- Details
- Written by: Paolo Tateo
- Category: Guida API bindCommerrce
- Hits: 459
Le API bindShipping consentono ad un sistema esterno alla piattaforma (bindCommerce compreso) di svolgere varie operazioni.
La documentazione tecnica delle API bindShipping è disponibile al seguente indirizzo: https://api-doc.ship.bindcommerce.app/
La radice dell'URL API da chiamare dipende dall'indirizzo dell'host bindShipping assegnato al cliente (quindi potenzialmente è sempre diverso)
Descriviamo di seguito le principali operazioni eseguibili via API.
Gestione Ordini
Creazione ordini: POST /jobs/orders/submit
Annullamento ordini: POST /jobs/orders/cancel
Richiesta stato di un ordine: GET /order/status
Richiesta stato di più ordini: GET /orders/status
Gestione Spedizioni
Creazione di una spedizione: POST /jobs/shipment/submit
Richiesta informazioni su una spedizione: GET /shipment/status
Richiesta etichette: GET /shipment/labels
Gestione Prodotti
Creazione prodotti: POST /jobs/products/submit
Aggiornamento stock prodotti: POST /jobs/products/stockupdate
Aggiornamento prodotti: POST /jobs/products/catalogupdate
Esito delle chiamate
A seguito di ogni chiamata, bindShipping restituite l'identificativo di un job.
Per conoscere l'esito dell'operazione è necessario eseguire la chiamata:
GET /jobs/status
- Details
- Written by: Dario Salaris
- Category: Guida API bindCommerrce
- Hits: 126
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 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)
E’ possibile inoltre indicare un eventuale nodo di tipo Web Server su cui caricare automaticamente il file generato al termine del processo di esportazione (in alternativa alla ricezione via https).
- Details
- Written by: Mariana Cherneva
- Category: Guida API bindCommerrce
- Hits: 1716
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 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)
E’ possibile inoltre indicare un eventuale nodo di tipo Web Server su cui caricare automaticamente il file generato al termine del processo di esportazione (in alternativa alla ricezione via https).
- Details
- Written by: Mariana Cherneva
- Category: Guida API bindCommerrce
- Hits: 600
- Details
- Written by: Dario Salaris
- Category: Guida API bindCommerrce
- Hits: 492
Formato del file di export
Il formato standard di export è XML, ma facoltativamente è possibile richiedere la trasformazione in CSV usando il parametro personalizzato API_EXPORT_PRODUCTS_OUTPUT_FORMAT___CSV.
È possibile gestire i parametri personalizzati al menu:
Parametri di sistema -> Parametri personalizzati
Per creare il parametro, cliccare su Aggiungi e compilare i seguenti campi:
- Nome Parametro: API_EXPORT_PRODUCTS_OUTPUT_FORMAT___CSV
- Valore Parametro: JSON per indicare quali sezioni esportare nel tracciato csv