Đồng bộ thông tin theo dõi đơn hàng

Nếu bạn đang xây dựng một tích hợp với Zonos và đang tạo thông tin theo dõi đơn hàng bên ngoài Zonos, chẳng hạn như với các tích hợp nhà vận chuyển của riêng bạn hoặc với nhà cung cấp nhãn bên thứ ba, bạn có thể sử dụng API của Zonos để thêm thông tin theo dõi vào các đơn hàng trong Zonos. Việc thêm thông tin theo dõi vào các đơn hàng trong Zonos sẽ đánh dấu đơn hàng là đã được giao và sẽ gửi thông tin theo dõi đến khách hàng.

Bạn cũng có thể lắng nghe các cập nhật theo dõi trên các đơn hàng của Zonos để giữ cho hệ thống của bạn đồng bộ với Zonos. Điều này rất hữu ích nếu bạn đang tạo tất cả các nhãn của mình trong Dashboard và muốn đồng bộ thông tin theo dõi/trạng thái trở lại hệ thống của riêng bạn. Hướng dẫn này sẽ đề cập đến cả hai kịch bản này một cách chi tiết.

Thêm số đơn hàng vào các đơn hàng của Zonos 

Để thêm số theo dõi vào một đơn hàng, bạn có thể sử dụng phép biến đổi orderAddTrackingNumber. Phép biến đổi này yêu cầu id của đơn hàng mà bạn muốn thêm số theo dõi, cũng như trackingNumbers mà bạn muốn thêm vào đơn hàng. Điều này sẽ đánh dấu đơn hàng là đã được giao và liên kết thông tin theo dõi với đơn hàng.

mutation OrderAddTrackingNumber {
  orderAddTrackingNumber(
    input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }
  ) {
    status
    trackingNumbers
  }
}

Lắng nghe các cập nhật theo dõi trên Zonos đơn hàng 

Bạn có thể sử dụng webhook SHIPMENT_CREATED để lắng nghe các đơn hàng khi có lô hàng mới được tạo. Webhook này sẽ được kích hoạt khi một nhãn được tạo trong Dashboard, hoặc khi một đơn hàng được đánh dấu là đã giao hàng bằng cách sử dụng phép biến đổi orderAddTrackingNumber.

Đọc hướng dẫn về webhooks của chúng tôi để biết thêm thông tin về cách thiết lập webhooks, và xem tham chiếu webhook của chúng tôi để biết thêm thông tin về payload của webhook SHIPMENT_CREATED.