Ambil pesanan

Endpoint API "Ambil Pesanan" ini digunakan untuk mengambil data pesanan yang telah selesai di dalam Sistem Zonos. Respons akan berisi objek JSON, yang mewakili semua informasi yang tersedia untuk pesanan termasuk alamat penagihan dan pengiriman, metode pengiriman, total pesanan, dan status.

Endpoint 

Nomor pesanan

Mengambil daftar nomor pesanan.

Detail pesanan

Mengambil informasi detail untuk pesanan.

Penggunaan endpoint API Ambil Pesanan

Ada dua cara umum untuk menggunakan endpoint ini.

1. (Bagian 1 + Bagian 2) – Gunakan halaman konfirmasi pesanan kustom / halaman sukses di domain Anda untuk memicu sistem Anda memanggil endpoint orderDetail dan mengimpor pesanan yang selesai. Selain itu, secara berkala panggil endpoint orderNumbers untuk merekonsiliasi pesanan apa pun di Sistem Zonos yang belum diimpor ke dalam sistem Anda.
2. (Hanya Bagian 2) – Gunakan halaman konfirmasi pesanan dasar Zonos / halaman sukses atau halaman statis di domain Anda untuk menunjukkan penyelesaian pesanan kepada pelanggan. Jadwalkan sistem Anda untuk secara berkala memanggil endpoint orderNumbers untuk menentukan kapan pesanan baru siap diimpor di sistem Anda. Ketika pesanan yang beredar ditemukan, panggil endpoint orderDetail untuk data pesanan tersebut.

Bagian 1: Halaman sukses di domain Anda

Setiap kali pembeli menyelesaikan pesanan di Zonos Checkout, mereka segera diarahkan ke URL halaman sukses pesanan. ID pesanan yang selesai akan ditambahkan ke URL pengalihan sebagai string kueri. URL halaman sukses pesanan harus disediakan ke Zonos. URL juga dapat dilewatkan sebagai parameter di endpoint createTempCart saat membuat keranjang sementara di Sistem Zonos.

Contoh: http://www.examplestore.com/internationalThankYou?orderId=999-99999

Ketika pelanggan dialihkan ke halaman ini, sistem Anda perlu mengurai nilai orderId dari URL. Anda kemudian akan menggunakan orderId untuk memanggil endpoint orderDetail untuk mengambil data pesanan.

Bagian 2: Gunakan pekerjaan terjadwal

Selain memanggil detail pesanan saat halaman sukses dipicu, kami merekomendasikan Anda untuk menyiapkan panggilan terjadwal untuk semua pesanan dan detail mereka sebagai catch-all. Dengan cara ini, Anda dapat mengambil pesanan yang telah selesai apa pun di Sistem Zonos yang belum diimpor ke dalam sistem Anda.

Proses ini harus merupakan pekerjaan/skrip terjadwal, seperti pekerjaan Cron, dijalankan sekali per jam/shift/hari/dll. (jadwalkan sesuai kebutuhan proses bisnis Anda). Skrip harus memanggil semua pesanan dan detail mereka yang terjadi sejak panggilan terakhir untuk pesanan. Endpoint orderNumbers memungkinkan Anda untuk mengambil pesanan sinceOrderId atau sinceDate seperti yang ditunjukkan di GUI uji API yang terletak di sini. Semua pesanan yang diambil melalui panggilan terjadwal ini kemudian harus direkonsiliasi terhadap pesanan yang dimasukkan ke dalam sistem Anda setiap kali halaman sukses dipicu. Pesanan apa pun yang belum ada di sistem Anda harus dimasukkan ke dalam sistem Anda dan diperlakukan sebagai pesanan yang sah.

Status pesanan awal

IGLOBAL_ORDER_IN_PROCESS atau IGLOBAL_FRAUD_REVIEW

Ketika memanggil endpoint orderDetail, kami merekomendasikan bahwa sistem Anda terlebih dahulu memeriksa properti orderStatus dari data pesanan.

Pesanan yang tidak memerlukan tinjauan penipuan akan diinisialisasi dengan orderStatus : IGLOBAL_ORDER_IN_PROCESS. Pesanan dengan status ini siap untuk diproses dan dikirim.

Pesanan yang memerlukan tinjauan penipuan akan diinisialisasi dalam orderStatus : IGLOBAL_FRAUD_REVIEW. Pesanan dalam status ini sedang diskrining dan ditinjau atas dugaan penipuan. Kami merekomendasikan Anda menempatkan pesanan ini pada status tinjauan atau tahan di sistem Anda dan terus memanggil endpoint orderDetail sampai pesanan melampaui proses tinjauan penipuan Zonos.

Setelah proses penyaringan penipuan Zonos selesai, pesanan akan berpindah ke salah satu status berikut:

• Pesanan lulus penyaringan penipuan

  • Pesanan akan berpindah ke orderStatus : IGLOBAL_ORDER_IN_PROCESS dan dapat melanjutkan ke pengiriman.

• Pesanan gagal penyaringan penipuan

  • Pesanan akan berpindah ke orderStatus : IGLOBAL_ORDER_CANCELLED dan harus dibatalkan di sistem Anda.

GUI uji API

Silakan hubungi dukungan untuk kredensial akun Anda.