📖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.
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.
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.
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.
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:
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.
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.
Last updated