主页文档代码示例API 参考公告模型发行说明常见问题GitHub视频
开发者中心API 状态支持
文档
开发者中心API 状态支持

供应商直接配送交易状态 API v2021-12-28 用例指南

以编程方式访问直接配送 (DF) 供应商的交易状态。

API 版本:2021-12-28

什么是直接配送交易状态 API?

供应商可以使用此 API 来检查其 POST 交易的交易状态。

包括以下操作:

操作HTTP 方法Path描述
getTransactionStatusGET/vendor/directFulfillment/transactions/2021-12-28/transactions/{transactionId}返回指定的 transactionId 所指示的交易状态。

getTransactionStatus

供应商可以使用 getTransactionStatus 操作来检查 POST 交易的状态。当使用供应商 API 中的某些 POST 操作向亚马逊发送请求时,例如 submitAcknowledgementsubmitShipmentConfirmations,例如,成功的响应包含唯一标识该交易的交易编号。亚马逊将异步处理交易,最终响应将通过 getTransactionStatus 操作提供。

亚马逊通过此 API 为 POST 交易提供最终处理状态,例如 submitAcknowledgementsubmitShipmentConfirmations。我们强烈建议供应商使用此 API 检查状态,以确保交易已成功处理。如果发生错误,您将收到错误详情,以便您可以更正交易并重新提交。

交易状态定义
Processing亚马逊收到的 API 交易正在处理中。处理尚未完成。检查每个 API 操作的服务级别协议,了解完成处理的预计时间。
Success亚马逊成功处理了 API 交易。
FailureAPI 交易在处理过程中失败。错误详情将在 getTransactionStatus 响应正文中提供。

以下直接配送 API 支持交易状态:

描述API 部分操作
确认订单直接配送订单submitAcknowledgement
提交货件确认直接配送发货submitShipmentConfirmations
货件标签请求直接配送发货submitShippingLabelRequest
配送状态更新直接配送发货submitShipmentStatusUpdates
库存更新直接配送库存submitInventoryUpdate
发票直接配送付款submitInvoice

If the transaction status is Processing and not updated to Failure or Success after 15 minutes, then the transaction has not successfully completed. The Success status will appear if the transaction is successful and an error code will be provided for Failure.

You cannot use this API for invoice messages as they are not supported and the status will be always be Processing. For any payment related queries, go to Vendor Central, select Contact Us, and select the relevant queue if the status is not updated in the vendor central portal within a day. Please ensure the data submitted is correctly formatted before opening the case.

For shipping label requests, if the transaction is failed with a terminal error reason code such as Internal server error, go to Vendor Central and select Contact Us to get the cause investigated. This generally happens due to operational constraints. For data related failures, you can correct the data and resubmit the payload to get the order fulfilled.

getTransactionStatus 请求

若要返回交易状态,请调用 getTransactionStatus 操作并传递以下参数:

路径参数:

名称 描述 必填项
transactionId 之前已在响应特定交易的 POST 请求时返回。

类型:字符串

有帮助

请求示例:

GET https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/2021-12-28/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a

getTransactionStatus 响应

成功的响应包括以下内容:

名称 描述 必填项
transactionId 在用于响应特定交易的发布请求的 transactionId 字段中发送的唯一标识符。

类型:字符串

有帮助
status 交易的当前处理状态。

enum (状态)

有帮助
errors 失败交易的错误代码和消息。仅当交易状态为“失败”时可用。

类型:错误列表

没有帮助

响应示例:

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

错误清单

The following table contains a list of all possible error codes for each message type. You should configure these error codes in your system and design a failure handling mechanism. Each error code has a message that explains the error and details that suggest how to resolve the error before retrying the transaction.

