Attributi
Coppie chiave/valore JSON nel corpo della richiesta
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
L'intestazione sopra è un input richiesto per questa richiesta di ordine completato affinché venga completata con successo.
| Campo | Note |
|---|---|
account_order_id OPZIONALE | La stringa numerica per l'ordine. |
landed_cost_id OBBLIGATORIO | L'identificatore unico landed cost per il commerciante o l'esportatore. |
parties OBBLIGATORIO | Un elenco delle parti coinvolte nella spedizione. Questo include le informazioni per la parte che spedisce il pacco, riceve il pacco, media il pacco e responsabile del pagamento di dazi e tasse. È necessario fornire le parti ship_from e ship_to. |
parties.city OBBLIGATORIO | Una stringa per la città, paese, distretto, sobborgo o villaggio dell'entità elencata. |
parties.contact_email OBBLIGATORIO | Una stringa per l'email di contatto. |
parties.contact_name OBBLIGATORIO | Una stringa per il nome di contatto. |
parties.contact_phone OBBLIGATORIO | Il numero di telefono di contatto. |
parties.company_name OPZIONALE | Il nome dell'azienda. |
parties.country OBBLIGATORIO | Il paese, rappresentato da un codice ISO a due lettere. |
parties.line1 OBBLIGATORIO | Una stringa per la riga 1 dell'indirizzo. |
parties.line2 OBBLIGATORIO | Una stringa per la riga 2 dell'indirizzo. |
parties.postal_code OBBLIGATORIO | Una stringa per il codice postale. Facoltativo per ship_to a seconda del paese di importazione. |
parties.state OPZIONALE | Una stringa per il codice dello stato quando disponibile. Richiesto solo in Canada e Brasile per ship_to. |
parties.tax_id OPZIONALE | La parte ship_to deve fornire un ID fiscale per importare in paesi come il Brasile. Se non viene fornito per le spedizioni in Brasile, la spedizione sarà trattenuta in dogana fino a quando il destinatario non potrà essere contattato per fornire l'ID fiscale. Se il destinatario non può essere raggiunto, le consegne saranno probabilmente ritardate, con il rischio di pacchi restituiti o abbandonati. |
parties.type OBBLIGATORIO | Il tipo di parte che le informazioni fornite rappresentano. I valori possibili includono ship_to, ship_from, shipper, sold_to, duties_taxes_payor e broker. |
test OPZIONALE | Se popolato con il valore di true, non ti verrà addebitato alcun costo relativo a questo ordine. |
tracking_numbers OPZIONALE | Un elenco per i numeri di tracciamento dell'ordine. |
Esempio di richiesta
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"account_order_id": "123456",
"landed_cost_id": "ldct_1LOYliG6NmEu31cVkvGHvv",
"parties": [
{
"city": "Campinas",
"contact_email": "info@example.com",
"contact_name": "Jean-Luc Picard",
"contact_phone": "1234567890",
"company_name": "Starfleet",
"country": "BR",
"line1": "49 Chapadao Rua",
"line2": null,
"postal_code": "75828-000",
"state": "SP",
"tax_id": "12-3456789",
"type": "ship_to"
}
],
"tracking_numbers": ["1Z12345E0205271688"]
}
Esempio di risposta
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"id": "ordr_5LwjnR9AW6L9eXs9lfeMC7",
"landed_cost_id": "ldct_1LOYliG6NmEu31cVkvGHvv",
"account_order_id": "123456",
"zonos_order_id": "1000151",
"parties": [
{
"id": "prty_12165151351",
"city": "Campinas",
"contact_email": "info@example.com",
"contact_name": "Jean-Luc Picard",
"contact_phone": "1234567890",
"company_name": "Starfleet",
"country": "BR",
"line1": "49 Chapadao Rua",
"line2": null,
"line3": null,
"postal_code": "75828-000",
"state": "SP",
"tax_id": "12-3456789",
"type": "ship_to"
}
],
"tracking_numbers": ["1Z12345E0205271688"]
}
Richiedi un ordine completato
Esplora le coppie chiave/valore in una richiesta di ordine completato.
L'API Order Complete consente di creare una nuova richiesta per le informazioni sugli ordini completati, fornendo dettagli essenziali per un'elaborazione accurata. Questa API garantisce il completamento dell'ordine specificando informazioni vitali sulle parti coinvolte e sui numeri di tracciamento, tra altri campi richiesti.