VeriFactu — Электронный биллинг

Pool-Control генерирует записи счетов, соответствующие VeriFactu: связанные отпечатки пальцев SHA-256, SOAP XML и QR-код в формате PDF.

Что реализовано

Функция	Статус
Отпечаток пальца и цепочка при выставлении счета	Доступно
XML VeriFactu (проект SOAP)	Доступно
QR-код проверки в PDF	Доступно
Загрузка XML из сведений о счете	Доступно
Исправления (кредит R1) со ссылкой на исходный счет	Доступно
Неизменяемость: не редактировать выставленные счета	Доступно
Сертифицировано компанией (.pfx)	Настройки → Компания → Сертификат VeriFactu
Отправляем в AEAT подготовку	Свидетельство арендатора +ALLOW_AEAT_SEND=confirmна сервере
Подпись XAdES	Ожидается (утвержденное производство)
Настоящее производство AEAT	Заблокировано (ALLOW_PROD+ XAdES)

Обычный поток

1. Создайте или создайте проект счета.
2. Просмотрите данные и нажмите Выдать — номер, отпечаток и XML назначены.
3. Счет-фактуру нельзя редактировать (исправляется только с помощью кредита).
4. Загрузите PDF (с QR) или XML.
5. Необязательно: Отправьте AEAT (PRE) из реквизита (только если сервер имеет сертификат от обязанного эмитента).

Требования к доставке AEAT

– Загрузите сертификат .pfx/.p12 ответственного эмитента в Настройки компании (NIF сертификата должен совпадать с NIF компании).

• Название компании = имя в переписи AEAT (должно соответствовать сертификату).
• NIF производителя программного обеспечения настроен в SuperAdmin → VeriFactu (отличается от NIF арендатора).
• Предварительная среда по умолчанию (verifactuProduction = false).
• В локальной разработке вы можете использоватьVERIFACTU_CERT_PATH(не в производстве рендеринга).
• При загрузке сертификата в настройках: вам сообщают о шифровании AES-256-GCM, назначении AEAT и возможности удаления; Подробности см. в политике конфиденциальности и настройках компании.

Матрица автоматического тестирования

Люкс	Что действительно
verifactu-hash.test.ts	След F1/F2/R1
verifactu-xml.test.ts	Получатель XML, цепочка
verifactu-aeat-response.test.ts	Правильный/неправильный парсер
verifactu-compliance.test.ts	Юридические правила API (неизменяемость, покупки без VF)
pnpm test:verifactu-xsd	Образцы XML (структура/XSD, если xmllint)
RUN_AEAT_INTEGRATION=1	Фактическая предварительная доставка (необязательно, без CI)

Внутренние тестовые аккаунты

Аккаунт	Поддомен	Использование
Публичная демо-версия	AquaDemo	Тестеры — фиктивные данные (демо CIF)
Лаборатория В.Ф.	vf-lab	VeriFactu тестирует реальные данные разработчиков, а не публичную демонстрацию

Лабораторный доступ (семена):admin@vf-lab.test/password123Команда для воссоздания динамических лабораторных данных:

cd packages/server && pnpm seed:vf-lab -- --reset

Покупки и VeriFactu

Счета-фактуры поставщика, квитанции, платежи поставщику и отмены покупок/кредиты в ERP не отправляются в AEAT в качестве регистрации VeriFactu.

Документ	VeriFactu от Pool-Control?	Причина
счет продажи (клиент)	Да — хэш, XML, QR, PRE-отправка	Вы являетесь обязательным эмитентом
Кредит / исправление продажа (R1)	Да	Исправить выставленный вами счет
счет поставщика (закупка)	Нет	Он зарегистрирован вашим провайдером; вы публикуете только чек
Оплата или отмена покупки	Нет	Это не регистрационная запись о выставленном вами счете

Если ваш поставщик обязан VeriFactu, он отправляет XML в Казначейство; Pool-Control не заменяет эту поставку.

Юридическая регистрация vs внутренний аудит

Слой	Что держит	Где это увидеть
Регистрация VeriFactu (обязательный эмитент)	Отпечаток SHA-256, цепочка, SOAP XML, статус AEAT	Счет-фактура выставлена: технические поля + загрузка XML
Бизнес-аудит	Кто выпустил, попытки редактирования заблокированы, материалы AEAT PRE	Настройки → Аудит (SETTINGS_VIEW_LOGS)

Соответствующие аудиторские действия:INVOICE_ISSUED,VERIFACTU_EDIT_BLOCKED,VERIFACTU_AEAT_SEND.

Экспортируемый журнал (массовый формат CSV/XML для проверки) ожидается; Сегодня техническая запись присутствует в каждом выставленном счете.

среда PRE до официальной регистрации в переписи населения

До тех пор, пока компания не будет зарегистрирована и данные AEAT не совпадут с сертификатом и названием компании:

– Используйте только предварительные версии (verifactuProduction = false, хозяинprewww1).

• Отгрузки только сALLOW_AEAT_SEND=confirmи надзор.
• Проверка в арендаторе vf-lab (не публичная демо-версия AquaDemo).
• Не активируйте производство AEAT илиALLOW_PRODв Рендере.

Когда официальная регистрация будет готова: сертификат арендатора в настройках, Исправление ПРЕДВАРИТЕЛЬНЫЙ тест из приложения, затем утверждение (XAdES) перед производством.

Исправить ≠ удалить

Выставленные счета-фактуры удалить невозможно. Чтобы исправить: используйте Исправить → кредит (R1) и, если применимо, новый счет.

Дополнительная информация

• Impuestos y modelos
• Обработка и исправление