Pical Web API è un servizio erogato da Pical Service al fine di fornire a un sistema informativo, come l'ERP, uno strumento telematico per trasferire i movimenti di registro all'ente di controllo.
Architettura API RESTful
Il servizio è conforme allo stile architetturale API RESTful: è quindi possibile accedere alle funzionalità in modo programmatico, utilizzando i verbi HTTP standard. Saranno elaborate solo le richieste autenticate e ritenute conformi alle regole descritte in questa documentazione.
→ Documentazione tecnica: processo operativo, campi obbligatori e identificazione giacenza
Operazioni gestite
Seleziona un'operazione per visualizzare la struttura dell'invio fornitura corrispondente.
PERD — Perdite
Campi operazione obbligatoriDataOperazione, Movimentazioni
| Riga | Descrizione | Movimento | Categorie ammesse | Campi Prodotto obbligatori | Campi Movimento obbligatori |
|---|---|---|---|---|---|
| 1 | Base che subisce perdite | Scarico | 21; 22; 23; 24; 25; 26; 28; 30; 31 | CodClassificazione CodColore CodDopIgp CodStatoFisico | Quantita |
ACET — Acetificazione
Campi operazione obbligatoriDataOperazione, NumOperazione, Movimentazioni
| Riga | Descrizione | Movimento | Categorie ammesse | Campi Prodotto obbligatori | Campi Movimento obbligatori |
|---|---|---|---|---|---|
| 1 | Base | Scarico | 21 | CodClassificazione CodColore CodDopIgp CodStatoFisico CodAttoCert | Quantita |
IMBO — Imbottigliamento
Campi operazione obbligatoriDataOperazione, NumOperazione, Movimentazioni
| Riga | Descrizione | Movimento | Categorie ammesse | Campi Prodotto obbligatori | Campi Movimento obbligatori |
|---|---|---|---|---|---|
| 1 | Sfuso | Scarico | 21; 22; 23; 24; 25; 26; 28; 30; 31 | CodClassificazione CodColore CodDopIgp CodStatoFisico CodAttoCert | Quantita |
| 2 | Imbottigliato | Carico | 21; 22; 23; 24; 25; 26; 28; 30; 31 | CodClassificazione CodColore CodDopIgp CodStatoFisico CodAttoCert | QuantitaPartita:VolNominaleNumConfLotto |
DOLC — Dolcificazione
Campi operazione obbligatoriDataOperazione, NumOperazione, Movimentazioni
| Riga | Descrizione | Movimento | Categorie ammesse | Campi Prodotto obbligatori | Campi Movimento obbligatori |
|---|---|---|---|---|---|
| 1 | Da Dolcificare | Scarico | 21; 28 | CodClassificazione CodColore CodDopIgp CodStatoFisico CodAttoCert | Quantita |
| 2 | Aggiunto (ripetibile) | Scarico | 07; 09; 10; 11; 41 | — | — |
| 3 | Dolcificato | Carico | 21; 28 | CodClassificazione CodColore CodDopIgp CodStatoFisico CodAttoCert | Quantita |
USSD — Vendita/Scarico da stabilimento o deposito
Campi operazione obbligatoriDataOperazione, NumOperazione, Movimentazioni
| Riga | Descrizione | Movimento | Categorie ammesse | Campi Prodotto obbligatori | Campi Movimento obbligatori |
|---|---|---|---|---|---|
| 1 | Venduto/Scaricato (ripetibile) | Scarico | 21; 22; 23; 24; 25; 26; 28; 30; 31 | CodClassificazione CodColore CodDopIgp CodStatoFisico | Quantita TitoloAlcolometrico |
ETIC — Etichettatura/Fascettatura
Campi operazione obbligatoriDataOperazione, NumOperazione, Movimentazioni
| Riga | Descrizione | Movimento | Categorie ammesse | Campi Prodotto obbligatori | Campi Movimento obbligatori |
|---|---|---|---|---|---|
| 1 | Base | Scarico | 21; 22; 23; 24; 25; 26; 28; 30; 31 | CodClassificazione CodColore CodDopIgp CodStatoFisico | Quantita |
| 2 | Etichettato | Carico | 21; 22; 23; 24; 25; 26; 28; 30; 31 | CodClassificazione CodColore CodDopIgp CodStatoFisico | QuantitaPartita:VolNominaleNumConfLottoNumSerieNumIniContrNumFinContr |
Aggiornamenti e release
Storico completo delle versioni rilasciate, dalla più recente.
- FixCorrezioni documentazione obbligatorietà NumOperazione
- FixCorrezioni documentazione classe destinatario
- FixCorrezioni documentazione messaggi di errore
- NovitàValidazione dell'obbligatorietà dei campi della classe prodotto (Articolo telematico) secondo le operazioni SIAN, per ogni tipo di operazione.
- NovitàRisposta HTTP 400 strutturata (FornituraValidazioneErrorDTO) con il dettaglio dei campi mancanti per prodotto, movimentazione e operazione.
- NovitàNuova pagina pubblica /releases per consultare aggiornamenti e release.
- ModificaNumOperazione obbligatorio per tutte le operazioni tranne PERD (non più [Required] globale a livello DTO).
- ModificaLa movimentazione è sempre obbligatoria: ogni operazione deve contenere almeno un movimento.
- ModificaOperazione DOLC: la riga "Aggiunto" non ha più campi obbligatori.
- ModificaCertificato DOP (DataCertDOP / NumCertDOP) non più obbligatorio per nessun movimento.
- FixAllineamento dell'obbligatorietà di CodAttoCert per le operazioni DOLC e IMBO alle schede operazioni.
- NovitàDocumentazione interattiva delle API tramite Scalar (/scalar) con tema aziendale.
- ModificaDocumentazione Swagger UI
- NovitàAcquisizione forniture con gestione delle operazioni ACET, DOLC, IMBO, ETIC, PERD e USSD.
- NovitàRecupero degli esiti di lavorazione per singola fornitura.
- NovitàServizi di consultazione delle giacenze.