Atribut
Pasangan kunci/nilai JSON dalam badan permintaan
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
Header di atas adalah input yang diperlukan untuk permintaan pesanan lengkap ini agar berhasil diselesaikan.
| Field | Notes |
|---|---|
account_order_id OPTIONAL | String nomor untuk pesanan. |
landed_cost_id REQUIRED | Identifikasi landed cost unik untuk pedagang atau eksportir. |
parties REQUIRED | Daftar pihak yang terlibat dalam pengiriman. Ini termasuk informasi untuk pihak yang mengirim paket, menerima paket, menengahi paket, dan bertanggung jawab atas pembayaran bea dan pajak. Menyediakan pihak ship_from dan ship_to adalah wajib. |
parties.city REQUIRED | String untuk kota alamat, kota, distrik, pinggiran kota, atau desa dari pihak yang terdaftar. |
parties.contact_email REQUIRED | String untuk email kontak. |
parties.contact_name REQUIRED | String untuk nama kontak. |
parties.contact_phone REQUIRED | Nomor telepon kontak. |
parties.company_name OPTIONAL | Nama perusahaan. |
parties.country REQUIRED | Negara, yang diwakili oleh kode ISO dua huruf. |
parties.line1 REQUIRED | String untuk baris 1 alamat. |
parties.line2 REQUIRED | String untuk baris 2 alamat. |
parties.postal_code REQUIRED | String untuk kode pos. Opsional untuk ship_to tergantung pada negara impor. |
parties.state OPTIONAL | String untuk kode negara bagian jika tersedia. Hanya diperlukan di Kanada dan Brasil untuk ship_to. |
parties.tax_id OPTIONAL | Pihak ship_to harus memberikan ID pajak untuk mengimpor ke negara seperti Brasil. Jika tidak diberikan untuk pengiriman ke Brasil, pengiriman akan ditahan di bea cukai sampai penerima dapat dihubungi untuk memberikan ID pajak. Jika penerima tidak dapat dihubungi, pengiriman kemungkinan akan tertunda, yang dapat mengakibatkan paket dikembalikan atau ditinggalkan. |
parties.type REQUIRED | Jenis pihak yang diwakili oleh informasi yang diberikan. Nilai yang mungkin termasuk ship_to, ship_from, shipper, sold_to, duties_taxes_payor, dan broker. |
test OPTIONAL | Jika diisi dengan nilai true, Anda tidak akan dikenakan biaya untuk biaya terkait dengan pesanan ini. |
tracking_numbers OPTIONAL | Daftar untuk nomor pelacakan pesanan. |
Contoh permintaan
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"]
}
Contoh respons
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"]
}
Permintaan pesanan lengkap
Jelajahi pasangan kunci/nilai dalam permintaan pesanan lengkap.
Order Complete API memungkinkan Anda untuk membuat permintaan baru untuk informasi pesanan yang telah selesai, memberikan detail penting untuk pemrosesan yang akurat. API ini memastikan penyelesaian pesanan yang sukses dengan menentukan informasi penting tentang pihak-pihak yang terlibat dan nomor pelacakan, di antara bidang yang diperlukan lainnya.