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
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.
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.
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.
Pemutusan dan Penghapusan
Hapus Penyedia Pengiriman: Hapus integrasi penyedia pengiriman dari sistem SunnyDay saat tidak lagi diperlukan.
