API Listini#

Cosa permette di fare#

L'API Listini consente a un sistema esterno di:

Consultare i listini di vendita presenti su Areagate, con possibilita' di filtrare per articolo
Sincronizzare i listini modificati dopo un determinato momento
Inserire, aggiornare o cancellare listini di vendita in modo massivo
Consultare i listini fornitore (sola lettura)

Consultazione listini di vendita#

Lista listini#

Permette di ottenere i listini di vendita attivi. E' possibile filtrare per gruppo merceologico, sottogruppo o codice articolo specifico.

I risultati sono impaginati (massimo 1000 per pagina).

Listini aggiornati#

Permette di ottenere solo i listini che sono stati modificati dopo un determinato punto di sincronizzazione. Utile per mantenere allineato un sistema esterno senza dover rileggere tutti i listini ogni volta.

Questa modalita' restituisce anche i listini cancellati, in modo che il sistema esterno possa recepire le cancellazioni.

Dati restituiti#

Per ogni listino di vendita vengono forniti:

Identificazione dell'articolo (gruppo, sottogruppo, codice)
Tipo di listino: standard (L) o per cliente specifico (C)
Riferimento del listino (numero progressivo o codice cliente)
Prezzo di listino e prezzo campagna/promozione
Codice articolo nel sistema esterno
Indicazione se il listino e' stato cancellato

Consultazione listini fornitore#

I listini fornitore sono disponibili in sola lettura. Sono accessibili con le stesse modalita' dei listini di vendita (lista completa o aggiornamenti incrementali), ma non e' possibile modificarli tramite API.

Le sequenze di sincronizzazione dei listini fornitore sono indipendenti da quelle dei listini di vendita.

Per ogni listino fornitore vengono forniti:

Identificazione dell'articolo (gruppo, sottogruppo, codice)
Codice fornitore
Prezzo di acquisto
Codice articolo nel sistema esterno
Indicazione se il listino e' stato cancellato

Inserimento e aggiornamento listini di vendita#

Il sistema esterno puo' inviare un elenco di listini da inserire, aggiornare o cancellare. Per ogni listino:

Se il listino non esiste su Areagate, viene creato
Se il listino esiste e il prezzo e' diverso, viene aggiornato
Se il listino esiste e viene indicato come cancellato, viene disattivato

Tipi di listino#

Sono supportati due tipi di listino di vendita:

Standard (L): listino associato a un numero di riferimento generico
Per cliente (C): listino associato a uno specifico cliente del sistema esterno

Dati inviabili#

Per ogni listino e' necessario fornire:

Tipo di listino (C o L) e riferimento numerico
Prezzo di vendita
Codice dell'articolo nel sistema esterno

Facoltativamente:

Prezzo campagna/promozione
Codice cliente nel sistema esterno (obbligatorio per listini di tipo C)
Indicazione di cancellazione logica

Articolo obbligatorio

Il codice articolo del sistema esterno deve corrispondere a un articolo gia' presente su Areagate. Se l'articolo non viene trovato, l'operazione fallisce. E' possibile configurare il servizio per ignorare silenziosamente gli articoli non trovati.

Comportamento in caso di cancellazione#

Se si richiede la cancellazione di un listino gia' cancellato, l'operazione viene ignorata senza errore. Se l'articolo non esiste e si richiede la cancellazione, anche in questo caso l'operazione viene ignorata.