Tích hợp và API
OptiRoutes kết nối với các hệ thống bạn đang dùng. Đơn hàng đi vào từ tệp Excel hoặc CSV, từ FTP hoặc SFTP, hoặc qua Files API bảo mật; phiếu giao hàng đã ký, tệp xuất tuyến và báo cáo quay về theo cùng cách đó. API báo cáo cung cấp dữ liệu của bạn cho các công cụ BI, và các địa chỉ web nhận báo cáo giao hàng và tệp xuất tuyến ngay khi chúng phát sinh.
Cập nhật:
OptiRoutes cung cấp những tích hợp nào?
| Nhu cầu | Cách OptiRoutes thực hiện |
|---|---|
| Nạp đơn hàng trong ngày | Tải lên Excel hoặc CSV, tự động nạp từ FTP, SFTP hoặc Files API, ở dạng CSV, JSON hoặc TXT độ rộng cố định. |
| Thu thập POD đã ký | Lệnh gọi Files API theo ngày hoặc theo đơn hàng, hoặc một tệp ZIP mỗi ngày; bản sao qua email. |
| Gửi tuyến sang hệ thống của bạn | Xuất tuyến ở dạng CSV, XLSX, XML, JSON hoặc TXT, ra tệp, lên FTP của bạn, thư mục công ty hoặc một địa chỉ web. |
| Đưa báo cáo vào BI hoặc ERP | API báo cáo: đơn hàng, tuyến, tài xế, khách hàng, POD và bản tổng kết giao hàng hằng ngày. |
| Phản hồi theo từng lượt giao | Một địa chỉ nhận báo cáo giao hàng, nhận mọi báo cáo ngay khi được tạo. |
| Thanh toán dịch vụ | Stripe Checkout cho nạp tiền trả trước và nạp tiền tự động. |
Nạp đơn hàng từ tệp, FTP hoặc SFTP
Cách tích hợp đơn giản nhất là chính tệp mà hệ thống của bạn đang xuất ra. Trên màn hình đơn hàng, Nạp đơn giao hàng đọc tệp Excel hoặc CSV; bạn ánh xạ mỗi trường của hệ thống — địa chỉ, tên khách hàng, số đơn hàng, số lượng và các trường khác — với tên cột của mình một lần, và mọi tệp sau đó đều được nạp theo cùng cách. Với tệp TXT độ rộng cố định, bạn nhập vị trí ký tự thay cho tên cột. Có thể bỏ qua các dòng theo một từ đánh dấu trong ghi chú, một từ đánh dấu thứ hai có thể thay thế địa chỉ, và bạn quyết định số đơn hàng đã tồn tại sẽ được cập nhật hay thêm mới.
Để loại bỏ thao tác thủ công, hãy chọn một phương thức tự động nạp trong phần cài đặt:
- Máy chủ tệp OptiRoutes — hệ thống của bạn đặt tệp hằng ngày, đặt tên theo ngày, vào thư mục của công ty trên máy chủ FTP hoặc máy chủ SFTP mã hóa.
- Máy chủ FTP của riêng bạn — OptiRoutes kết nối bằng tài khoản bạn cung cấp và nạp tệp mang ngày hôm nay, hoặc tệp được cập nhật gần nhất.
- Tự động nhập và xuất — đơn hàng tự nạp vào và tuyến cũng được lập luôn, không cần nhấp chuột.
- Files API — phần mềm của bạn tải tệp đơn hàng lên qua HTTPS, như mô tả bên dưới.
Trên màn hình khách hàng, một tệp Excel hoặc CSV có mã khách hàng, tên, địa chỉ, thời gian dừng và giờ mở cửa, đóng cửa sẽ tạo mới hoặc cập nhật khách hàng cùng khung giờ của họ.
Files API: đơn hàng vào, POD và báo cáo ra
Mỗi công ty trong OptiRoutes có một thư mục tệp riêng: các đơn hàng công ty nạp vào, các phiếu giao hàng đã ký kèm ảnh và chữ ký, các tệp xuất tuyến và các báo cáo cuối ngày. Files API cho phép hệ thống của bạn đọc và ghi trực tiếp vào thư mục đó qua HTTPS, không cần máy chủ FTP trung gian. Quản lý của công ty chuyển đổi giữa FTP và API tại Cài đặt → API và tệp và tạo khóa ngay tại đó — không cần gửi yêu cầu đến bộ phận hỗ trợ, và các công ty mới bắt đầu với API.
| Thư mục | Nội dung | Ai ghi |
|---|---|---|
| orders_files/ | Tệp đơn hàng hằng ngày, và các tệp xuất tuyến. | Bạn (đơn hàng), OptiRoutes (tệp xuất) |
| pod/YYYY/MM/DD/ | POD đã ký của ngày đó: tệp PDF đã ký, chữ ký và ảnh. | OptiRoutes |
| pod/ | Phiếu giao hàng gốc để ký trong ứng dụng tài xế, mỗi số đơn hàng một tệp PDF. | Bạn |
| reports/YYYY/MM/ | Báo cáo cuối ngày và báo cáo hàng trả lại. | OptiRoutes |
| podBaseFile/ | Mẫu POD cơ sở. | Bạn |
| inbox/ | Thư mục tự do cho các tệp bạn muốn chuyển giao. | Bạn |
Các lệnh gọi bao gồm kiểm tra khóa, liệt kê thư mục, tải xuống, tải lên (tối đa 50 MB mỗi tệp) và xóa các tệp bạn đã tải lên, liệt kê các tệp POD của một ngày theo đơn hàng và loại, và tải xuống mọi tệp POD của một ngày trong một tệp ZIP. Hướng dẫn có mã mẫu bằng Python, C# và Node.js, cùng một tập lệnh PowerShell giữ cho một thư mục trên máy chủ của bạn luôn đồng bộ với thư mục công ty — để đội ngũ đã quen dùng FTP có thể tiếp tục làm việc như cũ. Đọc tại hướng dẫn Files API.
Khóa API được bảo mật như thế nào?
- Quyền tối thiểu — mỗi khóa chỉ nhận những quyền cần thiết: chỉ POD đã ký, đọc mọi tệp, hoặc tải lên đơn hàng và tệp vào hộp thư đến.
- Địa chỉ được phép — khóa có thể được giới hạn theo các địa chỉ IP cố định của máy chủ bạn.
- Hết hạn và luân chuyển — khóa có thể hết hạn sau một số ngày; tạo khóa mới, chuyển sang dùng, rồi thu hồi khóa cũ mà không gián đoạn dịch vụ.
- Thu hồi ngay lập tức — khóa bị thu hồi ngừng hoạt động trong vòng 30 giây.
- Nhật ký kiểm tra — mọi lệnh gọi đều được ghi nhật ký kèm thời gian, địa chỉ, tệp và phản hồi, và hiển thị cho quản lý.
- Lưu trữ an toàn — OptiRoutes chỉ lưu dấu vân tay SHA-256 của mỗi khóa; kết nối qua HTTPS với TLS 1.2 trở lên, và mỗi khóa chỉ truy cập được thư mục của chính công ty mình.
Giới hạn: 300 yêu cầu mỗi phút cho mỗi khóa, 50 MB mỗi tệp, 20 khóa đang hoạt động cho mỗi công ty, và tối đa 5.000 mục trong một lần liệt kê thư mục.
API báo cáo và đẩy dữ liệu
Với các công cụ báo cáo và trình kết nối ERP, một API riêng tại api-users.optiroutes.com cung cấp dữ liệu của công ty bạn dưới dạng báo cáo và nhận dữ liệu được đẩy vào. Một địa chỉ và một token, do OptiRoutes cấp cho công ty bạn, dùng cho mọi lệnh gọi. Trang tài liệu cho phép bạn dán token để xem những báo cáo nào được mở cho bạn và ánh xạ cột của tài khoản: đọc tài liệu API.
| Báo cáo | Dữ liệu trả về |
|---|---|
| orders | Đơn hàng và đơn giao hàng, kèm tuyến và tài xế. |
| routes | Tuyến, kèm tài xế và số điểm dừng. |
| drivers | Dữ liệu tài xế. |
| customers | Dữ liệu và địa chỉ khách hàng. |
| pod | Chứng từ giao hàng. |
| delivery-summary | Bản tổng kết hằng ngày theo trạng thái. |
Hai lệnh gọi đẩy dữ liệu hoạt động theo chiều ngược lại: đẩy đơn hàng sẽ ghi tệp đơn hàng của ngày và khởi động việc tự động nạp, còn đẩy tài xế, tuyến cố định và xe sẽ thay thế toàn bộ đội xe, giống như một tệp đội xe. Vì danh sách tài xế được đẩy vào được tính là toàn bộ đội xe, hãy luôn gửi mọi tài xế, không chỉ những thay đổi.
Xuất tuyến và webhook
Chức năng xuất tuyến ghi các tuyến đã đánh dấu ở dạng CSV, XLSX, XML, JSON hoặc TXT độ rộng cố định. Một bảng cột quyết định trường nào được xuất và dưới tiêu đề nào, có thể thêm các cột gốc của tệp đơn hàng, và với tính năng quản lý mặt hàng, một tệp thứ hai liệt kê mọi mặt hàng. Tệp xuất có thể được lưu về máy tính, lên máy chủ FTP của bạn hoặc vào thư mục công ty, và với JSON, tệp xuất còn có thể được gửi đến một địa chỉ web; nếu gửi thất bại, hệ thống thử lại thêm một lần.
Để nhận từng lượt giao ngay khi diễn ra, hãy điền địa chỉ nhận báo cáo giao hàng trong cài đặt ứng dụng tài xế: mọi báo cáo giao hàng của tài xế cũng được gửi đến đó, để một hệ thống khác của bạn tự động cập nhật.
Email, thanh toán, bản đồ và nhắn tin
- Email — phiếu giao hàng đã ký được gửi từ chính tài khoản Gmail của bạn bằng mật khẩu ứng dụng Google; các báo cáo như báo cáo pallet cuối ngày được gửi đến email nhận báo cáo của bạn; khách hàng đã thanh toán nhận biên nhận và tài xế nhận xác nhận nộp tiền từ quầy thu ngân.
- Thanh toán — các khoản nạp tiền được thanh toán trên trang thanh toán bảo mật của Stripe, với tùy chọn lưu thẻ để nạp tiền tự động.
- Địa chỉ và bản đồ — địa chỉ được chọn từ gợi ý của Google và xác minh trên bản đồ trước khi lập kế hoạch.
- Dẫn đường — ứng dụng tài xế chuyển từng điểm dừng sang Waze, hoặc Apple Maps trên iPhone, theo địa chỉ hoặc theo tọa độ chính xác.
- SMS và WhatsApp — tin nhắn báo giờ đến và liên kết theo dõi cho khách hàng, cảnh báo cho quản lý, gửi tuyến cho nhà thầu phụ, và hình ảnh tuyến cho tài xế qua WhatsApp.
Đang lên kế hoạch tích hợp với ERP hoặc hệ thống kho của bạn? Hãy cho chúng tôi biết bạn cần kết nối những gì.
Dùng thử miễn phí 3 ngày · tối đa 50 địa chỉ mỗi ngày · không cần thẻ tín dụng
Câu hỏi thường gặp
OptiRoutes có thể tự động nạp đơn hàng từ ERP của chúng tôi không?
Có. ERP của bạn có thể đặt tệp hằng ngày lên máy chủ FTP hoặc SFTP của OptiRoutes, lên máy chủ FTP của riêng bạn, hoặc tải lên qua Files API, và OptiRoutes sẽ tự động nạp.
Làm sao đưa POD đã ký vào hệ thống của chúng tôi?
Qua Files API: liệt kê và tải xuống các tệp POD của một ngày, hoặc tải tất cả trong một tệp ZIP. Bản sao cũng được gửi email theo quy tắc chuyển của bạn.
Ai tạo khóa API cho Files API?
Quản lý của công ty, tại Cài đặt, API và tệp. Khóa có quyền hạn, tùy chọn địa chỉ được phép và thời hạn, và có thể thu hồi bất cứ lúc nào.
Có API cho báo cáo không?
Có. API báo cáo trả về đơn hàng, tuyến, tài xế, khách hàng, POD và bản tổng kết giao hàng hằng ngày, với token do OptiRoutes cấp.
Có thể xuất tuyến ra những định dạng tệp nào?
CSV, XLSX, XML, JSON và TXT độ rộng cố định, với các cột và tiêu đề bạn chọn.
Dùng thử miễn phí — 3 ngày, không cần thẻ
Dùng thử miễn phí 3 ngày · tối đa 50 địa chỉ mỗi ngày · không cần thẻ tín dụng