Quay lại catalog nguồn dữ liệu
POS / ERP / Kế toánPhù hợp với RetailerPhù hợp với F&B

Haravan

Nền tảng website thương mại và POS, phổ biến cho brand vừa và lớn tại VN.

Trang chính của vendor Tài liệu API chính thức

Loại API

REST API

Xác thực

OAuth 2.0

Tần suất refresh khả thi

Real-time, Mỗi giờ, Hằng ngày

Setup · Maintain hằng tháng

6-10 giờ · 1 giờ

Hướng dẫn kết nối, 6 bước

Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.

  1. 1

    Đăng ký Haravan Partner

    Vào docs.haravan.com, đăng ký Partner Account. Tạo App với redirect URL.

  2. 2

    Lấy Client ID + Client Secret

    App detail page hiển thị Client ID và Secret. Lưu vào vault.

  3. 3

    Generate authorization URL

    https://{shop}.myharavan.com/admin/oauth/authorize?client_id=...&scope=read_orders,read_products,read_customers&redirect_uri=...

  4. 4

    Trade code lấy access_token

    POST /admin/oauth/access_token với code. Token không hết hạn cho đến khi shop revoke, không cần refresh token job.

  5. 5

    Kết nối endpoint orders + products

    GET /admin/orders.json, /admin/products.json, /admin/customers.json. Pagination qua page và limit.

  6. 6

    Tùy chọn: webhooks

    POST /admin/webhooks.json đăng ký order/create, order/updated. Haravan POST đến endpoint của bạn khi có sự kiện.

Credentials cần có

Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.

  • Client ID
  • Client Secret
  • Access Token
  • Shop Domain

Trường dữ liệu mẫu

Các field thường có trong API response. Map vào schema warehouse khi ingest.

  • order_id
  • order_number
  • created_at
  • total_price
  • line_items[].sku
  • shipping_lines[].price
  • customer.id
  • fulfillment_status

Lỗi và pitfalls thường gặp tại Việt Nam

Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.

  • API endpoint version cũ vẫn dùng được nhưng không có support, luôn dùng path /admin/ mới nhất.
  • Inventory không cập nhật real-time trong API, có delay 1-5 phút.
  • Webhook không có retry mechanism, nếu endpoint down, mất event. Luôn có job đối soát theo cửa sổ thời gian.
  • Multi-location order chỉ có 1 location_id duy nhất, không reflect được order fulfilled từ nhiều kho.
  • Phí ship và voucher giảm giá cần parse từ shipping_lines và discount_codes thay vì từ line items.

Dashboard sử dụng Haravan

Xem toàn bộ thư viện dashboard →
Bán lẻ đa kênhTrưởng phòng vận hành

Cảnh báo hết hàng và hàng tồn chậm bán

Hai mặt của một vấn đề: SKU bán chạy có nguy cơ hết trong 7-14 ngày tới, và hàng đã không bán hơn 90 ngày đang khóa vốn. Một danh sách hành động, không phải bảng tồn kho khô khan.

Mở dashboard
Chuỗi F&BTrưởng phòng vận hành

Operations hằng ngày

Doanh thu, lượt khách, vòng quay bàn và AOV theo giờ trong ngày, cho từng chi nhánh. Phát hiện giờ ngấm (thừa hoặc thiếu nhân sự) và xu hướng vòng quay bàn giảm dần.

Mở dashboard
Chuỗi F&BTrưởng phòng marketing

Loyalty và retention khách hàng

Phân nhóm khách hàng theo cohort, tần suất ghé, AOV và thời gian từ lần ghé gần nhất. Trả lời "có bao nhiêu khách quay lại trong 30 ngày" và "khách VIP nào đang biến mất".

Mở dashboard
Bước tiếp theo

Kết nối Haravan vào data warehouse của doanh nghiệp bạn

Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.

Đặt lịch rà soát 30 phútXem toàn bộ nguồn dữ liệu