# Kết nối Pancake ## Những điều cần lưu ý | STT | Lưu ý | | :-: | ------------------------------------------------------------------------------------------------------------------------ | | 1 | Cần **kiểm tra kỹ** và **nhập đúng** các thông tin kết nối Pancake ở Loyalty Hub | | 2 | Sau khi kết nối, vui lòng **không thay đổi thông tin** trong quá trình CNV đồng bộ dữ liệu | | 3 | Một tài khoản KOV chỉ kết nối với một tài khoản Loyalty Hub | | 4 | Nên tích hợp một POS/một Hub để tránh trùng lặp dữ liệu đồng bộ giữa các POS | | 5 |

Tài khoản kết nối phải là

| | 6 | Chỉ **đồng bộ** dữ liệu **trong thời gian kết nối**, các dữ liệu trong thời gian ngắt kết nối sẽ **không được đồng bộ.** | ## Bảng giá đồng bộ dữ liệu cũ * [Bảng giá chi tiết](https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/dong-bo-du-lieu-cu) ## Thông tin đồng bộ CNV và Pancake | Danh mục | Chiều | Thông tin đồng bộ | Hoạt động đồng bộ | | ---------- | :---: | ----------------- | ----------------- | | Đơn Hàng | 2 | CNV → Pancake | CNV Thêm | | | | Pancake → CNV | Pancake Thêm, Sửa | | Sản phẩm | 1 | Pancake → CNV | Pancake Thêm, Sửa | | Khách Hàng | 1 | Pancake → CNV | Pancake Thêm, Sửa | {% hint style="info" %} Thời gian đồng bộ dữ liệu CNV Loyalty và Pancake từ 10 → 30 phút {% endhint %} ## Import dữ liệu cũ bằng File Excel ### Bước 1: Tải về mẫu Excel {% file src="/files/-MiqsAxU8rm\_CFeqX0ZU" %} Mẫu file Khách hàng {% endfile %} {% file src="/files/-Mir8aMxQVxCWQFjLsDW" %} Mẫu file Đơn hàng {% endfile %} {% file src="/files/-MiqsXOQvLOeOmwRpDIM" %} Mẫu file Sản phẩm {% endfile %} ### Bước 2: Nhập dữ liệu theo mẫu Excel * [Hướng dẫn Import dữ liệu](https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/import-du-lieu-cu) ### Bước 3: Liên hệ CNV Loyalty để cập nhật dữ liệu * Email: ## Tổng quan các thông tin đồng bộ Pancake ### Sản phẩm (Đồng bộ 1 chiều)

Sản phẩm Pancake -> CNV

### Đơn hàng (Đồng bộ hai chiều và xử lý đơn hàng bên Pancake)

Đơn hàng Pancake -> CNV

