> For the complete documentation index, see [llms.txt](https://abaha-tai-lieu-huong-dan-su-dung.gitbook.io/tai-lieu-huong-dan-su-dung-website-ban-hang/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://abaha-tai-lieu-huong-dan-su-dung.gitbook.io/tai-lieu-huong-dan-su-dung-website-ban-hang/modules-nang-cao/dong-bo-phan-mem-ban-hang/dong-bo-kiotviet.md).

# Đồng bộ Kiotviet

**I. CÁC DANH MỤC ĐỒNG BỘ**

<table><thead><tr><th width="102" align="center">STT</th><th width="264" align="center">Dữ liệu</th><th width="145" align="center">Abaha</th><th align="center">Kiotviet</th></tr></thead><tbody><tr><td align="center">1</td><td align="center">Danh mục sản phẩm</td><td align="center"></td><td align="center"><strong>✓</strong></td></tr><tr><td align="center">2</td><td align="center">Sản phẩm</td><td align="center"></td><td align="center"><strong>✓</strong></td></tr><tr><td align="center">3</td><td align="center">Bảng giá sản phẩm</td><td align="center"></td><td align="center"><strong>✓</strong></td></tr><tr><td align="center">4</td><td align="center">Đơn đặt hàng</td><td align="center"><strong>✓</strong></td><td align="center"><strong>✓</strong></td></tr><tr><td align="center">5</td><td align="center">Khách hàng và <br>nhóm khách hàng</td><td align="center"><strong>✓</strong></td><td align="center"><strong>✓</strong></td></tr></tbody></table>

**Chú thích: dấu “✓” thể hiện được đồng bộ.**

1. Danh mục: Abaha đang đồng bộ danh mục sản phẩm 1chiều từ Kiotviet về Abaha.
2. Sản phẩm: Abaha đang đồng bộ sản phẩm 1 chiều từ Kiotviet về Abaha.
3. Bảng giá sản phẩm: Abaha đang đồng bộ bảng giá sản phẩm 1 chiều từ Kiotviet về Abaha (Abaha sẽ không đồng bộ thời gian áp dụng bảng giá, chỉ đồng bộ về giá của sản phẩm trong bảng giá).
4. Đơn hàng: Abaha đang đồng bộ đơn đặt hàng cả 2 chiều giữa Abaha và Kiotviet
5. Nhóm khách hàng và nhóm : Abaha đang đồng bộ khách hàng 2 chiều giữa Abaha và Kiotviet.

### ***Lưu ý quan trọng:*** <a href="#luu-y-quan-trong" id="luu-y-quan-trong"></a>

***a. Đối với đồng bộ sản phẩm***

* **Khi đồng bộ sản phẩm khách hàng lưu ý chỉ sửa sản phẩm bên Kiotviet, sản phẩm nào không bán thì cần chuyển sang trạng thái ngừng kinh doanh, không được xoá sản phẩm ở Kiotviet.**
* Khi thao tác đồng bộ, khách hàng lưu ý: không thêm, sửa sản phẩm ở Web quản trị Abaha.

***b. Đối với đồng bộ đơn đặt hàng***

* Đồng bộ đơn đặt hàng và khách hàng liên hệ với Abaha để cài đặt.
* Khi đồng bộ đơn đặt hàng, cần phải cho phép cửa hàng mở tính năng bán âm ở bên Kiotviet
* Khi xử lý đơn đặt hàng trên Kiotviet, đơn hàng ở trạng thái Hoàn thành thì đơn trên web quản trị cũng là Hoàn thành.
* Thao tác huỷ đơn đơn đặt hàng bên Kiotviet cũng thì trên Abaha cũng sẽ ghi nhận là huỷ đơn.
* Abaha chỉ ghi nhận 2 trạng thái đơn đặt hàng là Hoàn thành và Hủy

&#x20;***Lưu ý: Khách hàng cần xử lý trạng thái đơn đặt hàng ở Kiotviet***

**II. CÁC BƯỚC ĐỒNG BỘ**

Thông tin kết nối API (được thiết lập trên hệ thống quản lý trên Kiotviet). Cách thiết lập:\
\
**Bước 1**: **Thiết lập dữ liệu trên phần mềm Kiotviet**

1\. Đăng nhập tài khoản trên Kiotviet chọn -> Quản lý

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2FhWmlAnCb2kGnTTYQZrcS%2FKiot1.jpg?alt=media&amp;token=3bae7483-130f-4dca-8b8c-9522a9b03f6d" alt=""><figcaption></figcaption></figure>

2\. Vào mục: Thiết lập -> Thiết lập cửa hàng

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2Fwj8GtQvkKZ21LbYfON0P%2FKiot2.jpg?alt=media&amp;token=6e53ec45-ab31-4616-829b-5b666e28ce1e" alt=""><figcaption></figcaption></figure>

3\. Chọn menu Thiết lập cửa hàng -> Thiết lập kết nối API -> Tạo mã

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2Fi3m501LW633GBTCJHms0%2FKiot3.jpg?alt=media&amp;token=307b9994-4c03-4674-b4b2-63a05389c774" alt=""><figcaption></figcaption></figure>

4\. Copy các thông tin:

* Tên kết nối: Ví dụ domain truy cập là <https://thoitrangmogi.kiotviet.vn> thì tên kết nối là: thoitrangmogi
* Client ID
* Mã bảo mật

*Lưu ý: Click cho phép truy xuất thông tin khách hàng, hoá đơn, đặt hàng từ gian hàng của bạn.*

5\. Đồng bộ đơn đặt hàng cần cài đặt (Cho phép đặt hàng khi hết tồn kho)

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2FDV9Aih9Fu2Un3quBhuOn%2FKiot4.jpeg?alt=media&amp;token=93d30f79-896e-4d9a-a049-4dc5a651889a" alt=""><figcaption></figcaption></figure>

**Bước 2: Đồng bộ sản phẩm trên web Abaha**

1\.  Tại màn hình quản lý Admin Abaha, bạn chọn: Quản lý sản phẩm -> Đồng bộ

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2FnGfmLFtFg0KNS4h9oBMd%2FKiot5.jpeg?alt=media&amp;token=f0be742c-2af4-4015-ada4-6db8dab1eea6" alt=""><figcaption></figcaption></figure>

Điền thông tin đã có ở bước 1 gồm:

* Tên kết nối
* Client ID
* Mã bảo mật
* Chi nhánh

***Lưu ý:*** *Cần chọn 1 chi nhánh mặc định để đồng bộ. nên chọn chi nhánh trung tâm.*

2\. Ấn *"Đồng bộ"* để tiến hành, chờ hệ thống đồng bộ hai bên

3\. Danh sách sản phẩm sau khi đồng bộ:<br>

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2FrqoicocfNpPmRYN9pRVF%2FKiot6.jpeg?alt=media&amp;token=dfcf8fcd-c298-457c-8740-63cfa6909315" alt=""><figcaption></figcaption></figure>

**III. QUẢN LÝ PHÍ THU KHÁC**

1. Áp dụng khi nào?\
   \
   Khi đơn hàng trên App từ Abaha có áp dụng phí (ví dụ: ship…. v.v), để cân bằng gía trị đơn hàng khi đồng bộ giữa App và Abaha, Khách hàng cần mở chức năng **quản lý thu khác** ở Kiotviet, theo hướng dẫn sau:<br>
2. Hướng dẫn mở chức năng **Quản lý phí thu khác**

**Bước 1:** Vào thiết lâp cửa hàng -> Giao dịch -> Bật thu khác khi bán hàng.

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2FyCRTwQ10ASqMndYawlSy%2Fphi%20thu%20khac.png?alt=media&amp;token=070367db-954b-4fbd-bc11-170f4644c5e8" alt=""><figcaption></figcaption></figure>

**Bước 2:** Vào thiết lập cửa hàng -> Quản lý thu khác -> Thêm loại thu khác

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2FVlLKkZz5JrA0Ni69gine%2Fphi%20thu%20khac%202.png?alt=media&amp;token=7fab5da7-0c36-4161-99ec-b524264d6ce6" alt=""><figcaption></figcaption></figure>

**Lưu ý làm như hình ảnh mô tả:**

* Ô giá trị : Bắt buộc bằng 0
* Bỏ check ô Tự động dựa vào hoá đơn và Hoàn lại đơn
* Ấn "LƯU"

**Bước 3:** Copy mã thu khác

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2F1DXlLXaywQ3xwefnxnYZ%2Fcopy%20ma%20thu%20khac.png?alt=media&amp;token=68d40da7-4037-4501-9bae-518588c5c9e9" alt=""><figcaption></figcaption></figure>

**Bước 4:** Tại đồng bộ Kiotviet ở Abaha, Nhập mã thu khác vừa copy vào ô mã thu khác rồi ấn "ĐỒNG BỘ"

<figure><img src="https://1513765949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Jsy6qlXRuUkJRf3uYrF%2Fuploads%2F1trBFh0tFxngyLSNsh7A%2Fcopy%20ma%20thu%20khac%201.png?alt=media&amp;token=21700056-a5b6-4185-8f5b-72b3905b4aef" alt=""><figcaption></figcaption></figure>
