Bitrix24Install

Overview

This node integrates with the Bitrix24 platform, specifically enabling interaction with its CRM and business automation features. The "Get SPA Settings" operation under the "SPA" resource allows users to retrieve configuration and metadata related to Smart Process Automation (SPA) types within Bitrix24.

Typical use cases include:

• Fetching SPA type definitions and settings to dynamically configure workflows.
• Automating processes based on SPA metadata.
• Integrating SPA data into other systems or reporting tools.

For example, a user might use this node to get all available SPA types and their fields to build a custom form or automate data entry in Bitrix24.

Properties

The node also requires selecting the Resource ("SPA" in this case) and the Operation ("Get SPA Settings"). Additional parameters may be dynamically loaded depending on the SPA type selected, but these are not explicitly listed here.

Output

The node outputs JSON data representing the results of the requested SPA settings or metadata. This typically includes:

• Lists of SPA types with their IDs and titles.
• Detailed field information for a given SPA type, including field names, types, and whether they are required or read-only.
• Other SPA-related configuration data such as automation enablement status.

If an error occurs during execution, the output JSON will contain an error field with the error message, along with the resource name and a timestamp.

The node does not output binary data.

Dependencies

• Requires a valid Bitrix24 authentication credential configured in n8n. Supported authentication methods are OAuth2, webhook URL, or API key.
• Uses Bitrix24 REST API endpoints such as crm.type.list and crm.item.fields to fetch SPA types and fields.
• Relies on internal helper functions to make standardized API calls to Bitrix24.

Troubleshooting

• Common issues:

  • Authentication failures due to invalid or expired credentials.
  • API rate limits or connectivity issues with Bitrix24.
  • Missing or incorrect SPA type ID parameter causing empty or error responses.

• Error messages:

  • Errors returned from Bitrix24 API calls will appear in the output's error field.
  • If the node fails to load SPA types or fields, it returns descriptive error messages like "Failed to load SPA types" or "Failed to load SPA fields".

• Resolutions:

  • Verify that the chosen authentication method is correctly set up and authorized.
  • Ensure the SPA type ID parameter is provided when required.
  • Check network connectivity and Bitrix24 API status.
  • Enable "Continue On Fail" option if you want the workflow to proceed despite errors.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 Smart Process Automation Overview
• n8n documentation on creating custom nodes