# Kết nối Misa AMIS CRM

## Mục tiêu:

* Thông qua Mini App để thiết lập kết nối giữa CRM của Misa là AMIS và CNVCDP (CNV) với chức năng đồng bộ thông tin giữa 2 bên
* Mini app: Đồng bộ Misa AMIS CRM

## Lưu ý trước khi bắt đầu

### Liên hệ và Khách hàng

* Phía MISA CRM, thông tin khách hàng có 2 loại 
  * Liên hệ (Contact) và 
  * Khách hàng (Customer + Company) 
* Phía CNV chỉ có loại Khách hàng (Customer)

➜ Khi đồng bộ khách hàng từ MISA → CNV, sẽ ưu tiên Khách hàng (Customer + Company)

### Đồng bộ từ MISA → CNV

**Đồng bộ Đơn hàng,** nếu đơn hàng có

* Cả thông tin Khách hàng và Liên hệ → Lấy Khách hàng của đơn MISA làm Khách hàng trong đơn CNV
* Chỉ có thông tin Khách hàng → Lấy Khách hàng của đơn MISA làm Khách hàng trong đơn CNV
* Chỉ có thông tin Liên hệ → Lấy Liên hệ của đơn MISA làm Khách hàng trong đơn CNV

**Đồng bộ Liên hệ:** 

* Nếu đã tồn tại 1 khách hàng của CNV trùng số điện thoại: 
  * Nếu khách hàng của CNV có loại mapping là CONTACT: update thông tin
  * Nếu khách hàng của CNV có loại mapping là CUSTOMER: Không update thông tin và báo rằng đã có 1 khách hàng có số điện thoại này
* Nếu chưa tồn tại khách hàng của CNV trùng số điện thoại: 
  * Tạo mới khách hàng CNV, mapping sẽ là loại CONTACT

**Đồng bộ Khách hàng:**

* Nếu đã tồn tại 1 khách hàng của CNV trùng số điện thoại: 
  * Ghi đè thông tin
* Nếu chưa tồn tại khách hàng của CNV trùng số điện thoại
  * Tạo mới khách hàng CNV, mapping sẽ là loại CUSTOMER

### Đồng bộ từ CNV → MISA

**Đồng bộ Đơn hàng:**

* Khách hàng CNV sẽ được gán làm Khách hàng trong đơn của MISA

**Đồng bộ Khách hàng:**

* Tạo mới : Sẽ tạo mới khách hàng MISA
* Cập nhật :
  * Nếu mapping là CONTACT thì sẽ update Liên hệ MISA
  * Nếu mapping là CUSTOMER thì sẽ update Khách hàng MISA<br>

### Sản phẩm

Đồng bộ từ MISA về sẽ có số lượng sản phẩm là vô hạn  ( vì lấy MISA làm gốc, và bên MISA không public api về phần tồn kho nên CNV không lấy được thông tin ) <br>

### Các thông tin kết nối từ Misa

Có thể lấy trước các thông tin kết nối từ Misa

1. Truy cập vào <https://amisapp.misa.vn/crm/settings/navigation>
2. Tìm đến Ký hiệu thiết lập ở góc phải

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

3. Trong mục Kết nối, chọn API

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

3. Copy **AppID** và **Mã bảo mật**

**Ví dụ:**

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

## Import dữ liệu cũ bằng File Excel

### Bước 1: Tải về mẫu Excel

{% file src="/files/-MiqsAxU8rm\_CFeqX0ZU" %}
Mẫu file Khách hàng
{% endfile %}

{% file src="/files/-Mir8aMxQVxCWQFjLsDW" %}
Mẫu file Đơn hàng
{% endfile %}

{% file src="/files/-Mir5YQwd1PcxBdd1\_S3" %}
Mẫu file Nhóm sản phẩm
{% endfile %}

{% file src="/files/-MiqsXOQvLOeOmwRpDIM" %}
Mẫu file Sản phẩm
{% endfile %}

### Bước 2: Nhập dữ liệu theo mẫu Excel

* [Hướng dẫn Import dữ liệu](https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/import-du-lieu-cu)

### Bước 3: Liên hệ CNV Loyalty để cập nhật dữ liệu

* Email: <cskh@cnvloyalty.com>

<mark style="color:red;">**Chú ý:**</mark> Để tránh dữ liệu bị nghẽn, khi Import dữ liệu qua file excel, cần tắt cài đặt cho mục Đẩy dữ liệu như trong hình. Sau đó bật lại.

Để vào mục này, tiếp tục các bước tiếp theo đến phần **Thêm cài đặt chi tiết kết nối ở Hub CDP** bên dưới.

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

## Thêm kết nối tới Misa AMIS

