📖NhanhVN

NhanhVN node provides solutions for developers to synchronize product, order, customer, and inventory data... between Nhanh.vn and other systems. These solutions are suitable for both normal websites (websites of an individual or company) and e-commerce platforms with many stores.

On this page, you'll find a list of operations the NhanhVN node supports and links to more resources.

Authentication, authorization, and terms: Refer to Nhanh Open API for guidance on setting up authentication, authorization, and terms about Nhanh Open API.

Basic Operations

• Product

  • Find Product

  • Create Or Update Product

  • Get Detailed Product Information

  • Get the Entire Product Category

  • Get the Entire Internal Catalog

  • Get a List of Gifts by Product

  • Get Product IMEI List

  • Look up IMEI Sold by Date

  • Get the History List of IMEI

  • Get the Product Expiration Date

• Customer

  • Find Customer

  • Create Or Update Customer

• Order

  • Find Order

  • Create Order

  • Update Order

  • Submit an Order Complaint

  • Get Order History

• Shipping

  • Get a List of Shipping Companies

  • Get a List of Cities and Districts

  • Charge Shipping

• Bill

  • Bill Search

  • Bill Imexs

  • Bill Imexrequirments

• Website

  • Get List of Posts

  • Get the Entire Business News Catalog

  • Add and Edit Subscribers

  • Add and Edit Contacts

• Supplier

  • Get the Name of Supplier on Nhanh

• Promotion

  • Get the List of Coupon Programs

• Store

  • Get a List of the Warehouses of Business

  • Get the List of Employees of the Business

• Accounting

  • Get the List of Accounting Entries on Nhanh.vn

  • Get the List of Customer Debts on Nhanh.vn

Example Usage

This workflow allows you can create or update a product for your app. This example usage workflow would use the following nodes. - Start – NhanhvnAuthentication - Nhanhvn

Workflow

1. Start node

The start node exists by default when you create a new workflow.

2. NhanhVN Authentication node

To use NhanhvnAuthentication node, sign up for a developer account and create an app at https://open.nhanh.vn/. Instructions are available at https://apidocs.nhanh.vn/#khoi-tao-ung-dung.

You will use the Nhanhvn Authentication node to get an access token to use other actions in the Nhanhvn node. Before that, you had to create new credentials to get the access code.

• Click on the Add node or drag to connect button and enter Nhanhvn Authentication in the search nodes box.

• Select Create new credential at Credential to connect with field.

The screenshots below are required fields for your connect information needed to get the access code.

After providing your App ID and Redirect URL and clicking Connect my account button the permissions window appears and you can choose the permissions for your app. You can continue to get access code by click "Đồng ý" or cancel by click "Hủy" button.

Permissions window

After pressing the "Đồng ý" button, the browser will redirect to your Redirect URL attached to the access code. Your access code is the string after the equals operator. You can copy it to use in the next step.

Access Code window

After getting an access code you can close the Access Code window and back to the credential screen. Now you can turn off it and just click close when Close without connecting popup appears because Nhanhvn doesn't have Authorization server support OAuth 2.0 protocol. This will not affect the further processes.

Close without connecting popup

Next, you will be paste access code was taken above and the Serect Key of your app. After that, you will click the Execute node button to get access Token.

After executing Nhanhvn Authentication node:

Execute node screen

3. NhanhVn node

We will use the create or update product action in the Nhanhvn node to set the values for needed fields.

• Click on the Add node or drag to connect button and enter Nhanhvn in the search nodes box.

• Search create or update product in the Nhanhvn Actions search box.

• Select Create new credential at Credential to connect with field.

Provide your App ID and Business ID (note: Business ID is the result of the previous node). After that, you can click save to finish creating credentials.

Now you can start creating a new product.

• Enter your access token in the Access Token field.

• Click Add Product button to create a new or update a product

• 

After clicking Add Product button you will see all the fields needed to create a product. But if you enter Product ID are exist in the system it will update that product information. You can click Add Product button to create another product.

create product screen

Finally, you can click Execute node button to run Nhanhvn node: