Le API di commercioVirtuoso.it ti permettono di evadere gli ordini del tuo negozio in modo programmatico. In questa guida, ti mostreremo come utilizzare l’endpoint /api/v2/orders/{orderId}/fulfillments.json per evadere un ordine specifico.
Documentazione API e Sandbox
Puoi visualizzare la lista completa degli Endpoint API e una Sandbox per simulare le chiamate e le risposte direttamente accedendo a: https://api.commerciovirtuoso.it
Evasione di un Ordine
Per evadere un ordine, dovrai effettuare una richiesta POST all’endpoint /api/v2/orders/{orderId}/fulfillments.json con i dettagli dell’evasione nel corpo della richiesta. Di seguito sono riportati i parametri che puoi utilizzare nella richiesta e un esempio di richiesta cURL.
Endpoint
POST /api/v2/orders/{orderId}/fulfillments.json
Parametri della Richiesta
| Nome Campo | Tipo | Descrizione |
|---|---|---|
| orderId | string | ID dell’ordine da evadere (path). |
| line_item_ids | array | Lista degli ID degli articoli e quantità da evadere (body). |
| fulfillment_method | string | Metodo di evasione. |
| tracking_number | string | Numero di tracciamento della spedizione. |
| shipping_method | string | Metodo di spedizione. |
| tracking_url | string | URL per il tracciamento della spedizione. |
Corpo della Richiesta
Ecco un esempio di corpo della richiesta in formato JSON:
{
"line_item_ids": [
{
"line_item_id": "101",
"quantity": "1"
}
],
"fulfillment_method": "other",
"tracking_number": "101",
"shipping_method": "Test Method",
"tracking_url": "www.example.com/tracking_url"
}
Note Importanti
- Evasione in Background: L’evasione degli ordini avviene in background, quindi potrebbero volerci alcuni minuti prima che le modifiche siano visibili.
- Contenuto della Richiesta: Assicurati che il contenuto della richiesta sia di tipo
application/json.
