In vận đơn J&T Express (PDF) — API J&T Express

order.printOrder

POST/order/printOrderGọi qua 360: POST https://partner.quantri360.com/v1/jtexpress/order/printOrder

Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.

Mô tả API

Lấy nhãn vận đơn để in theo mã đơn của bạn — trả file PDF dạng base64 (và link ảnh với đơn nhiều kiện).

base64EncodeContent là PDF mã hóa base64 — giải mã rồi lưu .pdf hoặc gửi máy in.

Request

Địa chỉ

POST https://partner.quantri360.com/v1/jtexpress/order/printOrder

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	TEST001	apiAccount J&T đã nối (GET /v1/platforms). Có thể bỏ.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
txlogisticId	body	string	Có	DH1001	Mã đơn của bạn.
templateSize	body	string	Không	A6	Khổ nhãn: `K80` 74×80mm (mặc định) · `A7` 75×100 · `A6` 100×150 · `A5` 148×210 · `A4` 210×297; đơn nhiều kiện thêm M: `A6M`, `K80M`…
subBillCodes	body	string[]	Không		Đơn nhiều kiện: chỉ in các kiện con này.

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/jtexpress/order/printOrder" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"txlogisticId":"DH1001","templateSize":"A6"}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/jtexpress/order/printOrder",
    params={},
    json={
        "txlogisticId": "DH1001",
        "templateSize": "A6"
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/jtexpress/order/printOrder');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"txlogisticId":"DH1001","templateSize":"A6"}),
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/jtexpress/order/printOrder' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"txlogisticId":"DH1001","templateSize":"A6"}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của J&T Express)

Tên	Kiểu	Mẫu	Mô tả
code	string	1	`"1"` = thành công; mã khác = lỗi, xem `msg` (J&T trả HTTP 200 kèm mã lỗi).
msg	string	success	Thông báo kết quả.
data	object		Dữ liệu.
billCode	string		Mã vận đơn.
txlogisticId	string	DH1001
base64EncodeContent	string		File PDF nhãn, mã hóa base64.
urlContent	string		Đơn nhiều kiện: link ảnh nhãn kiện mẹ (PDF).

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Vận đơn ở trang nền tảng
Tạo API key (tick kênh J&T Express)
Gọi theo ví dụ ở trên