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 v1 Kullanım Senaryosu Rehberi

Doğrudan gönderim (DF) programındaki satıcıların doğrudan gönderim operasyonlarını yönetmek için kargo API'sini kullanmalarına nasıl yardımcı olunur?

API Sürümü: v1

Doğrudan Gönderim Kargo API'si nedir?

Tedarikçiler, Amazon ile gönderimle ilgili belgeleri paylaşmak için Doğrudan Gönderim Kargo API'sini kullanabilir. Tedarikçiler kargo etiketleri talep edebilir, kargo etiketleri alabilir, kargo onayları gönderebilir, sevk irsaliyeleri edinebilir ve müşteri faturalarını alabilir.

Müşteri faturalarının Hindistan bölgesine özgü olduğunu lütfen unutmayın.

Şu işlemler mevcuttur:

İşlem HTTP Yöntemi Path Açıklama
submitShippingLabelRequest POST /vendor/directFulfillment/shipping/v1/shippingLabels Tek veya birden fazla kargo etiketi isteği gönderin.
getShippingLabels GET /vendor/directFulfillment/shipping/v1/shippingLabels Filtre ölçütlerine göre kargo etiketlerinin bir listesini alın.

Note: This is a restricted operation and therefore requires a Restricted Data Token (RDT) for authorization. For more information, refer to the Tokens API Use Case Guide.
Note: Shipping labels will expire 90 days after creation through a submit shipping label request, hence shipping labels older than 90 days should not be requested.

getShippingLabel GET

/vendor/directFulfillment/shipping/v1/shippingLabels/{purchaseOrderNumber}

Satın alma siparişi numarasına göre bir kargo etiketi alın.
Not: Kargo etiketlerinin süresi, kargo etiketi gönderme talebi yoluyla oluşturulduktan 90 gün sonra sona erer. Bu nedenle 90 günden eski kargo etiketleri talep edilmemelidir.
submitShipmentConfirmations POST /vendor/directFulfillment/shipping/v1/shipmentConfirmations Amazon'a tek veya birden fazla kargo onayı gönderin.
submitShipmentStatusUpdates POST /vendor/directFulfillment/shipping/v1/shipmentStatusUpdates Bir kargo durumu güncellemesi gönderin. Yalnızca tedarikçinin kendi kargo firmaları.
getPackingSlips GET /vendor/directFulfillment/shipping/v1/packingSlips Oluşturma tarihi aralığına göre sevkiyat irsaliyelerinin bir listesini alın.

Note: This is a restricted operation and therefore requires a Restricted Data Token (RDT) for authorization. For more information, refer to the Tokens API Use Case Guide.
Note: Data retrieval can only go back six months, meaning that createdBefore cannot be more than six months in the past.

getPackingSlip GET /vendor/directFulfillment/shipping/v1/packingSlips/{purchaseOrderNumber} Satın alma siparişi numarasına göre belirli bir siparişin sevk irsaliyesini alın.
Not: Veri alma işlemi yalnızca altı ay geriye gidebilir. Diğer bir ifadeyle, createdBefore altı aydan daha eski olamaz.
getCustomerInvoices GET /vendor/directFulfillment/shipping/v1/customerInvoices Filtre kriterine göre müşteri faturalarının bir listesini alın.

Note: This is a restricted operation and therefore requires a Restricted Data Token (RDT) for authorization. For more information, refer to the Tokens API Use Case Guide.
Note: Data retrieval can only go back six months, meaning that createdBefore cannot be more than six months in the past.

getCustomerInvoice GET /vendor/directFulfillment/shipping/v1/customerInvoices/{purchaseOrderNumber} Satın alma siparişi numarasına göre bir müşteri faturası alın.
Not: Veri alımı yalnızca altı ay geriye gidebilir, yani createdBefore geçmişte altı aydan fazla olamaz.

submitShippingLabelRequest

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.

Başarıyla gönderilen kargo etiketi taleplerinin doğrulanması

Vendors can verify the status of their shipping label requests using the Direct Fulfillment Transaction Status API. Allow the system up to 15 min to show the status after submission. If the transaction status is not updated after 30 minutes, open a Contact Us case in Vendor Central.

