Восемь скриншотов вместо тикета: как я отлаживал 12-ТОРГ по письму бухгалтера

Восемь скриншотов вместо тикета: как я отлаживал 12-ТОРГ по письму бухгалтера

Письмо пришло в понедельник, в районе обеда. Тема: "Не сходится 12-торг". Содержимое — восемь скриншотов, вставленных прямо в тело письма, и три абзаца текста между ними. Ни тикета в Jira, ни шагов воспроизведения, ни формального бага. Просто крик о помощи в почтовом виде.

Через час фикс был в продуктиве.

И, если честно, я считаю это письмо одним из лучших баг-репортов, которые получал за последние пару лет. Хотя автор почти наверняка не подозревала, что написала именно баг-репорт — для неё это было просто "я не знаю, как это объяснить, поэтому отправляю всё, что вижу".

Контекст: статистика для налоговой

Я настраивал учёт алкогольной продукции в розничной сети. У них специфика — большая доля выручки идёт через рестораны при магазинах, плюс собственно розничная торговля. Для отчётности требуется собирать статистику в разрезе видов деятельности: отдельно "розничный товарооборот", отдельно "товарооборот общественного питания". Это разные строки в форме статистической отчётности 12-ТОРГ.

Заодно туда же приходят формы 1-торг и 4-торг, каждая со своей логикой агрегации. Но проблема была в 12-ТОРГ.

Отдельная сложность — алкоголь продаётся наборами. Подарочный набор из шести бутылок вина, набор "вино + фужеры", бутылка плюс штопор. Система должна разложить такой набор по компонентам: для статистики важны не наборы, а сами бутылки. Шесть бутылок по 0,75 литра — это 4,5 литра вина, попадающие в декларацию. И сумма продажи тоже должна разложиться по компонентам пропорционально.

Эта раскладка и оказалась эпицентром проблемы.

Восемь скриншотов: цепочка данных от справочника до отчёта

Открываю письмо и начинаю смотреть, что бухгалтер мне прислала.

Скриншот первый. Карточка номенклатуры. Подарочный набор из шести бутылок вина одной марки. В табличной части "Состав набора" — ровно шесть строк, по одной бутылке в каждой.

Скриншот второй. Карточка единицы измерения для этой бутылки. Объём 0,75 литра, ёмкость 750 миллилитров, литраж рассчитан корректно.

Скриншот третий. Тестовый Z-отчёт за день. Одна продажа. Подарочный набор. 195 рублей 95 копеек. Покупатель — "розничный" (то есть продажа по виду деятельности "розница").

Скриншот четвёртый. Движения регистра накопления "Продажи". По проблемному документу. Шесть строк — компоненты набора, корректно разложенные. Сумма каждой строки — около 32 рублей 66 копеек, в сумме 195,95. Всё сходится.

Скриншот пятый. Отчёт по отгрузкам товаров. Тот же документ. Те же шесть компонентов. Та же сумма. Никаких расхождений.

Скриншот шестой. Здесь начинается самое интересное. Это уже сам 12-ТОРГ, заполненный по тестовым данным. Строка 01 — "Розничный товарооборот" — содержит значение 0,19595 (тысяч рублей). Это ровно 195,95. Хорошо, ожидаемо. Строка 06 — "Товарооборот общественного питания" — содержит то же самое значение: 0,19595.

Одна и та же сумма попала в две разные строки отчёта. Розничная продажа отразилась и как розница, и как общепит. Удвоение по виду деятельности.

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

Цепочка данных в отчёте 12-ТОРГ: от карточки набора через регистр продаж к итоговой строке

Когда я закрыл письмо, у меня в голове уже была готовая трасса. Карточка → единица измерения → документ продажи → движения регистра → промежуточный отчёт → итоговый 12-ТОРГ. Шесть точек на цепочке данных. На пяти из шести всё корректно. Расхождение появляется ровно при переходе от пятой точки к шестой — то есть внутри модуля 12-ТОРГ, на этапе агрегации.

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

