Finstrata Depot API v1
เชื่อมต่อระบบของสายเรือ/เจ้าของตู้กับลานที่ใช้ Finstrata Depot มีให้เลือก 4 ช่องทาง ใช้คู่กันได้
| ช่องทาง | เหมาะกับ |
|---|---|
พอร์ทัลลูกค้า /portal/ | ทีม Equipment Control ดูสต๊อก EIR พร้อมรูป อนุมัติซ่อม สร้างใบสั่งปล่อย โดยไม่ต้องพัฒนาระบบ |
REST API /api/v1 | ระบบ EMS/ERP ของลูกค้าดึงข้อมูลตามรอบ หรือสร้าง Release และอนุมัติซ่อมแบบอัตโนมัติ |
| Webhook | รับเหตุการณ์ทันทีที่เกิด (Gate In/Out, ใบประเมิน, ซ่อมเสร็จ, ใบแจ้งหนี้) เป็น JSON หรือ EDIFACT |
| EDI UN/EDIFACT D95B | CODECO และ DESTIM สำหรับระบบ EDI เดิมของสายเรือ |
การยืนยันตัวตน
ขอ API key จากลาน (หรือสร้างเองในพอร์ทัล เมนู เชื่อมต่อ API / EDI) แล้วส่งใน header ทุกคำขอ API key แต่ละชุดเห็นเฉพาะข้อมูลตู้ของลูกค้ารายนั้นในลานนั้นเท่านั้น
curl https://depot.finstrata.io/api/v1/ping \
-H "X-API-Key: fd_ln_xxxxxxxxxxxxxxxxxxxxxxxx"
รูปแบบ error
HTTP 4xx/5xx
{ "error": "ข้อความอธิบาย" }
401 = key ไม่ถูกต้อง · 403 = ไม่มีสิทธิ์ · 404 = ไม่พบ · 409 = สถานะไม่อนุญาต · 402 = ลานอยู่ในโหมดดูอย่างเดียว
ตู้คอนเทนเนอร์
รายการตู้ของลูกค้า (ค่าเริ่มต้น = อยู่ในลาน)
{ "count": 1, "data": [{
"container_no": "OSLU2301646", "iso_type": "22G1", "size": "20", "type": "GP",
"status": "IN_YARD", "condition": "AVAILABLE", "grade": "A", "on_hold": false,
"gate_in_at": "2026-11-16T08:21:00.000Z", "gate_out_at": null, "dwell_days": 3,
"washed": false, "pti_date": null }] }
สถานะปัจจุบันและประวัติการเข้าลาน 10 ครั้งล่าสุด
Gate moves / EIR
{
"eir_no": "EI6911-00064", "move": "GATE_IN", "container_no": "OSLU2301646", "iso_type": "22G1",
"condition": "DAMAGED", "grade": "B",
"damages": [{ "side": "ผนังซ้าย", "location": "LX", "damage": "DT", "note": "บุบ 30x20 ซม." }],
"truck_plate": "70-1234 ชบ", "trucker": "หจก. ชลบุรีขนส่ง", "seal_no": null,
"booking_no": null, "release_no": null, "location": "M-01-2-1",
"occurred_at": "2026-11-18T02:21:00.000Z",
"eir_url": "https://depot.finstrata.io/portal/#eir/…",
"photos": ["https://depot.finstrata.io/files/…jpg"]
}
ใบสั่งปล่อยตู้ (Release / Booking)
{ "booking_no": "OSLBKK2611002", "qty": 5, "size": "40", "type": "HC", "grade_min": "B",
"valid_until": "2026-12-05", "shipper": "Thai Rubber Export", "vessel": "OCEANIC PEARL 113E", "pod": "CNSHA" }
grade_min: A = Food grade, B = ใช้งานทั่วไป, C = ใช้ได้ · ลานจะปล่อยเฉพาะตู้ที่พร้อมใช้และเกรดไม่ต่ำกว่าที่ระบุ
งานซ่อม (M&R)
// reject ต้องมี note
{ "note": "ขอให้ใช้วิธีดัดแทนการปะ", "by": "EQC-Somchai" }
สถานะ: SUBMITTED → APPROVED / REJECTED → (ลานส่งใหม่เป็น revision) → IN_REPAIR → DONE · ตั้งวงเงินอนุมัติอัตโนมัติได้ที่ลาน
ใบแจ้งหนี้
EDI ผ่าน API
คืนไฟล์ EDIFACT (Content-Type: application/edifact)
Webhook — เหตุการณ์
ตั้ง URL ในพอร์ทัลหรือให้ลานตั้งให้ ระบบส่ง POST พร้อม header
Content-Type: application/json (หรือ application/edifact เมื่อเลือกรูปแบบ EDIFACT)
X-Finstrata-Event: gate.in
X-Finstrata-Delivery: 1234
X-Finstrata-Signature: sha256=5d41402abc4b2a76b9719d911017c592…
| Event | เมื่อไร | data |
|---|---|---|
gate.in / gate.out | บันทึก EIR ที่หน้าประตู | เหมือน /eir |
estimate.submitted | ลานส่งใบประเมินซ่อม | ใบประเมิน + รายการ + รูป |
estimate.approved / estimate.rejected | มีการตัดสินใบประเมิน | ใบประเมิน |
repair.completed | ซ่อมเสร็จ ตู้พร้อมใช้ | ใบประเมิน + รูปหลังซ่อม |
release.updated | ปล่อยตู้ตาม Booking / ปิด | qty, qty_out, remaining, status |
container.updated / container.serviced | เปลี่ยนเกรด/HOLD, ล้างตู้, PTI | container_no + ค่าที่เปลี่ยน |
invoice.issued | ออกใบแจ้งหนี้ | ยอด + ลิงก์ใบแจ้งหนี้ |
ping | กดทดสอบ | message |
{
"id": "evt_3f9a…", "event": "gate.out", "created_at": "2026-11-18T03:05:12.000Z",
"depot": { "code": "DEMO", "name": "บริษัท สยามคอนเทนเนอร์ดีโป้ จำกัด" },
"customer": { "code": "OSL" },
"data": { "eir_no": "EO6911-00008", "move": "GATE_OUT", "container_no": "OSLU2301190", … },
"edifact": "UNB+UNOA:2+SCDLCB+OSLBKK+…" // มีเมื่อเลือก JSON + EDIFACT
}
ตรวจลายเซ็น (Node.js)
const crypto = require('crypto');
function verify(rawBody, header, secret) {
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
return crypto.timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}
การส่งซ้ำ
ตอบกลับ HTTP 2xx ภายใน 10 วินาทีถือว่ารับแล้ว ถ้าไม่สำเร็จระบบส่งซ้ำหลัง 1, 5, 30, 120, 360 และ 720 นาที ใช้ id ของเหตุการณ์เพื่อกันข้อมูลซ้ำ
กล้อง OCR หน้าประตู (สำหรับลาน)
ใช้ API key ประเภท อุปกรณ์ลาน (สร้างที่หลังบ้าน > การเชื่อมต่อ) ระบบกล้อง OCR ส่งผลการอ่านเข้ามา แล้วเจ้าหน้าที่ Gate จะเห็นเลขตู้ขึ้นให้กดใช้ทันที ระบบตรวจ check digit ให้ด้วย
{ "lane": "IN-1", "container_no": "OSLU2390047", "truck_plate": "70-4455 ชบ",
"confidence": 0.97, "camera": "OCR-GATE-01", "image": "data:image/jpeg;base64,…" }
EDI — CODECO / DESTIM (UN/EDIFACT D95B)
ตัวอย่าง CODECO Gate In
UNB+UNOA:2+SCDLCB+OSLBKK+261118:0921+123456789'
UNH+1+CODECO:D:95B:UN:ITG14'
BGM+34+123456789IN+9'
DTM+137:202611180921:203'
NAD+MS+SCDLCB:160:ZZZ'
NAD+CF+OSL:160:ZZZ'
EQD+CN+OSLU2301646+22G1:102:5++2+4'
RFF+AAJ:EI6911-00064'
DTM+7:202611180915:203'
LOC+165+THLCH:139:6+SCDLCB:TER:ZZZ'
FTX+AAI+++SOUND GRADE A'
TDT+1++3++++++70-1234 ชบ:146::TRUCK'
CNT+16:1'
UNT+13+1'
UNZ+1+123456789'
หมายเหตุ: สายเรือแต่ละรายมี Message Implementation Guide (MIG) ของตัวเอง ทีม Finstrata ช่วยปรับ segment ให้ตรงกับ MIG ของคุณก่อนเปิดใช้จริง