Attribut
JSON nyckel/värde-par i begärans kropp
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
Headern ovan är en obligatorisk inmatning för att denna begäran om slutförd beställning ska slutföras framgångsrikt.
| Fält | Anteckningar |
|---|---|
account_order_id VALFRI | Nummersträngen för beställningen. |
landed_cost_id OBLIGATORISK | Den unika landed cost identifieraren för handlaren eller exportören. |
parties OBLIGATORISK | En lista över de parter som är involverade i frakten. Detta inkluderar information för den part som skickar paketet, tar emot paketet, förmedlar paketet och ansvarar för betalning av avgifter och skatter. Att ange ship_from och ship_to parterna är obligatoriskt. |
parties.city OBLIGATORISK | En sträng för adressens stad, ort, distrikt, förort eller by för den angivna parten. |
parties.contact_email OBLIGATORISK | En sträng för kontaktens e-postadress. |
parties.contact_name OBLIGATORISK | En sträng för kontaktens namn. |
parties.contact_phone OBLIGATORISK | Kontaktens telefonnummer. |
parties.company_name VALFRI | Företagsnamnet. |
parties.country OBLIGATORISK | Landet, representerat av en tvåbokstavskod enligt ISO. |
parties.line1 OBLIGATORISK | En sträng för rad 1 av adressen. |
parties.line2 OBLIGATORISK | En sträng för rad 2 av adressen. |
parties.postal_code OBLIGATORISK | En sträng för postnumret. Valfritt för ship_to beroende på importlandet. |
parties.state VALFRI | En sträng för delstatens kod när den finns tillgänglig. Endast obligatorisk i Kanada och Brasilien för ship_to. |
parties.tax_id VALFRI | Den ship_to parten måste ange ett skatte-ID för att importera till länder som Brasilien. Om det inte anges för sändningar till Brasilien kommer sändningen att hållas vid tullen tills mottagaren kan kontaktas för att ange skatte-ID. Om mottagaren inte kan nås, kommer leveranser sannolikt att försenas, vilket potentiellt kan resultera i returnerade eller övergivna paket. |
parties.type OBLIGATORISK | Typen av part som den angivna informationen representerar. Möjliga värden inkluderar ship_to, ship_from, shipper, sold_to, duties_taxes_payor och broker. |
test VALFRI | Om den är ifylld med värdet true, kommer du inte att debiteras för kostnader relaterade till denna beställning. |
tracking_numbers VALFRI | En lista över beställningens spårningsnummer. |
Exempel på begäran
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"]
}
Exempel på svar
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"]
}
Begär en slutförd beställning
Utforska nyckel/värde-par i en begäran om slutförd beställning.
Order Complete API gör det möjligt för dig att skapa en ny begäran om information om slutförda beställningar, vilket ger viktiga detaljer för noggrann behandling. Denna API säkerställer framgångsrik slutförande av beställningar genom att specificera viktig information om de involverade parterna och spårningsnummer, bland andra obligatoriska fält.