Nhất Tín LogisticsDevelopers
API ReferenceVận đơn

Cập nhật vận đơn

Cập nhật vận đơn đối với đơn trong trạng thái Chưa thành công (1) và Chờ lấy hàng (2).

Cấu hình API

HTTP Request

POST: /v3/bill/update-shipping

No.Tham sốLoạiBắt buộcMô tả
1bill_codeStringTrueMã Bill
2cod_amountDoubleSố tiền COD thu khi giao hàng cho người nhận.
3cargo_valueDoubleGiá trị hàng hoá
4weightDoubleTrọng lượng hàng hoá
5lengthDoubleDài
6heightDoubleCao
7widthDoubleRộng
8cargo_contentStringMô tả sơ về hàng hóa của đơn vận chuyển
9receiver_phoneStringSố điện thoại người nhận
10receiver_nameStringTên người nhận
11receiver_addressStringĐịa chỉ đầy đủ của người nhận (phải đúng định dạng: 52A Nguyễn Thái Bình).
12package_noNumberSố kiện
13is_return_docNumberCó chuyển hoàn chứng từ không (1: Có; 0: Không; Mặc định để 0)
14noteStringGhi chú đơn hàng, lưu ý khi vận chuyển hàng hóa/ giao hàng
15is_installationNumberĐơn có hỗ trợ lắp đặt khi giao hàng không (1: Có; 0: Không; Mặc định để 0)

JSON body respone

TênLoạiMô tả
successbooleanTrả về true nếu cập nhật vận đơn thành công, tất cả các giá trị false khác có nghĩa là lỗi. Xem message để biết thêm mô tả.
messagestringTrả về thông điệp của phản hồi API.
dataobjectDữ liệu của phản hồi API.

Mẫu yêu cầu (Request example)

{
   "bill_code": "TEST-009",
   "cod_amount": 200000,
   "is_return_doc": 0
}

Phản hồi (Response)

{
    "success": true,
    "message": "Update successful",
    "data": {
        "bill_id": 159839,
        "bill_code": "CP15983901",
        "ref_code": "TEST-009",
        "status_id": 2,
        "cod_amount": 200000,
        "service_id": 10,
        "payment_method": 10,
        "created_at": "2022-12-01 15:31:30",
        "main_fee": 33462,
        "cod_fee": 0,
        "insurr_fee": 5500,
        "lifting_fee": 0,
        "remote_fee": 0,
        "counting_fee": 0,
        "packing_fee": 0,
        "total_fee": 38962,
        "partner_address_id": 24371,
        "receiver_name": "Nguyễn Văn A",
        "receiver_phone": "09xxxxxxxx",
        "receiver_address": "52A, Nguyễn Thái Bình, P4, Tân Bình, TP.HCM",
        "package_no": 1,
        "weight": 1.3,
        "cargo_content": "Quần áo",
        "cargo_value": 1000000,
        "note": "ghi chú đơn hàng"
    }
}

mẫu phản hồi thất bại (Response Failed)

{
    "success": false,
    "message": "descriptions for detail error",
    "data": {}
}

Cập nhật lần cuối vào ngày 10 tháng 7, 2025

On this page