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 contacts, specifically allowing you to create new contacts such as clients or providers. It is useful in scenarios where you want to automate the addition of contact information into Alegra from other systems or workflows, ensuring your contact database stays up-to-date without manual entry.

For example, when a new client signs up on your website, this node can automatically create a corresponding contact record in Alegra with all relevant details like identification, contact info, and additional metadata.

Properties

Name Meaning
Name The full name of the contact to be created.
Contact Type The type of contact; options are: Client, Provider.
Identification Type The type of identification document; options include CC, CE, NIT, PP, TI, RC, RUT, DNI, RFC, RUC.
Identification Number The number of the identification document.
Additional Fields A collection of optional fields to provide more details about the contact:
- Email Contact's email address.
- Phone Primary Primary phone number.
- Phone Secondary Secondary phone number.
- Mobile Mobile phone number.
- Fax Fax number.
- Address Nested address fields including street address, city, department/state, country, postal code.
- Observations Additional notes or observations about the contact.
- Seller Name or ID Reference to a seller associated with the contact (selectable from a list or via expression).
- Price List Name or ID Reference to a price list associated with the contact (selectable from a list or via expression).
- Ignore Repeated Boolean flag indicating whether to ignore creation if a contact with the same identification exists.
- Include Statement Link Boolean flag indicating whether to include a customer statement link.

Output

The node outputs a JSON object representing the newly created contact as returned by the Alegra API. This includes all the contact details sent during creation along with any additional data Alegra provides, such as the unique contact ID and timestamps.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Alegra API.
  • The node expects the Alegra API base URL and authentication credentials to be configured within n8n.
  • Network access to Alegra's API endpoints is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Providing incomplete required fields (e.g., missing name or identification number) will result in errors.
    • Attempting to create a contact with an existing identification number without setting "Ignore Repeated" may cause duplication errors.

  • Error Messages:

    • Errors from the API are surfaced as node operation errors with messages describing the issue (e.g., "Identification number already exists").
    • Network or connectivity issues will throw generic errors; ensure network access and correct API endpoint configuration.

  • Resolution Tips:

    • Verify that all required fields are correctly filled.
    • Check API credentials and permissions.
    • Use the "Ignore Repeated" option if you want to skip creating duplicates based on identification number.
    • Review the API response message for specific validation errors.

Links and References

Discussion