Haravan

Connect a Haravan shop to look up and manage orders, products, customers and inventory.

Kết nối

• Kiểu xác thực: oauth2

Scope yêu cầu:

• openid
• profile
• email
• org
• userinfo
• grant_service
• wh_api
• com.read_shop
• com.read_products
• com.write_products
• com.read_orders
• com.write_orders
• com.read_customers
• com.write_customers
• com.read_inventories
• com.write_inventories

Actions

Action	Key	Nhóm	Tác động	Rủi ro	Duyệt
Danh sách đơn hàng	haravan.list_orders	Đơn hàng	NONE	low	không
Đếm đơn hàng	haravan.count_orders	Đơn hàng	NONE	low	không
Xem đơn hàng	haravan.get_order	Đơn hàng	NONE	low	không
Tạo đơn hàng	haravan.create_order	Đơn hàng	WRITE	medium	có
Cập nhật đơn hàng	haravan.update_order	Đơn hàng	WRITE	medium	có
Xác nhận đơn hàng	haravan.confirm_order	Đơn hàng	WRITE	medium	có
Đóng đơn hàng	haravan.close_order	Đơn hàng	WRITE	medium	có
Mở lại đơn hàng	haravan.open_order	Đơn hàng	WRITE	medium	có
Huỷ đơn hàng	haravan.cancel_order	Đơn hàng	WRITE	high	có
Thêm thẻ đơn hàng	haravan.add_order_tags	Đơn hàng	WRITE	medium	có
Xoá thẻ đơn hàng	haravan.remove_order_tags	Đơn hàng	WRITE	medium	có
Giao người xử lý đơn	haravan.assign_order	Đơn hàng	WRITE	medium	có
Lịch sử đơn hàng	haravan.list_order_events	Đơn hàng	NONE	low	không
Danh sách thanh toán của đơn	haravan.list_order_transactions	Đơn hàng	NONE	low	không
Ghi nhận thanh toán đơn	haravan.create_order_transaction	Đơn hàng	WRITE	high	có
Danh sách hoàn tiền của đơn	haravan.list_order_refunds	Đơn hàng	NONE	low	không
Hoàn tiền đơn hàng	haravan.create_order_refund	Đơn hàng	WRITE	high	có
Xem phí vận chuyển	haravan.get_shipping_rates	Đơn hàng	NONE	low	không
Danh sách sản phẩm	haravan.list_products	Sản phẩm	NONE	low	không
Xem sản phẩm	haravan.get_product	Sản phẩm	NONE	low	không
Tạo sản phẩm	haravan.create_product	Sản phẩm	WRITE	medium	có
Cập nhật sản phẩm	haravan.update_product	Sản phẩm	WRITE	medium	có
Xoá sản phẩm	haravan.delete_product	Sản phẩm	WRITE	high	có
Thêm thẻ sản phẩm	haravan.add_product_tags	Sản phẩm	WRITE	medium	có
Xoá thẻ sản phẩm	haravan.remove_product_tags	Sản phẩm	WRITE	medium	có
Danh sách biến thể	haravan.list_variants	Sản phẩm	NONE	low	không
Xem biến thể	haravan.get_variant	Sản phẩm	NONE	low	không
Tạo biến thể	haravan.create_variant	Sản phẩm	WRITE	medium	có
Cập nhật biến thể	haravan.update_variant	Sản phẩm	WRITE	medium	có
Xoá biến thể	haravan.delete_variant	Sản phẩm	WRITE	high	có
Danh sách ảnh sản phẩm	haravan.list_product_images	Sản phẩm	NONE	low	không
Thêm ảnh sản phẩm	haravan.add_product_image	Sản phẩm	WRITE	medium	có
Xoá ảnh sản phẩm	haravan.delete_product_image	Sản phẩm	WRITE	high	có
Danh sách nhóm sản phẩm	haravan.list_custom_collections	Sản phẩm	NONE	low	không
Tạo nhóm sản phẩm	haravan.create_custom_collection	Sản phẩm	WRITE	medium	có
Cập nhật nhóm sản phẩm	haravan.update_custom_collection	Sản phẩm	WRITE	medium	có
Xoá nhóm sản phẩm	haravan.delete_custom_collection	Sản phẩm	WRITE	high	có
Danh sách nhóm sản phẩm tự động	haravan.list_smart_collections	Sản phẩm	NONE	low	không
Thêm sản phẩm vào nhóm	haravan.add_product_to_collection	Sản phẩm	WRITE	medium	có
Bỏ sản phẩm khỏi nhóm	haravan.remove_product_from_collection	Sản phẩm	WRITE	medium	có
Danh sách khách hàng	haravan.list_customers	Khách hàng	NONE	low	không
Tìm khách hàng	haravan.search_customers	Khách hàng	NONE	low	không
Xem khách hàng	haravan.get_customer	Khách hàng	NONE	low	không
Tạo khách hàng	haravan.create_customer	Khách hàng	WRITE	medium	có
Cập nhật khách hàng	haravan.update_customer	Khách hàng	WRITE	medium	có
Xoá khách hàng	haravan.delete_customer	Khách hàng	WRITE	high	có
Thêm thẻ khách hàng	haravan.add_customer_tags	Khách hàng	WRITE	medium	có
Xoá thẻ khách hàng	haravan.remove_customer_tags	Khách hàng	WRITE	medium	có
Danh sách địa chỉ khách hàng	haravan.list_customer_addresses	Khách hàng	NONE	low	không
Thêm địa chỉ khách hàng	haravan.create_customer_address	Khách hàng	WRITE	medium	có
Cập nhật địa chỉ khách hàng	haravan.update_customer_address	Khách hàng	WRITE	medium	có
Xoá địa chỉ khách hàng	haravan.delete_customer_address	Khách hàng	WRITE	high	có
Đặt địa chỉ mặc định	haravan.set_default_customer_address	Khách hàng	WRITE	medium	có
Xem tồn kho	haravan.get_inventory_levels	Tồn kho	NONE	low	không
Điều chỉnh tồn kho	haravan.adjust_inventory	Tồn kho	WRITE	medium	có
Danh sách phiếu điều chỉnh kho	haravan.list_inventory_adjustments	Tồn kho	NONE	low	không
Danh sách phiếu chuyển kho	haravan.list_inventory_transfers	Tồn kho	NONE	low	không
Tạo phiếu chuyển kho	haravan.create_inventory_transfer	Tồn kho	WRITE	medium	có
Nhận hàng chuyển kho	haravan.receive_inventory_transfer	Tồn kho	WRITE	medium	có
Xem thông tin shop	haravan.get_shop	Cửa hàng	NONE	low	không
Danh sách chi nhánh, kho	haravan.list_locations	Cửa hàng	NONE	low	không
Danh sách nhân viên	haravan.list_staff	Cửa hàng	NONE	low	không
Nhật ký hoạt động shop	haravan.list_activity_events	Cửa hàng	NONE	low	không
Danh sách tỉnh/thành	haravan.list_provinces	Cửa hàng	NONE	low	không
Danh sách phường/xã	haravan.list_wards	Cửa hàng	NONE	low	không

