Pancake POS¶

Kích hoạt theo yêu cầu

Logidata kéo dữ liệu Pancake POS hằng ngày bằng chính hạ tầng này — đơn hàng và khách hàng đang chảy vào kho dữ liệu của khách hàng thật. Báo Logidata khi bạn cần, nền tảng được bật cho tài khoản của bạn.

Base URL:

https://api.logidata.vn/v1/pancake{đường dẫn Pancake POS}

Đường dẫn, tham số và response giống hệt Pancake POS Open API. Gốc là https://pos.pages.fm.

Một kết nối = một shop Pancake POS (shop_id).

Điều Logidata làm hộ bạn¶

Pancake xác thực bằng api_key gắn thẳng vào query string của mọi request — nghĩa là khoá bí mật của bạn nằm trong URL, đi qua log của mọi proxy trên đường đi và dễ lọt vào lịch sử shell, file cấu hình n8n hay bảng tính chia sẻ.

Việc	Gọi thẳng Pancake	Qua Logidata
Giữ `api_key` của shop	Bạn tự giữ, và nó nằm trong URL	Logidata giữ; bạn không bao giờ thấy
Ghép `api_key` vào từng request	Bạn tự làm	Không
Quản lý nhiều shop = nhiều khoá	Bạn tự map	Đổi `X-Account-Id`

Đây là điểm được lợi rõ nhất về bảo mật

Qua Logidata, khoá đi trong header X-API-Key chứ không phải query string, và đó là khoá của Logidata — thu hồi hoặc đổi được bất cứ lúc nào trên portal mà không phải đụng vào cấu hình Pancake.

Nhóm dữ liệu¶

Allowlist chỉ đọc, gồm các endpoint Logidata đã dùng thật trong pipeline production:

Nhóm	Đường dẫn gốc	Dùng để
Danh sách shop	`/api/v1/shops`	Các shop mà khoá nhìn thấy, lấy `shop_id`
Đơn hàng	`/api/v1/shops/{shop_id}/orders`	Đơn theo khoảng thời gian, kèm sản phẩm, trạng thái và giá trị
Khách hàng	`/api/v1/shops/{shop_id}/customers`	Danh sách khách, thông tin liên hệ, tổng chi tiêu

Ràng buộc cần biết¶

Phân trang bắt buộc. Các endpoint danh sách trả theo trang; bạn lặp cho tới hết. Mỗi trang là một request tính vào hạn mức.

Đơn thay đổi sau khi tạo. Trạng thái, phí ship và hoàn trả cập nhật nhiều ngày sau. Kéo lại cửa sổ vài ngày gần nhất mỗi lần chạy, ghi đè theo mã đơn.

Pancake POS khác Pancake Chat/CRM. Trang này nói về POS (bán hàng, đơn, khách). Dữ liệu hội thoại và quảng cáo của Pancake nằm ở nhóm API khác — nếu bạn cần, hãy trao đổi với Logidata về phạm vi trước khi thiết kế báo cáo.

Xác thực và mã lỗi¶

Giống hệt mọi nền tảng khác: X-API-Key + X-Account-Id (xem Xác thực), cùng bộ mã lỗi. X-Account-Id ở đây trỏ tới một shop Pancake POS.