Dolibarr icon

Dolibarr

Interact with Dolibarr API

Overview

This node interacts with the Dolibarr API to perform various operations related to business management. Specifically, for the Contracts - Validate operation, it validates a contract by its ID through the Dolibarr API endpoint. This is useful in scenarios where you want to programmatically confirm that a contract meets certain criteria or is in a valid state before proceeding with further automation steps.

Practical examples include:

  • Automatically validating contracts after creation or update.
  • Integrating contract validation into approval workflows.
  • Ensuring data integrity by checking contract validity before invoicing or reporting.

Properties

Name Meaning
Contract ID The unique numeric identifier of the contract to validate. Must be an integer ≥ 1.

Output

The node outputs the full HTTP response from the Dolibarr API when validating the contract. The main output is a JSON object containing the validation result and any related information returned by the API.

If the API returns binary data (not typical for this operation), it would be included accordingly, but primarily the output is JSON describing the contract validation status.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or missing Contract ID will cause the request to fail.
    • Incorrect or expired API credentials will lead to authentication errors.
    • Network connectivity problems can prevent reaching the Dolibarr API.
    • If the contract ID does not exist, the API may return a 404 error.
  • Error messages and resolutions:

    • Authentication errors: Verify that the API key/token is correct and has sufficient permissions.
    • 404 Not Found: Confirm the Contract ID exists in Dolibarr.
    • 400 Bad Request: Ensure the Contract ID is a positive integer and properly passed.
    • Network errors: Check network connectivity and Dolibarr server availability.

Links and References

Discussion