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. |
getShippingLabel
|
GET |
|
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. |
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. |
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.
İş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: < |
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:
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 ( |
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: < |
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:
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: |
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: < |
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:
İş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: < |
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:
İş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 Kodu | EDIFACT Neden Kodu | Operasyonel Açıklama | Vendor Central Kullanıcı Arayüzü Eşdeğerliği |
---|---|---|---|
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 Neden Kodu | Operasyonel Açıklama | Vendor Central Kullanıcı Arayüzü Eşdeğerliği |
---|---|---|---|
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 İ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: < |
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:
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 ( |
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: < |
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:
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: |
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:
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 ( |
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: < |
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:
Ü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"
}
}
Updated 23 days ago