PicalWebApi

Documentazione tecnica: processo operativo, campi obbligatori e identificazione giacenza

Processo Operativo

L'ERP in qualsiasi momento può inviare le forniture contenenti i movimenti da registrare. Il servizio, se ritiene valida la richiesta, prende in carico la fornitura e rilascia il codice CRF (Codice Riferimento Fornitura). L'ERP, a sua volta, può richiedere gli esiti dei movimenti processati di una determinata fornitura fornendo il CRF. Gli esiti dei singoli movimenti sono consultabili solo dopo che tutti i movimenti di una singola fornitura sono stati processati; diversamente il servizio informa l'ERP di ritentare, nell'attesa che le elaborazioni siano state completate.

Fornitura di Movimentazioni di Registro

La Fornitura da inviare all'ente di controllo contiene una lista di Operazioni, processate secondo l'ordine indicato. Le Operazioni descrivono le movimentazioni da effettuare in dipendenza del tipo di operazione; opzionalmente, per ogni operazione è possibile allegare uno o più documenti. In ogni singola Movimentazione sono specificate le quantità da caricare e/o scaricare di un determinato prodotto.

Classi prodotto, movimentazione e operazione — Campi obbligatori

Obbligatorietà dei campi per tipo di operazione e riga scheda del corpo della richiesta POST /v1/Forniture.

OperazioneRigaDescrizioneMovimentoCategorie ammesse Campi Prodotto obbligatoriCampi Movimento obbligatoriCampi Operazione obbligatori
ACET1BaseScarico21CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
CodAttoCert
QuantitaDataOperazione
NumOperazione
Movimentazioni
DOLC1Da DolcificareScarico21; 28CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
CodAttoCert
QuantitaDataOperazione
NumOperazione
Movimentazioni
2Aggiunto (ripetibile)Scarico07; 09; 10; 11; 41
3DolcificatoCarico21; 28CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
CodAttoCert
Quantita
IMBO1SfusoScarico21; 22; 23; 24; 25; 26; 28; 30; 31CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
CodAttoCert
QuantitaDataOperazione
NumOperazione
Movimentazioni
2ImbottigliatoCarico21; 22; 23; 24; 25; 26; 28; 30; 31CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
CodAttoCert
QuantitaPartita:VolNominaleNumConfLotto
ETIC1BaseScarico21; 22; 23; 24; 25; 26; 28; 30; 31CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
QuantitaDataOperazione
NumOperazione
Movimentazioni
2EtichettatoCarico21; 22; 23; 24; 25; 26; 28; 30; 31CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
QuantitaPartita:VolNominaleNumConfLottoNumSerieNumIniContrNumFinContr
PERD1Base che subisce perditeScarico21; 22; 23; 24; 25; 26; 28; 30; 31CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
QuantitaDataOperazione
Movimentazioni
USSD1Venduto/Scaricato (ripetibile)Scarico21; 22; 23; 24; 25; 26; 28; 30; 31CodClassificazione
CodColore
CodDopIgp
CodStatoFisico
Quantita
TitoloAlcolometrico
DataOperazione
NumOperazione
Movimentazioni

Identificazione Giacenza

L'identificazione univoca della giacenza per una specifica tipologia di vino è determinata dalla combinazione dei valori delle proprietà dell'oggetto Prodotto qui elencate. La variazione di uno qualsiasi di questi parametri individua una giacenza distinta.
Nome Campo (ID)Descrizione Proprietà
CodClassificazioneCodice Classificazione
CodColoreCodice Colore
CodStatoFisicoCodice Stato Fisico
CodAttoCertCodice Atto di Certificazione
CodBiologicoCodice Biologico
CodCategoriaCodice Categoria
CodDopIgpCodice DOP / IGP
PercIgpPercentuale IGP
NumCertDOPNumero Certificazione DOP
DataCertDOPData Certificazione DOP
CodSottozonaCodice Sottozona
CodVignaCodice Vigna
AnnataAnnata di riferimento
PercAnnatPercentuale Annata
CodZonaViticolaCodice Zona Viticola
CodProvenienzaUveCodice Provenienza Uve
CodPartitaCodice Partita / Lotto
CodVarietaElenco Codici Varietà
CodPraticheEnologicheElenco Codici Pratiche Enologiche