# Kết nối NhanhVN

## Tổng quan

NhanhVN là giải pháp quản lý bán hàng trên nền tảng điện toán đám mây, đồng bộ dữ liệu với website, dịch vụ vận chuyển, giúp doanh nghiệp quản lý toàn bộ quy trình bán hàng, chăm sóc khách hàng, tăng doanh thu, giảm chi phí, phát triển kinh doanh hiệu quả hơn.

Việc tích hợp NhanhVN vào AppVNcũng giống như các nền tảng khác, sẽ giúp cho người dùng có thể đồng bộ được đơn hàng và thông tin khách hàng về AppVN là ứng dụng các kịch bản tự động, để chăm sóc lại theo từng tệp khách hàng mà người dùng muốn.

## Kết nối

Để kết nối NhanhVN vào AppVN, 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/7MNWNu38loQvankJm9nN" 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:
  * **Tên nền tảng:** Đặt tên cho kết nối, ví dụ tên shop là NhanhVN
  * **Nền tảng:** Chọn NhanhVN
  * **Kết nối với NhanhVN**: Kết nối tài khoản NhanhVN và xác thực quyền truy cập.

    <figure><img src="/files/VZx4RQp429fQmQxkKtfL" alt=""><figcaption></figcaption></figure>
* Bấm **Kết nối với NhanhVN**, màn hình hiển thị popup đăng nhập, người dùng đăng nhập thông tin tài khoản NhanhVN muốn kết nối vào AppVN

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

* &#x20;Bấm **Đồng ý** để xác thực quyền truy cập, cho phép SmaxApp đồng bộ dữ liệu

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

  **Lưu ý:**&#x20;

  * Nếu gặp thông báo lỗi **Doanh nghiệp chưa mở cài đặt cho phép kết nối Open API, hoặc tài khoản chưa được cấp quyền**, vui lòng bật quyền cho phép kết nối Open API theo hướng dẫn phía dưới, sau đó đăng nhập lại và cấp quyền truy cập.

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

    * Bước 1: Truy cập vào giao diện **Cài đặt** của phần mềm quản lý NhanhVN

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

    * Bước 2: Tại khung Cài đặt Open API, người dùng bật tính năng Cho phép kết nối Open API (chỉ tài khoản được cấp quyền cao nhất là Giám đốc mới có thể mở được)

    <figure><img src="/files/a5FpFDpHTKpo9VGo4zwV" 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/Kht433hXzn494MvSEZRO" alt=""><figcaption></figcaption></figure>

## Đồng bộ 2 chiều

### Đồng bộ t**ừ Nhanh -> SmaxApp**

**Kích hoạt webhook :** hỗ trợ đồng bộ thông tin đơn hàng theo thời gian thực

* Thêm mới đơn hàng
* Cập nhật đơn hàng
* Xóa đơn hàng
* Cấu hình tạo khách hàng cho những đơn chưa ký tự ẩn (nếu không chọn thì hệ thống sẽ không tạo khách hàng)&#x20;
* Không đồng bộ đơn hàng có nguồn từ sàn TMDT.

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

* **Đồng bộ điểm Loyalty và Coupon từ Nhanh -> SmaxApp**

  * Đồng bộ điểm Loyalty: Tự động quét khách hàng có điểm loyalty từ NhanhVN về SmaxApp sau khi kết nối thành công
  * Đồng bộ mã giảm giá (Coupon): Tự động chương trình và mã giảm giá mới nhất từ khi tích hợp NhanhVN về SmaxApp.

### **Đồng bộ từ Smax App -> NhanhVN**:

Tự động đồng bộ đơn hàng từ SmaxApp sang NhanhVN

* Tạo đơn hàng
* Cập nhật đơn hàng
* Cấu hình các điều kiện cập nhật đơn hàng theo Trạng thái đơn, Thông tin khách hàng và Nguồn đơn

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

* **Mapping thông tin nhân viên**

NhanhVN hiện tại đang hỗ trợ mapping nhân viên với 2 vai trò: Người tạo đơn và Nhân viên phụ trách (NVBH).&#x20;

Khi đồng bộ đơn từ NhanhVN sang AppVN, hệ thống sẽ hiển thị đúng vai trò nhân viên đã mapping.

Chiều ngược lại, khi tạo đơn từ AppVN sang NhanhVN, người tạo đơn mặc định là AppVN, còn NVBH là nhân viên đã được gán.

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

* Người dùng tích chọn kích hoạt và bấm **Thêm** để hoàn thành việc kết nối.

### **Trạng thái đơn**

#### **Các trạng thái đơn hàng khi đơn hàng được đồng bộ NhanhVN => AppVN**

|    NhanhVN    |   SmaxApp   |
| :-----------: | :---------: |
|      Mới      |   Đơn mới   |
|  Chờ xác nhận |     Chờ     |
| Đang xác nhận |     Chờ     |
|  Đã xác nhận  |   Lên đơn   |
|    Hết hàng   |     Chờ     |
|  Đổi kho hàng | Đã gửi hàng |
| Đang đóng gói |   Lên đơn   |
|  Đã đóng gói  |   Lên đơn   |
|  Chờ thu gom  | Đã gửi hàng |
|  Đang chuyển  | Đã gửi hàng |
|   Thành công  |   Đã nhận   |
|    Thất bại   | Đã gửi hàng |
|   Khách hủy   |    Đã hủy   |
|  Hệ thống hủy |    Đã hủy   |
|    HVC hủy    |    Đã hủy   |
|   Đang hoàn   |   Đã hoàn   |
| Xác nhận hoàn |   Đã hoàn   |
|    Đã hoàn    |   Đã hoàn   |

#### **Các trạng thái đơn hàng khi đơn hàng được đồng bộ AppVN => NhanhVN**

|   SmaxApp   |    NhanhVN   |
| :---------: | :----------: |
|     Nháp    |  Đã xác nhận |
|   Đơn mới   |  Đã xác nhận |
|     Chờ     |  Đã xác nhận |
|   Lên đơn   |  Đã xác nhận |
| Đã gửi hàng |  Đã xác nhận |
|   Đã nhận   |  Thành công  |
|   Đã hoàn   | Không hỗ trợ |
|    Đã hủy   | Hệ thống hủy |

## <mark style="color:blue;">Lưu ý quan trọng</mark>

> <mark style="color:blue;">Để đồng bộ được đơn hàng từ AppVN => NhanhVN, cần lưu ý:</mark>
>
> * <mark style="color:blue;">Người dùng NÊN chọn sync với các đơn ĐÃ KHÓA thay vì đồng bộ tất cả các đơn, vì hiện tại hệ thống chỉ hỗ trợ CẬP NHẬT các thông số liên quan tới số tiền thanh toán. Các thông tin khác (giỏ hàng, khách hàng,...) chưa hỗ trợ cập nhật.</mark>
> * <mark style="color:blue;">Đơn hàng có giỏ hàng là các sản phẩm đã được mapping</mark>
> * <mark style="color:blue;">Số điện thoại khách hàng phải hợp lệ</mark>
> * <mark style="color:blue;">Hệ thống không đồng bộ các đơn hàng có số tiền phụ thu</mark>
> * <mark style="color:blue;">Không hỗ trợ trạng thái hoàn</mark>


---

# 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-nhanhvn.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.