Facturae и FACe для WooCommerce — э-счета для испанских администраций

Facturae for WooCommerce делает из заказа магазина файл Facturae 3.2.2, который принимают испанские государственные администрации. Всё происходит на вашем сервере, без стороннего сервиса выставления счетов. На чекауте покупатель вписывает NIF/CIF и три кода DIR3 учреждения, а в заказе появляется блок «Facturae» с кнопками. Pro подписывает файл сертификатом вашего бизнеса и отправляет его в FACe, общую точку входа для э-счетов испанской государственной администрации.

Что делает бесплатная версия

На чекауте (классическом и блочном) появляются необязательные поля: NIF/CIF покупателя и три кода DIR3 — бухгалтерская служба (oficina contable), орган управления (órgano gestor) и подразделение обработки (unidad tramitadora). Контрольная буква испанского NIF проверяется. В заказе блок «Facturae» создаёт счёт: продавец и покупатель, позиции с количеством и ценой, купоны как скидки по строкам, доставка и сборы, налоги по ставкам, срок оплаты и IBAN. Поддерживаются IVA, IGIC (Канарские острова) и IPSI (Сеута и Мелилья). Каждый файл перед сохранением проверяется по официальной XSD Facturae 3.2.2, которая входит в плагин: файл, не прошедший проверку, не сохраняется, а причина показывается. Собственная серия и счётчик никогда не дают один номер дважды и не оставляют пропусков из-за отклонённого счёта. NIF, коды DIR3, орган-инициатор и reference expediente можно исправить в блоке заказа и создать счёт заново с тем же номером. XML скачивается с экрана заказа.

Что добавляет Pro

Сертификат вашего бизнеса (.p12/.pfx или PEM) подписывает счёт подписью XAdES по политике подписи Facturae; закрытый ключ хранится зашифрованным, пароль файла не хранится, а подпись проверяется сразу после создания. Возврат оплаченного заказа даёт исправительный счёт (factura rectificativa) в отдельной серии, указывающий на счёт, который он исправляет. Счёт можно создавать автоматически — по статусу заказа «Обрабатывается» или «Выполнен» — подписывать и прикладывать к письмам покупателю. Подписанный счёт отправляется в FACe (REST API поставщика): регистрационный номер и статус хранятся в заказе и каждый час обновляются, а запрос на аннулирование, с причиной или без, можно подать из заказа. Для этого нужны квалифицированный сертификат и регистрация интегратора на портале FACe. Есть zip-экспорт файлов выбранных заказов или за период и журнал: что подписано, отправлено и что ответили.

Что стоит знать заранее

• Файл, созданный бесплатной версией, не подписан: точки входа вроде FACe требуют подпись, поэтому его подписывают своим инструментом или Pro.
• Для подписи нужен квалифицированный сертификат бизнеса с закрытым ключом, который можно экспортировать (.p12/.pfx или PEM). Ключи EC не поддерживаются; старый .p12 с RC2 на OpenSSL 3 нужно экспортировать заново.
• Для FACe нужна регистрация интегратора на портале интеграторов FACe и добавление сертификата на платформу там. Без этого работают создание и подпись.
• По умолчанию среда FACe тестовая; production выбирается в настройках явно.
• Счёт — юридический документ: правильность сумм и налогов остаётся за магазином. Если итог счёта не совпадает с заказом, модуль предупреждает, но не блокирует.
• Не реализовано: recargo de equivalencia, удержание IRPF, освобождённые операции с правовым основанием, эквивалент в евро для иностранной валюты, вложения в FACe, репозиторий счетов FACe и FACeB2B.
• Период исправительного счёта (TaxPeriod) — календарный месяц исправляемого счёта; если нужен квартал, это меняет фильтр ccfe_corrective_data.
• Если другой плагин уже нумерует счета, для Facturae нужна отдельная серия.
• Рядом с нашим модулем Verifactu (записи для AEAT): они выполняют разные задачи — Verifactu передаёт записи в AEAT, Facturae — счета администрациям; NIF, сохранённый Verifactu, используется как запасной.

Как это работает, шаг за шагом

1. В WooCommerce → Facturae впишите данные бизнеса (NIF/CIF, название, адрес), серию и налог магазина и сохраните.
2. Покупатель указывает NIF и коды DIR3 на чекауте, либо вы вписываете их в блоке заказа.
3. В заказе нажмите «Создать счёт» и скачайте XML.
4. В Pro загрузите сертификат, подпишите счёт и нажмите «Отправить в FACe»; статус обновляется каждый час.

Под капотом

• Схемы Facturae 3.2.2 и xmldsig входят в плагин; создание и проверка счёта не обращаются к внешним сервисам.
• Транспорт FACe — REST API поставщика (/providers/v1) с токеном JWT RS256, подписанным вашим сертификатом.
• Закрытый ключ хранится зашифрованным (AES-256), пароль файла не хранится.
• Ежечасная проверка статусов берёт счета, которые проверяли давнее всего, поэтому открытые счета обходятся все.
• Классический и блочный чекаут, HPOS; языки: English, español.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → Facturae: впишите данные бизнеса, серию и сохраните.
3. Создайте счёт в заказе с NIF покупателя.
4. Для Pro на вкладке «Подпись и FACe» загрузите сертификат.

Модуля пока нет на wordpress.org: бесплатная версия и Pro — один архив с этой страницы. Без ключа он работает как бесплатная версия.