Quick start

สิ่งที่ต้องได้รับจาก CFO

1. client_id และ client_secret ส่งผ่านช่องทางส่วนตัว
2. grant manifest ที่ระบุ zone, องค์กร, ปลายทาง และ capability
3. วันเริ่ม–หมดอายุของ credential และผู้ติดต่อเมื่อ discovery ไม่ตรง manifest

ตั้งค่า secret ใน secret store ของ ERP ห้ามใส่ใน source code, ticket, chat, ภาพหน้าจอ หรือ URL

ลำดับห้านาทีแรก

ERP runtime
  -> POST /integrations/oauth/token
  -> GET  /integrations/me
  -> GET  /integrations/destinations
  -> GET  /integrations/catalog/activity-codes

หลังขอ token ให้ตรวจ /integrations/me ว่าองค์กรและ zone ตรง manifest จากนั้นใช้เฉพาะ facility/retention pair ที่ /integrations/destinations คืนมา ห้ามสร้าง Cartesian product เอง

ก่อนส่งข้อมูล

• บันทึก external_ref, external_batch_id, Idempotency-Key และ canonical payload ลง durable store
• dry-run ทุก granted tuple และรอ job ถึง terminal
• persist เฉพาะเมื่อ dry-run ผ่านและได้รับอนุญาตให้เขียน
• retry ด้วย identity และ payload เดิมเมื่อผลลัพธ์ไม่แน่ชัด

ห้ามเริ่มด้วย persist

HTTP 202 Accepted หมายถึงรับเข้าคิว ไม่ได้หมายความว่าแถวสำเร็จ ต้อง poll job และอ่าน item ทุกหน้าเสมอ

ขั้นต่อไป: เลือก environment และ discover สิทธิ์จริง