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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.pos.pages.fm/pos/thiet-lap-shop/kenh-ban/ket-noi-kenh-ban/shopify.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.