SendDee Gateway v1.0 Production Online

Open-API Reference

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

บริการหลักของ SendDee API
  • Rate Inquiry: ตรวจสอบและเปรียบเทียบค่าจัดส่งแบบ Real-time ตามน้ำหนักและขนาดพัสดุ
  • Shipment Creation: สร้างออร์เดอร์พัสดุ ตัดยอดเงินจากกระเป๋าเงิน และออกเลข Tracking Number ทันที
  • Thermal Shipping Labels: สร้างไฟล์ใบปะหน้าพัสดุมาตรฐาน (PDF / ZPL) รองรับเครื่องพิมพ์ความร้อนทุกรุ่น
  • Courier Pickup: ส่งคำขอนัดหมายเรียกรถขนส่งเข้ารับพัสดุถึงหน้าบ้านหรือคลังสินค้า
  • Real-time Tracking & Webhooks: ติดตามสถานะพัสดุและรับแจ้งเตือนสถานะการจัดส่งอัตโนมัติผ่าน Webhook
GATEWAY BASE URL (PROD)
https://open-api.senddee.com/api/v1
GATEWAY BASE URL (TEST)
https://open-api-test.senddee.com/api/v1
HEALTH CHECK (cURL)
curl -I https://open-api-test.senddee.com/health

API Reference

ระบบ SendDee API ทำงานบนมาตรฐาน RESTful สื่อสารผ่านโปรโตคอล HTTPS ข้อมูลคำขอและคำตอบอยู่ในรูปแบบ JSON

API Environment

EnvironmentBase URLคำอธิบาย
Production https://open-api.senddee.com/api/v1 สภาพแวดล้อมใช้งานจริง รองรับการสร้างพัสดุจริงและตัดยอดเงินในกระเป๋าจริง
Test https://open-api-test.senddee.com/api/v1 สภาพแวดล้อมทดสอบ พัสดุจำลอง ไม่มีการตัดเงินจริง

มาตรฐานการสื่อสารระบบ (SendDee Protocols)

มาตรฐานข้อกำหนดรายละเอียด
ProtocolHTTPS / TLS 1.3คำขอทั้งหมดต้องส่งผ่านการเข้ารหัส TLS 1.2 หรือ TLS 1.3 เท่านั้น
Data FormatRESTful JSONระบุ Header Content-Type: application/json; charset=utf-8
TimestampUnix Epoch Secondsเวลาปัจจุบันของเซิร์ฟเวอร์หน่วยวินาที (10 หลัก UTC+7) เช่น 1731931500
CurrencyTHB (Satang / Baht)คำนวณแบบสตางค์ (Minor Unit) เพื่อความแม่นยำสูงสุดทางบัญชี
IdempotencyIdempotency-Keyรองรับการส่งคีย์กันคำขอซ้ำ ป้องกันการสร้างพัสดุซ้ำซ้อนกรณี Network Timeout

รูปแบบข้อมูลตอบกลับ (Unified JSON Envelope)

คำตอบทุกรายการจาก SendDee API ถูกห่อหุ้มด้วยโครงสร้างมาตรฐานเดียวกัน (Unified JSON Envelope):

FieldTypeDescription
codeintegerรหัสสถานะการทำงาน (200 = สำเร็จ, 400+ = ผิดพลาด)
statusstringสถานะผลลัพธ์: "success" หรือ "error"
messagestringข้อความอธิบายผลลัพธ์หรือสาเหตุของข้อผิดพลาด
dataobject / nullข้อมูลผลลัพธ์ของ API (กรณี Error ฟิลด์นี้จะมีค่าเป็น null)

Notices

