- Details
- Written by: marino monacis
- Category: API
- Hits: 3
Il processo di esportazione ordini via API, è personalizzabile grazie all'uso di specifici parametri personalizzati.
<br><b>API_ORDERS_PRODUCT_CATEGORIES = 0,1</b>
<br>Aggiunge nell’xml di esportazione anche i tag relativi alla key_cat delle categorie di prodotti.
<br>ES:<ProductCategories>
<Category> chiave2 della categoria </Category>
,<Category> chiave3 della categoria </Category>
</ProductCategories>
<br>
<br><b>API_ORDERS_SPLIT_ADDRESS = 0,1</b>
<br>Nel file xml di esportazione degli ordini, divide l’indirizzo aggiuntivo di spedizione e billing in due indirizzi con tue tag diversi invece che uno solo.
Es.: Se sono definiti billing_address e billing_address2 crea due tag: <Address>billing_address</Address>,<Address2>billing_address2</Address2>
<br>
<br><b>API_ORDERS_SHIPPING_VAT_FIX = id_nodo => aliquota</b>
<br>Serve a definire un’aliquota fissa sulla spedizione per un determinato nodo.
<br>
<br><b>API_ORDERS_OUT_SPLIT_SUPPLIER = 1</b>
<br>Quando settato 1, permette lo split degli ordini in base al fornitore nel processo di API export orders, con il seguente procedimento:
<br>1)Identifica se nelle righe abbinate all’ordine vi sono prodotti legati a differenti fornitori;
<br>2)Se la risposta è affermativa, modifica l’id ordine bindCommerce in idbindCommerce-idSupplier ed abbina allo stesso solo i prodotti di quel fornitore, e questo per gli N fornitori trovati;
<br>3)Se la risposta è negativa, ovvero vi è soltanto un fornitore, lavora gli ordini nel modo standard.
<br>
<br><b>API_ORDERS_ADDRESSTWO_TO_FC = ID_Nodo,ID_Nodo</b>
<br>Indicare gli ID nodo separati da virgola per cui tale trasformazione deve essere apportata.
<br>
<br><b>API_ORDER_OUTPUT_FORMAT___CSV = ID_Connettore</b>
<br>Il formato standard di export è XML, ma facoltativamente è possibile richiedere la trasformazione in CSV utilizzando questo parametro personalizzato.
<br>
<br><b>API_ORDER_OUTPUT_FORMAT___CSV_OPTIONS = {"<id_connettore>": {"separator": ";", "enclosure": "\"", "'", "date_format": "Y-m-d H:i:s", "line_break": "CRLF"}, "<id_secondo_connettore>": {...} }</b>
<br>Consente di variare le opzioni contenute all’interno del file CSV esportato, quali separatore, delimitatore di testo, formato della data e carattere di fine riga.
<br>line_break può assumere i seguenti valori:
<br>CR viene convertito in \r (line break macintosh)
<br>LF viene convertito in \n (line break linux e mac os x)
<br>CRLF viene convertio in \r\n (line break windows)
- Details
- Written by: Dario Salaris
- Category: API
- Hits: 689
L’API export prodotti consente ad un sistema esterno (ad esempio un sito eCommerce) di ricevere i prodotti da bindCommerce.
Configurazione connettore su bindCommerce
Al fine di ottimizzare la dimensione del file generato, la scelta di quali dati esportare è delegata all’utente attraverso le configurazioni a video.
Informazioni da considerare
Innanzitutto è necessario scegliere quali informazioni esportare.
Informazioni sui prodotti
Se è stata selezionata l’esportazione delle informazioni sui prodotti, è possibile selezionare i campi da includere nel file generato e selezionare un elenco di descrizioni alternative
Informazioni sulle categorie
Selezionando l’esportazione delle categorie sarà possibile selezionare i campi da includere nel file generato, se includere le descrizioni alternative e specificare uno o più tag (separati da virgola) che verranno utilizzati come filtro per selezionare le categorie da includere.
Informazioni sugli attributi
Scegliendo di esportare gli attributi sarà possibile definire l’elenco degli attributi da esportare e se applicare una conversione di scala.
Informazioni sugli attributi: Opzioni aggiuntive
Questa sezione consente di definire come esportare gli attributi dei prodotti e come gestire le varianti come prodotti virtuali.
Quali attributi esportare
Permette di selezionare quali attributi includere nel file di esportazione. E' possibile selezionare una delle opzioni di seguito:
- Tutti: vengono utilizzati tutti gli attributi disponibili.
- Tutti con opzione di conversione: vengono utilizzati solo gli attributi per cui è stata configurata una conversione di scala.
- Solo quelli selezionati: vengono utilizzati quelli selezionati all'interno del gruppo "Attributi".
Generare prodotti virtuali da un attributo variante?
Se attivo, il sistema crea un prodotto virtuale per ogni valore dell’attributo selezionato.
Attributo da cui generare i prodotti virtuali
Consente di definire quale attributo usare per la generazione dei prodotti virtuali.
Attributo variante come suffisso del titolo del prodotto virtuale?
Se attivo, il valore dell’attributo utilizzato per generare i prodotti virtuali viene aggiunto al titolo del prodotto virtuale. Ad esempio, un prodotto “Maglietta” con variante “Taglia M” verrà esportato come “Maglietta - Taglia M”.
Informazioni sui prezzi
Selezionando l’esportazione dei Prezzi sarà possibile definire i listini da esportare e le informazioni sui prezzi da includere.
Disponibilità magazzino
Scegliendo di esportare le disponibilità sarà possibile definire se prelevare le disponibilità dalla tabella Prodotti oppure da un magazzino specifico e selezionare eventuali stock aggiuntivi da includere
Immagini
Se è state selezionata l’esportazione delle immagini è possibile scegliere il tipo di immagine da esportare, se prelevare le immagini dalla tabella Prodotti o da una Alternativa e il numero massimo di immagini da esportare. Sarà inoltre possibile definire un elenco di tag separato da virgole che verrà usato come filtro per le immagini (verranno selezionato le immagini che hanno almeno un tag tra quelli specificati)
Upload su nodo Web Server (FTP)
Se questo campo viene valorizzato, il file generato dall’export verrà depositato nell’area FTP indicata. In questo modo, il connettore potrà essere inserito all’interno di una procedura bindCommerce per automatizzare il flusso.
È inoltre possibile attivare il parametro personalizzato ERP_FILENAME_BY_DATETIME = 1, che consente di generare il nome del file con data e ora come suffisso (es. prodotti_20250814_1500.csv), utile per versionare i tracciati.
Numero di prodotti per file
Serve per suddividere il carico di lavoro necessario all’importazione dei dati sul sistema ricevente.
-
Se il valore è 0, il sistema esporta tutti i prodotti inclusi nel filtro in un unico file.
-
Se viene indicato un numero maggiore di zero, il sistema suddivide l’export in più file, ciascuno contenente al massimo quel numero di prodotti.
Indirizzo e-mail
È possibile indicare uno o più indirizzi email (separati da virgola) ai quali inviare automaticamente il tracciato generato. Utile per notifiche, archiviazione o distribuzione manuale del file.
Applicazione al connettore
La configurazione API deve essere poi utilizzata in un connettore di tipo API [export prodotti].
- Details
- Written by: Dario Salaris
- Category: API
- Hits: 4251
L’API import prodotti consente ad un sistema esterno (ad esempio un gestionale di magazzino) di aggiungere e modificare i prodotti in bindCommerce, affinchè possano poi essere pubblicati o aggiornati nei canali di vendita.
Configurazione del connettore API per l'import prodotti
Per prima cosa è necessario creare una configurazione per selezionare le operazioni consentite.
Per creare la configurazione, recarsi al menù:
API >> Import prodotti
Cliccare su Aggiungi e compilare i campi come segue:
- Nome configurazione: scegliere il nome che si ritiene più adeguato;
- Tipo d'azione: è possibile scegliere tra - Creazione - Creazione e aggiornamento - Aggiornamento;
- Informazioni da considerare: selezionare quali fra Titolo, Descrizione, Descrizione breve, Produttore, Fornitore, Dimensioni e peso, Quantità, Attributi, Tags, Prezzi, Alternative, Immagini, Categorie;
- Eliminazione dati non trasmessi: Barcode - Immagini - Prodotti
- Calcolare quantità prodotto parent dalla somma delle varianti?: opzione che consente di determinare se i prodotti parent dovranno avere la quantità calcolata in base alla somma dello stock delle singole varianti;
- Calcolare prezzo del parent dal minimo delle varianti?: opzione che consente di determinare se i prodotti parent dovranno avere il prezzo calcolato in base al prezzo più basso delle singole varianti;
Cliccare su SALVA E CHIUDI.
Connettore API per l'import prodotti
Per creare il connettore che consentirà di importare i prodotti dal gestionale API a bindCommerce recarsi al menù:
Processi >> Connettori
Cliccare su Aggiungi e compilare i campi come segue:
- Nome connettore: usare il nome che si preferisce;
- Tipo nodo (tecnologia): API;
- Nodo: selezionare il nodo API;
- Tipo connettore: API [import prodotti];
Cliccando su SALVA E CONTINUA si avrà accesso agli ulteriori campi a seguire:
- Il sistema chiamante dovrà utilizzare la seguente stringa: l’URL presente in questo campo deve essere fornito al sistema chiamante;
- Configurazione connettore: selezionare la configurazione creata precedentemente;
- 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.
- Details
- Written by: Dario Salaris
- Category: API
- Hits: 1545
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).
Configurazione export ordini / documenti
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 per il quale si esegue l'operazione
- Tipo connettore: API [export documenti]
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 e incollarlo nell’apposito campo sul pannello di controllo dell'applicazione
- 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.