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

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.

Ảnh bìa bài hướng dẫn kết nối Pancake POS với phần mềm Cam Check qua ba bước tạo API Key, lấy Shop ID và kết nối

Tóm tắt nhanh

Để kết nối Pancake POS với Cam Check bạn cần đúng hai thông tin: API Key và Shop ID. API Key tạo trong trang quản trị Pancake theo đường Cấu hình → Nâng cao → Kết nối bên thứ 3 → Webhook/API → tab API Key → Thêm mới. Shop ID là dãy số nằm ngay sau /shop/ trên thanh địa chỉ trình duyệt khi bạn đang quản lý cửa hàng. Dán hai giá trị đó vào Cài đặt → Kết nối nền tảng bán hàng → Pancake POS trong Cam Check rồi lưu là xong, toàn bộ mất khoảng 3 phút và không cần tài khoản Developer riêng.

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 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 — 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 Cấu hình → Nâng cao → Kết nối bên thứ 3a1b2c3d4e5f6...

Lưu ý bảo mật: theo tài liệu chính thức của Pancake, API Key có quyền ngang một tài khoản admin — đọc và ghi toàn bộ dữ liệu cửa hàng, không thể giới hạn bớt quyền. Ai cầm khoá là thao tác được lên cửa hàng, nên hãy giữ kín như chìa khoá cửa hàng.

Thời gian thực hiện khoảng 3 phút. Bạn cần đăng nhập Pancake POS bằng tài khoản chủ cửa hàng hoặc tài khoản có quyền quản trị, và không cần đăng ký tài khoản Developer riêng.

Bước 1 — Mở mục Kết nối bên thứ 3

1

Đăng nhập Pancake POS trên trình duyệt

Truy cập pos.pages.fm bằng tài khoản chủ cửa hàng hoặc tài khoản có quyền quản trị. Thao tác này phải làm trên máy tính, ứng dụng di động không có màn hình cấu hình API.

2

Vào Cấu hình, kéo tới nhóm Nâng cao

Nhấn Cấu hình ở thanh menu bên trái. Trong trang cấu hình, kéo xuống nhóm Nâng cao ở khu vực Đối tác, rồi chọn Kết nối bên thứ 3.

Trang Cấu hình của Pancake POS, khoanh đỏ mục Cấu hình ở menu trái và mục Kết nối bên thứ 3 trong nhóm Nâng cao

Cấu hình → nhóm Nâng cao → Kết nối bên thứ 3. Nguồn ảnh: tài liệu chính thức Pancake POS

Nếu không tìm thấy mục này, khả năng cao tài khoản của bạn chưa đủ quyền quản trị. Nhờ chủ cửa hàng cấp quyền hoặc nhờ họ tạo hộ API Key.

Bước 2 — Vào ứng dụng Webhook/API

Màn hình Kết nối bên thứ 3 hiển thị danh sách Các ứng dụng. Tìm thẻ Webhook/API rồi nhấn nút Chi tiết trên thẻ đó.

Màn hình Kết nối bên thứ 3 của Pancake POS với thẻ ứng dụng Webhook/API và nút Chi tiết được khoanh đỏ

Nhấn Chi tiết trên thẻ ứng dụng Webhook/API. Nguồn ảnh: tài liệu chính thức Pancake POS

Nút Thêm mới màu xanh ở góc phải màn hình này dùng để thêm ứng dụng bên thứ ba khác, không phải nút tạo API Key. Nút tạo khoá nằm bên trong cửa sổ Webhook - API ở bước sau.

Bước 3 — Tạo và sao chép API Key

1

Mở tab API Key

Cửa sổ Webhook - API hiện ra với hai tab: Webhook URL và API Key. Chọn tab API Key.

2

Nhấn Thêm mới

Trong khung Danh sách, nhấn Thêm mới. Ở ô Ghi chú, đặt một cái tên dễ nhớ như Cam Check để sau này biết khoá nào dùng cho việc gì.

3

Sao chép chuỗi khoá và bật trạng thái

Hệ thống sinh ra một chuỗi mã dài. Sao chép và lưu lại ngay vì bạn sẽ dán nó vào Cam Check ở Bước 5. Đồng thời kiểm tra cột Bật/Tắt đang ở trạng thái bật — khoá đang tắt thì mọi request từ Cam Check đều bị từ chối.

Cửa sổ Webhook - API của Pancake POS đang mở tab API Key với nút Thêm mới và bảng danh sách khoá gồm cột Bật Tắt, API Key, Ghi chú

Tab API Key, nhấn Thêm mới rồi sao chép chuỗi khoá vừa sinh ra. Nguồn ảnh: tài liệu chính thức Pancake POS

Mỗi khoá gắn với một cửa hàng. Nếu bạn quản lý nhiều cửa hàng trên cùng một tài khoản Pancake, hãy tạo khoá riêng cho từng cửa hàng và đừng dùng lẫn.

Bước 4 — 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à nhìn thanh địa chỉ trình duyệt khi bạn đang ở trong trang quản trị cửa hàng.

Minh hoạ thanh địa chỉ trình duyệt với đường dẫn pos.pages.fm gạch vàng làm nổi dãy số Shop ID nằm ngay sau chữ shop

Dãy số ngay sau /shop/ chính là Shop ID.

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 đường dẫn — hệ thống sẽ tự tách lấy dãy số Shop ID.

Cách khác

Gọi GET /api/v1/shops?api_key=..., trường id trong kết quả trả về chính là Shop ID.

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

1

Mở Cam Check và đăng nhập

Truy cập app.quayvideodongdon.com và đăng nhập tài khoản của bạn.

2

Vào Cài đặt, chọn nền tảng Pancake POS

