📖KiotViet To LarkBase

Workflows KiotViet To LarkBase are workflows that support transferring data from KiotViet to LarkBase automatically. Workflows support transferring data of product, price book, price book detail, customer, order, invoice, branch, group product, inventory.

Authentication and terms: Refer to KiotViet Public API for guidance on setting up authentication and terms about KiotViet Public API.

Workflows

• Customer

  • KiotViet-LarkBase Create and Update Customer

  • KiotViet-LarkBase Delete Customer

• Product

  • KiotViet-LarkBase Create and Update Product

  • KiotViet-LarkBase Delete Product

• Order

  • KiotViet-LarkBase Create and Update Order

  • KiotViet-LarkBase Delete Order

• Price Book

  • KiotViet-LarkBase Create and Update Price Book

  • KiotViet-LarkBase Delete Price Book

• Price Book Detail

  • KiotViet-LarkBase Create and Update Price Book Detail

  • KiotViet-LarkBase Delete Price Book Detail

• Invoice

  • KiotViet-LarkBase Create and Update Invoice

  • KiotViet-LarkBase Delete Invoice

• Branch

  • KiotViet-LarkBase Create and Update Branch

  • KiotViet-LarkBase Delete Branch

  • KiotViet-LarkBase Create Central branch

• Group Product

  • KiotViet-LarkBase Create and Update Group Product

  • KiotViet-LarkBase Delete Group Product

• Inventory

  • KiotViet-LarkBase Update Inventory

1. Branch

a. KiotViet-LarkBase Create Central branch

This workflow is the first workflow that must be run when creating a store on KiotViet and run exactly once. This workflow allows taking central branch data and transferring it to LarkBase

Workflow takes the central branch data and transfers it into LarkBase

To use KiotViet node, register for a seller account at https://www.kiotviet.vn/dang-ky/. After creating an account, go to "Thiết lập cửa hàng" and select "Thiết lập kết nối API" to get Client ID, Client Secret and Retailer. Instructions are available at https://www.kiotviet.vn/huong-dan-su-dung-public-api-retail/

Select "Thiết lập của hàng"

Select "Thiết lập kết nối API"

Get Retailer, Client ID and Client Secret

• Click on the KiotViet node then click Create New Credential

Create new credential

• Provide your Client ID, Client Secret and Retailer. After that, you can click save to finish creating credentials.

  

  Enter Client ID, Client Secret and Retailer to create credentials

• Click on the Lark Authentication node then click Create New Credential

• Enter your app ID in the App ID field.

• Enter your app secret in the App Secret field.

• Click on Save to save credentials.

• Turn off the popup and click on Execute Node to run a node.

  

  In this screenshot, you will notice that the node sets the value for create new credential.

  

  In this screenshot, you will notice that the node sets the value for App ID and App Secret.

  

  After executing Lark Authentication node

• Click on the Edit Fields node and enter App Token and Table ID of Lark Base

Get App Token and Table ID from LarkBase link

Enter App token and table ID

• Click Execute Workflow button to start workflow

Run workflow

• When the workflow runs successfully, your LarkBase page will have data from the central branch added.

Added successful

b. KiotViet-LarkBase Create and Update Branch

This workflow supports transferring data when users create or update branch information.

Workflow Create and Update Branch

To use workflows, you must register webhooks that match the workflow you want to use.

Register webhook

• Click KiotViet trigger and enter Path. Then click on Webhook URLs, select Production URL and copy the link

Get link webhook

• Click the KiotViet button on the remaining workflow, resource select Webhook, Operation select "Đăng ký Webhook". Select credentail, webhook type suitable for the purpose of use, fill in Url and Description then select Is Active and click execute node

Register webhook

• Click Lark Authentication node and select credential as part 1.a

• Click Set Value node and enter App token and Table ID of Branch Table in LarkBase

Set value

• After completing the above steps and ensuring that you have activated the workflow, when you create and update branch on KiotViet's site, the data will automatically be transferred to LarkBase.

Active workflow

Steps to follow on KiotViet website

• Select "Quản lý chi nhánh"

Select "Quản lý chi nhánh"

• Click button to add branch

Click button to add branch

• Enter field required

Enter data to create branch

• After completing creating or editing data will be added to LarkBase

Complete data transfer

c. KiotViet-LarkBase Delete branch

This workflow supports transferring data when users delete branch.

Workflow delete branch

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Xóa chi nhánh"

• Click Lark Authentication node and select credential as part 1.a

• Enter App Token and Branch Table ID

Enter App Token and Branch Table ID

• After completing the above steps and ensuring that you have activated the workflow, when you delete branch on KiotViet's site, the data will automatically be transferred to LarkBase.

Active workflow

Steps to follow on KiotViet website

• Select "Quản lý chi nhánh"

  

  Select "Quản lý chi nhánh"
• Select the branch to delete and press the "Xóa" button

Select branch and click "Xóa" Button

• Click "Đồng ý" Button to confirm delete

Confirm delete branch

• After completing the operations on the KiotViet site, the data on LarkBase will be deleted.

Data is deleted

2. Customer

a. KiotViet-LarkBase Create and update Customer

This workflow supports transferring data when users create or update customer information.

Workflow to create and update customer

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Cập nhật khách hàng"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Customer Table ID, Branch Table ID

Enter App Token, Customer Table ID and Branch Table ID

• After completing the above steps and ensuring that you have activated the workflow, when you create and update customer on KiotViet's site, the data will automatically be transferred to LarkBase.

