Sincronizar información de seguimiento de pedidos

Si estás construyendo una integración con Zonos y estás generando información de seguimiento de pedidos fuera de Zonos, como con tus propias integraciones de transportistas de envío o con un proveedor de etiquetas de terceros, puedes usar la API de Zonos para agregar información de seguimiento a los pedidos en Zonos. Agregar información de seguimiento a los pedidos en Zonos marcará el pedido como enviado y enviará la información de seguimiento al cliente.

También puedes escuchar actualizaciones de seguimiento en los pedidos de Zonos para mantener tu sistema sincronizado con Zonos. Esto es útil si estás generando todas tus etiquetas en el Dashboard y deseas sincronizar la información de seguimiento/estado de vuelta a tu propio sistema. Esta guía cubrirá ambos escenarios en detalle.

Agregar números de pedido a los pedidos de Zonos 

Para agregar números de seguimiento a un pedido, puedes usar la mutación orderAddTrackingNumber. Esta mutación requiere el id del pedido al que deseas agregar números de seguimiento, así como los trackingNumbers que deseas agregar al pedido. Esto marcará el pedido como enviado y vinculará la información de seguimiento al pedido.

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

Escuchar actualizaciones de seguimiento en Zonos pedidos 

Puedes usar el SHIPMENT_CREATED webhook para escuchar pedidos cuando se crean nuevos envíos. Este webhook se activará cuando se cree una etiqueta en el Dashboard, o cuando un pedido se marque como enviado utilizando la mutación orderAddTrackingNumber.

Lee nuestra guía de webhooks para más información sobre cómo configurar webhooks, y consulta nuestra referencia de webhooks para más información sobre la carga útil del webhook SHIPMENT_CREATED.