Tedarikçi Doğrudan Gönderim Kargo API'si v2021-12-28 Kullanım Senaryosu Rehberi
Satıcı Doğrudan Gönderim (DF) Kargo API'sini nasıl kullanacağınızı öğrenin.
Kullan Doğrudan Gönderim Gönderim API'si Amazon ile gönderimle ilgili belgeleri takas etmek için.
Eğitimler
Bu bölümdeki eğitimlerde aşağıdakilerin nasıl yapılacağı açıklanmaktadır:
- Kargo etiketi taleplerini gönderin
- Bir veya daha fazla kargo etiketi alın
- Oluştur nakliye etiketleri ve konteyner etiketleri
- Gönder sevkiyat onayları ve sevkiyat durumu güncellemeleri
- Bir veya daha fazla sevk irsaliyesi alın
- Bir veya daha fazla müşteri faturası alın (Sadece Hindistan)
Kargo etiketi taleplerini gönderin
submitShippingLabelRequest
işlemi, tedarikçilerin her bir satın alma siparişi için Amazon'dan kargo etiketi bilgilerini talep etmesine olanak tanır. Şemaya bağlı kalarak tek bir API çağrısında toplu olarak birden fazla kargo etiketi isteği gönderebilirsiniz. Kargo etiketleri Amazon tarafından oluşturulduğunda getShippingLabel
işlemi kullanılarak indirilebilir.
Not
submitShippingLabelRequest
Operasyon yalnızca Amazon operatörlerini kullanan satıcılar tarafından kullanılabilir.
Kargo etiketi gönderim taleplerini doğrulayın
Gönderim etiketi taleplerinizin durumunu aşağıdakileri kullanarak doğrulayabilirsiniz: Satıcı DF İşlemleri API'si. Sistemin gönderildikten sonra durumu göstermesi için 15 dakikaya kadar izin verin. İşlem durumu 30 dakika sonra güncellenmezse, açın Bize Ulaşın Satıcı Merkezi"ndeki vaka.
Aşağıdaki şemada, kargo etiketi isteklerinin gönderilmesine yönelik iş akışı gösterilmektedir.
İşletme gereksinimleri
-
Gönderim etiketi talebini göndermeden önce satınalma siparişinin API, EDI veya Satıcı Merkezi aracılığıyla başarıyla onaylanması gerekir. Onaylanmamış veya iptal edilmiş satın alma siparişleri için kargo etiketi talepleri reddedilir.
-
Amazon'un kendi kargo etiketlerini kullanıyorsanız istekte ürün bilgilerinin veya paket bilgilerinin gönderilmesi isteğe bağlıdır.
submitShippingLabelRequest
zorunludur
submitShippingLabelRequest
zorunludurKargo etiketleri istemek için submitShippingLabelRequest
işlemini çağırın ve şu parametreyi geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
shippingLabelRequests | Bir veya daha fazla nakliye etiketi isteyin. Türü: < ShippingLabelRequest > sıra | Evet |
İstek örneği
POST "https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels"
{
"shippingLabelRequests": [
{
"purchaseOrderNumber": "2JK3S9VC",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"containers": [
{
"containerType": "carton",
"containerIdentifier": "123",
"trackingNumber": "XXXX",
"dimensions": {
"length": "12",
"width": "12",
"height": "12",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 1,
"buyerProductIdentifier": "B07DFVDRAB",
"packedQuantity": {
"amount": 1,
"unitOfMeasure": "Each"
}
}
]
}
]
}
]
}
submitShippingLabelRequest
zorunludur
submitShippingLabelRequest
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
transactionId | Bu işlemi tanımlamak için GUID. Bu değer ile kullanılabilir Satıcı DF İşlemleri API'si Bu işlemin durumunu döndürmek için.<br.>Tür: dize | Hayır |
Yanıt örneği
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Kargo etiketi alma
nextToken">getShippingLabels
işlemi, istekte belirtilen filtre kriterlerini karşılayan tüm siparişler için kargo etiketleri döndürür. Gönderim için kullanabileceğiniz kargo etiketlerini almak üzere bu API'yi kullanmadan önce submitShippingLabelRequest
işlemini kullanarak zaten kargo etiketleri talep etmiş olmanız gerekir. Amazon, tedarikçilerin iş saatleri içinde saatte en az bir kez kargo etiketlerini kontrol etmesini önerir. İş hacminize bağlı olarak daha sık kontrol etmeyi tercih edebilirsiniz. Bir API çağrısında en fazla 100 kargo etiketi alabilirsiniz. 100'den fazla kargo etiketi varsa sonraki kargo etiketi grubunu almak için "nextToken" değerini kullanabilirsiniz.
Nakliye etiketleri, oluşturulma tarihinden 90 gün sonra sona erer ( submitShippingLabelRequest
tarih).
Not
Bu kısıtlı bir işlemdir ve yetkilendirme için bir Kısıtlanmış Veri Kodu (RDT) gerektirir. Daha fazla bilgi için Kodlar API'si Kullanım Senaryosu Rehberi'ni inceleyin.
Aşağıdaki şemada kargo etiketlerinin alınmasını sağlayan entegrasyon iş akışı gösterilmektedir:
getShippingLabels
zorunludur
getShippingLabels
zorunludurKargo etiketlerinin listesini almak için getShippingLabels
işlemini çağırın ve şu parametreleri geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
shipFromPartyId | Satıcı warehouseId sipariş yerine getirme için. Belirtilmemişse, yanıt tüm depolar için siparişleri içerecektir.Tür: dize | Hayır |
limit | Döndürülen kayıt sayısının sınırı. Tür: tamsayı | Hayır |
createdAfter | Bu tarih ve saatten sonra kullanıma sunulan kargo etiketleri yanıta dahil edilecektir.. İçinde olmalı İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) | Evet |
createdBefore | Bu tarih ve saatten önce kullanıma sunulan kargo etiketleri sonuca dahil edilecektir.. İçinde olmalı İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) | Evet |
sortOrder | Artan sırala (ASC ) veya azalan (DESC ) sipariş oluşturma tarihine göre.Tür: enum ( SortOrder ) | Hayır |
nextToken | Belirtilen sonuç boyutu sınırından daha fazla gemi etiketi olduğunda sayfalandırma için kullanılır. Belirteç değeri önceki API çağrısında döndürülür. Tür: dize | Hayır |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC
getShippingLabels
zorunludur
getShippingLabels
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
pagination | 100'den fazla kargo etiketi iade edilirse sayfalandırma için yanıtta nextToken döndürülür. | Hayır |
shippingLabels | Gemi etiketlerinin listesi. Türü: < ShippingLabel > sıra | Hayır |
Yanıt örneği
{
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"shippingLabels": [
{
"purchaseOrderNumber": "2JK3S9VC",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "PKG001",
"trackingNumber": "1Z6A34Y60369738804",
"shipMethod": "UPS_GR_RES",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here "
}
]
}, {
"purchaseOrderNumber": "2JK3S9VD",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "PKG002",
"trackingNumber": "1Z6A34Y60369738805",
"shipMethod": "UPS_GR_RES",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here "
}
]
}
]
}
Kargo etiketi alma
getShippingLabel
işlemi, satın alma siparişi numarasını kullanarak belirttiğiniz kargo etiketi hakkında bilgiler döndürür. Yanıt, satın alma siparişiyle ilgili etiket türü, satın alma siparişi ayrıntıları ve gönderim yöntemi dahil olmak üzere eksiksiz kargo etiketi bilgilerini içerir.
Nakliye etiketleri, oluşturulma tarihinden 90 gün sonra sona erer ( submitShippingLabelRequest
tarih).
Not
Bu kısıtlı bir işlemdir ve yetkilendirme için bir Kısıtlanmış Veri Kodu (RDT) gerektirir. Daha fazla bilgi için Kodlar API'si Kullanım Senaryosu Rehberi'ni inceleyin.
Bu API'yi, herhangi bir kargo etiketinin ayrıntılarını almak için de kullanabilirsiniz (tedarikçi AP üzerinden yayına girdikten sonra, son 6 aylık makaralı pencereden itibaren 7 günlük zaman aralığında).
Aşağıdaki şemada, belirli bir kargo etiketinin alınmasını sağlayan entegre iş akışı gösterilmektedir:
İşletme gereksinimleri
- Ne tür etiketler indirilebilir?
Desteklenen etiket formatları ZPL ve PNG'dir. Etiket içeriği Base 64 dize biçiminde sağlanır, böylece dizeyi istediğiniz etiket biçimine dönüştürebilirsiniz. Etiket formatının seçimi satıcıya aittir ve buna doğrudan gönderim programına katılım sürecinin bir parçası olarak karar verirler.
- Nakliye etiketini ne zaman talep etmeliyim?
Kargo etiketlerinizi yalnızca siparişlerin gönderildiği gün isteyin.
getShippingLabel
zorunludur
getShippingLabel
zorunludurKargo etiketi istemek için getShippingLabel
işlemini çağırın ve şu parametreyi geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | Kargo etiketini döndürmek istediğiniz satın alma siparişi numarası. Siparişte alınan purchaseOrderNumber ile aynı olmalıdır. | Evet |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/2JK3S9VC
getShippingLabel
zorunludur
getShippingLabel
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | Bu siparişin satınalma emri numarası. Tür: dize | Evet |
sellingParty | Satıcı tarafın veya satıcının tanımlayıcısı. Türü: PartyIdentification | Evet |
shipFromParty | Satıcının depo kodu. Türü: PartyIdentification | Evet |
labelFormat | Etiketin formatı. enum ( LabelFormat ) | Evet |
labelData | Bu gönderideki paketlerin ayrıntılarını sağlar. Türü: < LabelData > sıra | Evet |
Yanıt örneği
{
"purchaseOrderNumber": "2JK3S9VC",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "PKG001",
"trackingNumber": "1Z6A34Y60369738804",
"shipMethod": "UPS_GR_RES",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here"
}
]
}
Kargo etiketleri oluşturma
createShippingLabels
işlem bir satınalma siparişi için kargo etiketleri oluşturur ve etiketleri döndürür. Bu senkron bir işlemdir ve çağrılmasını gerektirmez Satıcı DF İşlemleri API'si.
Not
Bu kısıtlı bir işlemdir ve yetkilendirme için bir Kısıtlanmış Veri Kodu (RDT) gerektirir. Daha fazla bilgi için Kodlar API'si Kullanım Senaryosu Rehberi'ni inceleyin.
Aşağıdaki diyagram, aşağıdakileri kullanarak kargo etiketleri oluşturma iş akışını göstermektedir. createShippingLabels
operasyon.
İşletme gereksinimleri
Talep başına bir satın alma siparişi için kargo etiketlerini iade edebilirsiniz. Tek bir istekte birden çok satınalma siparişi desteklenmez.
createShippingLabels
zorunludur
createShippingLabels
zorunludurEşzamanlı olarak kargo etiketleri oluşturmak için şu numarayı arayın createShippingLabels
çalıştırın ve aşağıdaki yol parametresini geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | İstediğiniz kargo etiketleri için satınalma siparişi numarası. Tür: dize | Evet |
Aşağıdaki vücut parametrelerini ekleyebilirsiniz:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
sellingParty | Satıcı tarafın veya satıcının kimliği. Türü: PartyIdentification | Evet |
shipFromParty | Satıcının depo kodu. Türü: PartyIdentification | Evet |
containers | Bu gönderideki paketlerin bir listesi. Türü: < Container > sıra | Hayır |
İstek örneği
POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/
shipping/2021-12-28/shippingLabels/XhvBghry
{
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
}
}
createShippingLabels
zorunludur
createShippingLabels
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | Bu siparişin satınalma emri numarası. Tür: dize | Evet |
sellingParty | Satıcı tarafın veya satıcının tanımlayıcısı. Türü: PartyIdentification | Evet |
shipFromParty | Satıcının depo kodu. Türü: PartyIdentification | Evet |
labelFormat | Etiketin formatı. enum ( LabelFormat ) | Evet |
labelData | Bu gönderideki paketlerin ayrıntılarını sağlar. Türü: < LabelData > sıra | Evet |
Yanıt örneği
{
"purchaseOrderNumber": "XhvBghry",
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"labelFormat": "PNG",
"labelData": [
{
"packageIdentifier": "1",
"trackingNumber": "1Z69664F0310685739",
"shipMethod": "UPS_GR_RES_SIG",
"shipMethodName": "UPS Ground Residential",
"content": "Base 64 encoded string goes here"
}
]
}
Yanıt örneği (hata)
{
"errors": [
{
"code": "InvalidInput",
"message": "[MISMATCHED_ITEM]: Request Rejected: Order quantity does not match the shipped quantity. All items in the order must be provided. Ensure you add the correct quantity of shipped items to packages. For items - ${fnSku}, the expected quantity is ${expectedQuantity}, but the provided quantity is ${providedQuantity}.",
"details": ""
}
]
}
Olası hata yanıtı ayrıntılarının listesi
Aşağıdaki tablo, olası tüm hata yanıtı ayrıntılarının bir listesini içerir. İsteği yeniden denemeden önce hata durumunu çözmek için atılması gereken önerilen adımlar dahildir. Bu olası hataları tahmin etmek ve ele almak için uygulamanızda bir hata işleme mekanizması tasarlamalısınız.
Zamanla ek hata yanıtlarının eklenmesi mümkündür, bu nedenle uygulamanız da bu listeye dahil edilmeyen hataları zarif bir şekilde işlemeye hazır olmalıdır.
Önündeki parantezli değerler \$
Mesaj sütununda görünen (örneğin, \${fnSku}
) hata yanıtında gerçek değerlerle değiştirilir.
Kod | Mesaj | Details |
---|---|---|
InvalidInput | [MISMATCHED_ITEM]: Talep Reddedildi: Sipariş miktarı gönderilen miktarla eşleşmiyor. Siparişteki tüm öğeler sağlanmalıdır. Paketlere doğru miktarda gönderilen ürün eklediğinizden emin olun. Öğeler için - ${fnSku}, beklenen miktar ${expectedQuantity}, ancak verilen miktar ${providedQuantity}. | Yok |
InvalidInput | [NO_ITEMS_PRESENT]: Talep Reddedildi: Sipariş Kimliği ${shipmentId} herhangi bir pakete atanmamış öğelere sahiptir. Lütfen tüm öğelerin paket (ler) le eşlendiğinden emin olun. | Yok |
InvalidInput | [PACKAGE_DIMENSION_NOT_VALID]: Talep Reddedildi: Sipariş Kimliği ${shipmentId} paket (ler) için geçersiz bir boyuta sahip. Lütfen paketleriniz için geçerli boyutlar ekleyin. | Yok |
InvalidInput | [PACKAGE_WEIGHT_NOT_VALID]: İstek Reddedildi: Sipariş Kimliği ${shipmentId} paket (ler) in geçersiz ağırlığı var. Lütfen paketleriniz için geçerli ağırlık ekleyin. | Yok |
InvalidInput | [PIECE_NUMBER_ONE_NOT_PROVIRED]: Konteyner sıra numarası '1' en az bir öğe için sağlanmamıştır. Konteyner sıra numarasının eksik olup olmadığını kontrol edin | Yok |
InvalidInput | [INCONSISTENT_PIECE_NUMBER_QUANTITY]: En az bir öğenin konteyner sıra numarası ya tutarlı değil ya da öğe miktarı ile uyumsuz. Konteyner sıra numarasının doğru olduğunu ve her bir öğenin miktarının öğe sıra numarasıyla aynı olduğunu doğrulayın | Yok |
InvalidInput | [INVALID_VENDOR_CODE]: Geçersiz satıcı kodu ${vendorCode}. Sipariş için satıcı kodunun doğru olduğunu doğrulayın | Yok |
InvalidInput | [INVALID_ORDER_ID_WAREHOUSE_COMBINATION]: Kargo Etiketi Reddedildi: Sipariş Kimliği ${shipmentId} depoya ait değil ${warehouseCode}. Lütfen depo kodu ve Sipariş Kimliğinin doğru olduğunu doğrulayın | Yok |
InvalidInput | [INCORRECT_VENDOR_GROUP_ID]: Geçersiz satıcı grubu Kimliği ${vendorGroupId}. Sipariş için satıcı grubu kimliğinin doğru olduğunu doğrulayın | Yok |
InvalidInput | [DUPLICATE_VENDOR_PACKAGE_ID]: Yinelenen VendorPackageID'leri. Lütfen Yinelenen konteyner tanımlayıcılarını düzeltin ve tekrar deneyin | Yok |
InvalidInput | [EMPTY_VENDOR_PACKAGE_ID]: Geçersiz VendorPackageIDs. Lütfen Geçersiz konteyner tanımlayıcılarını düzeltin ve tekrar deneyin | Yok |
InvalidInput | [GEMİ YÖNTEMİ_DESTEKLENMİYOR_]: ${ship_method} desteklenmiyor. $ için etiket oluşturmak için mevcut kurulumunuzu kullanın{ship_method} | Yok |
InvalidInput | [SHIP_METHOD_CHANGED]: Bu PO için gemi yöntemi $'dan değişti{old_ship_method} $ 'a{ship_method}. $ için etiket oluşturmak için mevcut kurulumunuzu kullanın{ship_method} | Yok |
InvalidInput | [INCONSISTENT_SHIP_METHODS]: İstek Reddedildi: Farklı paketler arasında farklı gemi yöntemleri atanır. Tüm eşyaları tek bir kutuda göndermeye çalışın. Bu mümkün değilse, lütfen bizimle iletişime geçin. | Yok |
ConflictError | [SHIPMENT_NOT_MUTABLE]: Talep Reddedildi: Sipariş Kimliği $ için paket boyutları{shipmentId} mevcut durumla güncellenemez. Başka bir işlem gerekmez. | Yok |
ConflictError | [ORDER_SHIPPED_WITH_VENDOR_LABEL]: Siparişi zaten Amazon Transportation dışındaki bir taşıyıcıyla gönderdiniz, bu nedenle bu siparişin etiketini yazdıramazsınız. Hiçbir işlem gerekli değildir. Gönderilen siparişi zaten onayladınız. | Yok |
InternalFailure | Dahili bir hatayla karşılaştık. Lütfen tekrar deneyin. | Yok |
Kargo Onaylarını Gönderin
submitShipmentConfirmations
işlemi, satıcıların Amazon'a kargo onayları göndermesini sağlar. Kargo onayınız, kargolarınızı verimli bir şekilde takip etmemizi ve müşterilerimizi bilgilendirmemizi sağlar. Satın alma siparişi numarası, kargo tarihi, tahmini teslimat tarihi ve takip numarası dahil olmak üzere gönderilen ürünler hakkında bilgiler içerir.
Kargo onayları, kargolarınızı takip etmek için kargo firmalarıyla daha etkili bir şekilde iş birliği yapmamızı sağlar.
Geçerli kargo onaylarının olmaması şunlara neden olabilir:
-
Kargolar hakkında yetersiz görünürlük.
-
Fiziksel gönderimlerin satın alma siparişleri ile mutabakatında hatalar.
-
Tutarsızlıkları gidermek için manuel takip işlemleri.
Başarıyla gönderilen kargo onaylarının doğrulanması
Satıcılar, gönderi onaylarının durumunu şu şekilde doğrulayabilir: Satıcı Merkezi > Siparişler > Doğrudan Gönderim Siparişleri veya kullanarak Satıcı DF İşlemleri API'si. Sistemin gönderildikten sonra durumu belirlemesi için 10 dakikaya kadar izin verin. Satıcı Merkezi, gönderi onayı için doğru değerleri göstermiyorsa, açın Bize Ulaşın Satıcı Merkezi"ndeki vaka. Gönderi onayları oluşturma hakkında bilgi için İş Gereksinimleri bölümüne bakın.
Aşağıdaki şemada, kargo onaylarını gönderilmesini sağlayan entegre iş akışı gösterilmektedir:
İşletme gereksinimleri
-
Sipariş deponuzdan gönderildikten sonraki dört saat içinde bir siparişin gönderilmesini onaylamak için bu API'yi kullanın.
-
Katta reddedilen kargolar için
shipmentStatus
alan değeriniFLOOR_DENIAL
olarak ayarlayın. -
Tüm satın alma siparişi satır öğeleri gönderim onayında bulunmalıdır. Kısmi sipariş gönderimine izin verilmez. Tedarikçiler, satır öğelerinden herhangi birinin yerine getirilememesi durumunda siparişi kat reddi olarak reddetmelidir.
-
Ürünlerin
itemSequenceNumber
öğesi, sipariş mesajında alınanla aynı olmalıdır. -
Kargo onayında
buyerProductIdentifier
veyavendorProductIdentifier
gönderilmesi zorunludur. Satın alma siparişinde alınanla aynı değeri göndermeniz gerekir. -
VOC'ler için gönderme
scacCode
zorunludur. -
Kargo etiketi Amazon tarafından sağlanıyorsa Amazon'un paket bilgilerine erişimi olduğundan konteyner bölümü isteğe bağlıdır. "Ürünler" bölümünün gönderilmesi zorunludur.
-
Bir gönderi onayındaki konteynerde belirtilen bir ShipMethod olmalıdır.
submitShipmentConfirmations
zorunludur
submitShipmentConfirmations
zorunludurKargo onaylarını göndermek için submitShipmentConfirmations
işlemini çağırın ve şu parametreyi geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
shipmentConfirmations | Onaylanmış gönderilerin listesi. Türü: < ShipmentConfirmation > sıra | Evet |
İstek örneği
POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shipmentConfirmations
{
"shipmentConfirmations": [
{
"purchaseOrderNumber": "PO00050003",
"shipmentDetails": {
"shippedDate": "2019-08-07T19:56:45.632Z",
"shipmentStatus": "SHIPPED",
"isPriorityShipment": true,
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z"
},
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"partyId": "VENDORWAREHOUSECODE"
},
"items": [
{
"itemSequenceNumber": 1,
"buyerProductIdentifier": "ASIN001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
},
{
"itemSequenceNumber": 2,
"buyerProductIdentifier": "ASIN002",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
},
{
"itemSequenceNumber": 3,
"buyerProductIdentifier": "ASIN003",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
},
{
"itemSequenceNumber": 4,
"buyerProductIdentifier": "ASIN004",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
],
"containers": [
{
"containerType": "carton",
"containerIdentifier": "123",
"trackingNumber": "TRACK001",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 1,
"buyerProductIdentifier": "ASIN001",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
},
{
"containerType": "carton",
"containerIdentifier": "234",
"trackingNumber": "TRACK002",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 2,
"buyerProductIdentifier": "ASIN002",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
},
{
"containerType": "carton",
"containerIdentifier": "ABCD",
"trackingNumber": "TRACK003",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 3,
"buyerProductIdentifier": "ASIN003",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
},
{
"containerType": "carton",
"containerIdentifier": "id12",
"trackingNumber": "TRACK004",
"scacCode": "SCAC001",
"carrier": "ABCD001",
"shipMethod": "UPS",
"dimensions": {
"length": "10",
"width": "10",
"height": "10",
"unitOfMeasure": "IN"
},
"weight": {
"unitOfMeasure": "KG",
"value": "10"
},
"packedItems": [
{
"itemSequenceNumber": 4,
"buyerProductIdentifier": "ASIN004",
"packedQuantity": {
"amount": 100,
"unitOfMeasure": "Each"
}
}
]
}
]
}
]
}
submitShipmentConfirmations
zorunludur
submitShipmentConfirmations
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
transactionId | Bu işlemi tanımlamak için GUID. Bu değer ile kullanılabilir Satıcı DF İşlemleri API'si Bu işlemin durumunu döndürmek için. Tür: dize | Evet |
Yanıt örneği
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Kargo Durumu Güncellemelerini Gönderin
Dikkat
Yalnızca Satıcının Kendi Taşıyıcı (VOC) satıcıları, Gönderi Durumu Güncellemelerini kullanabilir. Bu, gönderileri müşterilere taşımak için Amazon taşıyıcıları yerine gönderi teslimatı için kendi taşıyıcılarını kullanan satıcılar anlamına gelir. VOC satıcıları nihayetinde nakliye maliyetlerini ve müşterilere gönderileri teslim etme sorumluluğunu karşılar.
submitShipmentStatusUpdates
işlemi, tedarikçilerin son müşteriye giden kargolar için nakliye durumu olayını güncellemelerine olanak tanır. VOC tedarikçilerinin nakliye aşamasında kargo durumunu (genellikle taramalar olarak bilinir) güncellemeleri gerekir.
Bu bilgiler daha sonra "Siparişleriniz" sayfasında Amazon müşterilerine iletilir. Böylece sipariş takibi ve teslimat sürecinde görünürlük artar.
Sevkiyat durumu güncellemelerinin yapılmaması, düşük tarama oranı ve nihayetinde deponun askıya alınması gibi operasyonel KPI'ların karşılanamamasına neden olabilir.
Başarıyla gönderilen kargo durumu güncellemelerinin doğrulanması
Satıcılar, gönderi durumu güncellemelerinin durumunu şu adresten doğrulayabilir: Satıcı Merkezi > Siparişler > Doğrudan Gönderim Siparişleri veya kullanarak Satıcı DF İşlemleri API'si. Sistemin gönderildikten sonra durumu belirlemesi için 10 dakikaya kadar izin verin. Satıcı Merkezi, gönderi onayı için doğru değerleri göstermiyorsa, açın Bize Ulaşın Satıcı Merkezi"ndeki vaka. Gönderi onayları oluşturma hakkında bilgi için İş Gereksinimleri bölümüne bakın.
Aşağıdaki şemada, kargo durumu güncellemelerinin gönderilmesini sağlayan entegre iş akışını gösterilmektedir:
İşletme gereksinimleri
-
Bu API'yi yalnızca gönderiyi müşteriye taşımak için kendi taşıyıcınızı (VOC satıcısısınız) kullanıyorsanız kullanın.
-
Gönderim onaylandıktan sonra (API veya Satıcı Merkezi aracılığıyla) bir gönderinin durumunu güncellemek için bu API'yi kullanın.
-
trackingNumber
gönderi durumu API'sinde eşleşmelidirtrackingNumber
sevkiyat onayında sağlanmıştır. Eşleşmezse gönderi durumu güncellemesi başarısız olur. -
Bir
submitShipmentStatusUpdates
çağrı bir fiziksel pakete karşılık gelmelidir. Bir API çağrısında birkaç paketin gönderi durumu durumunu bir dizi gönderi durumu güncellemesi olarak toplu olarak toplayarak güncelleyebilirsiniz. -
Gönderim siparişi, müşteriye teslim edilecek birkaç fiziksel paketle sonuçlanabilir. Bu nedenle, siparişin tamamının kargo durumunu yansıtmak için birkaç kargo durumu güncellemesi gerekir.
-
Tedarikçiler, Amazon Kargo Durumu yönergelerini uygulayarak mümkün olduğunda kargo durumunu göndermelidir.
-
Tedarikçiler, planlı kargo siparişlerinde tahmini kargo süresini ve kargo zaman aralığını belirten
shipmentSchedule
dizisini göndermelidir.
Ek alanlar
statusCode
ve reasonCode
Belirli bir durum olayını ve durum olayının nedenini sağlamak için kullanılan EDI standartlarında (örneğin ISA X12 ve EDIFACT) kullanılan standart kodlardır. Belirli bir kombinasyon bekliyoruz statusCode
ve reasonCode
son müşteriye sevkiyat taşımacılığı aşamasında bir olayı belirleyen.
Bunlar, desteklediğimiz durum ve neden kodları ile bunların mevcut Vendor Central'daki karşılıklarıdır:
EDIFACT durum kodu | EDIFACT sebep kodu | Operasyonel Açıklama | Vendor Central UI equivalency |
---|---|---|---|
404 | 117 | Büyük çaplı bir kaza nedeniyle kargo ertelendi | DELAYED |
301 | 000 | Kargo müşteriye teslim edildi | DELIVERED |
101 | 000 | Kargo FC'den ayrıldı | DEPARTED_FROM_FC |
201 | 000 | Kargo, taşıyıcı tesisine ulaştı | IN_TRANSIT |
409 | 000 | Taşıyıcı kargoyu kaybetti | LOST |
302 | 000 | Kargo, teslimat için çıktı | OUT_FOR_DELIVERY |
407 | 000 | Alıcı kargoyu reddetti | REJECTED |
416 | 000 | Kargo teslim edilemiyor ve imha edilecek | UNDELIVERABLE |
X12 durum kodu | X12 sebep kodu | Operasyonel Açıklama | Vendor Central UI equivalency |
---|---|---|---|
DE | AF | Büyük çaplı bir kaza nedeniyle kargo ertelendi | DELAYED |
D1 | NNS | Kargo müşteriye teslim edildi | DELIVERED |
XB | NNS | Kargo FC'den ayrıldı | DEPARTED_FROM_FC |
O1 | NNS | Kargo, taşıyıcı tesisine ulaştı | IN_TRANSIT |
CA | PL | Taşıyıcı kargoyu kaybetti | LOST |
OD | NNS | Kargo, teslimat için çıktı | OUT_FOR_DELIVERY |
A7 | AM | Alıcı kargoyu reddetti | REJECTED |
AP | BG | Kargo teslim edilemiyor ve imha edilecek | UNDELIVERABLE |
submitShipmentStatusUpdates
zorunludur
submitShipmentStatusUpdates
zorunludurKargo durumu güncellemelerini göndermek için submitShipmentStatusUpdates
işlemini çağırın ve şu parametreyi geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
shipmentStatusUpdates | Onaylanmış gönderilerin listesi. Türü: < ShipmentStatusUpdate > sıra | Evet |
İstek örneği
POST https://sellingpartnerapi-na.amazon.com/ /vendor/directFulfillment/shipping/2021-12-28/shipmentStatusUpdates
{
"shipmentStatusUpdates": [
{
"purchaseOrderNumber": "DX00050015",
"sellingParty":
{
"partyId": "999US"
},
"shipFromParty":
{
"partyId": "ABCD"
},
"statusUpdateDetails":
{
"trackingNumber": "TRACK005",
"statusDateTime": "2020-08-07T19:56:45Z",
"statusCode": "D1",
"reasonCode": "NS",
"statusLocationAddress":
{
"name": "ABC",
"addressLine1": "1st street",
"city": "Seattle",
"countryCode": "US",
"postalCode": "124",
"stateOrRegion": "CA"
}
}
}
]
}
submitShipmentStatusUpdates
zorunludur
submitShipmentStatusUpdates
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
transactionId | Bu işlemi tanımlamak için GUID. Bu değer ile kullanılabilir Satıcı DF İşlemleri API'si Bu işlemin durumunu döndürmek için. Tür: dize | Evet |
Yanıt örneği
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Sevk irsaliyesi alın
getPackingSlips
işlemi, belirtilen kriterleri karşılayan siparişler için sevk irsaliyelerinin bir listesini döndürür. Belirli bir sipariş için sevk irsaliyesi almanız gerekiyorsa bunun yerine getPackingSlip
işlemini kullanın.
Not
Bu kısıtlı bir işlemdir ve yetkilendirme için bir Kısıtlanmış Veri Kodu (RDT) gerektirir. Daha fazla bilgi için Kodlar API'si Kullanım Senaryosu Rehberi'ni inceleyin.
Gönderim için kullanabileceğiniz satın alma siparişleri için sevk irsaliyelerini almak için bu API'yi kullanmalısınız. Amazon, satıcıların iş saatleri içinde saatte en az bir kez siparişleri kontrol etmelerini önerir. İşletmenizin hacmine bağlı olarak, daha sık kontrol etmeyi seçebilirsiniz. Bir API çağrısında 100'e kadar sevk irsaliyesi alabilirsiniz. 100'den fazla sevk irsaliyesi varsa, kullanabilirsiniz nextToken
Bir sonraki sevk irsaliyesi setini almak için bir sonraki isteğinizde bir parametre olarak değer.
Aşağıdaki şemada, sevk irsaliyelerini alırken kullanılan entegre iş akışını gösterilmektedir:
getPackingSlips
zorunludur
getPackingSlips
zorunludurSevkiyat irsaliyelerini almak için getPackingSlips
işlemini çağırın ve şu parametreleri geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
shipFromPartyId | Satıcı warehouseId siparişin yerine getirileceği. Belirtilmemişse sonuç tüm depolar için siparişleri içerecektir.Tür: dize | Hayır |
limit | Döndürülen kayıt sayısının sınırı. Tür: tamsayı | Hayır |
createdAfter | Bu tarih ve saatten sonra kullanıma sunulan sevkiyat fişleri sonuca dahil edilecektir.. İçinde olmalı İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) | Evet |
createdBefore | Bu tarih ve saatten önce kullanıma sunulan sevkiyat fişleri sonuca dahil edilecektir.. İçinde olmalı İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) | Evet |
sortOrder | Artan sırala (ASC ) veya azalan (DESC ) sevk irsaliyesi oluşturma tarihine göre.Tür: enum ( SortOrder ) | Hayır |
nextToken | Belirtilen sonuç boyutu sınırından daha fazla sipariş olduğunda sayfalandırma için kullanılır. Belirteç değeri önceki API çağrısında döndürülür. Tür: dize | Hayır |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/packingSlips?createdBefore=2020-06-12T12:00:00-08:00&createdAfter=2020-06-12T00:00:00-08:00&limit=2&sortOrder=DESC
getPackingSlips
zorunludur
getPackingSlips
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
pagination | 100'den fazla sipariş döndürülürse sayfalandırma için yanıtta nextToken döndürülür. | Hayır |
packingSlips | Sevk irsaliyeleri için detayları içerir. Türü: < PackingSlip > sıra | Hayır |
Yanıt örneği
{
"pagination": {
"nextToken": "NEBxNEBxNEBxNR=="
},
"packingSlips": [
{
"purchaseOrderNumber": "UvgABdBjQ",
"content": "base64 encoded string",
"contentType": "application/pdf"
},
{
"purchaseOrderNumber": "VvgCDdBjR",
"content": "base64 encoded string",
"contentType": "application/pdf"
}
]
}
Sevk irsaliyesi alın
getPackingSlip
işlem, belirttiğiniz satınalma emri numarası için sevk irsaliyesini döndürür. Yanıt, paketleme fişinin base64 kodlu dizesini içerir. İçerik türü her zaman “application/pdf” olacaktır.
Not
Bu kısıtlı bir işlemdir ve yetkilendirme için bir Kısıtlanmış Veri Kodu (RDT) gerektirir. Daha fazla bilgi için Kodlar API'si Kullanım Senaryosu Rehberi'ni inceleyin.
Aşağıdaki şemada, sevk irsaliyesi alınırken kullanılan entegre iş akışı gösterilmektedir:
İşletme gereksinimleri
- Tüm siparişler için sevk irsaliyesi gerekli midir?
Bir sevk irsaliyesi yalnızca İşletmeden İşletmeye (B2B) sipariş veya hediye siparişi içinse gereklidir. Değeri ne zaman isPslipRequired
alan doğrudur, sipariş için bir sevk irsaliyesi gereklidir.
getPackingSlip
zorunludur
getPackingSlip
zorunludurSevkiyat irsaliyesi döndürmek için getPackingSlip
işlemini çağırın ve şu parametreyi geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | purchaseOrderNumber İstediğiniz sevkiyat fişi için.Tür: dize | Evet |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com /vendor/directFulfillment/shipping/2021-12-28/packingSlips/UkP3YkKDr
getPackingSlip
zorunludur
getPackingSlip
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | Gönderinin satın alma sipariş numarası. Tür: dize | Evet |
content | Paketleme fişinin PDF'sinin Base64 kodlu dizesi. Tür: dize | Evet |
contentType | Dosyanın biçimi (PDF, JPEG gibi). Tür: enum ( ContentType ) | Hayır |
Yanıt örneği
{
"purchaseOrderNumber": "UvgABdBjQ",
"content": "base64 encoded string",
"contentType": "application/pdf"
}
Müşteri faturalarını alın (yalnızca Hindistan)
getCustomerInvoices
işlem, belirttiğiniz filtre kriterlerini karşılayan tüm satın alma siparişleri için müşteri faturalarını döndürür.
Önemli
getCustomerInvoices
Hindistan pazarında operasyon zorunludur. Başka herhangi bir pazar için mevcut değildir.
Amazon, satıcıları çalışma saatleri içinde saatte en az bir kez müşteri faturalarını kontrol etmeye teşvik eder. İşletmenizin hacmine bağlı olarak, daha sık kontrol etmeyi seçebilirsiniz. Bir API çağrısında 100'e kadar müşteri faturası alabilirsiniz. 100'den fazla müşteri faturası varsa şunları kullanabilirsiniz nextToken
Bir sonraki müşteri faturası setini almak için bir sonraki istekte bir parametre olarak değer.
Not
Bu kısıtlı bir işlemdir ve yetkilendirme için bir Kısıtlanmış Veri Kodu (RDT) gerektirir. Daha fazla bilgi için Kodlar API'si Kullanım Senaryosu Rehberi'ni inceleyin.
Aşağıdaki şemada, müşteri faturalarını alırken kullanılan entegrasyon iş akışını gösterilmektedir:
getCustomerInvoices
zorunludur
getCustomerInvoices
zorunludurMüşteri faturalarını döndürmek için getCustomerInvoices
işlemini çağırın ve şu parametreleri geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
shipFromPartyId | Satıcı warehouseId siparişin yerine getirileceği. Belirtilmemişse, sonuç tüm depolar için siparişleri içerecektir.Tür: dize | Hayır |
limit | Döndürülen kayıt sayısının sınırı. Tür: tamsayı | Hayır |
createdAfter | Bu tarih ve saatten sonra kullanılabilir hale gelen siparişler sonuca dahil edilecektir.. İçinde olmalı İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) | Evet |
createdBefore | Bu tarih ve saatten önce kullanıma sunulan siparişler sonuca dahil edilecektir.. İçinde olmalı İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) | Evet |
sortOrder | Artan sırala (ASC ) veya azalan (DESC ) sipariş oluşturma tarihine göre.Tür: enum ( SortOrder ) | Hayır |
nextToken | Belirtilen sonuç boyutu sınırından daha fazla gemi etiketi olduğunda sayfalandırma için kullanılır. Belirteç değeri önceki API çağrısında döndürülür. Tür: dize | Hayır |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/customerInvoices?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC
getCustomerInvoices
zorunludur
getCustomerInvoices
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
pagination | 100'den fazla müşteri faturası iade edilirse, nextToken sayfalandırma yanıtında döndürülür.Türü: Sayfalandırma | Hayır |
customerInvoices | Müşteri faturalarının listesi. Türü: < CustomerInvoice > sıra | Hayır |
Yanıt örneği
{
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"customerInvoices": [
{
"purchaseOrderNumber": "PO98676856",
"content": "base 64 content goes here"
}
]
}
Müşteri faturası alın (yalnızca Hindistan)
getCustomerInvoice
işlemi, satın alma siparişi numarasını kullanarak belirttiğiniz müşteri faturası hakkındaki bilgileri döndürür. Yanıt, söz konusu satın alma siparişi için eksiksiz müşteri fatura bilgilerini içerir.
Not
Bu kısıtlı bir işlemdir ve yetkilendirme için bir Kısıtlanmış Veri Kodu (RDT) gerektirir. Daha fazla bilgi için Kodlar API'si Kullanım Senaryosu Rehberi'ni inceleyin.
Bu API'yi herhangi bir müşteri faturasının ayrıntılarını almak için de kullanabilirsiniz (tedarikçinin API'de yayınlanmasından sonra son 6 aylık bir döneme ait 7 günlük bir zaman aralığında).
Aşağıdaki şemada, müşteri faturasının döndürülmesini sağlayan entegrasyon iş akışı gösterilmektedir:
İşletme gereksinimleri
Ne tür müşteri faturaları indirilebilir?
Müşteri faturası, binary64 dize biçiminde kodlanmış bir PDF dosyasıdır. IN bölgesi için tüm satın alma siparişlerinde, sevkiyatla birlikte gönderilmesi gereken bir müşteri faturası oluşturulmalıdır.
getCustomerInvoice
zorunludur
getCustomerInvoice
zorunludurMüşteri faturası döndürmek için getCustomerInvoice
işlemini çağırın ve şu parametreyi geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | Faturanın iade edileceği gönderinin satın alma siparişi numarası. Tür: dize | Evet |
İstek örneği
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/2JK3S9VC
getCustomerInvoice
zorunludur
getCustomerInvoice
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
purchaseOrderNumber | Bu siparişin satınalma emri numarası. Tür: dize | Evet |
content | Base64 kodlu müşteri faturası. Tür: dize | Evet |
Yanıt örneği
{
"purchaseOrderNumber": "PO98676856",
"content": "base 64 encoded string"
}
Konteyner etiketi oluşturma
Kullan createContainerLabel
Paletli her yük için Amazon'dan bir palet etiketi talep etme ve alma işlemi. Yanıt, etiket türünü ve palet kimliğini içeren 4X6 yazdırılabilir palet etiketi içerir.
İşletme gereksinimleri
createContainerLabel
işlem, bir API çağrısında birden fazla palet etiketi isteğini desteklemez. Birden fazla palet için palet etiketlerini almak istiyorsanız, birden fazla palet göndermelisiniz createContainerLabel
Paralel olarak istekler.
createContainerLabel
zorunludur
createContainerLabel
zorunludurKargo etiketi istemek için createContainerLabel
işlemini çağırın ve şu parametreyi geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
sellingParty | Satıcı tarafın veya satıcının kimliği. Türü: PartyIdentification | Evet |
shipFromParty | Satıcının depo kodu. Türü: PartyIdentification | Evet |
vendorContainerId | Satıcının konteyner için benzersiz tanımlayıcısı. Türü: VendorContainerId | Evet |
carrierId | Konteyner (palet) etiketinin taşıyıcısı. Türü: CarrierId | Evet |
packages | Gönderi paketlerini bir konteyner ile ilişkilendiren paket nesneleri dizisi. Türü: Packages | Evet |
İstek örneği
POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/containerLabel
{
"sellingParty": {
"partyId": "999US"
},
"shipFromParty": {
"partyId": "ABCD"
},
"vendorContainerId": "000011189212211212",
"carrierId": "SWA",
"packages": [
{
"packageTrackingNumber": "TBA134335066000"
},
{
"packageTrackingNumber": "TBA214335089000"
},
{
"packageTrackingNumber": "TBA311235066000"
}
]
}
createContainerLabel
zorunludur
createContainerLabel
zorunludurBaşarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
containerTrackingNumber | Nakliye operatöründen konteyner (palet) izleme tanımlayıcısı. Tür: dize | Evet |
content | Kapsayıcı etiketi içeriği bir Base64 dizesine kodlanmıştır. Tür: dize | Evet |
format | Konteyner etiketinin biçimi. Türü: ContainerLabelFormat | Evet |
Yanıt örneği
{
"containerLabel": {
"containerTrackingNumber": "TBA134335066000",
"content": "Base64 encoded string",
"format": "PNG"
}
}
Updated 12 days ago