Haravan

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

Connection

• Auth type: oauth2

Scopes requested:

• 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	Group	Side effect	Risk	Approval
List orders	haravan.list_orders	Orders	NONE	low	no
Count orders	haravan.count_orders	Orders	NONE	low	no
Get order	haravan.get_order	Orders	NONE	low	no
Create order	haravan.create_order	Orders	WRITE	medium	yes
Update order	haravan.update_order	Orders	WRITE	medium	yes
Confirm order	haravan.confirm_order	Orders	WRITE	medium	yes
Close order	haravan.close_order	Orders	WRITE	medium	yes
Reopen order	haravan.open_order	Orders	WRITE	medium	yes
Cancel order	haravan.cancel_order	Orders	WRITE	high	yes
Add order tags	haravan.add_order_tags	Orders	WRITE	medium	yes
Remove order tags	haravan.remove_order_tags	Orders	WRITE	medium	yes
Assign order	haravan.assign_order	Orders	WRITE	medium	yes
List order events	haravan.list_order_events	Orders	NONE	low	no
List order payments	haravan.list_order_transactions	Orders	NONE	low	no
Record order payment	haravan.create_order_transaction	Orders	WRITE	high	yes
List order refunds	haravan.list_order_refunds	Orders	NONE	low	no
Refund order	haravan.create_order_refund	Orders	WRITE	high	yes
Get shipping rates	haravan.get_shipping_rates	Orders	NONE	low	no
List products	haravan.list_products	Products	NONE	low	no
Get product	haravan.get_product	Products	NONE	low	no
Create product	haravan.create_product	Products	WRITE	medium	yes
Update product	haravan.update_product	Products	WRITE	medium	yes
Delete product	haravan.delete_product	Products	WRITE	high	yes
Add product tags	haravan.add_product_tags	Products	WRITE	medium	yes
Remove product tags	haravan.remove_product_tags	Products	WRITE	medium	yes
List variants	haravan.list_variants	Products	NONE	low	no
Get variant	haravan.get_variant	Products	NONE	low	no
Create variant	haravan.create_variant	Products	WRITE	medium	yes
Update variant	haravan.update_variant	Products	WRITE	medium	yes
Delete variant	haravan.delete_variant	Products	WRITE	high	yes
List product images	haravan.list_product_images	Products	NONE	low	no
Add product image	haravan.add_product_image	Products	WRITE	medium	yes
Delete product image	haravan.delete_product_image	Products	WRITE	high	yes
List collections	haravan.list_custom_collections	Products	NONE	low	no
Create collection	haravan.create_custom_collection	Products	WRITE	medium	yes
Update collection	haravan.update_custom_collection	Products	WRITE	medium	yes
Delete collection	haravan.delete_custom_collection	Products	WRITE	high	yes
List smart collections	haravan.list_smart_collections	Products	NONE	low	no
Add product to collection	haravan.add_product_to_collection	Products	WRITE	medium	yes
Remove product from collection	haravan.remove_product_from_collection	Products	WRITE	medium	yes
List customers	haravan.list_customers	Customers	NONE	low	no
Search customers	haravan.search_customers	Customers	NONE	low	no
Get customer	haravan.get_customer	Customers	NONE	low	no
Create customer	haravan.create_customer	Customers	WRITE	medium	yes
Update customer	haravan.update_customer	Customers	WRITE	medium	yes
Delete customer	haravan.delete_customer	Customers	WRITE	high	yes
Add customer tags	haravan.add_customer_tags	Customers	WRITE	medium	yes
Remove customer tags	haravan.remove_customer_tags	Customers	WRITE	medium	yes
List customer addresses	haravan.list_customer_addresses	Customers	NONE	low	no
Add customer address	haravan.create_customer_address	Customers	WRITE	medium	yes
Update customer address	haravan.update_customer_address	Customers	WRITE	medium	yes
Delete customer address	haravan.delete_customer_address	Customers	WRITE	high	yes
Set default customer address	haravan.set_default_customer_address	Customers	WRITE	medium	yes
Get stock levels	haravan.get_inventory_levels	Inventory	NONE	low	no
Adjust stock	haravan.adjust_inventory	Inventory	WRITE	medium	yes
List stock adjustments	haravan.list_inventory_adjustments	Inventory	NONE	low	no
List stock transfers	haravan.list_inventory_transfers	Inventory	NONE	low	no
Create stock transfer	haravan.create_inventory_transfer	Inventory	WRITE	medium	yes
Receive stock transfer	haravan.receive_inventory_transfer	Inventory	WRITE	medium	yes
Get shop	haravan.get_shop	Shop	NONE	low	no
List locations	haravan.list_locations	Shop	NONE	low	no
List staff	haravan.list_staff	Shop	NONE	low	no
List shop activity	haravan.list_activity_events	Shop	NONE	low	no
List Vietnam provinces	haravan.list_provinces	Shop	NONE	low	no
List wards of a province	haravan.list_wards	Shop	NONE	low	no

Events

haravan.order_created

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

Field	Type	Description
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

Default mapping:

{
  "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	Type	Description
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

Default mapping:

{
  "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	Type	Description
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

Default mapping:

{
  "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	Type	Description
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

Default mapping:

{
  "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	Type	Description
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	Type	Description
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	Type	Description
org_id	string