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

Зачем проверять смену карты отдельным тестом

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

В документации АЗС-Онлайн среди полей события заправки указаны NameUser — имя и фамилия водителя, IdUser — номер карты водителя, NumPetrol — порядковый номер заправки, а также дата и время, колонка и количество топлива. В примере ответа на запрос событий есть IdKolonka, NumPetrol, IdUser, NameUser и Firm. Эти поля позволяют выстроить понятный сценарий сравнения записей до и после замены карты.

Важно: тест ниже проверяет именно обмен и отображение учётных данных. Он не описывает настройку или выпуск карт. Порядок управления картами зависит от вашей конфигурации и регламента организации.

Что подготовить до теста

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

АЗС-Онлайн работает через контроллер «Квота». Сведения о сервисе и его возможностях приведены на странице АЗС-Онлайн.

Сценарий: одна смена карты, две тестовые записи

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

Шаг 1. Проверка старой карты

Выполните тест по старой карте и найдите соответствующую запись в АЗС-Онлайн и 1С. Зафиксируйте:

• IdUser — идентификатор старой карты;
• NameUser — отображаемое имя водителя;
• IdKolonka — идентификатор колонки;
• NumPetrol — номер заправки;
• дату и время;
• AmountFuel — количество выданного топлива, если это поле доступно в используемом представлении.

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

Шаг 2. Проверка новой карты

После согласованной замены карты проведите аналогичную проверку по новой карте. Найдите новую запись в АЗС-Онлайн и затем проверьте её получение в 1С.

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

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

Шаг 3. Сверка обмена с 1С

Сопоставьте событие в АЗС-Онлайн с принятой записью в 1С. Для обеих тестовых заправок проверьте:

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

Проверка событий через API

В описании API указано получение событий по номеру последней заправки на заданной колонке: запрос отправляется методом POST на https://garvekswebreporter.ru/api/events с IdKolonka и NumPetrol. В ответе возвращаются события начиная с запрошенного номера включительно. В структуре ответа приведены, в частности, Id, IdKolonka, NumPetrol, IdUser, NameUser и Firm.

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

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

Как оформить результат приемки

Для каждой карты составьте отдельную строку в протоколе:

• дата и время теста;
• тестовый водитель;
• старая или новая карта и её IdUser;
• IdKolonka и NumPetrol;
• значения, увиденные в АЗС-Онлайн;
• значения, найденные в 1С;
• итог: совпало, не совпало или поле отсутствует.

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

Вывод

Проверка смены карты у одного водителя строится на сравнении двух связанных по смыслу, но отдельных событий: заправки по старой карте и заправки по новой. Ключевые поля для сверки — NameUser, IdUser, IdKolonka и NumPetrol; дату, время и количество топлива используйте как дополнительные признаки, если они доступны в обмене.

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