Alegra (Unofficial - BETA) icon

Alegra (Unofficial - BETA)

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

Actions37

Overview

This node integrates with the Alegra API, an accounting and invoicing platform, to manage various resources such as contacts, invoices, items, payments, estimates, taxes, and bank accounts. Specifically, for the Tax resource with the Get operation, the node retrieves detailed information about a specific tax entry by its ID.

Common scenarios where this node is beneficial include:

  • Fetching tax details to apply correct tax rates in invoices or estimates.
  • Verifying tax configurations before generating financial reports.
  • Automating workflows that require up-to-date tax information from Alegra.

Practical example:

  • A user wants to retrieve the percentage and type of a tax configured in Alegra by providing its Tax ID, so they can use this data in subsequent invoice creation steps.

Properties

Name Meaning
Tax ID The unique identifier of the tax to retrieve. This is a required string input.

Output

The output JSON contains the full details of the requested tax object as returned by the Alegra API. Typical fields may include:

  • id: The tax's unique identifier.
  • name: The name of the tax.
  • percentage: The tax rate percentage.
  • type: The type/category of the tax.
  • Additional optional fields depending on the tax configuration.

No binary data is output by this operation.

Example output JSON structure (simplified):

{
  "id": "123",
  "name": "VAT",
  "percentage": 19,
  "type": "sales"
}

Dependencies

  • Requires an active connection to the Alegra API via an API key credential.
  • The node expects the user to configure the Alegra API credentials within n8n.
  • Network access to Alegra's API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Tax ID: The node requires a valid tax ID; otherwise, the API will return an error.
    • Authentication errors: If the API key credential is invalid or expired, requests will fail.
    • Network connectivity problems may cause request timeouts or failures.

  • Error messages:

    • "Unknown error occurred": Generic catch-all error, often due to network or unexpected API response issues.
    • API-specific errors indicating invalid ID or unauthorized access will be surfaced as error messages.

  • Resolutions:

    • Verify the Tax ID is correct and exists in Alegra.
    • Ensure the API key credential is properly set up and has sufficient permissions.
    • Check network connectivity and proxy/firewall settings if applicable.

Links and References

Discussion