Tra hành trình vận đơn J&T Express — API J&T Express

logistics.trace

POST/logistics/traceGọi qua 360: POST https://partner.quantri360.com/v1/jtexpress/logistics/trace

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

Hành trình vận đơn: từng lần quét (lấy hàng, nhập / xuất kho, đang giao, đã ký nhận, hoàn…) kèm bưu cục, nhân viên, ảnh ký nhận.

Request

Địa chỉ

POST https://partner.quantri360.com/v1/jtexpress/logistics/trace

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ả
billCodes	body	string	Có	842800765741	Mã vận đơn, nhiều mã cách dấu phẩy — tối đa 30. Đơn nhiều kiện: kiện con tra riêng bằng mã kiện con.
txlogisticId	body	string	Không		Mã đơn của bạn (có thể để trống khi đã có billCodes).
billcodes	body	string	Có		Bắt buộc.

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/jtexpress/logistics/trace" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"billCodes":"842800765741"}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/jtexpress/logistics/trace",
    params={},
    json={
        "billCodes": "842800765741"
    },
    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/logistics/trace');
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({"billCodes":"842800765741"}),
});
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/logistics/trace' . '?' . 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, '{"billCodes":"842800765741"}');
$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.
msg	string	success
data	object[]		Mỗi vận đơn một phần tử.
billCode	string	842800765741
details	object[]		Các lần quét.
scanTime	string	2024-06-05 15:57:04	Thời điểm quét (giờ Việt Nam).
scanTypeCode	int	113	106 lấy hàng · 109 gửi đi · 110 đến kho · 112 xuất kho đi giao · 113 ký nhận · 116 xác nhận hoàn · 117 hoàn thành công · 118 / 120 kiện có vấn đề.
scanTypeName	string	Ký nhận
desc	string		Mô tả (tiếng Việt).
scanNetworkName	string		Bưu cục quét.
scanNetworkProvince	string
scanNetworkCity	string
scanNetworkArea	string
staffName	string		Nhân viên.
staffContact	string
pictureUrl	string[]		Ảnh ký nhận / ảnh kiện có vấn đề.
weight	string		Trọng lượng tính cước cuối (kg).

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