Events

haravan.order_created

A new order was placed (Haravan topic orders/create).

Field	Kiểu	Mô tả
id	integer
name	string	Order number shown to staff, e.g. #1001
order_number	string
total_price	number
subtotal_price	number
financial_status	string	pending, paid, partially_paid, refunded, voided, …
fulfillment_status	string	notfulfilled, partial, fulfilled
email	string
note	string
tags	string
source_name	string
customer	object
customer.id	integer
customer.first_name	string
customer.last_name	string
customer.email	string
customer.phone	string
shipping_address	object
shipping_address.name	string
shipping_address.phone	string
shipping_address.address1	string
shipping_address.province	string
shipping_address.province_code	string
shipping_address.district	string	Ward name since the 2025 two-level reform
shipping_address.district_code	string	Ward code
billing_address	object
billing_address.name	string
billing_address.phone	string
billing_address.address1	string
billing_address.province	string
billing_address.province_code	string
billing_address.district	string	Ward name since the 2025 two-level reform
billing_address.district_code	string	Ward code
line_items	array of object
line_items[].variant_id	integer
line_items[].product_id	integer
line_items[].title	string
line_items[].variant_title	string
line_items[].sku	string
line_items[].quantity	integer
line_items[].price	number
created_at	string
updated_at	string

Mapping mặc định:

{
  "contact": {
    "email": "{{trigger.customer.email}}",
    "name": "{{trigger.customer.last_name}} {{trigger.customer.first_name}}",
    "phone": "{{trigger.customer.phone ?? trigger.shipping_address.phone}}"
  },
  "inputs": {}
}

haravan.order_paid

An order was paid (Haravan topic orders/paid).

