NAV Navbar
SENDDEE API v1.0
Developer Documentation

Open-API Reference

ยินดีต้อนรับสู่ SendDee Open-API Reference เอกสารมาตรฐานการเชื่อมต่อระบบขนส่งและโลจิสติกส์แบบครบวงจร ออกแบบมาสำหรับนักพัฒนาซอฟต์แวร์ ผู้พัฒนาระบบ ERP, WMS, POS, แพลตฟอร์มอีคอมเมิร์ซ และระบบจัดการร้านค้าออนไลน์ เพื่อให้สามารถเชื่อมต่อบริการขนส่งชั้นนำทั่วประเทศได้อย่างรวดเร็ว แม่นยำ และปลอดภัย

บริการหลักที่รองรับผ่าน SendDee Open-API ได้แก่:

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"
      }
    ]
  }
}

สร้างและดาวน์โหลดไฟล์ใบปะหน้าพัสดุมาตรฐาน รองรับขนาดสติกเกอร์สำหรับเครื่องพิมพ์ความร้อน (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 }
  ]
}