Коротко: Большая часть проблем в интеграционных проектах возникает не в коде, а до него: в справочниках, ролях, статусах и договорённостях о том, где живёт источник истины. Разбираем, что нужно подготовить компании до старта интеграции.

• Время чтения: 11 минут
• Формат: практический разбор без лишней теории

Когда компания говорит «нам нужно интегрировать 1С и CRM», большинство сразу думает про API, разработку и сроки. Но самые болезненные проблемы таких проектов обычно рождаются до написания первого запроса.

Интеграция ломается не потому, что разработчик не умеет вызвать endpoint. Она ломается потому, что бизнес не договорился, какие данные являются эталонными, как называются статусы, кто владеет справочниками и что считать успешным обменом.

Поэтому хорошая интеграция начинается не с кода, а с подготовки.

Сначала нужно ответить: зачем вообще интегрируем

Это звучит очевидно, но на практике цель часто формулируют слишком абстрактно: «чтобы всё было связано». Такой цели недостаточно.

Нужно понять конкретные бизнес-сценарии:

• заказы из CRM должны попадать в 1С;
• менеджер должен видеть актуальный статус отгрузки;
• остатки и цены должны возвращаться в CRM;
• финансовый блок должен получать корректные документы;
• руководитель должен видеть единый отчёт без ручной склейки.

Пока таких сценариев нет, интеграция рискует превратиться в дорогой обмен «чем-то с чем-то».

Шаг 1. Определите источник истины

Это первый вопрос, который экономит месяцы споров. Для каждой сущности нужно честно ответить: где живёт правильная версия данных.

Например:

• клиент — в CRM или 1С;
• договор — в 1С;
• лид и коммуникации — в CRM;
• номенклатура и остатки — чаще в 1С;
• статусы документооборота — в 1С;
• задачи по клиенту — в CRM.

Если этого разделения нет, обе системы начинают «переигрывать» друг друга, а сотрудники перестают понимать, где нужно смотреть правду.

Шаг 2. Разберите справочники до старта

Интеграции очень плохо переносят хаотичные справочники. Если в CRM один и тот же клиент может называться по-разному, а в 1С номенклатура живёт в другой логике, обмен будет наполнять систему дубликатами и конфликтами.

Что стоит проверить заранее:

• контрагенты и филиалы;
• номенклатура и единицы измерения;
• менеджеры, подразделения и роли;
• типы документов и статусы;
• валюты, ставки, типы оплат.

Это скучная, но критически важная часть работы. Без неё интеграция становится фабрикой расхождений.

Шаг 3. Согласуйте статусы и жизненный цикл данных

Один из самых частых конфликтов в проектах — одинаковые слова означают разное в разных системах. Например, «сделка закрыта» для продаж и «заказ проведён» для учёта — не одно и то же.

Поэтому нужно заранее зафиксировать:

• какие события в CRM порождают запись в 1С;
• какие статусы из 1С возвращаются обратно;
• когда допускается ручная корректировка;
• какие поля можно менять после обмена, а какие нет.

Без такого соглашения пользователи начинают жить в логике «мы думали, что это значит другое».

Шаг 4. Определите идентификаторы и ключи сопоставления

Это техническая тема, но у неё прямое бизнес-значение. Если системы не умеют надёжно понимать, что речь идёт об одном и том же объекте, дальше начнётся хаос с дублями и неверными связями.

Хорошая практика — заранее определить:

• по какому ключу сопоставляется клиент;
• как связаны карточка сделки и заказ;
• где хранится внешний ID;
• что происходит при конфликте.

Это особенно важно, если у компании уже есть старые данные и история ручной работы.

Шаг 5. Назначьте владельцев данных и правил

Интеграцию нельзя отдать только разработчику или подрядчику. На стороне бизнеса нужны люди, которые отвечают:

• за коммерческий процесс;
• за учётный контур;
• за правила обмена;
• за разбор ошибок;
• за приоритеты изменений.

Если владельцев нет, любой спор по данным зависает между отделами. В этот момент технический проект становится организационной проблемой.

Шаг 6. Сразу договоритесь об ошибках и мониторинге

Ни одна интеграция не живёт без ошибок. Вопрос не в том, будут ли они, а в том, как компания узнает о них и кто будет реагировать.

До запуска полезно определить:

• какие ошибки критичны;
• кто получает уведомления;
• как выглядит повторная отправка;
• кто разбирает спорные случаи;
• где хранится журнал обменов.