Field	Kiểu	Mô tả
id	integer
name	string	Order number shown to staff, e.g. #1001
order_number	string
total_price	number
subtotal_price	number
financial_status	string	pending, paid, partially_paid, refunded, voided, …
fulfillment_status	string	notfulfilled, partial, fulfilled
email	string
note	string
tags	string
source_name	string
customer	object
customer.id	integer
customer.first_name	string
customer.last_name	string
customer.email	string
customer.phone	string
shipping_address	object
shipping_address.name	string
shipping_address.phone	string
shipping_address.address1	string
shipping_address.province	string
shipping_address.province_code	string
shipping_address.district	string	Ward name since the 2025 two-level reform
shipping_address.district_code	string	Ward code
billing_address	object
billing_address.name	string
billing_address.phone	string
billing_address.address1	string
billing_address.province	string
billing_address.province_code	string
billing_address.district	string	Ward name since the 2025 two-level reform
billing_address.district_code	string	Ward code
line_items	array of object
line_items[].variant_id	integer
line_items[].product_id	integer
line_items[].title	string
line_items[].variant_title	string
line_items[].sku	string
line_items[].quantity	integer
line_items[].price	number
created_at	string
updated_at	string

Mapping mặc định:

{
  "contact": {
    "email": "{{trigger.customer.email}}",
    "name": "{{trigger.customer.last_name}} {{trigger.customer.first_name}}",
    "phone": "{{trigger.customer.phone ?? trigger.shipping_address.phone}}"
  },
  "inputs": {}
}

haravan.order_cancelled

An order was cancelled (Haravan topic orders/cancelled).

Field	Kiểu	Mô tả
id	integer
name	string	Order number shown to staff, e.g. #1001
order_number	string
total_price	number
subtotal_price	number
financial_status	string	pending, paid, partially_paid, refunded, voided, …
fulfillment_status	string	notfulfilled, partial, fulfilled
email	string
note	string
tags	string
source_name	string
customer	object
customer.id	integer
customer.first_name	string
customer.last_name	string
customer.email	string
customer.phone	string
shipping_address	object
shipping_address.name	string
shipping_address.phone	string
shipping_address.address1	string
shipping_address.province	string
shipping_address.province_code	string
shipping_address.district	string	Ward name since the 2025 two-level reform
shipping_address.district_code	string	Ward code
billing_address	object
billing_address.name	string
billing_address.phone	string
billing_address.address1	string
billing_address.province	string
billing_address.province_code	string
billing_address.district	string	Ward name since the 2025 two-level reform
billing_address.district_code	string	Ward code
line_items	array of object
line_items[].variant_id	integer
line_items[].product_id	integer
line_items[].title	string
line_items[].variant_title	string
line_items[].sku	string
line_items[].quantity	integer
line_items[].price	number
created_at	string
updated_at	string

Mapping mặc định:

{
  "contact": {
    "email": "{{trigger.customer.email}}",
    "name": "{{trigger.customer.last_name}} {{trigger.customer.first_name}}",
    "phone": "{{trigger.customer.phone ?? trigger.shipping_address.phone}}"
  },
  "inputs": {}
}

haravan.order_fulfilled

An order was fully delivered (Haravan topic orders/fulfilled).

Field	Kiểu	Mô tả
id	integer
name	string	Order number shown to staff, e.g. #1001
order_number	string
total_price	number
subtotal_price	number
financial_status	string	pending, paid, partially_paid, refunded, voided, …
fulfillment_status	string	notfulfilled, partial, fulfilled
email	string
note	string
tags	string
source_name	string
customer	object
customer.id	integer
customer.first_name	string
customer.last_name	string
customer.email	string
customer.phone	string
shipping_address	object
shipping_address.name	string
shipping_address.phone	string
shipping_address.address1	string
shipping_address.province	string
shipping_address.province_code	string
shipping_address.district	string	Ward name since the 2025 two-level reform
shipping_address.district_code	string	Ward code
billing_address	object
billing_address.name	string
billing_address.phone	string
billing_address.address1	string
billing_address.province	string
billing_address.province_code	string
billing_address.district	string	Ward name since the 2025 two-level reform
billing_address.district_code	string	Ward code
line_items	array of object
line_items[].variant_id	integer
line_items[].product_id	integer
line_items[].title	string
line_items[].variant_title	string
line_items[].sku	string
line_items[].quantity	integer
line_items[].price	number
created_at	string
updated_at	string

Mapping mặc định:

{
  "contact": {
    "email": "{{trigger.customer.email}}",
    "name": "{{trigger.customer.last_name}} {{trigger.customer.first_name}}",
    "phone": "{{trigger.customer.phone ?? trigger.shipping_address.phone}}"
  },
  "inputs": {}
}

haravan.customer_created

A new customer was added (Haravan topic customers/create).

Field	Kiểu	Mô tả
id	integer
first_name	string
last_name	string
email	string
phone	string

haravan.product_updated

A product, its variants or prices changed (Haravan topic products/update).

Field	Kiểu	Mô tả
id	integer
title	string
variants	array of object
variants[].id	integer
variants[].sku	string
variants[].price	number
variants[].inventory_quantity	integer

haravan.app_uninstalled

The shop removed the FLAE app (Haravan topic app/uninstalled).

Field	Kiểu	Mô tả
org_id	string