คู่มือทีละขั้น

การดูแลการเชื่อมต่อ ERP — สิ่งที่ตรวจได้จริงและส่วนที่ยังไม่เปิดใช้

กำหนด Runbook สำหรับ Operator/IT โดยยึดเฉพาะ Docs, Customer Domain และ Manual Test พร้อมทำเครื่องหมายชัดเจนว่า Connectors, Mapping, Queue, Logs และ Automatic delivery ยังใช้งานเป็น Production workflow ไม่ได้

IT Operations / ERP Support / Supervisorอ่านประมาณ 12 นาทีอัปเดต 17 กรกฎาคม 2026

อ่านบทนี้แล้วทำอะไรได้

  • ไม่ใช้ Hidden tab เป็น Production workflow
  • เก็บหลักฐานที่ช่วยวิเคราะห์ Manual Test ได้ครบ
  • ไม่สรุปว่า Weighing record ถูกส่งอัตโนมัติจากผล Test API

เตรียมก่อนเริ่ม

  • อ่าน Integration overview และ Settings แล้ว
  • มีช่องทางดู Log ฝั่ง ERP เพราะ Android ยังไม่เปิด Logs tab
  • ตกลงผู้รับผิดชอบเหตุขัดข้องทั้งฝั่ง Tablet และ ERP
คู่มือที่เกี่ยวข้องตั้งค่า Endpointตรวจ Subscription
สารบัญในหน้านี้

1. ขอบเขตบังคับของรุ่นปัจจุบัน

2. Runbook ที่ Operator ทำได้จริง

  1. ขั้นตอนที่ 1

    ตรวจ Subscription

    Refresh และยืนยันว่าเป็น Organisations/enterprise_manual พร้อม erp_integration และ cache ไม่เกิน 72 ชั่วโมง

  2. ขั้นตอนที่ 2

    เปิด Docs

    ยืนยัน endpoint และ payload contract ตามรุ่นแอป

  3. ขั้นตอนที่ 3

    ตรวจ Domain/Target URL

    เทียบค่าบน Settings กับ Test endpoint ที่ทีม ERP แจ้ง

  4. ขั้นตอนที่ 4

    กด Manual Test เมื่อได้รับอนุญาต

    ส่ง sample เพียงจำนวนที่ตกลงและจดเวลาทดสอบ

  5. ขั้นตอนที่ 5

    ให้ ERP ตรวจ Server log

    ใช้เวลา Target URL และ payload identifier เพื่อค้นหา request ฝั่งปลายทาง

  6. ขั้นตอนที่ 6

    ส่งต่อหลักฐาน

    หากล้มเหลวให้ส่ง HTTP status, response, screenshot และ network context โดยไม่เปิดเผย secret

3. Technical context สำหรับทีมพัฒนาเท่านั้น

ส่วนใน sourceมีอยู่สถานะที่คู่มือผู้ใช้ต้องถือ
REST webhook senderรองรับ HTTP POSTใช้ผ่าน Manual Test ที่เปิดอยู่เท่านั้น
SAP OData typeอยู่ใน sender/modelไม่มี UI production workflow ที่เปิดให้ตั้งค่า
Idempotency headersX-Idempotency-Key และ metadata headersเป็นรายละเอียด contract ไม่ใช่หลักฐานว่า record ถูก enqueue
Integration workerมี retry/status logicAutomatic record delivery ยังไม่ verified
Queue/Logs composableมี implementationHidden และไม่ใช่ Operator workflow

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 — อ่านอะไรต่อ

เลือกบทถัดไปตามงานที่คุณกำลังตั้งค่า เพื่อเรียนต่อได้โดยไม่ข้ามขั้นสำคัญ