Integrasi dan API

Integrasi apa saja yang ditawarkan OptiRoutes?

Memuat pesanan dari file, FTP, atau SFTP

Integrasi paling sederhana adalah file yang sudah diekspor sistem Anda. Di layar pesanan, Muat pengiriman membaca file Excel atau CSV; Anda memetakan setiap kolom sistem — alamat, nama pelanggan, nomor pesanan, jumlah, dan seterusnya — ke nama kolom Anda sekali saja, dan setiap file berikutnya dimuat dengan cara yang sama. Untuk file TXT lebar tetap, Anda memberikan posisi karakter alih-alih nama kolom. Baris dapat dilewati dengan kata penanda di keterangan, penanda kedua dapat menggantikan alamat, dan Anda menentukan apakah nomor pesanan yang sudah ada diperbarui atau ditambahkan sebagai pesanan baru.

Untuk menghilangkan campur tangan manual, pilih metode pemuatan otomatis di pengaturan:

• Server file OptiRoutes — sistem Anda menaruh file harian, yang dinamai sesuai tanggal, di folder perusahaan Anda pada server FTP atau server SFTP terenkripsi.
• Server FTP Anda sendiri — OptiRoutes terhubung dengan pengguna yang Anda berikan dan memuat file yang dinamai dengan tanggal hari ini, atau file yang paling baru diperbarui.
• Impor dan ekspor otomatis — pesanan dimuat dengan sendirinya dan rutenya juga direncanakan, tanpa perlu klik.
• Files API — software Anda mengunggah file pesanan melalui HTTPS, sebagaimana dijelaskan di bawah.

Di layar pelanggan, file Excel atau CSV berisi nomor pelanggan, nama, alamat, waktu perhentian, serta jam buka dan jam tutup akan membuat atau memperbarui pelanggan beserta jendela waktunya.

Files API: pesanan masuk, POD dan laporan keluar

Setiap perusahaan di OptiRoutes memiliki folder file pribadinya sendiri: pesanan yang dimuatnya, surat jalan bertanda tangan beserta foto dan tanda tangannya, ekspor rute, dan laporan akhir hari. Files API memungkinkan sistem Anda membaca dan menulis folder itu langsung melalui HTTPS, tanpa server FTP di antaranya. Manajer perusahaan beralih antara FTP dan API di Pengaturan → API & file dan membuat kuncinya di sana — tidak perlu mengajukan permintaan ke tim dukungan, dan perusahaan baru langsung menggunakan API.

Panggilan API mencakup pemeriksaan kunci, menampilkan isi folder, mengunduh, mengunggah (hingga 50 MB per file), dan menghapus file yang Anda unggah, menampilkan file POD satu hari menurut pesanan dan jenisnya, serta mengunduh semua file POD satu hari sebagai satu ZIP. Panduannya menyertakan contoh kode dalam Python, C#, dan Node.js, serta skrip PowerShell yang menyinkronkan folder di server Anda dengan folder perusahaan — sehingga tim yang terbiasa dengan FTP dapat tetap bekerja dengan cara yang sama. Baca di panduan Files API.

Bagaimana kunci API diamankan?

• Hak akses minimum — setiap kunci hanya mendapat izin yang dibutuhkannya: hanya POD bertanda tangan, membaca semua file, atau mengunggah pesanan dan file inbox.
• Alamat yang diizinkan — kunci dapat dibatasi ke alamat IP tetap server Anda.
• Masa berlaku dan rotasi — kunci dapat kedaluwarsa setelah sejumlah hari; buat kunci baru, beralih, lalu cabut kunci lama tanpa downtime.
• Cabut seketika — kunci yang dicabut berhenti berfungsi dalam 30 detik.
• Audit — setiap panggilan dicatat beserta waktu, alamat, file, dan responsnya, serta ditampilkan kepada manajer.
• Disimpan dengan aman — OptiRoutes hanya menyimpan sidik jari SHA-256 dari setiap kunci; koneksi menggunakan HTTPS dengan TLS 1.2 atau lebih baru, dan setiap kunci hanya dapat menjangkau folder perusahaannya sendiri.

Batasan: 300 permintaan per menit per kunci, 50 MB per file, 20 kunci aktif per perusahaan, dan hingga 5.000 entri dalam satu daftar isi folder.

API laporan dan push

Untuk tool pelaporan dan konektor ERP, API terpisah di api-users.optiroutes.com menyajikan data perusahaan Anda sebagai laporan dan menerima data yang dikirim (push). Satu alamat dan satu token, yang diterbitkan OptiRoutes untuk perusahaan Anda, mencakup setiap panggilan. Halaman dokumentasi memungkinkan Anda menempelkan token dan melihat laporan mana yang terbuka bagi Anda serta pemetaan kolom akun Anda: baca dokumentasi API.

Dua panggilan push bekerja ke arah sebaliknya: push pesanan menulis file pesanan hari itu dan memulai pemuatan otomatis, dan push pengemudi, jalur, dan kendaraan menggantikan seluruh armada, seperti file armada. Karena daftar pengemudi yang dikirim dianggap sebagai armada lengkap, selalu kirim semua pengemudi, bukan hanya perubahannya.

Mengekspor rute dan webhook

Ekspor rute menulis rute yang ditandai dalam CSV, XLSX, XML, JSON, atau TXT lebar tetap. Tabel kolom menentukan kolom mana yang dikeluarkan dan dengan judul apa, kolom asli dari file pesanan Anda dapat ditambahkan, dan dengan manajemen item, file kedua mencantumkan setiap item. Ekspor dapat dikirim ke komputer Anda, server FTP Anda, atau folder perusahaan, dan dengan JSON, ekspor juga dapat dikirim ke alamat web; jika pengiriman gagal, sistem mencoba sekali lagi.

Untuk setiap pengiriman saat terjadi, isi alamat laporan pengiriman di pengaturan aplikasi pengemudi: setiap laporan pengiriman yang dibuat pengemudi juga dikirim ke sana, sehingga sistem Anda yang lain diperbarui dengan sendirinya.

E-mail, pembayaran, peta, dan pesan

• E-mail — surat jalan bertanda tangan dikirim dari akun Gmail Anda sendiri dengan sandi aplikasi Google; laporan seperti laporan palet akhir hari dikirim ke e-mail laporan Anda; pelanggan pembayar menerima tanda terima dan pengemudi menerima konfirmasi setoran dari Kas.
• Pembayaran — isi ulang dibayar di halaman pembayaran Stripe yang aman, dengan opsi menyimpan kartu untuk isi ulang otomatis.
• Alamat dan peta — alamat dipilih dari saran Google dan diverifikasi di peta sebelum perencanaan.
• Navigasi — aplikasi pengemudi meneruskan setiap perhentian ke Waze, atau Apple Maps di iPhone, berdasarkan alamat atau koordinat yang tepat.
• SMS dan WhatsApp — pesan kedatangan dan tautan pelacakan ke pelanggan, peringatan ke manajer, jalur ke subkontraktor, dan gambar rute ke pengemudi lewat WhatsApp.

Pertanyaan yang sering diajukan