Bitrix

Overview

This node integrates with the Bitrix24 REST API, specifically targeting CRM entities such as companies, contacts, deals, items, and leads. The "Get Fields Description" operation for the "Company" resource retrieves metadata about the fields available in a company record within Bitrix24. This is useful for dynamically understanding what data can be accessed or manipulated in company records, enabling users to build workflows that adapt to the structure of their Bitrix24 CRM.

Practical examples include:

• Fetching field descriptions to generate dynamic forms or UI elements.
• Validating input data against the expected fields before creating or updating company records.
• Automating documentation or reporting on CRM schema changes.

Properties

Output

The node outputs JSON data containing the description of the fields for the Company resource. This typically includes field names, types, labels, and possibly other metadata describing each field's characteristics in the Bitrix24 CRM system.

No binary data output is involved in this operation.

Dependencies

• Requires authentication credentials for Bitrix24, either via OAuth2 or Webhook method.
• Needs proper configuration of these credentials within n8n to access the Bitrix24 REST API.
• Relies on Bitrix24's API availability and permissions granted to the authenticated user.

Troubleshooting

• Authentication errors: Ensure that the provided OAuth2 token or webhook URL is valid and has sufficient permissions to access company data.
• API rate limits: Bitrix24 may impose limits; hitting these could cause errors or delays.
• Field description not returned: Verify that the Bitrix24 account has company records and that the API endpoint supports fetching field metadata.
• Invalid resource or operation: Selecting unsupported resources or operations will result in errors; confirm correct selection.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 CRM Entities Overview
• n8n Documentation on Credentials