Ambil pesanan

Endpoint API “Ambil Pesanan” ini digunakan untuk mengambil data untuk pesanan yang telah diselesaikan 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 rinci untuk sebuah pesanan.

Penggunaan endpoint API ambil pesanan

Ada dua cara umum untuk menggunakan endpoint ini.

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

Bagian 1: Halaman sukses di domain Anda

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

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

Ketika pelanggan diarahkan ke halaman ini, sistem Anda perlu mem-parsing nilai untuk 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 ketika halaman sukses dipicu, kami merekomendasikan Anda untuk mengatur panggilan terjadwal untuk semua pesanan dan detailnya sebagai penangkap semua. Dengan cara ini, Anda dapat mengambil pesanan yang telah diselesaikan di Sistem Zonos yang belum diimpor ke dalam sistem Anda.

Proses ini harus menjadi pekerjaan/script terjadwal, seperti pekerjaan Cron, yang dijalankan sekali per jam/shif/hari/dll. (jadwalkan sesering yang dianggap perlu oleh proses bisnis Anda). Skrip harus memanggil semua pesanan dan detailnya yang terjadi sejak panggilan terakhir untuk pesanan. Endpoint orderNumbers memungkinkan Anda untuk mengambil pesanan sinceOrderId atau sinceDate seperti yang ditunjukkan pada GUI uji API yang terletak di sini. Semua pesanan yang diambil melalui panggilan terjadwal ini kemudian harus dicocokkan dengan pesanan yang dimasukkan ke dalam sistem Anda setiap kali halaman sukses dipicu. Setiap pesanan 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

Saat memanggil endpoint orderDetail, kami merekomendasikan agar 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 dalam status ini siap untuk diproses dan dikirim.

Pesanan yang memerlukan tinjauan penipuan akan diinisialisasi dalam orderStatus : IGLOBAL_FRAUD_REVIEW. Pesanan dalam status ini saat ini sedang disaring dan ditinjau untuk dugaan penipuan. Kami merekomendasikan Anda menempatkan pesanan ini dalam status tinjauan atau ditahan di sistem Anda dan terus memanggil endpoint orderDetail sampai pesanan tersebut melewati proses tinjauan penipuan Zonos.

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

• Pesanan lulus penyaringan penipuan

  • Pesanan akan berpindah ke orderStatus : IGLOBAL_ORDER_IN_PROCESS dan dapat melanjutkan menuju 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.