DOCS

Tạo một lô hàng

Tạo một lô hàng

Tạo lô hàng với API Zonos bằng cách sử dụng các phép biến đổi GraphQL.

GraphQL

Nếu bạn đã tích hợp với API Zonos và được phê duyệt để gửi hàng ra ngoài Dashboard, hãy sử dụng phép biến đổi shipmentCreateWorkflow để tạo lô hàng và cung cấp thông tin theo dõi. Những phép biến đổi này cũng cho phép bạn thông báo cho Zonos về các lô hàng nội địa đến các cơ sở cross-docking.

Lưu ý: Nếu bạn đang sử dụng một ứng dụng Duty and Tax với một nền tảng tự động đồng bộ hóa số theo dõi đến Zonos, hoặc nếu bạn đang gửi hàng trực tiếp qua Dashboard, những phép biến đổi này là không cần thiết.

Tạo lô hàng qua API 

Sau khi tính toán Landed Cost và tạo một đơn hàng, bạn có thể gửi số theo dõi và các chi tiết lô hàng khác đến Zonos thông qua API.

Sử dụng quy trình này khi bạn đang tạo một lô hàng cho một đơn hàng hiện có và không cần thay đổi chi tiết mặt hàng hoặc bên liên quan. Nó hỗ trợ các số theo dõi tùy chọn, các trung tâm thực hiện và lựa chọn cấp dịch vụ.

Phép biến đổi

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
28
29
30
31
32
33
34
35
36
37
38
39
40
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
  shipmentCreateWorkflow(input: $input) {
    id
    status
    trackingDetails {
      number
    }
    serviceLevel {
      id
      name
      carrier {
        id
        name
      }
    }
    shipmentCartons {
      id
      carton {
        id
        width
        length
        height
        weight
        items {
          item {
            id
            amount
            description
          }
        }
      }
      label {
        url
        trackingNumber
        id
        documentFiling
      }
    }
  }
}

Biến cơ bản

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Với Trung Tâm Hoàn Thành

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Với Theo Dõi Tùy Chỉnh

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Với Mức Độ Dịch Vụ

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Hủy một lô hàng 

Để hủy một nhãn đã tạo, hãy sử dụng phép biến đổi sau để hủy lô hàng. Bất kỳ nhãn nào liên quan cũng sẽ được hủy tự động. Lưu ý rằng một khi lô hàng đã bị hủy, nó không thể được cập nhật hoặc khôi phục.

Phép biến đổi

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

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