Отладка по обратной трассе

Открыл модуль отчёта. Семьсот строк. Для генерации 12-ТОРГ это типичный размер: формула на каждую строку, плюс блок раскладки наборов на компоненты, плюс блок корректировки остатков от округления. Стандартный набор инструментов.

Логика раскладки наборов выглядела так. Берём документ продажи, в котором есть строка с набором. Смотрим состав набора в справочнике. Создаём вместо одной строки документа шесть — по одной на компонент. Сумму в 195,95 рублей делим на шесть, получаем 32,66 на каждую строку. Деление на шесть не всегда даёт круглый результат, поэтому остаётся "хвост" — копеек тридцать. Этот хвост приписывается к последней строке, чтобы итог сошёлся точно с исходной суммой документа.

Это абсолютно стандартный приём в учёте. У меня самого в коде такая корректировка остатка лежит в десятках мест.

Дальше шла сама агрегация по строкам отчёта. По виду деятельности продажа определяется в основном цикле:

Если СтрокаПродажи.ВидДеятельности = ВидыДеятельности.Розница Тогда
    СтрокаОтчёта.Розница = СтрокаОтчёта.Розница + СтрокаПродажи.Сумма;
ИначеЕсли СтрокаПродажи.ВидДеятельности = ВидыДеятельности.Общепит Тогда
    СтрокаОтчёта.Общепит = СтрокаОтчёта.Общепит + СтрокаПродажи.Сумма;
КонецЕсли;

Тут всё корректно. Розница идёт в розницу, общепит — в общепит. Условие чёткое, развилка не пересекается. Выхожу из основного цикла. Дальше — блок корректировки остатка от округления. И вот тут начинается самое интересное.

// Корректировка остатка от округления при раскладке наборов
СтрокаОтчёта.Розница = СтрокаОтчёта.Розница + ОстатокРозница;
СтрокаОтчёта.Общепит = СтрокаОтчёта.Общепит + ОстатокОбщепит + СтрокаПродажи.Сумма;

Видите последнюю строку? Условия по виду деятельности нет. Корректировка остатка безусловно прибавляет полную сумму строки продажи к полю общепита. Не остаток. Полную сумму. Каждый раз.

Для строк, которые в основном цикле классифицировались как розница, накопленный ОстатокОбщепит равен нулю. Поэтому формула в блоке корректировки выдаёт: 0 + 195.95 + 0 = 195.95. Полная сумма продажи целиком улетает в общепит, в дополнение к тому, что она уже корректно ушла в розницу из основного цикла.

Сравнение: основной цикл правильно делит сумму по виду деятельности, блок остатка добавляет её ещё раз в общепит

Скорее всего, копи-паста. Кто-то когда-то писал блок остатка, скопировал шаблон "прибавляем к рознице, прибавляем к общепиту" и забыл, что внутри основного цикла этим должен заниматься Если/Иначе. В результате блок остатка стал параллельной веткой записи, которая дублирует продажу.

Фикс на четыре строки

Поправил. То же самое условие Если/Иначе, что в основном цикле, обернул вокруг блока корректировки. Четыре строки. Никакой хирургии. Перепровёл тестовый сценарий — 12-ТОРГ заполнился чисто. Розничный товарооборот: 0,19595. Общественное питание: пусто. Прогнал ещё пару реальных документов из прода — сходится.

// Корректировка остатка с учётом вида деятельности
Если СтрокаПродажи.ВидДеятельности = ВидыДеятельности.Розница Тогда
    СтрокаОтчёта.Розница = СтрокаОтчёта.Розница + ОстатокРозница;
ИначеЕсли СтрокаПродажи.ВидДеятельности = ВидыДеятельности.Общепит Тогда
    СтрокаОтчёта.Общепит = СтрокаОтчёта.Общепит + ОстатокОбщепит;
КонецЕсли;

Коммит, мерж в продуктивную ветку, деплой через хотдеплой. Час между моментом открытия письма и моментом, когда в проде поехал фикс. Большая часть времени ушла на чтение восьми скриншотов и трассировку модуля. Сам фикс — пять минут.

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

Почему этот баг-репорт оказался лучше многих формальных

Я работаю с тикетами уже много лет. Видел и идеальные, оформленные по шаблону: "Шаги воспроизведения", "Ожидаемый результат", "Фактический результат". И полную противоположность: "всё сломалось". Письмо с восемью скриншотами оказалось ближе к идеалу, чем большинство формальных тикетов, которые я разбирал в этом году.

Причина простая. Бухгалтер не знала, где может быть проблема, поэтому собрала всё, что выглядело относящимся к делу. И собрала это в правильном порядке: от исходной точки данных (карточка номенклатуры) до итоговой ячейки отчёта. Когда оформляют тикет по шаблону, обычно описывают только тот шаг, на котором заметили расхождение: "в 12-торг неправильное число". Все остальные точки на цепочке данных автор тикета "знает" — и не считает нужным показать. А мне для отладки нужно ровно обратное: не верить, что что-то очевидно, и пройти всю цепочку самому.

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

Если бы пришёл формальный тикет "в 12-торг сумма продажи попадает в общепит" — мне пришлось бы повторить всю эту работу самому. Найти документ. Открыть карточку. Проверить регистр. Сравнить с промежуточным отчётом. И только потом дойти до модуля 12-ТОРГ. Минимум полчаса лишней работы, прежде чем я вообще доберусь до строки с багом.

В этом смысле "непрофессиональный" баг-репорт оказался профессиональнее многих "правильных". Бухгалтер интуитивно сделала ровно то, что требуется от хорошего сообщения об ошибке: показала контекст, показала входные данные, показала промежуточные результаты, показала итог. Просто сделала это в форме, которая никому не нравится — кучей скриншотов в теле письма.

Иллюстрация: восемь скриншотов как готовая трасса для отладки отчёта 1С

Что я отсюда вынес

Главный для меня вывод — про шаблоны баг-репортов, и он не очень популярный. Я считаю, что обязывать пользователей оформлять тикеты по строгому шаблону — почти всегда хуже, чем пускать их писать как есть. Пользователь, который не знает, в чём проблема, пишет шаблонный тикет хуже, чем неструктурированное письмо с большим количеством деталей. Шаблон заставляет его отбросить ту половину контекста, которую он не сумел уложить в графу "Шаги воспроизведения". И именно эта половина обычно и нужна для отладки.

Второй вывод — про копи-пасту. Блок корректировки остатка был написан методом копирования из основного цикла, но без условия по виду деятельности. Это типичная ошибка: копируешь куда-то готовый кусок, удаляешь "лишнее" (как тебе кажется), и теряешь деталь, которая на самом деле критическая. Я с похожей логикой раз за разом сталкиваюсь — недавно писал об этом в разборе рефакторинга 2400-строчного модуля, где десятки мест были созданы такой же копипастой, и каждое второе содержало мелкое искажение оригинала.

И третий — про молчаливые баги в отчётах. Расхождение в 12-ТОРГ можно было заметить за месяцы до этого письма. Любой, кто видел итог, мог удивиться: "Почему у нас сумма в общепите равна сумме в рознице, если мы вообще не торгуем в общепите по этому документу?". Но никто не удивился — потому что ни у кого не было привычки сверять значения между строками отчёта. Все доверяли, что отчёт сделан правильно. Я писал про похожую ловушку доверия в статье про интеграции, которые ломаются не там, где ждёшь: пока никто не сверяет, ошибка живёт.

Восемь скриншотов вместо тикета. Час в проде. Один баг закрыт. Иногда лучшие баг-репорты пишут люди, которые понятия не имеют, что такое баг-репорт. Им просто очень нужно, чтобы цифры сошлись.