Начало работы
1. Быстрый старт

Назначение
2. Для чего нужен Match
Match отвечает не на вопрос «сколько строк в двух файлах вместе», а на вопросы «какая запись соответствует какой», «что в ней изменилось» и «что есть только с одной стороны».
Подготовка данных
3. Какие файлы подходят
| Формат | Импорт | Что учитывать |
|---|---|---|
| XLSX, XLS | Первый лист книги | Значения читаются локально. Выбор другого листа в текущем интерфейсе отсутствует. |
| CSV | Разделитель определяется автоматически | Поддерживаются UTF-8 и Windows-1251; для неоднозначного CSV проверьте предпросмотр. |
| TSV | Табуляция | Полезен, когда текстовые значения содержат запятые и точки с запятой. |
Ограничения пилотной версии: до 25 МБ и до 10 000 подготовленных строк в каждом файле; суммарно — до 300 000 непустых ячеек. Пустые строки и полностью пустые столбцы исключаются при подготовке.
- одна запись должна занимать одну строку;
- названия столбцов должны быть понятными и находиться в одной строке;
- даты и суммы лучше хранить в единообразном формате;
- итоги, подписи и служебные строки не должны попадать в ключ;
- идентификатор записи должен быть заполнен и по возможности уникален.
Стороны сравнения
4. Загрузка файлов A и B
A — исходный реестр, относительно которого вы читаете результат. B — версия или источник для сравнения.
| Статус | Смысл | Пример трактовки |
|---|---|---|
| Только в A | Ключ найден в A, но не найден в B. | Операция была в исходном реестре, но отсутствует в новой версии. |
| Только в B | Ключ найден в B, но не найден в A. | В сравниваемом реестре появилась новая операция. |
Смена мест A и B не меняет факт расхождения, но меняет его направление и смысл действий «добавить», «исключить» и «принять значение».
Шаг 2
5. Проверка структуры и заголовков
Match оценивает первые строки таблицы и предлагает наиболее вероятную строку заголовков. В выпадающем поле «Заголовки» можно вручную выбрать другую строку отдельно для A и B.
В этом примере строкой заголовков должна быть третья строка — «Артикул | Товар | Цена | Количество». Строки выше неё не попадут в данные.
- переключайтесь между вкладками A и B и проверяйте обе стороны;
- смотрите сводку подготовки: число исходных и подготовленных строк, очистку пробелов, нормализацию дат и чисел;
- при сообщении о неоднозначной структуре выбирайте заголовок вручную;
- поиск, пагинация и масштаб помогают проверить большой предпросмотр.

Главная настройка
6. Выбор ключа сверки
Ключ определяет, какие строки A и B относятся к одной записи. Поле сравнения проверяется уже после того, как пара найдена по ключу.
Простой ключ
Если «Номер операции» заполнен и уникален в обоих файлах, одной пары колонок достаточно: Операция A ↔ Номер операции B.
Составной ключ
Добавьте несколько сопоставлений с ролью «Ключ». Например:
Комбинация подходит, когда один номер может повторяться в разные даты. Она не подходит, если дата исправляется между версиями: тогда одна операция станет «Только в A» и «Только в B», а не «Изменилось».
Разные названия колонок
Названия не обязаны совпадать. В каждой строке настройки отдельно выберите столбец A и соответствующий ему столбец B.

После связи строк
7. Выбор полей сравнения
Для найденной по ключу пары Match сравнивает только строки настройки с ролью «Сравнивать». Если хотя бы одно из этих значений отличается, строка получает статус «Изменилось», а отчёт показывает A и B.
| Ключ | A: сумма | B: сумма | Результат |
|---|---|---|---|
| PAY-104 | 12 500 | 12 700 | Изменилось — сумма отличается |
| PAY-105 | 8 000 | 8 000 | Без изменений |
Не добавляйте технические метки выгрузки, время формирования и другие несущественные поля: любое их отличие увеличит число расхождений. Для просмотра в отчёте можно оставить сопоставление с ролью «Не учитывать».
Финансовая проверка
8. Контроль сумм
В блоке «Контроль сумм» выберите сопоставленную числовую пару. Match отдельно показывает итог A, итог B, общую разницу и вклад категорий в эту разницу.
| Ключ | A | B | Категория | Вклад B − A |
|---|---|---|---|---|
| 101 | 1 000 | 1 000 | Без изменений | 0 |
| 102 | 700 | 900 | Изменилось | +200 |
| 103 | 300 | — | Только A | −300 |
| 104 | — | 500 | Только B | +500 |
| Итого | 2 000 | 2 400 | +400 |
Отчёт по сверке
9. Как читать результаты
| Категория | Условие | Пример A / B |
|---|---|---|
| Без изменений | Ключ связан, все выбранные поля равны после нормализации. | ID 10, сумма 500 / ID 10, сумма 500 |
| Изменилось | Ключ связан, отличается хотя бы одно выбранное поле. | ID 11, 500 / ID 11, 550 |
| Только в A | Ключ существует только в A или остался лишний экземпляр повторной группы. | ID 12 / — |
| Только в B | Ключ существует только в B или остался лишний экземпляр повторной группы. | — / ID 13 |
| На проверку | В повторной группе есть несколько равнозначных вариантов сопоставления. | Две неодинаковые строки A и две строки B с одним ключом |
«Общее» объединяет пары «Без изменений» и «Изменилось». «Все результаты» также включает односторонние и неоднозначные записи. Повторы не являются отдельным конечным статусом: они отмечаются диагностикой ключа, затем идентичные строки гасятся попарно, а остаток попадает в одну из перечисленных категорий.