• Rate Limiting: โควต้าการเรียกใช้งานเริ่มต้นอยู่ที่ 120 คำขอต่อนาที (120 req/min) ต่อหนึ่ง API Key
• Idempotency: สำหรับ Endpoint สร้างพัสดุ แนะนำให้ส่งฟิลด์ merchantOrderId เพื่อป้องกันการสร้างพัสดุซ้ำกรณี Network Timeout
BASE REQUEST HEADERS
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json; charset=utf-8
Accept: application/json
UNIFIED SUCCESS ENVELOPE (JSON)
{
  "code": 200,
  "status": "success",
  "message": "Operation completed successfully",
  "data": {
    "balanceSatang": 5009846,
    "balanceBaht": 50098.46
  }
}
UNIFIED ERROR ENVELOPE (JSON)
{
  "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%

โครงสร้างยืนยันตัวตน 2 ส่วน (Two-Part Authentication Architecture)

ระบบ SendDee ใช้โครงสร้างความปลอดภัยระดับ Enterprise มาตรฐานเดียวกับ Flash Express Open API ซึ่งกำหนดให้ต้องใช้ข้อมูลยืนยันตัวตน 2 ส่วนประกอบกันเสมอ จึงจะสามารถสร้างออร์เดอร์พัสดุ (Create Shipment) หรือยิงคำขอเข้าระบบได้:

  • ส่วนที่ 1: รหัสร้านค้า (Merchant Code / Customer Code / mchId): คือรหัสประจำตัวร้านค้าของคุณ (เช่น SD559274) ซึ่งสามารถดูและคัดลอกได้จากหน้าตั้งค่า "API & นักพัฒนา" โดยส่งผ่าน Header X-SendDee-App-Id (หรือระบุใน Request Body ด้วยฟิลด์ mchId)
  • ส่วนที่ 2: API Key (Sign Key / Secret Token): คือกุญแจความปลอดภัย (เช่น sd_live_...) ที่กดขอรับได้จากหน้าตั้งค่า API ของร้านค้า ใช้ส่งผ่าน Header Authorization: Bearer YOUR_API_KEY หรือใช้เป็น Key ลับในการคำนวณลายเซ็นดิจิทัล (Signature)

ระบบจะตรวจสอบความสัมพันธ์ของทั้งสองส่วนอย่างเคร่งครัด หากรหัสลูกค้ากับ API Key ไม่ตรงกัน หรือส่งข้อมูลไม่ครบทั้ง 2 ส่วน ระบบจะปฏิเสธคำขอด้วยสถานะ 403 Forbidden ทันทีเพื่อป้องกันการยิงออร์เดอร์แอบอ้างข้ามร้านค้า 100%

โหมดการยืนยันตัวตน 2 รูปแบบ (Authentication Modes)

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

พารามิเตอร์ยืนยันตัวตนขั้นสูง (SendDee Protocol Headers)
X-SendDee-App-Id string Required
รหัสร้านค้าของคุณในระบบ SendDee เช่น SD559274 (ดูได้จากเมนูตั้งค่า "API & นักพัฒนา") หรือส่งใน Request Body ด้วยฟิลด์ mchId
X-SendDee-Timestamp integer Required
เวลาปัจจุบันของเซิร์ฟเวอร์หน่วยวินาที (Unix Timestamp 10 หลัก) ระบบจำกัดความคลาดเคลื่อนไม่เกิน 300 วินาที
X-SendDee-Nonce string(16..64) Required
สตริงสุ่มความยาวไม่ต่ำกว่า 16 ตัวอักษร เพื่อป้องกันการนำคำขอเดิมมายิงซ้ำ (Anti-Replay)
X-SendDee-Signature string(64) Required
ลายเซ็นดิจิทัลที่ผ่านการคำนวณด้วยอัลกอริทึมเข้ารหัส SHA-256 (UPPERCASE 64 ตัวอักษร)

SendDee Cryptographic Protocol (SDCP)

ขั้นตอนการคำนวณลายเซ็นดิจิทัลของ SendDee ประกอบด้วย 4 ขั้นตอนทางคณิตศาสตร์อย่างเคร่งครัด:

1. การรวบรวมและกรองข้อมูล (Filter & Cleanse)

นำฟิลด์ข้อมูลใน Request Body ทั้งหมดมารวมกัน หากฟิลด์ใดมีค่าเป็นค่าว่าง ("") หรือ null ให้ตัดออก และห้ามนำฟิลด์ลายเซ็นมาร่วมคำนวณ

2. การจัดเรียงพารามิเตอร์แบบ Canonical (ASCII Key Sorting)

นำชื่อฟิลด์มาเรียงตามลำดับตัวอักษร ASCII (A-Z, a-z) จากน้อยไปมาก แล้วเชื่อมต่อกันด้วยเครื่องหมาย & ในรูปแบบ key1=value1&key2=value2... จะได้ canonicalPayload

3. การต่อท้ายด้วย SendDee App Secret (Secret Binding)

นำ canonicalPayload มาต่อท้ายด้วย &secret= ตามด้วย App Secret ประจำร้านค้าของคุณ จะได้ payloadToSign

4. การสร้างลายเซ็นดิจิทัล SHA-256 (Cryptographic Hash)

นำ 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 Upgrade)

ระบบรองรับการอัปเกรดบัญชีร้านค้าจาก SD เป็น CO เพื่อผูกข้อมูลบริษัท เลขประจำตัวผู้เสียภาษี 13 หลัก และระบบหัก ณ ที่จ่าย (WHT 3%):

POST /api/v1/orgs/current/upgrade-corporate

• Seamless Code Transition: เมื่ออัปเกรดสำเร็จ ระบบจะออกรหัส 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: 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)
SENDDEE SIGNED REQUEST (HEADERS)
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: BF46380E893F6B8F5486D2EDFE265BB8942C6A9BD5C897E34373734CE08B4B67
SENDDEE SDK: NODE.JS / TYPESCRIPT
import 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();
}
SENDDEE SDK: PHP / WOOCOMMERCE
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));
}
SENDDEE SDK: PYTHON / ERP
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

เรียกดูยอดเงินคงเหลือและวงเงินเครดิตของร้านค้า

Request Headers
Authorization string Required
รูปแบบ Bearer YOUR_API_KEY
Accept string Required
ระบุ application/json
Response Data Fields
balanceSatang integer
ยอดเงินคงเหลือหน่วยสตางค์ (เช่น 5009846 = 50,098.46 บาท) สำหรับคำนวณแบบแม่นยำสูง
balanceBaht float
ยอดเงินคงเหลือหน่วยบาท ทศนิยม 2 ตำแหน่ง (เช่น 50098.46)
accountStatus string
สถานะบัญชีกระเป๋าเงิน: "active" (ปกติ) หรือ "frozen"
REQUEST EXAMPLE (cURL)
curl -X GET "https://open-api.senddee.com/api/v1/wallet/balance"   -H "Authorization: Bearer YOUR_API_KEY"
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