**Truy cập vào app đồng bộ:**

1. Truy cập vào [hub.cnvcdp.com](http://hub.cnvcdp.com)&#x20;
2. Trong menu chính, chọn Ứng dụng (B1)
3. Trong menu phụ, chọn mục POS (B2)
4. Tìm App “Đồng bộ Misa AMIS CRM” và Mở ứng dụng (B3)

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

**Thêm kết nối**

1. Click vào “Thêm kết nối” (B1)
2. Điền các thông tin kết nối

* Sử dụng các thông tin lấy trước từ Misa
* Điền thông tin (B2):
  * Tên tích hợp điền tự do
  * Điền AppID vào Bước 2
  * Điền Mã bảo mật vào Bước 3

3. CLick Kết nối ứng dụng (B3)

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

## Thêm cài đặt chi tiết kết nối ở Hub CDP

**Trong giao diện app Đồng bộ Misa AMIS CRM**

1. Chọn 1 ID hay Tên kết nối bất kỳ

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

2. Trong trang vừa mở, tìm đến phần đường dẫn - link web - trong hình

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

3. Copy đoạn text sau (gọi là secret key) và dán thêm vào sau đường dẫn đó:

**?cs=b7bae0c1-2176-4c85-a10b-d9b1b7a2cf10**

4. Nhấn Enter, phần Danh Mục sẽ thấy xuất hiện thêm các mục khác

**Chú ý:** Sau khi nhấn Enter giữ ở trang có các mục mới này

* Nếu lỡ thoát khỏi giao diện app KiotViet, quay lại thực hiện các bước vừa rồi để có menu đầy đủ các mục

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

Do tính năng hiện tại không để khách tự setup, nên cần có mã secret key trên để truy cập vào các bước tiếp theo

## Webhook

Chú ý: MISA AMIS CRM không public tài liệu về webhook nên CDP sẽ không xử lý, sẽ sử dụng Kéo dữ liệu thủ công và Kéo dữ liệu định kỳ để thay thế

## Kéo dữ liệu thủ công / định kỳ

**Thủ công:**

1. Chọn Kéo dữ liệu trong Danh mục
2. Bấm Tạo mới và Thủ công để tạo các chiến dịch kéo dữ liệu thủ công

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

3. Bấm Thêm loại và chọn mục dữ liệu cần kéo

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

<br>

4. Chọn Từ ngày: đầy đủ thời gian từ khi tạo lập shop
5. Tên đồng bộ: điền tự do
6. Tài khoản kết nối: sẽ được chọn mặc định và chỉ có 1 option

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

7. Bấm **Kích hoạt**

Kiểm tra dữ liệu đã chạy:

Quá trình chạy chiến dịch đồng bộ nếu có lỗi thì thông tin sẽ hiện thị trong Traffic và Dữ liệu lỗi.

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

**Định kỳ**

1. Bấm Tạo mới và Định kỳ để tạo các chiến dịch kéo dữ liệu định kỳ

* Các chiến dịch này sẽ chạy tự động theo chu kỳ được cài đặt

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

2. Điền thông tin tạo kéo dữ liệu:
3. Tên đồng bộ: điền tự do
4. Tài khoản kết nối: sẽ được chọn mặc định và chỉ có 1 option
5. Thời gian: Việc đồng bộ sẽ chạy tự động sau mỗi chu kỳ thời gian này
6. Chọn Loại dữ liệu cần đồng bộ

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

7. Bấm Tạo mới
8. Quay về mục Kéo dữ liệu, trong danh sách chọn kéo dữ liệu vừa tạo
9. Có thể chỉnh sửa thiết lập và Lưu thông tin
10. Kéo dữ liệu định kỳ sẽ chạy sau khi bấm **Kích hoạt**\ <br>

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

## Đẩy dữ liệu

Hiện tại chỉ hỗ trợ đồng bộ dữ liệu chiều CNV -> MISA cho **Đơn hàng, Khách hàng**

&#x20;\-  Đơn hàng: sẽ Tạo/ Cập nhật sang MISA

&#x20;\-  Khách hàng: Tạo/Cập nhật khách hàng sang MISA

<br>

<figure><img src="/files/0ad8NlP4Jq7uggnqtH5e" alt=""><figcaption></figcaption></figure>

<br>

## Hủy kết nối

Trong trường hợp kết nối sai shop MISA hoặc muốn hủy MISA và kết nối pos khác

1. Vào mini app Đồng bộ Misa AMIS CRM
2. Mở kết nối cần hủy và bấm Gỡ cài đặt

<br>

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

\
\
\
\
\
\
\ <br>


---

# 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://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/ket-noi-misa-amis-crm.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.