> For the complete documentation index, see [llms.txt](https://ladipage-vietnam.gitbook.io/v5-ladiflow/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ladipage-vietnam.gitbook.io/v5-ladiflow/tich-hop/huong-dan-tich-hop/tich-hop-kiotviet.md).

# Tích hợp KiotViet

Kể từ sau thời điểm tích hợp KiotViet trên Automation thành công:

* Tất cả khách hàng mới tạo đều được đồng bộ sang Automation
* Tất cả đơn hàng mới tạo, cập nhật, huỷ sẽ cập nhật dữ liệu khách hàng đã có hoặc tạo mới khách hàng
* Tự động cập nhật các thông tin chỉ số liên quan đến đơn hàng của bạn và của từng khách hàng

### Các bước tích hợp Kiotviet

1. Tìm và chọn ứng dụng **KiotViet** trên danh sách ứng dụng tích hợp.

<figure><img src="https://1206056511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMhzSb2lqVdrrRcaVOf97%2Fuploads%2FLcjMLUtZIOKCmmwclIy1%2Fimage.png?alt=media&amp;token=e9669350-e99e-44d1-8819-68f82870c3bd" alt=""><figcaption></figcaption></figure>

2. Chọn **Thêm liên kết.**
3. Mở thêm 1 cửa sổ trình duyệt, truy cập vào kiotviet và đăng nhập với shop của bạn.
4. Tại trang **KiotViet**, Chọn **Setting**, chọn **Thiết lập cửa hàng**, sau đó chọn **Thiết lập kết nối API.**
5. Tại trang Thiết lập kết nối API:

* Điền thông tin **Tên kết nối trùng với tên cửa hàng bạn đã đăng ký;**

<figure><img src="https://content.gitbook.com/content/MhzSb2lqVdrrRcaVOf97/blobs/NkKgzPSqFptIvEWFfCAq/image.png" alt=""><figcaption></figcaption></figure>

* Tích vào **Hoạt động** và **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;**

<figure><img src="https://content.gitbook.com/content/MhzSb2lqVdrrRcaVOf97/blobs/DV52dY64wOCJmOzSffbK/image.png" alt=""><figcaption></figcaption></figure>

Sau đó bấm nút **Lưu.**

6. Sau đó copy lần lượt **Tên kết nối, Client ID, Mã bảo mật** trên **KiotViet** và paste vào **Form trên Automation**
7. Điền **Tên tích hợp**.
8. Sau đó chọn **Lưu kết nối**.

{% hint style="danger" %}
Hiện tại hệ thống không giới hạn số tích hợp KiotViet.
{% endhint %}

### Lưu dữ liệu từ Kiotviet vào trường tùy chỉnh

Sau khi tích hợp KiotViet thành công, khi có Đơn đặt hàng mới, Hóa đơn mới thì dữ liệu khách hàng sẽ tự động về dữ liệu tài khoản **Automation** của bạn.  Các dữ liệu đơn hàng, hóa đơn và khách hàng được tự động lưu vào các trường tùy chỉnh tương ứng.&#x20;

Ngoài ra với 1 số thông tin đặc thù của từng nền tảng, bạn cần phải tạo các trường tùy chỉnh tương ứng:

<table><thead><tr><th width="259">Mã trường</th><th width="174">Loại dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>debt</td><td>Dạng số</td><td>Tổng nợ của khách hàng</td></tr><tr><td>last_total_payment_amount</td><td>Dạng số</td><td>Tổng số tiền thanh toán trong hóa đơn cuối</td></tr><tr><td>last_retailer_id</td><td>Dòng văn bản</td><td>ID cửa hàng Kiotviet</td></tr><tr><td>last_order_status_value</td><td>Dòng văn bản</td><td>Trạng thái hóa đơn/đơn hàng (value)</td></tr><tr><td>kiotviet_sale_channel_name</td><td>Dòng văn bản</td><td><p>Kênh bán hàng </p><p><em>(chỉ lưu được dữ liệu nếu là kênh khác kênh "Bán trực tiếp")</em></p></td></tr><tr><td>kiotviet_delivery_code</td><td>Dòng văn bản</td><td>Mã vận đơn</td></tr><tr><td>kiotviet_branch_name</td><td>Dòng văn bản</td><td>Tên chi nhánh cửa hàng</td></tr><tr><td>kiotviet_branch_id</td><td>Dòng văn bản</td><td>ID chi nhánh cửa hàng</td></tr><tr><td>kiotviet_customer_groups</td><td>Dòng văn bản</td><td>Nhóm khách hàng</td></tr></tbody></table>