Danh sách hóa đơn bán lẻ

  • API này dùng để lấy danh sách hoá đơn bán lẻ: hóa đơn bán lẻ

  • Chú ý:

    • Hệ thống chỉ hỗ trợ lấy hóa đơn trong khoảng 31 ngày.

    • Nếu bạn không truyền param createdAtFrom mặc định sẽ lấy 31 ngày gần nhất. Nếu bạn muốn lấy dữ liệu các ngày cũ hơn, xin vui lòng truyền createdAtFrom và createdAtTo trong khoảng 31 ngày, VD: 2025-08-01 => 2025-08-31.

    • Khi lọc theo id, customerId hoặc customerMobile thì có thể bỏ qua khoảng ngày.

Request

curl --location 'https://pos.open.nhanh.vn/v3.0/bill/retail?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "filters": {
    },
     "paginator": {
        "size": 50,
        "next": {"id": 100}
    },
    "dataOptions": {}
}'

Filters

Key
Type
Description

id

int

ID phiếu

depotIds

array

Mảng ID kho hàng

type

int

Loại xuất nhập kho 1 = Nhập kho 2 = Xuất kho

orderIds

array

Mảng ID đơn hàng (chỉ hỗ trợ lọc tối đa 100 ID đơn hàng)

customerId

int

ID khách hàng

customerMobile

string

Số điện thoại khách hàng

fromDate

date

Ngày xuất kho từ. Định dạng yyyy-mm-dd (ví dụ: 2025-07-16)

toDate

date

Ngày xuất kho đến. Định dạng yyyy-mm-dd (ví dụ: 2025-08-16)

Paginator

DataOptions

  • Dữ liệu cần lấy thêm:

Key
Type
Description

giftProducts

int

Lấy thông tin quà tặng của sản phẩm trong xuất nhập kho

tags

int

Lấy nhãn được gắn cho xuất nhập kho

Response

Failed response

Successful response

Last updated