KOPA DocsPOS (KiotViet, Sapo, iPos)

POS (KiotViet, Sapo, iPos)

Kết nối hệ thống bán hàng với KOPA — KiotViet, Sapo, iPos, Haravan.

KOPA tích hợp với 4 POS phổ biến tại Việt Nam.

KiotViet#

KiotViet là POS phổ biến nhất với F&B và retail.

Cách kết nối#

  1. Vào KiotViet → Cài đặt → API → Tạo client.
  2. Lưu Client ID + Client Secret.
  3. KOPA: Connectors → + Thêm → KiotViet → dán credentials.
  4. KOPA pull:
    • Sản phẩm + giá.
    • Đơn hàng (POS + online).
    • Khách hàng.
    • Kho.

Đồng bộ#

  • Real-time webhook khi có đơn hàng mới.
  • Pull lịch sử 30 ngày khi connect.

Auto-bookkeeping#

Mỗi đơn hàng KiotViet → KOPA tự đề xuất bút toán doanh thu (Nợ tiền mặt / phải thu KH — Có doanh thu — Có VAT đầu ra). Mã tài khoản cụ thể KOPA chọn theo bộ chuẩn ứng với loại hình công ty bạn đã setup. Ví dụ với doanh nghiệp lớn / vừa:

Nợ TK 1111 (Tiền mặt) hoặc 131 (Phải thu KH)
       Có TK 511 (Doanh thu)
       Có TK 3331 (VAT đầu ra)

Nếu công ty bạn là DN nhỏ hoặc hộ kinh doanh, mã tài khoản và format bút toán có khác — KOPA tự áp dụng đúng. Hãy xem trong tab "Đề xuất bút toán" của module Documents để thấy chính xác bút toán KOPA đề xuất cho công ty của bạn.

Tổng hợp theo ngày để giảm số bút toán (tránh 1000 bút toán/ngày).

Sapo#

  • Sapo OmniChannel + Sapo POS + Sapo Web.
  • API key authentication.
  • Pull mỗi 15 phút.

iPos#

  • F&B chuỗi (đặc biệt mạnh).
  • API access cần request qua iPos sales.
  • Real-time cho đơn lớn (> 1tr).

Haravan#

  • E-commerce focus.
  • OAuth flow.
  • Real-time webhook.

Mapping kho#

Mỗi POS có nhiều kho/chi nhánh. Khi connect, KOPA tự sync và bạn map:

  • POS Branch → KOPA Branch.
  • POS Warehouse → KOPA Inventory location.

Hướng giảm số bút toán#

POS sinh hàng nghìn đơn/tháng. KOPA tổng hợp theo:

  • Theo ngày (mặc định) — 1 bút toán doanh thu/ngày/chi nhánh.
  • Theo ca — 3 bút toán/ngày (sáng/chiều/tối) cho F&B.
  • Theo từng đơn — nếu cần audit chi tiết.

Cấu hình tại Settings → POS → Aggregation.

Hàng tồn kho#

Nếu bạn dùng module Tồn kho của KOPA:

  • POS xuất kho → KOPA tự ghi giảm tồn.
  • Định kỳ kiểm kê → so sánh sổ vs thực tế → KOPA đề xuất bút toán điều chỉnh.

Lưu ý: Đảm bảo mã sản phẩm trong POS khớp với mã trong KOPA Master Data.