Kênh iPOS.vn

Tích hợp iPOS.vn cho phép các doanh nghiệp ngành F&B (nhà hàng, quán cà phê, chuỗi đồ uống) kết nối dữ liệu bán hàng, hóa đơn và tồn kho giữa hệ thống iPOS và nền tảng quản trị OVIRO.

Điểm khác biệt về cơ chế kết nối

Khác với các kênh thương mại điện tử sử dụng cơ chế OAuth Popup (TikTok Shop, Shopee, Facebook, Zalo), iPOS.vn sử dụng phương thức API Key trực tiếp:

• Không mở cửa sổ đăng nhập/ủy quyền của bên thứ ba.
• Quản trị viên nhập trực tiếp các Endpoint và Access Token kỹ thuật do phía iPOS.vn (Foodbook / iPOS Data Warehouse) cung cấp vào form cài đặt của kênh.
• Không yêu cầu thiết lập cấu hình nền tại trang Cấu hình bán hàng đa kênh.

---

Quy trình 2 bước kết nối iPOS.vn

Bước 1: Khởi tạo kênh với thông tin API ban đầu

1. Vào menu Bán hàng đa kênh > Tích hợp đa kênh.
2. Nhấn nút Thêm kênh ở góc trên bên phải.
3. Trong popup danh sách kênh, chọn biểu tượng iPOS.vn.
4. Form Thêm kênh iPOS.vn hiển thị, điền các thông tin cơ bản:

5. Nhấn nút Lưu và Cài đặt. Hệ thống sẽ tạo kênh mới và lưu thông tin kết nối vào cơ sở dữ liệu.

---

Bước 2: Cấu hình nâng cao và ánh xạ định danh POS

Sau khi khởi tạo kênh thành công, bấm vào nút Sửa (biểu tượng cây bút) tại dòng kênh iPOS.vn vừa tạo để vào màn hình cấu hình chi tiết:

1. Thông số định danh điểm bán iPOS

• Mã điểm bán (POS ID): Mã số quầy POS trong hệ thống iPOS (ví dụ: 5898).
• Mã thương hiệu (POS Parent): Mã chuỗi hoặc thương hiệu (ví dụ: BRAND-RY4N).
• Mã cửa hàng (Store ID): Mã chi nhánh/nhà hàng tương ứng trên iPOS (ví dụ: 30R2KAPPZG1J).
• Access Token (Pull): Khóa bí mật dùng để xác thực các lệnh kéo báo cáo hóa đơn từ iPOS Data Warehouse.

2. Cấu hình nguồn đơn iPOS (Source ID Mapping)

Hỗ trợ ánh xạ các đơn hàng đổ về từ các nguồn bán hàng khác nhau:

• Source ID Shopee & Created By Shopee: Mã nguồn đơn Shopee trên iPOS (trường source_fb_id) và giá trị created_by khi đẩy đơn Shopee (ví dụ: SHOPEEFOOD).
• Source ID TikTok & Created By TikTok: Mã nguồn đơn TikTok trên iPOS và giá trị created_by tương ứng.
• Source ID Website & Created By Website: Mã nguồn đơn tự tạo hoặc qua website/app.

3. Cấu hình đẩy đơn hàng ra ngoài (Batch Push)

• Đẩy đơn hàng ra ngoài: Bật/tắt tính năng tự động đẩy đơn hàng sang hệ thống bên ngoài.
• Chế độ đẩy đơn: Chọn Cron (batch) để gom đơn xử lý định kỳ theo lô.
• Cron URL: Đường dẫn kích hoạt webhook định kỳ do hệ thống cung cấp (ví dụ: https://ws.oviro.asia/v1/ecomorders/processbatchpush/{id}).
• Bộ lọc điều kiện: Lọc đơn theo khoảng thời gian (giây), nguồn đơn hàng, trạng thái đơn, trạng thái giao hàng, trạng thái fulfillment và phương thức thanh toán.

4. Thông tin khách hàng mặc định

Khi đơn hàng từ quầy iPOS đổ về không có thông tin thành viên (khách vãng lai), hệ thống sẽ tự động gán theo thông tin này:

• Tên khách hàng mặc định: Ví dụ: Khách lẻ.
• SĐT mặc định: Ví dụ: 0901234567.

---

Bảng đối chiếu Endpoint iPOS.vn

---

Lưu ý khi triển khai

[!TIP]

• Đảm bảo rằng đơn vị cung cấp iPOS đã mở kết nối IP (Whitelist) cho máy chủ OVIRO nếu chi nhánh có thiết lập tường lửa riêng.
• Các mã Store ID và POS ID cần được đối chiếu chính xác với bộ phận triển khai phần mềm iPOS để dữ liệu bán hàng được phân bổ đúng cửa hàng.