准备变更输入
orderCreate 变更需要特定的输入数据。虽然还有其他可用字段，但以下字段是必需的：
productId或sku：您用来识别订单上商品的产品 ID 或 SKU（您在系统中用来识别产品的值）。accountOrderNumber：您分配给订单的订单号（通常是平台的订单号）。
只有在商品尚未发货的情况下，您才能从订单中移除商品。
发送变更
一旦您拥有所需的输入数据，请使用您选择的客户端库或工具将 GraphQL 变更发送到 API 端点。以下是您可以如何构建变更的示例：
变更
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
mutation {
orderItemUpdate(
orderId: "order_4f52ec0e-3467-11ed-b878-0242ac120002"
accountOrderNumber: "AO-67890"
itemId: "item_8659ec0e-3467-11ed-b878-0242ac120002"
itemSku: "T123-BLUE"
quantity: 1
) {
order {
accountOrderNumber
createdAt
createdBy
currencyCode
id
items {
id
name
quantity
amount
currencyCode
}
status
updatedAt
updatedBy
}
}
}
响应
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"data": {
"orderItemUpdate": {
"order": {
"accountOrderNumber": "AO-67890",
"createdAt": "2024-06-01T12:00:00Z",
"createdBy": "user_3258ec0e-3467-11ed-b878-0242ac120002",
"currencyCode": "USD",
"id": "order_4f52ec0e-3467-11ed-b878-0242ac120002",
"items": [
{
"id": "item_8659ec0e-3467-11ed-b878-0242ac120002",
"name": "T-Shirt",
"quantity": 0,
"amount": 19.99,
"currencyCode": "USD"
}
],
"status": "OPEN",
"updatedAt": "2024-07-09T12:20:00Z",
"updatedBy": "user_4258ec0e-3467-11ed-b878-0242ac120002"
}
}
}
}
创建订单
了解如何更新订单上的商品。GraphQL
即将推出
如果您已经创建了订单，但意识到由于短缺发货或其他不可预见的情况，并非所有商品都可以完成，您可以使用
orderItemUpdate变更来从订单中移除商品。一旦商品被移除，我们将进行新的landedCost计算，并更新该订单的发票，以反映您将被收取的新金额。如果您已经被收取费用，我们将在您即将到来的发票上添加该金额作为信用。