Request Body Parameters
fromZip string(5) Required
รหัสไปรษณีย์ต้นทาง (ผู้ส่ง) เช่น "10110"
toZip string(5) Required
รหัสไปรษณีย์ปลายทาง (ผู้รับ) เช่น "50000"
weightGrams integer Required
น้ำหนักพัสดุจริงหน่วยกรัม (เช่น 500 = 0.5 กก.)
codAmount float Optional
ยอดเงินเก็บเงินปลายทาง (หากมี) เพื่อคำนวณค่าธรรมเนียม COD
Response Data Fields (เรทราคาค่าจัดส่งทุกขนส่ง)
FieldTypeคำอธิบาย
quoteIdstringรหัสอ้างอิงใบเสนอราคา (Quote ID) มีอายุ 30 นาที สำหรับนำไปใช้ออกออร์เดอร์
options[].carrierCodestringรหัสขนส่งพันธมิตร: "FLASH", "SPX", "EMS", "KEX", "DHL"
options[].serviceNamestringชื่อบริการทางการ เช่น "Flash Express Standard", "SPX Delivery"
options[].priceBahtfloatค่าจัดส่งสุทธิหน่วยบาท รวมภาษีมูลค่าเพิ่ม (เช่น 23.54)
options[].priceSatangintegerค่าจัดส่งหน่วยสตางค์ สำหรับคำนวณความแม่นยำสูง (เช่น 2354)
options[].etaDaysstringระยะเวลาจัดส่งโดยประมาณ (เช่น "1-2 วัน")
options[].pickupSupportedbooleanรองรับบริการเรียกรถเข้ารับพัสดุถึงหน้าบ้านฟรีหรือไม่ (true / false)
options[].codFeeBahtfloatค่าธรรมเนียม COD (หากมีการระบุยอดเงินปลายทาง)

POST Create order /shipments

สร้างออร์เดอร์พัสดุในระบบ SendDee พร้อมตัดยอดเงินจากกระเป๋าเงิน (Wallet) ทันที และส่งต่อคำสั่งซื้อไปยังระบบของบริษัทขนส่งพันธมิตรแบบ Real-time โดยระบบจะส่งคืนเลขพัสดุทางการ (Tracking Number), รหัสคัดแยกสายพาน (Sorting Code), สาขาปลายทาง (Destination Hub) และลิงก์ใบปะหน้ามาตรฐาน (Label URL) กลับมาในทันที

