PANDUAN INTEGRASI PENGIRIMAN KHUSUS DI SUNNYDAY

Panduan Integrasi Pengiriman Khusus di SunnyDay

Panduan ini memberikan langkah-langkah lengkap untuk mengembangkan integrasi pengiriman khusus dengan marketplace SunnyDay. Integrasi ini memungkinkan bisnis untuk menghubungkan penyedia layanan pengiriman pilihan mereka, menawarkan tarif pengiriman real-time saat checkout, mengotomatiskan proses pemenuhan pesanan, dan menyediakan informasi pelacakan yang akurat langsung kepada pelanggan.

Manfaat Utama

• Fleksibilitas: Terhubung dengan penyedia pengiriman mana pun yang menyediakan API, melampaui opsi bawaan.

• Tarif Akurat: Menampilkan biaya pengiriman real-time yang akurat dari akun penyedia pengiriman Anda selama proses checkout.

• Pemenuhan Otomatis: Mengurangi upaya manual dengan secara otomatis membuat label pengiriman dan memicu pengiriman dengan penyedia Anda.

• Pelacakan Terintegrasi: Menjaga pelanggan tetap informasi dengan menyinkronkan informasi pelacakan dari penyedia kembali ke pesanan SunnyDay.

• Pengalaman Terpadu: Mengelola aspek pengiriman langsung dalam ekosistem SunnyDay.

Diagram Alur Integrasi

1. Persyaratan Teknis

Pengetahuan Teknis

• Pemahaman dasar tentang pengembangan backend (misalnya, Node.js, Python).

• Pemahaman tentang REST APIs, webhooks, dan alur otorisasi OAuth 2.0.

Layanan Backend

• Menangani pengalihan OAuth dari SunnyDay.

• Menerima dan memproses webhooks dari SunnyDay (misalnya, peristiwa pesanan) dan penyedia pengiriman khusus (misalnya, pembaruan pengiriman).

• Melakukan panggilan API ke SunnyDay dan API penyedia pengiriman khusus.

• Menyajikan antarmuka pengguna frontend (jika tidak dihosting secara terpisah).

Database

• Menyimpan dengan aman:

  • Token OAuth SunnyDay (akses dan refresh) yang terkait dengan ID lokasi.

  • Kredensial penyedia pengiriman khusus (misalnya, API keys, secrets) yang disediakan oleh pengguna, terkait dengan lokasi SunnyDay.

  • Informasi pemetaan antara entitas SunnyDay (seperti pesanan) dan entitas penyedia pengiriman.

Frontend

• Aplikasi frontend sederhana (dapat diimplementasikan sebagai Halaman Kustom SunnyDay) yang memungkinkan pengguna untuk:

  • Memulai proses koneksi.

  • Memasukkan dan menyimpan kredensial API penyedia pengiriman mereka.

  • Mengelola pengaturan koneksi (misalnya, mengaktifkan/nonaktifkan fitur).

APIs

• Layanan backend Anda perlu mengimplementasikan beberapa endpoint API:

  • OAuth Redirect URI: Menangani callback dari SunnyDay setelah otorisasi aplikasi.

  • SunnyDay Webhook Listener: Menerima webhooks dari SunnyDay (misalnya, OrderCreate, OrderStatusUpdate).

  • Manajemen Kredensial Penyedia: APIs untuk menyimpan/memperbarui/menghapus kredensial penyedia yang dimasukkan melalui frontend.

  • Carrier Webhook Listener: Menerima webhooks dari penyedia pengiriman khusus.

  • Live Rates Callback: Endpoint yang dipanggil SunnyDay untuk mengambil tarif pengiriman langsung selama checkout.

2. Implementasi Tarif Pengiriman Langsung

• Daftarkan Penyedia Pengiriman: Tambahkan penyedia pengiriman khusus Anda ke dalam sistem SunnyDay.

• Implementasikan Callback Tarif Langsung: Buat endpoint yang mengembalikan tarif pengiriman real-time berdasarkan detail pesanan.

• Konfigurasikan Tarif Pengiriman di Zona SunnyDay: Atur tarif pengiriman berdasarkan zona geografis yang relevan.

3. inkronisasi Pesanan dan Pemenuhan

• Aktifkan Webhooks Pesanan: Terima notifikasi otomatis saat pesanan dibuat atau diperbarui.

• Tangani Webhook Pembuatan Pesanan: Proses data pesanan baru untuk diteruskan ke penyedia pengiriman.

• Tangani Pembaruan Pengiriman Penyedia: Perbarui status pengiriman dan informasi pelacakan di SunnyDay berdasarkan data dari penyedia pengiriman.

4. Pemutusan dan Penghapusan

• Hapus Penyedia Pengiriman: Hapus integrasi penyedia pengiriman dari sistem SunnyDay saat tidak lagi diperlukan.