代码消息DetailsMessage Type
INVALID_ORDER_ID订单编号无效。请验证订单编号是否正确。致谢
ACK_ALREADY_PROCESSEDOrder confirmation already received for {orderId}无需采取进一步行动。致谢
INTERNAL_SERVER_ERROR内部错误。请再试一次。致谢
SHIP_METHOD_NOT_SUPPORTED{ship_method} 此频道不支持请获取标签 {ship_method},使用您现有的设置。ShipLabel
SHIP_METHOD_CHANGED此 PO 的配送方式已从 {old_ship_method} 到 {ship_method}。请获取标签 {ship_method},使用您现有的设置。ShipLabel
INVALID_DIMENSION_UNIT请求被拒绝:订单编号 {shipmentId} 包裹尺寸的计量单位无效。请确保包裹尺寸为 IN 或 CMShipLabel
INVALID_PACKAGE_ID总计 {count} 无效或重复 VendorPackageIdsPlease fix the Invalid or Duplicate VendorPackageIds and try again.ShipLabel
INVALID_ORDER_ID_WAREHOUSE_COMBINATION配送标签被拒绝:订单编号 {shipmentId} 不属于仓库 {warehouseCode}。请发送有效的订单编号和仓库代码ShipLabel
INVALID_ORDER_STATUS请求被拒绝:订单 {shipmentId} 已取消。由于订单处于取消状态,因此无法发货,请不要再次尝试打印标签。如果您认为此订单状态错误,请联系我们。ShipLabel
INVALID_WAREHOUSE_CODEShippingLabel 被拒绝:仓库代码无效 {warehouseCode}。请确保发送有效的仓库代码ShipLabel
SHIPMENT_NOT_MUTABLE请求被拒绝:订单编号的包裹尺寸 {shipmentId} 无法使用当前状态更新。无需采取进一步行动。ShipLabel
NO_ITEMS_PRESENT请求被拒绝:订单编号 {shipmentId} 有未分配给任何包裹的商品。请确保所有物品都映射到包裹中。ShipLabel
PACKAGE_DIMENSION_NOT_VALID请求被拒绝:订单编号 {shipmentId} 包裹的尺寸无效。请为您的包裹添加有效尺寸。ShipLabel
PACKAGE_WEIGHT_NOT_VALID请求被拒绝:订单编号 {shipmentId} 包裹的重量无效。请为您的包裹添加有效重量。ShipLabel
NO_SHIP_METHOD_ASSIGNABLE请求被拒绝:目前无法为订单编号分配配送方式 {shipmentId}。无法分配配送方式。请检查您的包裹尺寸和重量是否准确,并在接近预计发货日期时打印标签。ShipLabel
INCONSISTENT_SHIP_METHODS请求被拒绝:为不同的包裹分配了不同的配送方式。请尝试将所有物品装在一个箱子里,如果不可能,请联系我们。ShipLabel
INTERNAL_NON_RETRYABLE_FAILURE请求被拒绝:我们在处理您的请求时遇到了问题。请联系我们。ShipLabel
INTERNAL_RETRYABLE_FAILURE请求被拒绝:我们在处理您的请求时遇到了问题。请过几分钟再试一次。请重试。如果问题仍然存在,请联系我们。ShipLabel
EMPTY_PACKAGESASN 警报!订单编号 {shipmentId} 有空包裹。对于将来的发货,请确保您的订单有包裹。货件
EMPTY_ITEMSASN 警报!订单编号 {shipmentId} 有空物品。对于将来的配送,请确保将商品添加到 ASN 中。货件
INTERNAL_FAILURE内部错误。请再试一次。内部错误。请再试一次。货件
NO_SHIP_METHODASN 已拒绝!不 shipmethod 已找到包裹 {packageIds}。请添加你的 shipmethod 然后再试一次。货件
SHIPMENT_UNSHIPPABLEASN 已拒绝:订单编号 {shipmentId} 没有追踪编号或尚未处理必备文件(例如标签和邮票)。请确保所有必备文件(例如标签和邮票)均已处理完毕并提供有效的追踪编码。货件
SHIPMENT_IMMUTABLEASN 已拒绝!配送状态不允许更新配送。无需采取进一步行动。货件
NOT_ALL_ITEMS_PRESENTASN 已拒绝:订单编号 {shipmentId} 已使用与订单数量不匹配的包裹发货数量,并且某些商品可能没有分配包裹。请将商品添加到装运数量正确的包裹中。对于商品- {fnSku},预期数量为 {expectedQuantity} 但提供的数量是 {providedQuantity}。货件
NO_ITEMS_PRESENTASN 已拒绝:订单编号 {shipmentId} 有未分配给任何包裹的商品。请将商品添加到包裹中。货件
DIMENSION_OR_WEIGHT_NOT_VALIDASN 已拒绝:订单编号 {shipmentId} 有负重或零重量的包裹。ASN 已拒绝:订单编号 {shipmentId} 有负重或零重量的包裹。货件
SHIP_METHOD_UNASSIGNABLEASN 已拒绝:订单编号 {shipmentId} 其配送方式无法处理包裹。无法处理配送方式。请检查您的包裹尺寸、重量和配送方式。货件
INVALID_MESSAGE_PAYLOAD输入字段无效 {fieldName}。货件
VOC_NO_CARRIER_DETAILSASN 已拒绝!对于订单编号: {shipmentId},没有包裹的承运人详情 {packageId}。请添加承运人或 SCACCode,然后重试。货件
WEIGHT_NOT_PRESENT_FOR_PACKAGEASN 被拒绝!用于订购 {shipmentId}。包裹未显示包裹重量 {packageId}。请增加重量并重试。货件
INVALID_TRACKING_IDASN 已拒绝:包裹的追踪编码无效 {packageId}。因承运人而异,对于亚马逊货运标签供应商,承运人必须与货运标签上的承运人相匹配货件
INVALID_WAREHOUSE_CODEASN 已拒绝:无效的仓库代码 {warehouseCode}。请验证仓库代码是否正确。货件
ASN_ALREADY_PROCESSED已收到的 ASN {shipmentId}。无需执行任何操作,ASN 已经处理完毕。货件
INVALID_ORDER_ID_WAREHOUSEASN 已拒绝:订单编号 {orderId} 不属于仓库 {warehouseCode}。请验证仓库代码和订单编号是否正确。货件
INTERNAL_SERVER_ERROR内部错误。请再试一次。内部错误。请再试一次。货件

此页面对您有帮助吗?