ข้อกำหนดโครงสร้างข้อมูลที่อยู่ผู้ส่งและผู้รับ (Strict Party Address Policy)
มาตรฐานความสมบูรณ์ของข้อมูล (Zero-Enrichment Policy):
SendDee ทำหน้าที่เป็นพาร์ทเนอร์แพลตฟอร์มรวบรวมขนส่งชั้นนำในประเทศ (Logistics Aggregator) สำหรับรับคำขอและส่งข้อมูลพัสดุต่อไปยังบริษัทขนส่งที่คุณเลือก โดยระบบจะไม่มีการค้นหา เดา หรือเติมข้อมูลตำบล อำเภอ จังหวัดแทนผู้ใช้งานเป็นอันขาด
• ผู้พัฒนาและผู้ใช้งานต้องจัดเตรียมข้อมูลที่อยู่ต้นทาง (ผู้ส่ง) และปลายทาง (ผู้รับ) มาให้ครบถ้วนทุกฟิลด์ (ชื่อ, เบอร์โทรศัพท์, ที่อยู่ละเอียด, ตำบล/แขวง, อำเภอ/เขต, จังหวัด, และรหัสไปรษณีย์ 5 หลัก)
• หากกรอกหรือส่งข้อมูลผู้ส่งหรือผู้รับมาไม่ครบถ้วน: ระบบจะปฏิเสธคำขอและตอบกลับด้วยข้อผิดพลาด 400 Bad Request แจ้งเตือนรายการฟิลด์ที่ขาดหายทันทีตามมาตรฐานเดียวกับ Flash Express API
1. Request Parameters (พารามิเตอร์หลัก)
ชื่อพารามิเตอร์Typeจำเป็นคำอธิบาย & ข้อจำกัด
carrierstringRequiredรหัสขนส่งพันธมิตรที่เลือก: "FLASH", "SPX", "EMS", "KEX", "DHL"
senderobjectRequiredข้อมูลที่อยู่และผู้ติดต่อฝั่งต้นทาง (ดูโครงสร้างอ็อบเจกต์ด้านล่าง)
recipientobjectRequiredข้อมูลที่อยู่และผู้ติดต่อฝั่งปลายทาง (ดูโครงสร้างอ็อบเจกต์ด้านล่าง)
parcelobjectRequiredข้อมูลขนาด น้ำหนัก และประเภทสินค้า (ดูโครงสร้างอ็อบเจกต์ด้านล่าง)
codobjectOptionalข้อมูลการเก็บเงินปลายทาง (ระบุเมื่อต้องการเปิดใช้ COD)
merchantOrderIdstring(64)Optionalเลขออเดอร์อ้างอิงจากฝั่งระบบของคุณ เพื่อป้องกันการส่งคำขอซ้ำ (Idempotency) ห้ามซ้ำกับออร์เดอร์เดิม
remarkstring(200)Optionalหมายเหตุการจัดส่งสำหรับแจ้งพนักงานขนส่ง (เช่น "วางไว้หน้าบ้าน", "ขึ้นบันไดชั้น 3")
2. โครงสร้างอ็อบเจกต์ผู้ส่ง (sender)
ชื่อพารามิเตอร์Typeจำเป็นคำอธิบาย
namestring(50)Requiredชื่อ-นามสกุล หรือชื่อร้านค้าผู้ส่ง
phonestring(20)Requiredเบอร์โทรศัพท์ผู้ส่ง 10 หลัก (เช่น "0812345678")
addressstring(300)Requiredที่อยู่โดยละเอียด (บ้านเลขที่, หมู่, ถนน, ซอย, ตึก/ห้อง)
subdistrictstring(100)Requiredตำบล / แขวง ต้นทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง)
districtstring(100)Requiredอำเภอ / เขต ต้นทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง)
provincestring(100)Requiredจังหวัด ต้นทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง)
postalCodestring(5)Requiredรหัสไปรษณีย์ต้นทาง 5 หลัก (เช่น "10110")
3. โครงสร้างอ็อบเจกต์ผู้รับ (recipient)
ชื่อพารามิเตอร์Typeจำเป็นคำอธิบาย
namestring(50)Requiredชื่อ-นามสกุล ผู้รับปลายทาง
phonestring(20)Requiredเบอร์โทรศัพท์มือถือผู้รับ 10 หลัก สำหรับพนักงานขนส่งโทรติดต่อส่งของ
homePhonestring(20)Optionalเบอร์โทรศัพท์สำรองหรือเบอร์บ้าน
addressstring(300)Requiredที่อยู่จัดส่งปลายทางโดยละเอียด
subdistrictstring(100)Requiredตำบล / แขวง ปลายทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง)
districtstring(100)Requiredอำเภอ / เขต ปลายทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง)
provincestring(100)Requiredจังหวัด ปลายทาง (จำเป็นต้องระบุ ห้ามเว้นว่าง)
postalCodestring(5)Requiredรหัสไปรษณีย์ปลายทาง 5 หลัก (เช่น "50000")
4. โครงสร้างอ็อบเจกต์พัสดุและบริการเสริม (parcel & cod)
ชื่อพารามิเตอร์Typeจำเป็นคำอธิบาย & ข้อจำกัด
parcel.weightGramsintegerRequiredน้ำหนักพัสดุจริงหน่วยกรัม (1 ถึง 50,000 กรัม) เช่น 500 = 0.5 กก.
parcel.widthCmintegerOptionalความกว้างของกล่องพัสดุหน่วยเซนติเมตร
parcel.lengthCmintegerOptionalความยาวของกล่องพัสดุหน่วยเซนติเมตร
parcel.heightCmintegerOptionalความสูงของกล่องพัสดุหน่วยเซนติเมตร
parcel.itemNamestring(200)Optionalชื่อหรือประเภทสินค้าภายในกล่อง เช่น "เสื้อผ้าแฟชั่น", "เครื่องสำอาง"
parcel.declaredValueSatangintegerOptionalมูลค่าสินค้าสำหรับทำประกันความเสียหายพัสดุ (หน่วยสตางค์: 100 สตางค์ = 1 บาท)
cod.isCodbooleanOptionalเปิดใช้บริการเก็บเงินปลายทางหรือไม่ (true หรือ false)
cod.amountfloatOptionalยอดเงินที่ต้องการให้พนักงานขนส่งเก็บจากผู้รับหน่วยบาท (เช่น 350.00) บังคับระบุเมื่อ isCod = true
5. Response Parameters (ข้อมูลตอบกลับในฟิลด์ data)
ชื่อฟิลด์Typeคำอธิบาย
idstringรหัสอ้างอิงพัสดุเฉพาะของ SendDee เช่น "shp_98f12a3b7c4d"
trackingNumberstring(20)เลขพัสดุทางการจากขนส่ง (Courier Tracking Number) เช่น "TH01485938294B" นำไปเช็คสถานะหรือสแกนบาร์โค้ดได้ทันที
carrierstringรหัสผู้ให้บริการขนส่งที่ได้รับมอบหมาย เช่น "FLASH", "SPX"
statusstringสถานะพัสดุเริ่มต้น: "created" (สร้างสำเร็จและรอขนส่งเข้ารับ)
merchantOrderIdstring(64)เลขออเดอร์อ้างอิงของร้านค้าที่ส่งเข้ามา
chargedAmountBahtfloatยอดเงินค่าจัดส่งจริงที่ระบบหักชำระจาก SendDee Wallet (หน่วยบาท เช่น 23.54)
walletBalanceRemainingfloatยอดเงินคงเหลือในกระเป๋าเงิน SendDee Wallet หลังหักค่าส่งสำเร็จ
labelUrlstringลิงก์ URL สำหรับเปิดดูและดาวน์โหลดไฟล์ใบปะหน้ามาตรฐาน (100x150 mm Thermal PDF)
routing.sortCodestring(16)รหัสคัดแยกสาขาปลายทางของขนส่ง (Destination Sort Code เช่น "16C-05B002-00" หรือ "N_B_5G_S21_ACMAI-B")
routing.sortingLineCodestring(8)รหัสสายพานคัดแยกสินค้าที่ศูนย์คัดแยกหลัก (เช่น "A03")
routing.destinationStoreNamestring(50)ชื่อสาขาหรือศูนย์กระจายสินค้าปลายทาง (เช่น "TKU_SP-ทุ่งครุ")
routing.destinationPostalCodestring(5)รหัสไปรษณีย์ปลายทาง (เช่น "10140")
createdAtstringวันและเวลาที่ทำรายการสร้างพัสดุสำเร็จ รูปแบบ ISO-8601 UTC

