Hủy vận đơn J&T Express — API J&T Express

order.cancelOrder

POST/order/cancelOrderGọi qua 360: POST https://partner.quantri360.com/v1/jtexpress/order/cancelOrder

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.

Endpoint ghi — thay đổi dữ liệu trên J&T Express. Key phải được tạo với tick "Cho phép gọi API ghi", nếu không sẽ nhận 403 write_not_allowed. Mỗi lần gọi được ghi nhật ký.

Mô tả API

Hủy vận đơn J&T theo mã đơn của bạn.

Request

Địa chỉ

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

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 (đã gửi khi tạo).
billCode	body	string	Không		Mã vận đơn J&T.
reason	body	string	Có	Khách đổi ý	Lý do hủy.

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/jtexpress/order/cancelOrder" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"txlogisticId":"DH1001","reason":"Khách đổi ý"}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/jtexpress/order/cancelOrder",
    params={},
    json={
        "txlogisticId": "DH1001",
        "reason": "Khách đổi ý"
    },
    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/cancelOrder');
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","reason":"Khách đổi ý"}),
});
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/cancelOrder' . '?' . 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","reason":"Khách đổi ý"}');
$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	Mã đơn của bạn.

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