---
title: "Integrasi dan API: fail, pesanan dan POD | OptiRoutes"
description: "Sambungkan OptiRoutes ke ERP Anda: muat naik Excel/CSV, FTP atau SFTP, API fail untuk pesanan dan POD bertandatangan, API laporan, eksport laluan dan webhook."
url: https://optiroutes.com/ms/integrations/
lang: ms-MY
updated: 2026-10-24
---

# Integrasi dan API

OptiRoutes berhubung dengan sistem yang sudah Anda gunakan. Pesanan masuk daripada fail Excel atau CSV, daripada FTP atau SFTP, atau melalui API fail yang selamat; nota penghantaran bertandatangan, eksport laluan dan laporan kembali dengan cara yang sama. API laporan menyalurkan data Anda kepada alat BI, dan alamat web menerima laporan penghantaran serta eksport laluan sebaik sahaja ia berlaku.

## Integrasi apakah yang ditawarkan oleh OptiRoutes?

| Keperluan | Cara OptiRoutes melakukannya |
| --- | --- |
| Memuatkan pesanan hari itu | Muat naik Excel atau CSV, pemuatan automatik daripada FTP, SFTP atau API fail, dalam format CSV, JSON atau TXT lebar tetap. |
| Mengumpul POD bertandatangan | Panggilan API fail mengikut hari atau pesanan, atau satu ZIP sehari; salinan melalui e-mel. |
| Menghantar laluan ke sistem Anda | Eksport laluan dalam CSV, XLSX, XML, JSON atau TXT, ke fail, FTP Anda, folder syarikat atau alamat web. |
| Melaporkan ke BI atau ERP Anda | API laporan: pesanan, laluan, pemandu, pelanggan, POD dan ringkasan penghantaran harian. |
| Bertindak balas terhadap setiap penghantaran | Alamat laporan penghantaran yang menerima setiap laporan sebaik sahaja ia dibuat. |
| Membayar perkhidmatan | Stripe Checkout untuk tambah nilai prabayar dan tambah nilai automatik. |

## Memuatkan pesanan daripada fail, FTP atau SFTP

Integrasi paling mudah ialah fail yang sudah dieksport oleh sistem Anda. Di skrin pesanan, **Muat penghantaran** membaca fail Excel atau CSV; Anda memetakan setiap medan sistem — alamat, nama pelanggan, nombor pesanan, kuantiti dan sebagainya — kepada nama lajur Anda sekali sahaja, dan setiap fail kemudian dimuatkan dengan cara yang sama. Untuk fail TXT lebar tetap, Anda memberikan kedudukan aksara dan bukannya nama lajur. Baris boleh dilangkau melalui perkataan penanda dalam catatan, penanda kedua boleh menggantikan alamat, dan Anda menentukan sama ada nombor pesanan sedia ada dikemas kini atau ditambah sebagai baharu.

Untuk menghapuskan kerja manual, pilih kaedah pemuatan automatik dalam tetapan:

- **Pelayan fail OptiRoutes** — sistem Anda meletakkan fail harian, yang dinamakan mengikut tarikh, dalam folder syarikat Anda di pelayan FTP atau di pelayan SFTP yang disulitkan.
- **Pelayan FTP Anda sendiri** — OptiRoutes berhubung dengan pengguna yang Anda berikan dan memuatkan fail yang dinamakan dengan tarikh hari ini, atau fail yang paling baru dikemas kini.
- **Import dan eksport automatik** — pesanan dimuatkan dengan sendirinya dan laluan juga dirancang, tanpa perlu sebarang klik.
- **API fail** — perisian Anda memuat naik fail pesanan melalui HTTPS, seperti yang diterangkan di bawah.

Di skrin pelanggan, fail Excel atau CSV dengan nombor pelanggan, nama, alamat, masa hentian serta waktu buka dan tutup mencipta atau mengemas kini pelanggan dan tetingkap masa mereka.

## API fail: pesanan masuk, POD dan laporan keluar

