n8n-nodes-pragma-bitrix24 1.0.0

package/dist/nodes/Bitrix24UserField/Bitrix24UserField.node.js

@@ -0,0 +1,386 @@
+"use strict";
+/**
+ * Bitrix24 UserField — Нода пользовательских полей
+ *
+ * Bitrix24 PRAGMA.by nodes for n8n
+ * Профессиональная интеграция с Битрикс24.
+ *
+ * @author PRAGMA & Азбука Решений
+ * @copyright 2026 PRAGMA (https://pragma.by/) & Азбука Решений (https://abc-solution.ru/)
+ *
+ * Контакты:
+ * 🇧🇾 PRAGMA: +375 (44) 702-70-90 | https://pragma.by/
+ * 🇷🇺 Азбука Решений: +7 (939) 555-19-60 | https://abc-solution.ru/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bitrix24UserField = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const Helpers_1 = require("../Bitrix24/Helpers");
+class Bitrix24UserField {
+    constructor() {
+        this.description = {
+            displayName: 'Bitrix24 Пользовательские поля',
+            name: 'bitrix24UserField',
+            icon: 'file:bitrix24.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Создание и управление пользовательскими (UF_*) полями CRM',
+            defaults: {
+                name: 'Bitrix24 UF',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'bitrix24Api',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Lead',
+                            value: 'lead',
+                        },
+                        {
+                            name: 'Deal',
+                            value: 'deal',
+                        },
+                        {
+                            name: 'Contact',
+                            value: 'contact',
+                        },
+                        {
+                            name: 'Company',
+                            value: 'company',
+                        },
+                    ],
+                    default: 'lead',
+                    required: true,
+                },
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Create',
+                            value: 'create',
+                            description: 'Create a user field',
+                            action: 'Create a user field',
+                        },
+                        {
+                            name: 'Update',
+                            value: 'update',
+                            description: 'Update a user field',
+                            action: 'Update a user field',
+                        },
+                        {
+                            name: 'Get',
+                            value: 'get',
+                            description: 'Get a user field',
+                            action: 'Get a user field',
+                        },
+                        {
+                            name: 'Get All',
+                            value: 'getAll',
+                            description: 'Get all user fields',
+                            action: 'Get all user fields',
+                        },
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            description: 'Delete a user field',
+                            action: 'Delete a user field',
+                        },
+                    ],
+                    default: 'create',
+                },
+                // Field ID
+                {
+                    displayName: 'Field ID',
+                    name: 'fieldId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['update', 'get', 'delete'],
+                        },
+                    },
+                    description: 'ID of the user field',
+                },
+                // Create/Update Fields
+                {
+                    displayName: 'Field Name',
+                    name: 'fieldName',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['create'],
+                        },
+                    },
+                    description: 'Name of the field (e.g. UF_CRM_CUSTOM_FIELD)',
+                },
+                {
+                    displayName: 'Field Label',
+                    name: 'fieldLabel',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Label of the field',
+                },
+                {
+                    displayName: 'Field Type',
+                    name: 'userTypeId',
+                    type: 'options',
+                    options: [
+                        { name: 'String', value: 'string' },
+                        { name: 'Integer', value: 'integer' },
+                        { name: 'Double', value: 'double' },
+                        { name: 'Boolean', value: 'boolean' },
+                        { name: 'Enumeration', value: 'enumeration' },
+                        { name: 'Date', value: 'date' },
+                        { name: 'DateTime', value: 'datetime' },
+                        { name: 'File', value: 'file' },
+                        { name: 'Money', value: 'money' },
+                        { name: 'URL', value: 'url' },
+                    ],
+                    default: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['create'],
+                        },
+                    },
+                    description: 'Type of the user field',
+                },
+                // List Values
+                {
+                    displayName: 'List Values',
+                    name: 'listValues',
+                    type: 'fixedCollection',
+                    typeOptions: {
+                        multipleValues: true,
+                        sortable: true,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                            userTypeId: ['enumeration'],
+                        },
+                    },
+                    description: 'Values for the enumeration list',
+                    default: {},
+                    options: [
+                        {
+                            name: 'values',
+                            displayName: 'Values',
+                            values: [
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                    description: 'Value of the list item',
+                                },
+                            ],
+                        },
+                    ],
+                },
+                // Options
+                {
+                    displayName: 'Multiple',
+                    name: 'multiple',
+                    type: 'boolean',
+                    default: false,
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Whether the field is multiple',
+                },
+                {
+                    displayName: 'Mandatory',
+                    name: 'mandatory',
+                    type: 'boolean',
+                    default: false,
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Whether the field is mandatory',
+                },
+                {
+                    displayName: 'Show Filter',
+                    name: 'showFilter',
+                    type: 'boolean',
+                    default: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Show in filter',
+                },
+                {
+                    displayName: 'Show In List',
+                    name: 'showInList',
+                    type: 'boolean',
+                    default: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Show in list',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        try {
+            for (let i = 0; i < items.length; i++) {
+                try {
+                    if (operation === 'create') {
+                        const fieldName = this.getNodeParameter('fieldName', i);
+                        const fieldLabel = this.getNodeParameter('fieldLabel', i);
+                        const userTypeId = this.getNodeParameter('userTypeId', i);
+                        const multiple = this.getNodeParameter('multiple', i);
+                        const mandatory = this.getNodeParameter('mandatory', i);
+                        const showFilter = this.getNodeParameter('showFilter', i);
+                        const showInList = this.getNodeParameter('showInList', i);
+                        const params = {
+                            fields: {
+                                FIELD_NAME: fieldName,
+                                EDIT_FORM_LABEL: fieldLabel,
+                                LIST_COLUMN_LABEL: fieldLabel,
+                                USER_TYPE_ID: userTypeId,
+                                MULTIPLE: multiple ? 'Y' : 'N',
+                                MANDATORY: mandatory ? 'Y' : 'N',
+                                SHOW_FILTER: showFilter ? 'Y' : 'N',
+                                SHOW_IN_LIST: showInList ? 'Y' : 'N',
+                            },
+                        };
+                        if (showFilter) {
+                            params.fields.FILTER_LABEL = fieldLabel;
+                        }
+                        if (showInList) {
+                            params.fields.LIST_FILTER_LABEL = fieldLabel;
+                        }
+                        if (userTypeId === 'enumeration') {
+                            const listValues = this.getNodeParameter('listValues', i);
+                            if (listValues.values && listValues.values.length > 0) {
+                                params.fields.LIST = listValues.values.map((item, index) => ({
+                                    SORT: (index + 1) * 100,
+                                    VALUE: item.value,
+                                }));
+                            }
+                        }
+                        const endpoint = `crm.${resource}.userfield.add`;
+                        const response = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', endpoint, params);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'update') {
+                        const fieldId = this.getNodeParameter('fieldId', i);
+                        const fieldLabel = this.getNodeParameter('fieldLabel', i);
+                        const multiple = this.getNodeParameter('multiple', i);
+                        const mandatory = this.getNodeParameter('mandatory', i);
+                        const showFilter = this.getNodeParameter('showFilter', i);
+                        const showInList = this.getNodeParameter('showInList', i);
+                        const params = {
+                            id: fieldId,
+                            fields: {
+                                EDIT_FORM_LABEL: fieldLabel,
+                                LIST_COLUMN_LABEL: fieldLabel,
+                                MULTIPLE: multiple ? 'Y' : 'N',
+                                MANDATORY: mandatory ? 'Y' : 'N',
+                                SHOW_FILTER: showFilter ? 'Y' : 'N',
+                                SHOW_IN_LIST: showInList ? 'Y' : 'N',
+                            },
+                        };
+                        if (showFilter)
+                            params.fields.FILTER_LABEL = fieldLabel;
+                        if (showInList)
+                            params.fields.LIST_FILTER_LABEL = fieldLabel;
+                        const endpoint = `crm.${resource}.userfield.update`;
+                        const response = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', endpoint, params);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'get') {
+                        const fieldId = this.getNodeParameter('fieldId', i);
+                        const endpoint = `crm.${resource}.userfield.get`;
+                        const response = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', endpoint, { id: fieldId });
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'getAll') {
+                        const endpoint = `crm.${resource}.userfield.list`;
+                        const response = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', endpoint);
+                        const result = response.result;
+                        if (Array.isArray(result)) {
+                            for (const item of result) {
+                                returnData.push({
+                                    json: item,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                    }
+                    if (operation === 'delete') {
+                        const fieldId = this.getNodeParameter('fieldId', i);
+                        const endpoint = `crm.${resource}.userfield.delete`;
+                        const response = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', endpoint, { id: fieldId });
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                }
+                catch (error) {
+                    if (this.continueOnFail()) {
+                        returnData.push({
+                            json: { error: error.message },
+                            pairedItem: { item: i },
+                        });
+                        continue;
+                    }
+                    throw error;
+                }
+            }
+            return [returnData];
+        }
+        catch (error) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), error);
+        }
+    }
+}
+exports.Bitrix24UserField = Bitrix24UserField;

package/dist/nodes/Bitrix24UserField/bitrix24.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="32px" height="32px" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg">
+    <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <path d="M16,0 C24.8365,0 32,7.1635 32,16 C32,24.8365 24.8365,32 16,32 C7.1635,32 0,24.8365 0,16 C0,7.1635 7.1635,0 16,0" fill="#2FC7F7"/>
+        <path d="M13.3333,8 L18.6667,8 C21.6122,8 24,10.3878 24,13.3333 L24,18.6667 C24,21.6122 21.6122,24 18.6667,24 L13.3333,24 C10.3878,24 8,21.6122 8,18.6667 L8,13.3333 C8,10.3878 10.3878,8 13.3333,8" fill="#FFFFFF"/>
+    </g>
+</svg> 

package/dist/nodes/shared/bitrix24.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="32px" height="32px" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg">
+    <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <path d="M16,0 C24.8365,0 32,7.1635 32,16 C32,24.8365 24.8365,32 16,32 C7.1635,32 0,24.8365 0,16 C0,7.1635 7.1635,0 16,0" fill="#2FC7F7"/>
+        <path d="M13.3333,8 L18.6667,8 C21.6122,8 24,10.3878 24,13.3333 L24,18.6667 C24,21.6122 21.6122,24 18.6667,24 L13.3333,24 C10.3878,24 8,21.6122 8,18.6667 L8,13.3333 C8,10.3878 10.3878,8 13.3333,8" fill="#FFFFFF"/>
+    </g>
+</svg> 

package/dist/nodes/shared/localization.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Стандарт Локализации n8n 2.6+
+ * Bitrix24 PRAGMA.by nodes for n8n
+ *
+ * Этот файл определяет стандарты для:
+ * - displayName на русском языке
+ * - description с детальными объяснениями
+ * - hint с контекстными подсказками
+ * - placeholder с примерами
+ *
+ * Все тексты следуют лучшим практикам n8n 2.6 (2026)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIST_OPTIONS_RU = exports.JSON_FIELDS_RU = exports.FIELDS_RU = exports.RESOURCES_RU = exports.OPERATIONS_RU = void 0;
+// ============================================
+// СТАНДАРТНЫЕ ОПЕРАЦИИ CRM (на русском)
+// ============================================
+exports.OPERATIONS_RU = {
+    create: {
+        name: 'Создать',
+        action: 'Создать запись',
+        description: 'Создать новую запись в Битрикс24',
+    },
+    get: {
+        name: 'Получить',
+        action: 'Получить запись',
+        description: 'Получить запись по ID. Можно указать несколько ID через запятую.',
+    },
+    list: {
+        name: 'Список',
+        action: 'Получить список',
+        description: 'Получить список записей с фильтрацией и сортировкой',
+    },
+    update: {
+        name: 'Обновить',
+        action: 'Обновить запись',
+        description: 'Обновить существующую запись по ID',
+    },
+    delete: {
+        name: 'Удалить',
+        action: 'Удалить запись',
+        description: 'Удалить запись по ID. Действие необратимо!',
+    },
+};
+// ============================================
+// СТАНДАРТНЫЕ РЕСУРСЫ CRM (на русском)
+// ============================================
+exports.RESOURCES_RU = {
+    lead: {
+        name: 'Лид',
+        description: 'Потенциальный клиент, первичное обращение. Лиды можно конвертировать в сделки, контакты и компании.',
+        hint: 'API: crm.lead.*',
+    },
+    deal: {
+        name: 'Сделка',
+        description: 'Коммерческая сделка с клиентом. Содержит сумму, стадию, связанные контакты и компанию.',
+        hint: 'API: crm.deal.*',
+    },
+    contact: {
+        name: 'Контакт',
+        description: 'Физическое лицо — клиент, партнёр или сотрудник клиента. Содержит телефоны, email, соцсети.',
+        hint: 'API: crm.contact.*',
+    },
+    company: {
+        name: 'Компания',
+        description: 'Юридическое лицо — организация-клиент. Содержит реквизиты, контакты, связанные сделки.',
+        hint: 'API: crm.company.*',
+    },
+    smart_process: {
+        name: 'Смарт-процесс (SPA)',
+        description: 'Динамические сущности для кастомных бизнес-процессов. Позволяют создавать свои типы записей.',
+        hint: 'Предварительно создайте тип SPA в Битрикс24',
+    },
+    quote: {
+        name: 'Предложение',
+        description: 'Коммерческое предложение клиенту с товарами/услугами и ценами.',
+        hint: 'API: crm.quote.*',
+    },
+};
+// ============================================
+// СТАНДАРТНЫЕ ПОЛЯ (на русском с placeholder и hint)
+// ============================================
+exports.FIELDS_RU = {
+    id: {
+        displayName: 'ID',
+        description: 'Уникальный идентификатор записи в Битрикс24',
+        placeholder: '123',
+        hint: 'Для получения нескольких записей укажите ID через запятую: 1,2,3',
+    },
+    title: {
+        displayName: 'Название',
+        description: 'Название записи — отображается в списках и карточке',
+        placeholder: 'Новая сделка с ООО "Компания"',
+        hint: 'Используйте понятные названия для быстрого поиска',
+    },
+    assignedById: {
+        displayName: 'Ответственный',
+        description: 'Пользователь, ответственный за запись. Получает уведомления и задачи по ней.',
+        placeholder: '1',
+        hint: 'ID пользователя или выберите из списка',
+    },
+    phone: {
+        displayName: 'Телефон',
+        description: 'Номер телефона контакта. Поддерживает множественные значения с типами (рабочий, мобильный и т.д.)',
+        placeholder: '+7 (999) 123-45-67',
+        hint: 'Формат: +7 (XXX) XXX-XX-XX или международный',
+    },
+    email: {
+        displayName: 'Email',
+        description: 'Электронная почта. Поддерживает множественные значения с типами (рабочий, личный).',
+        placeholder: 'client@company.ru',
+        hint: 'Используется для рассылок и уведомлений',
+    },
+    opportunity: {
+        displayName: 'Сумма',
+        description: 'Сумма сделки или предложения в валюте по умолчанию',
+        placeholder: '100000',
+        hint: 'Только число без пробелов и символов валюты',
+    },
+    stageId: {
+        displayName: 'Стадия',
+        description: 'Текущая стадия сделки или лида в воронке продаж',
+        placeholder: 'NEW',
+        hint: 'Коды стадий: NEW, PREPARATION, NEGOTIATION, WON, LOST',
+    },
+    sourceId: {
+        displayName: 'Источник',
+        description: 'Откуда пришёл клиент: сайт, звонок, реклама и т.д.',
+        placeholder: 'WEB',
+        hint: 'Стандартные: CALL, WEB, ADVERTISING, PARTNER, RECOMMENDATION',
+    },
+    comments: {
+        displayName: 'Комментарий',
+        description: 'Произвольный текстовый комментарий к записи',
+        placeholder: 'Клиент заинтересован в услуге X, перезвонить завтра',
+        hint: 'Поддерживает HTML-форматирование',
+    },
+};
+// ============================================
+// СТАНДАРТНЫЕ JSON-ПОЛЯ (на русском)
+// ============================================
+exports.JSON_FIELDS_RU = {
+    filter: {
+        displayName: 'Фильтр (JSON)',
+        description: 'JSON-объект фильтрации записей. Поддерживает операторы сравнения (>, <, >=, <=, !) и логику.',
+        placeholder: '{"STAGE_ID": "NEW", ">OPPORTUNITY": 50000}',
+        hint: 'Операторы: > (больше), < (меньше), ! (не равно), % (содержит)',
+    },
+    select: {
+        displayName: 'Поля для выборки (JSON)',
+        description: 'Массив полей, которые нужно вернуть. По умолчанию возвращаются все поля.',
+        placeholder: '["ID", "TITLE", "STAGE_ID", "OPPORTUNITY"]',
+        hint: 'Для ускорения запросов указывайте только нужные поля',
+    },
+    order: {
+        displayName: 'Сортировка (JSON)',
+        description: 'JSON-объект сортировки результатов',
+        placeholder: '{"OPPORTUNITY": "DESC", "DATE_CREATE": "ASC"}',
+        hint: 'ASC — по возрастанию, DESC — по убыванию',
+    },
+    fields: {
+        displayName: 'Поля (JSON)',
+        description: 'JSON-объект с полями для создания/обновления записи',
+        placeholder: '{"TITLE": "Новая сделка", "OPPORTUNITY": 100000, "STAGE_ID": "NEW"}',
+        hint: 'Полный список полей в документации API Битрикс24',
+    },
+};
+// ============================================
+// СТАНДАРТНЫЕ ПАРАМЕТРЫ СПИСКА
+// ============================================
+exports.LIST_OPTIONS_RU = {
+    returnAll: {
+        displayName: 'Получить все',
+        description: 'Получить все записи без ограничения количества. Внимание: может занять много времени для больших объёмов данных.',
+        hint: 'Для больших списков используйте фильтры или ограничение',
+    },
+    limit: {
+        displayName: 'Лимит',
+        description: 'Максимальное количество записей для получения',
+        placeholder: '50',
+        hint: 'Максимум 50 записей за один запрос API',
+    },
+    useFilter: {
+        displayName: 'Использовать фильтр',
+        description: 'Включить расширенную фильтрацию записей',
+        hint: 'Позволяет настроить условия выборки',
+    },
+};

package/dist/nodes/shared/types.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Centralized TypeScript types for Bitrix24 n8n nodes
+ * Standard 2026: Strong typing for all API interactions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBitrixApiError = isBitrixApiError;
+exports.isBitrixApiResponse = isBitrixApiResponse;
+// ============================================
+// Type Guards
+// ============================================
+function isBitrixApiError(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        'error' in response &&
+        typeof response.error === 'string');
+}
+function isBitrixApiResponse(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        'result' in response);
+}

package/index.js

@@ -0,0 +1,10 @@
+'use strict';
+
+module.exports = {
+    nodeTypes: [
+        require('./dist/nodes/Bitrix24/Bitrix24.node.js'),
+    ],
+    credentialTypes: [
+        require('./dist/credentials/Bitrix24Api.credentials.js'),
+    ],
+};