FatturaPA SdI для WooCommerce — итальянские е-счета FatturaPA из заказов, с проверкой по официальной XSD

FatturaPA SdI для WooCommerce — плагин для магазинов в Италии, которые продают на WooCommerce и выставляют электронные счета через Sistema di Interscambio (SdI) налоговой службы Agenzia delle Entrate. Плагин превращает заказ в счёт в официальном формате FatturaPA 1.2.3 для частного сектора (FPR12, «fattura ordinaria»), проверяет его по официальной XSD-схеме и помогает доставить в SdI — без платного сервиса счетов посередине и без ежемесячной подписки. Журнал счетов, XML с именем по правилам SdI и квитанции SdI хранятся в магазине.

Как счёт попадает в SdI. Прямой канал SdI (web service или SFTP) плагин не использует: для него нужна отдельная аккредитация, которой у магазина обычно нет. В бесплатной версии вы загружаете готовый XML в SdI сами — например, в кабинете «Fatture e corrispettivi» — и потом загружаете в плагин XML-квитанцию, которую вернул SdI. В Pro плагин отправляет счёт с вашего PEC-ящика (канал, открытый для любой фирмы) и сам читает из него квитанции, или передаёт XML вашему посреднику через webhook.

Что нужно от вас. Итальянская фирма или ИП с Partita IVA; налоги WooCommerce с итальянскими ставками; цены в EUR. Для отправки в Pro — ваш PEC-ящик с доступом SMTP и IMAP от вашего провайдера или посредник, который принимает XML по адресу webhook.

Честно о проверке. Плагин проверен на локальном магазине WooCommerce на PHP 8.3 и 7.4: 153 проверки в браузере, классический и блочный чекаут, админка на английском и итальянском. Каждый XML из тестовых заказов — фирмы с кодом SDI, покупатели с CF, PEC, forfettario с болом, кредит-ноты, иностранные покупатели — прошёл официальную XSD-схему FatturaPA 1.2.3 двумя независимыми валидаторами. PEC-канал проверен на тестовом почтовом сервере (настоящие SMTP и IMAP), а квитанции SdI собраны по официальной схеме сообщений. С настоящим SdI и настоящими PEC-провайдерами плагин ещё не работал: для этого нужен PEC-ящик итальянской фирмы. Начните с триала Pro на своей фирме — если SdI ответит не так, как описано в спецификации, исправим оперативно.

Ответственность за содержание счёта остаётся за продавцом. Плагин строит счёт из данных заказа WooCommerce и из настроек, которые вы выбираете: коды Natura для строк без НДС, ссылки на закон, бол, режим «когда выставлять счёт», иностранные покупатели. Это решение вашего commercialista — покажите ему настройки до первого настоящего счёта.

Что получает админ

• WooCommerce → FatturaPA: вкладки «Invoices», «Settings» и «Licence».
• Журнал счетов: номер и тип документа (счёт или кредит-нота), заказ, покупатель с CF или P.IVA, сумма, статус, имя файла и Id SdI; фильтр по статусу и поиск по номеру, файлу, Id SdI, покупателю или заказу. Ссылки на детали с полным XML и на скачивание файла.
• «Send / read receipts now» (Pro) отправляет очередь и читает квитанции сразу, не дожидаясь крона.
• Уведомления вверху админки: как сейчас идут счета в SdI, сколько ещё не передано, отклонённые или недоставленные счета, последняя проблема с отправкой.

В каждом заказе — блок «FatturaPA»: номер счёта, статус, имя XML-файла и действия — «Details», «XML», «Mark as uploaded», «Rebuild», «Discard». Для заказа без счёта — кнопка «Create FatturaPA» или причина, почему счёт не создан. Заметки заказа фиксируют каждый шаг: счёт создан, передан, доставлен или отклонён с кодом ошибки.

Счёт, который SdI отклонил (квитанция NS), считается не выставленным. Список ошибок из квитанции виден в журнале и в заметках заказа. Исправили заказ — «Rebuild and send» перестраивает счёт с тем же номером и датой и новым именем файла, как требует SdI; ненужный — «Discard».

Как это выглядит для покупателя

На чекауте появляется галочка «I need an invoice (fattura elettronica)». Пока она не поставлена, поля счёта скрыты и заказ оформляется как обычный. После галочки — Codice fiscale, Partita IVA, Codice destinatario SDI, PEC и, пока WooCommerce скрывает своё поле «Компания», «Company name (for the invoice)». Для адреса за пределами Италии поля SDI и PEC скрываются.

• Codice fiscale проверяется по контрольному символу с учётом omocodia; Partita IVA — по контрольной цифре, префикс IT убирается сам.
• Partita IVA без названия фирмы не проходит; код SDI — ровно 7 букв или цифр; адрес SdI (@pec.fatturapa.it) в качестве PEC покупателя плагин не принимает.
• Покупатель ввёл CF строчными буквами — в счёте он будет заглавными.
• Работает на классическом и блочном чекауте. В блочном поля скрываются до галочки на WooCommerce 9.9+; на более старых версиях они видны всегда, а серверные проверки те же.

Если данные для счёта уже собирает другой плагин, поля можно отключить: плагин прочитает известные мета-поля заказа с CF, P.IVA, кодом SDI и PEC.

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

