供应商直接配送交易状态 API v2021-12-28 用例指南
以编程方式访问直接配送 (DF) 供应商的交易状态。
API 版本:2021-12-28
什么是直接配送交易状态 API?
供应商可以使用此 API 来检查其 POST 交易的交易状态。
包括以下操作:
操作 | HTTP 方法 | Path | 描述 |
---|---|---|---|
getTransactionStatus | GET | /vendor/directFulfillment/transactions/2021-12-28/transactions/{transactionId} | 返回指定的 transactionId 所指示的交易状态。 |
getTransactionStatus
供应商可以使用 getTransactionStatus
操作来检查 POST 交易的状态。当使用供应商 API 中的某些 POST 操作向亚马逊发送请求时,例如 submitAcknowledgement
或 submitShipmentConfirmations
,例如,成功的响应包含唯一标识该交易的交易编号。亚马逊将异步处理交易,最终响应将通过 getTransactionStatus
操作提供。
亚马逊通过此 API 为 POST 交易提供最终处理状态,例如 submitAcknowledgement
和 submitShipmentConfirmations
。我们强烈建议供应商使用此 API 检查状态,以确保交易已成功处理。如果发生错误,您将收到错误详情,以便您可以更正交易并重新提交。
交易状态 | 定义 |
---|---|
Processing | 亚马逊收到的 API 交易正在处理中。处理尚未完成。检查每个 API 操作的服务级别协议,了解完成处理的预计时间。 |
Success | 亚马逊成功处理了 API 交易。 |
Failure | API 交易在处理过程中失败。错误详情将在 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": "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.
代码 | 消息 | Details | Message Type |
---|---|---|---|
INVALID_ORDER_ID | 订单编号无效。 | 请验证订单编号是否正确。 | 致谢 |
ACK_ALREADY_PROCESSED | Order 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 或 CM | ShipLabel |
INVALID_PACKAGE_ID | 总计 {count } 无效或重复 VendorPackageIds 。 | Please 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_CODE | ShippingLabel 被拒绝:仓库代码无效 {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_PACKAGES | ASN 警报!订单编号 {shipmentId } 有空包裹。 | 对于将来的发货,请确保您的订单有包裹。 | 货件 |
EMPTY_ITEMS | ASN 警报!订单编号 {shipmentId } 有空物品。 | 对于将来的配送,请确保将商品添加到 ASN 中。 | 货件 |
INTERNAL_FAILURE | 内部错误。请再试一次。 | 内部错误。请再试一次。 | 货件 |
NO_SHIP_METHOD | ASN 已拒绝!不 shipmethod 已找到包裹 {packageIds }。 | 请添加你的 shipmethod 然后再试一次。 | 货件 |
SHIPMENT_UNSHIPPABLE | ASN 已拒绝:订单编号 {shipmentId } 没有追踪编号或尚未处理必备文件(例如标签和邮票)。 | 请确保所有必备文件(例如标签和邮票)均已处理完毕并提供有效的追踪编码。 | 货件 |
SHIPMENT_IMMUTABLE | ASN 已拒绝!配送状态不允许更新配送。 | 无需采取进一步行动。 | 货件 |
NOT_ALL_ITEMS_PRESENT | ASN 已拒绝:订单编号 {shipmentId } 已使用与订单数量不匹配的包裹发货数量,并且某些商品可能没有分配包裹。 | 请将商品添加到装运数量正确的包裹中。对于商品- {fnSku },预期数量为 {expectedQuantity } 但提供的数量是 {providedQuantity }。 | 货件 |
NO_ITEMS_PRESENT | ASN 已拒绝:订单编号 {shipmentId } 有未分配给任何包裹的商品。 | 请将商品添加到包裹中。 | 货件 |
DIMENSION_OR_WEIGHT_NOT_VALID | ASN 已拒绝:订单编号 {shipmentId } 有负重或零重量的包裹。 | ASN 已拒绝:订单编号 {shipmentId } 有负重或零重量的包裹。 | 货件 |
SHIP_METHOD_UNASSIGNABLE | ASN 已拒绝:订单编号 {shipmentId } 其配送方式无法处理包裹。 | 无法处理配送方式。请检查您的包裹尺寸、重量和配送方式。 | 货件 |
INVALID_MESSAGE_PAYLOAD | 输入字段无效 {fieldName }。 | 货件 | |
VOC_NO_CARRIER_DETAILS | ASN 已拒绝!对于订单编号: {shipmentId },没有包裹的承运人详情 {packageId }。 | 请添加承运人或 SCACCode,然后重试。 | 货件 |
WEIGHT_NOT_PRESENT_FOR_PACKAGE | ASN 被拒绝!用于订购 {shipmentId }。包裹未显示包裹重量 {packageId }。 | 请增加重量并重试。 | 货件 |
INVALID_TRACKING_ID | ASN 已拒绝:包裹的追踪编码无效 {packageId }。 | 因承运人而异,对于亚马逊货运标签供应商,承运人必须与货运标签上的承运人相匹配 | 货件 |
INVALID_WAREHOUSE_CODE | ASN 已拒绝:无效的仓库代码 {warehouseCode }。 | 请验证仓库代码是否正确。 | 货件 |
ASN_ALREADY_PROCESSED | 已收到的 ASN {shipmentId }。 | 无需执行任何操作,ASN 已经处理完毕。 | 货件 |
INVALID_ORDER_ID_WAREHOUSE | ASN 已拒绝:订单编号 {orderId } 不属于仓库 {warehouseCode }。 | 请验证仓库代码和订单编号是否正确。 | 货件 |
INTERNAL_SERVER_ERROR | 内部错误。请再试一次。 | 内部错误。请再试一次。 | 货件 |
Updated 23 days ago