Document V2 в Shopware: как проверить экспериментальное оформление документов
Что проверить перед использованием Document V2: область версии, исходный invoice, доступные форматы и различие отправки письма и отметки sent.
Содержание статьи
Document V2 в документации Shopware обозначен как экспериментальная функция для версии 6.7.14.0 или новее. Он требует отдельного включения технической командой и не должен восприниматься как уже действующий стандарт любого магазина. Руководство проверено 27 октября 2026 года; оно описывает процедуру оценки функции, а не устанавливает налоговые обязанности компании.
Проверьте область версии и способ включения
Документация указывает флаг DOCUMENT_GENERATION_REWORK. Наличие статьи в справке не подтверждает, что функция включена в вашей установке или совместима со всеми используемыми расширениями. Перед экспериментом согласуйте окружение проверки, ответственного и способ возвращения к прежнему процессу, если результат не подходит.
Используйте контрольные заказы с известными значениями и не начинайте с массовой генерации настоящих документов. Сначала зафиксируйте, где бизнес ведёт основной документальный учёт. Если номера и счета создаёт другая система, появление второго механизма не должно приводить к параллельному выпуску разных документов по одной продаже.
Проверьте основания для каждого типа документа
Для invoice необходим заказ. Credit note и cancellation invoice требуют уже существующего invoice; для credit note также нужны кредитовые строки. Delivery note предполагает дату доставки. Эти зависимости нельзя заменить одним общим статусом заказа: каждый документ должен иметь правильный исходный контекст.
Составьте матрицу контрольных случаев: обычный счёт, корректировка и документ доставки. В каждом сравните исходный заказ, позиции и выбранный тип. Отдельно проверьте, что команда понимает различие документа и перевода денег. Похожая граница разобрана в руководстве по credit slip PrestaShop; сам файл не доказывает завершения платёжного возврата.
Сверьте форматы и содержимое до создания
Document V2 предлагает форматы в зависимости от типа: для счетов и корректировок доступны PDF, HTML и варианты ZUGFeRD, а для delivery note — PDF и HTML. Предварительный просмотр помогает проверить адреса, строки, цены и разбивку страниц. Не считайте название формата подтверждением правильности всех хозяйственных сведений внутри.
Проверьте длинное наименование, несколько страниц и адрес с нетипичными символами. Сопоставьте сумму и валюту с исходной операцией. Если номер вводится вручную, согласуйте его с основным реестром. Красивый PDF может содержать неверный адрес или повторный номер, и эти ошибки не устраняются выбором другого формата выгрузки.
Различайте отправку и отметку о ней
В функции предусмотрены отдельные действия отправки по email и Mark as sent. Поэтому отметка «отправлено» не равна доказательству фактической доставки письма. При массовом создании также нужно осознанно выбирать пропуск существующих документов или принудительное повторное создание.
Сохраните контрольный файл и подтверждение выбранного маршрута отправки. Для автоматизации отдельно проверьте привязки и получателей Shopware Flow, прежде чем добавлять документы в массовые письма. Приёмка завершена после проверки исходных данных, форматов, нумерации и действительного результата отправки. Экспериментальный статус сохраняйте в инструкции команды до подтверждённого изменения документации; не скрывайте его за обычным названием кнопки.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы