주문 추적 정보 동기화

Zonos와 통합을 구축하고 Zonos 외부에서 주문 추적 정보를 생성하는 경우, 예를 들어 자체 배송업체 통합이나 제3자 라벨 제공업체와 함께 사용할 경우, Zonos API를 사용하여 Zonos의 주문에 추적 정보를 추가할 수 있습니다. Zonos의 주문에 추적 정보를 추가하면 주문이 발송된 것으로 표시되며 고객에게 추적 정보가 전송됩니다.

또한 Zonos 주문에 대한 추적 업데이트를 수신하여 시스템을 Zonos와 동기화할 수 있습니다. 이는 모든 라벨을 대시보드에서 생성하고 추적/상태 정보를 자신의 시스템으로 다시 동기화하려는 경우에 유용합니다. 이 가이드는 이 두 가지 시나리오를 자세히 다룰 것입니다.

Zonos 주문에 주문 번호 추가 

주문에 추적 번호를 추가하려면 orderAddTrackingNumber 변이를 사용할 수 있습니다. 이 변이는 추적 번호를 추가할 주문의 id와 주문에 추가할 trackingNumbers를 요구합니다. 이렇게 하면 주문이 발송된 것으로 표시되고 추적 정보가 주문에 연결됩니다.

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

Zonos 주문에 대한 추적 업데이트 듣기 

새로운 배송이 생성될 때 주문을 듣기 위해 SHIPMENT_CREATED 웹후크를 사용할 수 있습니다. 이 웹후크는 대시보드에서 라벨이 생성되거나 orderAddTrackingNumber 변이를 사용하여 주문이 배송된 것으로 표시될 때 트리거됩니다.

웹후크 설정 방법에 대한 자세한 내용은 웹후크 가이드를 참조하고, SHIPMENT_CREATED 웹후크 페이로드에 대한 자세한 내용은 웹후크 참조를 참조하세요.