📖Nhanh VN

NhanhVN node cung cấp giải pháp cho nhà phát triển đồng bộ hóa dữ liệu sản phẩm, đơn hàng, khách hàng, tồn kho... giữa Nhanh.vn và các hệ thống khác. Các giải pháp này phù hợp cho cả website thông thường (website của cá nhân, công ty) và nền tảng thương mại điện tử có nhiều cửa hàng.

Trên trang này, bạn sẽ tìm thấy danh sách các hoạt động mà Nhanh VN node hỗ trợ và liên kết đến nhiều tài nguyên hơn.

Authentication, authorization, and terms: Tham khảo Nhanh Open API để được hướng dẫn thiết lập xác thực, ủy quyền và các điều khoản về 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

  • Retrieve List of Warehouse in/out Bill

  • Retrieve the List of Enterprise Warehouse Products in and Out

  • Get a List of Products that Require Import and Export From the Enterprise Warehouse

• 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

Quy trình sử dụng ví dụ này sẽ sử dụng các node như sau. - Start – NhanhvnAuthentication - Nhanhvn.

Workflow

1. Start node

Start node tồn tại theo mặc định khi bạn tạo workflow mới.

2. Nhanhvn Authentication node

Để sử dụng Nhanhvn Authentication node, đăng ký tài khoản nhà phát triển và tạo ứng dụng tại https://open.nhanh.vn/. Hướng dẫn có sẵn tại https://apidocs.nhanh.vn/#khoi-tao-ung-dung.

Bạn sẽ sử dụng Nhanhvn Authentication node để nhận được access token để sử dụng cho các action khác nhau trong Nhanhvn node. Trước đó, bạn phải create new credentials để lấy access code.

• Nhấp vào nút Click on the Add node or drag to connect và nhập Nhanhvn Authentication trong search nodes box.

• Lựa chọn Create new credential tại trường Credential to connect with.

Ảnh chụp màn hình bên dưới là các trường bắt buộc cung cấp thông tin kết nối cần thiết để nhận access code.

Sau khi cung cấp App ID và Redirect URL của bạn và nhấp vào nút Connect my account; từ đó cửa sổ cấp quyền cho app xuất hiện và bạn có thể chọn quyền cho ứng dụng của mình. Sau đó bạn click nút "Đồng ý" để tiếp tục lấy access code.

Permissions window

Sau khi nhấn nút "Đồng ý", trình duyệt sẽ chuyển hướng đến Redirect URL đính kèm với access code. Access code của bạn là xâu chuỗi sau "accessCode=". Bạn copy mã đó để sử dụng trong bước tiếp theo.

Access Code window

Sau khi lấy được access code bạn đóng Access Code window và trở về credential screen. Ngay lúc này bạn tắt nó và chỉ cần bấm đóng khi Close without connecting popup xuất hiện vì Nhanhvn không có Authorization server support OAuth 2.0 protocol. Điều này sẽ không ảnh hưởng đến các quá trình tiếp theo.

Close without connecting popup

Tiếp theo, bạn cung cấp access code lấy ở bước trên và Serect Key trong ứng dụng của bạn vào các trường nhập tương ứng trong Nhanhvn Authentication. Sau đó, bạn sẽ click nút Execute node để lấy access Token.

Kết quả sau khi thực thi Nhanhvn Authentication node:

Execute node screen

3. Nhanhvn node (Append)

• Nhấp vào nút Click on the Add node or drag to connect và nhập Nhanhvn trong search nodes box.

• Lựa chọn Create new credential tại trường Credential to connect with.

Cung cấp App ID trong app của bạn và Business ID (note: Business ID is the result of the previous node). After that, you can click save to finish creating credentials.

Find Product

Tìm kiếm Find Product trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để filter tìm kiếm sản phẩm đang cần tìm.

Ví dụ về dữ liệu nhập vào để sử dụng find product action

Cuối cùng, bạn click nút Execute node để run Nhanhvn node:

Create Or Update Product

Tìm kiếm Create Or Update Product trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn click vào nút Add Product để tạo mới hoặc cập nhật 1 sản phẩm

