n8n-nodes-pragma-bitrix24 1.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+# Лицензия — Bitrix24 PRAGMA.by nodes for n8n
+
+**Copyright © 2026 PRAGMA & Азбука Решений. Все права защищены.**
+
+---
+
+## Условия Использования
+
+### Разрешается:
+- ✅ Использование данного программного обеспечения для личных и коммерческих целей
+- ✅ Установка в собственные экземпляры n8n
+- ✅ Создание автоматизаций с использованием данных нод
+
+### Запрещается без письменного разрешения правообладателей:
+- ❌ Распространение, перепродажа или сублицензирование данного программного обеспечения
+- ❌ Модификация исходного кода с целью создания производных продуктов
+- ❌ Удаление или изменение информации об авторских правах
+- ❌ Использование торговых марок PRAGMA или Азбука Решений без разрешения
+- ❌ Включение данного программного обеспечения в конкурирующие продукты
+
+---
+
+## Отказ от Гарантий
+
+ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ,
+ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ГАРАНТИЯМИ ТОВАРНОЙ ПРИГОДНОСТИ,
+СООТВЕТСТВИЯ ОПРЕДЕЛЁННОЙ ЦЕЛИ И НЕНАРУШЕНИЯ ПРАВ.
+
+НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ
+ЗА ЛЮБЫЕ ПРЕТЕНЗИИ, УБЫТКИ ИЛИ ИНУЮ ОТВЕТСТВЕННОСТЬ, БУДЬ ТО В РАМКАХ ДОГОВОРА,
+ДЕЛИКТА ИЛИ ИНЫМ ОБРАЗОМ, ВОЗНИКАЮЩУЮ ИЗ, В СВЯЗИ С ДАННЫМ ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ
+ИЛИ ЕГО ИСПОЛЬЗОВАНИЕМ.
+
+---
+
+## Правообладатели
+
+### 🇧🇾 PRAGMA (Беларусь)
+- **Сайт**: https://pragma.by/
+- **Телефон**: +375 (44) 702-70-90
+
+### 🇷🇺 Азбука Решений (Россия)
+- **Сайт**: https://abc-solution.ru/
+- **Телефон**: +7 (939) 555-19-60
+
+---
+
+## Заказ Доработки и Лицензирование
+
+Для получения расширенной лицензии, заказа доработки или консультации
+по автоматизации с n8n и Битрикс24 обращайтесь к правообладателям.

package/README.md