Active workflow

Steps to follow on KiotViet website

• Select "Đối tác" then select "Khách hàng"

Select "Khách hàng"

• Click button add customer

Click button add customer

• Enter require field and click "Lưu" button

Enter information and click "Lưu" button

• After completing creating or editing data will be added to LarkBase

Customer data has been transferred successfully

b. KiotViet-LarkBase Delete Customer

This workflow supports transferring data when users delete customer.

Workflow delete customer

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Xoá khách hàng"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Customer Table ID

Enter App Token and Customer Table ID

• After completing the above steps and ensuring that you have activated the workflow, when you delete customer on KiotViet's site, the data will automatically be transferred to LarkBase.

Active workflow

Steps to follow on KiotViet website

• Select "Đối tác" then select "Khách hàng"

Select "Khách hàng"

• Select the customer to delete and press the "Xóa" button

Select customer and click "Xóa" button

• Click "Đồng ý" button to confirm delete customer

Confirm delete customer

• After completing the operations on the KiotViet site, the data on LarkBase will be deleted.

Customer data has been deleted

3. Group Product

a. KiotViet-LarkBase Create and Update Group Product

This workflow supports transferring data when users create or update group product information.

Workflow create update group product

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Danh mục hàng hóa"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Group Product Table ID

Enter App token and group product table ID

• After completing the above steps and ensuring that you have activated the workflow, when you create and update group product on KiotViet's site, the data will automatically be transferred to LarkBase.

Active workflow

Steps to follow on KiotViet website

• Select "Hàng hóa" then select "Danh mục"

Select "Danh mục"

• Click this button

Click add button

• Enter require field and click "Lưu" button

Save data

• After completing creating or editing data will be added to LarkBase

Customer data has been transferred successfully

b. KiotViet-LarkBase Delete Group Product

This workflow supports transferring data when users delete group product.

Workflow delete group product

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Xoá danh mục hàng hóa"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Group Product Table ID

Enter App Token and Group Product Table ID

• After completing the above steps and ensuring that you have activated the workflow, when you delete group product on KiotViet's site, the data will automatically be transferred to LarkBase.

Make workflow is active

Steps to follow on KiotViet website

• Select "Hàng hóa" then select "Danh mục"

Select "Danh mục"

• Select the product group you want to delete and select the button as shown

Choose edit button

• Click "Xoá" button

Click "Xóa" button

• Click "Đồng ý" button to confirm delete.

Confirm delete

After completing the operations on the KiotViet site, the data on LarkBase will be deleted.

Data has been deleted

4. Product

a. KiotViet-LarkBase Create and Update Product

This workflow supports transferring data when users create or update product information.

Workflow create and update product

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Cập nhật hàng hóa"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Product Table ID, Attribute Table ID, Branch Table ID

Enter App Token, Product Table ID, Attribute Table ID

Enter Branch Table ID

• After completing the above steps and ensuring that you have activated the workflow, when you create and update product on KiotViet's site, the data will automatically be transferred to LarkBase.

Active workflow

Steps to follow on KiotViet website

• Select "Hàng hóa" then select "Danh mục"

Select "Danh mục"

• Select "Thêm mới" then select "Thêm hàng hóa"

Select "Thêm hàng hóa"

• Enter require field and click "Lưu" button

Enter data and click "Lưu" button

• After completing creating or editing data will be added to Product Table and Attribute Table LarkBase. Wait about 1 to 2 minutes for data to flow to LarkBase

New Products

New Attributes

b. KiotViet-LarkBase Delete Product

This workflow supports transferring data when users delete product.

Workflow delete product

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Xoá hàng hóa"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Product Table ID, Attribute Table ID, Price Book Detail Table ID

Enter App token, product table ID, attribute table ID

enter price book detail ID

• After completing the above steps and ensuring that you have activated the workflow, when you delete product on KiotViet's site, the data will automatically be transferred to LarkBase.

Make workflow is active

Steps to follow on KiotViet website

• Select "Hàng hóa" then select "Danh mục"

Select "Danh mục"

• Select the product that needs to be deleted and click the "Xóa" button

Click "Xóa" button

• Click "Đồng ý" button to confirm delete

Confirm delete

After completing the operations on the KiotViet site, the data on LarkBase will be deleted.

Data has been deleted

5. Price Book

a. KiotViet-LarkBase Create and Update Price Book

This workflow supports transferring data when users create or update price book information.

Workflow create and update price book

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Cập nhật bảng giá"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Price Book Table ID, Branch Table ID

Enter app token, price book table ID, branch table ID

• After completing the above steps and ensuring that you have activated the workflow, when you create and update price book on KiotViet's site, the data will automatically be transferred to LarkBase.

Active workflow

Steps to follow on KiotViet website

• Select "Hàng hóa" then select "Thiết lập giá"

Select ""Thiết lập giá"

• Select the button as shown

Click add new button

• Enter field require and click "Lưu" button

Enter data and click "Lưu" button

After completing creating or editing data will be added to LarkBase.

Data has been transferred/head

b. KiotViet-LarkBase Delete Price Book

This workflow supports transferring data when users delete product.

Workflow delete price book

• To use this workflow you need to register a webhook similar to part 1.b with webhook type is "Xoá bảng giá"

• Click Lark Authentication node and select credential as part 1.a

• Click Set value node and enter App Token, Product Table ID, Attribute Table ID, Price Book Detail Table ID