# 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.

{% hint style="info" %}
**Authentication, authorization, and terms:** Refer to [Nhanh Open API](https://apidocs.nhanh.vn/) for guidance on setting up authentication, authorization, and terms about Nhanh Open API.
{% endhint %}

## Basic Operations&#x20;

* Product
  * Find Product
  * Create Or Update Product&#x20;
  * 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

<figure><img src="/files/vUnGDB2hImQko0aGRN1f" alt=""><figcaption><p>Workflow</p></figcaption></figure>

### 1. Start node

&#x20; 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.

<figure><img src="/files/S8ZpWVXkgvLdZkVkwKf5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/uLsA9UtIlBcckUN3m1oe" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/qLsnHJP01epO9nf0SMzo" alt=""><figcaption><p>Permissions window</p></figcaption></figure>

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.

<figure><img src="/files/7EJVL06odQJLDb8OAcPl" alt=""><figcaption><p>Access Code window</p></figcaption></figure>

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.

<figure><img src="/files/SbmBVfLV8tGB2X9yMR8l" alt=""><figcaption><p>Close without connecting popup</p></figcaption></figure>

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.**

<figure><img src="/files/79sOiXBMtS9EnRDfN5kH" alt=""><figcaption></figcaption></figure>

After executing Nhanhvn Authentication node:&#x20;

<figure><img src="/files/bWmShFwCnyO7IHff1Tkx" alt=""><figcaption><p>Execute node screen</p></figcaption></figure>

### 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.

<figure><img src="/files/gisqq0LeZ5HCBwYOFMkv" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/eYDgnBr8SoZvvlRWITel" alt=""><figcaption></figcaption></figure>

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
*

```
<figure><img src="/files/nmaOtKfBIFDPo3ZJN7gc" alt=""><figcaption></figcaption></figure>
```

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.

<figure><img src="/files/zkrUeiOnhcbDRYaR74DR" alt=""><figcaption><p>create product screen</p></figcaption></figure>

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

<figure><img src="/files/f8lOGahL0LSyDZYdRtSF" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-tech.n8n.vn/nhanhvn.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
