1. Tổng quan về hệ thống

Tài liệu này cung cấp hướng dẫn chi tiết về quy trình và luồng hoạt động đồng bộ hóa dữ liệu giữa hệ thống quản lý bán hàng KiotViet và hệ thống nội bộ EvoTech. Việc tích hợp này được thực hiện thông qua KiotViet API và cơ chế Webhook, đảm bảo dữ liệu được cập nhật gần như theo thời gian thực, tối ưu hóa hiệu quả vận hành và quản lý.
Các đối tượng dữ liệu chính được đồng bộ: Hệ thống hỗ trợ đồng bộ các đối tượng dữ liệu quan trọng sau:

• Sản phẩm (Product): Đồng bộ một chiều từ KiotViet sang EvoTech.

• Đơn hàng (Order): Đồng bộ hai chiều giữa KiotViet và EvoTech.

• Khách hàng (Customer): Đồng bộ một chiều từ KiotViet sang EvoTech.

• Danh mục (Category): Tự động tạo mới trong EvoTech khi cần thiết dựa trên dữ liệu từ KiotViet.

• Tồn kho (Stock): Cập nhật theo thời gian thực để đảm bảo tính chính xác.

2. Tính năng đồng bộ dữ liệu

Hệ thống EvoTech sử dụng các cơ chế đồng bộ tiên tiến để đảm bảo tính toàn vẹn và cập nhật của dữ liệu.

Đồng bộ dữ liệu từ KiotViet (KiotViet → EvoTech):

• Hệ thống EvoTech sử dụng Webhook do KiotViet cung cấp để nhận dữ liệu tức thời khi có bất kỳ thay đổi nào.

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

• Tạo mới / Cập nhật đơn hàng:

• Webhook KiotViet: order.update, invoice.update

• Quy trình xử lý:

  • KiotViet tạo/cập nhật đơn hàng.

  • Webhook gửi dữ liệu đơn hàng đến EvoTech.

  • Hệ thống EvoTech lấy thông tin khách hàng liên quan từ KiotViet API.

  • Tìm kiếm hoặc tạo mới người dùng (User) trong EvoTech.

  • Kiểm tra sự tồn tại của đơn hàng trong EvoTech (dựa trên ExternalId).

  • Cập nhật đơn hàng hiện có hoặc tạo mới đơn hàng.

  • Tìm kiếm hoặc tạo mới sản phẩm trong EvoTech.

  • Đồng bộ chi tiết sản phẩm trong đơn hàng.

  • Ánh xạ trạng thái đơn hàng giữa KiotViet và EvoTech.

  • Hoàn tất quá trình đồng bộ.

• Xử lý khách hàng:

  • Tự động lấy thông tin khách hàng từ KiotViet API.

  • Tìm kiếm người dùng trong EvoTech theo tên hoặc tạo mới nếu chưa tồn tại.

  • Cập nhật thông tin liên hệ của khách hàng.

• Xóa đơn hàng:

  • Webhook KiotViet: invoice.delete

  • Quy trình xử lý: Tìm và xóa đơn hàng trong EvoTech dựa trên ExternalId tương ứng.

Đồng bộ Khách hàng

• Webhook KiotViet: customer.update, customer.delete

• Quy trình xử lý:

  • Nhận dữ liệu khách hàng từ KiotViet.

  • Tìm kiếm người dùng trong EvoTech theo tên.

  • Cập nhật thông tin khách hàng hiện có hoặc tạo mới nếu chưa tồn tại.

Đồng bộ Danh mục

• Webhook KiotViet: category.update, category.delete

• Quy trình xử lý:

  • Tự động tạo danh mục mới trong EvoTech khi có sản phẩm mới liên quan.

  • Cập nhật tên danh mục khi có thay đổi từ KiotViet.

Đồng bộ dữ liệu lên KiotViet (EvoTech → KiotViet)

• (Phần này cần được bổ sung chi tiết về các đối tượng dữ liệu và quy trình đồng bộ từ EvoTech lên KiotViet nếu có.)

Chi tiết bảng ánh xạ dữ liệu (Data Mapping)

• Sản phẩm (KiotViet → EvoTech)

• Đơn hàng (KiotViet → EvoTech)

  • Thông tin chung đơn hàng:

• Chi tiết sản phẩm trong đơn hàng:

• Khách hàng (KiotViet → EvoTech)

Bảng ánh xạ trạng thái đơn hàng

• Trạng thái đơn hàng (Status → Status Order)

• Trạng thái vận chuyển (Status → Status Transport)

3. Hướng dẫn kết nối

• Để thiết lập kết nối giữa hệ thống EvoTech và KiotViet, vui lòng thực hiện theo các bước sau:

Bước 1: Chuẩn bị thông tin kết nối từ KiotViet

• Bạn cần truy cập vào tài khoản KiotViet của mình để lấy các thông tin cần thiết:

  • Đăng nhập vào hệ thống KiotViet.

  • Điều hướng đến mục Thiết lập cửa hàng.

  • Chọn Thiết lập kết nối API.

• Thu thập các thông tin sau:

  

  Bước 2: Thiết lập kết nối trong hệ thống EvoTech

• Sau khi có đầy đủ thông tin từ KiotViet, tiến hành thiết lập trong EvoTech:

  • Đăng nhập vào hệ thống EvoTech.

  • Truy cập vào mục Đồng bộ.

  • Chọn KiotViet.

  • Điền các thông tin đã thu thập từ KiotViet vào các trường tương ứng trong giao diện kết nối EvoTech:

    • Tên cửa hàng KiotViet: (Ví dụ: mystoretest1)

    • Client ID: Nhập mã ứng dụng từ KiotViet.

    • Client Secret: Nhập khóa bí mật từ KiotViet.

    • T: (Cần làm rõ trường này là gì, có thể là ID cửa hàng hoặc Tenant ID tùy theo thiết kế của EvoTech)

  • Nhấn nút "Kết nối" để hoàn tất.

  Bước 3: Xác nhận kết nối thành công

• Sau khi nhấn "Kết nối", hệ thống sẽ hiển thị thông báo xác nhận trạng thái kết nối. Đảm bảo rằng kết nối đã được thiết lập thành công để quá trình đồng bộ dữ liệu diễn ra bình thường.

4. Hướng dẫn ngắt kết nối

• Để ngắt kết nối giữa Evotech và Nhanh.vn, bạn có thể thực hiện theo các bước sau:

  • Truy cập trang quản trị Evotech và đăng nhập.

  • Điều hướng đến mục Cài đặt >> Kết nối dịch vụ.

  • Chọn dịch vụ đồng bộ KitotViet.

  • Tại trang chi tiết kết nối, nhấn nút Ngừng kết nối.

  • Xác nhận hành động ngắt kết nối khi được yêu cầu.