# Tích hợp hệ thống POS Haravan

Đối với hệ thống POS Haravan, HUB Platform hỗ trợ đồng bộ các thông tin về Sản phẩm, Khách hàng và Đơn hàng về hệ thống CDP. Trong đó,

* **Sản phẩm** là thông tin được đồng bộ 1 chiều, có nghĩa là thông tin Sản phẩm chỉ được tạo mới và đồng bộ từ Haravan về hệ thống CDP.
* **Khách hàng** và **Đơn hàng** là thông tin được đồng bộ 2 chiều, tức là thông tin Khách hàng và Đơn hàng được tạo trên hệ thống CDP có thể được đẩy về POS tạo thành Khách hàng và Đơn hàng mới ở POS và ngược lại.

## <mark style="color:blue;">Thao tác trên hệ thống Haravan</mark>

### <mark style="color:blue;">1. Tạo ứng dụng cá nhân</mark> <a href="#id-60krov999lj6" id="id-60krov999lj6"></a>

Bằng cách tạo mới ứng dụng cá nhân, Haravan có thể kiểm soát và quản lý quyền truy cập và tài nguyên vào API của họ. Việc này giúp Haravan bảo vệ dữ liệu và đảm bảo rằng chỉ những ứng dụng được xác thực mới có thể truy cập vào dữ liệu của khách hàng của doanh nghiệp trên nền tảng Haravan.

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Đăng nhập hệ thống Haravan</mark>

Truy cập hệ thống Haravan và đăng nhập đúng tài khoản chủ doanh nghiệp của bạn (đây là tài khoản đăng ký Haravan).
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">Vào Ứng dụng riêng</mark>

Sau khi truy cập vào hệ thống Haravan, trên thanh menu bên trái, bạn chọn **Ứng dụng -> Ứng dụng riêng**&#x20;

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

Sau đó nhấn **Tạo ứng dụng riêng**

<figure><img src="/files/UpUPjitqxK6Cc3kEBCJ0" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 3" %}

### <mark style="color:blue;">Tạo ứng dụng riêng mới</mark>

Để tạo ứng dụng riêng mới, bạn thao tác như sau:

* Nhập tên của ứng dụng riêng mà bạn muốn tạo trên Haravan. (Ví dụ: CDP/ MiniCRM...)
* Sau đó chọn **Hiện quyền quản trị API không hoạt động**&#x20;

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

Sau đó chọn tất cả các quyền là **Đọc và ghi**, lưu lại ứng dụng vừa tạo bằng cách ấn vào ![](/files/hK8O1k22i0spcruyg8dK)như sau:

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

Nhấn **Tạo ứng dụng riêng** để xác nhận

<figure><img src="/files/kBWr5TVLlLtUWkcnbIzk" alt="" width="311"><figcaption></figcaption></figure>

{% hint style="info" %}
Chọn tất cả các quyền là đọc và ghi để dữ liệu được đồng bộ từ Haravan sang hệ thống Mini CRM.
{% endhint %}
{% endtab %}

{% tab title="Bước 4" %}

### <mark style="color:blue;">Lưu mã Token</mark>

Sau khi tạo ứng dụng cá nhân ngoài màn hình sẽ có mã token như sau:

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