Sau khi click vào nút Add Product bạn sẽ thấy tất cả các trường cần để tạo mới 1 sản phẩm. Nhưng nếu bạn nhập Product ID đã tồn tại trong hệ thống thì action này sẽ cập nhật thông tin mà bạn nhập vào cho sản phẩm đã tồn tại đó. Hoặc bạn có thể tạo mới hoặc cập nhật nhiều product cùng lúc bằng cách click vào nút Add product.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Create Or Update Product action.

Get Detailed Product Information

Tìm kiếm Get Detailed Product Information trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn nhập Product ID mà bạn muốn tìm kiếm vào trường Product ID để tìm kiếm sản phẩm có Product ID đó.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get Detailed Product Information action.

Get the Entire Product Category

Tìm kiếm Get the Entire Product Category trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the Entire Product Category action.

Get the Entire Internal Catalog

Tìm kiếm Get the Entire Internal Catalog trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the Entire Internal Catalog action.

Get a List of Gifts by Product

Tìm kiếm Get a List of Gifts by Product trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường trong hình bên dưới để filter và phân trang hiển thị các quà tặng sản phẩm.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get a List of Gifts by Product action.

Get Product IMEI List

Tìm kiếm Get Product IMEI List trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường trong hình bên dưới để filter và phân trang hiển thị danh sách sản phẩm IMEI.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get Product IMEI List action.

Look up IMEI Sold by Date

Tìm kiếm Look up IMEI Sold by Date trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường trong hình bên dưới để filter và phân trang hiển thị danh sách các IMEI đã bán.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Look up IMEI Sold by Date action.

Get the History List of IMEI

Tìm kiếm Get the History List of IMEI trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn cần nhập IMEI mà bạn muốn xem lịch sử và có thể nhập các trường trong hình bên dưới để filter và phân trang hiển thị danh sách các lịch sử của IMEI bạn nhập vào.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Look up IMEI Sold by Date action.

Get the Product Expiration Date (chưa mở dịch vụ hỗ trợ API)

Create Or Update Customer

Tìm kiếm Create Or Update Customer trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn click vào nút Add Customer để tạo mới hoặc cập nhật 1 khách hàng.

Sau khi click vào nút Add Customer bạn sẽ thấy tất cả các trường cần để tạo mới 1 khách hàng. Nhưng nếu bạn nhập Customer Phone Number đã tồn tại trong hệ thống thì action này sẽ cập nhật thông tin mà bạn nhập vào cho khách hàng đã tồn tại đó. Hoặc bạn có thể tạo mới hoặc cập nhật nhiều khách hàng cùng lúc bằng cách click vào nút Add customer.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Create Or Update Customer action.

Find Customer

Tìm kiếm Find Customer trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để filter tìm kiếm khách hàng đang cần tìm.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm khách hàng theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Find Customer action.

Create Order

Tìm kiếm Create Order trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn nhập các thông tin vào các trường cho đơn hàng mới mà bạn muốn tạo. Hình ảnh dưới đây là ví dụ minh họa dữ liệu nhập vào:

Ở dữ liệu nhập vào tiếp theo ở dưới, có mục Product ở đây bạn có thể thêm sản phẩm và số lượng sản phẩm bạn muốn order.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Create Order action.

Update Order

Tìm kiếm Update Order trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn điền Order ID mà bạn muốn update, và các trường còn lại bên dưới là những trường bạn có thể update cho 1 order. Sau đây là hình ảnh minh họa về dữ liệu nhập vào:

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Update Order action.

Find Order

Tìm kiếm Find Order trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để filter tìm kiếm danh sách các đơn hàng đang cần tìm.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Find Order action.

Submit an Order Complaint

Tìm kiếm Submit an Order Complaint trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để gửi khiếu nại đến đơn hàng mà có Order ID bạn nhập vào.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Submit an Order Complaint action. Hình ảnh bên dưới đang sử dụng Order ID của đơn hàng chưa phát sinh giao hàng nên trả về thông báo Order don't send carrier.

Get Order History

Tìm kiếm Get Order History trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn nhập vào trường Order ID, Order ID của đơn hàng nào bạn cần xem lịch sử.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get Order History action.

Get a List of Shipping Companies

Tìm kiếm Get a List of Shipping Companies trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get a List of Shipping Companies action.

Get a List of Cities and Districts