Kargo Etiketi İsteği API'si entegrasyon iş akışı

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

Amazon, satın alma siparişinin satıcı tarafından sipariş onay API'si kullanılarak kabul edildiği onaylandıktan sonra bir kargo etiketi isteği almalıdır.

Amazon'un kendi kargo etiketlerini kullanıyorsanız istekte ürün bilgilerinin veya paket bilgilerinin gönderilmesi isteğe bağlıdır.

Ülkeye özel işletme gereksinimleri

Ülkeye özel bir gereklilik yoktur.

submitShippingLabelRequest İsteği

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

Gövde parametresi:

Ad

Açıklama

Zorunlu mu?
shippingLabelRequests Bir veya daha fazla kargo etiketi isteyin.

Tür: < ShippingLabelRequest > dizi

Evet

İstek örneği:

POST "https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/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 Yanıtı

Baş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, bu işlemin durumunu döndürmek için İşlem Durumu API'si ile kullanılabilir.

Tür: dize

Hayır

Yanıt örneği:

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

getShippingLabels

The getShippingLabels operation returns shipping labels for all orders which meet the filter criteria specified in the request. You must have already requested shipping labels using the submitShippingLabelRequest operation before you use this API to get shipping labels available to you for fulfillment. Amazon recommends that vendors check for shipping labels at least once per hour during business hours. Depending on your business volume, you can choose to check more frequently. You can get up to 100 shipping labels in one API call. If there are more than 100 shipping labels you can use the nextToken value to get the next set of shipping labels.

📘

Yetkilendirme için Kısıtlanmış Veri Kodu

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 İsteği

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

Sorgu parametreleri:

Ad Açıklama Zorunlu mu?
shipFromPartyId Siparişin gönderileceği depo. Belirtilmezse sonuç tüm depolardaki siparişleri içerir.

Tür: dize

Hayır
limit Döndürülen kayıt sayısının sınırı.

Minimum: 1

Maksimum: 100

Tür: tam sayı

Hayır
createdAfter Bu tarih ve saatten sonra kullanılabilir hale gelen kargo etiketleri sonuca dahil edilir. ISO-8601 tarih/saat biçiminde olmalıdır.

Tür: dize (tarih-saat)

Evet
createdBefore Bu tarih ve saatten önce kullanıma sunulan kargo etiketleri sonuca dahil edilecektir. ISO-8601 tarih/saat biçiminde olmalıdır.

Tür: dize (tarih-saat)

Evet
sortOrder Sipariş oluşturma tarihine göre artan (ASC) veya azalan (DESC) şekilde sıralayın.

Tür: numaralandırma ( SortOrder )

Hayır
nextToken Belirtilen sonuç boyutu sınırından daha fazla gemi etiketi olduğunda sayfalama 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/v1/shippingLabels?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC

getShippingLabels Yanıtı

Baş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.

Tür: dize

Hayır
shippingLabels Kargo etiketlerinin listesi.

Tür: < ShippingLabel > dizi

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.

You can also use this API to get details for any shipping label (in the time range of seven days from a rolling window of the last six months, after the vendor went live on API).

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.

Kargo etiketi ne zamana kadar istenmelidir?

ZPL ve PNG etiketleri yalnızca siparişlerin gönderileceği gün istenmelidir.

Ülkeye özel işletme gereksinimleri

Kargo etiketi yanıtları için ülkeye özel bir gereklilik yoktur.

getShippingLabel İsteği

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

Yol parametresi:

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.

Tür: dize

Evet

İstek örneği:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shippingLabels/2JK3S9VC

getShippingLabel Yanıtı

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

Ad Açıklama Zorunlu mu?
purchaseOrderNumber Bu alan, bu siparişin Satın Alma Siparişi Numarasını içerir.

Tür: dize

Evet
sellingParty Satıcı tarafın veya tedarikçinin kimliği.

Tür: PartyIdentification

Evet
shipFromParty Satıcının depo kodu.

Tür: PartyIdentification

Evet
labelFormat Etiketin biçimi.

numaralandırma ( LabelFormat )

Evet
labelData Bu kargodaki paketlerin ayrıntılarını sağlar.

