AndroidWeb

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

ตั้งค่า Customer Domain — ตรวจ Target URL และ Test API ทีละขั้น

กรอก Base URL ที่ถูกต้อง รวมกับ Endpoint /weighing/records ทดสอบ sample payload จริง และอ่านผล HTTP โดยไม่สรุปเกินกว่าสิ่งที่การทดสอบพิสูจน์

IT / ERP Integratorอ่านประมาณ 11 นาทีอัปเดต 17 กรกฎาคม 2026

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

  • ประกอบ Target URL ได้ถูกต้อง
  • กด Test API โดยเข้าใจว่าจะมี request จริง
  • แยกปัญหา URL, Auth, Permission, Payload และ Server ได้

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

  • ทีม ERP ให้ Base URL และยืนยันว่า POST /weighing/records เปิดรับ Test data
  • Tablet เชื่อม Internet/VPN ที่เข้าถึงปลายทางได้
  • Subscription มี erp_integration
คู่มือที่เกี่ยวข้องอ่าน Integration Docsขอบเขต Operations
สารบัญในหน้านี้

1. กติกาของ URL ในรุ่นปัจจุบัน

Settings รับ Customer Domain หรือ Base URL และแอปต่อ path /weighing/records ให้อัตโนมัติ ต้องกรอก scheme เต็ม เช่น https://erp-test.example.com ไม่ควรใส่ path เดิมซ้ำท้าย Domain

รายการตัวอย่าง
Domainhttps://erp-test.example.com
Endpoint คงที่/weighing/records
Target URLhttps://erp-test.example.com/weighing/records
ค่าที่ไม่ผ่านerp-test.example.com เพราะไม่มี http:// หรือ https://

2. ตั้งค่าและทดสอบทีละขั้น

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

    เปิด Settings

    ใน Integration Center เลือก Tab Settings แล้วหา Card Customer Domain

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

    กรอก Base URL

    ใช้ Domain ของ Test environment พร้อม https:// และไม่ใส่ /weighing/records ซ้ำ

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

    ตรวจ Target URL

    อ่าน URL เต็มที่แอปแสดงและส่งให้ทีม ERP เทียบกับ Route ที่เปิดจริง

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

    ยืนยันว่าปลายทางรับ Sample

    ก่อนกดปุ่ม ให้เจ้าของ ERP ยืนยันว่าการทดสอบจะไม่สร้าง Stock/Invoice/Production transaction จริง

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

    กด Test API

    แอปบังคับ connector เป็น REST webhook และ LIVE mode สำหรับการทดสอบนี้ แล้ว POST sample weighing record จริง

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

    บันทึกผล

    เก็บ Passed/Failed, Last test, Tested at, HTTP status และ response ที่ทีม ERP ตรวจได้

3. แปลผล Passed และ Failed

ผล/สถานะความหมายที่เป็นไปได้ตรวจต่อ
Passed / 2xxปลายทางตอบสำเร็จต่อ sample requestตรวจข้อมูลที่ ERP รับและยืนยันว่าไม่สร้างรายการซ้ำ
401Authentication ไม่ผ่านCredential/API gateway ของ ERP
403ไม่มี Permissionสิทธิ์ endpoint หรือ allowlist
408/504TimeoutVPN, Firewall, Server load และ timeout policy
409Duplicate ticket/idempotency conflictตรวจ key และข้อมูลทดสอบเดิม
4xx อื่นPayload หรือ request ไม่ตรง contractเทียบ Swagger และ response body
5xxERP/Server unavailableตรวจ log ฝั่งปลายทางและลองเมื่อระบบพร้อม
ไม่มี http schemeDomain ไม่ถูกต้องเติม https:// หรือ http:// ตาม environment

4. ข้อจำกัดของ Settings ปัจจุบัน

  • Endpoint ใน UI ถูกกำหนดเป็น /weighing/records
  • การพิมพ์ Domain จะบันทึกค่าตามการเปลี่ยนแปลง จึงควรกรอกอย่างระมัดระวัง
  • ViewModel ปัจจุบันใช้ local/default scope ภายใน ไม่ควรถือว่าการตั้งค่าได้รับการยืนยันแบบแยก Company/Branch สำหรับ Production
  • ผล Test ถูกเก็บใน local integration repository ของแอป
  • Passed ไม่ได้พิสูจน์ automatic delivery ของ record จริง

5. ข้อมูลที่ต้องส่งต่อทีมพัฒนา/ERP

  • Company, Branch, รุ่นแอป และเวลาทดสอบ
  • Domain, Endpoint และ Target URL เต็ม
  • HTTP status และ response body โดยปิดข้อมูลลับก่อนส่ง
  • ตัวอย่าง payload/schema จาก Docs
  • ระบุชัดว่าเป็น Manual Test ไม่ใช่หลักฐานของ Automatic delivery

Continue learning

Next Steps — อ่านอะไรต่อ

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

ขอบเขตการใช้งาน ERP

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

อ่านสถานะ Subscription

ตรวจ Plan, Status, Days remaining, Period end และ Renewal source พร้อม Refresh/Switch scope และเข้าใจเหตุผลที่ Business Module ถูกบล็อกแม้เคยใช้งานได้ออฟไลน์