Customer overview report — API Pancake POS

get /shops/{SHOP_ID}/customer_analytics/report

Request

Địa chỉ

Xác thực & gian hàng

Tham số request

Phân trang

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_pos/shops/1234567/customer_analytics/report?startDate=1790787600&endDate=1793206799&page=1&pageSize=30" \
  -H "Authorization: Bearer $KEY"

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/pancake_pos/shops/1234567/customer_analytics/report",
    params={
        "startDate": 1790787600,
        "endDate": 1793206799,
        "page": 1,
        "pageSize": 30
    },
    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/pancake_pos/shops/1234567/customer_analytics/report');
for (const [k, v] of Object.entries({"startDate":1790787600,"endDate":1793206799,"page":1,"pageSize":30})) 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
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/pancake_pos/shops/1234567/customer_analytics/report' . '?' . http_build_query(['startDate' => 1790787600, 'endDate' => 1793206799, 'page' => 1, 'pageSize' => 30]);
$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)

Mẫu phản hồi

{
  "success": true,
  "data": {
    "customer": {
      "new_customer": 11,
      "old_customer": 4
    },
    "customer_purchased": {
      "new_customer": "2588500",
      "old_customer": "2527300"
    },
    "customer_gender": {
      "unknown": 5,
      "female": 10,
      "male": 0
    },
    "customer_level": [
      {
        "count": 15,
        "id": null,
        "total_amount": "5115800"
      }
    ],
    "customer_order_count": [
      {
        "amount": "0",
        "customer_count": 7,
        "order_success_quantity": 0
      },
      {
        "amount": "2728500",
        "customer_count": 8,
        "order_success_quantity": 1
      }
    ],
    "new_customer": {
      "old_customer": 4,
      "analytic_new_customer": {
        "count": 11,
        "count_1": 11,
        "count_2": 0,
        "count_tags": 0
      }
    },
    "customer_analytic": [
      {
        "range": 0,
        "total": 4344,
        "from_1_to_30": 3,
        "from_31_to_60": 2,
        "from_61_to_90": 3,
        "under_90": 4336
      }
    ],
    "customer_orders": {
      "page_number": 1,
      "page_size": 1,
      "total_entries": 15,
      "total_pages": 15,
      "data": [
        {
          "id": "…",
          "name": "Khách hàng A",
          "phone_number": "0901234567",
          "currency": "VND",
          "order_count": 1,
          "order_success_count": 1,
          "order_success_amount": 295000,
          "order_return_count": 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 Khách hàng ở trang nền tảng
3. Tạo API key (tick kênh Pancake POS)
4. Gọi theo ví dụ ở trên