Бизнесу не нужен «идеальный обмен». Ему нужен предсказуемый обмен, который можно контролировать.

Шаг 7. Запускайте поэтапно, а не сразу всё

Попытка интегрировать весь контур за один раз обычно приводит к длинному и нервному проекту. Рабочий подход — идти по очереди:

1. Один основной сценарий.
2. Проверка на реальных пользователях.
3. Отладка ошибок и пограничных случаев.
4. Только потом расширение периметра.

Это особенно важно, если компания впервые проходит через серьёзный интеграционный проект.

Что бизнес часто недооценивает

Интеграция — это не «фоновая техническая работа». Она меняет поведение людей. Когда данные начинают синхронизироваться автоматически, приходится по-новому относиться к дисциплине ввода, владению полями и ответственности за корректность записей.

Поэтому такие проекты всегда находятся на стыке технологий и операционного управления.

Вывод

Подготовка к интеграции 1С, CRM и внутренних сервисов — это не бюрократия ради бюрократии. Это способ сделать так, чтобы интеграционный проект не развалился на противоречиях в данных и ожиданиях.

Если компания заранее определила источник истины, привела в порядок справочники, согласовала статусы и назначила владельцев, сама разработка проходит спокойнее и быстрее. А результат получается не «формально связанным», а действительно полезным для бизнеса.

The post Как подготовить компанию к интеграции 1С, CRM и внутренних сервисов first appeared on Portfolio.

В этой статье описан процесс создания HTTP-сервиса в 1С для получения списка номенклатуры в формате JSON. Мы рассмотрим разработку шаблона, обработчика, общего модуля и вспомогательных функций для корректной обработки запросов и формирования ответа.

Создание шаблона

1. Перейдите в конфигураторе в раздел HTTP-сервисы.
2. Добавьте новый маршрут, например /api/items, для обработки GET-запросов.
3. Укажите функцию-обработчик, например ШаблонURL1ПолучитьДанныеПоНоменклатуре.

Создание обработчика запросов

Обработчик запроса обрабатывает GET-запрос и возвращает список номенклатуры в формате JSON. Пример функции:

Функция ШаблонURL1ПолучитьДанныеПоНоменклатуре(Запрос)
    Ответ = Новый HTTPСервисОтвет(200);

    // Установка заголовка через коллекцию Заголовки
    Ответ.Заголовки.Вставить("Content-Type", "application/json");

    // Получаем данные
    СтрокаJSON = АИР.ПолучитьСписокНоменклатуры();

    // Устанавливаем тело ответа
    Ответ.УстановитьТелоИзСтроки(СтрокаJSON);

    Возврат Ответ;
КонецФункции

Комментарии к коду

• Важный момент: заголовок Content-Type указывает клиенту, что ответ возвращается в формате JSON.
• Используется общая функция для получения списка номенклатуры (подробнее в следующем разделе).

Общий модуль для обработки запросов

Для обработки данных создается функция в общем модуле, например, АИР:

Функция ПолучитьСписокНоменклатуры() Экспорт
    Попытка
        Запрос = Новый Запрос;
        Запрос.Текст = "ВЫБРАТЬ Код КАК cod, Наименование КАК name, Артикул КАК articul ИЗ Справочник.Номенклатура";
        Выборка = Запрос.Выполнить().Выбрать();

        Массив = Новый Массив;
        Пока Выборка.Следующий() Цикл
            Массив.Добавить(Новый Структура("cod, name, articul", Строка(Выборка.cod), Строка(Выборка.name), Строка(Выборка.articul)));
        КонецЦикла;

        Если Массив.Количество() > 0 Тогда
            Возврат АИР.СтруктураВСтрокуJSON(Массив);
        Иначе
            Возврат "Ошибка";
        КонецЕсли;
    Исключение
        Сообщить("Ошибка выполнения запроса: " + ОписаниеОшибки());
        Возврат ОписаниеОшибки();
    КонецПопытки;
КонецФункции

Важные моменты

• В строке Массив.Добавить(...) типы данных для полей (например, Строка) указываются явно, чтобы избежать ошибок сериализации в JSON.
• Обработка исключений позволяет отлавливать ошибки и возвращать диагностические сообщения.

Функция для преобразования массива в JSON

Функция преобразует массив структур в JSON-строку:

Функция СтруктураВСтрокуJSON(Результат) Экспорт
    Если Результат = Неопределено ИЛИ Результат.Количество() = 0 Тогда
        Возврат "[]";
    КонецЕсли;

    Попытка
        ЗаписьJSON = Новый ЗаписьJSON;
        ЗаписьJSON.УстановитьСтроку();
        ЗаписатьJSON(ЗаписьJSON, Результат, НастройкиJSON());
        Возврат ЗаписьJSON.Закрыть();
    Исключение
        Сообщить("Ошибка преобразования в JSON: " + ОписаниеОшибки());
        Возврат ОписаниеОшибки();
    КонецПопытки;
КонецФункции

Функция настроек сериализации

Для управления сериализацией данных используется вспомогательная функция:

Функция НастройкиJSON()
    Результат = Новый НастройкиСериализацииJSON;
    Результат.ФорматСериализацииДаты = ФорматДатыJSON.ISO;
    Возврат Результат;
КонецФункции

Пример результата

В результате обработки запроса сервис возвращает следующий JSON-ответ:

[
    {
        "cod": "00-00000353",
        "name": "Жесткая упаковка груза",
        "articul": ""
    },
    {
        "cod": "00-00000331",
        "name": "Услуги по заявке товарного знака",
        "articul": ""
    },
    {
        "cod": "00-00000290",
        "name": "Реклама",
        "articul": ""
    }
]

Этот JSON-ответ можно использовать в веб-приложениях, мобильных приложениях и других системах, работающих с REST API.

The post Get запрос (получение номенклатуры) first appeared on Portfolio.

Шаг 1: Создание шаблона URL и обработчика

Обработчик для POST-запроса

Функция Changesumm(Запрос)    // Обработчик POST-запроса для изменения суммы документа
    // Получаем тело запроса в формате JSON
    Попытка
        СтрокаJSON = Запрос.ПолучитьТелоКакСтроку();
    Исключение
        // Возвращаем ошибку при проблемах с получением тела запроса
        Возврат Новый HTTPСервисОтвет(400, "Ошибка при получении тела запроса");
    КонецПопытки;

    // Разбираем JSON в структуру данных
    Попытка
        ЧтениеJSON = Новый ЧтениеJSON;
        ЧтениеJSON.УстановитьСтроку(СтрокаJSON);
        СтруктураВходныхПараметров = ПрочитатьJSON(ЧтениеJSON);
        ЧтениеJSON.Закрыть();
    Исключение
        // Возвращаем ошибку при некорректном формате JSON
        Возврат Новый HTTPСервисОтвет(400, "Ошибка разбора JSON");
    КонецПопытки;

    // Передаем данные в модуль для обработки и получаем результат
    ОбъектОтвета = АИР.ОбновитьСуммуПоДокументу(СтруктураВходныхПараметров);

    // Формируем HTTP-ответ
    Ответ = Новый HTTPСервисОтвет(200);
    Ответ.УстановитьТелоИзСтроки(ОбъектОтвета);

    Возврат Ответ;
КонецФункции

Важные моменты:

• Получение тела запроса: Используется метод Запрос.ПолучитьТелоКакСтроку() для извлечения данных из POST-запроса.
• Обработка ошибок: Добавлены обработчики исключений для предотвращения падения сервиса при некорректных данных.
• Проверка JSON: После разбора JSON данные передаются в модуль для дальнейшей обработки.

Пример тела запроса:

{
    "cod": "00ЦБ-005884",
    "summa": 32100
}

Шаг 2: Создание функции в общем модуле