Bạn vui lòng copy lấy mã token đó để nhập vào hệ thống CDP ở [bước 3](#nhap-token).
{% endtab %}
{% endtabs %}

### <mark style="color:blue;">2. Bật thông báo Webhooks tại hệ thống Haravan</mark> <a href="#id-7s8asihan6lk" id="id-7s8asihan6lk"></a>

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Vào Thông báo của Haravan</mark>

Truy cập tính năng **Cấu hình** chọn **Thông báo**

<figure><img src="/files/XOdu7vwy8symR6QQJiWG" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">Tạo webhook</mark>

Kéo xuống cuối trang **Thông báo**, nhấn chọn **Tạo webhook** trong mục **Webhooks**

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

Để tạo 1 webhook, bạn hãy nhập các thông tin như sau:

* **Sự kiện**: chọn tên sự kiện của Webhook. Tên sự kiện đại diện cho những sự kiện xảy ra ở Haravan mà Webhook này sẽ truyền đến hệ thống CDP.
* **URL**: bạn nhập URL theo format sau: **URL của hệ thống CDP/haravan/webhook**

{% hint style="info" %}
URL bạn truy cập **hệ thống CDP** để lấy.
{% endhint %}

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

Bạn vui lòng tạo 8 webhook có sự kiện như sau:

<figure><img src="/files/cN2mYxL1eUIrztvSBWw4" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## <mark style="color:blue;">Thao tác trên hệ thống CDP HUB Platform</mark>

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Truy cập vào Quản lý Plugin</mark>

Tại màn hình trang chủ hệ thống CDP, nhấn vào biểu tượng **Cài đặt -> Quản lý nền tảng -> Plugins** để vào trang quản lý danh sách các Plugin của hệ thống

<figure><img src="/files/mQb7Hbxwq4qHDfhPZ9tr" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">**Chọn Plugin Haravan**</mark>

Bạn có thể gõ trên thanh tìm kiếm hoặc tìm trực tiếp trên màn hình danh sách để chọn plugin Haravan

<figure><img src="/files/8YzgwxSUvyNcHEcBZt4a" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 3" %}

### <mark style="color:blue;">Nhập Token</mark>

Sau khi chọn Plugin Haravan, bạn hãy paste mã Token vừa copy ở Haravan vào ô Mã API Haravan như dưới đây:

<figure><img src="/files/25AxUTNg3lO5GXMIo9UD" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 4" %}

### <mark style="color:blue;">Lưu kết nối</mark>

Chọn **Lưu** hoặc **Lưu & Đóng** để lưu thao tác tích hợp Haravan vào hệ thống CDP.

Lúc này thông tin khách hàng, đơn hàng và sản phẩm đã được kết nối để đồng bộ từ Haravan về hệ thống CDP.

{% hint style="info" %}

* Thông tin **Khách hàng và Đơn hàng** sẽ được đồng bộ về hệ thống Mini CRM sau 15 phút
* Thông tin **Trạng thái đơn hàng** thì sẽ được đồng bộ liên tục, tần suất là 1 phút/lần.
  {% endhint %}
  {% endtab %}

{% tab title="Bước 5" %}

### <mark style="color:blue;">Kiểm tra đồng bộ thông tin</mark>

Sau khi kết nối 15 phút sau truy cập hệ thống CDP, truy cập module Quản lý khách hàng để kiểm tra dữ liệu được đồng bộ về

Các contact đồng bộ từ Haravan về sẽ có trường tuỳ chỉnh Nguồn = "**Haravan**"

Tại tab **Lịch sử đơn hàng** bạn sẽ xem được thông tin các đơn hàng được đồng bộ về từ Haravan như sau:

<figure><img src="/files/wkIvFMGZW0kVgP7CDhwG" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Trong quá trình kết nối, nếu bạn gặp vấn đề ở bất kỳ bước nào, vui lòng liên hệ với HUB để nhận được hỗ trợ thông qua các nhóm làm việc chung hoặc qua hotline 032.817.9699
{% endhint %}

***

## <mark style="color:blue;">**Giải thích cơ chế kết nối đồng bộ thông tin từ hệ thống Haravan về hệ thống CDP HUB Platform**</mark> <a href="#co-che-dong-bo-haravan-va-minicrm" id="co-che-dong-bo-haravan-va-minicrm"></a>

<details>

<summary><strong>Cơ chế đồng bộ</strong></summary>

Sau khi kết nối, hệ thống sẽ đồng bộ được thông tin về **Khách hàng, Đơn hàng và Sản phẩm** từ Haravan về hệ thống CDP

</details>

<details>

<summary><strong>Sử dụng Id Vendor của Haravan để định danh khách hàng</strong></summary>

Hiện tại Haravan có trường hợp 1 số điện thoại tạo ra được nhiều khách hàng hoặc cùng số điện thoại nhưng sẽ là người mua hàng hoặc người nhận hàng nên sử dụng **Id vendor** để định danh khách hàng, tránh tình trạng đồng bộ sai đơn hàng cho nhận và người mua.

Việc sử dụng **ID vendor** của Haravan để định danh khách hàng giữa 2 hệ thống sẽ giải quyết được vấn đề đồng bộ đúng đơn hàng.&#x20;

Tuy nhiên **cùng 1 số điện thoại** khi đồng bộ từ Haravan về nếu **khác ID vendor** thì hệ thống CDP sẽ tạo ra 2 khách hàng.

</details>

<details>

<summary><strong>Về dữ liệu Khách hàng đồng bộ từ Haravan về CDP như sau:</strong></summary>

* <mark style="color:blue;">**Thông tin khách hàng**</mark> sẽ đồng bộ từ **thông tin liên hệ** tại Haravan.&#x20;
* Trường hợp thông tin liên hệ ở Haravan có trường Phone trống sẽ được lấy tại địa chỉ mặc định của khách hàng. **Địa chỉ mặc định** tại Haravan sẽ được đồng bộ và cập nhật nếu có thay đổi về <mark style="color:blue;">**Địa chỉ của khách hàng**</mark> trong CDP. Đồng bộ toàn bộ dữ liệu địa chỉ của khách hàng về tab **Địa chỉ** trong CDP.
* Đối với **người mua hàng** tại Campaign sẽ có trường thông tin <mark style="color:blue;">**Is Buyer**</mark> **= Yes**
* Đối với **người nhận hàng** (không phải người mua) sẽ có trường thông tin <mark style="color:blue;">**Is Buyer**</mark> **= No**
* Các trường thông tin đồng bộ tại **Hồ sơ khách hàng**:

1. **Id Vendor:** mã định danh khách hàng tại hệ thống Haravan
2. **Is Buyer:** là Yes nếu khách hàng là người mua, No nếu khách hàng là người bán
3. **Nguồn**: Haravan
4. **Revenue**: Doanh thu của khách hàng
5. **Total Orders**: Tổng số đơn hàng mà khách hàng đã đặt
6. **Địa chỉ**: Địa chỉ của khách hàng

</details>

<details>

<summary><strong>Về dữ liệu Đơn hàng đồng bộ từ Haravan về CDP như sau:</strong></summary>

* Đồng bộ tất cả đơn hàng của khách hàng hiển thị tại chức năng **Đơn hàng** trong hệ thống CDP
* Có các thông tin sau:

1. *Order Number*
2. *Order Created*
3. *Payment Status*
4. *Order Status*
5. *Total Price*
6. *Order Store*
7. *Chi tiết thông tin đơn hàng (giá trị và sản phẩm, địa chỉ nhận hàng)*

* Nếu là người mua hàng **(Is Buyer = yes)** thì thông tin khách hàng mua đơn hàng đó sẽ cập nhật vào Quản lý khách hàng
* Nếu là người bán hàng **(Is Buyer= No)** thì thông tin contact sẽ được tạo mới và thông tin order được cập nhật cho người mua hàng
* **Quy tắc tính&#x20;**<mark style="color:blue;">**Total Orders**</mark>**&#x20;và&#x20;**<mark style="color:blue;">**Revenue**</mark>**&#x20;cho khách hàng như sau:**

Nếu đơn hàng có:

1. ***Payment Status = paid***  ->  Cộng luôn giá trị đơn hàng vào Revenue của khách hàng.

* Có đơn hàng được tạo mới thì số lượng đơn trong **Total Orders** sẽ tăng lên.
* Đối với đơn hàng ở trạng thái hủy sẽ trừ **Revenue** và trừ **Total Orders.**

2. ***Payment Status = Partially\_refunded*** không tính Total shipping (Haravan có tính)

</details>

<details>

<summary><strong>Kết nối đẩy thông tin khách hàng từ CDP sang Haravan</strong></summary>

HUB Platform hỗ trợ doanh nghiệp đẩy thông tin khách hàng từ hệ thống CDP sang hệ thống Haravan. Các trường thông tin đồng bộ sang bao gồm:

1. <mark style="color:blue;">**Họ tên**</mark>
2. <mark style="color:blue;">**Email**</mark>
3. <mark style="color:blue;">**Facebook**</mark>

</details>


---

# 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://help-cdp.hub-js.com/data-collect/tich-hop-du-lieu/tich-hop-he-thong-pos-haravan.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.