คู่มือทีละขั้น
การดูแลการเชื่อมต่อ ERP — สิ่งที่ตรวจได้จริงและส่วนที่ยังไม่เปิดใช้
กำหนด Runbook สำหรับ Operator/IT โดยยึดเฉพาะ Docs, Customer Domain และ Manual Test พร้อมทำเครื่องหมายชัดเจนว่า Connectors, Mapping, Queue, Logs และ Automatic delivery ยังใช้งานเป็น Production workflow ไม่ได้
อ่านบทนี้แล้วทำอะไรได้
- ไม่ใช้ Hidden tab เป็น Production workflow
- เก็บหลักฐานที่ช่วยวิเคราะห์ Manual Test ได้ครบ
- ไม่สรุปว่า Weighing record ถูกส่งอัตโนมัติจากผล Test API
เตรียมก่อนเริ่ม
- อ่าน Integration overview และ Settings แล้ว
- มีช่องทางดู Log ฝั่ง ERP เพราะ Android ยังไม่เปิด Logs tab
- ตกลงผู้รับผิดชอบเหตุขัดข้องทั้งฝั่ง Tablet และ ERP
สารบัญในหน้านี้
1. ขอบเขตบังคับของรุ่นปัจจุบัน
2. Runbook ที่ Operator ทำได้จริง
- ขั้นตอนที่ 1
ตรวจ Subscription
Refresh และยืนยันว่าเป็น Organisations/enterprise_manual พร้อม erp_integration และ cache ไม่เกิน 72 ชั่วโมง
- ขั้นตอนที่ 2
เปิด Docs
ยืนยัน endpoint และ payload contract ตามรุ่นแอป
- ขั้นตอนที่ 3
ตรวจ Domain/Target URL
เทียบค่าบน Settings กับ Test endpoint ที่ทีม ERP แจ้ง
- ขั้นตอนที่ 4
กด Manual Test เมื่อได้รับอนุญาต
ส่ง sample เพียงจำนวนที่ตกลงและจดเวลาทดสอบ
- ขั้นตอนที่ 5
ให้ ERP ตรวจ Server log
ใช้เวลา Target URL และ payload identifier เพื่อค้นหา request ฝั่งปลายทาง
- ขั้นตอนที่ 6
ส่งต่อหลักฐาน
หากล้มเหลวให้ส่ง HTTP status, response, screenshot และ network context โดยไม่เปิดเผย secret
3. Technical context สำหรับทีมพัฒนาเท่านั้น
4. Checklist เมื่อ Manual Test ล้มเหลว
- ยืนยันว่าใช้ Test endpoint ไม่ใช่ Production โดยไม่ได้รับอนุญาต
- ตรวจ http:// หรือ https://, DNS, VPN, Firewall และ Certificate
- เทียบ /weighing/records กับ route ฝั่ง ERP
- ตรวจ 401/403 ที่ credential และ permission ฝั่ง Server
- ตรวจ 409 โดยใช้ idempotency key/request ใหม่ตามแผนทดสอบ
- ตรวจ 4xx ที่ payload/schema และ 5xx/timeout ที่ Server log
- อย่าเปิด Tab ที่ซ่อนหรือแก้ database local เพื่อข้าม UI
5. ก่อนประกาศว่า Production พร้อม ต้องมีหลักฐานเพิ่ม
- มีจุด enqueue จาก Weighing record จริงที่ทดสอบ end-to-end แล้ว
- มีวิธีดู Queue, Retry, Failed และ Transaction log ที่ผู้รับผิดชอบเข้าถึงได้
- Mapping ผ่านกรณีข้อมูลจริงและ versioning ของ contract
- Company/Branch scope ของ Connector ถูกยืนยัน
- ทดสอบ duplicate, timeout, offline/online, token expiry และ recovery
- มี monitoring และเจ้าของ incident ฝั่ง WeWeigh/ERP
Continue learning
Next Steps — อ่านอะไรต่อ
เลือกบทถัดไปตามงานที่คุณกำลังตั้งค่า เพื่อเรียนต่อได้โดยไม่ข้ามขั้นสำคัญ
อ่านสถานะ Subscription
ตรวจ Plan, Status, Days remaining, Period end และ Renewal source พร้อม Refresh/Switch scope และเข้าใจเหตุผลที่ Business Module ถูกบล็อกแม้เคยใช้งานได้ออฟไลน์
Sync Queue และส่งข้อมูล
เข้าใจ Pending, Auto sync, การกด Sync ด้วยตนเอง ผล Synced/Deferred/Failed และข้อจำกัดของหน้าคิวในเวอร์ชันปัจจุบัน