DOCS

Create orders graphql

/

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 đổi orderCreate để 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 bảo đảm Landed Cost của chúng tôi. Khi một đơn hàng được tạo, phí Zonos sẽ được tính.

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 bảo đảm 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ụ 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:

Tạo đơn hàng
Tạo đơn hàng và lô hàng

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"
        }
      ]
    }
  }
}

Trang này có hữu ích không?