Setiap syarikat dalam OptiRoutes mempunyai folder fail peribadinya sendiri: pesanan yang dimuatkannya, nota penghantaran bertandatangan bersama foto dan tandatangannya, eksport laluan dan laporan akhir hari. **API fail** membolehkan sistem Anda membaca dan menulis folder itu secara terus melalui HTTPS, tanpa pelayan FTP di antaranya. Pengurus syarikat bertukar antara FTP dan API dalam **Tetapan → API & fail** dan mencipta kunci di situ — tiada permintaan kepada sokongan diperlukan, dan syarikat baharu bermula dengan API.

| Folder | Kandungannya | Siapa yang menulis |
| --- | --- | --- |
| orders_files/ | Fail pesanan harian, dan eksport laluan. | Anda (pesanan), OptiRoutes (eksport) |
| pod/YYYY/MM/DD/ | POD bertandatangan hari itu: PDF bertandatangan, tandatangan dan foto. | OptiRoutes |
| pod/ | Nota penghantaran sumber untuk ditandatangani dalam aplikasi pemandu, satu PDF bagi setiap nombor pesanan. | Anda |
| reports/YYYY/MM/ | Laporan akhir hari dan pemulangan. | OptiRoutes |
| podBaseFile/ | Borang asas POD. | Anda |
| inbox/ | Folder bebas untuk fail yang ingin Anda serahkan. | Anda |

Folder syarikat dalam API fail.

Panggilan merangkumi menyemak kunci, menyenaraikan folder, memuat turun, memuat naik (sehingga 50 MB setiap fail) dan memadam fail yang Anda muat naik, menyenaraikan fail POD sesuatu hari mengikut pesanan dan jenis, serta memuat turun setiap fail POD sesuatu hari sebagai satu ZIP. Panduan ini merangkumi contoh kod dalam Python, C# dan Node.js, serta skrip PowerShell yang memastikan folder di pelayan Anda sentiasa segerak dengan folder syarikat — jadi pasukan yang biasa menggunakan FTP boleh terus bekerja dengan cara yang sama. Baca di [panduan API fail](https://srv2.optiroutes.com/api/v1/docs?lang=ms).

## Bagaimanakah kunci API dilindungi?

- **Keistimewaan minimum** — setiap kunci hanya mendapat kebenaran yang diperlukan: POD bertandatangan sahaja, membaca setiap fail, atau memuat naik pesanan dan fail peti masuk.
- **Alamat yang dibenarkan** — kunci boleh dihadkan kepada alamat IP tetap pelayan Anda.
- **Tamat tempoh dan penggiliran** — kunci boleh tamat tempoh selepas beberapa hari; cipta kunci baharu, bertukar, kemudian batalkan kunci lama tanpa sebarang gangguan.
- **Batalkan serta-merta** — kunci yang dibatalkan berhenti berfungsi dalam masa 30 saat.
- **Audit** — setiap panggilan direkod dengan masa, alamat, fail dan jawapan, dan dipaparkan kepada pengurus.
- **Disimpan dengan selamat** — OptiRoutes hanya menyimpan cap jari SHA-256 setiap kunci; sambungan menggunakan HTTPS dengan TLS 1.2 atau lebih baharu, dan kunci hanya boleh mencapai folder syarikatnya sendiri.

Had: 300 permintaan seminit bagi setiap kunci, 50 MB setiap fail, 20 kunci aktif bagi setiap syarikat, dan sehingga 5,000 entri dalam satu penyenaraian folder.

## API laporan dan tolakan

