# Tích hợp TopShip

{% hint style="warning" %}
Lưu ý:

* Tính năng đã tạm ngưng từ 12/2022, chỉ áp dụng cho các khách hàng kết nối trước đó và nếu ngắt kết nối sẽ không hỗ trợ kết nối lại.
  {% endhint %}

## Những điều cần lưu ý

| STT | Lưu ý                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| :-: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  1  | <p>Topship đang tích hợp với rất nhiều hệ thống giao vận khác như GHN, GHTK, ViettelPost, Ahamove, J\&T Express, Ship60, DHL, NinjaVan, Snappy,...</p><ul><li>Nếu doanh nghiệp có <strong>tài khoản Etop</strong> và tài khoản đó chỉ ký hợp đồng với GHN thì doanh nghiệp chỉ thấy và sử dụng được GHN</li><li>Nếu doanh nghiệp <strong>ký hợp đồng với Topship</strong> thì sẽ thấy <em>tất cả các hệ thống giao vận đã được tích hợp</em> trong Topship, <em><strong>trừ Ahamove</strong></em> (vì Ahamove thuộc diện giao hàng tức thời, TopShip ko mở API này cho đối tác sử dụng)</li></ul> |
|  2  | Các hệ thống đã được tích hợp với Topship sẽ **không bao gồm tất cả các service** của hệ thống đó, TopShip chỉ ký hợp đồng với các nhà vận chuyển để sử dụng một số dịch vụ nhất định                                                                                                                                                                                                                                                                                                                                                                                                             |
|  3  | Cần **kiểm tra kỹ** và **nhập đúng** địa chỉ email đăng ký TopShip ở Loyalty Hub                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|  4  | Sau khi kết nối với, vui lòng **không thay đổi thông tin** trong quá trình CNV đồng bộ dữ liệu                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|  5  | <p>Tài khoản kết nối phải là</p><ul><li>Admin của Loyalty Hub</li><li>Admin của TopShip</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|  6  | <p>Điền đầy đủ địa chỉ đại lý, chi nhánh, đặc biệt là thông tin về khu vực của Kho hàng phải được cập nhật chính xác</p><ul><li><a href="https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/dia-diem">Hướng dẫn Thêm khu vực địa điểm</a></li></ul>                                                                                                                                                                                                                                                                                                                                               |

## Kết nối với TopShip

### Bước 1: Vào Cấu hình ➝ Vận chuyển&#x20;

![](/files/-Mclmt-yxM2MDuUqjaTI)

### Bước 2: Thêm TopShip

1. Chọn Thêm nhà vận chuyển
2. Chọn nút :heavy\_plus\_sign:

![](/files/-Md2DrDfWXaSD6w9bL1h)

### Bước 3: Chọn Kết nối nhà vận chuyển

![](/files/-Md27W0UO_f2_cnmStDX)

### Bước 4: Nhập thông tin

1. Nhập địa chỉ Email
   * Doanh nghiệp đã có tài khoản TopShip: nhập email đã đăng ký TopShip
   * Doanh nghiệp chưa có tài khoản TopShip: nhập email bạn muốn đăng ký TopShip
2. Chọn Lưu

![](/files/-MdHhobLMuwhIu-W9fr1)

Sau khi *Lưu*, website chuyển đến trang đăng nhập TopShip, tiếp tục thực hiện các bước sau:

## 1. Doanh nghiệp đã có tài khoản TopShip <a href="#buoc-4-nhap-email-hoac-so-dien-thoai-de-ket-noi" id="buoc-4-nhap-email-hoac-so-dien-thoai-de-ket-noi"></a>

### Bước 5: Đăng nhập TopShip

1. Nhập Email hoặc Số điện thoại
   * Sử dụng Email đã nhập ở bước 4 để **đồng bộ tài khoản** giữa CNV với TopShip
2. Chọn Đăng nhập

![](/files/-MdHiNhyDxjnmBr6bW_3)

### Bước 6: Nhập mã xác nhận

1. Nhập mã xác nhận
   * Nếu đăng nhập bằng mail, mã xác nhận sẽ được gửi về mail
   * Nếu đăng nhập bằng số điện thoại, mã xác nhận sẽ được gửi về số điện thoại
2. Chọn Tiếp tục

![](/files/-Md2b1UXgP3wDHGFU3gI)

{% hint style="info" %}
Mã xác nhận có hiệu lực trong 2 giờ. Bằng việc nhập mã xác nhận, bạn đồng ý cấp quyền cho CNV tạo vận đơn với tư cách của bạn
{% endhint %}

## 2. Doanh nghiệp chưa có tài khoản TopShip

Sau khi hoàn tất bước 5 và bước 6, tiếp tục thực hiện:

### &#x20;Bước 7: Nhập Thông tin

1. Nhập Thông tin tài khoản **(bắt buộc)**
   * Họ và Tên
   * Tên Shop
   * Số điện thoại liên hệ
   * Email
     * Sử dụng Email đã nhập ở bước 4 để **đồng bộ tài khoản** giữa CNV với TopShip
2. Chọn Thông báo
   * Nhận email liên hệ từ đội ngũ TopShip
   * Bằng việc đăng ký tôi đồng ý với điều khoản sử dụng dịch vụ **(bắt buộc)**
3. Chọn Đăng kí

![](/files/-MdHjbzvhFsJrgXbGD6s)

### Đăng nhập thành công

* Bạn sẽ được cung cấp mật khẩu [đăng nhập TopShip](https://pos.etop.vn/login) qua email

![](/files/-McmbQwQmKc0W7u7iSzH)

{% hint style="success" %}

* Truy cập TopShip để cài đặt
  * Thay đổi mật khẩu
  * Xác thực số điện thoại đã đăng ký TopShip
  * Thiếp lập Thông tin liên hệ và Thông tin doanh nghiệp
  * Kết nối với các Nhà vận chuyển
  * Đối soát số tiền thu hộ
    {% endhint %}

### Kết nối TopShip thành công

![](/files/-Md2YpB0dexja5EnOvsY)


---

# 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/van-chuyen/tich-hop-topship.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.