> For the complete documentation index, see [llms.txt](https://docs.pos.pages.fm/pos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pos.pages.fm/pos/thiet-lap-shop/kenh-ban/ket-noi-kenh-ban/shopify.md).

# Shopify

## 1. Đăng ký tài khoản Shopify partner

Đăng ký Shopify partner tại: [https://partners.shopify.com](https://partners.shopify.com/)

<figure><img src="/files/SFXPGUPcYYdCgmpUZ010" alt=""><figcaption><p>Giao diện Shopify Partner</p></figcaption></figure>

## 2.  Liên kết Shopify bằng ID và mã bí mật:

### Bước 1: Tạo app trên Shopify

&#x20;Tại view **Partner Shopify -> All apps -> Create app**

<figure><img src="/files/eyljwYZHkYgnVJxKUBlj" alt=""><figcaption></figcaption></figure>

### **Bước 2:** Lưu Client ID và Client secret

<figure><img src="/files/Z0CtlDtvD74LmYoBGEeT" alt=""><figcaption></figcaption></figure>

### **Bước 3:** Setup app

Điền thông tin mặc định liên kết app với POS:

**App URL:** <https://pos.pages.fm/>

**Allowed redirection URL(s):** <https://pos.pages.fm/api/v1/login-shopify>

<figure><img src="/files/iPLNRPFomybzPd0sKGUM" alt=""><figcaption><p>Setup app trên Shopify</p></figcaption></figure>

### **Bước 4:** Phân phối app

<figure><img src="/files/87YGbR0ROuaewXvvDbZR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6YGugautu4L4VFbKwrlN" alt=""><figcaption><p>Tạo domain </p></figcaption></figure>

Thông tin này trong link là ID cửa hàng cần điền trong POS:

<figure><img src="/files/ugDCFGim8axdkr0ygLe8" alt=""><figcaption><p>Sao chép URLcửa hàng</p></figcaption></figure>

### Bước 5: Đăng nhập trên Pancake POS

Điền thông tin đã lấy từ Shopify:

* **Shop URL:** xem bước 4
* **Client ID và Client secret:** xem bước 2

Cấu hình đồng bộ POS với Shopify:

* **Kho:** Đơn hàng được đồng bộ từ kênh bán về sẽ mặc định chọn kho hàng này, tồn kho/có thể bán của sản phẩm cũng sẽ được trừ trực tiếp trên kho đã chọn.
* **Đồng bộ tồn kho POS -> Shopify:** Số liệu tồn kho sẽ được cập nhật liên tục từ **POS** với kênh bán để đảm bảo số liệu tồn kho trên các kênh bán chính xác trong trường hợp bạn có nhiều kênh bán.
* **Đồng bộ giá bán POS -> Shopify:** Giá sản phẩm sẽ được đồng bộ liên tục từ **POS** với kênh bán, bạn sẽ chỉ cần thao tác chỉnh sửa giá trên **POS** mà không cần phải thay đổi trên từng kênh bán.
* **Đồng bộ đơn hàng từ Shopify -> POS**: Đơn hàng mới từ kênh bán sẽ được đồng bộ liên tục về **POS** để Shop quản lý và theo dõi
* **Kho hàng đồng bộ tồn kho POS -> Shopify**: Bạn có thể đồng bộ tồn kho tổng của nhiều kho hàng POS với kênh bán.

{% hint style="warning" %}
**Lưu ý**: Để đồng bộ tồn kho và giá bán từ **POS** -> Kênh bán bạn cần [Liên kết sản phẩm](/pos/thiet-lap-shop/kenh-ban/lien-ket-san-pham.md) giữa **POS** và kênh bán
{% endhint %}

<figure><img src="/files/cwFnBdZPot5SGojKdz0u" alt=""><figcaption><p>Liên kết POS với Shopify</p></figcaption></figure>

## 3. Liên kết Shopify bằng Access token:

### **Bước 1:** Truy cập trang [https://admin.shopify.com](https://admin.shopify.com/) và truy cập vào store của bạn

<figure><img src="/files/dSC7snd2wOR5Ud1xsAP2" alt=""><figcaption></figcaption></figure>

### **Bước 2:**  Tạo app mới trong cửa hàng của bạn&#x20;

* Vào **Cài đặt -> Ứng dụng và kênh bán -> Phát triển ứng dụng -> Tạo một ứng dụng**.
* Trong cửa sổ bật lên, điền **Tên ứng dụng** -> chọn tài khoản -> **Tạo ứng dụng.**

<figure><img src="/files/9cMQVto69pKeDevloKyO" alt=""><figcaption><p>Tạo ứng dụng </p></figcaption></figure>

### Bước 3: Cấu hình quyền truy cập&#x20;

Tại mục **Tổng quan**, chọn **Cấu hình phạm vi API quản trị.**

Trong mục **Phạm vi truy cập API quản trị**, bạn cần bật các phạm vi truy cập và nhấn **Lưu**:

| Scopes                                    | Permissions required                                                                                                              |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Đơn hàng                                  | <p><code>read\_orders</code></p><p><code>write\_orders</code></p>                                                                 |
| Sản phẩm                                 | <p><code>read\_products</code></p><p><code>write\_products</code></p>                                                             |
| Đơn hàng thực hiện của bên thứ ba         | <p><code>read\_third\_party\_fulfillment\_orders</code></p><p><code>write\_third\_party\_fulfillment\_orders</code></p>           |
| Đơn hàng thực hiện đã chỉ định            | <p><code>read\_assigned\_fulfillment\_orders</code></p><p><code>write\_assigned\_fulfillment\_orders</code></p>                   |
| Đơn hàng thực hiện do thương nhân quản lý | <p><code>read\_merchant\_managed\_fulfillment\_orders</code></p><p><code>write\_merchant\_managed\_fulfillment\_orders</code></p> |
| Hàng trong kho                            | `read_inventory`                                                                                                                  |
| Khách hàng                                | `read_customers`                                                                                                                  |

### Bước 4: Cài đặt ứng dụng để lấy Access token.

Chọn **Cài đặt ứng dụng** -> truy cập tab **Thông tin xác thực API** -> chọn **Hiển thị token một lần** và copy token đó.

{% hint style="warning" %}
**Lưu ý:** Admin API access token **chỉ hiển thị 1 lần** vì lý do bảo mật trên Shopify, bạn cần sao chép và lưu lại để dùng sau này.
{% endhint %}

<figure><img src="/files/q9iQNR3xPeA9CKH5bfvV" alt=""><figcaption><p>Lấy thông tin bao gồm URL cửa hàng và Access token</p></figcaption></figure>

### Bước 5: Liên kết Shopify với POS

Điền thông tin vừa lấy được từ Shopify để kết nối với POS

* **Kho:** Đơn hàng được đồng bộ từ kênh bán về sẽ mặc định chọn kho hàng này, tồn kho/có thể bán của sản phẩm cũng sẽ được trừ trực tiếp trên kho đã chọn.
* **Đồng bộ tồn kho POS -> Shopify:** Số liệu tồn kho sẽ được cập nhật liên tục từ **POS** với kênh bán để đảm bảo số liệu tồn kho trên các kênh bán chính xác trong trường hợp bạn có nhiều kênh bán.
* **Đồng bộ giá bán POS -> Shopify:** Giá sản phẩm sẽ được đồng bộ liên tục từ **POS** với kênh bán, bạn sẽ chỉ cần thao tác chỉnh sửa giá trên **POS** mà không cần phải thay đổi trên từng kênh bán.
* **Đồng bộ đơn hàng từ Shopify -> POS**: Đơn hàng mới từ kênh bán sẽ được đồng bộ liên tục về **POS** để Shop quản lý và theo dõi
* **Kho hàng đồng bộ tồn kho POS -> Shopify**: Bạn có thể đồng bộ tồn kho tổng của nhiều kho hàng POS với kênh bán.

<figure><img src="/files/cwFnBdZPot5SGojKdz0u" alt=""><figcaption></figcaption></figure>