GET List orders /shipments

ค้นหาและดึงรายการประวัติคำสั่งซื้อพัสดุในระบบ กรองตามสถานะ ขนส่ง ช่วงวันที่ หรือเลขออร์เดอร์ร้านค้า พร้อมระบบแบ่งหน้า (Pagination)

Query Parameters (ตัวกรองค้นหา)
ParameterTypeจำเป็นคำอธิบาย
pageintegerOptionalลำดับหน้าที่ต้องการดู Default: 1
pageSizeintegerOptionalจำนวนรายการต่อหน้า สูงสุด 100 รายการ Default: 20
statusstringOptionalกรองตามสถานะ: "created", "in_transit", "delivered", "cancelled"
carrierstringOptionalกรองเฉพาะขนส่ง: "FLASH", "SPX", "EMS", "KEX"
searchstringOptionalคำค้นหาอัจฉริยะ (เลขออเดอร์ร้านค้า merchantOrderId, เลขพัสดุ Tracking, หรือชื่อผู้รับ)
startDatestring(10)Optionalวันที่เริ่มต้นค้นหา รูปแบบ YYYY-MM-DD
endDatestring(10)Optionalวันที่สิ้นสุดค้นหา รูปแบบ YYYY-MM-DD
Response Data Fields
FieldTypeคำอธิบาย
items[]arrayรายการออร์เดอร์พัสดุตามเงื่อนไขการค้นหา
items[].idstringรหัสพัสดุเฉพาะของ SendDee เช่น "shp_98f12a3b7c4d"
items[].trackingNumberstringเลขพัสดุของขนส่ง (Tracking No.)
items[].carrierstringขนส่งที่จัดส่ง
items[].statusstringสถานะพัสดุปัจจุบัน
items[].chargedAmountBahtfloatค่าจัดส่งจริงที่ชำระไป
items[].recipientNamestringชื่อผู้รับปลายทาง
items[].createdAtstringวันและเวลาที่สร้างออร์เดอร์
pagination.totalintegerจำนวนออร์เดอร์ทั้งหมดที่พบ
pagination.pageintegerหน้าที่กำลังแสดงผล
pagination.totalPagesintegerจำนวนหน้าทั้งหมด

GET Tracking order /shipments/:id

ติดตามสถานะ ไทม์ไลน์การเดินทาง และประวัติการจัดส่งพัสดุแบบ Real-time โดยดึงสถานะตรงจากศูนย์คัดแยกของขนส่งพันธมิตร

Path Parameter
ParameterTypeจำเป็นคำอธิบาย
:idstringRequiredรหัสพัสดุ SendDee (เช่น shp_98f12a3b7c4d) หรือเลข Tracking Number (เช่น TH01485938294B)
Response Data Fields (สถานะและประวัติการเดินทาง)
FieldTypeคำอธิบาย
idstringรหัสพัสดุ SendDee
trackingNumberstringเลขพัสดุของขนส่ง
carrierstringขนส่งที่จัดส่ง (เช่น "FLASH", "SPX")
statusstringสถานะหลัก: "created", "in_transit", "out_for_delivery", "delivered", "cancelled"
carrierStatusstringสถานะดิบจากขนส่งพันธมิตร
routingobjectข้อมูลคัดแยกสายส่ง (sortCode, sortingLineCode, destinationStoreName)
events[]arrayไทม์ไลน์ประวัติการเดินทางของพัสดุ เรียงจากใหม่ไปเก่า
events[].statusstringรหัสสถานะในเหตุการณ์นั้น
events[].descriptionstringคำอธิบายเหตุการณ์ เช่น "พนักงานรับพัสดุเข้าระบบแล้ว", "พัสดุถึงศูนย์กระจายสินค้าปลายทาง", "พนักงานกำลังนำจ่ายให้ผู้รับ"
events[].occurredAtstringวันและเวลาที่เกิดเหตุการณ์ (ISO-8601 UTC)
events[].locationstring / nullสถานที่หรือศูนย์คัดแยกที่บันทึกข้อมูล