Vào Cài đặt, kéo xuống phần Kết nối nền tảng bán hàng rồi chọn Pancake POS trong danh sách nền tảng.

3

Điền hai trường và lưu cài đặt

Điền Shop ID lấy ở Bước 4 và API Key lấy ở Bước 3, rồi nhấn Lưu cài đặt.

TrườngGiá trị cần nhập
Shop IDDãy số định danh cửa hàng, ví dụ 6036602
API KeyChuỗi khoá đã tạo ở Bước 3
Màn hình Cài đặt của Cam Check với nền tảng bán hàng chọn Pancake POS và hai ô nhập Shop ID cùng API Key

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

Ngay tại màn hình này Cam Check có sẵn hai liên kết: Tài liệu API Pancake POS dẫn sang tài liệu kỹ thuật của Pancake, và Xem hướng dẫn kết nối Pancake POS dẫn về đúng bài bạn đang đọc.

Kiểm tra kết nối đã chạy chưa

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

Muốn kiểm tra riêng phần khoá trước khi dán vào Cam Check, chạy lệnh sau trong terminal và thay YOUR_API_KEY bằng khoá của bạn:

curl "https://pos.pages.fm/api/v1/shops?api_key=YOUR_API_KEY"

Khoá hợp lệ thì máy chủ trả về JSON có "success": true kèm danh sách cửa hàng. Trường id của cửa hàng trong kết quả này chính là Shop ID bạn cần — một cách lấy Shop ID không cần nhìn thanh địa chỉ.

{ "success": true, "shops": [ { "id": 12345, "name": "..." } ] }

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.

1

Lấy danh sách và 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.

2

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.

3

Lấy danh sách cửa hàng

GET/shops?api_key=<api_key>

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

Tài liệu API chính thức: Pancake POS Open API và trang Lấy API key & xác thực.

Lưu ý bảo mật quan trọng

  • API Key có quyền ngang tài khoản admin, đọc và ghi toàn bộ dữ liệu cửa hàng và không giới hạn bớt quyền được. Không chia sẻ, không đăng công khai, không commit vào mã nguồn.
  • Nếu nghi ngờ lộ khoá, vào Cấu hình → Nâng cao → Kết nối bên thứ 3 → Webhook/API → API Key để xoá khoá cũ và tạo khoá mới, sau đó cập nhật lại trong Cam Check.
  • Đặt Ghi chú rõ ràng cho từng khoá để khi cần thu hồi thì biết chính xác khoá nào của ứng dụng nào.
  • Mỗi khoá gắn với một cửa hàng. Quản lý nhiều cửa hàng thì tạo khoá riêng cho từng cửa hàng và đảm bảo Shop ID khớp với khoá.
  • Cam Check chỉ đọc dữ liệu đơn hàng và sản phẩm để đối chiếu khi đóng gói, 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 hoặc không có quyềnAPI Key sai, đã bị xoá, đang tắt, hoặc thuộc cửa hàng khácKiểm tra cột Bật/Tắt của khoá; nếu vẫn lỗi thì tạo khoá mới 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 thanh địa chỉ, hoặc dán nguyên đường dẫn
Đồ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ộ
Không thấy mục Kết nối bên thứ 3Tài khoản đăng nhập không có quyền quản trịNhờ chủ cửa hàng cấp quyền hoặc nhờ họ tạo hộ API Key

Câu hỏi thường gặp

Kết nối Pancake POS với Cam Check có mất phí không?

Không. Pancake POS không thu phí khi bạn tạo API Key, và Cam Check cho phép kết nối nền tảng bán hàng ở cả gói miễn phí. Bạn chỉ cần tài khoản Pancake POS có quyền quản trị để vào được mục Kết nối bên thứ 3.

Tôi có cần đăng ký tài khoản Developer của Pancake không?

Không cần. Khác với Haravan hay Sapo phải tạo ứng dụng riêng, Pancake POS cho tạo API Key ngay trong trang quản trị cửa hàng qua Cấu hình, Nâng cao, Kết nối bên thứ 3. Cả quá trình chỉ mất khoảng ba phút.

Một tài khoản quản lý nhiều cửa hàng thì làm thế nào?

Mỗi API Key chỉ gắn với một cửa hàng, nên bạn cần tạo khoá riêng cho từng cửa hàng muốn đồng bộ. Khi điền vào Cam Check, phải chắc chắn Shop ID và API Key thuộc cùng một cửa hàng, nếu không hệ thống sẽ tra cứu nhầm sang đơn của cửa hàng khác.

API Key bị lộ thì xử lý ra sao?

Vào Cấu hình, Nâng cao, Kết nối bên thứ 3, mở ứng dụng Webhook/API rồi sang tab API Key và xoá khoá cũ đi. Sau đó nhấn Thêm mới để sinh khoá khác và dán lại vào Cam Check. Khoá cũ mất hiệu lực ngay khi bị xoá, nên hãy làm việc này sớm vì khoá có quyền ngang tài khoản admin.

Cam Check có sửa đơn hàng trên Pancake không?

Không. Cam Check chỉ đọc dữ liệu đơn hàng và sản phẩm để đối chiếu lúc đóng gói và gắn video vào đúng mã vận đơn. Bản thân API Key của Pancake có quyền ghi, nhưng Cam Check không dùng tới các endpoint chỉnh sửa.

Tìm Shop ID ở đâu nếu thanh địa chỉ không hiện dãy số?

Bạn gọi endpoint danh sách cửa hàng bằng chính API Key vừa tạo, theo địa chỉ pos.pages.fm/api/v1/shops kèm tham số api_key. Kết quả trả về là JSON chứa trường id của từng cửa hàng, đó chính là Shop ID cần điền vào Cam Check.

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ệ:

ZaloHỗ trợ qua ZaloFacebookHỗ trợ qua Facebook