API Giacenze

Cosa permette di fare

L'API Giacenze consente a un sistema esterno di:

Consultare le giacenze di magazzino presenti su Areagate, con possibilita' di filtrare per codice merce e magazzino/agenzia
Sincronizzare le giacenze modificate dopo un determinato momento
Aggiornare le giacenze in modo massivo (fino a 2000 elementi per chiamata)

Due modalita' di consultazione

Le giacenze sono esposte su due endpoint separati, a seconda di come sono organizzate:

Giacenze per magazzino (`/v1/giacenze`)

Restituiscono le quantita' disponibili per ciascuna combinazione di magazzino e merce. Questa e' la modalita' piu' comune, utilizzata quando il sistema esterno deve conoscere le giacenze nei vari depositi.

I dati disponibili per ogni record:

Codice magazzino e codice merce (sia interni che del sistema esterno)
Quantita' in giacenza, impegnata, ordinata, prenotata
Eventuali numeri seriali associati

Magazzini visibili

Vengono restituiti solo i magazzini che hanno un codice host configurato. Magazzini senza codice host non compaiono nei risultati.

Giacenze per capoarea (`/v1/giacenze-cap`)

Restituiscono le quantita' disponibili per ciascuna combinazione di agenzia e merce. Utile quando le giacenze sono organizzate per area commerciale anziche' per magazzino fisico.

I dati disponibili per ogni record:

Gruppo, sottogruppo e codice merce interni
Codice merce e codice agenzia (sia interni che del sistema esterno)
Quantita' in giacenza, impegnata, ordinata, prenotata, disponibile

Consultazione e sincronizzazione

Entrambe le modalita' supportano:

Lista completa: lettura delle giacenze con filtri per codice merce e magazzino/agenzia, con paginazione (max 2000 risultati per pagina)
Aggiornamenti incrementali: lettura delle sole giacenze modificate dopo un determinato punto di sincronizzazione, utile per mantenere allineato il sistema esterno senza dover rileggere tutti i dati ogni volta

Aggiornamento giacenze

Il sistema esterno puo' inviare un elenco di giacenze da aggiornare. Per ogni record:

Se la combinazione merce/magazzino (o merce/agenzia) non esiste, viene creata (a condizione che almeno un valore sia diverso da zero)
Se la combinazione esiste e i valori sono diversi, viene aggiornata
Se la combinazione esiste e i valori sono invariati, viene ignorata

Gestione numeri seriali

Per le giacenze per magazzino, e' possibile gestire anche i numeri seriali delle merci. In questo caso:

La quantita' deve essere 0 o 1
Un nuovo seriale con giacenza 1 viene inserito e la giacenza incrementata
Un seriale esistente marcato come cancellato viene rimosso e la giacenza decrementata
Un seriale esistente con magazzino diverso viene spostato (decremento dal vecchio, incremento nel nuovo)

Raccordi obbligatori

I codici merce e magazzino/agenzia devono corrispondere a raccordi gia' configurati nel sistema. Se un raccordo non viene trovato, l'operazione restituisce un errore.