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 — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.