Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node integrates with the Bitrix24 platform to update properties of products within the Bitrix24 CRM system. It allows users to modify existing product property attributes such as name, code, type, requirement status, sort order, multiplicity, active state, and list values. This is useful in scenarios where product metadata needs to be kept current or customized dynamically, for example, updating a product's specification fields or adjusting property settings based on business rules.

Practical examples include:

  • Changing the label or code of a product attribute to reflect new naming conventions.
  • Updating whether a product property is mandatory or optional.
  • Modifying the available options for a list-type property.
  • Activating or deactivating certain product properties without deleting them.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Property ID The unique identifier of the product property to update (required).
Property Name The display name of the product property (required).
Property Code The internal code of the product property (required).
Property Type The data type of the product property. Options: String, Number, List, File, Date, DateTime, HTML, Element, GPS, User. (required)
Property Required Boolean indicating if the property must have a value (true = required, false = optional).
Property Sort Order Numeric value defining the order in which the property appears relative to others.
Property Multiple Boolean indicating if the property can hold multiple values.
Property Active Boolean indicating if the property is currently active and usable.
Property Values For list-type properties, a collection containing comma-separated values that define the list options.

Output

The node outputs an array of items, each containing a json object representing the result of the update operation. The exact structure depends on the Bitrix24 API response but typically includes confirmation of the updated property details or error information if the update failed.

If an error occurs and "Continue On Fail" is enabled, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

No binary data output is produced by this node.

Dependencies

  • Requires access to a Bitrix24 account with appropriate permissions to update product properties.
  • Requires one of the following authentication methods configured in n8n:
    • OAuth2 authentication (recommended for production use).
    • Bitrix24 webhook URL (simpler but less secure).
    • Bitrix24 API key authentication.
  • The node relies on Bitrix24's REST API endpoints for product property management.

Troubleshooting

  • Common issues:

    • Invalid or missing Property ID: Ensure the correct property ID is provided; otherwise, the update will fail.
    • Insufficient permissions: The authenticated user must have rights to modify product properties.
    • Incorrect authentication setup: Verify that the chosen authentication method is correctly configured and valid.
    • Invalid property values: For list-type properties, ensure the values are properly formatted as comma-separated strings.

  • Error messages:

    • Errors returned from Bitrix24 API will be included in the output if "Continue On Fail" is enabled.
    • Common errors include authorization failures, invalid parameters, or network issues.
    • To resolve, check credentials, verify input parameters, and ensure network connectivity.

Links and References

Discussion