Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

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

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.

The Direct Fulfillment integration workflow for submitting shipping label requests.

İş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

Kargo etiketleri istemek için submitShippingLabelRequest işlemini çağırın ve şu parametreyi geçirin:

AdAçıklamaZorunlu mu?
shippingLabelRequestsBir 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
transactionIdBu 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: dizeHayı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 ( submitShippingLabelRequesttarih).

📘

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:

The Direct Fulfillment integration workflow when retrieving shipping labels.

getShippingLabels zorunludur

Kargo etiketlerinin listesini almak için getShippingLabels işlemini çağırın ve şu parametreleri geçirin:

AdAçıklamaZorunlu mu?
shipFromPartyIdSatı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
limitDöndürülen kayıt sayısının sınırı.
Tür: tamsayı
Hayır
createdAfterBu 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
createdBeforeBu 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
sortOrderArtan sırala (ASC) veya azalan (DESC) sipariş oluşturma tarihine göre.
Tür: enum (SortOrder)
Hayır
nextTokenBelirtilen 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
pagination100'den fazla kargo etiketi iade edilirse sayfalandırma için yanıtta nextToken döndürülür.Hayır
shippingLabelsGemi 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 ( submitShippingLabelRequesttarih).

📘

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:

The Direct Fulfillment integration workflow for retrieving a specific shipping label.

İş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

Kargo etiketi istemek için getShippingLabel işlemini çağırın ve şu parametreyi geçirin:

AdAçıklamaZorunlu mu?
purchaseOrderNumberKargo 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
purchaseOrderNumberBu siparişin satınalma emri numarası.
Tür: dize
Evet
sellingPartySatıcı tarafın veya satıcının tanımlayıcısı.
Türü: PartyIdentification
Evet
shipFromPartySatıcının depo kodu.
Türü: PartyIdentification
Evet
labelFormatEtiketin formatı.
enum (LabelFormat)
Evet
labelDataBu 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.

The Direct Fulfillment integration workflow for creating shipping labels synchronously.

İş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

Eş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:

AdAçıklamaZorunlu mu?
purchaseOrderNumberİstediğiniz kargo etiketleri için satınalma siparişi numarası.
Tür: dize
Evet

Aşağıdaki vücut parametrelerini ekleyebilirsiniz:

AdAçıklamaZorunlu mu?
sellingPartySatıcı tarafın veya satıcının kimliği.
Türü: PartyIdentification
Evet
shipFromPartySatıcının depo kodu.
Türü: PartyIdentification
Evet
containersBu 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
purchaseOrderNumberBu siparişin satınalma emri numarası.
Tür: dize
Evet
sellingPartySatıcı tarafın veya satıcının tanımlayıcısı.
Türü: PartyIdentification
Evet
shipFromPartySatıcının depo kodu.
Türü: PartyIdentification
Evet
labelFormatEtiketin formatı.
enum (LabelFormat)
Evet
labelDataBu 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.

KodMesajDetails
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 edinYok
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ınYok
InvalidInput[INVALID_VENDOR_CODE]: Geçersiz satıcı kodu ${vendorCode}. Sipariş için satıcı kodunun doğru olduğunu doğrulayınYok
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ınYok
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ınYok
InvalidInput[DUPLICATE_VENDOR_PACKAGE_ID]: Yinelenen VendorPackageID'leri. Lütfen Yinelenen konteyner tanımlayıcılarını düzeltin ve tekrar deneyinYok
InvalidInput[EMPTY_VENDOR_PACKAGE_ID]: Geçersiz VendorPackageIDs. Lütfen Geçersiz konteyner tanımlayıcılarını düzeltin ve tekrar deneyinYok
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
InternalFailureDahili 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:

The Direct Fulfillment integration workflow for submitting shipment confirmations.

İş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ğerini FLOOR_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 veya vendorProductIdentifier 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

Kargo onaylarını göndermek için submitShipmentConfirmations işlemini çağırın ve şu parametreyi geçirin:

AdAçıklamaZorunlu mu?
shipmentConfirmationsOnaylanmış 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
transactionIdBu 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:

The Direct Fulfillment integration workflow for submitting shipment status updates.

İş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şmelidir trackingNumber 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 koduEDIFACT sebep koduOperasyonel AçıklamaVendor Central UI equivalency
404117Büyük çaplı bir kaza nedeniyle kargo ertelendiDELAYED
301000Kargo müşteriye teslim edildiDELIVERED
101000Kargo FC'den ayrıldıDEPARTED_FROM_FC
201000Kargo, taşıyıcı tesisine ulaştıIN_TRANSIT
409000Taşıyıcı kargoyu kaybettiLOST
302000Kargo, teslimat için çıktıOUT_FOR_DELIVERY
407000Alıcı kargoyu reddettiREJECTED
416000Kargo teslim edilemiyor ve imha edilecekUNDELIVERABLE
X12 durum koduX12 sebep koduOperasyonel AçıklamaVendor Central UI equivalency
DEAFBüyük çaplı bir kaza nedeniyle kargo ertelendiDELAYED
D1NNSKargo müşteriye teslim edildiDELIVERED
XBNNSKargo FC'den ayrıldıDEPARTED_FROM_FC
O1NNSKargo, taşıyıcı tesisine ulaştıIN_TRANSIT
CAPLTaşıyıcı kargoyu kaybettiLOST
ODNNSKargo, teslimat için çıktıOUT_FOR_DELIVERY
A7AMAlıcı kargoyu reddettiREJECTED
APBGKargo teslim edilemiyor ve imha edilecekUNDELIVERABLE

