Hướng dẫn cấu hình WooSync toàn diện — Từ cài đặt đến lượt đồng bộ đầu tiên

Trước khi bắt đầu

Bạn cần chuẩn bị:

• Perfex CRM phiên bản 3.4.0 trở lên

• Ít nhất một cửa hàng WooCommerce đã kích hoạt REST API

• Tài khoản quản trị viên (Admin) trên cả hai hệ thống

Tổng thời gian thiết lập: 10–15 phút.

Bước 1: Cài đặt mô-đun (Module)

WooSync sẽ tự động tạo 16 bảng dữ liệu khi kích hoạt — không cần chạy lệnh SQL thủ công.

Bước 2: Tạo WooCommerce API Keys

Bước 3: Thêm cửa hàng mới trong Perfex CRM

Bước 4: Cấu hình Webhooks (Đồng bộ thời gian thực)

Sau khi lưu cửa hàng, chỉnh sửa thông tin cửa hàng đó để lấy Webhook Delivery URL và Webhook Secret.

Trên trang quản trị WooCommerce:

Truy cập Cấu hình (Settings) → Nâng cao (Advanced) → Webhooks
Tạo các webhook tương ứng với các sự kiện sau:

Bước 5: Cấu hình Cron Job chạy ngầm

WooSync tận dụng tiến trình cron.php có sẵn của Perfex CRM để thực hiện đồng bộ hóa gia tăng. Đảm bảo máy chủ của bạn chạy tiến trình này đều đặn:

Trên cPanel/DirectAdmin:

*/5 * * * * wget -q -O- https://your-perfex.com/cron.php

Phục vụ môi trường phát triển localhost/Windows:

Truy cập WooSync → Cài đặt (Settings)
Bật Chế độ gỡ lỗi (Debug Mode)
WooSync sẽ tự động kích hoạt cron giả lập mỗi khi bạn duyệt qua bảng điều khiển quản trị.

Bước 6: Chạy lượt đồng bộ dữ liệu đầu tiên

Bước 7: Cấu hình ánh xạ thuế Tax Mapping (Tùy chọn)

If you use auto-invoicing and your WooCommerce store has tax rates:

Bước 8: Ánh xạ dữ liệu & Trường tùy biến (Tùy chọn)

WooSync v1.2.0 giới thiệu tính năng ánh xạ dữ liệu trực quan. Nếu trang thanh toán của bạn có các trường tùy biến (ví dụ: Mã số thuế VAT, Ngày giao hàng) hoặc bạn muốn theo dõi Mã giảm giá cụ thể:

1. Truy cập WooSync → Ánh xạ dữ liệu (Data Mapping)
2. Chọn cửa hàng của bạn và tiến hành ánh xạ trực tiếp các trường WooCommerce custom meta keys với các trường tùy biến (Custom Fields) của Khách hàng hoặc Hóa đơn trong Perfex CRM.

Lưu ý: WooSync hỗ trợ đầy đủ 16 ngôn ngữ. Bạn có thể thay đổi ngôn ngữ của Perfex CRM trong thiết lập hồ sơ cá nhân để dịch toàn bộ giao diện làm việc của WooSync ngay lập tức.

Kiểm tra và Xác minh hoạt động

Sau khi thiết lập, hãy xác nhận:

• Cửa hàng (Stores): Trạng thái kết nối hiển thị màu xanh lá cây

• Sản phẩm (Products): Các sản phẩm WooCommerce đã xuất hiện trong WooSync → Products

• Đơn hàng (Orders): Các đơn hàng gần đây đã được đồng bộ với tổng giá trị chính xác

• Khách hàng (Customers): Người mua hàng được liên kết chuẩn xác với Khách hàng Perfex

• Nhật ký (Logs): Mục WooSync → Logs ghi nhận các lượt đồng bộ thành công

• Webhooks: Tạo một đơn hàng thử nghiệm trên WooCommerce — đơn hàng này sẽ xuất hiện trong WooSync chỉ sau vài giây

Khắc phục sự cố thường gặp

Cấu hình hoàn tất. Cửa hàng WooCommerce của bạn hiện đã được kết nối đồng bộ với Perfex CRM.