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 to manage invoices, specifically supporting operations such as creating, retrieving, updating, sending by email, listing, and deleting invoices. The Delete Invoice operation allows users to remove an existing sales invoice from their Alegra account by specifying its unique ID.

Typical use cases include automating invoice lifecycle management within business workflows, such as cleaning up obsolete or incorrect invoices, or integrating invoice deletion into broader financial automation processes.

For example, a user might set up a workflow that deletes invoices automatically when certain conditions are met (e.g., canceled orders), ensuring the Alegra system stays up-to-date without manual intervention.

Properties

Name Meaning
Invoice ID The unique identifier of the invoice to delete

The node requires the Invoice ID property to specify which invoice should be deleted.

Output

The output of the Delete Invoice operation is a JSON object representing the response from the Alegra API after attempting to delete the specified invoice. Typically, this will confirm successful deletion or provide error details if the operation failed.

The structure generally includes status information or confirmation messages but does not output binary data.

Example output JSON (conceptual):

{
  "message": "Invoice deleted successfully",
  "id": "12345"
}

Or in case of error:

{
  "error": "Invoice not found"
}

Dependencies

  • Requires an active connection to the Alegra API via an API key credential configured in n8n.
  • The node uses HTTP requests authenticated with this API key to perform actions on Alegra resources.
  • No additional external dependencies beyond the Alegra API and proper credential setup.

Troubleshooting

  • Common issues:

    • Invalid or missing Invoice ID: The node requires a valid invoice ID; ensure the ID exists in Alegra.
    • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
    • Network or API downtime: Check network connectivity and Alegra service status.

  • Error messages:

    • "Invoice not found": The specified invoice ID does not exist. Confirm the ID is correct.
    • "Unauthorized" or authentication errors: Recheck API credentials.
    • "Unknown error occurred": Generic catch-all for unexpected failures; review node logs and API responses for details.

To resolve errors, verify input parameters, ensure credentials are valid, and consult Alegra API documentation or support if needed.

Links and References

Discussion