Deliverr API指南 - 订单履约篇 – 卖家帮助中心

注：本指南应与Deliverr API规范一起使用：

https://api.deliverr.com/documentation/v1/spec

单个产品的订单履约

对于订单的履约和管理，您需要 api/products 和 api/orders 的作用域。

设置产品
创建入库
- 创建产品后，可以通过卖家门户为产品创建入库。有关如何在卖家门户创建入库的详情，请访问此链接。如果使用的是现有的Deliverr产品，并且已经拥有库存，则可以忽略此步骤。

创建订单

一旦创建了产品，并拥有了库存，就可以开始创建订单！有关如何设置订单运输速度的信息，请访问此链接。您可以通过 Create Order 端点来创建订单。

请参阅《创建订单API参考资料》，查看 Create Order 正文架构中每个字段的定义。

curl --location --request POST '<https://api.deliverr.com/orders/v1/order>' \\
--header 'Authorization: Bearer {valid_access_token}' \\
--header 'Content-Type: application/json' \\
--data-raw '{
  "externalOrderId": "string",
  "source": "string",
  "sourceOrderId": "string",
  "shiptoAddress": {
    "name": "string",
    "company": "string",
    "street1": "string",
    "street2": "string",
    "city": "string",
    "state": "string",
    "postcode": "string",
    "countryCode": "string"
  },
  "lineItems": [
    {
      "externalProductId": "string",
      "quantity": 0
    }
  ],
  "orderDeliveryTime": "2019-08-24T14:15:22Z",
  "shipMethod": "string",
  "orderShipmentTime": "2019-08-24T14:15:22Z",
  "orderCreationTime": "2019-08-24T14:15:22Z"
}'

创建订单后，会在响应中收到 orderId 字段，以查看订单。您可以在卖家门户查看订单，网址为：https://sellerportal.deliverr.com/orders/{orderId}/detail

出错类型	说明
ORDER_INVENTORY_DSKU_NEVER_INBOUNDED （订单_库存_DSKU_从未_入库）	相关产品从未入库。在提交订单之前，请为该产品创建入库。
PRODUCT_NOT_APPROVED_FOR_SALE （产品_未_获准_销售）	该产品未获准销售。请更正产品定义，并确保产品具有所有必需字段，如尺寸或危险品验证。
ORDER_CANNOT_BE_FULFILLED （订单_无法_履约）	缺少代表要履约行产品的“lineItems”（产品行）对象。请更新订单定义。
ORDER_MISSING_LINE_ITEM （订单_缺少_产品行）	缺少其中一个“lineItems”（产品行）对象的externalproductID。请更新订单定义。
ORDER_MISSING_SHIPPING_ADDRESS （订单_缺少_收件_地址）	缺少"shiptoAddress"（收件地址）对象。请更新订单定义。
ORDER_MISSING_ADDRESS_LINE （订单_缺少_地址_栏）	缺少“street1”（街道1）地址栏。请更新订单定义。
ORDER_MISSING_CITY （订单_缺少_城市）	缺少“city”（城市）字段。请更新订单定义。
ORDER_MISSING_STATE_ZIP （订单_缺少_州_邮编）	缺少"state"（州）或"zip"（邮编）字段；这两个字段对美国国内订单来说是必需的。请更新订单定义。
ORDER_INVALID_COUNTRY_CODE （订单_国家_代码_无效）	“countryCode”（国家代码）字段无效。请使用有效国家/地区代码来更新订单定义。
ORDER_PRODUCT_MISSING_CUSTOMS （订单_产品_缺少_海关信息）	产品不具备所需的基本海关信息。请更新产品定义。
ORDER_PREVIOUSLY_SEEN_ERROR （订单_之前_出错）	此订单在过去一小时内已经创建，但由于出错而失败。请等待至少一个小时，然后重新创建订单。
ORDER_SUBMITTED_TOO_EARLY （订单_提交_过早）	此订单是在商家帐户设置的“订单接收延迟”内创建的。请等待“订单接收延迟”时段过后，再重新创建订单。
PRODUCT_NOT_AVAILABLE （产品_无_库存）	此订单包含从未入库的产品。在创建订单之前，请确保有库存。

查看订单状态
- 创建订单后，可以注册webhook和接收 ORDER_STATUS_UPDATE 事件（指南即将发布），或使用 Get Order Status 端点来查看订单状态。
```
<https://api.deliverr.com/orders/v1/order/{orderId}>
```
  在此响应中，请查看 status 字段以了解订单是否已发货，并可以在 shipments 字段中，查看发货详情和物流编号。

此组别内的文章

单个产品的订单履约

相关文章