DOCS

Sincronizar informações de rastreio de encomendas

Saiba como sincronizar o rastreio de encomendas entre a Zonos e o seu sistema.

Se estiver a criar uma integração com a Zonos e a gerar informações de rastreio de encomendas fora da Zonos, por exemplo, com as suas próprias integrações de transportadoras ou com um fornecedor de etiquetas externo, pode utilizar a API da Zonos para adicionar informações de rastreio às encomendas. Ao adicionar informações de rastreio, a encomenda é marcada como enviada e as informações de rastreio são enviadas ao cliente.

Também pode escutar as atualizações de rastreio das encomendas da Zonos para manter o seu sistema sincronizado. Isto é útil se gerar todas as suas etiquetas no Dashboard e pretender sincronizar as informações de rastreio/estado de volta com o seu próprio sistema. Este guia aborda ambos os cenários em detalhe.

Adicionar números de rastreio às encomendas da Zonos 

Para adicionar números de rastreio a uma encomenda, pode utilizar a mutação orderAddTrackingNumber. Esta mutação requer o id da encomenda à qual pretende adicionar números de rastreio, bem como os trackingNumbers que pretende adicionar à encomenda. Isto marcará a encomenda como enviada e associará as informações de rastreio à encomenda.

1mutation OrderAddTrackingNumber {
2 orderAddTrackingNumber(
3 input: { id: "order_XXXXXXXXXXXXXX", trackingNumbers: "123123123" }
4 ) {
5 status
6 trackingNumbers
7 }
8}

Escutar atualizações de rastreio das encomendas da Zonos 

Pode utilizar o webhook SHIPMENT_CREATED para escutar as encomendas quando são criados novos envios. Este webhook é acionado quando é criada uma etiqueta no Dashboard ou quando uma encomenda é marcada como enviada através da mutação orderAddTrackingNumber.

Leia o nosso guia de webhooks para obter mais informações sobre como configurar webhooks e consulte a nossa referência de webhooks para obter mais informações sobre o payload do webhook SHIPMENT_CREATED.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

Esta página foi útil?