Open-API Reference
ยินดีต้อนรับสู่ SendDee Open-API Reference เอกสารมาตรฐานการเชื่อมต่อระบบขนส่งและโลจิสติกส์แบบครบวงจร ออกแบบมาสำหรับนักพัฒนาซอฟต์แวร์ ผู้พัฒนาระบบ ERP, WMS, POS, แพลตฟอร์มอีคอมเมิร์ซ และระบบจัดการร้านค้าออนไลน์ เพื่อให้สามารถเชื่อมต่อบริการขนส่งชั้นนำทั่วประเทศได้อย่างรวดเร็ว แม่นยำ และปลอดภัย
บริการหลักที่รองรับผ่าน SendDee Open-API ได้แก่:
- Rate Inquiry: ตรวจสอบและเปรียบเทียบค่าจัดส่งแบบ Real-time ตามน้ำหนักและขนาดพัสดุ
- Shipment Creation: สร้างออร์เดอร์พัสดุ ตัดยอดเงินจากกระเป๋าเงิน และออกเลข Tracking Number ทันที
- Thermal Shipping Labels: สร้างไฟล์ใบปะหน้าพัสดุมาตรฐาน (PDF / ZPL) รองรับเครื่องพิมพ์ความร้อนทุกรุ่น
- Courier Pickup: ส่งคำขอนัดหมายเรียกรถขนส่งเข้ารับพัสดุถึงหน้าบ้านหรือคลังสินค้า
- Real-time Tracking & Webhooks: ติดตามสถานะพัสดุและรับแจ้งเตือนสถานะการจัดส่งอัตโนมัติผ่าน Webhook
Quick Start Gateway Endpoint:
https://api.senddee.com/api/v1
# ตรวจสอบการเชื่อมต่อ API Gateway เบื้องต้น
curl -I https://api.senddee.com/api/v1
API Reference
ระบบ SendDee API ทำงานบนมาตรฐาน RESTful สื่อสารผ่านโปรโตคอล HTTPS ข้อมูลคำขอและคำตอบอยู่ในรูปแบบ JSON และใช้รหัสสถานะ HTTP มาตรฐานในการแจ้งผลการทำงาน
API Environment
SendDee ให้บริการ 2 สภาพแวดล้อมเพื่อความสะดวกและปลอดภัยในการทดสอบระบบ:
| Environment | Base URL | คำอธิบาย |
|---|---|---|
| Production | https://api.senddee.com/api/v1 |
สภาพแวดล้อมใช้งานจริง รองรับการสร้างพัสดุจริงและตัดยอดเงินในกระเป๋าเงินจริง |
| Sandbox (Staging) | https://sandbox-api.senddee.com/api/v1 |
สภาพแวดล้อมสำหรับทดสอบ พัสดุจำลอง ไม่มีการตัดเงินจริงและไม่มีการเรียกรถจริง |
Request Header Base Example:
GET /api/v1/wallet/balance HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json
curl -X GET "https://api.senddee.com/api/v1/wallet/balance" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json"
The Basic Standard
ข้อกำหนดและมาตรฐานพื้นฐานในการสื่อสารกับ SendDee API:
| มาตรฐาน | ข้อกำหนด | รายละเอียด |
|---|---|---|
| Protocol | HTTPS Only | คำขอทั้งหมดต้องส่งผ่าน TLS 1.2 หรือ TLS 1.3 ขึ้นไปเท่านั้น คำขอที่เป็น HTTP ธรรมดาจะถูกปฏิเสธ |
| Data Format | JSON (UTF-8) | คำขอประเภท POST/PUT ต้องระบุ Header Content-Type: application/json; charset=utf-8 |
| Character Encoding | UTF-8 | รองรับภาษาไทย ภาษาอังกฤษ และภาษาจีนอย่างสมบูรณ์แบบ |
| Timestamp | Unix Timestamp (Seconds) | เวลาหน่วยเป็นวินาที 10 หลัก (UTC+7) เช่น 1731931500 |
| Money Precision | Satang / Baht (2 Decimals) | ยอดเงินภายในระบบคำนวณแบบ Satang (จำนวนเต็ม) เพื่อป้องกันข้อผิดพลาด Floating-point |
Standard Response Structure:
{
"code": 200,
"status": "success",
"message": "Operation completed successfully",
"data": { ... }
}
The basic response data format
คำตอบทุกรายการจาก SendDee API ถูกห่อหุ้มด้วยโครงสร้างมาตรฐานเดียวกัน (Unified JSON Envelope):
| Field | Type | Description |
|---|---|---|
code |
integer | รหัสสถานะการทำงานระดับแอปพลิเคชัน (200 = สำเร็จ, 400+ = ข้อผิดพลาด) |
status |
string | สถานะผลลัพธ์: "success" หรือ "error" |
message |
string | ข้อความอธิบายผลลัพธ์หรือสาเหตุของข้อผิดพลาด (ภาษาไทย/อังกฤษ) |
data |
object / array | ข้อมูลผลลัพธ์ของ API แต่ละเส้น กรณีเกิดข้อผิดพลาดฟิลด์นี้จะมีค่าเป็น null |
Example Error Response Envelope:
{
"code": 400,
"status": "error",
"message": "Invalid recipient phone number: 081234",
"data": null
}
Notices
Rate Limit Response Headers:
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1731931560
Retry-After: 60
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-MITM)
และป้องกันการนำคำขอที่สำเร็จแล้วมายิงซ้ำ (Anti-Replay Attack) อย่างสมบูรณ์แบบ
พารามิเตอร์ด้านความปลอดภัยหลัก (Authentication Parameters)
ทุกคำขอที่ส่งไปยัง API Gateway สามารถส่งข้อมูลยืนยันตัวตนได้ทั้งในรูปแบบ HTTP Headers หรือ JSON Body:
| Parameter | Header Equivalent | Type | Required | Description |
|---|---|---|---|---|
mchId |
x-senddee-mchid |
string(32) | true | รหัสร้านค้า (Merchant ID) ที่ได้รับจากระบบ เช่น SD10088 |
nonceStr |
x-senddee-noncestr |
string(32) | true | สตริงสุ่มความยาว 16-32 ตัวอักษร สำหรับป้องกันการยิงคำขอซ้ำ (Replay Attack) |
timestamp |
x-senddee-timestamp |
integer | true | เวลาปัจจุบันของเซิร์ฟเวอร์หน่วยวินาที (Unix Timestamp 10 หลัก UTC+7) |
sign |
x-senddee-sign |
string(64) | true | ลายเซ็นดิจิทัลที่ผ่านการคำนวณด้วยอัลกอริทึม SHA-256 (Uppercase Hex) |
Security Request Envelope Sample:
POST /api/v1/shipments HTTP/1.1
Host: api.senddee.com
x-senddee-mchid: SD10088
x-senddee-noncestr: yyv6YJP436wCkdpNdghC
x-senddee-timestamp: 1731931500
x-senddee-sign: BF46380E893F6B8F5486D2EDFE265BB8942C6A9BD5C897E34373734CE08B4B67
Content-Type: application/json
{
"carrier": "FLASH",
"merchantOrderId": "ORD-202611-0091"
}
curl -X POST "https://api.senddee.com/api/v1/shipments" -H "x-senddee-mchid: SD10088" -H "x-senddee-noncestr: yyv6YJP436wCkdpNdghC" -H "x-senddee-timestamp: 1731931500" -H "x-senddee-sign: BF46380E893F6B8F5486D2EDFE265BB8942C6A9BD5C897E34373734CE08B4B67" -H "Content-Type: application/json" -d '{"carrier":"FLASH","merchantOrderId":"ORD-202611-0091"}'
Signature Algorithm
อัลกอริทึมการคำนวณลายเซ็นดิจิทัล (Signature Generation Pipeline) ประกอบด้วย 4 ขั้นตอนสำคัญอย่างเคร่งครัด เพื่อให้ได้ค่าแฮชที่ตรงกันทั้งฝั่งระบบร้านค้าและฝั่ง SendDee Security Gateway:
ขั้นตอนที่ 1: รวบรวมพารามิเตอร์และกรองฟิลด์ว่างออก (Filter & Collect)
นำพารามิเตอร์ทั้งหมดในคำขอ (ยกเว้นฟิลด์ sign) มารวมกัน หากฟิลด์ใดมีค่าเป็นสตริงว่าง ("")
หรือค่าว่างเปล่า (null, undefined) จะต้องตัดฟิลด์นั้นออกจากการคำนวณทันที
| ประเภทค่า | ตัวอย่าง | การปฏิบัติ |
|---|---|---|
ฟิลด์ sign |
sign: "BF4638..." |
ตัดออกเสมอ (ไม่นำมาร่วมคำนวณลายเซ็นของตัวเอง) |
| สตริงว่าง / Null | remark: "" หรือ remark: null |
ตัดออก ไม่นำมาร่วมคำนวณ |
| ตัวเลขศูนย์ / Boolean เท็จ | amount: 0 หรือ isCod: false |
คงไว้ ถือเป็นข้อมูลที่มีความหมาย |
Step 1: Raw Request Payload Example:
{
"mchId": "SD10088",
"nonceStr": "yyv6YJP436wCkdpNdghC",
"timestamp": 1731931500,
"carrier": "FLASH",
"merchantOrderId": "ORD-202611-0091",
"remark": ""
}
ขั้นตอนที่ 2: เรียงลำดับชื่อฟิลด์ตามรหัส ASCII (Dictionary Order Sorting)
นำชื่อฟิลด์ (Parameter Keys) ที่ผ่านการกรองแล้ว มาเรียงลำดับจากน้อยไปมากตามรหัส ASCII (A-Z ตามด้วย a-z)
จากนั้นนำมาเชื่อมต่อกันด้วยเครื่องหมาย & ในรูปแบบ key1=value1&key2=value2... ได้ผลลัพธ์เป็น stringA
Step 2: Sorted stringA Output:
stringA="carrier=FLASH&mchId=SD10088&merchantOrderId=ORD-202611-0091&nonceStr=yyv6YJP436wCkdpNdghC×tamp=1731931500"
ขั้นตอนที่ 3: ต่อท้ายด้วย App Secret (Salt Secret Key Suffix)
นำ stringA มาต่อท้ายด้วย &key= ตามด้วย appSecret ประจำร้านค้าที่ได้รับจากระบบ SendDee
(ความลับนี้ห้ามเปิดเผยต่อบุคคลภายนอก) ได้ผลลัพธ์เป็น stringSignTemp:
Step 3: stringSignTemp with App Secret:
stringSignTemp = stringA + "&key=" + appSecret
// ตัวอย่าง (appSecret = "dd807a8e18b40153888e5a9864e70080"):
"carrier=FLASH&mchId=SD10088&merchantOrderId=ORD-202611-0091&nonceStr=yyv6YJP436wCkdpNdghC×tamp=1731931500&key=dd807a8e18b40153888e5a9864e70080"
ขั้นตอนที่ 4: คำนวณ SHA-256 และแปลงเป็นตัวพิมพ์ใหญ่ (Uppercase Hash)
นำ stringSignTemp ไปเข้ารหัสด้วยฟังก์ชันแฮช SHA-256 จากนั้นแปลงผลลัพธ์ที่เป็น Hexadecimal String
ให้เป็นตัวพิมพ์ใหญ่ทั้งหมด (UPPERCASE 64 ตัวอักษร) จะได้ค่า sign ที่สมบูรณ์
Step 4: Implementation Code in Multiple Languages:
sign = SHA256(stringSignTemp).toUpperCase()
// ผลลัพธ์: "BF46380E893F6B8F5486D2EDFE265BB8942C6A9BD5C897E34373734CE08B4B67"
# คำนวณใน Bash / CLI:
sign=$(echo -n "${stringSignTemp}" | sha256sum | awk '{print toupper($1)}')
echo "Calculated Signature: ${sign}"
// Node.js Implementation
const crypto = require('crypto');
function generateSignature(params, appSecret) {
// 1. กรองฟิลด์ที่ไม่เอาออก และเรียงลำดับ ASCII
const sortedKeys = Object.keys(params)
.filter(k => k !== 'sign' && params[k] !== '' && params[k] !== null && params[k] !== undefined)
.sort();
// 2. เชื่อมเป็น key=value&
const stringA = sortedKeys
.map(k => `${k}=${typeof params[k] === 'object' ? JSON.stringify(params[k]) : params[k]}`)
.join('&');
// 3. เติม &key=appSecret
const stringSignTemp = `${stringA}&key=${appSecret}`;
// 4. ทำ SHA-256 Uppercase
return crypto.createHash('sha256').update(stringSignTemp, 'utf8').digest('hex').toUpperCase();
}
const sign = generateSignature(requestData, 'dd807a8e18b40153888e5a9864e70080');
# Python Implementation
import hashlib
import json
def generate_signature(params: dict, app_secret: str) -> str:
# 1. กรองฟิลด์ที่ไม่เอาออก
filtered = {
k: (json.dumps(v, separators=(',', ':'), ensure_ascii=False) if isinstance(v, (dict, list)) else str(v))
for k, v in params.items()
if k != 'sign' and v not in ('', None)
}
# 2. เรียงลำดับคีย์ตาม ASCII
string_a = '&'.join(f'{k}={filtered[k]}' for k in sorted(filtered.keys()))
# 3. เติม &key=app_secret
string_sign_temp = f'{string_a}&key={app_secret}'
# 4. ทำ SHA-256 Uppercase
return hashlib.sha256(string_sign_temp.encode('utf-8')).hexdigest().upper()
sign = generate_signature(request_data, 'dd807a8e18b40153888e5a9864e70080')
กฎสำคัญในการคำนวณลายเซ็น (Crucial Cryptographic Rules)
| กฎข้อบังคับ | คำอธิบาย | ตัวอย่าง |
|---|---|---|
| ASCII Sorting | เรียงลำดับชื่อฟิลด์ตามรหัส ASCII จากน้อยไปมากเสมอ | carrier มาก่อน mchId มาก่อน nonceStr |
| Case Sensitive | ชื่อฟิลด์และค่าข้อมูลคำนึงถึงตัวพิมพ์เล็ก-ใหญ่ | mchId ไม่เท่ากับ mchid |
| Exclude Empty Values | ค่าที่เป็น "" หรือ null ห้ามนำมาร่วมคำนวณ |
ตัดทิ้งออกจาก stringA |
| Exclude 'sign' | ฟิลด์ sign จะต้องไม่นำมาร่วมคำนวณลายเซ็น |
ตัดทิ้งก่อนทำขั้นตอนเรียงลำดับ |
| Uppercase Output | สตริงผลลัพธ์ของ Hash SHA-256 ต้องแปลงเป็นตัวพิมพ์ใหญ่ | BF46380E... (ไม่ใช่ตัวพิมพ์เล็ก) |
Complete Signed Request Payload:
{
"mchId": "SD10088",
"nonceStr": "yyv6YJP436wCkdpNdghC",
"timestamp": 1731931500,
"carrier": "FLASH",
"merchantOrderId": "ORD-202611-0091",
"sign": "BF46380E893F6B8F5486D2EDFE265BB8942C6A9BD5C897E34373734CE08B4B67"
}
Random nonce string algorithm
พารามิเตอร์ nonceStr คือสตริงสุ่มตัวอักษรและตัวเลข (Cryptographic Nonce) มีหน้าที่ทำให้ค่าแฮชของคำขอไม่สามารถคาดเดาได้
และป้องกันการโจมตีแบบ Replay Attack โดยเซิร์ฟเวอร์จะจดจำค่า Nonce ในช่วงเวลา 300 วินาที หากพบค่านำซ้ำจะปฏิเสธคำขอทันที
| คุณสมบัติ | ข้อกำหนด | คำแนะนำ |
|---|---|---|
| ความยาว | 16 ถึง 32 ตัวอักษร | แนะนำ 20 หรือ 32 ตัวอักษร |
| ชุดตัวอักษร | [0-9a-zA-Z] |
ตัวเลข อักษรภาษาอังกฤษพิมพ์เล็กและพิมพ์ใหญ่ |
| ความไม่ซ้ำ | Unique per request | สร้างใหม่ทุกครั้งที่ยิงคำขอ API |
Nonce Generation Helper Example:
// Node.js Nonce Generator
const crypto = require('crypto');
const nonceStr = crypto.randomBytes(16).toString('hex'); // 32 chars
# Python Nonce Generator
import secrets
nonce_str = secrets.token_hex(16) # 32 chars
Security notice
ตารางรหัสข้อผิดพลาดด้านความปลอดภัย (Security Error Codes)
| Code | HTTP Status | Message | คำอธิบายและการแก้ไข |
|---|---|---|---|
1001 |
401 Unauthorized | Invalid Signature |
ลายเซ็นไม่ถูกต้อง ให้ตรวจสอบการเรียงลำดับ ASCII, การตัดค่าว่าง, ค่า appSecret และการทำตัวพิมพ์ใหญ่ |
1002 |
401 Unauthorized | Timestamp Expired |
เวลาในคำขอห่างจากเซิร์ฟเวอร์เกิน 300 วินาที ตรวจสอบการซิงค์นาฬิกาเครื่องเซิร์ฟเวอร์ผ่าน NTP |
1003 |
401 Unauthorized | Invalid Merchant ID |
ไม่พบรหัสร้านค้าในระบบ หรือบัญชีร้านค้าถูกระงับการใช้งาน |
1004 |
401 Unauthorized | Duplicate Nonce |
ค่า nonceStr นี้ถูกใช้งานไปแล้วภายใน 5 นาทีที่ผ่านมา ป้องกันการ Replay Attack |
Example Security Error Response (401 Unauthorized):
{
"code": 1001,
"status": "error",
"message": "Invalid Signature: Computed signature does not match provided sign",
"data": null
}
Wallet API
ระบบบริหารจัดการกระเป๋าเงิน SendDee Wallet สำหรับตรวจสอบยอดเงินคงเหลือ ตรวจสอบวงเงินเครดิต และสถานะของบัญชี เพื่อให้ระบบของท่านสามารถเตรียมพร้อมสำหรับการตัดยอดค่าส่งพัสดุแบบอัตโนมัติ
GET Wallet Balance /wallet/balance
เรียกดูยอดเงินคงเหลือในกระเป๋าเงินและวงเงินเครดิตปัจจุบันของร้านค้า
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | true | รูปแบบ Bearer YOUR_API_KEY |
Accept |
string | true | ระบุ application/json |
Response Data Fields
| Field | Type | Description |
|---|---|---|
balanceSatang |
integer | ยอดเงินคงเหลือหน่วยสตางค์ (เช่น 5009846 สตางค์ = 50,098.46 บาท) สำหรับคำนวณแบบแม่นยำสูง |
balanceBaht |
float | ยอดเงินคงเหลือหน่วยบาท ทศนิยม 2 ตำแหน่ง (เช่น 50098.46) |
creditLimitSatang |
integer | วงเงินเครดิตที่ได้รับอนุมัติหน่วยสตางค์ (กรณีได้รับเครดิตเทอม) |
currency |
string | สกุลเงินของกระเป๋าเงิน (ค่าคงที่: "THB") |
accountStatus |
string | สถานะบัญชีกระเป๋าเงิน: "active" (ปกติพร้อมใช้งาน), "frozen" (ระงับชั่วคราว) |
Request Example:
GET /api/v1/wallet/balance HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
curl -X GET "https://api.senddee.com/api/v1/wallet/balance" -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch('https://api.senddee.com/api/v1/wallet/balance', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const wallet = await res.json();
console.log('ยอดคงเหลือ:', wallet.data.balanceBaht, 'บาท');
import requests
res = requests.get(
'https://api.senddee.com/api/v1/wallet/balance',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(res.json()['data'])
Example response (200 OK):
{
"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 พร้อมคำนวณค่าบริการพื้นที่ห่างไกลและค่าธรรมเนียม COD
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | true | Bearer YOUR_API_KEY |
Content-Type |
string | true | application/json |
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
fromZip |
string(5) | true | รหัสไปรษณีย์ต้นทาง (ผู้ส่ง) เช่น "10110" |
toZip |
string(5) | true | รหัสไปรษณีย์ปลายทาง (ผู้รับ) เช่น "50000" |
weightGrams |
integer | true | น้ำหนักพัสดุจริงหน่วยกรัม (เช่น 500 = 0.5 กก.) |
widthCm |
integer | true | ความกว้างพัสดุหน่วยเซนติเมตร |
lengthCm |
integer | true | ความยาวพัสดุหน่วยเซนติเมตร |
heightCm |
integer | true | ความสูงพัสดุหน่วยเซนติเมตร |
codAmount |
float | false | ยอดเงินเก็บเงินปลายทาง (หากมี) ระบบจะคำนวณค่าธรรมเนียม COD ให้อัตโนมัติ |
Response Data Fields
| Field | Type | Description |
|---|---|---|
rates |
array | รายการค่าจัดส่งของแต่ละขนส่ง เรียงลำดับจากราคาประหยัดที่สุด |
rates[].carrier |
string | รหัสขนส่ง (เช่น "FLASH", "SPX", "EMS", "JNT") |
rates[].carrierName |
string | ชื่อทางการของบริษัทขนส่ง |
rates[].shippingFeeBaht |
float | ค่าขนส่งพื้นฐานหน่วยบาท |
rates[].remoteAreaFeeBaht |
float | ค่าบริการพื้นที่ห่างไกล/เกาะพิเศษ (หากไม่มีเป็น 0.00) |
rates[].codFeeBaht |
float | ค่าธรรมเนียมเก็บเงินปลายทางรวมภาษีมูลค่าเพิ่ม (Inc. VAT) |
rates[].totalFeeBaht |
float | ยอดเงินสุทธิที่ต้องชำระหน่วยบาท |
rates[].estimatedDeliveryDays |
string | ระยะเวลาประมาณการจัดส่งถึงปลายทาง (เช่น "1-2 วัน") |
Rate Inquiry Request Example:
POST /api/v1/rates/quote HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"fromZip": "10110",
"toZip": "50000",
"weightGrams": 500,
"widthCm": 15,
"lengthCm": 20,
"heightCm": 10,
"codAmount": 350.00
}
curl -X POST "https://api.senddee.com/api/v1/rates/quote" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
"fromZip": "10110",
"toZip": "50000",
"weightGrams": 500,
"widthCm": 15,
"lengthCm": 20,
"heightCm": 10,
"codAmount": 350.00
}'
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"rates": [
{
"carrier": "FLASH",
"carrierName": "Flash Express",
"shippingFeeBaht": 22.00,
"remoteAreaFeeBaht": 0.00,
"codFeeBaht": 10.50,
"totalFeeBaht": 32.50,
"estimatedDeliveryDays": "1-2 วัน"
},
{
"carrier": "SPX",
"carrierName": "Shopee Express",
"shippingFeeBaht": 24.50,
"remoteAreaFeeBaht": 0.00,
"codFeeBaht": 10.50,
"totalFeeBaht": 35.00,
"estimatedDeliveryDays": "1-2 วัน"
}
]
}
}
POST Create order /shipments
สร้างออร์เดอร์พัสดุเข้าระบบ ตัดเงินจากกระเป๋าเงินทันที และรับเลขพัสดุ (Tracking Number) พร้อมลิงก์ใบปะหน้า
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | true | Bearer YOUR_API_KEY |
Content-Type |
string | true | application/json |
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
carrier |
string | true | ขนส่งที่เลือก: "FLASH", "SPX", "EMS", "JNT" |
sender |
object | true | ข้อมูลผู้ส่ง: name, phone, address, postalCode |
recipient |
object | true | ข้อมูลผู้รับ: name, phone, address, postalCode |
parcel |
object | true | รายละเอียดพัสดุ: weightGrams, widthCm, lengthCm, heightCm, itemName |
cod |
object | false | กรณีเก็บเงินปลายทาง: {"isCod": true, "amount": 350.00} |
merchantOrderId |
string | false | เลขออร์เดอร์ของฝั่งระบบคุณ สำหรับใช้เป็นเลขอ้างอิงและป้องกันการสร้างซ้ำ (Idempotency) |
Response Data Fields
| Field | Type | Description |
|---|---|---|
id |
string | Shipment ID ในระบบ SendDee สำหรับใช้อ้างอิงใน API เส้นอื่นๆ |
trackingNumber |
string | เลขพัสดุจริงของขนส่ง (Tracking Number) เช่น "TH01485938294B" |
carrier |
string | ขนส่งที่สร้างออร์เดอร์ |
status |
string | สถานะเริ่มต้นของพัสดุ ("created") |
chargedAmountBaht |
float | ยอดเงินที่หักชำระจากกระเป๋าเงิน SendDee ของคุณจริง |
walletBalanceRemaining |
float | ยอดเงินคงเหลือล่าสุดในกระเป๋าเงินหลังตัดชำระเรียบร้อย |
labelUrl |
string | URL สำหรับเปิดพิมพ์ใบปะหน้าพัสดุทันที |
createdAt |
string | วันเวลาที่สร้างออร์เดอร์สำเร็จ (ISO 8601 UTC) |
Create Order Request Example:
POST /api/v1/shipments HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"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"
}
curl -X POST "https://api.senddee.com/api/v1/shipments" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
"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"
}'
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"id": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"status": "created",
"merchantOrderId": "ORD-202611-0091",
"chargedAmountBaht": 23.54,
"walletBalanceRemaining": 50098.46,
"cod": {
"isCod": true,
"amount": 350.00,
"feeBaht": 10.50,
"vatBaht": 0.74
},
"labelUrl": "https://api.senddee.com/labels/shp_98f12a3b7c4d.pdf",
"createdAt": "2026-11-18T10:15:30Z"
}
}
GET List orders /shipments
ค้นหาและดึงรายการประวัติคำสั่งซื้อพัสดุในระบบ สามารถกรองตามสถานะ ขนส่ง ช่วงวันที่ หรือค้นหาด้วยเลขพัสดุ
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page |
integer | false | 1 |
ลำดับหน้าที่ต้องการเรียกดู |
pageSize |
integer | false | 20 |
จำนวนรายการต่อหน้า (สูงสุด 100 รายการ) |
status |
string | false | - | กรองตามสถานะ: created, picked_up, in_transit, delivered, problem, cancelled |
carrier |
string | false | - | กรองเฉพาะขนส่ง: FLASH, SPX, EMS, JNT |
startDate |
string(10) | false | - | วันที่เริ่มต้น (YYYY-MM-DD) เช่น 2026-11-01 |
endDate |
string(10) | false | - | วันที่สิ้นสุด (YYYY-MM-DD) เช่น 2026-11-18 |
searchKeyword |
string | false | - | ค้นหาจากเลขพัสดุ เลขออร์เดอร์ ชื่อผู้รับ หรือเบอร์โทรศัพท์ |
Response Data Fields
| Field | Type | Description |
|---|---|---|
page |
integer | ลำดับหน้าปัจจุบัน |
pageSize |
integer | จำนวนรายการต่อหน้า |
total |
integer | จำนวนรายการทั้งหมดที่พบตามเงื่อนไข |
items |
array | รายการพัสดุ: id, trackingNumber, carrier, status, recipientName, recipientPhone, codAmount, createdAt |
List Orders Request Example:
GET /api/v1/shipments?page=1&pageSize=10&status=in_transit HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
curl -X GET "https://api.senddee.com/api/v1/shipments?page=1&pageSize=10&status=in_transit" -H "Authorization: Bearer YOUR_API_KEY"
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"page": 1,
"pageSize": 10,
"total": 42,
"items": [
{
"id": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"status": "in_transit",
"merchantOrderId": "ORD-202611-0091",
"recipientName": "สมชาย ใจดี",
"recipientPhone": "0898765432",
"destinationPostalCode": "50000",
"codAmount": 350.00,
"shippingFeeBaht": 23.54,
"createdAt": "2026-11-18T10:15:30Z"
}
]
}
}
GET Tracking order /shipments/:id
ติดตามสถานะและไทม์ไลน์การเดินทางของพัสดุแบบ Real-time โดยสามารถระบุได้ทั้ง Shipment ID หรือ เลขพัสดุ (Tracking Number)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | true | ระบุเป็น Shipment ID (shp_...) หรือเลขพัสดุจริง (เช่น TH01485938294B) |
Response Data Fields
| Field | Type | Description |
|---|---|---|
trackingNumber |
string | เลขพัสดุของขนส่ง |
carrier |
string | รหัสขนส่ง (เช่น "FLASH") |
currentStatus |
string | สถานะปัจจุบันของพัสดุ (เช่น "in_transit", "out_for_delivery", "delivered") |
timeline |
array | ลำดับเหตุการณ์การเดินทางของพัสดุ จากล่าสุดลงไปเก่าสุด |
timeline[].status |
string | รหัสสถานะในแต่ละจุดสแกน |
timeline[].statusDesc |
string | ข้อความอธิบายสถานะภาษาไทย (เช่น "พัสดุถึงศูนย์คัดแยกหลักเชียงใหม่") |
timeline[].location |
string | สถานที่สาขาหรือศูนย์คัดแยกที่ทำการสแกน |
timeline[].timestamp |
string | วันเวลาที่ทำการสแกน (ISO 8601 UTC) |
timeline[].operatorPhone |
string | เบอร์โทรศัพท์พนักงานจัดส่ง (กรณีสถานะ out_for_delivery) |
Tracking Request Example:
GET /api/v1/shipments/TH01485938294B HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
curl -X GET "https://api.senddee.com/api/v1/shipments/TH01485938294B" -H "Authorization: Bearer YOUR_API_KEY"
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"currentStatus": "in_transit",
"timeline": [
{
"status": "in_transit",
"statusDesc": "พัสดุอยู่ระหว่างการขนส่งไปยังศูนย์คัดแยกปลายทาง",
"location": "ศูนย์กระจายสินค้าภาคเหนือ จ.ลำพูน",
"timestamp": "2026-11-18T18:30:00Z"
},
{
"status": "picked_up",
"statusDesc": "พนักงานเข้ารับพัสดุเรียบร้อยแล้ว",
"location": "สาขาคลองเตย กรุงเทพฯ",
"timestamp": "2026-11-18T14:10:00Z"
}
]
}
}
GET Print label /shipments/:id/universal-label
สร้างและดาวน์โหลดไฟล์ใบปะหน้าพัสดุมาตรฐาน รองรับขนาดสติกเกอร์สำหรับเครื่องพิมพ์ความร้อน (Thermal Printer) ทุกยี่ห้อ
Path & Query Parameters
| Parameter | Location | Type | Required | Default | Description |
|---|---|---|---|---|---|
id |
Path | string | true | - | Shipment ID หรือเลขพัสดุ (Tracking Number) |
size |
Query | string | false | 100x150 |
ขนาดสติกเกอร์: "100x150" (A6 มาตรฐาน), "100x75", "A4" |
format |
Query | string | false | PDF |
ฟอร์แมตไฟล์: "PDF" (ค่าเริ่มต้น), "ZPL" (Direct Thermal), "PNG" |
Response Data Fields
| Field | Type | Description |
|---|---|---|
labelUrl |
string | ลิงก์ดาวน์โหลดไฟล์ใบปะหน้าพัสดุ (มีอายุ 24 ชั่วโมง) |
format |
string | ชนิดของไฟล์ที่สร้างขึ้น (เช่น "PDF") |
size |
string | ขนาดของใบปะหน้า (เช่น "100x150") |
trackingNumber |
string | เลขพัสดุที่ระบุบนใบปะหน้า |
Print Label Request Example:
GET /api/v1/shipments/shp_98f12a3b7c4d/universal-label?size=100x150&format=PDF HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
curl -X GET "https://api.senddee.com/api/v1/shipments/shp_98f12a3b7c4d/universal-label?size=100x150&format=PDF" -H "Authorization: Bearer YOUR_API_KEY"
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"labelUrl": "https://api.senddee.com/labels/shp_98f12a3b7c4d.pdf",
"format": "PDF",
"size": "100x150",
"trackingNumber": "TH01485938294B",
"expiresAt": "2026-11-19T10:15:30Z"
}
}
POST Cancel order /shipments/:id/cancel
ยกเลิกคำสั่งซื้อพัสดุก่อนที่ขนส่งจะสแกนเข้ารับ พร้อมคืนยอดเงินค่าจัดส่งและค่าบริการเข้ากระเป๋าเงิน SendDee ของคุณทันทีแบบเรียลไทม์
Path & Body Parameters
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
id |
Path | string | true | Shipment ID หรือเลขพัสดุที่ต้องการยกเลิก |
reasonCode |
Body | string | false | รหัสเหตุผล: "CUSTOMER_CANCEL", "WRONG_ADDRESS", "OUT_OF_STOCK", "OTHER" |
reasonText |
Body | string | false | รายละเอียดเหตุผลการยกเลิกเพิ่มเติม |
Response Data Fields
| Field | Type | Description |
|---|---|---|
id |
string | Shipment ID ที่ถูกยกเลิก |
trackingNumber |
string | เลขพัสดุที่ถูกยกเลิก |
status |
string | สถานะที่เปลี่ยนเป็น "cancelled" |
refundAmountBaht |
float | ยอดเงินค่าส่งที่คืนเข้ากระเป๋าเงินทันที |
walletBalanceRemaining |
float | ยอดเงินคงเหลือล่าสุดในกระเป๋าเงินหลังได้รับเงินคืน |
Cancel Order Request Example:
POST /api/v1/shipments/shp_98f12a3b7c4d/cancel HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"reasonCode": "CUSTOMER_CANCEL",
"reasonText": "ลูกค้าขอยกเลิกคำสั่งซื้อเนื่องจากเปลี่ยนใจ"
}
curl -X POST "https://api.senddee.com/api/v1/shipments/shp_98f12a3b7c4d/cancel" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"reasonCode":"CUSTOMER_CANCEL","reasonText":"ลูกค้าขอยกเลิก"}'
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"id": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"status": "cancelled",
"refundAmountBaht": 23.54,
"walletBalanceRemaining": 50122.00,
"cancelledAt": "2026-11-18T10:40:15Z"
}
}
Notify API
ระบบเรียกรถเข้ารับพัสดุ (Courier Pickup Dispatch API) สำหรับส่งคำขอนัดหมายให้พนักงานขนส่งเข้ารับพัสดุ ณ จุดที่ตั้งของคลังสินค้าหรือหน้าร้าน รวมถึงการตรวจสอบรายการและประวัติการเรียกรถเข้ารับ พร้อมข้อมูลสถานะคนขับและจำนวนพัสดุจริง
POST Notify courier /pickups
ส่งคำขอนัดหมายเรียกรถขนส่งเข้ารับพัสดุ ณ ที่อยู่ต้นทาง
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | true | Bearer YOUR_API_KEY |
Content-Type |
string | true | application/json |
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
carrier |
string | true | ขนส่งที่ต้องการให้เข้ารับ: "FLASH", "SPX", "EMS", "JNT" |
pickupDate |
string(10) | true | วันที่นัดหมายให้เข้ารับ (YYYY-MM-DD) เช่น "2026-11-19" |
pickupTimeSlot |
string | true | ช่วงเวลานัดหมาย: "09:00-12:00" (เช้า) หรือ "13:00-17:00" (บ่าย) |
senderName |
string | true | ชื่อผู้ติดต่อ ณ จุดเข้ารับพัสดุ |
senderPhone |
string | true | เบอร์โทรศัพท์ติดต่อสำหรับคนขับรถโทรประสานงาน |
pickupAddress |
string | true | ที่อยู่จุดเข้ารับอย่างละเอียด (บ้านเลขที่ ซอย ถนน ตำบล อำเภอ จังหวัด) |
postalCode |
string(5) | true | รหัสไปรษณีย์จุดเข้ารับ เช่น "10110" |
estimatedParcels |
integer | true | จำนวนพัสดุโดยประมาณที่ต้องการส่งมอบในรอบนี้ (ชิ้น) |
remark |
string | false | ข้อความเพิ่มเติมสำหรับคนขับรถ เช่น "โกดังหลังสีส้ม เลี้ยวซ้ายเข้าซอย 2" |
Response Data Fields
| Field | Type | Description |
|---|---|---|
pickupTicketId |
string | เลขที่ใบงานนัดหมายเข้ารับพัสดุ (เช่น "PK-20261119-0042") |
carrier |
string | ขนส่งที่ทำการนัดหมาย |
status |
string | สถานะเริ่มต้นของใบงาน ("scheduled") |
scheduledDate |
string | วันที่นัดเข้ารับ |
timeSlot |
string | ช่วงเวลาที่นัดหมาย |
estimatedParcels |
integer | จำนวนพัสดุที่แจ้งไว้ |
Notify Courier Request Example:
POST /api/v1/pickups HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"carrier": "FLASH",
"pickupDate": "2026-11-19",
"pickupTimeSlot": "13:00-17:00",
"senderName": "บริษัท แสนดี สโตร์ จำกัด",
"senderPhone": "0812345678",
"pickupAddress": "123/45 ถนนสุขุมวิท แขวงคลองเตย เขตคลองเตย กทม.",
"postalCode": "10110",
"estimatedParcels": 25,
"remark": "อยู่หน้าโกดัง A3 ประตูกระจก"
}
curl -X POST "https://api.senddee.com/api/v1/pickups" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
"carrier": "FLASH",
"pickupDate": "2026-11-19",
"pickupTimeSlot": "13:00-17:00",
"senderName": "บริษัท แสนดี สโตร์ จำกัด",
"senderPhone": "0812345678",
"pickupAddress": "123/45 สุขุมวิท คลองเตย กทม.",
"postalCode": "10110",
"estimatedParcels": 25,
"remark": "โกดัง A3"
}'
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"pickupTicketId": "PK-20261119-0042",
"carrier": "FLASH",
"status": "scheduled",
"scheduledDate": "2026-11-19",
"timeSlot": "13:00-17:00",
"estimatedParcels": 25,
"createdAt": "2026-11-18T10:45:00Z"
}
}
GET List pickups /pickups
ตรวจสอบรายการและประวัติการเรียกรถขนส่งเข้ารับ พร้อมสถานะพนักงานขับรถและจำนวนพัสดุที่เข้ารับจริง
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | true | Bearer YOUR_API_KEY |
Accept |
string | true | application/json |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page |
integer | false | 1 |
ลำดับหน้าที่ต้องการเรียกดู |
pageSize |
integer | false | 10 |
จำนวนรายการต่อหน้า (สูงสุด 50 รายการ) |
carrier |
string | false | - | กรองเฉพาะขนส่ง: FLASH, SPX, EMS, JNT |
status |
string | false | - | กรองตามสถานะ: scheduled, assigned, in_progress, completed, cancelled |
startDate |
string(10) | false | - | วันที่เริ่มต้นนัดหมาย (YYYY-MM-DD) เช่น 2026-11-01 |
endDate |
string(10) | false | - | วันที่สิ้นสุดนัดหมาย (YYYY-MM-DD) เช่น 2026-11-30 |
Response Data Fields
| Field | Type | Description |
|---|---|---|
page |
integer | ลำดับหน้าปัจจุบัน |
pageSize |
integer | จำนวนรายการต่อหน้า |
total |
integer | จำนวนรายการประวัติการเรียกรถทั้งหมดที่พบ |
items |
array | รายการใบงานเรียกรถเข้ารับพัสดุ |
items[].pickupTicketId |
string | เลขที่ใบงานนัดหมายเรียกรถ (เช่น "PK-20261119-0042") |
items[].carrier |
string | ขนส่งที่นัดหมายเข้ารับ |
items[].status |
string | สถานะใบงาน (ดูรายละเอียดสถานะด้านล่าง) |
items[].pickupDate |
string | วันที่นัดเข้ารับพัสดุ |
items[].pickupTimeSlot |
string | ช่วงเวลานัดหมาย (เช่น "13:00-17:00") |
items[].estimatedParcels |
integer | จำนวนพัสดุที่แจ้งนัดหมายไว้ |
items[].actualParcels |
integer / null | จำนวนพัสดุที่พนักงานสแกนรับจริง (จะมีค่าเมื่อเข้ารับสำเร็จ) |
items[].driverName |
string / null | ชื่อพนักงานขับรถขนส่งที่ได้รับมอบหมายงาน |
items[].driverPhone |
string / null | เบอร์โทรศัพท์ติดต่อพนักงานขับรถ |
items[].createdAt |
string | วันเวลาที่ทำการสร้างคำขอนัดหมาย (ISO 8601 UTC) |
ตารางความหมายของสถานะการเรียกรถ (Pickup Status Definitions)
| Status | ชื่อสถานะ | คำอธิบายและการดำเนินการ |
|---|---|---|
scheduled |
นัดหมายสำเร็จ | คำขอส่งไปยังขนส่งแล้ว รอสาขาขนส่งจัดสรรพนักงานขับรถ |
assigned |
จัดสรรคนขับแล้ว | ขนส่งกำหนดคนขับรถรับผิดชอบแล้ว ระบบจะแสดงชื่อและเบอร์โทรคนขับ |
in_progress |
กำลังเดินทาง | พนักงานขับรถกำลังเดินทางมายังจุดรับพัสดุของคุณ |
completed |
เข้ารับสำเร็จ | พนักงานสแกนพัสดุขึ้นรถเรียบร้อย พร้อมบันทึกจำนวนพัสดุจริง |
cancelled |
ยกเลิก | ใบงานถูกยกเลิก (ยกเลิกโดยผู้ส่ง หรือขนส่งติดต่อไม่ได้) |
List Pickups Request Example:
GET /api/v1/pickups?page=1&pageSize=10 HTTP/1.1
Host: api.senddee.com
Authorization: Bearer YOUR_API_KEY
curl -X GET "https://api.senddee.com/api/v1/pickups?page=1&pageSize=10" -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch('https://api.senddee.com/api/v1/pickups?page=1&pageSize=10', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const result = await res.json();
console.log('ประวัติการเรียกรถ:', result.data.items);
import requests
res = requests.get(
'https://api.senddee.com/api/v1/pickups',
params={'page': 1, 'pageSize': 10},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(res.json()['data']['items'])
Example response (200 OK):
{
"code": 200,
"status": "success",
"data": {
"page": 1,
"pageSize": 10,
"total": 3,
"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) ไปยังเซิร์ฟเวอร์ของคุณโดยตรง เมื่อเกิดเหตุการณ์สำคัญเกี่ยวกับสถานะพัสดุ ยอดเงิน COD หรือการเรียกรถเข้ารับ
Web hook service
เมื่อเปิดใช้งาน Webhook บนระบบ SendDee เมื่อใดก็ตามที่ขนส่งสแกนสถานะพัสดุ (เช่น เข้ารับ, กำลังจัดส่ง, เซ็นรับสำเร็จ, เกิดปัญหา) ระบบ SendDee Gateway จะส่งคำขอแบบ HTTP POST JSON ไปยัง Endpoint URL ของคุณทันที
HTTP Headers ที่ส่งพร้อม Webhook
| Header | Description | ตัวอย่าง |
|---|---|---|
Content-Type |
ชนิดของข้อมูล | application/json; charset=utf-8 |
x-senddee-event |
ชื่อเหตุการณ์ที่เกิดขึ้น | order.delivered |
x-senddee-signature |
ลายเซ็นดิจิทัลสำหรับตรวจสอบความถูกต้อง | 9A4B8C... (SHA-256 HMAC / Hash) |
x-senddee-timestamp |
เวลาที่ส่ง Webhook หน่วยวินาที | 1731931500 |
Webhook Receiver Response Expectation:
HTTP/1.1 200 OK
Content-Type: application/json
{"status":"ok"}
// Node.js Express Webhook Handler Example
app.post('/api/senddee-webhook', (req, res) => {
const event = req.headers['x-senddee-event'];
const payload = req.body;
console.log(`Received event ${event} for tracking ${payload.data.trackingNumber}`);
// ตอบกลับ 200 OK เสมอเพื่อยืนยันการรับข้อมูลสำเร็จ
res.status(200).json({ status: 'ok' });
});
Web hook events
รายการเหตุการณ์ (Events) ทั้งหมดที่ระบบ SendDee รองรับการแจ้งเตือน:
| 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 | พัสดุตีกลับถึงผู้ส่งต้นทางเรียบร้อยแล้ว |
cod.transferred |
Finance | ยอดเงินเก็บเงินปลายทางโอนเข้าสู่กระเป๋าเงิน SendDee สำเร็จ |
pickup.assigned |
Pickup | ขนส่งจัดสรรคนขับรถมารับพัสดุตามคำขอนัดหมายแล้ว |
pickup.completed |
Pickup | พนักงานขนส่งเข้ารับพัสดุ ณ จุดนัดหมายสำเร็จ |
Example Webhook Payload (order.delivered):
{
"event": "order.delivered",
"timestamp": 1731931500,
"data": {
"id": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"status": "delivered",
"statusDesc": "ผู้รับเซ็นรับพัสดุเรียบร้อยแล้ว",
"recipientName": "สมชาย ใจดี",
"recipientPhone": "0898765432",
"signedBy": "สมชาย (ผู้รับโดยตรง)",
"signedAt": "2026-11-18T14:35:20Z",
"cod": {
"isCod": true,
"amount": 350.00,
"collectionStatus": "collected"
}
}
}
Status Flow
แผนผังวงจรชีวิตของพัสดุ (Shipment Lifecycle State Machine) อธิบายลำดับการเปลี่ยนสถานะตั้งแต่สร้างออร์เดอร์จนถึงส่งมอบสำเร็จหรือตีกลับ:
| ลำดับ | Status | สถานะภาษาไทย | เงื่อนไขและจุดเปลี่ยนสถานะ |
|---|---|---|---|
| 1 | created |
สร้างออร์เดอร์แล้ว | ตัดเงินจากกระเป๋าเงินสำเร็จ ออกเลข Tracking Number และใบปะหน้า |
| 2 | picked_up |
เข้ารับพัสดุแล้ว | พนักงานขนส่งสแกนรับพัสดุ ณ จุดรับ หรือร้านค้านำไปส่งที่จุด Drop-off |
| 3 | in_transit |
อยู่ระหว่างขนส่ง | พัสดุอยู่ระหว่างการเคลื่อนย้ายผ่านศูนย์คัดแยกหลัก (HUB / Sorting Center) |
| 4 | out_for_delivery |
กำลังนำจ่าย | พัสดุถึงสาขาปลายทาง และพนักงานนำจ่ายโหลดพัสดุขึ้นรถนำส่ง |
| 5A | delivered |
จัดส่งสำเร็จ | ผู้รับเซ็นรับพัสดุเรียบร้อย (หากเป็น COD ระบบเตรียมโอนเงินเข้า Wallet) |
| 5B | problem |
พัสดุติดปัญหา | ติดต่อผู้รับไม่ได้, ที่อยู่ไม่ถูกต้อง หรือขอเลื่อนนัดส่ง (ขนส่งพยายามส่งซ้ำ 3 ครั้ง) |
| 6 | returned |
ตีกลับต้นทาง | พัสดุส่งไม่สำเร็จเกิน 3 ครั้ง และถูกส่งตีกลับถึงมือผู้ส่งเรียบร้อยแล้ว |
| - | cancelled |
ยกเลิกออร์เดอร์ | ยกเลิกก่อนที่ขนส่งจะสแกนรับ ระบบคืนเงินเข้ากระเป๋าเงินทันที |
Shipment Lifecycle Representation:
{
"normalFlow": [
"created",
"picked_up",
"in_transit",
"out_for_delivery",
"delivered"
],
"exceptionFlow": [
"problem",
"returned"
],
"abortFlow": [
"cancelled"
]
}
Constants
ตารางรหัสและค่าคงที่มาตรฐานที่ใช้ร่วมกันในระบบ SendDee Open-API
Response Code
ตารางรหัสผลลัพธ์ของระบบ SendDee Gateway และแนวทางการจัดการข้อผิดพลาด:
| Code | HTTP Status | Message | คำอธิบาย |
|---|---|---|---|
200 |
200 OK | Success |
คำขอทำงานสำเร็จสมบูรณ์ |
400 |
400 Bad Request | Bad Request |
ข้อมูลคำขอไม่ถูกต้องหรือส่งพารามิเตอร์ที่จำเป็นไม่ครบ |
401 |
401 Unauthorized | Unauthorized |
API Key ไม่ถูกต้อง ลายเซ็นไม่ผ่าน หรือเวลาหมดอายุ |
403 |
403 Forbidden | Forbidden |
ไม่มีสิทธิ์เข้าถึง Endpoint นี้ หรือบัญชีถูกระงับการใช้งาน |
404 |
404 Not Found | Not Found |
ไม่พบข้อมูลพัสดุหรือใบงานที่ระบุ |
422 |
422 Unprocessable | Unprocessable Entity |
รูปแบบข้อมูลถูกต้องแต่ไม่สามารถทำรายการได้ เช่น ยอดเงินคงเหลือไม่พอ |
1001 |
401 Unauthorized | Invalid Signature |
การคำนวณลายเซ็นดิจิทัล SHA-256 ไม่ถูกต้อง |
1002 |
401 Unauthorized | Timestamp Expired |
เวลาในคำขอห่างจากเวลาปัจจุบันเกิน 300 วินาที |
1003 |
401 Unauthorized | Invalid Merchant ID |
รหัสร้านค้าไม่ถูกต้องหรือไม่มีอยู่ในระบบ |
1004 |
401 Unauthorized | Duplicate Nonce |
ค่า nonceStr ถูกส่งซ้ำภายในช่วงเวลา 5 นาที (Replay Attack) |
2001 |
422 Unprocessable | Insufficient Wallet Balance |
ยอดเงินในกระเป๋าเงิน SendDee ไม่เพียงพอสำหรับการตัดชำระค่าส่ง |
2002 |
503 Service Unavail | Carrier Gateway Unavailable |
ระบบขนส่งปลายทางปิดปรับปรุงชั่วคราว |
2003 |
400 Bad Request | Invalid Postal Code |
รหัสไปรษณีย์ปลายทางไม่ถูกต้องหรือไม่ตรงกับตำบล/อำเภอ |
2004 |
422 Unprocessable | Remote Area Not Supported |
ขนส่งที่เลือกไม่รองรับการจัดส่งในรหัสไปรษณีย์พื้นที่ห่างไกลนี้ |
5000 |
500 Internal Error | Internal Gateway Error |
ข้อผิดพลาดภายในระบบ SendDee Gateway |
Example Error Response (2001 Insufficient Balance):
{
"code": 2001,
"status": "error",
"message": "Insufficient Wallet Balance: Required 35.50 THB, Available 12.00 THB. Please top up your wallet.",
"data": {
"requiredAmountBaht": 35.50,
"availableBalanceBaht": 12.00,
"topupUrl": "https://senddee.com/wallet/topup"
}
}
Carrier List
รายชื่อรหัสบริษัทขนส่งที่รองรับในระบบ SendDee Open-API:
| Carrier Code | ชื่อบริษัทขนส่ง | บริการที่รองรับ | การเรียกรถเข้ารับ (Pickup) |
|---|---|---|---|
FLASH |
Flash Express | Standard, COD, Speed, Bulky | รองรับเรียกรถเข้ารับฟรีถึงหน้าบ้าน/คลังสินค้า |
SPX |
Shopee Express (SPX) | Standard, COD | รองรับทั้ง Drop-off สาขา และเรียกรถเข้ารับ |
EMS |
Thailand Post (ไปรษณีย์ไทย EMS) | Standard, COD, ครอบคลุม 100% ทั่วไทย | รองรับ Drop-off ทุกที่ทำการไปรษณีย์ทั่วประเทศ |
JNT |
J&T Express | Standard, COD | เปิดบริการ 365 วันไม่มีวันหยุด |
KEX |
KEX (Kerry Express) | Standard, COD | รองรับ Drop-off และเรียกรถเข้ารับ |
Carrier Constants JSON:
{
"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 },
{ "code": "KEX", "name": "KEX (Kerry Express)", "pickupSupported": true }
]
}