Bitrix24Install

Overview

This node integrates with the Bitrix24 CRM and business platform, allowing users to interact with various Bitrix24 resources such as contacts, deals, leads, companies, quotes, invoices, products, and activities. Specifically, for the Product resource and the Get Product Fields operation, it fetches metadata about the fields available in Bitrix24's product entity.

This is useful when you want to dynamically retrieve the list of fields that exist for products in your Bitrix24 instance, for example, to build dynamic forms, validate data before sending it to Bitrix24, or map fields between systems.

Practical examples:

• Automatically loading all available product fields to create a custom UI form for product data entry.
• Fetching field metadata to understand which fields are required or read-only before creating or updating products.
• Using the field list to configure other automation steps that depend on product attributes.

Properties

Output

The node outputs an array of objects representing the fields of the selected Bitrix24 resource (in this case, product fields). Each object typically contains:

• name: The display label of the field (e.g., "Product Name").
• value: The internal field ID used by Bitrix24 (e.g., "NAME").
• description: Additional information about the field, such as its type and whether it is required.

The output JSON structure looks like this (example):

[
  {
    "name": "Product Name",
    "value": "NAME",
    "description": "string - Field ID: NAME"
  },
  {
    "name": "Price",
    "value": "PRICE",
    "description": "double - Field ID: PRICE"
  }
]

No binary data output is produced by this operation.

Dependencies

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

  • OAuth2 token credential
  • Webhook URL
  • API key credential

• The node internally calls Bitrix24 API endpoints such as crm.product.fields to retrieve field metadata.

• Proper configuration of credentials in n8n is necessary to authenticate API requests.

Troubleshooting

• Common issues:

  • Failure to load fields due to incorrect or expired authentication credentials.
  • Network connectivity problems preventing API calls.
  • Insufficient permissions in Bitrix24 user account to access product metadata.

• Error messages:

  • "Failed to load CRM fields: <error message>" — Indicates an issue during the API call; check credentials and network.
  • "Error loading fields" — Generic error when fetching fields; inspect node execution logs for details.

• Resolutions:

  • Verify that the chosen authentication method is correctly configured and valid.
  • Ensure the Bitrix24 user has permission to access product data.
  • Check network connectivity and firewall settings.
  • If using webhook authentication, confirm the webhook URL is correct and active.

Links and References

• Bitrix24 REST API Documentation
• Bitrix24 CRM Products API
• n8n Documentation on Credentials