Содержание:
1. Система ФГИС "Сатурн" и для чего она предназначена
3. Общая архитектура системы интеграции с 1С: ERP
4. Инструкция по реализации интеграции
Контроль за использованием пестицидов и агрохимикатов является одной из приоритетных задач в сфере аграрного регулирования. С 1 января 2023 года в России введена обязательная электронная прослеживаемость оборота данных веществ. Для реализации этого контроля была разработана ФГИС "Сатурн" — федеральная государственная информационная система прослеживаемости пестицидов и агрохимикатов, разработанная Россельхознадзором.
Компании, осуществляющие оборот таких товаров (производители, импортёры, оптовики, сельхозпроизводители), обязаны передавать в систему "Сатурн" сведения о производстве, ввозе, транспортировке, хранении и применении агрохимикатов. Это требует не только ручного ввода данных, но и автоматизированной интеграции с корпоративными системами, особенно с такими, как 1С: ERP.
В данной статье мы рассмотрим:
· что такое ФГИС "Сатурн" и каковы требования к передаче данных;
· какие этапы включает интеграция с базой 1С: ERP;
· как настроить взаимодействие на практике;
· какие данные передаются.
1. Система ФГИС "Сатурн" и для чего она предназначена
ФГИС "Сатурн" — информационная система, предназначенная для прослеживания движения пестицидов и агрохимикатов на всей цепочке поставки: от завода до поля. Она обеспечивает:
· фиксацию каждой единицы продукции с момента ввоза/производства;
· прозрачность транспортных и складских операций;
· учёт фактического применения (нормы, культура, участок, агроном);
· возможность государственной аналитики и надзора.
Передача данных в "Сатурн" осуществляется либо через личный кабинет, либо через интерфейс прикладного программирования (API), что делает возможной интеграцию с системами класса ERP.
2. Требования к интеграции
Организации, работающие с пестицидами и агрохимикатами, обязаны:
· Зарегистрироваться в ФГИС "Сатурн" (через ЕСИА и РПГУ);
· Получить API-ключи и доступ к спецификациям;
· Обеспечить передачу информации по каждому факту оборота агрохимикатов.
ФГИС "Сатурн" принимает данные в формате JSON, передача идёт через REST API. В документации описаны эндпоинты и структуры, которые необходимо использовать для:
· регистрации партии товара;
· фиксации операции (поступление, хранение, перемещение, использование);
· уведомлений об уничтожении или утилизации.
Каждая операция должна сопровождаться:
· данными о продукте (код, номер партии, состав, номер ГОСТ);
· участнике операции (ИНН, ОГРН, адрес, роль);
· параметрами события (дата, место, масса, упаковка).
3. Общая архитектура системы интеграции с 1С: ERP
Интеграция с "Сатурн" предполагает следующую архитектуру:
1. Выделенный модуль обмена в 1С (расширение или подсистема);
2. Хранилище API-ключей и токена авторизации;
3. Обработчики событий ERP-системы, формирующие JSON-документы;
4. HTTP-клиент для отправки запросов в ФГИС;
5. Логирование и журнал ошибок для контроля стабильности;
6. Интерфейс подтверждения и перепроведения ошибок.
4. Инструкция по реализации интеграции
Рассмотрим по порядку, как корректно выполнить интеграцию:
1. Регистрация в ФГИС "Сатурн", для этого:
· Авторизуйтесь через ЕСИА;
· Подтвердите полномочия на юридическое лицо;
· Получите ключи API и ссылки на тестовую/боевую среду.
Классификатор организаций САТУРН
2. Создание модуля интеграции данных в 1С.
Интеграция с ФГИС «Сатурн»
Для этого нужно выполнить подключение HTTPService, в этом поможет следующий программный код:
КопироватьРедактировать
HTTPЗапрос = Новый HTTPЗапрос("https://saturn.api.gov.ru/v1/batches");
HTTPЗапрос.Заголовки.Вставить("Authorization", "Bearer " + Токен);
HTTPЗапрос.УстановитьТелоИзСтроки(ТелоJSON, "application/json; charset=utf-8");
Ответ = HTTPЗапрос.Отправить();
Пример структуры JSON будет таким:
КопироватьРедактировать
{
"productBatch": {
"productCode": "123456789",
"batchNumber": "BCH-2024-01",
"productionDate": "2024-01-15",
"quantity": 200,
"unit": "kg"
},
"participant": {
"inn": "7712345678",
"ogrn": "1027700123456",
"organizationName": "ООО АгроХим"
},
"eventDate": "2024-01-20T09:00:00"
}
3. Настройка событий в 1С таким образом:
· Создайте обработчик документа «Поступление товаров и услуг»;
· При проведении документа формируйте структуру JSON;
· Используйте HTTP-запрос для отправки данных;
· Сохраняйте статус ответа и дату отправки.
4. Обработка ошибок при помощи таких действий:
· Если сервер ФГИС вернул 400 или 500 — логируйте ошибку;
· Предусмотрите механизм повторной отправки;
· Добавьте интерфейс для просмотра истории отправки по каждой партии.
5. Формирование отчётности. В 1С: ERP можно формировать отчёты:
· по партиям, зарегистрированным в "Сатурн";
· по операциям использования на полях;
· по прослеживаемости на складе.
Рассмотрим, как интеграция будет работать в двух следующих случаях-примерах.
Пример первый. Автоматическое формирование JSON при продаже. Компания реализует партию гербицида. В момент проведения документа «Реализация товаров»:
· автоматически формируется структура данных;
· вызывается функция отправки в API;
· фиксируется GUID события от ФГИС.
Пример второй. Учёт применения в сельском хозяйстве. При заполнении документа «Работы в растениеводстве»:
· выбирается участок, культура, агроном;
· указывается норма внесения, препарат;
· на основании этих данных формируется JSON-объект и отправляется в ФГИС.
Интеграция с ФГИС "Сатурн" — это обязательное и стратегически важное направление для предприятий агрохимического сектора. 1С: ERP предоставляет все необходимые средства для автоматизации процесса, начиная от подключения к API и заканчивая полной прослеживаемостью в рамках внутренних бизнес-процессов.
Правильно реализованная интеграция:
· снижает трудозатраты на ручной ввод;
· минимизирует вероятность ошибок;
· обеспечивает прозрачность операций;
· соответствует требованиям законодательства.
Для устойчивой работы интеграции необходима регулярная поддержка, валидация входных данных и сопровождение с использованием механизмов контроля ошибок и повторной отправки.
Специалист компании ООО "Кодерлайн"
Лев Туренко