Диагностика
10. Повторяющиеся и пустые ключи
Пустой ключ
Если хотя бы одна часть составного ключа пуста, Match не может надёжно связать строку и блокирует запуск. Интерфейс предлагает исключить такие строки из анализа. Исключённые строки остаются видны в предпросмотре, но не входят в сверку.
Повторяющийся ключ
Запуск также блокируется, пока вы не подтвердите построчный разбор повторов. После подтверждения:
- полностью идентичные строки с одинаковым ключом сопоставляются попарно;
- оставшиеся строки связываются по минимальному числу отличающихся выбранных полей;
- если несколько вариантов равнозначны, вся оставшаяся группа получает статус «На проверку»;
- лишние экземпляры попадают в «Только в A» или «Только в B».
Аудит результата
11. Проверка в исходниках
В строке результата или решения нажмите «Проверить в исходниках». Модальное окно покажет связанные строки A и B с исходными номерами строк. Для статуса «На проверку» отображается вся неоднозначная группа.
Кнопка «Вернуться к расхождению» закрывает окно, сохраняя текущую вкладку, фильтры, позицию и уже введённые решения.

Этап 2
12. Обработка расхождений
Сначала выберите цель: «Только реестр решений», «Исправленный файл A», «Исправленный файл B» или «Объединённый файл». Рекомендуемые действия поднимаются выше в списке, но решение остаётся за пользователем.
| Категория | Доступные действия | Практический смысл |
|---|---|---|
| Изменилось | Принять значение из A; принять из B; расхождение допустимо; отложить | Для исправленного файла переносится выбранное значение сравниваемых полей; для реестра фиксируется решение. |
| Только в A | Добавить строку в B; оставить только в A; исключить из A; отложить | Добавить отсутствующую запись, сохранить одностороннее состояние или убрать запись из целевого результата. |
| Только в B | Добавить строку в A; оставить только в B; исключить из B; отложить | Зеркальный набор действий для строки B. |
| На проверку | Взять строки из A; взять строки из B; передать на ручную проверку; оставить нерешённым | Решение принимается для неоднозначной группы, а не для придуманной системой пары. |
Решение можно изменить до скачивания. Есть комментарии, поиск, выбор нескольких строк и массовое применение действия внутри текущей категории.

