คู่มือทีละขั้น
ศูนย์เชื่อมต่อระบบ (Integration Center) — อ่าน API Contract และทดสอบปลายทางอย่างปลอดภัย
อธิบายเฉพาะความสามารถที่ UI Android เปิดใช้จริงในรุ่นปัจจุบัน ได้แก่ Docs และ Settings พร้อมขอบเขตที่ยังไม่ควรถือว่าเป็นระบบส่ง ERP อัตโนมัติ
อ่านบทนี้แล้วทำอะไรได้
- แยก Docs กับ Settings ได้
- อ่าน Endpoint และ Payload contract ก่อนทดสอบ
- เข้าใจว่าส่วน Operations และ Automatic delivery ยังไม่ยืนยันว่าใช้งานได้
เตรียมก่อนเริ่ม
- ใช้แพ็กเกจ Organisations/enterprise_manual ที่มี erp_integration
- Login และเลือก Company/Branch ที่ถูกต้อง
- มี Test endpoint ที่ทีม ERP อนุญาตให้รับ sample payload
สารบัญในหน้านี้
1. ขอบเขตที่เปิดให้ใช้จริง
2. ใช้ Docs เพื่อทำความเข้าใจ Contract
- ขั้นตอนที่ 1
เปิด Integration Center
เข้า navigation drawer แล้วเลือก Integration Center หากเมนู disabled ให้ตรวจ Subscription และ Refresh
- ขั้นตอนที่ 2
เปิด Tab Docs
Swagger UI โหลดจาก asset ภายในแอป จึงใช้สำหรับอ่าน schema และ endpoint ที่มากับรุ่นแอปนี้
- ขั้นตอนที่ 3
ค้นหา Weighing records
ตรวจ method, path, request fields, response และตัวอย่าง payload ร่วมกับทีม ERP
- ขั้นตอนที่ 4
บันทึก Contract version
เก็บรุ่นแอป วันที่ตรวจ และตัวอย่าง payload ไว้ในเอกสารส่งมอบ เพื่อเทียบเมื่อระบบใดระบบหนึ่งอัปเดต
3. ลำดับทดสอบที่ไม่กระทบ Production
- ขั้นตอนที่ 1
ให้ ERP เตรียม Test endpoint
ใช้ปลายทางที่ยอมรับ sample record และไม่สร้างเอกสารบัญชี/คลังจริง
- ขั้นตอนที่ 2
ยืนยัน HTTPS และ Firewall
ตรวจ Certificate, VPN, allowlist และเส้นทางจาก Tablet ไปยัง Domain
- ขั้นตอนที่ 3
เทียบ Payload กับ Docs
ตรวจ field บังคับ ชนิดข้อมูล หน่วย เวลา และ idempotency ก่อนยิง request
- ขั้นตอนที่ 4
กรอก Domain ใน Settings
ใช้ URL เต็มที่มี http:// หรือ https:// แล้วตรวจ Target URL
- ขั้นตอนที่ 5
กด Test API เพียงครั้งเดียว
ปุ่มนี้ส่ง sample payload จริงไปยัง endpoint จึงต้องได้รับอนุญาตจากเจ้าของระบบก่อน
4. สิ่งที่ผล Passed ยังไม่ยืนยัน
- ไม่ได้ยืนยันว่า Weighing record ทุกตัวจะถูกส่ง ERP อัตโนมัติ
- ไม่ได้ยืนยันว่า field mapping สำหรับข้อมูลจริงครบทุกกรณี
- ไม่ได้ยืนยันว่า Queue, Retry และ Logs เปิดให้ Operator ตรวจได้
- ไม่ได้ยืนยันว่า Company/Branch scope ของการตั้งค่าตรงกับ Production ทุกเครื่อง
- ยืนยันเพียงว่าการทดสอบ sample request ครั้งนั้นได้รับผลตามที่แอปแสดง
Continue learning
Next Steps — อ่านอะไรต่อ
เลือกบทถัดไปตามงานที่คุณกำลังตั้งค่า เพื่อเรียนต่อได้โดยไม่ข้ามขั้นสำคัญ