การเชื่อมต่อระบบและ API
OptiRoutes เชื่อมต่อกับระบบที่คุณใช้อยู่แล้ว คำสั่งซื้อเข้ามาจากไฟล์ Excel หรือ CSV จาก FTP หรือ SFTP หรือผ่าน Files API ที่ปลอดภัย ใบส่งของที่ลงนาม ไฟล์ส่งออกเส้นทาง และรายงานส่งกลับด้วยวิธีเดียวกัน API รายงานส่งข้อมูลของคุณไปยังเครื่องมือ BI และที่อยู่เว็บรับรายงานการจัดส่งและไฟล์ส่งออกเส้นทางได้ทันทีที่เกิดขึ้น
อัปเดตเมื่อ:
OptiRoutes มีการเชื่อมต่อระบบใดบ้าง
| ความต้องการ | วิธีที่ OptiRoutes ทำ |
|---|---|
| โหลดคำสั่งซื้อของวัน | อัปโหลด Excel หรือ CSV หรือโหลดอัตโนมัติจาก FTP, SFTP หรือ Files API ในรูปแบบ CSV, JSON หรือ TXT แบบความกว้างคงที่ |
| เก็บ POD ที่ลงนาม | เรียก Files API รายวันหรือรายคำสั่งซื้อ หรือ ZIP เดียวต่อวัน พร้อมสำเนาทางอีเมล |
| ส่งเส้นทางไปยังระบบของคุณ | ส่งออกเส้นทางเป็น CSV, XLSX, XML, JSON หรือ TXT ไปยังไฟล์ FTP ของคุณ โฟลเดอร์ของบริษัท หรือที่อยู่เว็บ |
| ส่งรายงานเข้า BI หรือ ERP ของคุณ | API รายงาน: คำสั่งซื้อ เส้นทาง คนขับ ลูกค้า POD และสรุปการจัดส่งรายวัน |
| ตอบสนองต่อการจัดส่งแต่ละครั้ง | ที่อยู่สำหรับรายงานการจัดส่งที่รับทุกรายงานทันทีที่ทำ |
| ชำระค่าบริการ | Stripe Checkout สำหรับการเติมเงินแบบชำระล่วงหน้าและการเติมเงินอัตโนมัติ |
การโหลดคำสั่งซื้อจากไฟล์ FTP หรือ SFTP
การเชื่อมต่อที่ง่ายที่สุดคือไฟล์ที่ระบบของคุณส่งออกอยู่แล้ว บนหน้าจอคำสั่งซื้อ โหลดรายการจัดส่ง จะอ่านไฟล์ Excel หรือ CSV คุณจับคู่แต่ละฟิลด์ของระบบ เช่น ที่อยู่ ชื่อลูกค้า เลขที่คำสั่งซื้อ จำนวน และอื่น ๆ กับชื่อคอลัมน์ของคุณเพียงครั้งเดียว แล้วไฟล์ต่อ ๆ ไปจะโหลดแบบเดียวกัน สำหรับไฟล์ TXT แบบความกว้างคงที่ ให้ระบุตำแหน่งอักขระแทนชื่อคอลัมน์ ข้ามแถวได้ด้วยคำระบุในหมายเหตุ คำระบุที่สองใช้แทนที่ที่อยู่ได้ และคุณกำหนดได้ว่าเลขที่คำสั่งซื้อที่มีอยู่แล้วจะอัปเดตหรือเพิ่มเป็นรายการใหม่
หากต้องการให้ไม่ต้องใช้คนเลย ให้เลือกวิธีโหลดอัตโนมัติในการตั้งค่า:
- เซิร์ฟเวอร์ไฟล์ของ OptiRoutes ระบบของคุณวางไฟล์รายวันที่ตั้งชื่อตามวันที่ไว้ในโฟลเดอร์ของบริษัทบนเซิร์ฟเวอร์ FTP หรือเซิร์ฟเวอร์ SFTP ที่เข้ารหัส
- เซิร์ฟเวอร์ FTP ของคุณเอง OptiRoutes เชื่อมต่อด้วยผู้ใช้ที่คุณให้ไว้ และโหลดไฟล์ที่ตั้งชื่อตามวันที่วันนี้ หรือไฟล์ที่อัปเดตล่าสุด
- นำเข้าและส่งออกอัตโนมัติ คำสั่งซื้อโหลดเข้ามาเองและเส้นทางก็ถูกวางแผนด้วย โดยไม่ต้องคลิกเลย
- Files API ซอฟต์แวร์ของคุณอัปโหลดไฟล์คำสั่งซื้อผ่าน HTTPS ตามที่อธิบายด้านล่าง
บนหน้าจอลูกค้า ไฟล์ Excel หรือ CSV ที่มีรหัสลูกค้า ชื่อ ที่อยู่ เวลาจอด และเวลาเปิดกับเวลาปิด จะสร้างหรืออัปเดตลูกค้าและช่วงเวลาจัดส่งของลูกค้า
Files API: คำสั่งซื้อเข้า POD และรายงานออก
ทุกบริษัทใน OptiRoutes มีโฟลเดอร์ไฟล์ส่วนตัวของตนเอง ได้แก่ คำสั่งซื้อที่โหลดเข้า ใบส่งของที่ลงนามพร้อมรูปถ่ายและลายเซ็น ไฟล์ส่งออกเส้นทาง และรายงานสิ้นวัน Files API ให้ระบบของคุณอ่านและเขียนโฟลเดอร์นั้นได้โดยตรงผ่าน HTTPS โดยไม่ต้องมีเซิร์ฟเวอร์ FTP คั่นกลาง ผู้จัดการของบริษัทสลับระหว่าง FTP กับ API ได้ใน การตั้งค่า → API และไฟล์ และสร้างคีย์ได้ที่นั่น ไม่ต้องติดต่อฝ่ายสนับสนุน และบริษัทใหม่เริ่มต้นด้วย API
| โฟลเดอร์ | สิ่งที่อยู่ข้างใน | ผู้เขียนข้อมูล |
|---|---|---|
| orders_files/ | ไฟล์คำสั่งซื้อรายวัน และไฟล์ส่งออกเส้นทาง | คุณ (คำสั่งซื้อ) OptiRoutes (ไฟล์ส่งออก) |
| pod/YYYY/MM/DD/ | POD ที่ลงนามของวันนั้น ได้แก่ PDF ที่ลงนาม ลายเซ็น และรูปถ่าย | OptiRoutes |
| pod/ | ใบส่งของต้นฉบับที่จะลงนามในแอปคนขับ หนึ่ง PDF ต่อเลขที่คำสั่งซื้อ | คุณ |
| reports/YYYY/MM/ | รายงานสิ้นวันและรายงานสินค้าคืน | OptiRoutes |
| podBaseFile/ | แบบฟอร์มพื้นฐานของ POD | คุณ |
| inbox/ | โฟลเดอร์อิสระสำหรับไฟล์ที่คุณต้องการส่งมอบ | คุณ |
คำสั่งเรียกใช้ครอบคลุมการตรวจคีย์ การแสดงรายการในโฟลเดอร์ การดาวน์โหลด การอัปโหลด (สูงสุด 50 MB ต่อไฟล์) และการลบไฟล์ที่คุณอัปโหลด การแสดงรายการไฟล์ POD ของวันตามคำสั่งซื้อและประเภท และการดาวน์โหลดไฟล์ POD ทั้งหมดของวันเป็น ZIP เดียว คู่มือมีตัวอย่างโค้ดใน Python, C# และ Node.js และสคริปต์ PowerShell ที่ซิงก์โฟลเดอร์บนเซิร์ฟเวอร์ของคุณกับโฟลเดอร์ของบริษัท ทีมที่คุ้นเคยกับ FTP จึงทำงานแบบเดิมต่อไปได้ อ่านได้ที่คู่มือ Files API
คีย์ API ได้รับการรักษาความปลอดภัยอย่างไร
- สิทธิ์น้อยที่สุดเท่าที่จำเป็น คีย์แต่ละรายการได้รับเฉพาะสิทธิ์ที่ต้องใช้ ได้แก่ เฉพาะ POD ที่ลงนาม อ่านทุกไฟล์ หรืออัปโหลดคำสั่งซื้อและไฟล์ใน inbox
- ที่อยู่ที่อนุญาต จำกัดคีย์ให้ใช้ได้เฉพาะที่อยู่ IP แบบคงที่ของเซิร์ฟเวอร์ของคุณได้
- วันหมดอายุและการหมุนเวียนคีย์ ตั้งให้คีย์หมดอายุหลังจำนวนวันที่กำหนดได้ สร้างคีย์ใหม่ สลับไปใช้ แล้วเพิกถอนคีย์เดิมได้โดยระบบไม่หยุดทำงาน
- เพิกถอนได้ทันที คีย์ที่ถูกเพิกถอนจะหยุดทำงานภายใน 30 วินาที
- การตรวจสอบย้อนหลัง ทุกการเรียกใช้ถูกบันทึกพร้อมเวลา ที่อยู่ ไฟล์ และผลตอบกลับ และแสดงให้ผู้จัดการเห็น
- จัดเก็บอย่างปลอดภัย OptiRoutes เก็บเพียงลายนิ้วมือ SHA-256 ของคีย์แต่ละรายการ การเชื่อมต่อเป็น HTTPS ที่ใช้ TLS 1.2 ขึ้นไป และคีย์เข้าถึงได้เฉพาะโฟลเดอร์ของบริษัทตนเองเท่านั้น
ขีดจำกัด: 300 คำขอต่อนาทีต่อคีย์ 50 MB ต่อไฟล์ 20 คีย์ที่ใช้งานอยู่ต่อบริษัท และสูงสุด 5,000 รายการในการแสดงรายการโฟลเดอร์หนึ่งครั้ง
API รายงานและการส่งข้อมูลเข้า
สำหรับเครื่องมือรายงานและตัวเชื่อมต่อ ERP มี API แยกต่างหากที่ api-users.optiroutes.com ซึ่งส่งข้อมูลของบริษัทคุณเป็นรายงานและรับข้อมูลที่ส่งเข้ามา ที่อยู่เดียวและโทเคนเดียวที่ OptiRoutes ออกให้บริษัทของคุณใช้ได้กับทุกการเรียกใช้ หน้าเอกสารประกอบให้คุณวางโทเคนเพื่อดูว่ารายงานใดเปิดให้คุณใช้ และการจับคู่คอลัมน์ของบัญชีคุณ: อ่านเอกสาร API
| รายงาน | สิ่งที่ส่งกลับ |
|---|---|
| orders | คำสั่งซื้อและรายการจัดส่ง พร้อมเส้นทางและคนขับ |
| routes | เส้นทาง พร้อมคนขับและจำนวนจุดจอด |
| drivers | ข้อมูลคนขับ |
| customers | ข้อมูลและที่อยู่ของลูกค้า |
| pod | เอกสารการจัดส่ง |
| delivery-summary | สรุปรายวันแยกตามสถานะ |
มีคำสั่งส่งข้อมูลเข้าสองคำสั่งที่ทำงานในทิศทางตรงข้าม การส่งคำสั่งซื้อเข้าจะเขียนไฟล์คำสั่งซื้อของวันและเริ่มการโหลดอัตโนมัติ และการส่งคนขับ สายจัดส่ง และรถเข้าจะแทนที่ข้อมูลกองรถทั้งหมด เหมือนไฟล์กองรถ เนื่องจากรายชื่อคนขับที่ส่งเข้าถือเป็นกองรถทั้งหมด จึงต้องส่งคนขับทุกคนเสมอ ไม่ใช่เฉพาะที่เปลี่ยนแปลง
การส่งออกเส้นทางและ webhook
การส่งออกเส้นทางเขียนเส้นทางที่ทำเครื่องหมายไว้เป็น CSV, XLSX, XML, JSON หรือ TXT แบบความกว้างคงที่ ตารางคอลัมน์กำหนดว่าฟิลด์ใดส่งออกและใช้หัวข้อใด เพิ่มคอลัมน์ต้นฉบับจากไฟล์คำสั่งซื้อของคุณได้ และเมื่อใช้การจัดการรายการสินค้า ไฟล์ที่สองจะแสดงรายการสินค้าทั้งหมด ไฟล์ส่งออกส่งไปยังคอมพิวเตอร์ เซิร์ฟเวอร์ FTP ของคุณ หรือโฟลเดอร์ของบริษัทได้ และเมื่อใช้ JSON ยังส่งไปยังที่อยู่เว็บได้ด้วย หากส่งไม่สำเร็จ ระบบจะลองอีกหนึ่งครั้ง
สำหรับการจัดส่งแต่ละครั้งทันทีที่เกิดขึ้น ให้กรอก ที่อยู่สำหรับรายงานการจัดส่ง ในการตั้งค่าแอปคนขับ รายงานการจัดส่งทุกรายการที่คนขับทำจะถูกส่งไปที่นั่นด้วย ระบบอื่นของคุณจึงอัปเดตเองได้
อีเมล การชำระเงิน แผนที่ และการส่งข้อความ
- อีเมล ใบส่งของที่ลงนามส่งจากบัญชี Gmail ของคุณเองด้วยรหัสผ่านแอปของ Google รายงาน เช่น รายงานพาเลทสิ้นวัน ส่งไปยังอีเมลสำหรับรายงานของคุณ ลูกค้าที่ชำระเงินได้รับใบเสร็จ และคนขับได้รับการยืนยันการนำส่งเงินจากแคชเชียร์
- การชำระเงิน การเติมเงินชำระบนหน้าชำระเงินที่ปลอดภัยของ Stripe และเลือกบันทึกบัตรสำหรับการเติมเงินอัตโนมัติได้
- ที่อยู่และแผนที่ ที่อยู่เลือกจากรายการแนะนำของ Google และตรวจสอบบนแผนที่ก่อนวางแผน
- การนำทาง แอปคนขับส่งแต่ละจุดจอดไปยัง Waze หรือ Apple Maps บน iPhone ด้วยที่อยู่หรือพิกัดที่แม่นยำ
- SMS และ WhatsApp ข้อความแจ้งการมาถึงและลิงก์ติดตามถึงลูกค้า การแจ้งเตือนผู้จัดการ สายจัดส่งถึงผู้รับเหมาช่วง และภาพเส้นทางถึงคนขับทาง WhatsApp
กำลังวางแผนเชื่อมต่อกับ ERP หรือระบบคลังสินค้าของคุณใช่ไหม บอกเราได้ว่าคุณต้องการเชื่อมต่ออะไร
ทดลองใช้ฟรี 3 วัน · สูงสุด 50 ที่อยู่ต่อวัน · ไม่ต้องใช้บัตรเครดิต
คำถามที่พบบ่อย
OptiRoutes โหลดคำสั่งซื้อจาก ERP ของเราโดยอัตโนมัติได้หรือไม่
ได้ ERP ของคุณวางไฟล์รายวันไว้บนเซิร์ฟเวอร์ FTP หรือ SFTP ของ OptiRoutes บนเซิร์ฟเวอร์ FTP ของคุณเอง หรืออัปโหลดผ่าน Files API ได้ แล้ว OptiRoutes จะโหลดเอง
จะนำ POD ที่ลงนามเข้าระบบของเราได้อย่างไร
ผ่าน Files API: แสดงรายการและดาวน์โหลดไฟล์ POD ของวัน หรือดาวน์โหลดทั้งหมดเป็น ZIP เดียว สำเนายังส่งทางอีเมลตามกฎการส่งของคุณด้วย
ใครเป็นผู้สร้างคีย์ API สำหรับ Files API
ผู้จัดการของบริษัท ในการตั้งค่า API และไฟล์ คีย์มีสิทธิ์ ที่อยู่ที่อนุญาตและวันหมดอายุซึ่งเลือกกำหนดได้ และเพิกถอนได้ทุกเมื่อ
มี API สำหรับรายงานหรือไม่
มี API รายงานส่งกลับคำสั่งซื้อ เส้นทาง คนขับ ลูกค้า POD และสรุปการจัดส่งรายวัน ด้วยโทเคนที่ OptiRoutes ออกให้
ส่งออกเส้นทางได้ในรูปแบบไฟล์ใดบ้าง
CSV, XLSX, XML, JSON และ TXT แบบความกว้างคงที่ ด้วยคอลัมน์และหัวข้อที่คุณเลือก
เริ่มทดลองใช้ฟรี 3 วัน ไม่ต้องใช้บัตร
ทดลองใช้ฟรี 3 วัน · สูงสุด 50 ที่อยู่ต่อวัน · ไม่ต้องใช้บัตรเครดิต