List of debt — API Pancake POS

get /shops/{SHOP_ID}/debt

GET/shops/{SHOP_ID}/debtGọi qua 360: GET https://partner.quantri360.com/v1/pancake_pos/shops/{SHOP_ID}/debt

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

Danh sách công nợ (phải thu khách / phải trả NCC): số tiền phải thu-trả, đã thu-trả, hạn, đơn hoặc phiếu nhập liên quan, khách. Dùng để theo dõi khách nợ COD / nợ đơn và nợ NCC.

Gọi thật: 1 khoản, các trường phân trang = null.
Khoản nợ tự sinh "tiền khách nợ đơn hàng" thực tế có type = 0 — đừng chỉ dựa vào type; xác định đối tượng bằng shop_customer_id (khách) hoặc supplier_products_id (NCC).
Có tên + SĐT khách trong shop_customer.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/pancake_pos/shops/{SHOP_ID}/debt

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	1234567	SHOP_ID đã nối — có thể bỏ khi đường dẫn có /shops/{SHOP_ID}.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
SHOP_ID	path	integer	Có	1234567	Mã cửa hàng đã nối với 360.
page	query	int	Không	1
page_size	query	int	Không	30
status	query	int	Không	-1	`-1` tất cả · `0` chưa giao dịch / thanh toán một phần · `1` đã giao dịch · `2` đã hủy.
shop_customer_id	query	string	Không	96a8e283-…	Lọc theo khách.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_pos/shops/1234567/debt?page=1&page_size=30&status=-1" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/pancake_pos/shops/1234567/debt",
    params={
        "page": 1,
        "page_size": 30,
        "status": -1
    },
    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/pancake_pos/shops/1234567/debt');
for (const [k, v] of Object.entries({"page":1,"page_size":30,"status":-1})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/pancake_pos/shops/1234567/debt' . '?' . http_build_query(['page' => 1, 'page_size' => 30, 'status' => -1]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$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 Pancake POS)

Tên	Kiểu	Mẫu	Mô tả
success	bool	true
data	object[]		Khoản nợ.
id	string		Mã (UUID).
display_id	int	1	Số hiển thị.
name_debt	string	Công nợ tạo tự động
description	string		Mô tả (vd "…tiền khách nợ đơn hàng #4117").
status	int	0	Như tham số status.
type	int	0	Loại công nợ (`0` phải trả / `1` phải thu — xem ghi chú).
money_must_pay_or_collect	int	0	Tổng phải trả / phải thu (VND).
money_payed_or_collected	int	0	Đã trả / đã thu.
order_id	int		Đơn liên quan.
order	object		id, display_id, cod, total_price, assigning_seller_id.
purchase_id / export_id / transaction_id	string		Phiếu liên quan.
shop_customer_id	string
shop_customer	object		Khách: id, name, phone_numbers[], customer{fb_id, psid}.
supplier_products_id	int		NCC.
expired_at	string		Hạn thanh toán (UTC).
payment_date	string
inserted_at / updated_at	string		UTC.
sum / page_number / page_size / total_pages / total_entries		null	Gọi thật: đều null.

Mẫu phản hồi

{
  "success": true,
  "data": [
    {
      "id": "c0bee728-3b9d-4218-8517-b5a108b10000",
      "display_id": 1,
      "name_debt": "Công nợ tạo tự động",
      "description": "Công nợ được tạo tự động từ tiền khách nợ đơn hàng #4117",
      "status": 0,
      "type": 0,
      "money_must_pay_or_collect": 0,
      "money_payed_or_collected": 0,
      "order_id": 464290000,
      "order": {
        "id": 464290000,
        "display_id": 4117,
        "cod": 902300,
        "total_price": 902300
      },
      "shop_customer_id": "8815b3f4-…",
      "shop_customer": {
        "id": "8815b3f4-…",
        "name": "Khách hàng A",
        "phone_numbers": [
          "0901234567"
        ]
      },
      "expired_at": "2024-07-11T07:24:25",
      "inserted_at": "2024-06-11T07:24:25"
    }
  ],
  "sum": null,
  "page_size": null,
  "total_pages": null,
  "page_number": null,
  "total_entries": null
}

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Tài chính ở trang nền tảng
Tạo API key (tick kênh Pancake POS)
Gọi theo ví dụ ở trên