Alegra (Unofficial - BETA) icon

Alegra (Unofficial - BETA)

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

Overview

This node integrates with the Alegra API to manage estimates (quotes). Specifically, the "Get" operation under the "Estimate" resource retrieves detailed information about a single estimate by its unique ID. This is useful in scenarios where you want to fetch and process existing estimate data within an automated workflow, such as reviewing quote details before approval, generating reports, or syncing estimate data with other systems.

For example, you might use this node to:

  • Retrieve an estimate's details to send a customized follow-up email.
  • Pull estimate data into a CRM or ERP system for further processing.
  • Validate estimate information before converting it into an invoice.

Properties

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

Output

The node outputs a JSON object representing the full details of the requested estimate as returned by the Alegra API. This includes fields such as:

  • id: The estimate's unique identifier.
  • date and dueDate: Dates related to the estimate.
  • client: Client information associated with the estimate.
  • items: List of items included in the estimate, each with details like id, price, quantity, description, discount, and taxes.
  • currency: Currency code used in the estimate.
  • Additional optional fields such as seller, observations, annotations, terms and conditions, status, and exchange rate if present.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Alegra API via an API key credential configured in n8n.
  • The node uses the base URL from the credential's environment setting to make authenticated HTTP requests.
  • No additional external dependencies are needed beyond the Alegra API access.

Troubleshooting

  • Common issues:

    • Invalid or missing Estimate ID will cause the API call to fail.
    • Network connectivity problems or incorrect API credentials will result in authentication errors.
    • If the specified estimate ID does not exist, the API will return a not found error.
  • Error messages:

    • Errors from the API are caught and rethrown as node operation errors with the message from the API response.
    • Typical error messages include "Estimate not found" or authentication failures.
  • Resolution tips:

    • Verify that the Estimate ID is correct and exists in Alegra.
    • Ensure the API key credential is valid and has proper permissions.
    • Check network connectivity and API endpoint configuration.

Links and References

Discussion