Tür: < LabelData > dizi

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" } ] }

submitShipmentConfirmations

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ı

Vendors can verify the status of their shipment confirmations via Vendor Central > Orders > Direct Fulfillment Orders or using the Direct Fulfillment Transaction Status API. Allow the system up to 10 min to determine the status after submission. If Vendor Central is not showing the correct values for the shipment confirmation, open a Contact Us case in Vendor Central. Refer to the Business Requirements section for information about creating shipment confirmations.

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 sonra 4 saat içinde siparişin gönderimini onaylamak için bu API'yi kullanmalısınız.

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.

Tedarikçinin kendi kargo firmaları scacCode gönderilmesi 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.

Kargo onayındaki konteynerde shipMethod belirtilmiş olması gerekir.

Ülkeye özel işletme gereksinimleri

Yok

submitShipmentConfirmations İsteği

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

Gövde parametresi:

Ad Açıklama Zorunlu mu?
shipmentConfirmations Onaylanan kargoların listesi

Tür: < ShipmentConfirmation > dizi

Evet

İstek örneği:

POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/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 Yanıtı

Baş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, bu işlemin durumunu döndürmek için İşlem Durumu API'si ile kullanılabilir.

Tür: dize

Evet

Yanıt örneği:

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

submitShipmentStatusUpdates

⚠️

Önemli

Kargo Durumu Güncellemeleri yalnızca VOC (Tedarikçinin Kendi Kargo Firması) tedarikçileri tarafından kullanılır. Bu, kargo teslimatı için kendi kargo firmasını kullanan ve kargoyu müşteriye taşımak için Amazon kargo firması kullanmayan tedarikçileri ifade eder. Kargo maliyetlerini ve kargoyu müşteriye teslim etme sorumluluğunu nihayetinde tedarikçiler 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ı

Vendors can verify the status of their shipment status updates via Vendor Central > Orders > Direct Fulfillment Orders or by using the Direct Fulfillment Transaction Status API. Allow the system up to 10 min to determine the status after submission. If Vendor Central is not showing the correct values for the shipment confirmation, open a Contact Us case in Vendor Central. Refer to the Business Requirements section for information about creating shipment confirmations.

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 bir VOC (Satıcı Own Carrier) satıcısıysanız kullanmalısınız, yani gönderiyi müşteriye taşımak için kendi taşıyıcınızı kullanırsınız.

Bu API'yi yalnızca kargo onayı API'si veya Vendor Central kargo onayı aracılığıyla kargo onaylandıktan sonra bir kargonun durumunu güncellemek için kullanmalısınız.

Kargo durumu API'sindeki trackingNumber, kargo onayında sağlanan trackingNumber ile %100 eşleşmelidir, aksi takdirde kargo durumu güncellemesi başarısız olur.

Bir Kargo Durumu Güncelleme API'si çağrısı bir fiziksel pakete karşılık gelmelidir. Birden fazla paketin kargo durumunu, Kargo Durumu Güncellemeleri dizisi olarak gruplayarak tek bir API çağrısında 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.

Ülkeye Özel İşletme Gereksinimleri

Yok

Ek Alanlar Açıklaması

statusCode and reasonCode

Bu alanlar, EDI standartlarında (örneğin, ISA X12 ve EDIFACT) kullanılan ve belirli bir durum olayını ve durum olayının nedenini sağlamak için kullanılan standart kodlardır. Son müşteriye kargo teslimatı aşamasındaki olayları belirleyen statusCode ve reasonCode olaylarının belirli bir kombinasyonunu bekleriz.

Bunlar, desteklediğimiz durum ve neden kodları ile bunların mevcut Vendor Central'daki karşılıklarıdır:

EDIFACT Durum KoduEDIFACT Neden KoduOperasyonel AçıklamaVendor Central Kullanıcı Arayüzü Eşdeğerliği
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 Neden KoduOperasyonel AçıklamaVendor Central Kullanıcı Arayüzü Eşdeğerliği
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 İsteği

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

Gövde parametresi:

Ad Açıklama Zorunlu mu?
shipmentStatusUpdates Onaylanmış kargoların listesi.

