Actions28
Contracts → Update Line
AI-generatedOverview
This node operation updates a specific line item within a contract in the Dolibarr system. It is useful for scenarios where contract details need to be modified, such as changing the description, product or service ID, pricing, quantity, tax details, dates, discounts, or additional custom fields of a contract line. For example, a user can update the unit price or planned start and end dates of a contract line to reflect new terms or corrections.
Use Case Examples
- Updating the quantity and unit price of a product line in a contract to reflect a new order amount.
- Changing the description and tax settings of a service line in a contract to comply with updated billing requirements.
- Adding extra custom attributes to a contract line for internal tracking or reporting purposes.
Properties
| Name | Meaning |
|---|---|
| Contract ID | The unique identifier of the contract containing the line to update. Required to specify which contract is being modified. |
| Line ID | The unique identifier of the specific line within the contract to update. Required to specify which line item is being modified. |
| Values | A collection of fields representing the details to update on the contract line, such as description, product/service ID, sales tax percentage, tax type (exclusive or inclusive), unit price, quantity, discount percentage, planned start and end dates. These fields map directly to the contract line's properties in Dolibarr. |
| Extra Fields | Additional custom attributes that can be added to the contract line. These are user-defined fields loaded dynamically and sent as part of the request body. |
| Fields | Other contract fields that can be assigned or updated, allowing for extended customization beyond the predefined properties. |
| Request Options | Settings to control request behavior such as batching of requests, SSL certificate validation, proxy configuration, and request timeout duration. |
Output
JSON
response- The full response from the Dolibarr API after updating the contract line, including status and updated data.
Dependencies
- Dolibarr API with appropriate credentials
Troubleshooting
- Ensure that the Contract ID and Line ID are valid and exist in the Dolibarr system to avoid 'not found' errors.
- Verify that required fields such as Contract ID, Line ID, and Quantity are provided to prevent validation errors.
- Check API credentials and base URL configuration to avoid authentication or connection issues.
- If SSL errors occur, consider enabling the 'Ignore SSL Issues' option or verify the SSL certificate validity.
- When using batching, ensure batch size and interval are set appropriately to avoid rate limiting or timeouts.