# Kết nối Shopify

Tổng quan

Shopify là một nền tảng thương mại điện tử dựa trên đám mây cho phép cá nhân và doanh nghiệp tạo và quản lý cửa hàng trực tuyến của mình. Được thành lập vào năm 2006 bởi Tobias Lütke, Daniel Weinand và Scott Lake, Shopify đã trở thành một trong những nền tảng thương mại điện tử phổ biến nhất trên thế giới.

## Thao tác

Để kết nối Shopify vào AppVN, người dùng thao tác như sau:

* Đăng nhập tài khoản shopify trên trình duyệt của bạn
* Trên màn hình danh sách kết nối, bấm **+ Thêm** ở góc trên cùng bên phải của màn hình.

  <figure><img src="/files/HoVdzYblY4mRUqngniDp" alt=""><figcaption></figcaption></figure>
* Pop-up tạo kết nối mới hiển thị trên màn hình, người dùng có thể cấu hình như sau.&#x20;

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

  * **Tên nền tảng:** Đặt tên cho kết nối, ví dụ tên shop là Shopify
  * **Nền tảng:** Chọn Shopify
* **Cập nhật thông tin về Subdomain và Token truy cập API quản trị**&#x20;

  * Hướng dẫn lấy Subdomain: người dùng truy cập vào trang quản lý của shopify, tại đường dẫn URL sẽ thấy được subdomain cần lấy

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

  * Nhập tên nền tảng, Store Alias (là subdomain bạn vừa copy bên trên)

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

  * Lựa chọn chi nhánh đồng bộ đơn hàng, kho đồng bộ đơn hàng. Khi đơn hàng đổ về từ shopify, sẽ có thông tin của chi nhánh và kho này.

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

  * Cấu hình thêm webhook từ Shopify đổ về AppVđây: tại đây

  <figure><img src="/files/9Y7wpVBkV5mPlAEZMeQc" alt=""><figcaption></figcaption></figure>

  * Bật đồng bộ khi bạn muốn đẩy đơn từ AppVN lên Shopify

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

  * Ấn **Thêm** để hoàn thành việc kết nối với Shopify.

#### *Trường hợp đặc biệt:* Nếu sau khi ấn Thêm, màn hình của bạn hiển thị như dưới đây, thì bạn cần lấy token của API Quản trị.

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

* Hướng dẫn lấy Token truy cập API quản trị:&#x20;

  <figure><img src="/files/2xpE2Cf991KGrrKWhVkY" alt=""><figcaption><p>Thao tác cấu hình bên Shopify</p></figcaption></figure>

* Kiểm tra version, chọn version mới nhất **2025-1**

<figure><img src="/files/9IuISpBy7wWRNhN0JnNU" alt=""><figcaption><p>Chọn version mới nhất</p></figcaption></figure>

Lấy token và lưu vào 1 nơi riêng, vì token này chỉ hiển thị 1 lần.

<figure><img src="/files/8CsWeEpXUq8pqWSw9lOv" alt=""><figcaption><p>API Access Token </p></figcaption></figure>

* Bật Custom App và Dán token của bạn vào API quản trị

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

Người dùng tích chọn kích hoạt và bấm **Thêm** để hoàn thành việc kết nối.

* **LƯU Ý:** Do shopify không sử dụng trạng thái đơn hàng nên AppVNsẽ định danh một số trạng thái cụ thể để đẩy thông tin sang Shopify và đồng bộ ngược lại như sau:
  * Đơn hàng ở trạng thái Nháp, Đơn Mới, Chờ, Lên Đơn bên SmaxApp sẽ đồng bộ thành Đơn hàng Nháp (Draft Order) bên Shopify, còn Shopify sẽ đồng bộ Đơn Nháp sang AppVNluôn ở trạng thái Nháp
  * Đơn hàng ở trạng thái Đã gửi hàng sẽ đồng bộ thành Đơn hàng (Order) bên Shopify đã được thanh toán nhưng chưa vận chuyển
  * Đơn hàng ở trạng thái Đã nhận sẽ đồng bộ sang Shopify là đơn hàng được thực hiện thành công.


---

# 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://tailieu.smax.app/tai-lieu-huong-dan-app.vn/su-dung-app.vn/tich-hop/ket-noi-nen-tang/ket-noi-shopify.md?ask=<question>
```

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.