Phụ Thu KiotViet icon

Phụ Thu KiotViet

Quản lý phụ thu từ KiotViet

Actions5

Tạo Mới

AI-generated

Overview

This node manages surcharges in the KiotViet system, specifically allowing the creation of new surcharges. It is useful for businesses that need to add additional charges to invoices, such as service fees or taxes. For example, a user can create a surcharge named "Service Fee" with a fixed value or a percentage rate to be automatically applied to customer bills.

Use Case Examples

  1. Create a new surcharge named 'Service Fee' with a value of 10, which is a fixed amount.
  2. Create a new surcharge named 'VAT' with a value of 5, which is a percentage of the invoice total.

Properties

Name Meaning
Tên Phụ Thu The name of the surcharge to be created.
Giá Trị The value of the surcharge, either a fixed amount or a percentage depending on the 'Là Phần Trăm' property.
Là Phần Trăm Indicates whether the surcharge value is a percentage or a fixed amount.
Trường Bổ Sung Additional optional fields for the surcharge such as code, description, auto-add flag, required flag, applicable branch IDs, and active status.

Output

JSON

  • id - The unique identifier of the created surcharge.
  • name - The name of the created surcharge.
  • value - The value of the created surcharge.
  • isPercent - Indicates if the value is a percentage.
  • code - The code identifier of the surcharge.
  • description - Description of the surcharge.
  • isAutoAdd - Flag indicating if the surcharge is automatically added to invoices.
  • isRequired - Flag indicating if the surcharge is mandatory.
  • branchIds - Branch IDs where the surcharge applies.
  • isActive - Active status of the surcharge.

Dependencies

  • KiotViet API with authentication credentials

Troubleshooting

  • Ensure all required fields (name, value, isPercent) are provided when creating a surcharge.
  • Check API credentials and network connectivity if the node fails to communicate with the KiotViet API.
  • If the node throws an error about invalid field values, verify that numeric fields are correctly formatted and boolean fields are properly set.

Links

Discussion