Untuk alat pelaporan dan penyambung ERP, API berasingan di api-users.optiroutes.com menyalurkan data syarikat Anda sebagai laporan dan menerima data yang ditolak. Satu alamat dan satu token, yang dikeluarkan oleh OptiRoutes untuk syarikat Anda, meliputi setiap panggilan. Halaman dokumentasi membolehkan Anda menampal token dan melihat laporan mana yang terbuka kepada Anda serta pemetaan lajur akaun Anda: [baca dokumentasi API](https://api-users.optiroutes.com/api-docs/en).

| Laporan | Apa yang dikembalikan |
| --- | --- |
| orders | Pesanan dan penghantaran, bersama laluan dan pemandu. |
| routes | Laluan, bersama pemandu dan bilangan hentian. |
| drivers | Data pemandu. |
| customers | Data dan alamat pelanggan. |
| pod | Dokumentasi penghantaran. |
| delivery-summary | Ringkasan harian mengikut status. |

Dua panggilan tolakan berfungsi ke arah sebaliknya: menolak pesanan menulis fail pesanan hari itu dan memulakan pemuatan automatik, manakala menolak pemandu, jalur dan kenderaan menggantikan seluruh armada, seperti fail armada. Oleh kerana senarai pemandu yang ditolak dikira sebagai armada penuh, sentiasa hantar setiap pemandu, bukan hanya perubahannya.

## Mengeksport laluan dan webhook

Eksport laluan menulis laluan bertanda dalam format CSV, XLSX, XML, JSON atau TXT lebar tetap. Jadual lajur menentukan medan mana yang dikeluarkan dan di bawah tajuk apa, lajur asal fail pesanan Anda boleh ditambah, dan dengan pengurusan item, fail kedua menyenaraikan setiap item. Eksport boleh dihantar ke komputer Anda, pelayan FTP Anda atau folder syarikat, dan dengan JSON eksport juga boleh dihantar ke alamat web; jika penghantaran gagal, sistem mencuba sekali lagi.

Untuk setiap penghantaran sebaik sahaja ia berlaku, isi **alamat laporan penghantaran** dalam tetapan aplikasi pemandu: setiap laporan penghantaran yang dibuat oleh pemandu turut dihantar ke sana, jadi sistem lain milik Anda dikemas kini dengan sendirinya.

## E-mel, pembayaran, peta dan pemesejan

- **E-mel** — nota penghantaran bertandatangan dihantar daripada akaun Gmail Anda sendiri dengan kata laluan aplikasi Google; laporan seperti laporan palet akhir hari dihantar ke e-mel laporan Anda; pelanggan yang membayar menerima resit dan pemandu menerima pengesahan deposit daripada kaunter tunai.
- **Pembayaran** — tambah nilai dibayar di halaman pembayaran Stripe yang selamat, dengan kad tersimpan secara pilihan untuk tambah nilai automatik.
- **Alamat dan peta** — alamat dipilih daripada cadangan Google dan disahkan pada peta sebelum perancangan.
- **Navigasi** — aplikasi pemandu menyerahkan setiap hentian kepada Waze, atau Apple Maps pada iPhone, mengikut alamat atau koordinat tepat.
- **SMS dan WhatsApp** — mesej ketibaan dan pautan penjejakan kepada pelanggan, amaran kepada pengurus, jalur kepada subkontraktor, dan gambar laluan kepada pemandu di WhatsApp.

Merancang integrasi dengan ERP atau sistem gudang Anda? Beritahu kami apa yang perlu Anda sambungkan.

[Mulakan percubaan percuma](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations)

## Soalan lazim

### Bolehkah OptiRoutes memuatkan pesanan secara automatik daripada ERP kami?

Ya. ERP Anda boleh meletakkan fail harian di pelayan FTP atau SFTP OptiRoutes, di pelayan FTP Anda sendiri, atau memuat naiknya melalui API fail, dan OptiRoutes memuatkannya dengan sendirinya.

### Bagaimanakah kami membawa POD bertandatangan ke dalam sistem kami?

Melalui API fail: senaraikan dan muat turun fail POD sesuatu hari, atau muat turun semuanya sebagai satu ZIP. Salinan juga dihantar melalui e-mel mengikut peraturan penghantaran Anda.

### Siapakah yang mencipta kunci API untuk API fail?

Pengurus syarikat, dalam Tetapan, API & fail. Kunci mempunyai kebenaran, alamat yang dibenarkan dan tamat tempoh secara pilihan, dan boleh dibatalkan pada bila-bila masa.

### Adakah terdapat API untuk laporan?

Ya. API laporan mengembalikan pesanan, laluan, pemandu, pelanggan, POD dan ringkasan penghantaran harian, dengan token yang dikeluarkan oleh OptiRoutes.

### Dalam format fail apakah laluan boleh dieksport?

CSV, XLSX, XML, JSON dan TXT lebar tetap, dengan lajur dan tajuk yang Anda pilih.

---

OptiRoutes · 1235 Jefferson Ave, Redwood City, CA 94062, USA · yoni@optiroutes.com · https://optiroutes.com/ms/