Функция ОбновитьСуммуПоДокументу(СтруктураПараметров) Экспорт
    Попытка
        // Проверка входных параметров
        Если НЕ СтруктураПараметров.Свойство("cod") ИЛИ НЕ СтруктураПараметров.Свойство("summa") Тогда
            Возврат Новый HTTPСервисОтвет(400, "Invalid parameters: 'cod' and 'summa' are required");
        КонецЕсли;

        КодДокумента = СтруктураПараметров.cod;
        НоваяСумма = СтруктураПараметров.summa;

        // Поиск документа по номеру
        Запрос = Новый Запрос;
        Запрос.Текст = 
            "ВЫБРАТЬ  
            |    Ссылка  
            |ИЗ  
            |    Документ.ОперацияПоПлатежнойКарте КАК Документ  
            |ГДЕ  
            |    Документ.Номер = &Номер";  // Параметр для Номер без кавычек

        Запрос.УстановитьПараметр("Номер", КодДокумента); // Устанавливаем параметр, значение КодДокумента будет в кавычках

        // Отладочное сообщение: выводим запрос
        Сообщить("Запрос: " + Запрос.Текст); // Выводим текст запроса для отладки

        РЗ = Запрос.Выполнить().Выбрать();
        
        // Если документ не найден
        Если РЗ.Следующий() тогда
			ДокументСсылка=РЗ.ССылка;	//Сообщить(РЗ.номер);
				
				иначе 
				Возврат "Нет такого документа";
		Конецесли;     
		
		
        // Получаем первую строку из результата запроса
        ДокументОбъект=ДокументСсылка.ПолучитьОбъект();;

        // Проверка на наличие ссылки на объект
  
        Если ДокументОбъект = Неопределено Тогда
            Возврат Новый HTTPСервисОтвет(500, "Ошибка получения объекта документа");
        КонецЕсли;

        // Изменяем сумму
        ДокументОбъект.СуммаДокумента = НоваяСумма;
		// Обновляем сумму в табличной части, например, в табличной части "Расшифровка платежа"
		Если ДокументОбъект.РасшифровкаПлатежа <> Неопределено Тогда
    Для Каждого СтрокаТЧ Из ДокументОбъект.РасшифровкаПлатежа Цикл
        // Логика изменения суммы в табличной части
        // Например, распределение суммы пропорционально количеству
        СтрокаТЧ.Сумма = НоваяСумма;
    КонецЦикла;
КонецЕсли;
		
        // Проводим документ
        Попытка
            ДокументОбъект.Записать(РежимЗаписиДокумента.Проведение);
			//	
		Исключение
            Возврат Новый HTTPСервисОтвет(500, "Ошибка проведения документа: " + ОписаниеОшибки());
        КонецПопытки;

        // Возвращаем успех
        Возврат Новый HTTPСервисОтвет(200, "Document updated and posted successfully");
    Исключение
        // Логируем и возвращаем ошибку
        Сообщить("Ошибка обновления документа: " + ОписаниеОшибки());
        Возврат Новый HTTPСервисОтвет(500, "Internal server error: " + ОписаниеОшибки());
    КонецПопытки;
КонецФункции

Ключевые моменты:

1. Проверка входных данных: обязательная проверка наличия полей cod и summa в структуре параметров.
2. Поиск документа: запрос для получения ссылки на документ должен использовать параметр с учетом кавычек.
3. Обновление документа: проверяется наличие объекта документа и изменяется его сумма.
4. Изменение табличной части: добавлена возможность обновлять суммы в строках табличной части документа.
5. Обработка ошибок: исключения отлавливаются и возвращается сообщение для отладки.
6. Обязательно пользуемся отладчиком  с включенным автообнаружением HTTP-запросов.

Результат работы

Пример успешного JSON-ответа:

{
    "status": "success",
    "message": "Изменения успешно сохранены"
}

Пример ошибки:

{
    "status": "error",
    "message": "Нет такого документа"
}

Важные моменты для публикации и тестирования

1. Публикация сервиса:
   • Убедитесь, что серверный сервис опубликован на веб-сервере и доступен по URL.
   • Настройте разрешения для вызова обработчиков.
2. Тестирование:
   • Используйте инструменты, такие как Postman или curl, для отправки POST-запросов.
   • Проверяйте корректность передаваемого JSON.
3. Логирование:
   • Добавьте логирование на этапе обработки запроса и выполнения изменений для упрощения диагностики.
4. Пример тела запроса:
   Убедитесь, что JSON-запрос формируется в правильном формате:

   {
       "cod": "00ЦБ-005884",
       "summa": 32100
   }
   

The post Post запрос (изменение документа) first appeared on Portfolio.

В данной статье описан процесс создания HTTP-сервиса в 1С, включая настройку сервиса, создание шаблона и обработчика запросов, а также публикацию базы данных на сервере.

1. Создание сервиса

1. Откройте конфигуратор вашей информационной базы.
2. В дереве конфигурации найдите раздел «Общие» и создайте новый объект типа «HTTP-сервис».
3. Укажите имя вашего сервиса, например, MyService. Это имя будет частью URL, по которому будет доступен сервис.

Пример структуры URL: http://<имя_сервера>/<путь_к_базе>/hs/MyService

4. Сохраните изменения в конфигурации.

2. Создание шаблона для обработки запросов

