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.