Tür: < ShipmentStatusUpdate > dizi

Evet

İstek örneği:

POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shipmentStatusUpdates { "shipmentStatusUpdates": [ { "purchaseOrderNumber": "DX00050015", "sellingParty": { "partyId": "999US" }, "shipFromParty": { "partyId": "ABCD" }, "statusUpdateDetails": { "trackingNumber": "TRACK005", "statusCode": "D1", "reasonCode": "NS", "statusDateTime": "2020-08-07T19:56:45Z", "statusLocationAddress": { "city": "Any Town", "postalCode": "98101", "stateOrRegion": "Washington", "countryCode": "US" } } } ] }

submitShipmentStatusUpdates Yanıtı

Baş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, bu işlemin durumunu döndürmek için İşlem Durumu API'si ile kullanılabilir.

Tür: dize

Evet

Yanıt örneği:

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

getPackingSlips

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.

📘

Yetkilendirme için Kısıtlanmış Veri Kodu

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, gönderim için kullanabileceğiniz satın alma siparişlerine ait sevk irsaliyelerini almak üzere kullanmalısınız. Amazon, tedarikçilerin çalışma saatleri içinde saatte en az bir kez siparişleri kontrol etmesini önerir. İş hacminize bağlı olarak daha sık kontrol etmeyi tercih edebilirsiniz. Bir API çağrısında 100 adede kadar sevk irsaliyesi alabilirsiniz. 100'den fazla sevk irsaliyesi varsa sonraki kümeyi almak için nextToken değerini bir sonraki isteğinizde parametre olarak kullanabilirsiniz.

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 İsteği

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

Sorgu parametreleri:

Ad Açıklama Zorunlu mu?
shipFromPartyId Sipariş gönderimi için satıcı warehouseId. Belirtilmezse sonuç tüm depolardaki siparişleri içerir.

Tür: dize

Hayır
limit Döndürülen kayıt sayısının sınırı.

Minimum: 1

Maksimum: 100

Tür: tam sayı

Hayır
createdAfter Bu tarih ve saatten sonra kullanılabilir hâle gelen sevk irsaliyesi sonuca dahil edilecektir. ISO-8601 tarih/saat biçiminde olmalıdır.

Tür: dize (tarih-saat)

Evet
createdBefore Bu tarih ve saatten önce mevcut olan sevk irsaliyeleri sonuca dahil edilecektir. ISO-8601 tarih/saat biçiminde olmalıdır.

Tür: dize (tarih-saat)

Evet
sortOrder ASC veya DESC öğesini sevk irsaliyesi oluşturma tarihine göre sıralayın.

Tür: numaralandırma ( SortOrder )

Hayır
nextToken Belirtilen sonuç boyutu sınırından daha fazla sevk irsaliyesi 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/v1/packingSlips?createdBefore=2020-06-12T12:00:00-08:00&createdAfter=2020-06-12T00:00:00-08:00&limit=2&sortOrder=DESC

getPackingSlips Yanıtı

Baş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.

Tür: dize

Hayır
packingSlips Sevk irsaliyeleriyle ilgili ayrıntıları içerir.

Tür: < PackingSlip > dizi

Hayır

Yanıt örneği:

{ "payload": { "pagination": { "nextToken": "NEBxNEBxNEBxNR==" }, "packingSlips": [ { "purchaseOrderNumber": "UvgABdBjQ", "content": "base64 encoded string", "contentType": "application/pdf" }, { "purchaseOrderNumber": "VvgCDdBjR", "content": "base64 encoded string", "contentType": "application/pdf" } ] } }

getPackingSlip

getPackingSlip işlemi, satın alma siparişi numarasını kullanarak belirttiğiniz belirli bir sevk irsaliyesi hakkındaki bilgileri döndürür. Yanıt, sevk irsaliyesinin "base64" kodlu bir dizesini içerir. İçerik türü her zaman "application/pdf" olacaktır.

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.

getPackingSlip İsteği

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

Yol parametresi:

Ad Açıklama Zorunlu mu?
purchaseOrderNumber İstediğiniz sevkiyat irsaliyesi için purchaseOrderNumber.

