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://open-api.senddee.com/api/v1https://open-api-test.senddee.com/api/v1curl -I https://open-api-test.senddee.com/healthAPI Reference
ระบบ SendDee API ทำงานบนมาตรฐาน RESTful สื่อสารผ่านโปรโตคอล HTTPS ข้อมูลคำขอและคำตอบอยู่ในรูปแบบ JSON
API Environment
| Environment | Base URL | คำอธิบาย |
|---|---|---|
| Production | https://open-api.senddee.com/api/v1 |
สภาพแวดล้อมใช้งานจริง รองรับการสร้างพัสดุจริงและตัดยอดเงินในกระเป๋าจริง |
| Test | https://open-api-test.senddee.com/api/v1 |
สภาพแวดล้อมทดสอบ พัสดุจำลอง ไม่มีการตัดเงินจริง |
มาตรฐานการสื่อสารระบบ (SendDee Protocols)
| มาตรฐาน | ข้อกำหนด | รายละเอียด |
|---|---|---|
| Protocol | HTTPS / TLS 1.3 | คำขอทั้งหมดต้องส่งผ่านการเข้ารหัส TLS 1.2 หรือ TLS 1.3 เท่านั้น |
| Data Format | RESTful JSON | ระบุ Header Content-Type: application/json; charset=utf-8 |
| Timestamp | Unix Epoch Seconds | เวลาปัจจุบันของเซิร์ฟเวอร์หน่วยวินาที (10 หลัก UTC+7) เช่น 1731931500 |
| Currency | THB (Satang / Baht) | คำนวณแบบสตางค์ (Minor Unit) เพื่อความแม่นยำสูงสุดทางบัญชี |
| Idempotency | Idempotency-Key | รองรับการส่งคีย์กันคำขอซ้ำ ป้องกันการสร้างพัสดุซ้ำซ้อนกรณี Network Timeout |
รูปแบบข้อมูลตอบกลับ (Unified JSON Envelope)
คำตอบทุกรายการจาก 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
}SendDee Security Shield™
ระบบ SendDee API ถูกสร้างขึ้นบนสถาปัตยกรรมความปลอดภัยระดับ Zero-Trust สำหรับงานโลจิสติกส์ยุคใหม่ (SendDee Zero-Trust Logistics Architecture) ด้วยเทคโนโลยีการเข้ารหัสลับขั้นสูง (Cryptographic Security Pipeline) เพื่อให้มั่นใจว่าข้อมูลคำสั่งซื้อ เงินในกระเป๋า และข้อมูลลูกค้าของคุณจะปลอดภัยสูงสุด 100%
ระบบ SendDee ใช้โครงสร้างความปลอดภัยระดับ Enterprise มาตรฐานเดียวกับ Flash Express Open API ซึ่งกำหนดให้ต้องใช้ข้อมูลยืนยันตัวตน 2 ส่วนประกอบกันเสมอ จึงจะสามารถสร้างออร์เดอร์พัสดุ (Create Shipment) หรือยิงคำขอเข้าระบบได้:
- ส่วนที่ 1: รหัสร้านค้า (Merchant Code / Customer Code /
mchId): คือรหัสประจำตัวร้านค้าของคุณ (เช่นSD559274) ซึ่งสามารถดูและคัดลอกได้จากหน้าตั้งค่า "API & นักพัฒนา" โดยส่งผ่าน HeaderX-SendDee-App-Id(หรือระบุใน Request Body ด้วยฟิลด์mchId) - ส่วนที่ 2: API Key (Sign Key / Secret Token): คือกุญแจความปลอดภัย (เช่น
sd_live_...) ที่กดขอรับได้จากหน้าตั้งค่า API ของร้านค้า ใช้ส่งผ่าน HeaderAuthorization: Bearer YOUR_API_KEYหรือใช้เป็น Key ลับในการคำนวณลายเซ็นดิจิทัล (Signature)
ระบบจะตรวจสอบความสัมพันธ์ของทั้งสองส่วนอย่างเคร่งครัด หากรหัสลูกค้ากับ API Key ไม่ตรงกัน หรือส่งข้อมูลไม่ครบทั้ง 2 ส่วน ระบบจะปฏิเสธคำขอด้วยสถานะ 403 Forbidden ทันทีเพื่อป้องกันการยิงออร์เดอร์แอบอ้างข้ามร้านค้า 100%
1. โหมดมาตรฐาน (Bearer Token Mode): เหมาะสำหรับการเชื่อมต่อทั่วไป (เช่น WooCommerce, Shopify, ระบบจัดการหลังบ้าน) โดยส่ง API Key ผ่าน Authorization: Bearer sd_live_... ควบคู่กับรหัสลูกค้า X-SendDee-App-Id หรือฟิลด์ mchId
2. โหมดความปลอดภัยขั้นสูง (SendDee Cryptographic Protocol - SDCP): เหมาะสำหรับระบบ Enterprise, ระบบแฟรนไชส์ และ ERP โดย ไม่ต้องส่ง Secret Key ผ่านอินเทอร์เน็ตเลย (Zero-Knowledge Transmission) แต่ใช้การคำนวณลายเซ็นดิจิทัล X-SendDee-Signature (SHA-256) ร่วมกับรหัสลูกค้าและ API Key
SD559274 (ดูได้จากเมนูตั้งค่า "API & นักพัฒนา") หรือส่งใน Request Body ด้วยฟิลด์ mchIdSendDee Cryptographic Protocol (SDCP)
ขั้นตอนการคำนวณลายเซ็นดิจิทัลของ SendDee ประกอบด้วย 4 ขั้นตอนทางคณิตศาสตร์อย่างเคร่งครัด:
นำฟิลด์ข้อมูลใน Request Body ทั้งหมดมารวมกัน หากฟิลด์ใดมีค่าเป็นค่าว่าง ("") หรือ null ให้ตัดออก และห้ามนำฟิลด์ลายเซ็นมาร่วมคำนวณ
นำชื่อฟิลด์มาเรียงตามลำดับตัวอักษร ASCII (A-Z, a-z) จากน้อยไปมาก แล้วเชื่อมต่อกันด้วยเครื่องหมาย & ในรูปแบบ key1=value1&key2=value2... จะได้ canonicalPayload
นำ canonicalPayload มาต่อท้ายด้วย &secret= ตามด้วย App Secret ประจำร้านค้าของคุณ จะได้ payloadToSign
นำ payloadToSign ไปคำนวณแฮชด้วยฟังก์ชัน SHA-256 จากนั้นแปลงผลลัพธ์เป็น ตัวพิมพ์ใหญ่ทั้งหมด (UPPERCASE) จะได้ค่า X-SendDee-Signature
โครงสร้างรหัสลูกค้าแบบสุ่มคละ 6 หลัก (Customer Code: SD / CO / FR / AP)
เพื่อยกระดับความปลอดภัยและป้องกันการสุ่มเดาจำนวนลูกค้าในระบบหรือการแอบอ้างสิทธิ์ (Anti-Enumeration Protection) SendDee ได้ปรับใช้ระบบรหัสลูกค้าแบบ Prefix ตัวอักษร 2 ตัวตามด้วยเลขสุ่มคละ 6 หลัก (100000 – 999999) ผ่านฟังก์ชันการสุ่มเข้ารหัสลับขั้นสูง (Cryptographically Secure Random Generation) แยกกลุ่มลูกค้าได้อย่างชัดเจน:
| Prefix | กลุ่มบัญชี | ตัวอย่างรหัส | สิทธิประโยชน์ & คุณสมบัติ |
|---|---|---|---|
SD |
SendDee General User | SD849205 |
บุคคลทั่วไป / ร้านค้าออนไลน์ทั่วไป ระบบเติมเงิน (Prepaid) เรทมาตรฐาน |
CO |
Corporate Business | CO391842 |
ลูกค้านิติบุคคล / บริษัท รองรับใบกำกับภาษีเต็มรูป หัก ณ ที่จ่าย 3% (WHT) เครดิตเทอม |
FR |
Franchise Branch | FR502914 |
ร้านค้าแฟรนไชส์ / จุดรับส่งพัสดุ กระเป๋าเงินและเรทราคาแฟรนไชส์เฉพาะสาขา |
AP |
API Partner | AP716390 |
พาร์ทเนอร์เชื่อมต่อผ่าน Open API ใช้เป็น mchId ร่วมกับ API Key |
ระบบรองรับการอัปเกรดบัญชีร้านค้าจาก SD เป็น CO เพื่อผูกข้อมูลบริษัท เลขประจำตัวผู้เสียภาษี 13 หลัก และระบบหัก ณ ที่จ่าย (WHT 3%):
POST /api/v1/orgs/current/upgrade-corporate
COxxxxxx ใหม่ให้ทันที โดยคงกระเป๋าเงิน (Wallet) และประวัติออร์เดอร์เดิมไว้ 100%• Audit Trail: รหัส
SDxxxxxx เดิมจะถูกบันทึกเก็บไว้ใน previous_customer_code และบันทึกประวัติการเปลี่ยนแปลงลงตารางตรวจสอบ account_code_histories สำหรับงานตรวจสอบบัญชี
ระบบจำกัดอัตราการยิงระดับบัญชี (Tiered Rate Limiting per Account)
SendDee บังคับใช้ระบบ Rate Limiting ระดับบัญชี (Organization / Account) ผ่านสถาปัตยกรรม NestJS + Redis Sliding Window ส่ง Response Headers กำกับในทุกคำขอ:
| Tier บัญชี | โควตาสูงสุด | ความเร็วเฉลี่ย | เหมาะสำหรับ |
|---|---|---|---|
STANDARD |
60 requests / minute | 1 req/s | บัญชีบุคคลทั่วไป (SD) เชื่อมต่อร้านค้าขนาดเล็ก |
BUSINESS |
300 requests / minute | 5 req/s | บัญชีนิติบุคคล (CO) ร้านค้าขนาดกลางและคลังสินค้า E-Commerce |
ENTERPRISE |
1,000 requests / minute | ~16.6 req/s | พาร์ทเนอร์เชื่อมต่อ API ขนาดใหญ่ (AP) และเครือข่ายแฟรนไชส์ (FR) |
Response Headers:
• X-RateLimit-Limit: โควตาสูงสุดต่อนาทีของบัญชีท่าน (เช่น 60, 300, 1000)
• X-RateLimit-Remaining: โควตาที่เหลือในหน้าต่างเวลาปัจจุบัน
• X-RateLimit-Reset: จำนวนวินาทีจนกว่าโควตาจะรีเซ็ต
หากส่งคำขอเกินโควตา ระบบจะตอบกลับด้วย HTTP 429 Too Many Requests พร้อม Header Retry-After
การป้องกัน Replay Attack & Clock Drift
ระบบ SendDee มีระบบตรวจสอบความสดใหม่ของคำขอ (Freshness Verification) โดยเซิร์ฟเวอร์จะจดจำค่า X-SendDee-Nonce ภายในกรอบเวลา 300 วินาที
หากแฮกเกอร์ดักจับข้อมูลแล้วนำมายิงซ้ำ ระบบจะปฏิเสธคำขอทันที
นโยบายความปลอดภัยระดับ Enterprise (Enterprise Policies)
App Secret ต้องถูกเก็บรักษาบนเซิร์ฟเวอร์ฝั่งหลังบ้านของคุณเท่านั้น ห้ามใส่ใน Mobile App หรือ Frontend เด็ดขาด• Strict IP Whitelisting: สามารถระบุ Server IP ที่อนุญาตในหน้าจัดการ API Key คำขอที่ยิงมาจาก IP อื่นจะถูกบล็อกด้วย
403 Forbidden ทันที• Default-Deny Scopes: API Key ได้รับสิทธิ์เฉพาะ 7 กลุ่มงานขนส่งและกระเป๋าเงินเท่านั้น โดยระบบบล็อกการเข้าถึงระบบภายใน องค์กร และแอดมิน 100%
• Rate Limiting (120 req/min): จำกัดความถี่ในการส่งคำขอสูงสุด 120 คำขอต่อนาทีต่อ API Key (ป้องกันการโจมตีแบบ DoS/Brute-force)
POST /api/v1/rates/quote HTTP/1.1
Host: open-api.senddee.com
Content-Type: application/json; charset=utf-8
X-SendDee-App-Id: SD559274
X-SendDee-Timestamp: 1731931500
X-SendDee-Nonce: 4f797775c74a4e3a9bc4d7a120ee52a8
X-SendDee-Signature: BF46380E893F6B8F5486D2EDFE265BB8942C6A9BD5C897E34373734CE08B4B67import crypto from 'crypto';
export function createSendDeeSignature(payload: Record, appSecret: string): string {
const cleanPayload = { ...payload };
delete cleanPayload.signature;
delete cleanPayload.sign;
// เรียงคีย์ตามลำดับ ASCII
const sortedKeys = Object.keys(cleanPayload)
.filter(k => cleanPayload[k] !== '' && cleanPayload[k] != null)
.sort();
const canonicalPayload = sortedKeys
.map(k => `${k}=${typeof cleanPayload[k] === 'object' ? JSON.stringify(cleanPayload[k]) : cleanPayload[k]}`)
.join('&');
const payloadToSign = `${canonicalPayload}&secret=${appSecret}`;
return crypto.createHash('sha256').update(payloadToSign, 'utf8').digest('hex').toUpperCase();
} function createSendDeeSignature(array $payload, string $appSecret): string {
unset($payload['signature'], $payload['sign']);
// กรองค่าว่างออก
$filtered = array_filter($payload, function($val) {
return $val !== null && $val !== '';
});
// เรียงคีย์ตามลำดับ ASCII
ksort($filtered);
$parts = [];
foreach ($filtered as $k => $v) {
$valStr = is_array($v) ? json_encode($v, JSON_UNESCAPED_UNICODE) : (string)$v;
$parts[] = "{$k}={$valStr}";
}
$canonicalPayload = implode('&', $parts);
$payloadToSign = "{$canonicalPayload}&secret={$appSecret}";
return strtoupper(hash('sha256', $payloadToSign));
}import hashlib
import json
def create_senddee_signature(payload: dict, app_secret: str) -> str:
clean = {k: v for k, v in payload.items() if k not in ('signature', 'sign') and v is not None and v != ''}
sorted_keys = sorted(clean.keys())
parts = []
for k in sorted_keys:
v = clean[k]
val_str = json.dumps(v, separators=(',', ':'), ensure_ascii=False) if isinstance(v, (dict, list)) else str(v)
parts.append(f"{k}={val_str}")
canonical_payload = "&".join(parts)
payload_to_sign = f"{canonical_payload}&secret={app_secret}"
return hashlib.sha256(payload_to_sign.encode('utf-8')).hexdigest().upper()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://open-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 กก.)| Field | Type | คำอธิบาย |
|---|---|---|
quoteId | string | รหัสอ้างอิงใบเสนอราคา (Quote ID) มีอายุ 30 นาที สำหรับนำไปใช้ออกออร์เดอร์ |
options[].carrierCode | string | รหัสขนส่งพันธมิตร: "FLASH", "SPX", "EMS", "KEX", "DHL" |
options[].serviceName | string | ชื่อบริการทางการ เช่น "Flash Express Standard", "SPX Delivery" |
options[].priceBaht | float | ค่าจัดส่งสุทธิหน่วยบาท รวมภาษีมูลค่าเพิ่ม (เช่น 23.54) |
options[].priceSatang | integer | ค่าจัดส่งหน่วยสตางค์ สำหรับคำนวณความแม่นยำสูง (เช่น 2354) |
options[].etaDays | string | ระยะเวลาจัดส่งโดยประมาณ (เช่น "1-2 วัน") |
options[].pickupSupported | boolean | รองรับบริการเรียกรถเข้ารับพัสดุถึงหน้าบ้านฟรีหรือไม่ (true / false) |
options[].codFeeBaht | float | ค่าธรรมเนียม COD (หากมีการระบุยอดเงินปลายทาง) |
POST Create order /shipments
สร้างออร์เดอร์พัสดุในระบบ SendDee พร้อมตัดยอดเงินจากกระเป๋าเงิน (Wallet) ทันที และส่งต่อคำสั่งซื้อไปยังระบบของบริษัทขนส่งพันธมิตรแบบ Real-time โดยระบบจะส่งคืนเลขพัสดุทางการ (Tracking Number), รหัสคัดแยกสายพาน (Sorting Code), สาขาปลายทาง (Destination Hub) และลิงก์ใบปะหน้ามาตรฐาน (Label URL) กลับมาในทันที
SendDee ทำหน้าที่เป็นพาร์ทเนอร์แพลตฟอร์มรวบรวมขนส่งชั้นนำในประเทศ (Logistics Aggregator) สำหรับรับคำขอและส่งข้อมูลพัสดุต่อไปยังบริษัทขนส่งที่คุณเลือก โดยระบบจะไม่มีการค้นหา เดา หรือเติมข้อมูลตำบล อำเภอ จังหวัดแทนผู้ใช้งานเป็นอันขาด
• ผู้พัฒนาและผู้ใช้งานต้องจัดเตรียมข้อมูลที่อยู่ต้นทาง (ผู้ส่ง) และปลายทาง (ผู้รับ) มาให้ครบถ้วนทุกฟิลด์ (ชื่อ, เบอร์โทรศัพท์, ที่อยู่ละเอียด, ตำบล/แขวง, อำเภอ/เขต, จังหวัด, และรหัสไปรษณีย์ 5 หลัก)
• หากกรอกหรือส่งข้อมูลผู้ส่งหรือผู้รับมาไม่ครบถ้วน: ระบบจะปฏิเสธคำขอและตอบกลับด้วยข้อผิดพลาด
400 Bad Request แจ้งเตือนรายการฟิลด์ที่ขาดหายทันทีตามมาตรฐานเดียวกับ Flash Express API
| ชื่อพารามิเตอร์ | Type | จำเป็น | คำอธิบาย & ข้อจำกัด |
|---|---|---|---|
carrier | string | Required | รหัสขนส่งพันธมิตรที่เลือก: "FLASH", "SPX", "EMS", "KEX", "DHL" |
sender | object | Required | ข้อมูลที่อยู่และผู้ติดต่อฝั่งต้นทาง (ดูโครงสร้างอ็อบเจกต์ด้านล่าง) |
recipient | object | Required | ข้อมูลที่อยู่และผู้ติดต่อฝั่งปลายทาง (ดูโครงสร้างอ็อบเจกต์ด้านล่าง) |
parcel | object | Required | ข้อมูลขนาด น้ำหนัก และประเภทสินค้า (ดูโครงสร้างอ็อบเจกต์ด้านล่าง) |
cod | object | Optional | ข้อมูลการเก็บเงินปลายทาง (ระบุเมื่อต้องการเปิดใช้ COD) |
merchantOrderId | string(64) | Optional | เลขออเดอร์อ้างอิงจากฝั่งระบบของคุณ เพื่อป้องกันการส่งคำขอซ้ำ (Idempotency) ห้ามซ้ำกับออร์เดอร์เดิม |
remark | string(200) | Optional | หมายเหตุการจัดส่งสำหรับแจ้งพนักงานขนส่ง (เช่น "วางไว้หน้าบ้าน", "ขึ้นบันไดชั้น 3") |
| ชื่อพารามิเตอร์ | Type | จำเป็น | คำอธิบาย |
|---|---|---|---|
name | string(50) | Required | ชื่อ-นามสกุล หรือชื่อร้านค้าผู้ส่ง |
phone | string(20) | Required | เบอร์โทรศัพท์ผู้ส่ง 10 หลัก (เช่น "0812345678") |
address | string(300) | Required | ที่อยู่โดยละเอียด (บ้านเลขที่, หมู่, ถนน, ซอย, ตึก/ห้อง) |
subdistrict | string(100) | Required | ตำบล / แขวง ต้นทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง) |
district | string(100) | Required | อำเภอ / เขต ต้นทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง) |
province | string(100) | Required | จังหวัด ต้นทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง) |
postalCode | string(5) | Required | รหัสไปรษณีย์ต้นทาง 5 หลัก (เช่น "10110") |
| ชื่อพารามิเตอร์ | Type | จำเป็น | คำอธิบาย |
|---|---|---|---|
name | string(50) | Required | ชื่อ-นามสกุล ผู้รับปลายทาง |
phone | string(20) | Required | เบอร์โทรศัพท์มือถือผู้รับ 10 หลัก สำหรับพนักงานขนส่งโทรติดต่อส่งของ |
homePhone | string(20) | Optional | เบอร์โทรศัพท์สำรองหรือเบอร์บ้าน |
address | string(300) | Required | ที่อยู่จัดส่งปลายทางโดยละเอียด |
subdistrict | string(100) | Required | ตำบล / แขวง ปลายทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง) |
district | string(100) | Required | อำเภอ / เขต ปลายทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง) |
province | string(100) | Required | จังหวัด ปลายทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง) |
postalCode | string(5) | Required | รหัสไปรษณีย์ปลายทาง 5 หลัก (เช่น "50000") |
| ชื่อพารามิเตอร์ | Type | จำเป็น | คำอธิบาย & ข้อจำกัด |
|---|---|---|---|
parcel.weightGrams | integer | Required | น้ำหนักพัสดุจริงหน่วยกรัม (1 ถึง 50,000 กรัม) เช่น 500 = 0.5 กก. |
parcel.widthCm | integer | Optional | ความกว้างของกล่องพัสดุหน่วยเซนติเมตร |
parcel.lengthCm | integer | Optional | ความยาวของกล่องพัสดุหน่วยเซนติเมตร |
parcel.heightCm | integer | Optional | ความสูงของกล่องพัสดุหน่วยเซนติเมตร |
parcel.itemName | string(200) | Optional | ชื่อหรือประเภทสินค้าภายในกล่อง เช่น "เสื้อผ้าแฟชั่น", "เครื่องสำอาง" |
parcel.declaredValueSatang | integer | Optional | มูลค่าสินค้าสำหรับทำประกันความเสียหายพัสดุ (หน่วยสตางค์: 100 สตางค์ = 1 บาท) |
cod.isCod | boolean | Optional | เปิดใช้บริการเก็บเงินปลายทางหรือไม่ (true หรือ false) |
cod.amount | float | Optional | ยอดเงินที่ต้องการให้พนักงานขนส่งเก็บจากผู้รับหน่วยบาท (เช่น 350.00) บังคับระบุเมื่อ isCod = true |
| ชื่อฟิลด์ | Type | คำอธิบาย |
|---|---|---|
id | string | รหัสอ้างอิงพัสดุเฉพาะของ SendDee เช่น "shp_98f12a3b7c4d" |
trackingNumber | string(20) | เลขพัสดุทางการจากขนส่ง (Courier Tracking Number) เช่น "TH01485938294B" นำไปเช็คสถานะหรือสแกนบาร์โค้ดได้ทันที |
carrier | string | รหัสผู้ให้บริการขนส่งที่ได้รับมอบหมาย เช่น "FLASH", "SPX" |
status | string | สถานะพัสดุเริ่มต้น: "created" (สร้างสำเร็จและรอขนส่งเข้ารับ) |
merchantOrderId | string(64) | เลขออเดอร์อ้างอิงของร้านค้าที่ส่งเข้ามา |
chargedAmountBaht | float | ยอดเงินค่าจัดส่งจริงที่ระบบหักชำระจาก SendDee Wallet (หน่วยบาท เช่น 23.54) |
walletBalanceRemaining | float | ยอดเงินคงเหลือในกระเป๋าเงิน SendDee Wallet หลังหักค่าส่งสำเร็จ |
labelUrl | string | ลิงก์ URL สำหรับเปิดดูและดาวน์โหลดไฟล์ใบปะหน้ามาตรฐาน (100x150 mm Thermal PDF) |
routing.sortCode | string(16) | รหัสคัดแยกสาขาปลายทางของขนส่ง (Destination Sort Code เช่น "16C-05B002-00" หรือ "N_B_5G_S21_ACMAI-B") |
routing.sortingLineCode | string(8) | รหัสสายพานคัดแยกสินค้าที่ศูนย์คัดแยกหลัก (เช่น "A03") |
routing.destinationStoreName | string(50) | ชื่อสาขาหรือศูนย์กระจายสินค้าปลายทาง (เช่น "TKU_SP-ทุ่งครุ") |
routing.destinationPostalCode | string(5) | รหัสไปรษณีย์ปลายทาง (เช่น "10140") |
createdAt | string | วันและเวลาที่ทำรายการสร้างพัสดุสำเร็จ รูปแบบ ISO-8601 UTC |
GET List orders /shipments
ค้นหาและดึงรายการประวัติคำสั่งซื้อพัสดุในระบบ กรองตามสถานะ ขนส่ง ช่วงวันที่ หรือเลขออร์เดอร์ร้านค้า พร้อมระบบแบ่งหน้า (Pagination)
| Parameter | Type | จำเป็น | คำอธิบาย |
|---|---|---|---|
page | integer | Optional | ลำดับหน้าที่ต้องการดู Default: 1 |
pageSize | integer | Optional | จำนวนรายการต่อหน้า สูงสุด 100 รายการ Default: 20 |
status | string | Optional | กรองตามสถานะ: "created", "in_transit", "delivered", "cancelled" |
carrier | string | Optional | กรองเฉพาะขนส่ง: "FLASH", "SPX", "EMS", "KEX" |
search | string | Optional | คำค้นหาอัจฉริยะ (เลขออเดอร์ร้านค้า merchantOrderId, เลขพัสดุ Tracking, หรือชื่อผู้รับ) |
startDate | string(10) | Optional | วันที่เริ่มต้นค้นหา รูปแบบ YYYY-MM-DD |
endDate | string(10) | Optional | วันที่สิ้นสุดค้นหา รูปแบบ YYYY-MM-DD |
| Field | Type | คำอธิบาย |
|---|---|---|
items[] | array | รายการออร์เดอร์พัสดุตามเงื่อนไขการค้นหา |
items[].id | string | รหัสพัสดุเฉพาะของ SendDee เช่น "shp_98f12a3b7c4d" |
items[].trackingNumber | string | เลขพัสดุของขนส่ง (Tracking No.) |
items[].carrier | string | ขนส่งที่จัดส่ง |
items[].status | string | สถานะพัสดุปัจจุบัน |
items[].chargedAmountBaht | float | ค่าจัดส่งจริงที่ชำระไป |
items[].recipientName | string | ชื่อผู้รับปลายทาง |
items[].createdAt | string | วันและเวลาที่สร้างออร์เดอร์ |
pagination.total | integer | จำนวนออร์เดอร์ทั้งหมดที่พบ |
pagination.page | integer | หน้าที่กำลังแสดงผล |
pagination.totalPages | integer | จำนวนหน้าทั้งหมด |
GET Tracking order /shipments/:id
ติดตามสถานะ ไทม์ไลน์การเดินทาง และประวัติการจัดส่งพัสดุแบบ Real-time โดยดึงสถานะตรงจากศูนย์คัดแยกของขนส่งพันธมิตร
| Parameter | Type | จำเป็น | คำอธิบาย |
|---|---|---|---|
:id | string | Required | รหัสพัสดุ SendDee (เช่น shp_98f12a3b7c4d) หรือเลข Tracking Number (เช่น TH01485938294B) |
| Field | Type | คำอธิบาย |
|---|---|---|
id | string | รหัสพัสดุ SendDee |
trackingNumber | string | เลขพัสดุของขนส่ง |
carrier | string | ขนส่งที่จัดส่ง (เช่น "FLASH", "SPX") |
status | string | สถานะหลัก: "created", "in_transit", "out_for_delivery", "delivered", "cancelled" |
carrierStatus | string | สถานะดิบจากขนส่งพันธมิตร |
routing | object | ข้อมูลคัดแยกสายส่ง (sortCode, sortingLineCode, destinationStoreName) |
events[] | array | ไทม์ไลน์ประวัติการเดินทางของพัสดุ เรียงจากใหม่ไปเก่า |
events[].status | string | รหัสสถานะในเหตุการณ์นั้น |
events[].description | string | คำอธิบายเหตุการณ์ เช่น "พนักงานรับพัสดุเข้าระบบแล้ว", "พัสดุถึงศูนย์กระจายสินค้าปลายทาง", "พนักงานกำลังนำจ่ายให้ผู้รับ" |
events[].occurredAt | string | วันและเวลาที่เกิดเหตุการณ์ (ISO-8601 UTC) |
events[].location | string / null | สถานที่หรือศูนย์คัดแยกที่บันทึกข้อมูล |
GET Print label /shipments/:id/universal-label
สร้างและดาวน์โหลดไฟล์ใบปะหน้าพัสดุมาตรฐาน SendDee Universal Label (ขนาดมาตรฐาน 100x150 mm / 4x6 นิ้ว) สำหรับสั่งพิมพ์ลงบนกระดาษสติกเกอร์ความร้อน (Direct Thermal) ได้ทันที โดยระบบจะนำข้อมูลผู้ส่ง, ผู้รับ, เลขพัสดุ, บาร์โค้ด และรหัสคัดแยกของขนส่งมาจัดวางลงในฟอร์มมาตรฐานให้โดยอัตโนมัติ
shp_98f12a3b7c4d) หรือเลข Tracking Number (เช่น TH01485938294B)pdf•
pdf — ไฟล์ PDF มาตรฐาน (100x150 mm) สำหรับเปิดพิมพ์ผ่าน Web Browser หรือไดรเวอร์เครื่องพิมพ์ความร้อนทุกรุ่น•
zpl — โค้ดคำสั่งภาษา Zebra Programming Language สำหรับเครื่องพิมพ์อุตสาหกรรม (Zebra / Honeywell)•
html — โค้ด HTML พร้อม CSS Responsive สำหรับแสดงพรีวิวบนหน้าจอเว็บหรือแอปพลิเคชัน•
png / svg — ภาพความละเอียดสูง
203 (ค่าเริ่มต้นทั่วไป) หรือ 300 (สำหรับหัวพิมพ์ความละเอียดสูง)1. Carrier Brand: โลโก้และชื่อขนส่งทางการ (Flash Express, SPX, Kerry, EMS, DHL) พร้อมประเภทบริการ
2. Destination Routing Code (รหัสคัดแยก): รหัสศูนย์กระจายสินค้าปลายทางของขนส่ง (เช่น
N_B_5G_S21_ACMAI-B) เพื่อให้พนักงานคัดแยกสายส่งได้อย่างรวดเร็ว3. Barcode & Tracking: บาร์โค้ด 1D มาตรฐานสากล (Code128) คมชัดระดับหัวพิมพ์ความร้อน พร้อมเลขพัสดุตัวใหญ่ สแกนติด 100%
4. Recipient (ข้อมูลผู้รับ): ชื่อผู้รับ, เบอร์โทรศัพท์ติดต่อ, ที่อยู่จัดส่ง และ รหัสไปรษณีย์ 5 หลักขนาดใหญ่พิเศษ
5. Sender (ข้อมูลผู้ส่ง): ชื่อร้านค้า, เบอร์โทรศัพท์ติดต่อ, ที่อยู่ต้นทาง
6. COD Highlight Box: หากมียอดเก็บเงินปลายทาง จะมีกรอบสีดำตัวหนาระบุยอดเงินชัดเจน เช่น
COD: ฿350.00 ป้องกันพนักงานลืมเรียกเก็บเงิน7. Parcel & Order Meta: น้ำหนักพัสดุ (กก./กรัม), ขนาด, วันที่สั่งซื้อ และเลขอ้างอิงร้านค้า (
merchantOrderId)
POST Batch Print Labels /shipments/labels/batch
สั่งพิมพ์ใบปะหน้าพัสดุหลายกล่องพร้อมกันในคำขอเดียว โดยระบบจะรวมทุกใบปะหน้าเป็นไฟล์ PDF ไฟล์เดียว พิมพ์รวดเดียวต่อเนื่อง
"pdf" รวมทุกใบลงในไฟล์ PDF เดียวPOST Cancel order /shipments/:id/cancel
ขอยกเลิกคำสั่งซื้อพัสดุก่อนที่ขนส่งจะสแกนเข้ารับพัสดุ โดยระบบจะทำการยกเลิกใบงานกับบริษัทขนส่งทันที และคืนเงินค่าจัดส่งเข้ากระเป๋า SendDee Wallet 100% เต็มจำนวนแบบ Real-time (Instant Refund)
created (ยังไม่ถูกพนักงานขนส่งสแกนรับขึ้นรถ)• การคืนเงิน: ยอดค่าจัดส่งทั้งหมดจะถูกโอนคืนเข้า SendDee Wallet ทันทีโดยไม่มีการหักค่าธรรมเนียมใดๆ ทั้งสิ้น
• พัสดุที่สแกนแล้ว: หากพนักงานขนส่งสแกนพัสดุเข้าระบบแล้ว (สถานะเปลี่ยนเป็น
in_transit) ระบบจะปฏิเสธการยกเลิกด้วย 400 Bad Request
| Parameter | Type | จำเป็น | คำอธิบาย |
|---|---|---|---|
:id | string | Required | รหัสพัสดุ SendDee (เช่น shp_98f12a3b7c4d) หรือเลข Tracking Number ที่ต้องการยกเลิก |
| Field | Type | คำอธิบาย |
|---|---|---|
success | boolean | ผลการยกเลิก: true เมื่อยกเลิกและคืนเงินสำเร็จ |
message | string | ข้อความแจ้งเตือน: "ยกเลิกคำสั่งซื้อและคืนเงินเรียบร้อยแล้ว" |
shipmentId | string | รหัสพัสดุที่ถูกยกเลิก |
trackingNumber | string | เลขพัสดุที่ถูกยกเลิก |
refundAmountBaht | float | ยอดเงินที่คืนเข้ากระเป๋าเงิน SendDee Wallet (หน่วยบาท เช่น 23.54) |
walletBalanceRemaining | float | ยอดเงินคงเหลือในกระเป๋าเงินล่าสุดหลังได้รับเงินคืน |
{
"carrier": "FLASH",
"merchantOrderId": "ORD-202611-0091",
"remark": "วางไว้หน้าบ้าน ขึ้นบันไดชั้น 2",
"sender": {
"name": "บริษัท แสนดี สโตร์ จำกัด",
"phone": "0812345678",
"address": "123/45 ถนนสุขุมวิท คลองเตย กทม.",
"subdistrict": "คลองเตย",
"district": "คลองเตย",
"province": "กรุงเทพมหานคร",
"postalCode": "10110"
},
"recipient": {
"name": "สมชาย ใจดี",
"phone": "0898765432",
"homePhone": "021234567",
"address": "99 หมู่ 2 ตำบลสุเทพ เชียงใหม่",
"subdistrict": "สุเทพ",
"district": "เมืองเชียงใหม่",
"province": "เชียงใหม่",
"postalCode": "50000"
},
"parcel": {
"weightGrams": 500,
"widthCm": 15,
"lengthCm": 20,
"heightCm": 10,
"itemName": "เสื้อยืดคอกลมคอตตอน 100%",
"declaredValueSatang": 35000
},
"cod": {
"isCod": true,
"amount": 350.00
}
}{
"statusCode": 400,
"error": "BadRequestException",
"message": "ข้อมูลผู้ส่งหรือผู้รับไม่ครบถ้วน (Incomplete address data): กรุณาระบุข้อมูลให้ครบถ้วนทุกฟิลด์ (ชื่อ, เบอร์โทรศัพท์, ที่อยู่, ตำบล/แขวง, อำเภอ/เขต, จังหวัด, รหัสไปรษณีย์) ตามโครงสร้าง API (มาตรฐานเดียวกับ Flash Express)",
"missingFields": [
"recipient.subdistrict",
"recipient.district",
"recipient.province"
]
}{
"code": 200,
"status": "success",
"message": "Shipment created successfully",
"data": {
"id": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"status": "created",
"merchantOrderId": "ORD-202611-0091",
"chargedAmountBaht": 23.54,
"walletBalanceRemaining": 50098.46,
"labelUrl": "https://open-api.senddee.com/api/v1/shipments/shp_98f12a3b7c4d/universal-label?format=pdf",
"routing": {
"sortCode": "16C-05B002-00",
"sortingLineCode": "A03",
"destinationStoreName": "TKU_SP-ทุ่งครุ",
"destinationPostalCode": "50000",
"originPostalCode": "10110"
},
"createdAt": "2026-11-19T04:15:30Z"
}
}# ดาวน์โหลดไฟล์ PDF ใบปะหน้าสำหรับพิมพ์ลงกระดาษความร้อน 100x150 มม.
curl -X GET "https://open-api.senddee.com/api/v1/shipments/shp_98f12a3b7c4d/universal-label?format=pdf" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output label-shp_98f12a3b7c4d.pdfPOST /api/v1/shipments/labels/batch
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"shipmentIds": [
"shp_98f12a3b7c4d",
"shp_77a19c2e4f88",
"shp_33b52d1a9e60"
],
"format": "pdf"
}curl -X GET "https://open-api.senddee.com/api/v1/shipments?page=1&pageSize=20&status=created" \
-H "Authorization: Bearer YOUR_API_KEY"curl -X GET "https://open-api.senddee.com/api/v1/shipments/TH01485938294B" \
-H "Authorization: Bearer YOUR_API_KEY"{
"code": 200,
"status": "success",
"data": {
"trackingNumber": "TH01485938294B",
"carrier": "FLASH",
"status": "in_transit",
"routing": {
"sortCode": "16C-05B002-00",
"destinationStoreName": "TKU_SP-ทุ่งครุ"
},
"events": [
{
"status": "IN_TRANSIT",
"description": "พัสดุถึงศูนย์คัดแยกสินค้าหลัก (BKK HUB)",
"occurredAt": "2026-11-19T06:30:00Z",
"location": "กรุงเทพมหานคร"
},
{
"status": "PICKED_UP",
"description": "พนักงานเข้ารับพัสดุจากผู้ส่งเรียบร้อยแล้ว",
"occurredAt": "2026-11-19T04:45:00Z",
"location": "คลองเตย กทม."
}
]
}
}curl -X POST "https://open-api.senddee.com/api/v1/shipments/shp_98f12a3b7c4d/cancel" \
-H "Authorization: Bearer YOUR_API_KEY"{
"code": 200,
"status": "success",
"message": "ยกเลิกคำสั่งซื้อและคืนเงินเรียบร้อยแล้ว",
"data": {
"shipmentId": "shp_98f12a3b7c4d",
"trackingNumber": "TH01485938294B",
"refundAmountBaht": 23.54,
"walletBalanceRemaining": 50122.00
}
}Courier Pickup Service
ระบบเรียกรถเข้ารับพัสดุ (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 }
]
}