# 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FeYBUHCFh31Q0ZsDEx5zP%2FScreen%20Shot%202023-12-16%20at%2010.48.27.png?alt=media&#x26;token=cf3c4c04-eb34-4b40-8de0-ce34dc521aa3" 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FHkJyMSVmmT5h0SsY61bp%2FScreen%20Shot%202023-12-16%20at%2010.57.00.png?alt=media&#x26;token=58b136c2-ec64-46a8-9fc0-7bfeff871f78" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FXHK2lBPdY6zCQNzN1ATu%2FScreen%20Shot%202023-12-16%20at%2010.59.08.png?alt=media&#x26;token=05ca24e1-6bcd-456d-84df-37f6e9440746" 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FdN57jnyalSWRlcYB3e6h%2FScreen%20Shot%202023-12-16%20at%2011.03.35.png?alt=media&#x26;token=626d1d41-d9a7-475d-ad69-328dd22dfbf6" alt=""><figcaption><p>Setup app trên Shopify</p></figcaption></figure>

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

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2Fn4mgwb09NQ628Mq42XMQ%2FScreen%20Shot%202023-12-16%20at%2011.18.21.png?alt=media&#x26;token=bdeb07bf-94b7-4b10-9208-6a2f5dad9ca6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FyXQyUbgAPIdfVKFKKgyk%2FScreen%20Shot%202023-12-16%20at%2011.19.40.png?alt=media&#x26;token=9972db6e-fe28-41e2-924d-d475f730c3bf" 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2Fwz4M1cD9hKw6JVcKxh9c%2FScreen%20Shot%202023-12-16%20at%2011.26.01.png?alt=media&#x26;token=709e01b5-f8fa-47b5-8994-de739dc5b73d" alt=""><figcaption><p>Sao chép URLcử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](https://docs.pos.pages.fm/pos/thiet-lap-shop/kenh-ban/lien-ket-san-pham) giữa **POS** và kênh bán
{% endhint %}

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FK8VFo3ewSGiMsy63qYCO%2FScreenshot%202024-04-20%20at%2016.22.52.png?alt=media&#x26;token=819bc25c-7db4-453a-9af0-1ba3eaf42340" 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2F9lOJYyaOpdL7dK4fAubj%2FScreen%20Shot%202023-12-16%20at%2012.17.07.png?alt=media&#x26;token=80778785-291f-4afb-be68-ff64d4e22598" 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FunjNrpb739Y8lFl4bbJo%2FScreen%20Shot%202023-12-16%20at%2012.19.22.png?alt=media&#x26;token=e341ace6-a053-447d-a754-e587221cc1c7" 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FVZiLpCjBL2e8bOTOerYn%2FScreen%20Shot%202023-12-16%20at%2014.25.08.png?alt=media&#x26;token=139871f6-7acb-4013-a5da-3cb7c71af45c" 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="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FK8VFo3ewSGiMsy63qYCO%2FScreenshot%202024-04-20%20at%2016.22.52.png?alt=media&#x26;token=819bc25c-7db4-453a-9af0-1ba3eaf42340" alt=""><figcaption></figcaption></figure>