Tür: dize

Evet

İstek örneği:

GET https://sellingpartnerapi-na.amazon.com /vendor/directFulfillment/shipping/v1/packingSlips/UkP3YkKDr

getPackingSlip Yanıtı

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

Ad Açıklama Zorunlu mu?
purchaseOrderNumber Sevk irsaliyesinin kullanıldığı kargonun satın alma siparişi numarası.

Tür: dize

Hayır
packingSlip

Sevk irsaliyesi bilgileri.

Tür: PackingSlip

Hayır

Yanıt örneği:

{ "payload": { "purchaseOrderNumber": "UvgABdBjQ", "content": "base64 encoded string", "contentType": "application/pdf" } }

Müşteri Sesleri Alın

The getCustomerInvoices operation returns customer invoices for all purchase orders which meet the filter criteria you specify. The use of this API is mandatory only in the India region and not required in any other region. Amazon recommends that vendors check for customer invoices at least once per hour during business hours. Depending on your business volume, you can choose to check more frequently. You can get up to 100 customer invoices in one API call. If there are more than 100 customer invoices you can use the nextToken value as a parameter in the next request to get the next set of customer invoices.

📘

Yetkilendirme için Kısıtlanmış Veri Kodu

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 İsteği

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

Sorgu parametreleri:

Ad Açıklama Zorunlu mu?
shipFromPartyId Sipariş gönderim talimatı oluşturmak için tedarikçi warehouseId. Belirtilmezse sonuç tüm depolardaki siparişleri içerir.

Tür: dize

Hayır
limit Döndürülen kayıt sayısının sınırı.

Minimum: 1

Maksimum: 10

Tür: tam sayı

Hayır
createdAfter Bu tarih ve saatten sonra kullanılabilir hâle gelen siparişler sonuca dahil edilecektir. ISO-8601 tarih/saat biçiminde olmalıdır.

Tür: dize (tarih-saat)

Evet
createdBefore Bu tarih ve saatten önce mevcut olan siparişler sonuca dahil edilecektir. ISO-8601 tarih/saat biçiminde olmalıdır.

Tür: dize (tarih-saat)

Evet
sortOrder ASC veya DESC'yi sipariş oluşturma tarihine göre sıralayın.

Tür: numaralandırma ( SortOrder )

Hayır
nextToken Belirtilen sonuç boyutu sınırından daha fazla sipariş olduğunda sayfalandırma için kullanılır. Kod değeri bir ö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/v1/customerInvoices?limit=2&createdAfter=2020-02-15T14:00:00-08:00&createdBefore=2020-02-20T00:00:00-08:00&sortOrder=DESC

getCustomerInvoices Yanıtı

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

Ad Açıklama Zorunlu mu?
pagination 100'den fazla müşteri faturası döndürülürse sayfalandırma için yanıtta nextToken döndürülür.

Tür: dize

Hayır
customerInvoices Müşteri faturalarının listesi.

Tür: < CustomerInvoice > dizi

Hayır

Yanıt örneği:

{ "pagination": { "nextToken": "MDAwMDAwMDAwMQ==" }, "customerInvoices": [ { "purchaseOrderNumber": "PO98676856", "content": "base 64 content goes here" } ] }

CustomerInvoice

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.

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.

Ülkeye Özel İşletme Gereksinimleri

Yalnızca Hindistan bölgesinin müşteri faturası API'sini kullanması gerekir.

getCustomerInvoice İsteği

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

Yol parametresi:

Ad Açıklama Zorunlu mu?
purchaseOrderNumber Faturanın iade edileceği kargonun satın alma sipariş numarası.

Tür: dize

Evet

İstek örneği:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/v1/shippingLabels/2JK3S9VC

getCustomerInvoice Yanıtı

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

Ad Açıklama Zorunlu mu?
purchaseOrderNumber Bu siparişin satın alma siparişi numarası.

Tür: dize

Evet
content Base64 kodlu müşteri faturası.

Tür: dize

Evet

Yanıt örneği:

{ "payload": { "purchaseOrderNumber": "PO98676856", "content": "base 64 encoded string" } }

Bu sayfa size yardımcı oldu mu?