Kết nối Haravan POS với omniVN

Có thể kết nối

Có thể kết nối. Tạo private app (hoặc private token) trong Haravan Admin để lấy access token.

Có thể kết nối

Có thể kết nối. Chi nhánh, sản phẩm, tồn kho theo vị trí, khách hàng và đơn hàng qua Haravan Omni API. Trang này được liệt kê trong workspace.

Kết nối Haravan POSTạo tài khoản và làm theo hướng dẫn bên dưới — dùng thử 14 ngày.

Tổng quan

Haravan Omni API xác thực bằng Bearer token từ private app. Omni0 cần access token có quyền đọc cửa hàng, sản phẩm, tồn kho, khách hàng và đơn hàng.

Điều kiện trước khi bắt đầu

Bạn đăng nhập Haravan Admin bằng tài khoản chủ cửa hàng (owner).
Có quyền tạo private app trong mục Apps.

Các bước lấy credential

1. Mở Private app trong Haravan Admin

Đăng nhập admin Haravan → Apps trên menu trái → chọn Private app. Đây là cách được tài liệu Haravan khuyến nghị cho tích hợp server-to-server.

Haravan Admin — mục Apps và Private app · Haravan Platform

2. Tạo private app và chọn quyền đọc

Chọn Create new private app, đặt tên và bật quyền read cho các tài nguyên cần đồng bộ (locations, products, inventory, customers, orders). Lưu app.

Cấu hình tên và permission cho private app · Haravan Platform

3. Copy access token (private token)

Sau khi lưu, Haravan hiển thị API key / access token. Token này dùng như access_token trong header Authorization: Bearer. Chỉ gọi API thuộc scope đã chọn.

Sao chép API key sau khi tạo private app · Haravan Platform

4. Điền vào Omni0

Integrations → Haravan POS. Dán Haravan access token. Omni0 xác minh bằng GET https://apis.haravan.com/com/shop.json.

Ánh xạ credential với omniVN

Cột "Lấy từ đâu" cho biết giá trị do người dùng nhập, do provider cấp, do omniVN quản lý, hay do OAuth sinh ra.

Field omniVN	Tên trong tài liệu official	Bắt buộc	Lấy từ đâu
Haravan access token	Private app access token	Bắt buộc	provider_generated Tạo private app trong Haravan Admin để lấy token với read scopes.

accessToken → Private app access token (Bearer).

Vòng đời token

Private token thường không hết hạn cho đến khi bạn xóa app hoặc thu hồi token trong Haravan.

Lỗi thường gặp

Lỗi 401

Access token sai, app bị xóa, hoặc thiếu read scope cho API đang gọi.

Nguồn chính thức

Private App

docs.haravan.com·Công khai·Đã kiểm chứng 2026-08-29

Haravan APIs overview

docs.haravan.com·Công khai·Đã kiểm chứng 2026-08-29