API in đơn hàng
API dùng để in nhãn đơn hàng
info
Nhãn đơn hàng là tem nhãn được dán lên kiện hàng, ghi rõ các thông tin quan trọng của đơn hàng gồm: mã vận đơn, mã vạch, thông tin sản phẩm, phương thức vận chuyển....
- Cung cấp 2 mẫu nhãn đơn hàng, gồm: khổ dọc và khổ ngang
- Kích thước hỗ trợ : A5 hoặc A6 (Mặc định )
Request
Đường dẫn
GET /api/v1/orders/{TRACKING_ORDER}/label
Headers
Authorization: Bearer {JWT}
X-Client-Source: {PARTNER_CODE}
Content-Type: application/json
Tham số
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| TRACKING_ORDER | Có | Mã vận đơn |
Code
- CURL
- HTTP
curl --location --globoff '{{url}}/api/v1/orders/{TRACKING_ORDER}/label' \
--header 'Authorization: Bearer d6824A005D576e3e18741E0b2A55e608B4e59A0e' \
--header 'X-Client-Source: mwg'
GET /services/label/{TRACKING_ORDER} HTTP/1.1
Token: {API_TOKEN}
X-Client-Source: {PARTNER_CODE}
Phản hồi
Kết quả trả về
Hệ thống sẽ trả về kết quả dưới dạng binary file PDF. Kết quả trả về được mô tả như sau:
Thành công
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=""
Content-Transfer-Encoding: binary
Trường hợp có lỗi
Kết quả sẽ trả về với định dạng JSON
{
"status": 400,
"message": "Mã vận đơn không hợp lệ, không tìm thấy vận đơn",
"error_code": 4010502,
"timestamp": "2025-10-10T15:36:56.794Z"
}