Dolibarr icon

Dolibarr

Interact with Dolibarr API

Overview

This node integrates with the Dolibarr API to update an existing event in the Dolibarr agenda. It allows users to modify various fields of a specified event by providing the event's unique identifier and the fields to update.

Common scenarios include:

  • Updating event details such as title, date, description, or location after creation.
  • Correcting or adding information to an existing calendar event in Dolibarr.
  • Automating event management workflows where event data needs to be programmatically adjusted.

Practical example:

  • A user wants to change the start time and add notes to a meeting event already scheduled in Dolibarr. By specifying the event ID and the updated fields, this node sends the changes to Dolibarr, ensuring the event is up-to-date.

Properties

Name Meaning
Event ID The unique numeric identifier of the event to update.
Fields The collection of event fields to update. This can include any modifiable event property.

Output

The node outputs the full response from the Dolibarr API after attempting to update the event. The json output field contains the updated event data as returned by the API, reflecting the new state of the event.

If the update is successful, the output JSON will typically include the event's properties with their updated values.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to a Dolibarr instance via its REST API.
  • Needs an API authentication token or key configured in n8n credentials for Dolibarr.
  • The base URL of the Dolibarr API must be set correctly in the credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing Event ID: The node requires a valid event identifier; otherwise, the API call will fail.
    • Incorrect or incomplete fields: Providing invalid field names or values may cause the API to reject the update.
    • Authentication errors: If the API key or token is incorrect or expired, the request will not succeed.
    • Network or connectivity problems with the Dolibarr server.
  • Error messages:

    • HTTP 404 Not Found: Usually means the event ID does not exist.
    • HTTP 401 Unauthorized: Indicates authentication failure; check API credentials.
    • Validation errors from the API: Returned if fields are malformed or contain invalid data.

To resolve these:

  • Verify the event ID exists in Dolibarr.
  • Double-check the fields being updated conform to Dolibarr's expected schema.
  • Ensure API credentials are correct and have sufficient permissions.
  • Confirm network access to the Dolibarr API endpoint.

Links and References

Discussion