Dolibarr icon

Dolibarr

Interact with Dolibarr API

Overview

This node interacts with the Dolibarr API to manage contacts and their associated categories. Specifically, the "Delete Categories" operation under the "Contact" resource removes a category association from a specified contact. This is useful in scenarios where you want to update or clean up contact categorizations, for example, removing outdated or incorrect category tags from a contact record.

Practical examples:

  • Removing a "VIP" category from a customer who no longer qualifies.
  • Cleaning up contact categories after a data import or synchronization process.

Properties

Name Meaning
Contact ID The unique identifier of the contact from which a category will be removed. Must be a positive integer.
Category ID The unique identifier of the category to delete from the specified contact. Must be a positive integer.

Output

The node outputs the full HTTP response from the Dolibarr API after attempting to delete the category from the contact. The main output is available in the json field and typically contains confirmation of the deletion or an error message if the operation failed.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to a Dolibarr instance via its REST API.
  • Needs an API key credential configured in n8n for authenticating requests to Dolibarr.
  • The base URL of the Dolibarr API must be set in the credentials configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing Contact ID or Category ID will cause the API call to fail.
    • Network connectivity problems or incorrect base URL can prevent successful API communication.
    • Insufficient permissions on the API key may result in authorization errors.
  • Error messages:

    • HTTP 404 Not Found: The specified contact or category does not exist. Verify the IDs.
    • HTTP 401 Unauthorized: Authentication failed. Check the API key credential.
    • HTTP 400 Bad Request: Likely due to invalid input parameters; ensure IDs are positive integers.

Resolving these usually involves verifying input values, checking API credentials, and ensuring the Dolibarr instance is accessible.

Links and References

Discussion