สร้างและดาวน์โหลดไฟล์ใบปะหน้าพัสดุมาตรฐาน SendDee Universal Label (ขนาดมาตรฐาน 100x150 mm / 4x6 นิ้ว) สำหรับสั่งพิมพ์ลงบนกระดาษสติกเกอร์ความร้อน (Direct Thermal) ได้ทันที โดยระบบจะนำข้อมูลผู้ส่ง, ผู้รับ, เลขพัสดุ, บาร์โค้ด และรหัสคัดแยกของขนส่งมาจัดวางลงในฟอร์มมาตรฐานให้โดยอัตโนมัติ

Path Parameter
:id string Required
รหัสพัสดุ SendDee (เช่น shp_98f12a3b7c4d) หรือเลข Tracking Number (เช่น TH01485938294B)
Query Parameters (ตัวเลือกการพิมพ์)
format string Optional
รูปแบบไฟล์ที่ต้องการ ค่าเริ่มต้นคือ pdf
• pdf — ไฟล์ PDF มาตรฐาน (100x150 mm) สำหรับเปิดพิมพ์ผ่าน Web Browser หรือไดรเวอร์เครื่องพิมพ์ความร้อนทุกรุ่น
• zpl — โค้ดคำสั่งภาษา Zebra Programming Language สำหรับเครื่องพิมพ์อุตสาหกรรม (Zebra / Honeywell)
• html — โค้ด HTML พร้อม CSS Responsive สำหรับแสดงพรีวิวบนหน้าจอเว็บหรือแอปพลิเคชัน
• png / svg — ภาพความละเอียดสูง
dpi integer Optional
ความละเอียดหัวพิมพ์ความร้อน: 203 (ค่าเริ่มต้นทั่วไป) หรือ 300 (สำหรับหัวพิมพ์ความละเอียดสูง)
ข้อมูลที่ปรากฏบนใบปะหน้าพัสดุ (Label Contents)
ผู้ใช้งานไม่ต้องส่งข้อมูลผู้ส่ง/ผู้รับซ้ำตอนสั่งพิมพ์ ระบบจะดึงข้อมูลจากการสร้างออร์เดอร์มาร้อยเรียงลงบนใบปะหน้ามาตรฐานดังนี้:
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 ไฟล์เดียว พิมพ์รวดเดียวต่อเนื่อง

Request Body Parameters
shipmentIds array<string> Required
รายการรหัสพัสดุที่ต้องการพิมพ์พร้อมกัน (สูงสุด 100 รายการต่อคำขอ)
format string Optional
ค่าเริ่มต้นคือ "pdf" รวมทุกใบลงในไฟล์ PDF เดียว

POST Cancel order /shipments/:id/cancel

ขอยกเลิกคำสั่งซื้อพัสดุก่อนที่ขนส่งจะสแกนเข้ารับพัสดุ โดยระบบจะทำการยกเลิกใบงานกับบริษัทขนส่งทันที และคืนเงินค่าจัดส่งเข้ากระเป๋า SendDee Wallet 100% เต็มจำนวนแบบ Real-time (Instant Refund)

ข้อกำหนดและเงื่อนไขการยกเลิก (Cancellation Rules)
• เงื่อนไขเวลา: สามารถกดยกเลิกได้เฉพาะพัสดุที่ยังอยู่ในสถานะ created (ยังไม่ถูกพนักงานขนส่งสแกนรับขึ้นรถ)
• การคืนเงิน: ยอดค่าจัดส่งทั้งหมดจะถูกโอนคืนเข้า SendDee Wallet ทันทีโดยไม่มีการหักค่าธรรมเนียมใดๆ ทั้งสิ้น
• พัสดุที่สแกนแล้ว: หากพนักงานขนส่งสแกนพัสดุเข้าระบบแล้ว (สถานะเปลี่ยนเป็น in_transit) ระบบจะปฏิเสธการยกเลิกด้วย 400 Bad Request
Path Parameter
ParameterTypeจำเป็นคำอธิบาย
:idstringRequiredรหัสพัสดุ SendDee (เช่น shp_98f12a3b7c4d) หรือเลข Tracking Number ที่ต้องการยกเลิก
Response Data Fields (ผลการยกเลิกและคืนเงิน)
FieldTypeคำอธิบาย
successbooleanผลการยกเลิก: true เมื่อยกเลิกและคืนเงินสำเร็จ
messagestringข้อความแจ้งเตือน: "ยกเลิกคำสั่งซื้อและคืนเงินเรียบร้อยแล้ว"
shipmentIdstringรหัสพัสดุที่ถูกยกเลิก
trackingNumberstringเลขพัสดุที่ถูกยกเลิก
refundAmountBahtfloatยอดเงินที่คืนเข้ากระเป๋าเงิน SendDee Wallet (หน่วยบาท เช่น 23.54)
walletBalanceRemainingfloatยอดเงินคงเหลือในกระเป๋าเงินล่าสุดหลังได้รับเงินคืน
CREATE ORDER REQUEST (JSON)
{
  "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
  }
}
VALIDATION ERROR (400 BAD REQUEST)
{
  "statusCode": 400,
  "error": "BadRequestException",
  "message": "ข้อมูลผู้ส่งหรือผู้รับไม่ครบถ้วน (Incomplete address data): กรุณาระบุข้อมูลให้ครบถ้วนทุกฟิลด์ (ชื่อ, เบอร์โทรศัพท์, ที่อยู่, ตำบล/แขวง, อำเภอ/เขต, จังหวัด, รหัสไปรษณีย์) ตามโครงสร้าง API (มาตรฐานเดียวกับ Flash Express)",
  "missingFields": [
    "recipient.subdistrict",
    "recipient.district",
    "recipient.province"
  ]
}
CREATE ORDER RESPONSE (200 OK)
{
  "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"
  }
}
PRINT LABEL (cURL / BROWSER)
# ดาวน์โหลดไฟล์ 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.pdf
BATCH PRINT (JSON)
POST /api/v1/shipments/labels/batch
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "shipmentIds": [
    "shp_98f12a3b7c4d",
    "shp_77a19c2e4f88",
    "shp_33b52d1a9e60"
  ],
  "format": "pdf"
}
LIST ORDERS (cURL)
curl -X GET "https://open-api.senddee.com/api/v1/shipments?page=1&pageSize=20&status=created" \
  -H "Authorization: Bearer YOUR_API_KEY"
