Hướng dẫn kết nối Pancake POS

Lấy API Key và Shop ID của Pancake POS (pos.pages.fm) để kết nối với Cam Check, tự động đồng bộ đơn hàng và gắn video đóng gói theo mã vận đơn.

🥞

Tổng quan

Pancake POS (pos.pages.fm) cung cấp Open API dùng cơ chế xác thực bằng API Key. Cam Check sử dụng API Key cùng với Shop ID của bạn để truy vấn đơn hàng và sản phẩm — bạn chỉ cần thiết lập một lần, không phải thao tác thủ công về sau.

Bạn cần chuẩn bị 2 thông tin sau:

Thông tinMô tảVí dụ
Shop IDMã số định danh cửa hàng trên Pancake POS6036602
API KeyKhoá truy cập API, tạo trong phần Cấu hình → Nâng cao → Kết nối bên thứ 3a1b2c3d4e5f6...

⚠️ Lưu ý bảo mật:API Key có toàn quyền truy cập dữ liệu cửa hàng của bạn. Không chia sẻ công khai và chỉ dán vào Cam Check.

🔑

Bước 1 — Tạo API Key

API Key được tạo ngay trong trang quản trị Pancake POS, không cần đăng ký tài khoản Developer riêng.

1

Đăng nhập Pancake POS bằng tài khoản quản trị

Truy cập pos.pages.fm và đăng nhập bằng tài khoản chủ cửa hàng (hoặc tài khoản có quyền quản trị).

2

Vào Cấu hình → Nâng cao → Kết nối bên thứ 3

Từ menu quản trị, chọn Cấu hình (Setting) → Nâng cao (Advance) → Kết nối bên thứ 3 (Third-party connection) → Webhook/API. Tìm đến khung API KEY.

Cấu hình Webhook/API trên Pancake POS

Cấu hình → Nâng cao → Kết nối bên thứ 3 → Webhook/API, tìm khung API KEY

3

Nhấn Thêm mới để tạo API Key

Trong khung API KEY, nhấn Thêm mới (Create). Hệ thống sẽ sinh ra một chuỗi API Key — hãy sao chép và lưu lại ngay.

Tạo API Key trên Pancake POS

Tạo và sao chép API Key

🏪

Bước 2 — Lấy Shop ID

Shop ID là dãy số định danh cửa hàng trên Pancake POS. Cách nhanh nhất là xem trực tiếp trên thanh địa chỉ trình duyệt khi bạn đang ở trong trang quản trị cửa hàng.

1

Xem trên URL quản trị

Khi đang quản lý cửa hàng, URL trên trình duyệt thường có dạng:

https://pos.pages.fm/shop/6036602/...

Dãy số ngay sau /shop/ chính là Shop ID bạn cần.

Vị trí Shop ID trên Pancake POS

Shop ID nằm trong URL của trang quản trị cửa hàng

Ví dụ

https://pos.pages.fm/shop/6036602/orders

→ Shop ID: 6036602

Mẹo

Cam Check chấp nhận cả việc bạn dán nguyên URL — hệ thống sẽ tự tách lấy dãy số Shop ID.

🔗

Bước 3 — Kết nối Pancake trong Cam Check

Bước 1: Mở Cam Check tại app.quayvideodongdon.com và đăng nhập.

Bước 2: Vào Cài đặt → kéo xuống phần Kết nối nền tảng bán hàng → chọn Pancake POS.

Bước 3: Điền 2 trường sau và nhấn Lưu cài đặt:

TrườngGiá trị cần nhập
Shop IDDãy số định danh cửa hàng (VD: 6036602)
API KeyKhoá đã tạo ở Bước 1 (Cấu hình → Nâng cao → Kết nối bên thứ 3 → Webhook/API)
Kết nối Pancake trong Cam Check

Chọn Pancake POS và nhập Shop ID + API Key trong Cài đặt Cam Check

Sau khi lưu, bạn có thể nhấn Kiểm tra kết nối. Nếu thành công, Cam Check sẽ tự động kéo danh sách sản phẩm trong đơn khi bạn quét mã vận đơn, giúp đối chiếu khi đóng gói.

⚙️

Thông tin API

Cam Check sử dụng các endpoint sau của Pancake POS Open API (base URL: https://pos.pages.fm/api/v1). Xác thực bằng tham số api_key trên query string.

📦

Lấy danh sách / tra cứu đơn hàng

GET/shops/{SHOP_ID}/orders?api_key=<api_key>&search=<mã_vận_đơn>

Tham số search khớp theo số điện thoại, tên khách, ghi chú và mã đơn — Cam Check dùng để tìm đúng đơn theo mã vận đơn vừa quét.

🔍

Tìm kiếm sản phẩm

GET/shops/{SHOP_ID}/products/variations?api_key=<api_key>&search=<từ_khoá>

Lấy danh sách biến thể sản phẩm để hiển thị checklist đóng gói.

🆔

Lấy danh sách cửa hàng (Shop ID)

GET/shops?api_key=<api_key>

Trả về danh sách cửa hàng kèm id — cách khác để tra cứu Shop ID nếu không xem được trên URL.

Tài liệu API chính thức: Pancake POS Open API. Để tạo API Key, vào Cấu hình → Nâng cao → Kết nối bên thứ 3 → Webhook/API và nhấn Thêm mới trong khung API KEY.

📌

Lưu ý quan trọng

  • API Key có toàn quyền truy cập dữ liệu cửa hàng — không chia sẻ công khai, chỉ dán vào Cam Check.
  • Nếu nghi ngờ lộ API Key, hãy vào Cấu hình → Nâng cao → Kết nối bên thứ 3 → Webhook/API để xoá khoá cũ và tạo khoá mới, sau đó cập nhật lại trong Cam Check.
  • Nhập đúng Shop ID dạng dãy số. Cam Check chấp nhận dán cả URL và sẽ tự tách lấy dãy số.
  • Một tài khoản Pancake có thể quản lý nhiều cửa hàng — đảm bảo Shop ID và API Key thuộc cùng một cửa hàng bạn muốn đồng bộ.
  • Cam Check chỉ đọc dữ liệu đơn hàng và sản phẩm, không chỉnh sửa đơn trên Pancake.
🛠️

Xử lý sự cố

Vấn đềNguyên nhân có thểCách xử lý
Không tìm thấy đơn hàngMã vận đơn chưa có trên Pancake hoặc sai Shop IDKiểm tra lại Shop ID và đảm bảo đơn đã tồn tại trên cửa hàng đó
Lỗi xác thực / không có quyềnAPI Key sai, đã bị xoá hoặc thuộc cửa hàng khácTạo lại API Key trong Cấu hình → Nâng cao → Kết nối bên thứ 3 và dán lại vào Cam Check
Kết nối báo lỗi Shop IDNhập thiếu hoặc sai dãy số Shop IDXem lại dãy số sau /shop/ trên URL Pancake, hoặc dán nguyên URL
Đồng bộ sai cửa hàngShop ID và API Key thuộc hai cửa hàng khác nhauĐảm bảo cả hai cùng thuộc một cửa hàng cần đồng bộ

Cần hỗ trợ thêm?

Nếu bạn gặp khó khăn trong quá trình sử dụng phần mềm, vui lòng liên hệ: