Finstrata Liner

คู่มือ REST API

ส่ง API Key ใน header X-API-Key (ดู/สร้างใหม่ได้ที่ ตั้งค่า > ตั้งค่าระบบ / API / Webhook) · ทุก response มี header X-App-Version

ตรวจการเชื่อมต่อ

GET /api/v1/ping

ตารางเรือ

GET /api/v1/schedules?direction=OB&principal=<id>

Booking / B/L

GET /api/v1/bookings/BK2611-0001
GET /api/v1/bls/LCHJEA2600001

ตู้และประวัติ Movement

GET /api/v1/containers/SLXU0070016

ส่ง Movement จาก Depot / Terminal

POST /api/v1/movements
Content-Type: application/json

[{ "container_no": "SLXU0070016", "move": "MA", "move_date": "2026-11-19", "move_time": "10:30",
   "status": "AV", "from": "CONSIGNEE", "to": "EDP", "bl_no": "SINLCH2600001" }]

รหัส Movement: MS ปล่อยตู้เปล่า · FL ตู้หนักเข้าท่า · LD ขึ้นเรือ · DS ขนลงจากเรือ · FC ตู้หนักออกให้ผู้นำเข้า · MA คืนตู้เปล่า · TS Transshipment · MT ย้ายตู้เปล่า · ON/OF On/Off-hire · รายการที่ส่งผ่าน API จะรอ Acknowledge ในระบบ

ส่งไฟล์ EDI CODECO

POST /api/v1/edi/codeco
Content-Type: text/plain

UNB+UNOA:2+DEPOT+LINE+...' UNH+1+CODECO:D:95B:UN' BGM+36+...' EQD+CN+SLXU0070016+22G1:102:5++2+4' DTM+7:202611191030:203' LOC+165+EDP' ...

Webhook

ตั้ง URL ที่ ตั้งค่า > Webhook ระบบส่ง POST JSON {"event","at","data"} พร้อม header x-finstrata-event และ x-finstrata-signature: sha256=<HMAC ของ body ด้วย secret>

Event: booking.confirmed bl.issued bl.released do.issued movement.created invoice.issued receipt.created

ตรวจสอบ D/O (สาธารณะ)

QR บน D/O ชี้ไปที่ /verify/<D/O No.>?t=..&k=.. แสดงว่า D/O ถูกต้อง ยกเลิก หรือหมดอายุ