Overview
This node manages warehouse transfer records in the KiotViet system, allowing users to create, update, retrieve, list, and delete stock transfer documents between branches. It is useful for businesses that operate multiple branches or warehouses and need to track inventory movements accurately.
Typical use cases include:
- Creating a new transfer record when goods are moved from one branch to another.
- Updating existing transfer details such as quantities or descriptions.
- Retrieving specific transfer records by ID.
- Listing transfers with various filters like date ranges, status, or involved branches.
- Deleting obsolete or incorrect transfer records.
For example, a retail chain can automate updating their inventory system whenever stock is transferred between stores, ensuring real-time accuracy of stock levels.
Properties
| Name | Meaning |
|---|---|
| ID Phiếu Chuyển | The unique identifier of the transfer record (required for get, update, delete operations). |
| Chi Nhánh Gửi | The ID of the branch sending the goods (required for create and update). |
| Chi Nhánh Nhận | The ID of the branch receiving the goods (required for create and update). |
| Mã Phiếu Chuyển | The code of the transfer document; if left empty, it will be generated automatically. |
| Mô Tả | Description of the transfer document. |
| Là Bản Nháp | Boolean flag indicating whether the transfer is saved as a draft. |
| Chi Tiết Sản Phẩm | A collection of product details being transferred, each including: |
| - ID Sản Phẩm: Product ID (required) | |
| - Mã Sản Phẩm: Product code (required) | |
| - Số Lượng Gửi: Quantity sent (required) | |
| - Số Lượng Nhận: Quantity received (optional) | |
| - Giá: Price of the product (required) |
Output
The node outputs an array of JSON objects representing the result of the operation:
- For create, update, get, and getAll operations, the output contains the transfer data returned by the KiotViet API, typically including all fields of the transfer record such as IDs, branch info, product details, status, dates, etc.
- For the delete operation, the output is a simple JSON object confirming success with a message.
- If multiple items are returned (e.g., in listing), they are flattened into the output array.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the KiotViet API.
- Uses the KiotViet API client internally to perform CRUD operations on transfer records.
- No additional environment variables are needed beyond the API credential configuration.
Troubleshooting
- Invalid or missing transfer ID: When performing get, update, or delete operations, ensure the "ID Phiếu Chuyển" property is provided and valid. Errors will occur if this is missing or malformed.
- API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Data validation errors: Required fields such as branch IDs and product details must be correctly filled. Missing or invalid data may cause the API to reject requests.
- Network or API downtime: Temporary connectivity issues with the KiotViet service can cause failures; retrying later may help.
- Continue On Fail: If enabled, the node will continue processing remaining items even if some fail, returning error messages in the output.
Links and References
- KiotViet Official Website
- KiotViet API Documentation (for detailed API usage and field definitions)