@@ -0,0 +1,340 @@
+# Bitrix24 PRAGMA.by nodes for n8n
+
+<p align="center">
+  <img src="https://pragma.by/logo.png" alt="PRAGMA Logo" width="200"/>
+</p>
+
+<p align="center">
+  <strong>Профессиональная интеграция n8n с Битрикс24 CRM</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/n8n-nodes-pragma-bitrix24">
+    <img src="https://img.shields.io/npm/v/n8n-nodes-pragma-bitrix24.svg" alt="npm version"/>
+  </a>
+  <a href="https://www.npmjs.com/package/n8n-nodes-pragma-bitrix24">
+    <img src="https://img.shields.io/npm/dm/n8n-nodes-pragma-bitrix24.svg" alt="npm downloads"/>
+  </a>
+</p>
+
+---
+
+## 🎯 О Проекте
+
+**Bitrix24 PRAGMA.by nodes for n8n** — это профессиональный набор из **30 специализированных нод** для глубокой интеграции платформы автоматизации [n8n](https://n8n.io/) с [Битрикс24 CRM](https://www.bitrix24.ru/).
+
+Разработано компаниями **PRAGMA** (Беларусь) и **Азбука Решений** (Россия) для enterprise-уровня автоматизации бизнес-процессов.
+
+### ✨ Ключевые Преимущества
+
+| Особенность                      | Описание                                     |
+| -------------------------------- | -------------------------------------------- |
+| 🚀 **30 Специализированных Нод** | Отдельная нода для каждого модуля Битрикс24  |
+| 🔄 **Адаптивный Rate Limiting**  | Автоматическое управление частотой запросов  |
+| 🛡️ **Circuit Breaker**           | Защита от каскадных сбоев API                |
+| 📦 **Batch API**                 | Эффективная обработка массовых операций      |
+| 🎯 **Строгая Типизация**         | Full TypeScript поддержка                    |
+| 🤖 **AI Tool Ready**             | Оптимизированные операции для LLM интеграции |
+| 🇷🇺 **Русский Интерфейс**         | Все описания и подсказки на русском языке    |
+
+---
+
+## 📦 Полный Список Нод
+
+### 🏢 CRM и Продажи
+
+| Нода                    | Возможности                                                                                                |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
+| **Bitrix24 CRM**        | Лиды, Сделки, Контакты, Компании, Предложения, Смарт-процессы, Реквизиты, Товарные строки, Воронки, Стадии |
+| **Bitrix24 Pipeline**   | Управление воронками продаж и направлениями                                                                |
+| **Bitrix24 User Field** | Настройка пользовательских полей CRM                                                                       |
+| **Bitrix24 Commerce**   | Товары, Заказы, Платежи, Доставка, Складские документы                                                     |
+| **Bitrix24 Sale**       | Расширенные операции интернет-магазина                                                                     |
+| **Bitrix24 Document**   | Генерация документов из шаблонов                                                                           |
+
+### 📋 Задачи и Планирование
+
+| Нода                  | Возможности                                                            |
+| --------------------- | ---------------------------------------------------------------------- |
+| **Bitrix24 Task**     | Создание, обновление, удаление задач, подзадачи, чеклисты, комментарии |
+| **Bitrix24 Calendar** | События, повторяющиеся встречи, вложения, участники                    |
+| **Bitrix24 Booking**  | Бронирование ресурсов, слоты времени, waitlist                         |
+| **Bitrix24 Timeman**  | Учёт рабочего времени, открытие/закрытие дня                           |
+
+### 💬 Коммуникации
+
+| Нода                         | Возможности                                            |
+| ---------------------------- | ------------------------------------------------------ |
+| **Bitrix24 ChatBot**         | Создание ботов, отправка сообщений, реакции, файлы     |
+| **Bitrix24 Open Channels**   | Открытые линии, история переписки                      |
+| **Bitrix24 Social**          | Живая лента, посты, комментарии, лайки, рабочие группы |
+| **Bitrix24 Message Service** | SMS, внешние мессенджеры                               |
+| **Bitrix24 Mail**            | Интеграция с почтой                                    |
+
+### 📞 Телефония
+
+| Нода                   | Возможности                                       |
+| ---------------------- | ------------------------------------------------- |
+| **Bitrix24 Telephony** | Регистрация звонков, история, записи, расшифровки |
+
+### 📁 Файлы и Хранение
+
+| Нода                | Возможности                         |
+| ------------------- | ----------------------------------- |
+| **Bitrix24 Disk**   | Файлы, папки, права доступа, версии |
+| **Bitrix24 App**    | Хранение настроек приложения        |
+| **Bitrix24 Entity** | Storage API для приложений          |
+| **Bitrix24 Lists**  | Универсальные списки (инфоблоки)    |
+
+### 👥 Пользователи и Структура
+
+| Нода                    | Возможности                               |
+| ----------------------- | ----------------------------------------- |
+| **Bitrix24 User**       | Управление пользователями, поиск, профили |
+| **Bitrix24 Department** | Оргструктура, дерево подразделений        |
+| **Bitrix24 Group**      | Социальные группы (Sonet)                 |
+
+### 🔧 Инструменты и AI
+
+| Нода              | Возможности                                                                 |
+| ----------------- | --------------------------------------------------------------------------- |
+| **Bitrix24 Tool** | AI-ready операции для LLM: поиск CRM, прогнозирование сделок, анализ данных |
+| **Bitrix24 AI**   | Интеграция с AI-копилотом Битрикс24                                         |
+| **Bitrix24 Log**  | Логирование и аудит операций                                                |
+
+### ⚡ Триггеры и События
+
+| Нода                 | Возможности                                      |
+| -------------------- | ------------------------------------------------ |
+| **Bitrix24 Trigger** | Webhook-события: новый лид, сделка, задача и др. |
+
+### 💳 Платежи и Подписи
+
+| Нода                    | Возможности                    |
+| ----------------------- | ------------------------------ |
+| **Bitrix24 Pay System** | Настройка платёжных систем     |
+| **Bitrix24 Sign**       | Электронные подписи документов |
+
+---
+
+## 🚀 Быстрый Старт
+
+### Шаг 1: Установка
+
+```bash
+# Через npm (рекомендуется)
+npm install n8n-nodes-pragma-bitrix24
+
+# Или в Docker
+# Добавьте в переменные окружения:
+N8N_NODE_MODULES_PATH=/home/node/.n8n/nodes
+```
+
+### Шаг 2: Создание Webhook в Битрикс24
+
+1. Войдите в ваш Битрикс24
+2. Перейдите: **Разработчикам** → **Другое** → **Входящий вебхук**
+3. Создайте вебхук с нужными правами:
+   - `crm` — для работы с CRM
+   - `task` — для задач
+   - `calendar` — для календаря
+   - `disk` — для файлов
+   - `user` — для пользователей
+4. Скопируйте URL вебхука (формат: `https://ваш-домен.bitrix24.ru/rest/1/xxxxx/`)
+
+### Шаг 3: Настройка в n8n
+
+1. В n8n откройте **Credentials**
+2. Добавьте новые: **Bitrix24 API (Webhook)**
+3. Вставьте URL вебхука
+4. Нажмите **Save**
+
+### Шаг 4: Первый Workflow
+
+```
+[HTTP Trigger] → [Bitrix24 CRM] → [Set] → [Respond]
+```
+
+1. Добавьте ноду **Bitrix24 CRM**
+2. Выберите ресурс: **Лиды**
+3. Выберите операцию: **Список**
+4. Выполните!
+
+---
+
+## 📖 Примеры Использования
+
+### Пример 1: Создание Лида из Формы
+
+```json
+{
+	"resource": "lead",
+	"operation": "create",
+	"title": "Заявка с сайта",
+	"name": "{{ $json.firstName }}",
+	"phone": "{{ $json.phone }}",
+	"email": "{{ $json.email }}",
+	"source": "WEB"
+}
+```
+
+### Пример 2: Поиск Сделок по Сумме
+
+```json
+{
+	"resource": "deal",
+	"operation": "list",
+	"filter": {
+		">OPPORTUNITY": 100000,
+		"STAGE_ID": "NEW"
+	},
+	"order": {
+		"OPPORTUNITY": "DESC"
+	}
+}
+```
+
+### Пример 3: Массовое Обновление Статусов
+
+```json
+{
+	"resource": "deal",
+	"operation": "update",
+	"id": "{{ $json.dealId }}",
+	"fields": {
+		"STAGE_ID": "WON",
+		"CLOSEDATE": "{{ $now.format('YYYY-MM-DD') }}"
+	}
+}
+```
+
+### Пример 4: Создание Задачи с Чеклистом
+
+```json
+{
+	"resource": "task",
+	"operation": "create",
+	"title": "Подготовить КП",
+	"description": "Клиент: {{ $json.companyName }}",
+	"responsibleId": "1",
+	"deadline": "{{ $now.plus(3, 'days').format('YYYY-MM-DD HH:mm:ss') }}"
+}
+```
+
+### Пример 5: AI-Поиск в CRM
+
+```json
+{
+	"operation": "searchCrm",
+	"query": "найди все сделки Иванова за последний месяц",
+	"outputFormat": "llm_optimized"
+}
+```
+
+---
+
+## ⚡ Rate Limiting и Производительность
+
+### Автоматическое Управление
+
+Ноды автоматически управляют частотой запросов:
+
+| Параметр                 | Значение                            |
+| ------------------------ | ----------------------------------- |
+| **Минимальная задержка** | 100мс (10 запросов/сек)             |
+| **При ошибке 429**       | Экспоненциальный backoff            |
+| **Circuit Breaker**      | Активируется после 5 ошибок подряд  |
+| **Retry-After**          | Автоматическое соблюдение заголовка |
+
+### Рекомендации
+
+- 🟢 **До 10 запросов/сек** — безопасно для платных тарифов
+- 🟡 **1-2 запроса/сек** — для бесплатных тарифов
+- 🔴 **Batch API** — используйте для массовых операций (50+ записей)
+
+---
+
+## 🔧 Технические Требования
+
+| Требование | Версия        |
+| ---------- | ------------- |
+| Node.js    | 18.x или 20.x |
+| n8n        | 1.0.0+        |
+| Битрикс24  | Любой тариф   |
+
+---
+
+## 📞 Контакты для Заказа Разработки
+
+Мы предоставляем услуги по автоматизации бизнес-процессов:
+
+### 🇧🇾 PRAGMA (Беларусь)
+
+- 🌐 **Сайт**: [pragma.by](https://pragma.by/)
+- 📱 **Телефон**: +375 (44) 702-70-90
+
+### 🇷🇺 Азбука Решений (Россия)
+
+- 🌐 **Сайт**: [abc-solution.ru](https://abc-solution.ru/)
+- 📱 **Телефон**: +7 (939) 555-19-60
+
+### Наши Услуги:
+
+- 🔧 Доработка и кастомизация нод
+- 🤖 Автоматизация бизнес-процессов
+- 📊 Интеграция с внешними системами
+- 🎓 Обучение и консалтинг по n8n
+
+---
+
+## 📄 Лицензия
+
+Проприетарная лицензия © PRAGMA & Азбука Решений
+
+**Разрешено**: использование для личных и коммерческих целей.
+
+**Запрещено**: распространение, модификация, перепродажа без письменного разрешения.
+
+См. [LICENSE](./LICENSE) для подробностей.
+
+---
+
+## 📚 Ссылки
+
+- [Документация REST API Битрикс24](https://apidocs.bitrix24.ru/api-reference/)
+- [Документация n8n](https://docs.n8n.io/)
+- [CHANGELOG](./CHANGELOG.md)
+
+---
+
+## 🤖 Для AI-Разработчиков
+
+Проект оптимизирован для доработки через AI-агенты (Claude, GPT-4, Gemini).
+
+### Быстрый Старт
+
+1. **Прочитайте** — [docs/AI_GUIDE.md](./docs/AI_GUIDE.md) — главный файл для AI
+2. **Изучите** — [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) — архитектура проекта
+3. **Следуйте** — [docs/CONTRIBUTING.md](./docs/CONTRIBUTING.md) — стандарты разработки
+4. **Используйте** — [docs/NODE_TEMPLATE.md](./docs/NODE_TEMPLATE.md) — шаблон новой ноды
+5. **Справочник** — [docs/API_REFERENCE.md](./docs/API_REFERENCE.md) — ссылки API
+
+### Ключевые Принципы
+
+| Принцип                       | Описание                                       |
+| ----------------------------- | ---------------------------------------------- |
+| 🇷🇺 **Русский язык**           | Все displayName и description на русском       |
+| 📝 **JSDoc заголовки**        | Единый стиль авторства PRAGMA & Азбука Решений |
+| 🔧 **bitrixRequestWithRetry** | Обязательный хелпер для API-запросов           |
+| 📦 **TypeScript**             | Строгая типизация из `nodes/shared/types.ts`   |
+| 🎯 **n8n 2.6+**               | Используем последние практики                  |
+
+---
+
+<p align="center">
+  <strong>Создано с ❤️ компаниями PRAGMA и Азбука Решений</strong>
+</p>
+
+<p align="center">
+  <a href="https://pragma.by/">pragma.by</a> • <a href="https://abc-solution.ru/">abc-solution.ru</a>
+</p>

package/dist/credentials/Bitrix24Api.credentials.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Bitrix24 API Credentials
+ *
+ * Bitrix24 PRAGMA.by nodes for n8n
+ * Профессиональная интеграция с Битрикс24 CRM
+ *
+ * @author PRAGMA & Азбука Решений
+ * @copyright 2026 PRAGMA (https://pragma.by/) & Азбука Решений (https://abc-solution.ru/)
+ * @version 1.0.0
+ *
+ * Контакты для заказа разработки:
+ * 🇧🇾 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.Bitrix24Api = void 0;
+class Bitrix24Api {
+    constructor() {
+        this.name = 'bitrix24Api';
+        this.displayName = 'Bitrix24 API (Webhook)';
+        // Ссылка на официальную документацию REST API Битрикс24
+        this.documentationUrl = 'https://training.bitrix24.com/rest_help/';
+        this.properties = [
+            {
+                displayName: 'URL Вебхука',
+                name: 'webhookUrl',
+                type: 'string',
+                default: '',
+                placeholder: 'https://ваш-домен.bitrix24.ru/rest/1/ваш-код-вебхука/',
+                required: true,
+                description: 'URL входящего вебхука из вашего Битрикс24. Создайте вебхук в разделе Разработчикам → Другое → Входящий вебхук.',
+                hint: 'Формат: https://домен.bitrix24.ru/rest/ID/КОД/',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            },
+        };
+        // Тест подключения — используем универсальный метод profile.json
+        // который работает без дополнительных прав доступа
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.webhookUrl}}',
+                url: 'profile.json',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.Bitrix24Api = Bitrix24Api;