Open-API Reference
ยินดีต้อนรับสู่ SendDee Open-API Reference เอกสารมาตรฐานการเชื่อมต่อระบบขนส่งและโลจิสติกส์แบบครบวงจร ออกแบบมาสำหรับนักพัฒนาซอฟต์แวร์ ผู้พัฒนาระบบ ERP, WMS, POS, แพลตฟอร์มอีคอมเมิร์ซ และระบบจัดการร้านค้าออนไลน์ เพื่อให้สามารถเชื่อมต่อบริการขนส่งชั้นนำทั่วประเทศได้อย่างรวดเร็ว แม่นยำ และปลอดภัยสูงสุด
- Rate Inquiry: ตรวจสอบและเปรียบเทียบค่าจัดส่งแบบ Real-time ตามน้ำหนักและขนาดพัสดุ
- Shipment Creation: สร้างออร์เดอร์พัสดุ ตัดยอดเงินจากกระเป๋าเงิน และออกเลข Tracking Number ทันที
- Thermal Shipping Labels: สร้างไฟล์ใบปะหน้าพัสดุมาตรฐาน (PDF / ZPL) รองรับเครื่องพิมพ์ความร้อนทุกรุ่น
- Courier Pickup: ส่งคำขอนัดหมายเรียกรถขนส่งเข้ารับพัสดุถึงหน้าบ้านหรือคลังสินค้า
- Real-time Tracking & Webhooks: ติดตามสถานะพัสดุและรับแจ้งเตือนสถานะการจัดส่งอัตโนมัติผ่าน Webhook
https://api.senddee.com/api/v1curl -I https://api.senddee.com/api/v1API Reference
ระบบ SendDee API ทำงานบนมาตรฐาน RESTful สื่อสารผ่านโปรโตคอล HTTPS ข้อมูลคำขอและคำตอบอยู่ในรูปแบบ JSON
API Environment
| Environment | Base URL | คำอธิบาย |
|---|---|---|
| Production | https://api.senddee.com/api/v1 |
สภาพแวดล้อมใช้งานจริง รองรับการสร้างพัสดุจริงและตัดยอดเงินในกระเป๋าจริง |
| Sandbox (Staging) | https://sandbox-api.senddee.com/api/v1 |
สภาพแวดล้อมทดสอบ พัสดุจำลอง ไม่มีการตัดเงินจริง |
The Basic Standard
| มาตรฐาน | ข้อกำหนด | รายละเอียด |
|---|---|---|
| Protocol | HTTPS | คำขอทั้งหมดต้องส่งผ่าน TLS 1.2 หรือ TLS 1.3 ขึ้นไป |
| Data Format | JSON | ระบุ Header Content-Type: application/json; charset=utf-8 |
| Timestamp | Unix Time | เวลาปัจจุบันหน่วยวินาที (10 หลัก UTC+7) เช่น 1731931500 |
| Money | Satang / Baht | คำนวณแบบสตางค์เพื่อความแม่นยำสูง ป้องกัน Floating-point error |
Response Data Format
คำตอบทุกรายการจาก SendDee API ถูกห่อหุ้มด้วยโครงสร้างมาตรฐานเดียวกัน (Unified JSON Envelope):
| Field | Type | Description |
|---|---|---|
code | integer | รหัสสถานะการทำงาน (200 = สำเร็จ, 400+ = ผิดพลาด) |
status | string | สถานะผลลัพธ์: "success" หรือ "error" |
message | string | ข้อความอธิบายผลลัพธ์หรือสาเหตุของข้อผิดพลาด |
data | object / null | ข้อมูลผลลัพธ์ของ API (กรณี Error ฟิลด์นี้จะมีค่าเป็น null) |
Notices
• Idempotency: สำหรับ Endpoint สร้างพัสดุ แนะนำให้ส่งฟิลด์
merchantOrderId เพื่อป้องกันการสร้างพัสดุซ้ำกรณี Network Timeout
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json; charset=utf-8
Accept: application/json{
"code": 200,
"status": "success",
"message": "Operation completed successfully",
"data": {
"balanceSatang": 5009846,
"balanceBaht": 50098.46
}
}{
"code": 400,
"status": "error",
"message": "Invalid recipient phone number: 081234",
"data": null
}The Security Reference
ระบบ SendDee Open API ถูกพัฒนาขึ้นด้วยสถาปัตยกรรมความปลอดภัยและการเข้ารหัสขั้นสูงระดับ Enterprise (Enterprise-Grade Cryptographic Security Architecture)
เทียบเท่าระบบธุรกรรมการเงินระดับสากล โดยใช้กลไกลายเซ็นดิจิทัลเข้ารหัส (Cryptographic Request Signature / SHA-256) ร่วมกับ
mchId (Merchant ID), nonceStr (Cryptographic Nonce) และ timestamp
เพื่อรับประกันความถูกต้องสมบูรณ์ของข้อมูล ป้องกันการปลอมแปลงแก้ไขคำขอ (Anti-Tampering) และป้องกันการยิงซ้ำ (Anti-Replay Attack)
SD10088 (ส่งผ่าน Header: x-senddee-mchid ได้)x-senddee-noncestr ได้)Signature Algorithm
ขั้นตอนการคำนวณลายเซ็นดิจิทัล (Signature Pipeline) ประกอบด้วย 4 ขั้นตอนสำคัญอย่างเคร่งครัด:
นำพารามิเตอร์ทั้งหมดในคำขอมารวมกัน หากฟิลด์ใดมีค่าเป็นสตริงว่าง ("") หรือ null จะต้องตัดฟิลด์นั้นออก และห้ามนำฟิลด์ sign มาร่วมคำนวณ
นำชื่อฟิลด์ (Parameter Keys) มาเรียงลำดับจากน้อยไปมากตามรหัส ASCII (A-Z ตามด้วย a-z) จากนั้นเชื่อมต่อกันด้วยเครื่องหมาย & ในรูปแบบ key1=value1&key2=value2... ได้เป็น stringA
นำ stringA มาต่อท้ายด้วย &key= ตามด้วย appSecret ของร้านค้า ได้ผลลัพธ์เป็น stringSignTemp
นำ stringSignTemp ไปเข้ารหัสด้วยฟังก์ชันแฮช SHA-256 จากนั้นแปลงผลลัพธ์ให้เป็นตัวพิมพ์ใหญ่ทั้งหมด (UPPERCASE 64 ตัวอักษร) จะได้ค่า sign
Random nonce string algorithm
พารามิเตอร์ nonceStr คือสตริงสุ่มตัวอักษรและตัวเลขความยาว 16-32 ตัวอักษร เพื่อป้องกันการโจมตีแบบ Replay Attack โดยเซิร์ฟเวอร์จะจดจำค่า Nonce ในช่วงเวลา 300 วินาที
Security notice
appSecret ต้องถูกเก็บรักษาบนเซิร์ฟเวอร์หลังบ้านของคุณเท่านั้น ห้ามใส่ใน Mobile App หรือ Frontend เด็ดขาด• Timestamp Freshness Window (300 วินาที): ค่า
timestamp ต้องไม่ห่างจากเวลาปัจจุบันเกิน 5 นาที มิฉะนั้นจะถูกปฏิเสธด้วยรหัส 1002 Timestamp Expired
{
"mchId": "SD10088",
"nonceStr": "yyv6YJP436wCkdpNdghC",
"timestamp": 1731931500,
"carrier": "FLASH",
"merchantOrderId": "ORD-202611-0091",
"remark": ""
}stringA="carrier=FLASH&mchId=SD10088&merchantOrderId=ORD-202611-0091&nonceStr=yyv6YJP436wCkdpNdghC×tamp=1731931500"stringSignTemp = stringA + "&key=" + appSecret
// ผลลัพธ์:
"carrier=FLASH&mchId=SD10088&merchantOrderId=ORD-202611-0091&nonceStr=yyv6YJP436wCkdpNdghC×tamp=1731931500&key=dd807a8e18b40153888e5a9864e70080"const crypto = require('crypto');
function generateSignature(params, appSecret) {
const sortedKeys = Object.keys(params)
.filter(k => k !== 'sign' && params[k] !== '' && params[k] != null)
.sort();
const stringA = sortedKeys
.map(k => `${k}=${typeof params[k] === 'object' ? JSON.stringify(params[k]) : params[k]}`)
.join('&');
const stringSignTemp = `${stringA}&key=${appSecret}`;
return crypto.createHash('sha256').update(stringSignTemp, 'utf8').digest('hex').toUpperCase();
}
const sign = generateSignature(payload, 'dd807a8e18b40153888e5a9864e70080');{
"mchId": "SD10088",
"nonceStr": "yyv6YJP436wCkdpNdghC",
"timestamp": 1731931500,
"carrier": "FLASH",
"merchantOrderId": "ORD-202611-0091",
"sign": "BF46380E893F6B8F5486D2EDFE265BB8942C6A9BD5C897E34373734CE08B4B67"
}Wallet API
ระบบตรวจสอบยอดเงินคงเหลือและสถานะกระเป๋าเงิน SendDee Wallet สำหรับตัดชำระค่าขนส่งอัตโนมัติ
GET Wallet Balance /wallet/balance
เรียกดูยอดเงินคงเหลือและวงเงินเครดิตของร้านค้า
Bearer YOUR_API_KEYapplication/json5009846 = 50,098.46 บาท) สำหรับคำนวณแบบแม่นยำสูง50098.46)"active" (ปกติ) หรือ "frozen"curl -X GET "https://api.senddee.com/api/v1/wallet/balance" -H "Authorization: Bearer YOUR_API_KEY"{
"code": 200,
"status": "success",
"data": {
"balanceSatang": 5009846,
"balanceBaht": 50098.46,
"creditLimitSatang": 0,
"currency": "THB",
"accountStatus": "active"
}
}Order API
ระบบบริหารจัดการคำสั่งซื้อพัสดุ เช็คเรทราคา เปรียบเทียบค่าส่ง ออกใบปะหน้า และติดตามสถานะ
POST Freight Inquiry /rates/quote
ตรวจสอบและเปรียบเทียบค่าจัดส่งแบบ Real-time ทุกขนส่งที่เชื่อมต่อในระบบ SendDee
"10110""50000"500 = 0.5 กก.)POST Create order /shipments
สร้างออร์เดอร์พัสดุ ตัดเงินจากกระเป๋าเงินทันที และรับเลขพัสดุ (Tracking Number) พร้อมลิงก์ใบปะหน้า
"FLASH", "SPX", "EMS", "JNT"name, phone, address, postalCodename, phone, address, postalCodeweightGrams, widthCm, lengthCm, heightCm, itemNameGET List orders /shipments
ค้นหาและดึงรายการประวัติคำสั่งซื้อพัสดุในระบบ กรองตามสถานะ ขนส่ง ช่วงวันที่ หรือเลขออร์เดอร์
GET Tracking order /shipments/:id
ติดตามสถานะและไทม์ไลน์การเดินทางของพัสดุแบบ Real-time
GET Print label /shipments/:id/universal-label
สร้างและดาวน์โหลดไฟล์ใบปะหน้าพัสดุมาตรฐาน รองรับขนาดสติกเกอร์สำหรับเครื่องพิมพ์ความร้อน
POST Cancel order /shipments/:id/cancel
ยกเลิกคำสั่งซื้อพัสดุก่อนที่ขนส่งจะสแกนเข้ารับ พร้อมคืนยอดเงินเข้ากระเป๋าเงินทันที
{
"carrier": "FLASH",
"sender": {
"name": "บริษัท แสนดี สโตร์ จำกัด",
"phone": "0812345678",
"address": "123/45 ถนนสุขุมวิท คลองเตย กทม.",
"postalCode": "10110"
},
"recipient": {
"name": "สมชาย ใจดี",
"phone": "0898765432",
"address": "99 หมู่ 2 ตำบลสุเทพ เชียงใหม่",
"postalCode": "50000"
},
"parcel": {
"weightGrams": 500,
"widthCm": 15,
"lengthCm": 20,
"heightCm": 10,
"itemName": "เสื้อยืดคอกลม"
},
"cod": { "isCod": true, "amount": 350.00 },
"merchantOrderId": "ORD-202611-0091"
}{
"code": 200,
"status": "success",
"data": {
"id": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"status": "created",
"merchantOrderId": "ORD-202611-0091",
"chargedAmountBaht": 23.54,
"walletBalanceRemaining": 50098.46,
"labelUrl": "https://api.senddee.com/labels/shp_98f12a3b7c4d.pdf",
"createdAt": "2026-11-18T10:15:30Z"
}
}Notify API
ระบบเรียกรถเข้ารับพัสดุ (Courier Pickup Dispatch API) สำหรับนัดหมายให้พนักงานขนส่งเข้ารับพัสดุ ณ คลังสินค้าหรือหน้าร้าน
POST Notify courier /pickups
ส่งคำขอนัดหมายเรียกรถขนส่งเข้ารับพัสดุ ณ ที่อยู่ต้นทาง
"FLASH", "SPX", "EMS", "JNT""2026-11-19""09:00-12:00" หรือ "13:00-17:00""10110"GET List pickups /pickups
ตรวจสอบรายการและประวัติการเรียกรถขนส่งเข้ารับ พร้อมสถานะพนักงานขับรถและจำนวนพัสดุที่เข้ารับจริง
FLASH, SPX, EMS, JNTscheduled, assigned, in_progress, completed, cancelled"PK-20261119-0042")"13:00-17:00")| Status | ชื่อสถานะ | คำอธิบายและการดำเนินการ |
|---|---|---|
scheduled | นัดหมายสำเร็จ | คำขอส่งไปยังขนส่งแล้ว รอจัดสรรคนขับ |
assigned | จัดสรรคนขับแล้ว | ขนส่งกำหนดคนขับรถแล้ว พร้อมเบอร์โทรคนขับ |
in_progress | กำลังเดินทาง | พนักงานขับรถกำลังเดินทางมายังจุดรับพัสดุ |
completed | เข้ารับสำเร็จ | พนักงานสแกนพัสดุขึ้นรถเรียบร้อย พร้อมบันทึกจำนวนจริง |
cancelled | ยกเลิก | ใบงานถูกยกเลิก |
{
"carrier": "FLASH",
"pickupDate": "2026-11-19",
"pickupTimeSlot": "13:00-17:00",
"senderName": "บริษัท แสนดี สโตร์ จำกัด",
"senderPhone": "0812345678",
"pickupAddress": "123/45 ถนนสุขุมวิท แขวงคลองเตย เขตคลองเตย กทม.",
"postalCode": "10110",
"estimatedParcels": 25,
"remark": "อยู่หน้าโกดัง A3 ประตูกระจก"
}{
"code": 200,
"status": "success",
"data": {
"page": 1,
"pageSize": 10,
"total": 2,
"items": [
{
"pickupTicketId": "PK-20261119-0042",
"carrier": "FLASH",
"status": "assigned",
"pickupDate": "2026-11-19",
"pickupTimeSlot": "13:00-17:00",
"estimatedParcels": 25,
"actualParcels": null,
"driverName": "สมศักดิ์ สายตรวจ",
"driverPhone": "0891112233",
"createdAt": "2026-11-18T10:45:00Z"
},
{
"pickupTicketId": "PK-20261118-0019",
"carrier": "FLASH",
"status": "completed",
"pickupDate": "2026-11-18",
"pickupTimeSlot": "09:00-12:00",
"estimatedParcels": 40,
"actualParcels": 38,
"driverName": "สมศักดิ์ สายตรวจ",
"driverPhone": "0891112233",
"createdAt": "2026-11-17T16:20:00Z"
}
]
}
}web hook API
ระบบแจ้งเตือนแบบเรียลไทม์ผ่าน HTTP Callback (Webhooks) ไปยังเซิร์ฟเวอร์ของคุณโดยตรงเมื่อสถานะพัสดุเปลี่ยนแปลง
Web hook service
| Header | คำอธิบาย | ตัวอย่าง |
|---|---|---|
Content-Type | ชนิดข้อมูล | application/json; charset=utf-8 |
x-senddee-event | ชื่อเหตุการณ์ | order.delivered |
x-senddee-signature | ลายเซ็นดิจิทัล SHA-256 | 9A4B8C... |
Web hook events
| Event Name | หมวดหมู่ | คำอธิบายเหตุการณ์ |
|---|---|---|
order.created | Shipment | สร้างออร์เดอร์สำเร็จและออกเลขพัสดุเรียบร้อย |
order.picked_up | Shipment | พนักงานขนส่งสแกนรับพัสดุเข้าสาขาต้นทางแล้ว |
order.in_transit | Shipment | พัสดุอยู่ระหว่างการขนส่งระหว่างศูนย์คัดแยก |
order.out_for_delivery | Shipment | พนักงานนำจ่ายกำลังนำพัสดุออกไปส่งให้ผู้รับ |
order.delivered | Shipment | พัสดุจัดส่งสำเร็จ ผู้รับเซ็นรับเรียบร้อยแล้ว |
order.problem | Shipment | พัสดุเกิดปัญหาการจัดส่ง (เช่น ติดต่อผู้รับไม่ได้) |
order.returned | Shipment | พัสดุตีกลับถึงผู้ส่งต้นทางเรียบร้อยแล้ว |
{
"event": "order.delivered",
"timestamp": 1731931500,
"data": {
"id": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"status": "delivered",
"recipientName": "สมชาย ใจดี",
"signedAt": "2026-11-18T14:35:20Z",
"cod": { "isCod": true, "amount": 350.00 }
}
}Status Flow
| ลำดับ | Status | สถานะภาษาไทย | เงื่อนไขและจุดเปลี่ยนสถานะ |
|---|---|---|---|
| 1 | created | สร้างออร์เดอร์แล้ว | ตัดเงินสำเร็จ ออกเลข Tracking Number และใบปะหน้า |
| 2 | picked_up | เข้ารับพัสดุแล้ว | พนักงานสแกนรับพัสดุเข้าสาขาต้นทาง |
| 3 | in_transit | อยู่ระหว่างขนส่ง | พัสดุอยู่ระหว่างการเคลื่อนย้ายผ่านศูนย์คัดแยกหลัก |
| 4 | out_for_delivery | กำลังนำจ่าย | พัสดุถึงสาขาปลายทาง และพนักงานนำจ่ายนำพัสดุออกไปส่ง |
| 5A | delivered | จัดส่งสำเร็จ | ผู้รับเซ็นรับพัสดุเรียบร้อย |
| 5B | problem | พัสดุติดปัญหา | ติดต่อผู้รับไม่ได้ หรือขอเลื่อนนัดส่ง (ขนส่งพยายามส่งซ้ำ 3 ครั้ง) |
| 6 | returned | ตีกลับต้นทาง | พัสดุส่งไม่สำเร็จเกิน 3 ครั้ง และถูกตีกลับถึงผู้ส่ง |
Constants
Response Code
| Code | HTTP | Message | คำอธิบาย |
|---|---|---|---|
200 | 200 | Success | คำขอทำงานสำเร็จสมบูรณ์ |
400 | 400 | Bad Request | ข้อมูลคำขอไม่ถูกต้องหรือพารามิเตอร์ไม่ครบถ้วน |
401 | 401 | Unauthorized | API Key หรือลายเซ็นไม่ถูกต้อง หรือเวลาหมดอายุ |
422 | 422 | Unprocessable | ยอดเงินในกระเป๋าไม่พอ หรือข้อมูลไม่สามารถประมวลผลได้ |
1001 | 401 | Invalid Signature | การคำนวณลายเซ็นดิจิทัล SHA-256 ไม่ถูกต้อง |
1002 | 401 | Timestamp Expired | เวลาในคำขอห่างจากเซิร์ฟเวอร์เกิน 300 วินาที |
2001 | 422 | Insufficient Balance | ยอดเงินในกระเป๋าไม่พอสำหรับการตัดค่าส่ง |
Carrier List
| Carrier Code | ชื่อบริษัทขนส่ง | บริการที่รองรับ | การเรียกรถเข้ารับ (Pickup) |
|---|---|---|---|
FLASH | Flash Express | Standard, COD, Speed, Bulky | รองรับเรียกรถเข้ารับฟรีถึงหน้าบ้าน/คลังสินค้า |
SPX | Shopee Express (SPX) | Standard, COD | รองรับทั้ง Drop-off สาขา และเรียกรถเข้ารับ |
EMS | ไปรษณีย์ไทย EMS | Standard, COD, ทั่วไทย 100% | รองรับ Drop-off ทุกที่ทำการไปรษณีย์ |
JNT | J&T Express | Standard, COD | เปิดบริการ 365 วันไม่มีวันหยุด |
{
"code": 2001,
"status": "error",
"message": "Insufficient Wallet Balance: Required 35.50 THB, Available 12.00 THB.",
"data": {
"requiredAmountBaht": 35.50,
"availableBalanceBaht": 12.00,
"topupUrl": "https://senddee.com/wallet/topup"
}
}{
"supportedCarriers": [
{ "code": "FLASH", "name": "Flash Express", "pickupSupported": true },
{ "code": "SPX", "name": "Shopee Express", "pickupSupported": true },
{ "code": "EMS", "name": "Thailand Post EMS", "pickupSupported": false },
{ "code": "JNT", "name": "J&T Express", "pickupSupported": true }
]
}