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

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

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

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

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

До загрузки: зафиксируйте условия сверки

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

Проверьте заранее:

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

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

Как проверить полноту данных при постраничной выгрузке

1. Сверьте исходный набор и загруженный период

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

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

2. Проверьте прохождение каждой страницы

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

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

3. Найдите пропуски и повторы

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

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

4. Сверьте итоги по группам

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

5. Повторный запуск контролируйте отдельно

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

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

Как разбирать ошибки обмена ГСМ

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

Для обращения к специалисту подготовьте:

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

Не отправляйте лишние персональные данные: для первичной проверки обычно достаточно технических сведений о периоде, количестве записей и характере расхождения. Общие материалы об АЗС-Онлайн доступны в документации Гарвекс. Если самостоятельно установить причину не получается, можно обратиться к специалистам.

Чек-лист перед закрытием периода

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

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