L’API export ordini/documenti consente ad un sistema esterno di interrogare bindCommerce per ottenere gli ordini ed altri documenti che sono stati importati dalle piattaforme di vendita (eCommerce, marketplace, ecc…).

La scelta di quali ordini/documenti esporre all’API viene effettuata attraverso l’interfaccia di bindCommerce. E’ possibile creare più connettori (che corrispondono a differenti URL da chiamare da parte del sistema esterno), ognuno dei quali rispondente ad una differente configurazione (filtro di quali ordini restituire all’API).

Sull’API ordini possono agire congiuntamente

• un filtro documenti: basato sulle caratteristiche del documento (es. stato della spedizione, destinazione della merce, ecc…)
• un filtro prodotti: basato sulle caratteristiche dei prodotti ivi contenuti (è ad esempio possibile esportare solo gli ordini che contengono righe ordine che fanno riferimento a prodotti di un determinato fornitore)

Inoltre è possibile applicare delle trasformazioni agli ordini esportati (come cambiare l’indirizzo di fatturazione oppure i prezzi).

L'API export ordini può essere utilizzata in 2 modalità alternative:

• con chiamata HTTPS
• eseguendo il connettore o inserendolo in una procedura bindCommerce (in tal caso il file verrà depositato nel nodo FTP precisato nella configurazione)

Il formato standard di export è XML, ma facoltativamente è possibile richiedere la trasformazione in CSV (usando il parametro personalizzato API_ORDER_OUTPUT_FORMAT___CSV con valore pari all'id del connettore di interesse)

Configurazione export ordini

bindCommerce consente di esportare tutti gli ordini ai gestionali API grazie ad una semplice configurazione.

Per creare la configurazione dal pannello di controllo bindCommerce andare al menù:

API >> Export ordini

Cliccare su Aggiungi e compilare i campi richiesti come illustrato di seguito:

• Nome configurazione: scegliere il nome desiderato
• Tecnologia: API
• Trasformazione ordini: funzione Premium. Per la configurazione si rimanda all’apposita guida tecnica Trasformazione ordini
• Web Server per archiviazione file: se valorizzato questo campo, il connettore può essere inserito in una procedura bindCommerce e il file depositato nell'area FTP indicata. Per fare in modo che il file depositato nell’area FTP disponga di data e ora come suffisso nel nome è necessario creare un parametro personalizzato con nome ERP_FILENAME_BY_DATETIME e valore 1.

Cliccare su SALVA E CHIUDI.

Connettore export ordini / documenti

Per creare il connettore che consentirà di esportare gli ordini da bindCommerce al gestionale API è necessario andare al menù:

Processi >> Connettori

Cliccare su Aggiungi e compilare i campi come segue:

• Nome connettore: scegliere il nome che si ritiene più adeguato
• Tipo nodo (tecnologia): API
• Nodo: il nodo creato in precedenza
• Tipo connettore: API [export ordini]

Cliccando su SALVA E CONTINUA si avrà accesso agli ulteriori campi da compilare.

• Il sistema chiamante dovrà utilizzare la seguente stringa: copiare l’URL presente in questo campo
• Configurazione connettore: selezionare la configurazione creata prima
• Filtro su documenti di vendita: per creare un filtro sugli ordini si invita a seguire le istruzioni riportate all'interno della guida apposita Filtri sugli ordini
• Filtro prodotti: per creare un filtro sui prodotti si invita a seguire le istruzioni riportate all'interno della guida apposita Filtri sui prodotti

Cliccare su SALVA E CHIUDI.

Grazie per aver valutato questo contenuto.