Tedarikçi Doğrudan Gönderim İşlem Durumu API'si v1 Kullanım Senaryosu Rehberi
Help vendors in the direct fulfillment (DF) program use the Transaction Status API to manage their direct fulfillment operations.
API Sürümü: v1
Doğrudan Gönderim İşlemi Durumu API'si nedir?
Tedarikçiler, POST işlemlerinin işlem durumunu kontrol etmek için bu API'yi kullanabilir.
Aşağıdaki işlem dahildir:
İşlem | HTTP Yöntemi | Path | Açıklama |
---|---|---|---|
getTransactionStatus | GET | /vendor/directFulfillment/transactions/v1/transactions/{transactionId} | Belirtilen transactionId ile gösterilen işlemin durumunu döndürür. |
Geç Transaction Durumu
Vendors can use the getTransactionStatus
operation to check the status of a POST transaction. When a request is posted to Amazon using certain POST operations in the vendor APIs, such as submitAcknowledgement
or submitShipmentConfirmations
, for example, a successful response contains a transaction ID that uniquely identifies the transaction. Amazon will process the transaction asynchronously, and the final response will be available via the getTransactionStatus
operation.
Refer to the corresponding integration workflow diagram in the other sections of this guide to understand when to call the getTransactionStatus
operation to get the transaction status.
Amazon, bu API aracılığıyla submitAcknowledgement
ve submitShipmentConfirmations
gibi POST işlemleri için son işlenme durumunu sunar. Satıcıların, işlemlerin başarıyla işlendiğinden emin olmak için bu API'yi kullanarak durumu kontrol etmelerini önemle öneririz. Bir hata oluştuysa hata ayrıntılarını alırsınız. Böylece işlemi düzeltebilir ve yeniden gönderebilirsiniz.
İşlem Durumu | Tanım |
---|---|
Processing | API işlemi Amazon tarafından alındı ve işleniyor. İşlem henüz tamamlanmadı. İşlemin tamamlanması için beklenen süre için her bir API işleminin SLA'sını kontrol edin. |
Success | API işlemi Amazon tarafından başarıyla işlendi. |
Failure | API işlemi, işleme sırasında başarısız oldu. Hata ayrıntıları getTransactionStatus yanıt gövdesinde sağlanacak. |
İşlem durumu aşağıdaki Doğrudan Gönderim API'lerinde desteklenmektedir:
Açıklama | API Bölümü | İşlem |
---|---|---|
Siparişi Onaylayın | Doğrudan Gönderim Siparişleri | submitAcknowledgement |
Kargo Onaylarını Gönderin | Doğrudan Gönderim Kargo | submitShipmentConfirmations |
Kargo Etiketi İsteği | Doğrudan Gönderim Kargo | submitShippingLabelRequest |
Kargo Durumu Güncellemeleri | Doğrudan Gönderim Kargo | submitShipmentStatusUpdates |
Envanter Güncellemesi | Doğrudan Gönderim Envanteri | submitInventoryUpdate |
Fatura | Doğrudan Gönderim Ödemeleri | submitInvoice |
İşlem durumu şimdilik sadece Processing
ve Failure
durum kodlarını desteklemektedir. İşlem durumu Processing
ise ve 30 dakika sonra Failure
olarak güncellenmemişse işlem sistemlerimizde başarıyla işlenmiştir. Gelecekte Success
durumu da desteklenecek.
getTransactionStatus İsteği
To return the transaction status, call the getTransactionStatus
operation and pass the following parameter:
Yol parametresi:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
transactionId |
Daha önce belirli bir işlemin POST isteğine yanıt olarak döndürülmüştür. Tür: dize |
Evet |
İstek Örneği:
GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/v1/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a
getTransactionStatus Yanıtı
Başarılı bir yanıtta aşağıdakiler yer alır:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
transactionId |
Belirli bir işlemin POST isteğine yanıt olarak transactionId alanında gönderilen benzersiz tanımlayıcı. Tür: dize |
Evet |
status |
İşlemin mevcut işlem durumu. enum ( Status ) |
Evet |
errors |
Başarısız işlem için hata kodu ve mesajı. Yalnızca işlem durumu "Başarısız" olduğunda kullanılabilir. Type:
|
Hayır |
Yanıt Örneği:
{
"transactionId": "20190918190535-eef8cad8-418e-456f-ac72-789e2ee6813c",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID."
}
]
}
Updated 5 months ago