Đồng bộ nhanh.vn

Estimated reading: 11 minutes 2139 views

I. Giới thiệu:

1. Tính năng là gì?

Tính năng này cho phép kết nối Nhanh.vn – nền tảng quản lý bán hàng trực tuyến – với Zalo Mini App trên nền tảng Zacademy. Toàn bộ dữ liệu về sản phẩm, đơn hàng, khách hàng và nhóm sản phẩm được đồng bộ hai chiều, giúp quản lý tập trung và nâng cao trải nghiệm khách hàng trên Zalo.

2. Đối tượng sử dụng

Các cửa hàng, doanh nghiệp đang sử dụng Nhanh.vn làm kênh bán hàng chính.
Shop muốn mở rộng kênh bán qua Zalo Mini App mà không muốn nhập liệu thủ công.
Doanh nghiệp cần đồng bộ thông tin đơn hàng, sản phẩm giữa website và kênh Zalo để giảm sai sót và tăng hiệu quả bán hàng.

3. Lợi ích chính

Sản phẩm từ Nhanh.vn tự động đồng bộ hai chiều với Zalo Mini App.
Nhóm sản phẩm đồng bộ một chiều từ Nhanh.vn sang Zalo Mini App.
Đơn hàng và khách hàng đồng bộ hai chiều giữa Nhanh.vn và Zalo Mini App.
Cập nhật trạng thái sản phẩm và tồn kho theo thời gian thực, giúp quản lý chính xác.
Tiết kiệm thời gian nhập liệu thủ công, giảm rủi ro sai sót.
Tăng trải nghiệm mua sắm liền mạch và chuyên nghiệp trên Zalo.

4. Điều kiện và cách triển khai

Điều kiện sử dụng:

Khách hàng cần sử dụng gói dịch vụ Nhanh.vn có hỗ trợ API / OAuth (thường là các gói trả phí hoặc nâng cao).
Liên hệ với Nhanh.vn để mở quyền truy cập API / OAuth, nhận các thông tin như App ID, Secret Key, Access Token.
Tài khoản Nhanh.vn phải có quyền quản trị viên để cấp phép và cấu hình kết nối.

5. Quy trình triển khai:

Liên hệ với Nhanh.vn để mở API và nhận thông tin cấu hình.
Thực hiện quy trình OAuth để lấy mã ủy quyền (Authorization code) và access_token.
Đăng nhập hệ thống Zacademy Admin → chọn phần mềm Nhanh.vn.
Nhập tên shop (Alias) và access_token.
Cấu hình các thông số như chi nhánh, nguồn đơn, nhân viên, phương thức thanh toán.
Chọn các mục cần đồng bộ và nhấn “Đồng bộ” để bắt đầu kết nối.

II. Hướng dẫn đồng bộ:

A. Các danh mục đồng bộ:

Dữ liệu	Zacademy	Nhanh.vn
1. Danh mục sản phẩm		✓
2. Sản phẩm		✓
3. Đơn đặt hàng	✓	✓
4. Khách hàng	✓	✓

Chú thích:

Dấu “✓” thể hiện được đồng bộ.

1. Danh mục sản phẩm – Sản phẩm

Đối với đồng bộ danh mục – sản phẩm hệ thống Zacademy đồng bộ một chiều với Nhanh.vn.

Điều kiện để đồng bộ sản phẩm: Bật chức năng đồng bộ sản phẩm

Đồng bộ sản phẩm với nhanh có 2 loại: đồng bộ giá bán lẻ và đồng bộ giá sỉ

Chọn Giá sỉ hệ thống sẽ tự đồng bộ giá sỉ về Zacademy
Chọn Giá lẻ hệ thống sẽ đồng bộ giá bán lẻ về Zacademy

Bật tính năng đồng bộ giá đã bao gồm VAT:

Lưu ý:

Hệ thống sẽ không cập nhật thông tin về tên, trạng thái của danh mục khi có thay đổi ở bên Nhanh, chỉ cập nhật danh mục cha con và thời gian cập nhật.

Nếu sản phẩm chưa tồn tại bên Zacademy mặc định sẽ chỉ đồng bộ những sản phẩm ở trạng thái hiển thị, nếu sản phẩm đã tồn tại bên Zacademy mới thực hiện cập nhật theo trạng thái của sản phẩm.
Sản phẩm bị xóa bên nhanh sẽ không cập nhật trạng thái ẩn bên app

2. Đơn hàng :

Đối với đồng bộ đơn hàng với Nhanh hệ thống Zacademy đồng bộ hai chiều: đồng bộ đơn từ Nhanh về Zacademy và chiều ngược lại đồng bộ đơn từ Zacademy sang Nhanh (còn gọi là đẩy đơn)

