Overview
This node manages warehouse transfers and inventory stock from the KiotViet system. It supports operations such as creating, updating, deleting, retrieving a single transfer by ID, and listing multiple transfers with filtering options.
A common use case is automating the synchronization of warehouse transfer records between KiotViet and other systems or workflows. For example, you can fetch all transfer orders within a date range or with specific statuses to update your internal logistics dashboard. Another scenario is creating new transfer orders programmatically based on sales or stock movement events.
Specifically, the "Lấy Danh Sách" (Get List) operation retrieves a filtered list of transfer orders, which is useful for reporting, auditing, or triggering downstream processes based on transfer data.
Properties
| Name | Meaning |
|---|---|
| Bộ Lọc (filters) | Collection of filters to narrow down the list of transfers: |
| Chi Nhánh Gửi (fromBranchIds) | IDs of sending branches (multiple IDs separated by commas) |
| Từ Ngày Nhận (fromReceivedDate) | Filter transfers received from this date |
| Từ Ngày Chuyển (fromTransferDate) | Filter transfers sent from this date |
| Trạng Thái (status) | Statuses of transfer orders (multiple statuses separated by commas) |
| Chi Nhánh Nhận (toBranchIds) | IDs of receiving branches (multiple IDs separated by commas) |
| ĐếN Ngày Nhận (toReceivedDate) | Filter transfers received up to this date |
| ĐếN Ngày Chuyển (toTransferDate) | Filter transfers sent up to this date |
| Tùy Chọn (options) | Additional options controlling pagination and result limits: |
| Giới Hạn (pageSize) | Number of results to return (1 to 100, default 20) |
| Vị Trí Bắt ĐầU (currentItem) | Starting position/index to begin fetching data (default 0) |
Output
The output is an array of JSON objects representing transfer orders matching the filter criteria. Each object corresponds to a transfer record returned by the KiotViet API and includes fields such as branch IDs, status, dates, product details, and other metadata.
If the response contains a data field with an array, the node flattens and returns these items directly. Otherwise, it returns the raw object.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the KiotViet API.
- Uses an internal KiotViet API client class to perform HTTP requests.
- No additional environment variables are required beyond the API credential configuration in n8n.
Troubleshooting
- Invalid Filter Values: Providing non-numeric values for branch IDs or statuses (which expect comma-separated numbers) may cause errors or empty results. Ensure IDs and statuses are numeric and properly formatted.
- API Authentication Errors: If the API key credential is missing or invalid, the node will fail to connect. Verify that the API key is correctly configured.
- Pagination Issues: Setting
pageSizetoo high orcurrentItemout of range may lead to unexpected results or empty responses. Use sensible values within allowed ranges. - Unhandled Operation: If an unsupported operation is selected, the node throws an error indicating the operation is not supported.
- Continue On Fail: When enabled, the node captures errors per item and continues processing subsequent items, returning error messages in the output.