📖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
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/
Click on the KiotViet node then click 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
Click Execute Workflow button to start workflow
When the workflow runs successfully, your LarkBase page will have data from the central branch added.
b. KiotViet-LarkBase Create and Update Branch
This workflow supports transferring data when users create or update branch information.
To use workflows, you must register webhooks that match the workflow you want to use.
Click KiotViet trigger and enter Path. Then click on Webhook URLs, select Production URL and copy the link
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
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
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.
Steps to follow on KiotViet website
Select "Quản lý chi nhánh"
Click button to add branch
Enter field required
After completing creating or editing data will be added to LarkBase
c. KiotViet-LarkBase Delete branch
This workflow supports transferring data when users 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
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.
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
Click "Đồng ý" Button to confirm delete
After completing the operations on the KiotViet site, the data on LarkBase will be deleted.
2. Customer
a. KiotViet-LarkBase Create and update Customer
This workflow supports transferring data when users create or update customer information.
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
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.
Steps to follow on KiotViet website
Select "Đối tác" then select "Khách hàng"
Click button add customer
Enter require field and click "Lưu" button
After completing creating or editing data will be added to LarkBase
b. KiotViet-LarkBase Delete Customer
This workflow supports transferring data when users 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
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.
Steps to follow on KiotViet website
Select "Đối tác" then select "Khách hàng"
Select the customer to delete and press the "Xóa" button
Click "Đồng ý" button to confirm delete customer
After completing the operations on the KiotViet site, the data on LarkBase will be 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.
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
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.
Steps to follow on KiotViet website
Select "Hàng hóa" then select "Danh mục"
Click this button
Enter require field and click "Lưu" button
After completing creating or editing data will be added to LarkBase
b. KiotViet-LarkBase Delete Group Product
This workflow supports transferring data when users 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
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.
Steps to follow on KiotViet website
Select "Hàng hóa" then select "Danh mục"
Select the product group you want to delete and select the button as shown
Click "Xoá" button
Click "Đồng ý" button to confirm delete.
After completing the operations on the KiotViet site, the data on LarkBase will be deleted.
4. Product
a. KiotViet-LarkBase Create and Update Product
This workflow supports transferring data when users create or update product information.
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
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.
Steps to follow on KiotViet website
Select "Hàng hóa" then select "Danh mục"
Select "Thêm mới" then select "Thêm hàng hóa"
Enter require field 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
b. KiotViet-LarkBase Delete Product
This workflow supports transferring data when users 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
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.
Steps to follow on KiotViet website
Select "Hàng hóa" then select "Danh mục"
Select the product that needs to be deleted and click the "Xóa" button
Click "Đồng ý" button to confirm delete
After completing the operations on the KiotViet site, the data on LarkBase will be 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.
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
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.
Steps to follow on KiotViet website
Select "Hàng hóa" then select "Thiết lập giá"
Select the button as shown
Enter field require and click "Lưu" button
After completing creating or editing data will be added to LarkBase.
b. KiotViet-LarkBase Delete Price Book
This workflow supports transferring data when users delete product.
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
Last updated