Statistics by product — API Pancake POS

get /shops/{SHOP_ID}/inventory_analytics/inventory_by_product

GET/shops/{SHOP_ID}/inventory_analytics/inventory_by_productGọi qua 360: GET https://partner.quantri360.com/v1/pancake_pos/shops/{SHOP_ID}/inventory_analytics/inventory_by_product

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

Báo cáo xuất nhập tồn THEO SẢN PHẨM (gộp mọi mẫu mã của sản phẩm) trong kỳ — cùng các cột như báo cáo theo mẫu mã. Dùng cho báo cáo NXT cấp mã cha.

Xuất là số ÂM như báo cáo theo mẫu mã.

Request

Địa chỉ

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

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.
start_date	query	int	Có	1790787600	Đầu kỳ (Unix giây).
end_date	query	int	Có	1793466000	Cuối kỳ (Unix giây).
type	query	string	Có	actual	`actual` tồn thực · `remain` có thể bán.
page	query	int	Không	1
page_size	query	int	Không	30
warehouse_ids[]	query	string[]	Không		Lọc kho.
product_ids[]	query	string[]	Không		Lọc sản phẩm.
category_ids[]	query	int[]	Không		Lọc danh mục.

Phân trang

Tăng page tới total_pages (cửa hàng thử: 7.275 sản phẩm).

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_pos/shops/1234567/inventory_analytics/inventory_by_product?start_date=1790787600&end_date=1793466000&type=actual&page=1&page_size=100" \
  -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/inventory_analytics/inventory_by_product",
    params={
        "start_date": 1790787600,
        "end_date": 1793466000,
        "type": "actual",
        "page": 1,
        "page_size": 100
    },
    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/inventory_analytics/inventory_by_product');
for (const [k, v] of Object.entries({"start_date":1790787600,"end_date":1793466000,"type":"actual","page":1,"page_size":100})) 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/inventory_analytics/inventory_by_product' . '?' . http_build_query(['start_date' => 1790787600, 'end_date' => 1793466000, 'type' => 'actual', 'page' => 1, 'page_size' => 100]);
$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[]		Một dòng / sản phẩm.
id / product_id	string		Mã sản phẩm.
begin_inventory / end_inventory	number		Tồn đầu / cuối.
total_import / total_export	number		Tổng nhập / xuất (xuất ÂM).
purchase_import, return_import, stocktaking_import, transfer_import, sell_export, transfer_export, stocktaking_export, purchase_export	number		Như báo cáo theo mẫu mã.
…_value	int		Giá trị VND theo giá vốn.
product	object		name, custom_id, display_id, category_ids, images, inserted_at.
page_number / page_size / total_pages / total_entries	int

Mẫu phản hồi

{
  "success": true,
  "data": [
    {
      "id": "fffaef9f-91b4-4fcc-a03d-c61084d50000",
      "product_id": "fffaef9f-91b4-4fcc-a03d-c61084d50000",
      "product": {
        "name": "Quần ống côn",
        "custom_id": "33860000",
        "display_id": 2779,
        "category_ids": [
          40619
        ]
      },
      "begin_inventory": 0,
      "end_inventory": 0,
      "total_import": 0,
      "total_export": 0,
      "sell_export": 0,
      "total_import_value": 0,
      "total_export_value": 0,
      "begin_inventory_value": 0,
      "end_inventory_value": 0
    }
  ],
  "page_size": 100,
  "total_pages": 73,
  "page_number": 1,
  "total_entries": 7275
}

Bắt đầu dùng

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