Шаблон определяет маршруты (endpoints) и методы (GET, POST, PUT, DELETE), которые обрабатываются сервисом.

1. В объекте «HTTP-сервис» перейдите на вкладку «Шаблоны».
2. Добавьте новый маршрут, указав путь и методы запросов. Например, добавьте маршрут /api/data для обработки GET и POST запросов.
3. Укажите имя процедуры или функции, которая будет обрабатывать запросы для каждого метода.

Пример настройки:

• Путь: /api/data
• Методы: GET, POST
• Обработчик GET: ПолучитьДанные
• Обработчик POST: ДобавитьДанные

3. Создание обработчика запросов

Для обработки запросов создайте процедуры в модуле HTTP-сервиса. Эти процедуры будут выполняться при получении запросов на указанные маршруты.

Пример обработчика для метода GET:

Функция ШаблонURL1ПолучитьДанныеПоНоменклатуре(Запрос)
    Ответ = Новый HTTPСервисОтвет(200);

    // Установка заголовка через коллекцию Заголовки
    Ответ.Заголовки.Вставить("Content-Type", "application/json");

    // Получаем данные
    СтрокаJSON = АИР.ПолучитьСписокНоменклатуры();

    // Устанавливаем тело ответа
    Ответ.УстановитьТелоИзСтроки(СтрокаJSON);

    Возврат Ответ;
КонецФункции

Пример обработчика для метода POST:

Функция Changesumm(Запрос) // Получаем тело запроса
Попытка
СтрокаJSON = Запрос.ПолучитьТелоКакСтроку();
Исключение
Возврат Новый HTTPСервисОтвет(400, "Ошибка при получении тела запроса");
КонецПопытки;

// Разбираем JSON
Попытка
ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(СтрокаJSON);
СтруктураВходныхПараметров = ПрочитатьJSON(ЧтениеJSON);
ЧтениеJSON.Закрыть();
Исключение
Возврат Новый HTTPСервисОтвет(400, "Ошибка разбора JSON");
КонецПопытки;

// Передаем данные в модуль и получаем ответ
ОбъектОтвета = АИР.ОбновитьСуммуПоДокументу(СтруктураВходныхПараметров);

// Формируем HTTP-ответ
Ответ = Новый HTTPСервисОтвет(200);
Ответ.УстановитьТелоИзСтроки(ОбъектОтвета);

Возврат Ответ;
КонецФункции

4. Создание модуля для обработки запросов

Для удобства и повторного использования создайте общий модуль, который будет содержать логику обработки запросов. Этот модуль можно вызывать из обработчиков HTTP-сервиса.

Пример общего модуля:

Название модуля: ПолучитьСписокНоменклатуры

Код модуля:

Функция ПолучитьСписокНоменклатуры() Экспорт
    Попытка
        Запрос = Новый Запрос;
        Запрос.Текст = "ВЫБРАТЬ Код КАК cod, Наименование КАК name, Артикул КАК articul ИЗ Справочник.Номенклатура";
        Выборка = Запрос.Выполнить().Выбрать();


        Массив = Новый Массив;
        Пока Выборка.Следующий() Цикл
            Массив.Добавить(Новый Структура("cod, name, articul", Строка(Выборка.cod), Строка(Выборка.name), Строка(Выборка.articul)));
КонецЦикла;


        Если Массив.Количество() > 0 Тогда
    Возврат АИР.СтруктураВСтрокуJSON(Массив);
Иначе
    Возврат "1";
КонецЕсли;
    Исключение
        Сообщить("Ошибка выполнения запроса: " + ОписаниеОшибки());
        Возврат ОписаниеОшибки();
    КонецПопытки;
КонецФункции

5. Публикация базы на сервере

Для того чтобы HTTP-сервис стал доступен через веб, необходимо опубликовать базу данных:

1. В конфигураторе откройте меню «Администрирование» -> «Публикация на веб-сервере».
2. Укажите путь для публикации (например, /MyBase).
3. Включите поддержку HTTP-сервисов в параметрах публикации.
4. Нажмите «ОК» для применения настроек.

После публикации сервис будет доступен по адресу:

http://<имя_сервера>/<путь_к_базе>/hs/MyService

Теперь ваш HTTP-сервис готов к использованию! Вы можете отправлять запросы с помощью браузера, Postman или других HTTP-клиентов.

The post Создание сервиса first appeared on Portfolio.