Hóa đơn bán lẻ / xuất nhập kho — API Nhanh.vn

nhanh.v3.0.bill.list

Request

Địa chỉ

Xác thực & gian hàng

Tham số request

Phân trang

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/nhanh/v3.0/bill/list" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":{"type":2,"modes":[2],"fromDate":"2026-10-27","toDate":"2026-10-27"},"paginator":{"size":100},"dataOptions":{"giftProducts":true,"tags":true}}'

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/nhanh/v3.0/bill/list",
    params={},
    json={
        "filters": {
            "type": 2,
            "modes": [
                2
            ],
            "fromDate": "2026-10-27",
            "toDate": "2026-10-27"
        },
        "paginator": {
            "size": 100
        },
        "dataOptions": {
            "giftProducts": True,
            "tags": True
        }
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/nhanh/v3.0/bill/list');
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({"filters":{"type":2,"modes":[2],"fromDate":"2026-10-27","toDate":"2026-10-27"},"paginator":{"size":100},"dataOptions":{"giftProducts":true,"tags":true}}),
});
console.log(r.status, await r.json());

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/nhanh/v3.0/bill/list' . '?' . 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, '{"filters":{"type":2,"modes":[2],"fromDate":"2026-10-27","toDate":"2026-10-27"},"paginator":{"size":100},"dataOptions":{"giftProducts":true,"tags":true}}');
$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 Nhanh.vn)

Mẫu phản hồi

{
  "code": 1,
  "paginator": {
    "next": {
      "id": 246489501
    }
  },
  "data": [
    {
      "id": 246000003,
      "orderId": 0,
      "requirementBillId": 0,
      "inventoryCheckId": 0,
      "warrantyBillId": 0,
      "depotId": 100001,
      "date": "2026-10-27",
      "type": 2,
      "mode": 2,
      "related": {
        "type": 0,
        "parentId": 0,
        "billId": 0,
        "businessId": 0,
        "depotId": 0,
        "requirementBillId": 0,
        "userId": 0
      },
      "customer": {
        "id": 158000001,
        "name": "nguoimua123",
        "mobile": "0901234567",
        "address": "Số 1 đường ABC, Long Biên, Hà Nội"
      },
      "created": {
        "id": 2800001,
        "name": "Nhân viên mẫu",
        "createdAt": 1793110151
      },
      "sale": {
        "id": 3200001,
        "name": "Nhân viên A",
        "saleBonus": 0
      },
      "technicalStaff": {
        "id": 0
      },
      "supplier": {
        "id": 0
      },
      "products": [
        {
          "imexId": 631000001,
          "id": 40000001,
          "code": "SPMAU006-Màu 1-39",
          "barcode": "17000001",
          "name": "Áo sơ mi nam dài tay ( Perfect fit)/SPMAU006/Màu 1 - Kẻ tăm xanh/39/MAU01",
          "quantity": 1,
          "price": 500000,
          "priceVatMode": 2,
          "discount": 100000,
          "vat": {
            "percent": 0,
            "amount": 0
          },
          "extendedWarrantyAmount": 0,
          "amount": 400000,
          "imei": [],
          "giftProducts": [
            {
              "productId": 37000001,
              "productName": "Túi đóng gói lớn",
              "productCode": "TH4",
              "productQuantity": 1
            }
          ]
        }
      ],
      "payment": {
        "amount": 400000,
        "customerAmount": 400000,
        "discount": 100000,
        "points": 4000,
        "usedPoints": {
          "points": 0,
          "amount": 0
        },
        "transfer": {
          "accountId": 0,
          "amount": 0
        },
        "cash": {
          "accountId": 790001,
          "amount": 400000
        },
        "installment": {
          "accountId": 0,
          "amount": 0
        },
        "credit": {
          "accountId": 0,
          "amount": 0
        },
        "coupon": {
          "value": 0,
          "amount": 0
        },
        "returnFee": 0,
        "returnAmount": 0
      },
      "description": "BEST PRICE END OF SS khách mới",
      "tags": [],
      "gifts": [],
      "customerSource": {
        "id": 0
      }
    }
  ]
}

Bắt đầu dùng

1. Đăng ký tài khoản Partner
2. Mở loại dữ liệu thuộc nhóm Hóa đơn bán lẻ ở trang nền tảng
3. Tạo API key (tick kênh Nhanh.vn)
4. Gọi theo ví dụ ở trên