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-денний тріал.