VeriFactu — 電子請求
Pool-Control は、VeriFactu 準拠の請求レコード (連鎖された SHA-256 フィンガープリント、SOAP XML、PDF 内の QR コード) を生成します。
実装される内容
| 機能 | ステータス |
|---|---|
| 請求書発行時の指紋とチェーン | 利用可能 |
| XML VeriFactu (SOAP ドラフト) | 利用可能 |
| PDF での検証 QR | 利用可能 |
| 請求書の詳細から XML をダウンロード | 利用可能 |
| 元の請求書を参照した修正 (R1 クレジット) | 利用可能 |
| 不変性: 発行された請求書を編集しないでください。利用可能 | |
| 企業認証済み (.pfx) | 設定 → 会社 → VeriFactu 証明書 |
| AEAT プリプロダクションに送信中 | テナント証明書+ALLOW_AEAT_SEND=confirmサーバー上 |
| XAdES 署名 | 保留中 (生産承認済み) |
| リアルAEAT制作 | ブロックされました (ALLOW_PROD+ XAdES) |
通常の流れ
- 請求書草案を作成または生成します。
- データを確認し、発行 を押します。番号、フィンガープリント、および XML が割り当てられます。
- 請求書は 編集できません (クレジットによる修正のみ)。
- PDF (QR 付き) または XML をダウンロードします。
- オプション: 詳細から AEAT (PRE) を送信します (サーバーに義務のある発行者からの証明書がある場合のみ)。
AEAT 配送の要件
- 会社設定で、義務のある発行者の**.pfx/.p12**証明書をアップロードします(証明書のNIFは会社のNIFと一致する必要があります)。
- 会社名 = AEAT国勢調査の名前(証明書と一致する必要があります)。
- ソフトウェア プロデューサーの NIF は SuperAdmin → VeriFactu で構成されます (テナントの NIF とは異なります)。
- デフォルトの 実稼働前 環境 (
verifactuProduction = false）。 - ローカル開発では使用できます
VERIFACTU_CERT_PATH(レンダリングプロダクションではありません)。 - 設定で証明書をアップロードすると、AES-256-GCM 暗号化、AEAT の目的、および削除の可能性について通知されます。詳細については、politica de privacidad および会社の設定をご覧ください。
自動テスト マトリックス
| スイート | 有効なもの |
|---|---|
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 サンプル (xmllint の場合は構造/XSD) |
RUN_AEAT_INTEGRATION=1 | 実際の PRE 配送 (オプション、CI なし) |
内部テスト アカウント
| アカウント | サブドメイン | 使い方 |
|---|---|---|
| 公開デモ | AquaDemo | テスター — 架空 データ (CIF デモ) |
| VF研究所 | vf-lab | VeriFactu は実際の開発者のデータを使用してテストします。公開デモではありません。 |
研究室へのアクセス (シード):admin@vf-lab.test/password123動的ラボ データを再作成するコマンド:
bash
cd packages/server && pnpm seed:vf-lab -- --reset購入と VeriFactu
ERP の サプライヤー請求書、領収書、サプライヤーへの支払い、購入キャンセル/クレジットは、VeriFactu 登録として AEAT に送信されません**。
| ドキュメント | Pool-Control の VeriFactu ですか? | 理由 |
|---|---|---|
| 販売 請求書 (顧客) | はい - ハッシュ、XML、QR、PRE 送信 | あなたは必須発行者です |
| クレジット / 修正 販売 (R1) | はい | 発行した請求書を修正する |
| サプライヤー 請求書 (購入) | いいえ | プロバイダーによって登録されています。領収書を郵送するだけです |
| 購入の支払いまたはキャンセル | いいえ | これは発行された請求書の登録記録ではありません |
サプライヤーが VeriFactu に義務を負っている場合、サプライヤーは XML を財務省に送信します。 Pool-Control はその出荷に代わるものではありません。
法的登録と内部監査
| レイヤー | 維持するもの | どこで見られますか |
|---|---|---|
| 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レンダリングで。
正式な登録の準備ができたら、[設定] でテナント証明書を作成し、アプリから 修正 PRE テストを行ってから、運用前に承認 (XAdES) を行います。
修正≠削除
発行された請求書は削除できません。修正するには: 修正 → クレジット (R1) を使用し、該当する場合は新しい請求書を使用します。