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

Зачем отдельно проверять дробные значения

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

Проверка нужна не для того, чтобы заранее предположить ошибку в Гарвекс или 1С, а чтобы зафиксировать согласованные правила обмена и подтвердить их на тестовых примерах. Например, если значение 12,34 при передаче превратилось в 12,3, важно установить, предусмотрено ли такое округление настройками учета или это расхождение, требующее выяснения.

АЗС-Онлайн описан как облачный веб-сервис, который обрабатывает, хранит и передает данные по топливным операциям в режиме реального времени. В документации также указана интеграция со сторонним программным обеспечением через API. Для 1С предусмотрены интеграция через API (Swagger) или готовая конфигурация 1С:Предприятие. Сведения об АЗС-Онлайн доступны на странице программного обеспечения.

До теста: согласуйте правила

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

Зафиксируйте письменно:

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

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

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

Подготовьте набор тестовых значений

Набор должен проверять не только одно «удобное» число. Возьмите несколько разных значений и заранее запишите, какой результат считается правильным. Примеры ниже — тестовые данные для проверки; это не описание ограничений или настроек продуктов.

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

Пошаговый тест интеграции топлива с 1С

1. Зафиксируйте исходные данные

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

2. Проверьте данные в источнике

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

3. Проверьте результат в 1С

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

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

4. Повторите тест без изменения данных

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

5. Проверьте разные форматы представления

В тестовом протоколе укажите, как записан разделитель дробной части в исходных данных и как значение отображается после обмена. Важно сравнивать сами числа, а не только внешний формат записи: 12,34 и 12.34 могут выглядеть по-разному в интерфейсах, оставаясь одним числовым значением. Правило представления и точность результата должны быть согласованы для используемой конфигурации.

Как оформить приемку обмена учетными данными

Для каждого теста заполните короткую карточку:

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

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

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

Итог

Проверка дробных значений — часть приемки обмена, а не попытка угадать настройки интеграции. Сначала зафиксируйте соответствие полей, точность и правило округления, затем сравните тестовую операцию в источнике и в 1С и запишите результат повторного обмена. Для АЗС-Онлайн документацией предусмотрена интеграция со сторонним ПО через API, а для 1С — через API (Swagger) или готовую конфигурацию 1С:Предприятие.

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