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

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:

İşlemHTTP YöntemiPathAçıklama
getTransactionStatusGET/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 DurumuTanım
ProcessingAPI 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.
SuccessAPI işlemi Amazon tarafından başarıyla işlendi.
FailureAPI 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çıklamaAPI Bölümüİşlem
Siparişi OnaylayınDoğrudan Gönderim SiparişlerisubmitAcknowledgement
Kargo Onaylarını GönderinDoğrudan Gönderim KargosubmitShipmentConfirmations
Kargo Etiketi İsteğiDoğrudan Gönderim KargosubmitShippingLabelRequest
Kargo Durumu GüncellemeleriDoğrudan Gönderim KargosubmitShipmentStatusUpdates
Envanter GüncellemesiDoğrudan Gönderim EnvanterisubmitInventoryUpdate
FaturaDoğrudan Gönderim ÖdemelerisubmitInvoice

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

Hayır

Yanıt Örneği:

{ "transactionId": "20190918190535-eef8cad8-418e-456f-ac72-789e2ee6813c", "status": "Failure", "errors": [ { "code": "INVALID_ORDER_ID", "message": "Invalid order ID." } ] }

Bu sayfa size yardımcı oldu mu?