Bitrix24

Overview

This node integrates with the Bitrix24 CRM and business platform, enabling users to interact with various Bitrix24 resources. Specifically, for the Document Generator resource with the Get Template Fields operation, it retrieves the fields available in a document template within Bitrix24. This is useful when you want to dynamically fetch and use template fields for generating or populating documents based on Bitrix24 data.

Common scenarios include:

• Automatically fetching available fields from a document template to map data dynamically.
• Preparing data structures for document generation workflows.
• Integrating Bitrix24 document templates into automated processes without manual field entry.

Example: You have a document template for contracts in Bitrix24 and want to retrieve all its fields to fill them automatically with customer data during workflow execution.

Properties

Output

The node outputs an array of items where each item contains a json object representing the result of the requested operation.

For the Get Template Fields operation, the output JSON includes the list of fields retrieved from the specified document template. Each field typically has properties such as:

• name: The display name of the field.
• value: The internal identifier of the field.
• description: Additional information about the field, such as type or whether it is required.

If an error occurs, the output JSON will contain an error property with the error message, along with metadata like the resource name and timestamp.

The node does not output binary data.

Dependencies

• Requires connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
• Uses Bitrix24 API endpoints internally to fetch data.
• Requires proper configuration of credentials in n8n corresponding to the chosen authentication method.

Troubleshooting

• Common issues:

  • Authentication failures due to incorrect or expired credentials.
  • API rate limits or permission restrictions on the Bitrix24 account.
  • Missing or invalid template identifiers leading to empty or error responses.

• Error messages:

  • "Failed to load CRM fields: <message>" — Indicates an issue fetching fields; check API permissions and connectivity.
  • "Error loading fields" or "No fields available" — Could mean the template ID is incorrect or the template has no fields.
  • Network or timeout errors — Verify network access and Bitrix24 service status.

• Resolutions:

  • Ensure credentials are valid and have sufficient permissions.
  • Confirm the template exists and is accessible.
  • Retry after some time if rate limits are suspected.

Links and References

• Bitrix24 Official API Documentation
• Bitrix24 Document Generator Overview
• n8n documentation on creating custom nodes