Özellikler
Talep gövdesindeki JSON anahtar/değer çiftleri
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
Yukarıdaki başlık, bu sipariş tamamlama talebinin başarılı bir şekilde tamamlanması için gerekli bir girdi.
| Alan | Notlar |
|---|---|
account_order_id İSTEĞE BAĞLI | Sipariş için numara dizesi. |
landed_cost_id GEREKEN | Tüccar veya ihracatçı için benzersiz landed cost tanımlayıcısı. |
parties GEREKEN | Gönderimle ilgili tarafların bir listesi. Bu, paketi gönderen, paketi alan, paketi aracılık eden ve gümrük vergileri ve harçların ödenmesinden sorumlu olan tarafın bilgilerini içerir. ship_from ve ship_to taraflarının sağlanması gereklidir. |
parties.city GEREKEN | Listelenen tarafın adres şehri, kasabası, ilçesi, banliyösü veya köyü için bir dize. |
parties.contact_email GEREKEN | İletişim e-postası için bir dize. |
parties.contact_name GEREKEN | İletişim adı için bir dize. |
parties.contact_phone GEREKEN | İletişim telefon numarası. |
parties.company_name İSTEĞE BAĞLI | Şirket adı. |
parties.country GEREKEN | İki harfli ISO kodu ile temsil edilen ülke. |
parties.line1 GEREKEN | Adresin 1. satırı için bir dize. |
parties.line2 GEREKEN | Adresin 2. satırı için bir dize. |
parties.postal_code GEREKEN | Posta kodu için bir dize. İthalat ülkesine bağlı olarak ship_to için isteğe bağlıdır. |
parties.state İSTEĞE BAĞLI | Mevcut olduğunda eyalet kodu için bir dize. Sadece Kanada ve Brezilya için ship_to gereklidir. |
parties.tax_id İSTEĞE BAĞLI | ship_to tarafı, Brezilya gibi ülkelere ithalat için bir vergi kimliği sağlamalıdır. Brezilya'ya yapılan gönderimler için sağlanmazsa, gönderim gümrükte bekletilecektir ve alıcıdan vergi kimliğini sağlamak için iletişim kurulması gerekecektir. Alıcıya ulaşılamazsa, teslimatlar muhtemelen gecikecek ve bu da paketlerin iade edilmesine veya terk edilmesine neden olabilir. |
parties.type GEREKEN | Sağlanan bilgilerin temsil ettiği tarafın türü. Olası değerler arasında ship_to, ship_from, shipper, sold_to, duties_taxes_payor ve broker bulunmaktadır. |
test İSTEĞE BAĞLI | true değeri ile doldurulursa, bu siparişle ilgili ücretler için fatura almayacaksınız. |
tracking_numbers İSTEĞE BAĞLI | Sipariş takip numaraları için bir liste. |
Örnek talep
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"]
}
Örnek yanıt
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"]
}
Bir sipariş tamamlaması talep et
Bir sipariş tamamlaması talebindeki anahtar/değer çiftlerini keşfedin.
Sipariş Tamam API'si, tamamlanmış sipariş bilgileri için yeni bir talep oluşturmanıza olanak tanır ve doğru işleme için gerekli ayrıntıları sağlar. Bu API, ilgili taraflar ve takip numaraları hakkında hayati bilgileri belirterek siparişin başarılı bir şekilde tamamlanmasını sağlar.