# Kết nối Sapo Omnichanel(V2)

## Tổng quan

Sapo là một công ty cung cấp các giải pháp phần mềm cho doanh nghiệp ở Việt Nam, với các dịch vụ nổi bật như Sapo Omnichannel, Sapo Web, Sapo FnB,... Hiện tại, AppVN đã nâng cấp và hỗ trợ kết nối với hệ thống Sapo Omnichannel (chuẩn API V2) để tối ưu hóa khả năng đồng bộ dữ liệu đa kênh.

Sapo Omnichannel (V2) là nền tảng quản lý bán hàng đa kênh toàn diện của Sapo. Không chỉ giới hạn ở việc xây dựng và quản lý website (Sapo Web), giải pháp này cho phép nhà bán hàng quản lý tập trung toàn bộ hoạt động kinh doanh từ cửa hàng bán lẻ (POS), website, mạng xã hội (Facebook, Zalo) cho đến các sàn thương mại điện tử. Với việc kết nối qua chuẩn V2 (sử dụng API Key và Secret Key thông qua Ứng dụng riêng), AppVN giúp doanh nghiệp đồng bộ sâu các dữ liệu phức tạp như thông tin khách hàng, sản phẩm, tồn kho đa chi nhánh và trạng thái xử lý đơn hàng với tốc độ nhanh chóng, ổn định và bảo mật cao.

## Thao tác

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

* 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/uTotuBGhuvpp0fDxHv7q" 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:

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

  * **Tên nền tảng:** Đặt tên cho kết nối, ví dụ tên là SapoV2
  * **Nền tảng:** Chọn Sapo Omnichannel(V2)
  * Cách lấy API Key và Secret Key:

    * Tại giao diện trang chủ của Sapo, người dùng chọn vào dấu + ở menu Ứng dụng bên trái màn hình, sau đó chọn Ứng dụng riêng

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

    * Người dùng chọn Tạo ứng dụng riêng&#x20;

    <figure><img src="/files/1LH0uZ5OX7WB5Dc9nvpY" alt=""><figcaption></figcaption></figure>

    * Điền tên ứng dụng và email liên hệ. Sau đó chuyển phân quyền admin API sang đọc và ghi.

      <figure><img src="/files/agTSTeehyroGPjTF0iO3" alt=""><figcaption></figcaption></figure>
    * Bật cho phép app sử dụng Storefront API và tích chọn các quyền. Sau đó chọn Lưu.

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

    * Giao diện hiện ra API Key và API secret.

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

    * Người dùng sao chép và dán vào API key và Secret Key của màn hình kết nối AppVN.

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

  * Cập nhật **subdomain** kết nối với Sapo Web:&#x20;

    * Truy cập vào giao diện của trang Sapo Web
      * Tại đường link truy cập shop, copy phần text nằm phía trước **.mysapo.net** điền vào ô Subdomain.

    Ví dụ: https\://**example**.mysapo.net => Subdomain của bạn là: **example**

    <figure><img src="/files/WJv6Pg4Akg5N7WETWRO6" alt=""><figcaption></figcaption></figure>
* **Chi nhánh đồng bộ đơn hàng và Kho đồng bộ đơn hàng:** tự động gắn chi nhánh và kho cho đơn hàng được đồng bộ về AppVN

  <figure><img src="/files/dPoTlMZb26hj5xzW7XTq" alt=""><figcaption></figcaption></figure>
* **Kích hoạt Webhook :** bật / tắt cấu hình các tính năng khi kết nối với AppVN

  * Tạo đơn hàng&#x20;
  * Cập nhật đơn hàng&#x20;
  * Xóa đơn hàng&#x20;
  * Thanh toán đơn hàng&#x20;
  * Hủy đơn&#x20;
  * Đơn thành công&#x20;
  * Thành công 1 phần
  * Tạo khách hàng cho những đơn có chứa ký tự ẩn
  * Quét thông tin khách hàng từ SmaxAI đồng bộ thông tin kênh kết nối

  <figure><img src="/files/x0fRSw0OvjOLkiqaXMrj" alt=""><figcaption></figcaption></figure>
* Mapping thông tin: Người dùng có thể mapping các thông tin sau từ Sapo sang AppVN

  * Mapping nhân viên
  * Mapping vai trò
  * Mapping kho hàng
  * Mapping chi nhánh

  <figure><img src="/files/3Yv84Dmrj5dRZLLzujsV" alt=""><figcaption></figcaption></figure>
* Người dùng tích chọn kích hoạt và bấm **Thêm**. Kết nối hoàn thành.


---

# 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-sapo-omnichanel-v2.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.