Bitrix24Install

Overview

This node integrates with the Bitrix24 CRM and business platform, allowing users to perform various operations on Bitrix24 resources. Specifically, the Update Document operation under the Document Generator resource enables updating existing documents within Bitrix24.

Typical use cases include automating document updates in workflows, such as modifying contract templates, invoices, or other generated documents based on dynamic data from other systems. For example, after processing a customer order, you could update a related document in Bitrix24 with new details like pricing or delivery dates.

Properties

Note: The provided properties JSON only includes the "Authentication" property. Other properties relevant to the "Document Generator" resource and "Update Document" operation are defined elsewhere in the node but are not included here.

Output

The node outputs an array of items where each item contains a json object representing the result of the operation performed on Bitrix24. For the Update Document operation, this typically includes the updated document's data returned by the Bitrix24 API.

If an error occurs and the node is configured to continue on failure, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

The node does not explicitly handle binary data output.

Dependencies

• Requires connection to Bitrix24 via one of the supported authentication methods:

  • OAuth2 authentication (recommended)
  • Webhook URL
  • API Key authentication

• The node depends on internal helper modules for making API calls to Bitrix24 and handling different resources and operations.

• Proper credentials must be configured in n8n for the chosen authentication method.

Troubleshooting

• Common Issues:

  • Incorrect or expired authentication credentials can cause authorization failures.
  • Network connectivity issues may prevent API calls to Bitrix24.
  • Providing invalid or incomplete parameters for the Update Document operation may result in API errors.

• Error Messages:

  • Errors thrown during execution include the message from the Bitrix24 API or internal exceptions.
  • If "Continue On Fail" is enabled, errors are returned in the output JSON with fields error, resource, and timestamp.

• Resolution Tips:

  • Verify that the selected authentication method is correctly set up and credentials are valid.
  • Check network access to Bitrix24 endpoints.
  • Ensure all required input parameters for the Update Document operation are provided and correctly formatted.

Links and References

• Bitrix24 Official API Documentation
• n8n Documentation on Creating Custom Nodes