{% hint style="info" %} Đơn hàng sau khi đồng bộ về đến CNV, mỗi item sản phẩm trong đơn hàng sẽ hiển thị theo dạng custom (bản thể chính xác ứng với item đơn bên Pancake - không link qua chi tiết sản phẩm khi click trực tiếp vào từng dòng item trong đơn hàng. **Nguyên nhân**: Cách phía Pancake quy định chi tiết đơn hàng cho phép tạo ra nhiều dòng item cùng một sản phẩm, mỗi dòng item này lại được tuỳ chỉnh giá bán, khuyến mãi,... do đó để tương thích được với các rule bên CNV cũng như các POS khác cần chuyển thành dạng custom {% endhint %}

Đơn hàng CNV -> Pancake

### Khách hàng (Đồng bộ 1 chiều)
{% hint style="info" %} Lưu ý: Đối với việc đồng bộ khách hàng, sẽ ko đồng bộ địa chỉ mặc định của khách hàng từ POS về CNV, vì các field địa chỉ ở POS khác với CNV nên khi đồng bộ địa chỉ khách hàng về CNV sẽ ko map theo các trường (tỉnh, tp, quận huyện xã phường ...), chỉ đổ về trường địa chỉ cụ thể, ảnh hưởng tới trải nghiệm khách hàng mua hàng và việc hiển thị phí vận chuyển theo setup của doanh nghiệp {% endhint %} ## Kết nối Pancake ### Bước 1: Lấy thông tin kết nối ở Pancake ### 1. Doanh nghiệp chưa có tài khoản Pancake * [Đăng ký Pancake](https://id.pancake.vn/signup?redirect_uri=http%3A%2F%2Fid.pancake.vn%2Foauth2%2Fauthorize%3Fgrant_type%3Dcode%26client_id%3D53e2d5e33a8940f4a30ba22a4011e52a%26redirect_uri%3Dhttps%253A%252F%252Fpages.fm%252Fapi%252Fv1%252Fusers%252Fpancake_id_login_success%26scope%3Davatar%2Cemail%2Csubscriptions%26verification_method%3Demail%26locale%3Dvi%26state%3DeyJjb3VudHJ5IjoiVk4iLCJwb3NfbG9naW4iOnRydWV9) ![](/files/-Mi6WCE5YTS0zwGgU7Vr) * Nhập mã xác thực từ email đã đăng ký → chọn Xác thực ![](/files/-Mi7Wwf_Rx0XEsjRCjXH) ### 2. Doanh nghiệp đã có tài khoản Pancake * [Truy cập Pancake](https://pos.pages.fm/) → chọn Đăng nhập ![](/files/-Mi6RAegKi3ZsIS9Xb5T) * [Đăng nhập Pancake](https://id.pancake.vn/oauth2/authorize?grant_type=code\&client_id=53e2d5e33a8940f4a30ba22a4011e52a\&redirect_uri=https://pages.fm/api/v1/users/pancake_id_login_success\&scope=avatar,email,subscriptions\&force=true) ![](/files/-Mi7R0Z8RoJkkrkyH1Cz) * Chọn Đồng ý ![](/files/-Mi7U1n0X9i83l5LkYP-) * Chọn Thêm cửa hàng ![](/files/-Mi7YZbSYyrarroCAZHi) * Nhập Tên cửa hàng → chọn ngành hàng của bạn → Thêm ![](/files/-Mi7dH_NW7GmWbnUIq2-) * Chọn Truy cập ![](/files/-Mi7erfd1UV4FczUbk9m) * Chọn Cấu hình → Cấu hình ứng dụng → API Key: Thêm mới ![](/files/-Mi7kFaVp--M7yJ8ogyA) * Lấy thông tin kết nối 1. Lấy thông tin Shop id * Ví dụ: 3909009 2. Chọn Bật để API key hoạt động 3. Lấy thông tin API key * Ví dụ: 9b1f9f2d6c994f19bebceb8db99a2ee9 ![](/files/-Mi7tqGcIGa419W0R0g3) {% hint style="warning" %} * **Không** nhấn **nút sao chép** ở API key vì * Hệ thống tự động sao chép đường link của shop bao gồm cả API * Không thể thực hiện kết nối bằng đường link này {% endhint %} ### Bước 2: Vào Cấu hình ➝ Cổng kết nối dữ liệu ![](/files/-Mi8-9VNoyjJL4Z6TnGx) ### Bước 3: Chọn Thêm Cổng kết nối ![](/files/-Mi8-QLBzpORgCZb6jX0) ### Bước 4: Thêm Pancake ![](/files/-Mi7nr0hrCKd5miJA6rW) ### Bước 5: Kích hoạt Pancake 1. Chọn Kết nối 2. Nhập thông tin đã lấy ở bước 1 * Shop id * API Key 3. Chọn Kích hoạt ![](/files/-Mi7ubnlu1z4TaT8hiWw) ### Bước 6: Kích hoạt cổng kết nối Pancake ![](/files/-Mi7v7Ntzc6X57RhMf9Z) ### Kết nối Pancake thành công ![](/files/-Mi7vcrH_douZO1Xy2r9) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/ket-noi-pancake.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.