Nhà Cung Cấp KiotViet icon

Nhà Cung Cấp KiotViet

Quản lý nhà cung cấp từ KiotViet
Join our community

Actions2

Overview

This node integrates with the KiotViet platform to manage supplier data. It allows users to either retrieve a single supplier by its ID or fetch a list of suppliers with optional filtering and pagination controls. This is useful for automating workflows that require supplier information, such as inventory management, order processing, or reporting.

Practical examples include:

  • Fetching details of a specific supplier to update records in another system.
  • Retrieving a filtered list of active suppliers to synchronize with an external database.
  • Exporting supplier lists for analysis or auditing purposes.

Properties

Name Meaning
Thao Tác (operation) The action to perform: "Lấy Theo ID" (Get by ID) or "Lấy Danh Sách" (Get All suppliers).
ID Nhà Cung Cấp (supplierId) The unique identifier of the supplier to retrieve (used only when operation is "Lấy Theo ID").
Lấy Toàn Bộ (returnAll) Whether to return all supplier results without limit (boolean, used only when operation is "Lấy Danh Sách").
Giới Hạn (limit) Maximum number of supplier results to return (number, minimum 1, used only when operation is "Lấy Danh Sách" and returnAll is false).
Bộ Lọc (filters) Collection of filters applied when listing suppliers (used only when operation is "Lấy Danh Sách"):
- Từ Khóa Tìm Kiếm (searchTerm): Search by supplier name or code.
- Trạng Thái (status): Filter by supplier status; options are "ĐAng Hoạt ĐộNg" (Active) or "Ngừng Hoạt ĐộNg" (Inactive).

Output

The node outputs JSON data representing supplier information:

  • For the "Lấy Theo ID" operation, the output is a JSON object containing the details of the specified supplier.
  • For the "Lấy Danh Sách" operation, the output is an array of supplier objects matching the filter criteria and pagination settings.

Each output item includes metadata linking it to the input item index.

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 requests.
  • No additional environment variables are needed beyond the configured API credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing supplier ID when using the "Lấy Theo ID" operation will cause errors.
    • Exceeding API rate limits or network connectivity problems may result in request failures.
    • Incorrect filter values might lead to empty results.

  • Error messages:

    • Errors returned from the KiotViet API are surfaced with their message property.
    • If "Continue On Fail" is enabled, errors for individual items are returned as JSON objects with an error field instead of stopping execution.

  • Resolutions:

    • Verify supplier IDs are correct and exist in KiotViet.
    • Check API credentials and network connectivity.
    • Adjust filters to valid values and ensure they match existing data.

Links and References

Discussion