Alegra (Unofficial - BETA) icon

Alegra (Unofficial - BETA)

Consume Alegra API - UNOFFICIAL BETA community node. NOT officially supported by Alegra.

Actions37

Overview

The node integrates with the Alegra API to manage tax records. Specifically, the Tax - Update operation allows users to update an existing tax entry by specifying its ID and the fields to modify. This is useful in scenarios where tax details such as name, percentage, description, or status need to be changed after creation.

Practical examples include:

  • Correcting a tax percentage due to regulatory changes.
  • Updating the tax name or description for clarity.
  • Activating or deactivating a tax without deleting it.

This operation helps maintain accurate and up-to-date tax information within Alegra accounting workflows.

Properties

Name Meaning
Tax ID The unique identifier of the tax record to update (required).
Update Fields A collection of fields to update on the tax record:
- Name: The new name of the tax.
- Percentage: The new tax percentage (number with two decimals).
- Description: A textual description of the tax.
- Status: Boolean indicating whether the tax is active (true) or inactive (false).

Output

The output JSON contains the updated tax object returned from the Alegra API after a successful update. It reflects the current state of the tax resource including any modified fields.

No binary data is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Alegra API.
  • The node uses HTTP methods (PUT) to communicate with the /taxes/{id} endpoint of the Alegra API.
  • Proper configuration of the API environment URL and credentials in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Tax ID will cause the API to return an error.
    • Providing invalid field values (e.g., negative percentage) may result in validation errors.
    • Network or authentication failures if the API key is incorrect or expired.

  • Error messages:

    • "Unknown error occurred": Generic catch-all; verify network connectivity and API credentials.
    • API validation errors typically indicate which field is invalid; ensure all required fields are correctly formatted.

  • Resolution tips:

    • Double-check the Tax ID exists before updating.
    • Validate input data types and constraints.
    • Confirm API credentials and environment settings in n8n.

Links and References

Discussion