Гарвекс и 1С: как согласовать состав передаваемых полей

Согласуйте результат обмена до списка полей

Интеграция Гарвекс с 1С начинается с ответа на вопрос: для какой операции нужны данные о топливе? Одному предприятию требуется передавать события выдачи, другому — готовить сведения для сверки остатков. Разные задачи предполагают разные требования к детализации, проверке и обработке записей.

На странице АЗС-Онлайн указана интеграция с «1С:Предприятие» через API. Однако наличие такой возможности не определяет состав полей и готовность обмена с любой конфигурацией. Поддержку вашей версии 1С, способ подключения и объём настройки уточнит менеджер Гарвекс.

Ниже приведён порядок подготовки задания на обмен. Предлагаемые поля — рабочая заготовка для обсуждения, а не перечень реквизитов API Гарвекс.

Соберите участников и исходные сведения

На согласовании нужны ответственный за топливный учёт, специалист по конфигурации 1С и представитель стороны, которая настраивает источник данных. Они согласуют смысл операции, место записи в 1С и доступность сведений.

Подготовьте название и версию конфигурации, описание доработок, перечень площадок и пример результата. Укажите, как пользователь найдёт операцию и проверит её происхождение. Тестовые примеры можно обезличить.

Составьте карту данных Гарвекс — 1С

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

Добавьте колонки «поле источника», «реквизит назначения», «тип», «обязательность», «правило преобразования» и «действие при ошибке». Не заполняйте названия технических полей по догадке. В разделе документации Гарвекс есть описание API «АЗС-Онлайн»; применимую редакцию и доступность нужных данных подтвердите со специалистом.

Договоритесь о значении каждого поля

Одного названия «дата» недостаточно: оно может обозначать момент операции или момент обработки записи. Аналогично «объект» может пониматься как площадка, резервуар или колонка. В карте нужно словесное определение, которое одинаково прочтут обе стороны.

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

Выполните сопоставление справочников ГСМ

Сравните списки топлива, площадок и техники до запуска обмена. Совпадение названий удобно для ручной проверки, но правило автоматического сопоставления должно опираться на согласованный устойчивый признак. Переименование объекта не должно незаметно создавать новую сущность.

Назначьте владельца таблицы соответствий. Он проверяет новые записи и решает, к какому существующему объекту они относятся. Если соответствие не найдено, предусмотрите очередь разбора или другой согласованный способ остановить обработку спорной записи. Автоматическое создание объектов допускайте только как заранее утверждённое требование к реализации.

Определите правила повторов и исправлений

Обмен нужно проектировать так, чтобы повторная передача уже полученной записи не увеличивала итог выдачи. Зафиксируйте критерий уникальности, а затем проверьте его на повторном поступлении тестового события. Способ реализации выбирают специалисты с учётом возможностей источника и приёмника.

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

Проведите приёмочную сверку

Проверьте обычную операцию, повтор, неизвестный объект, отсутствующее обязательное значение и исправление. В каждом случае сравните запись источника, результат обработки и итог в 1С. Сверяйте не только суммарный объём, но и число событий, распределение по объектам и причины отклонения записей.

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

Вывод

Согласованный состав полей — это значения с определённым смыслом, правила преобразования и проверенные сценарии обработки. Направьте Гарвекс описание конфигурации 1С и черновик карты данных: консультация поможет уточнить доступные сведения и подготовить задание на интеграцию.