Chuẩn bị dữ liệu đầu vào cho phép biến đổi
Phép biến đổi orderCreate
yêu cầu dữ liệu đầu vào cụ thể. Trong khi có thêm các trường tùy chọn, các trường sau là bắt buộc:
currencyCode
: Tiền tệ mà đơn hàng được đặt.landedCostId
: ID cho báo giá landed cost được sử dụng trong đơn hàng.accountOrderNumber
: Số đơn hàng mà bạn chỉ định (thường là số đơn hàng của nền tảng). Mỗi số đơn hàng phải là duy nhất trong một tổ chức.
Bạn có thể tạo nhiều đơn hàng sử dụng cùng một landedCostId
, nhưng trong hầu hết các trường hợp, các báo giá landed cost không thể được sử dụng quá 90 ngày. Việc sử dụng một báo giá landed cost cũ hơn 90 ngày thường sẽ làm vô hiệu hóa đảm bảo landed cost cho đơn hàng đó.
Gửi phép biến đổi
Khi bạn đã có dữ liệu đầu vào cần thiết, hãy gửi phép biến đổi GraphQL đến điểm cuối API bằng cách sử dụng thư viện hoặc công cụ khách hàng mà bạn đã chọn. Dưới đây là một ví dụ về cách bạn có thể cấu trúc phép biến đổi:
Sử dụng phép biến đổi này khi bạn đang tạo một đơn hàng dựa trên một báo giá landed cost.
Phép biến đổi
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
mutation {
orderCreate(
input: {
accountOrderNumber: "12343244"
billTo: "party_00e63a9e-9735-44d9-b129-3b3e76c5df25"
currencyCode: USD
grandTotal: 2346.12
landedCostId: "landed_cost_32e7f442-8e82-47b3-957a-096088b14e7b"
}
) {
id
organization
landedCosts {
id
}
}
}
Phản hồi
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"data": {
"orderCreate": {
"id": "order_ec7084f6-0778-47ce-b848-3ba57af9684d",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0",
"landedCosts": [
{
"id": "landed_cost_32e7f442-8e82-47b3-957a-096088b14e7b"
}
]
}
}
}
Tạo đơn hàng
Học cách tạo đơn hàng từ một báo giá landed cost.GraphQL
Khi bạn đã tạo hoặc tính toán một
landedCost
, bạn phải sử dụng phép biến đổiorderCreate
để liên kết báo giálandedCost
mà bạn nhận được với một đơn hàng, điều này sẽ kích hoạt đảm bảo Landed Cost của chúng tôi. Khi một đơn hàng được tạo, phí Zonos sẽ được tính.