Điều kiện để đồng bộ đơn hàng:

Nếu đơn hàng chứa sản phẩm và khách hàng đã tồn tại bên Zacademy => Cần bật chức năng Đồng bộ đơn hàng
Nếu đơn hàng chứa sản phẩm chưa tồn tại bên Zacademy và khách hàng đã tồn tại bên Zacademy => Cần bật chức năng Đồng bộ đơn hàng và Đồng bộ sản phẩm
Nếu đơn hàng chứa sản phẩm đã tồn tại bên Zacademy và khách hàng chưa tồn tại bên Zacademy => Cần bật chức năng Đồng bộ đơn hàng và Đồng bộ khách hàng
Điều kiện để đẩy đơn sang Nhanh: Bật chức năng Đồng bộ đơn hàng

Các thông tin đơn hàng được đẩy sang POS và đồng bộ về Zacademy bao gồm:

Mã đơn hàng bên Nhanh
Ghi chú đơn hàng bên Nhanh
ID đơn hàng bên Nhanh
Thời gian đặt hàng bên Nhanh
Trạng thái giao hàng bên Nhanh

Lưu ý:

Không đồng bộ địa chỉ giao hàng
Với đơn hàng lần đầu đồng bộ về Zacademy sẽ không đồng bộ đơn trạng thái Hủy, nếu đơn hàng đã tồn tại bên Zacademy mới cập nhật trạng thái Hủy
Các đơn đẩy từ Zacademy sang sẽ ở trạng thái đặt hàng chứ không đẩy theo được các trạng thái tương ứng như bên Nhanh
Đơn đã tồn tại bên Zacademy khi có thay đổi bên POS mới được cập nhật
Thông tin về khách hàng và sản phẩm trong đơn sẽ được tìm theo id để lấy dữ liệu
Các trạng thái đơn Zacademy tương ứng với bên Nhanh (áp dụng cho đồng bộ đơn)

3. Khách hàng

Đối với đồng bộ Khách hàng hệ thống Zacademy đồng bộ một chiều với Nhanh.vn

( Chiều từ Zacademy: thì đẩy khách hàng sang Nhanh.vn kèm theo trong đơn hàng).

Điều kiện để đồng bộ khách hàng: Bật chức năng Đồng bộ khách hàng

Các thông tin khách hàng đẩy sang:

Số điện thoại khách hàng bên Nhanh
ID của khách hàng bên Nhanh

Lưu ý:

Không đồng bộ tên khách hàng mặc định khi đồng bộ về sẽ lấy tên là Khách (do hệ thống bên thứ 3 có thể đặt tên khách hàng không mong muốn)
Chỉ đồng bộ khách hàng có số điện thoại

4. Tin tức

Để đồng bộ tin tức cần bật chức năng Đồng bộ tin tức

Các thông tin đồng bộ danh muc tin -tin tức

Danh mục tin:

Tiêu đề danh mục tin tức

ID danh mục tin tức bên Nhanh

Thời gian tạo danh mục bên Nhanh

Thời gian cập nhật danh mục bên Nhanh

Tin tức

Tiêu đề tin tức
Trích dẫn tin tức
Nội dung tin tức
Ảnh tin tức
Trạng thái tin tức

Lưu ý quan trọng khi vận hành đồng bộ:

1. Chỉ đồng bộ được với Nhanh.vn khi khách hàng sử dụng gói dịch vụ là gói doanh nghiệp (Gói enterprise) của Nhanh.vn

2. Không được xoá sản phẩm ở Nhanh.vn

3. Không được xoá sản phẩm thuộc tính ở Nhanh.vn

4. Không được đổi sản phẩm thuộc tính là sản phẩm con của sản phẩm khác.

5. Không được xoá khách hàng ở Nhanh.vn

6. Thao tác xử lý trạng thái đơn hàng sẽ diễn ra trên Nhanh.vn không xử lý trạng thái đơn trên Zacademy

7. Do nhanh.vn định danh tài khoản người dùng nằm luôn trong phần địa chỉ giao hàng cụ thể là số điện thoại, không khớp với trên App là người dùng có thể dùng chính số điện thoại đó làm định danh, nhưng số điện thoại địa chỉ giao hàng có thể khác ( Zacademy đã note: SĐT người nhận trước phần thông tin địa chỉ đơn hàng) để đảm bảo việc đồng bộ giữa App và Nhanh.vn

8. Note về phí ship, tích điểm, khuyến mãi được ghi bổ sung trong ghi chú đơn hàng