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

Начните с конкретной операции

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

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

Запишите направление понятным предложением

Удобная формула задания: «Система-источник передаёт указанные сведения в систему-получатель для определённой учётной задачи». Отдельно назовите программу, которая инициирует запрос. Данные могут двигаться в сторону 1С, даже если технически именно обработка на стороне 1С запрашивает их у сервиса.

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

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

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

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

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

Время операции и время получения

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

Согласуйте сопоставление справочников ГСМ

Одинаковое название топлива или автомобиля в двух программах не гарантирует, что это одна сущность. Сопоставление справочников ГСМ должно опираться на согласованные устойчивые идентификаторы и проверку ответственного сотрудника.

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

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

Предусмотрите повторную загрузку

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

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

Как принять результат работы

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

Сведения о составе заправочного оборудования удобно сверить с разделом контроллеров Гарвекс. Для задания на обмен дополнительно понадобятся название конфигурации 1С, её версия и описание текущего учётного процесса.

Вывод

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