TRACKING ORDER (cURL)
curl -X GET "https://open-api.senddee.com/api/v1/shipments/TH01485938294B" \
  -H "Authorization: Bearer YOUR_API_KEY"
TRACKING RESPONSE (200 OK)
{
  "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": "คลองเตย กทม."
      }
    ]
  }
}
CANCEL ORDER & REFUND (cURL)
curl -X POST "https://open-api.senddee.com/api/v1/shipments/shp_98f12a3b7c4d/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"
CANCEL RESPONSE (200 OK)
{
  "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

ส่งคำขอนัดหมายเรียกรถขนส่งเข้ารับพัสดุ ณ ที่อยู่ต้นทาง

Request Body Parameters
carrier string Required
ขนส่งที่ต้องการให้เข้ารับ: "FLASH", "SPX", "EMS", "JNT"
pickupDate string(10) Required
วันที่นัดหมายให้เข้ารับ (YYYY-MM-DD) เช่น "2026-11-19"
pickupTimeSlot string Required
ช่วงเวลา: "09:00-12:00" หรือ "13:00-17:00"
senderName string Required
ชื่อผู้ติดต่อ ณ จุดเข้ารับพัสดุ
senderPhone string Required
เบอร์โทรศัพท์ติดต่อสำหรับคนขับรถโทรประสานงาน
pickupAddress string Required
ที่อยู่จุดเข้ารับอย่างละเอียด (บ้านเลขที่ ซอย ถนน ตำบล อำเภอ จังหวัด)
postalCode string(5) Required
รหัสไปรษณีย์จุดเข้ารับ เช่น "10110"
estimatedParcels integer Required
จำนวนพัสดุโดยประมาณที่ต้องการส่งมอบในรอบนี้ (ชิ้น)

GET List pickups /pickups

ตรวจสอบรายการและประวัติการเรียกรถขนส่งเข้ารับ พร้อมสถานะพนักงานขับรถและจำนวนพัสดุที่เข้ารับจริง

Query Parameters
page integer Optional
ลำดับหน้าที่ต้องการเรียกดู Default: 1
pageSize integer Optional
จำนวนรายการต่อหน้า (สูงสุด 50) Default: 10
carrier string Optional
กรองเฉพาะขนส่ง: FLASH, SPX, EMS, JNT
status string Optional
กรองตามสถานะ: scheduled, assigned, in_progress, completed, cancelled
Response Data Fields
items[].pickupTicketId string
เลขที่ใบงานนัดหมายเรียกรถ (เช่น "PK-20261119-0042")
items[].carrier string
ขนส่งที่นัดหมายเข้ารับ
items[].status string
สถานะใบงาน (ดูตารางความหมายสถานะด้านล่าง)
items[].pickupDate string
วันที่นัดเข้ารับพัสดุ (YYYY-MM-DD)
items[].pickupTimeSlot string
ช่วงเวลานัดหมาย (เช่น "13:00-17:00")
items[].estimatedParcels integer
จำนวนพัสดุที่แจ้งนัดหมายไว้
items[].actualParcels integer / null
จำนวนพัสดุที่พนักงานสแกนรับจริง (จะมีค่าเมื่อเข้ารับสำเร็จ)
items[].driverName string / null
ชื่อพนักงานขับรถขนส่งที่ได้รับมอบหมายงาน
items[].driverPhone string / null
เบอร์โทรศัพท์ติดต่อพนักงานขับรถ
ตารางความหมายสถานะการเรียกรถ (Pickup Status Definitions)
Statusชื่อสถานะคำอธิบายและการดำเนินการ
scheduledนัดหมายสำเร็จคำขอส่งไปยังขนส่งแล้ว รอจัดสรรคนขับ
assignedจัดสรรคนขับแล้วขนส่งกำหนดคนขับรถแล้ว พร้อมเบอร์โทรคนขับ
in_progressกำลังเดินทางพนักงานขับรถกำลังเดินทางมายังจุดรับพัสดุ
completedเข้ารับสำเร็จพนักงานสแกนพัสดุขึ้นรถเรียบร้อย พร้อมบันทึกจำนวนจริง
cancelledยกเลิกใบงานถูกยกเลิก
NOTIFY COURIER REQUEST (JSON)
{
  "carrier": "FLASH",
  "pickupDate": "2026-11-19",
  "pickupTimeSlot": "13:00-17:00",
  "senderName": "บริษัท แสนดี สโตร์ จำกัด",
  "senderPhone": "0812345678",
  "pickupAddress": "123/45 ถนนสุขุมวิท แขวงคลองเตย เขตคลองเตย กทม.",
  "postalCode": "10110",
  "estimatedParcels": 25,
  "remark": "อยู่หน้าโกดัง A3 ประตูกระจก"
}
LIST PICKUPS RESPONSE (200 OK)
{
  "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-2569A4B8C...

Web hook events

Event Nameหมวดหมู่คำอธิบายเหตุการณ์
order.createdShipmentสร้างออร์เดอร์สำเร็จและออกเลขพัสดุเรียบร้อย
order.picked_upShipmentพนักงานขนส่งสแกนรับพัสดุเข้าสาขาต้นทางแล้ว
order.in_transitShipmentพัสดุอยู่ระหว่างการขนส่งระหว่างศูนย์คัดแยก
order.out_for_deliveryShipmentพนักงานนำจ่ายกำลังนำพัสดุออกไปส่งให้ผู้รับ
order.deliveredShipmentพัสดุจัดส่งสำเร็จ ผู้รับเซ็นรับเรียบร้อยแล้ว
order.problemShipmentพัสดุเกิดปัญหาการจัดส่ง (เช่น ติดต่อผู้รับไม่ได้)
order.returnedShipmentพัสดุตีกลับถึงผู้ส่งต้นทางเรียบร้อยแล้ว
EXAMPLE WEBHOOK PAYLOAD (JSON)
{
  "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สถานะภาษาไทยเงื่อนไขและจุดเปลี่ยนสถานะ
1createdสร้างออร์เดอร์แล้วตัดเงินสำเร็จ ออกเลข Tracking Number และใบปะหน้า
2picked_upเข้ารับพัสดุแล้วพนักงานสแกนรับพัสดุเข้าสาขาต้นทาง
3in_transitอยู่ระหว่างขนส่งพัสดุอยู่ระหว่างการเคลื่อนย้ายผ่านศูนย์คัดแยกหลัก
4out_for_deliveryกำลังนำจ่ายพัสดุถึงสาขาปลายทาง และพนักงานนำจ่ายนำพัสดุออกไปส่ง
5Adeliveredจัดส่งสำเร็จผู้รับเซ็นรับพัสดุเรียบร้อย
5Bproblemพัสดุติดปัญหาติดต่อผู้รับไม่ได้ หรือขอเลื่อนนัดส่ง (ขนส่งพยายามส่งซ้ำ 3 ครั้ง)
6returnedตีกลับต้นทางพัสดุส่งไม่สำเร็จเกิน 3 ครั้ง และถูกตีกลับถึงผู้ส่ง

Constants

Response Code

CodeHTTPMessageคำอธิบาย
200200Successคำขอทำงานสำเร็จสมบูรณ์
400400Bad Requestข้อมูลคำขอไม่ถูกต้องหรือพารามิเตอร์ไม่ครบถ้วน
401401UnauthorizedAPI Key หรือลายเซ็นไม่ถูกต้อง หรือเวลาหมดอายุ
422422Unprocessableยอดเงินในกระเป๋าไม่พอ หรือข้อมูลไม่สามารถประมวลผลได้
1001401Invalid Signatureการคำนวณลายเซ็นดิจิทัล SHA-256 ไม่ถูกต้อง
1002401Timestamp Expiredเวลาในคำขอห่างจากเซิร์ฟเวอร์เกิน 300 วินาที
2001422Insufficient Balanceยอดเงินในกระเป๋าไม่พอสำหรับการตัดค่าส่ง

Carrier List

Carrier Codeชื่อบริษัทขนส่งบริการที่รองรับการเรียกรถเข้ารับ (Pickup)
FLASHFlash ExpressStandard, COD, Speed, Bulkyรองรับเรียกรถเข้ารับฟรีถึงหน้าบ้าน/คลังสินค้า
SPXShopee Express (SPX)Standard, CODรองรับทั้ง Drop-off สาขา และเรียกรถเข้ารับ
EMSไปรษณีย์ไทย EMSStandard, COD, ทั่วไทย 100%รองรับ Drop-off ทุกที่ทำการไปรษณีย์
JNTJ&T ExpressStandard, CODเปิดบริการ 365 วันไม่มีวันหยุด
ERROR RESPONSE (2001 INSUFFICIENT BALANCE)
{
  "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"
  }
}
SUPPORTED CARRIERS 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 }
  ]
}