Sinkronisasi informasi pelacakan pesanan

Jika Anda sedang membangun integrasi dengan Zonos dan menghasilkan informasi pelacakan pesanan di luar Zonos, seperti dengan integrasi pengangkut pengiriman Anda sendiri atau dengan penyedia label pihak ketiga, Anda dapat menggunakan API Zonos untuk menambahkan informasi pelacakan ke pesanan di Zonos. Menambahkan informasi pelacakan ke pesanan di Zonos akan menandai pesanan sebagai dikirim dan akan mengirimkan informasi pelacakan kepada pelanggan.

Anda juga dapat mendengarkan pembaruan pelacakan pada pesanan Zonos untuk menjaga sistem Anda tetap sinkron dengan Zonos. Ini berguna jika Anda menghasilkan semua label Anda di Dashboard dan ingin menyinkronkan informasi pelacakan/status kembali ke sistem Anda sendiri. Panduan ini akan membahas kedua skenario ini secara rinci.

Tambahkan nomor pesanan ke pesanan Zonos 

Untuk menambahkan nomor pelacakan ke sebuah pesanan, Anda dapat menggunakan mutasi orderAddTrackingNumber. Mutasi ini memerlukan id dari pesanan yang ingin Anda tambahkan nomor pelacakan, serta trackingNumbers yang ingin Anda tambahkan ke pesanan tersebut. Ini akan menandai pesanan sebagai dikirim dan menghubungkan informasi pelacakan ke pesanan.

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

Dengarkan pembaruan pelacakan pada Zonos pesanan 

Anda dapat menggunakan webhook SHIPMENT_CREATED untuk mendengarkan pesanan ketika pengiriman baru dibuat. Webhook ini akan dipicu ketika label dibuat di Dashboard, atau ketika pesanan ditandai sebagai dikirim menggunakan mutasi orderAddTrackingNumber.

Baca panduan webhook kami untuk informasi lebih lanjut tentang cara mengatur webhook, dan lihat referensi webhook kami untuk informasi lebih lanjut tentang payload webhook SHIPMENT_CREATED.