Uç Noktalar
Sipariş tamamlandı detaylarını isteyin
POST | https://api.iglobalstores.com/2.0/order-completed - Tamamlanmış bir siparişle ilgili bilgi talebi oluşturun.
HTTPS isteği
| Alan | Notlar |
|---|---|
| HTTP yöntemi | POST |
| Uç nokta URL'si | https://api.iglobalstores.com/2.0/order-completed |
| Protokol | HTTPS |
| Mesaj formatı | JSON |
| Accept HTTP başlığı | Accept: application/json |
| Güvenlik tokeni HTTP başlığı | serviceToken: your-test-token-valueHTTPS isteğinize serviceToken adında bir başlık ekleyin ve değer olarak test güvenlik API tokeninizi girin. (Bu token için Hesap Yöneticinizle iletişime geçin.) |
| Content-Type HTTP başlığı | Content-Type: application/jsonHizmete JSON verisi göndereceğiniz için, HTTPS isteğinize Content-Type adında bir başlık ekleyin ve değer olarak application/json girin. |
İstek gövdesindeki JSON anahtar/değer çiftleri
Mesaj Formatı: JSON
Örnek istek
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
{
"billingAddress": {
"address1": "123 S West Elm St",
"address2": null,
"address3": null,
"city": "Calgary",
"countryCode": "CA",
"postalCode": "T2P 5G8",
"state": "Alberta",
"stateCode": null
},
"billingCompany": null,
"billingEmail": "jdoe@jdoe.com",
"billingName": "John E. Doe",
"billingPhone": "+1 555-555-5555",
"orderGrandTotal": 1225.89,
"orderNumber": "854725421",
"paymentTypeCode": "PAYPAL",
"prepaidDutyTax": true,
"shippingQuoteId": "bcdbdbcd-0145-4d3b-a54e-0de3cdce5a0a",
"shipToCompany": null,
"shipToEmail": "jdoe@jdoe.com",
"shipToName": "John Doe",
"shipToPhone": "+1 555-555-5555"
}
JSON Tanımları
| Alan | Notlar |
|---|---|
billingAddress GEREKEN | Bu, siparişin fatura adresidir. Bu, aşağıdaki adres alanlarını içeren bir haritadır: address1, address2, address3, city, state, stateCode, postalCode ve countryCode. Bu alanlar, ülkeye bağlı olarak ya zorunlu ya da isteğe bağlıdır. Yerelleştirme uç noktası, her ülke için hangi spesifik adres alanlarının zorunlu olduğunu veya olmadığını döndürür. Not: stateCode her zaman zorunlu değildir ve yerelleştirme uç noktasında belirtilmemiştir. Varsa stateCode geçirebilirsiniz. |
billingCompany İSTEĞE BAĞLI | Bu, siparişin fatura şirket adıdır. |
billingEmail GEREKEN | Bu, siparişin fatura e-posta adresidir. |
billingName GEREKEN | Bu, siparişin tam fatura adıdır. |
billingPhone GEREKEN | Bu, siparişin fatura telefon numarasıdır. |
items[index].orderGrandTotal GEREKEN | Bu, alıcının siparişi için ödediği toplam tutardır (USD - Amerikan Doları). Lütfen virgül olmadan, dolar işareti “$” olmadan ve iki ondalık basamakla sağlayın. Örnek değer: 2102.99 |
items[index].orderNumber GEREKEN | Bu, yeni tamamlanan siparişiniz için sipariş numaranızdır. Örnek değer: 854725421 |
paymentTypeCode GEREKEN | Alıcının siparişi için ödeme yapmak için kullandığı ödeme yöntemidir. Örnek değerler: PayPal veya Visa veya MC veya AMEX veya DISC |
prepaidDutyTax GEREKEN | Alıcı, ithalat vergilerini ve harçlarını prepay ödemeyi mi seçti yoksa zorunlu olarak mı prepay ödemek zorunda kaldı? Eğer öyleyse, true olarak ayarlayın; değilse, false olarak ayarlayın. Örnek değerler: true veya false |
shippingQuoteId GEREKEN | Bu, alıcının seçtiği nakliye teklifinin kimliğidir. Sepet detayları, nakliye teklifleri alındığında olduğu gibi aynı olmalıdır. Sepet detayları değiştiyse, alıcının siparişini tamamlamadan önce yeni nakliye teklifleri istemiş olmalısınız. |
shipToCompany İSTEĞE BAĞLI | Bu, gönderilen siparişi alacak kişinin şirket adıdır. |
shipToEmail GEREKEN | Bu, gönderilen siparişi alacak kişinin e-posta adresidir. |
shipToName GEREKEN | Bu, gönderilen siparişi alacak kişinin tam adıdır. |
shipToPhone GEREKEN | Bu, gönderilen siparişi alacak kişinin telefon numarasıdır. |
HTTPS yanıtı
Mesaj formatı: JSON
Sadece Kanada ve Avustralya için örnek yanıt
Not: Gerçek yanıtlar, tüm desteklenen ülkeleri içerecektir.
Örnek yanıt
1
2
3
4
5
6
7
{
"igOrderId": "e55a4efc-e615-49af-b3a4-afcda87e9e5e",
"deniedParty": {
"flagged": true,
"source": "source reference for review"
}
}
Yanıt JSON tanımları
| Alan | Notlar |
|---|---|
deniedParty | Bu, reddedilen taraf tarama sonuçlarının bir haritasıdır. Null olarak ayarlandığında, reddedilen taraf taraması gerçekleştirilmemiştir. Bunu karşılaşırsanız Zonos temsilcinizle iletişime geçin. |
deniedParty.flagged | Bu siparişin Zonos reddedilen taraf konsolide listelerinde bir kayıtla eşleşip eşleşmediği. Eğer doğruysa, bu siparişi işlemden önce gözden geçirin. Şüphe durumunda, doğru olarak işaretlenmiş bir siparişi işlemeyin. Örnek değerler: doğru veya yanlış |
deniedParty.source | Eğer işaretli alan doğru olarak ayarlandıysa, bu alan siparişin neden reddedilen bir tarafla eşleştiğini gözden geçirmek için yararlı kaynak referanslarını tutacaktır. |
igOrderId | Yeni tamamlanan sipariş için Zonos tanımlayıcısı. Örnek değer: e55a4efc-e615-49af-b3a4-afcda87e9e5e |
Sipariş Tamamlandı API Legacy
Legacy Sipariş Tamamlandı API'sinin nasıl çalıştığını öğrenin.
Sipariş Tamamlandı uç noktası, alışverişçinin siparişinin son detaylarını kabul eder, sipariş detaylarını reddedilen taraflar için tarar ve sonuçları Zonos-özel bir sipariş kimliği ile birlikte döndürür.