Экспорт
13. Скачивание результатов
| Кнопка / цель | Файл | Состав |
|---|---|---|
| Скачать отчёт | Structo_Match_полный_результат.xlsx | Сводка, «Все результаты», «Общее», «Изменилось», «Только A», «Только B», «На проверку», настройки и диагностика ключа. |
| Скачать реестр решений | Structo_Match_реестр_решений.xlsx | Протокол действий и комментариев, навигация к копиям исходных строк A и B внутри книги. |
| Исправленный файл A | Structo_Match_исправленный_A.xlsx | Новая таблица на основе A с применёнными решениями и протоколом. |
| Исправленный файл B | Structo_Match_исправленный_B.xlsx | Новая таблица на основе B с применёнными решениями и протоколом. |
| Объединённый файл | Structo_Match_объединённый_файл.xlsx | Новая таблица, собранная по статусам и выбранным решениям, плюс протокол. |
Исходные файлы A и B не перезаписываются. Все скачивания создают новые XLSX. Полный отчёт фиксирует результат сверки; реестр решений фиксирует последующие действия пользователя.
Практика
14. Три сквозных примера
Кейс A — банк против учётной системы
Ключ: Номер платежа. Сравнивать: Сумма, Получатель.
| A: банк | Сумма | Получатель | B: учёт | Сумма | Получатель | Ожидание |
|---|---|---|---|---|---|---|
| PAY-01 | 10 000 | ООО Альфа | PAY-01 | 10 000 | ООО Альфа | Без изменений |
| PAY-02 | 7 500 | ООО Бета | PAY-02 | 7 000 | ООО Бета | Изменилось: сумма |
| PAY-03 | 2 000 | ООО Гамма | — | — | — | Только в A |
| — | — | — | PAY-04 | 900 | ООО Дельта | Только в B |
Контроль сумм: A = 19 500, B = 17 900, разница B − A = −1 600.
Кейс B — две версии прайс-листа
Ключ: Артикул. Сравнивать: Наименование, Цена.
| Артикул | A: товар / цена | B: товар / цена | Ожидание |
|---|---|---|---|
| P-100 | Папка / 180 | Папка / 195 | Изменилось: цена |
| P-200 | Ручка / 45 | Ручка / 45 | Без изменений |
| P-300 | Блокнот / 240 | — | Только в A — позиция удалена |
| P-400 | — | Маркер / 120 | Только в B — позиция добавлена |
Кейс C — маркетплейс против внутреннего реестра
Составной ключ: Номер заказа + Артикул. Сравнивать: Количество, Выплата.
| Сторона | Заказ | Артикул | Количество | Выплата |
|---|---|---|---|---|
| A | ORD-7 | SKU-1 | 1 | 900 |
| A | ORD-7 | SKU-1 | 2 | 1 800 |
| B | ORD-7 | SKU-1 | 1 | 850 |
| B | ORD-7 | SKU-1 | 2 | 1 750 |
Ключ повторяется с обеих сторон. Несмотря на визуально естественные пары по количеству, на первом шаге есть несколько кандидатов с одинаковым минимальным числом отличий. Поэтому движок консервативно вернёт одну группу «На проверку», а не назначит пары автоматически. Для устойчивого результата добавьте в ключ идентификатор строки отчёта маркетплейса.
Перед запуском
15. Типичные ошибки и ограничения
| Ситуация | Признак | Что делать |
|---|---|---|
| Неверная строка заголовков | Названия колонок выглядят как данные или «Столбец 1» | Выберите правильную строку отдельно на вкладках A и B. |
| Неуникальный ключ | Диагностика показывает повторяющиеся группы | Добавьте часть составного ключа либо осознанно подтвердите разбор повторов. |
| Пустой ключ | Запуск заблокирован | Заполните идентификатор, выберите другой ключ или исключите служебные строки. |
| Разный формат | Визуально похожие значения попали в разные категории | Проверьте тип столбца, пробелы, даты, идентификаторы с ведущими нулями. |
| Итоги внутри таблицы | Служебная строка участвует в диагностике и сумме | Уберите её из рабочей области или исключите при пустом ключе. |
| Неоднозначное соответствие | Статус «На проверку» | Откройте исходники и уточните ключ; не назначайте пару наугад. |
| Контрольные суммы расходятся | Итоги A и B различны | Разложите вклад по категориям и проверьте повторы/исключения. |
- обрабатывается только первый лист Excel-книги;
- нет fuzzy matching, поиска синонимов и вероятностного связывания;
- нет группировки нескольких строк одной стороны в агрегированную строку другой;
- решение по неоднозначному совпадению принимает пользователь;
- результат зависит от выбранных заголовков, ключа и полей сравнения;
- итоговые книги создаются заново и не заменяют исходные файлы.
Справка
16. Частые вопросы
Почему две визуально одинаковые строки не совпали?
Проверьте ключ и выбранные поля. Различаться могут скрытые символы, ведущие нули, тип значения или одна из частей составного ключа. Откройте обе строки через «Проверить в исходниках».
Почему обнаружены дубли?
Одно нормализованное значение ключа встретилось несколько раз хотя бы в одном файле. Это может быть допустимая детализация или реальный повтор операции.
Можно ли использовать несколько колонок в ключе?
Да. Добавьте несколько сопоставлений и задайте им роль «Ключ». Строки свяжутся, только если совпадут все части.
Что означает «Только в B»?
В B есть строка с ключом, которого нет в A, либо после попарного разбора повторов в B остался лишний экземпляр.
Как вернуться к исходной строке?
Нажмите «Проверить в исходниках» в отчёте или списке решений. После просмотра нажмите «Вернуться к расхождению».
Почему контрольные суммы различаются?
Разницу могут создавать изменённые суммы, строки только в A/B, повторы и исключённые из анализа записи. Панель контроля раскладывает вклад по категориям.
Изменяются ли мои исходные Excel-файлы?
Нет. Match читает их в браузере и скачивает отдельные новые XLSX.
Отправляются ли данные на сервер?
Нет, содержимое файлов обрабатывается локально. Для первой загрузки страницы и библиотек может требоваться интернет.
Можно ли скачать результат, если не все решения приняты?
Да, как черновик. Нерешённые строки останутся без изменений и будут отмечены в протоколе; интерфейс показывает их количество.
Чем полный отчёт отличается от реестра решений?
Полный отчёт фиксирует категории автоматической сверки. Реестр решений фиксирует выбранные человеком действия и комментарии, а также содержит копии исходных строк для навигации.
Почему не сработало приблизительное совпадение названий?
Такой функции нет. Match использует строгий ключ после ограниченной технической нормализации. Для разных названий нужен общий стабильный идентификатор.