1. Продавец. WooCommerce → FatturaPA → Settings: Partita IVA, название фирмы или имя физлица, RegimeFiscale, адрес с CAP и провинцией, REA для компаний, IBAN для банковского перевода.
2. Нумерация. Формат номера, например WEB{N}/{YYYY} со счётчиком, который начинается с 1 каждый год. SdI отклоняет второй счёт с тем же номером за год — поэтому год в формате лучше оставить.
3. НДС и Natura. Ставки берутся из налогов WooCommerce каждого заказа; для строк без НДС выбираете код Natura и, при необходимости, свою ссылку на закон.
4. Канал. Free — ручная загрузка. Pro — PEC: адрес, SMTP- и IMAP-серверы провайдера, пароль и кнопка «Test the PEC connection». Или посредник: адрес webhook и токен.
5. Статус заказа. Заказ становится «Выполнен» (или «В обработке» — как выберете) — плагин проверяет данные по офлайн-контролям SdI, строит XML со следующим номером и проверяет его по XSD. Номер не тратится, пока данные не пройдут проверку.
6. Доставка в SdI. Free: загружаете XML в SdI и нажимаете «Mark as uploaded». Pro: плагин отправляет письмо с XML на адрес SdI; первый счёт уходит на sdi01@pec.fatturapa.it, дальше — на адрес, с которого ответил SdI.
7. Квитанция. RC — счёт доставлен; NS — отклонён со списком ошибок; MC — не доставлен покупателю, счёт выставлен и лежит в его кабинете. Free: загружаете XML-квитанции в журнал (несколько за раз, распознаются по имени файла). Pro: плагин читает их из PEC-ящика сам.
8. Сбои. PEC-сервер недоступен — счёт ждёт в очереди и повторяется с паузой от 5 минут до 12 часов. Неверный пароль — счёт помечается сбоем без повторов, а в админке появляется уведомление.

В бесплатной версии журнал подсказывает, что делать: загрузить каждый XML в SdI, отметить «Mark as uploaded» и записать квитанцию. Та же квитанция, загруженная повторно, ничего не меняет, а поздняя квитанция к старому файлу не перебивает статус текущего.

НДС и бол. Несколько ставок в одном счёте, итоги по каждой ставке и коду Natura, округление до суммы заказа. Для продавца forfettario (RF19) и minimi (RF02) все строки идут без НДС с кодом N2.2 и ссылкой на закон. Когда строки без НДС (N2.1, N2.2, N3.5, N3.6, N4) вместе превышают 77,47 EUR, в счёт добавляется BolloVirtuale 2 EUR — сам бол вы платите ежеквартально через F24.

Pro. Возврат WooCommerce — по позициям или суммой — даёт кредит-ноту TD04 со ссылкой на счёт (DatiFattureCollegate). Кредит-нота создаётся автоматически, когда у счёта уже есть квитанция RC или MC; иначе — кнопкой «Create credit note» в заказе. Покупатели за пределами Италии получают код XXXXXXX, иностранный VAT или идентификатор клиента магазина, CAP 00000 и коды Natura, выбранные вами для продаж фирмам ЕС, экспорта и услуг. Заказы с налоговой ставкой другой страны ЕС (OSS) плагин не выставляет и объясняет причину.

В «Мой аккаунт» покупатель видит счёт, переданный в SdI, и скачивает копию (copia di cortesia) — только владелец заказа. Продавцу forfettario Pro может добавить бол 2 EUR в корзину отдельной строкой, когда сумма без НДС превышает порог.

Что под капотом

• FatturaPA 1.2.3, FPR12 по спецификациям Agenzia delle Entrate 1.9.1: счёт TD01 и кредит-нота TD04. Официальная XSD-схема лежит в плагине, поэтому проверка идёт локально, без сети.
• Офлайн-контроли SdI до номера: соответствие Natura и ставки, суммы и округление, идентификатор покупателя, код получателя и PEC, обобщённые коды Natura, которые SdI отклоняет. Только после них счёт получает номер и проходит XSD.
• Имена файлов — IT + codice fiscale трансмиттента + прогрессив; каждая повторная отправка получает новое имя. Серию букв прогрессива можно изменить, если тот же codice fiscale использует ещё и другая программа.
• PEC в Pro: SMTP через PHPMailer из WordPress, IMAP собственным клиентом (расширение php-imap не нужно), разбор конверта PEC до XML-квитанции. Пароли ящика и токены хранятся зашифрованными (AES-256 с ключами сайта).
• Посредник в Pro: POST XML на ваш адрес с токеном Bearer и заголовками X-FatturaPA-*; квитанции возвращаются на REST-адрес /wp-json/ccfp/v1/receipt с токеном.
• Квитанции SdI хранятся в базе данных магазина, а не файлами в wp-content/uploads, поэтому прямой ссылки на них нет. Скачать их может только менеджер магазина из админки; бэкап базы — это и бэкап квитанций.
• Нумерация с блокировкой: два заказа в одну секунду не получат одинаковый номер; у кредит-нот свой счётчик.
• Режим имитации: константа CCFP_SDI_MOCK в wp-config.php моделирует ответы SdI (rc, ns, mc, silent, down, auth) — ничего не уходит с сайта.
• Удаление плагина убирает пароли, токены и кроны; журнал счетов и квитанции остаются как бухгалтерские записи. Константа CCFP_DELETE_DATA убирает всё.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите fatturapa-sdi-for-woocommerce-1.0.0.zip и активируйте (WooCommerce должен быть активен).
2. WooCommerce → FatturaPA → Settings: данные продавца (Partita IVA, название, RegimeFiscale, адрес с CAP и провинцией), нумерация, настройки НДС и Natura.
3. Выберите, какие заказы получают счёт: фирмы и покупатели с галочкой, каждый заказ или данные из другого плагина.
4. Выберите канал: ручная загрузка (Free) или PEC либо посредник (Pro). Для PEC — «Test the PEC connection».
5. Включите «Create FatturaPA invoices», оформите тестовый заказ с галочкой счёта и переведите его в «Выполнен» — счёт появится в журнале и в заказе.
6. Покажите настройки НДС, Natura и бола бухгалтеру до первого настоящего счёта.
7. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал.