Интеграция оборудования Гарвекс: как проверить единицы объёма в стороннем оборудовании

Зачем проверять единицы объёма до запуска обмена

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

Проверка единиц объёма — часть приёмки интерфейсов АЗС. Она помогает выявить неоднозначность до начала регулярной работы и зафиксировать, какие сведения должны передаваться. Это не инструкция по настройке или ремонту сторонней ТРК: такие действия выполняет владелец оборудования или его уполномоченный сервис.

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

Сначала определите, что именно проверяете

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

Составьте короткую схему движения данных:

1. Где появляется исходное значение.
2. Какая система его передаёт.
3. Какое поле принимает другая сторона.
4. Где оператор видит результат.
5. Где сохраняется итоговая запись.

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

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

Порядок приёмки: от описания поля до тестовой записи

1. Сверьте документы участников

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

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

2. Зафиксируйте исходные условия теста

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

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

3. Сопоставьте значение на всех этапах

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

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

4. Проверьте представление числа

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

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

Таблица для протокола проверки

Эта таблица — шаблон протокола, а не спецификация конкретного оборудования. Состав и критерии тестов следует согласовать с поставщиками подключаемых систем.

Что делать, если значения не совпали

Не корректируйте настройки сторонней техники самостоятельно и не считайте расхождение доказательством неисправности конкретного устройства. Зафиксируйте:

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

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

Особенности приёмки интерфейсов АЗС

Приёмка должна завершаться не устной отметкой «данные пришли», а протоколом, в котором понятны объект проверки, результат и нерешённые вопросы. Полезно отдельно отметить, какие сценарии проверены, какие не входили в тест и кто отвечает за дальнейшие действия.

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

Вывод

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

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