submitShipmentStatusUpdates zorunludur

Kargo durumu güncellemelerini göndermek için submitShipmentStatusUpdates işlemini çağırın ve şu parametreyi geçirin:

AdAçıklamaZorunlu mu?
shipmentStatusUpdatesOnaylanmış 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
transactionIdBu 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:

The Direct Fulfillment integration workflow when retrieving packing slips.

getPackingSlips zorunludur

Sevkiyat irsaliyelerini almak için getPackingSlips işlemini çağırın ve şu parametreleri geçirin:

AdAçıklamaZorunlu mu?
shipFromPartyIdSatıcı warehouseId siparişin yerine getirileceği. Belirtilmemişse sonuç tüm depolar için siparişleri içerecektir.
Tür: dize
Hayır
limitDöndürülen kayıt sayısının sınırı.
Tür: tamsayı
Hayır
createdAfterBu 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
createdBeforeBu 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
sortOrderArtan sırala (ASC) veya azalan (DESC) sevk irsaliyesi oluşturma tarihine göre.
Tür: enum (SortOrder)
Hayır
nextTokenBelirtilen 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
pagination100'den fazla sipariş döndürülürse sayfalandırma için yanıtta nextToken döndürülür.Hayır
packingSlipsSevk 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:

The Direct Fulfillment integration workflow when retrieving a packing slip.

İş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

Sevkiyat irsaliyesi döndürmek için getPackingSlip işlemini çağırın ve şu parametreyi geçirin:

AdAçıklamaZorunlu 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
purchaseOrderNumberGönderinin satın alma sipariş numarası.
Tür: dize
Evet
contentPaketleme fişinin PDF'sinin Base64 kodlu dizesi.
Tür: dize
Evet
contentTypeDosyanı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:

The Direct Fulfillment integration workflow when retrieving customer invoices.

getCustomerInvoices zorunludur

Müşteri faturalarını döndürmek için getCustomerInvoices işlemini çağırın ve şu parametreleri geçirin:

AdAçıklamaZorunlu mu?
shipFromPartyIdSatıcı warehouseId siparişin yerine getirileceği. Belirtilmemişse, sonuç tüm depolar için siparişleri içerecektir.
Tür: dize
Hayır
limitDöndürülen kayıt sayısının sınırı.
Tür: tamsayı
Hayır
createdAfterBu 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
createdBeforeBu 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
sortOrderArtan sırala (ASC) veya azalan (DESC) sipariş oluşturma tarihine göre.
Tür: enum (SortOrder)
Hayır
nextTokenBelirtilen 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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
pagination100'den fazla müşteri faturası iade edilirse, nextToken sayfalandırma yanıtında döndürülür.
Türü: Sayfalandırma
Hayır
customerInvoicesMüş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:

The Direct Fulfillment integration workflow for retrieving a customer invoice.

İş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

Müşteri faturası döndürmek için getCustomerInvoice işlemini çağırın ve şu parametreyi geçirin:

AdAçıklamaZorunlu mu?
purchaseOrderNumberFaturanı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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
purchaseOrderNumberBu siparişin satınalma emri numarası.
Tür: dize
Evet
contentBase64 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

Kargo etiketi istemek için createContainerLabel işlemini çağırın ve şu parametreyi geçirin:

AdAçıklamaZorunlu mu?
sellingPartySatıcı tarafın veya satıcının kimliği. Türü: PartyIdentificationEvet
shipFromPartySatıcının depo kodu. Türü: PartyIdentificationEvet
vendorContainerIdSatıcının konteyner için benzersiz tanımlayıcısı. Türü: VendorContainerIdEvet
carrierIdKonteyner (palet) etiketinin taşıyıcısı. Türü: CarrierIdEvet
packagesGönderi paketlerini bir konteyner ile ilişkilendiren paket nesneleri dizisi. Türü: PackagesEvet

İ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

Başarılı bir yanıtta aşağıdakiler yer alır:

AdAçıklamaZorunlu mu?
containerTrackingNumberNakliye operatöründen konteyner (palet) izleme tanımlayıcısı. Tür: dizeEvet
contentKapsayıcı etiketi içeriği bir Base64 dizesine kodlanmıştır. Tür: dizeEvet
formatKonteyner etiketinin biçimi. Türü: ContainerLabelFormatEvet

Yanıt örneği

{ "containerLabel": { "containerTrackingNumber": "TBA134335066000", "content": "Base64 encoded string", "format": "PNG" } }

Bu sayfa size yardımcı oldu mu?