API Merci

Cosa permette di fare

L'API Merci consente a un sistema esterno di:

Consultare l'elenco delle merci presenti su Areagate, con possibilita' di filtrare per gruppo, sottogruppo, codice o descrizione
Sincronizzare le merci modificate dopo un determinato momento
Inserire o aggiornare merci in modo massivo
Gestire i raggruppamenti sconti associati alle merci

Consultazione merci

Lista merci

Permette di ottenere l'elenco delle merci attive. E' possibile filtrare per:

Gruppo: ricerca esatta per gruppo merce
Sottogruppo: ricerca esatta per sottogruppo merce
Codice: ricerca esatta per codice numerico
Descrizione: ricerca parziale (basta una porzione della descrizione)

I risultati sono impaginati (massimo 1000 per pagina).

Per ogni merce vengono restituiti, oltre ai dati principali: aliquota IVA, unita' di misura, servizio, settore, sottogruppo, brand, tossicita', descrizioni aggiuntive, raggruppamenti, flag riordino e prezzo UA ufficiale.

Merci aggiornate

Permette di ottenere solo le merci che sono state modificate dopo un determinato punto di sincronizzazione. Utile per mantenere allineato un sistema esterno senza dover rileggere tutte le merci ogni volta.

Inserimento e aggiornamento merci

Il sistema esterno puo' inviare un elenco di merci da inserire o aggiornare. Per ogni merce:

Se il codice del sistema esterno (codice_host) non esiste su Areagate, la merce viene creata
Se il codice esiste e i dati sono diversi, la merce viene aggiornata
Se il codice esiste e viene indicata come cancellata, la merce viene disattivata

Dati gestibili

I dati principali che possono essere inviati per ogni merce:

Codice host (obbligatorio), descrizione
Codice host aliquota IVA, unita' di misura
Codice host servizio, settore, sottogruppo, brand
Codice tossicita', descrizioni aggiuntive
Categoria sconti vendita

Codice interno

Il codice interno della merce (composto da gruppo, sottogruppo e codice numerico) viene generato automaticamente dal sistema. Non e' necessario specificarlo in fase di inserimento.

Raggruppamenti sconti

E' possibile gestire i raggruppamenti sconti associati alle merci tramite un endpoint dedicato (/v1/merce/raggr_sconti). I raggruppamenti vengono registrati sulla tabella specifica e possono essere gestiti indipendentemente dall'inserimento merci.