Tìm kiếm Get a List of Cities and Districts trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi bạn nhập các trường để lấy danh sách thành phố hoặc huyện. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get a List of Cities and Districts action.

Charge Shipping

Tìm kiếm Charge Shipping trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để tính phí vận chuyển.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Charge Shipping action.

Get List of Posts

Tìm kiếm Get List of Posts trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách các bài đăng.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các bài đăng theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get List of Posts action.

Get the Entire Business News Catalog

Tìm kiếm Get the Entire Business News Catalog trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the Entire Business News Catalog action.

Add and Edit Subscribers

Tìm kiếm Add and Edit Subscribers trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn click vào nút Add Subscriber để tạo mới hoặc cập nhật 1 subscriber.

Sau khi click vào nút Add Subscriber bạn sẽ thấy tất cả các trường cần để tạo mới subscriber. Nhưng nếu bạn nhập Email của subscriber đã tồn tại trong hệ thống thì action này sẽ cập nhật thông tin mà bạn nhập vào cho subscriber đã tồn tại đó. Hoặc bạn có thể tạo mới hoặc cập nhật nhiều subscriber cùng lúc bằng cách click vào nút Add Subscriber.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Add and Edit Subscribers action.

Add and Edit Contacts

Tìm kiếm Add and Edit Contacts trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn click vào nút Add Contact để tạo mới hoặc cập nhật 1 contact.

Sau khi click vào nút Add Contact bạn sẽ thấy tất cả các trường cần để tạo mới contact. Nhưng nếu bạn nhập Email của contact đã tồn tại trong hệ thống thì action này sẽ cập nhật thông tin mà bạn nhập vào cho contact đã tồn tại đó. Hoặc bạn có thể tạo mới hoặc cập nhật nhiều contact cùng lúc bằng cách click vào nút Add Contact.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Add and Edit Contacts action.

Get the Name of Supplier on Nhanh

Tìm kiếm Get the Name of Supplier on Nhanh trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách các Supplier.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các Supplier theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the Name of Supplier on Nhanh action.

Get the List of Coupon Programs

Tìm kiếm Get the List of Coupon Programs trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách coupon.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các coupon theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the List of Coupon Programs action.

Get a List of the Warehouses of Business

Tìm kiếm Get a List of the Warehouses of Business trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để filter lấy danh sách kho của doanh nghiệp.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các kho theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get a List of the Warehouses of Business action.

Get the List of Employees of the Business

Tìm kiếm Get the List of Employees of the Business trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để filter lấy danh sách nhân viên của doanh nghiệp.

Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the List of Employees of the Business action.

Get the List of Accounting Entries on Nhanh.vn

Tìm kiếm Get the List of Accounting Entries on Nhanh.vn trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách bút toán.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các bút toán theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the List of Accounting Entries on Nhanh.vn action.

Get the List of Customer Debts on Nhanh.vn

Tìm kiếm Get the List of Customer Debts on Nhanh.vn trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách công nợ khách hàng.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các công nợ khách hàng theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get the List of Customer Debts on Nhanh.vn action.

Retrieve List of Warehouse in/out Bill

Tìm kiếm Retrieve List of Warehouse in/out Bill trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách phiếu xuất nhập kho.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các phiếu xuất nhập kho theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Retrieve List of Warehouse in/out Bill action.

Retrieve the List of Enterprise Warehouse Products in and Out

Tìm kiếm Retrieve the List of Enterprise Warehouse Products in and Out trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách sản phẩm xuất nhập kho.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các sản phẩm xuất nhập kho theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Retrieve the List of Enterprise Warehouse Products in and Out action.

Get a List of Products that Require Import and Export From the Enterprise Warehouse

Tìm kiếm Get a List of Products that Require Import and Export From the Enterprise Warehouse trong search Nhanhvn Actions box.

• Nhập access token của bạn trong trường Access Token.

Sau khi nhập access token, bạn có thể nhập các trường sau để phân trang và filter danh sách sản phẩm yêu cầu xuất nhập kho.

Sau khi đã nhập giá trị cho trường muốn tìm kiếm các sản phẩm yêu cầu xuất nhập kho theo trường đó. Cuối cùng, bạn click vào nút Execute node để chạy Nhanhvn node thực thi Get a List of Products that Require Import and Export From the Enterprise Warehouse action.