Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node integrates with the Bitrix24 CRM and business platform, allowing users to interact with various Bitrix24 resources. Specifically, for the Document Generator resource with the Get Providers operation, it retrieves a list of available document providers from Bitrix24.

Common scenarios where this node is beneficial include automating document generation workflows within Bitrix24, such as fetching available templates or providers before generating contracts, invoices, or other documents dynamically. For example, a user might first get the list of document providers to present options in a UI or to select a provider programmatically for subsequent document creation steps.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24. Options:
- OAuth2 (recommended for production)
- Webhook (simpler but less secure)
- API Key

Output

The node outputs an array of JSON objects representing the data returned by the Bitrix24 API for the requested resource and operation. For the Get Providers operation under the Document Generator resource, the output JSON typically contains information about document providers available in the Bitrix24 account.

The exact structure depends on the Bitrix24 API response but generally includes fields such as provider IDs, names, and possibly descriptions or metadata related to each document provider.

If the node supports binary data output (not indicated here), it would be summarized as providing relevant binary content associated with the operation, such as generated documents or files.

Dependencies

  • Requires access to a Bitrix24 account with appropriate permissions.
  • Needs one of the following authentication methods configured in n8n:
    • OAuth2 credentials
    • Webhook URL
    • API Key credential
  • The node relies on internal helper functions to make standard Bitrix24 API calls.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured and valid. OAuth2 tokens may expire and require refresh.
  • API call failures: Network issues or incorrect permissions can cause API calls to fail. Verify connectivity and user rights in Bitrix24.
  • Empty or unexpected results: If no providers are returned, confirm that document providers exist in the Bitrix24 account and that the API endpoint supports the requested operation.
  • Continue on Fail: If enabled, the node returns error details in the output JSON instead of failing the workflow, which helps in debugging.

Links and References

Discussion