これまで sgcSign が署名するのは、アプリケーション側で自前で作成しなければならない請求書 XML でした。国別プロファイルは Facturae、FatturaPA、TicketBAI のファイルへの署名方法を知っていましたが、ファイルが先に存在している必要があり、それを書くのは開発者の仕事でした。
sgcSign 2026.12 からは、ライブラリが請求書の作成も行います。型付きの請求書に値を設定すると、ライブラリが合計を計算し、ビジネスルールを検査し、受領者または税務当局が求める形式で文書を書き出します。国別プロファイルがその結果に署名し、3つのクライアントが送信します。この記事で説明する機能はすべて sgcSign 2026.12 から、Delphi 7 から Delphi 13 および .NET で利用でき、sgcSign に含まれています。
1分でわかる sgcSign の電子インボイス:インボイスモデル、フォーマット、検証、Peppol 送信。 YouTubeでも公開中。
EN 16931 に基づく型付き請求書
TsgcInvoice は EN 16931 セマンティックデータモデルを型として表現したモデルです。売り手、買い手、受取人、支払い、明細行、値引きと追加料金、付加価値税 (VAT) の内訳、合計を保持します。モデルは XML を保持しないため、同じ請求書を複数の構文で書き出せます。CalculateTotals が明細行の正味金額、VAT の内訳、文書の合計を埋めるので、アプリケーションは数量、単価、VAT 率を設定するだけで、自分で合算する必要はありません。
TsgcInvoiceUBL は UBL 2.1 の Invoice と CreditNote を書き込み、読み込みます。TsgcInvoiceCII は UN/CEFACT Cross Industry Invoice D16B を書き込み、読み込みます。次の例では、請求書に値を設定し、合計を計算し、EN 16931 のルールを検査して、UBL 2.1 ファイルを書き出します。
uses
Classes, SysUtils,
sgcSign_Invoice, sgcSign_Invoice_UBL, sgcSign_Invoice_Validator;
procedure CreateInvoice;
var
oInvoice: TsgcInvoice;
oLine: TsgcInvoiceLine;
oValidator: TsgcInvoiceValidator;
oUBL: TsgcInvoiceUBL;
begin
oInvoice := TsgcInvoice.Create;
oValidator := TsgcInvoiceValidator.Create;
oUBL := TsgcInvoiceUBL.Create;
try
oInvoice.Number := 'INV-2026-0001';
oInvoice.IssueDate := EncodeDate(2026, 11, 11);
oInvoice.DueDate := EncodeDate(2026, 12, 11);
oInvoice.CurrencyCode := 'EUR';
oInvoice.SpecificationIdentifier :=
CS_SGC_INVOICE_UBL_CUSTOMIZATION_EN16931;
oInvoice.BuyerReference := 'PO-7781';
oInvoice.Seller.Name := 'Seller Company SL';
oInvoice.Seller.VATID := 'ESB12345674';
oInvoice.Seller.Address.City := 'Madrid';
oInvoice.Seller.Address.CountryCode := 'ES';
oInvoice.Buyer.Name := 'Buyer Company GmbH';
oInvoice.Buyer.VATID := 'DE123456789';
oInvoice.Buyer.Address.City := 'Berlin';
oInvoice.Buyer.Address.CountryCode := 'DE';
oLine := oInvoice.Lines.Add;
oLine.ID := '1';
oLine.Item.Name := 'Consulting';
oLine.Quantity := 10;
oLine.UnitCode := CS_SGC_INVOICE_UNIT_HOUR;
oLine.Price.NetPrice := 85;
oLine.VATCategoryCode := CS_SGC_INVOICE_VAT_STANDARD;
oLine.VATRate := 21;
// line amounts, VAT breakdown and totals
oInvoice.CalculateTotals;
// EN 16931 business rules
if not oValidator.Validate(oInvoice) then
raise Exception.Create(oValidator.AsText);
// UBL 2.1 document
oUBL.WriteToFile(oInvoice, 'invoice.xml');
finally
oUBL.Free;
oValidator.Free;
oInvoice.Free;
end;
end;
XRechnung、Peppol BIS、Factur-X
多くの受領者は、素の EN 16931 ではなく、そのプロファイルを求めます。sgcSign 2026.12 は、同じモデルから次の3つを書き込み、読み込みます。
- XRechnung、UBL または CII 構文。
- Peppol BIS Billing 3.0、UBL 構文。
- Factur-X / ZUGFeRD、5つのプロファイル (Minimum、Basic WL、Basic、EN 16931、Extended) の XML。
TsgcInvoiceFacturXを使用します。
プロファイルで書き出しても請求書は変わらないため、1つのモデルをある顧客には XRechnung として、次の顧客には Peppol BIS として書き出せます。請求書を受け取ったときは、sgcInvoiceReadAny がファイルの構文とプロファイルを検出し、モデルに読み込みます。
公式ルール ID による検証
TsgcInvoiceValidator は、請求書を EN 16931 のビジネスルールに照らして検査し、指定すれば XRechnung と Peppol BIS Billing 3.0 のルールセットでも検査します。ルールはネイティブにコーディングされており、XML を書き出す前にモデル上で実行されます。すべてのメッセージには、公式のルール識別子、重大度、ビジネス用語、モデル内のフィールドのパス、ルールの文面が含まれるため、アプリケーションはどのフィールドを修正すべきかをユーザーに示せます。
次の例では、同じ請求書を2回検証します。まず EN 16931 のルールに合格し、次に XRechnung として検査すると、コアモデルでは必須でない売り手の連絡先が求められます。FillInvoice は最初の例の請求書に値を設定し、XRechnung が必須とする両当事者の住所の番地と郵便番号、および SEPA クレジット振込を追加します。Log は1行を出力します。
uses
SysUtils, Classes,
sgcSign_Invoice, sgcSign_Invoice_Validator, sgcSign_Invoice_Variants;
procedure RuleSetsSample;
var
oInvoice: TsgcInvoice;
oValidator: TsgcInvoiceValidator;
i: Integer;
begin
oInvoice := TsgcInvoice.Create;
oValidator := TsgcInvoiceValidator.Create;
try
FillInvoice(oInvoice);
oInvoice.CalculateTotals;
Log(BoolToStr(oValidator.Validate(oInvoice), True)); // True
// the same invoice as XRechnung
sgcInvoiceApplyVariant(oInvoice, ivXRechnung, isUBL);
oValidator.RuleSets := [vrsEN16931, vrsXRechnung];
if not oValidator.Validate(oInvoice) then
for i := 0 to oValidator.Messages.Count - 1 do
Log(oValidator.Messages[i].RuleID + ' ' + oValidator.Messages[i].Path);
// what XRechnung asks for and the core model does not
oInvoice.Seller.Contact.Name := 'Ana Lopez';
oInvoice.Seller.Contact.Telephone := '+34 910 000 000';
oInvoice.Seller.Contact.Email := 'ana@seller.example';
oInvoice.Delivery.ActualDeliveryDate := EncodeDate(2026, 11, 10);
Log(BoolToStr(oValidator.Validate(oInvoice), True)); // True
Log(IntToStr(oValidator.WarningCount)); // 0
finally
oValidator.Free;
oInvoice.Free;
end;
end;
2回目の検証では、BR-DE-2 Seller.Contact と BR-DE-TMP-32 Delivery.ActualDeliveryDate の2つのメッセージが出力されます。前者は致命的エラー、後者は警告です。連絡先と納品日を設定すると、請求書は警告なしで合格します。
国別フォーマット
3つの国は独自の請求書フォーマットを使用しており、それぞれに同じ TsgcInvoice を受け取るライターがあります。
- Facturae、スペイン:
TsgcInvoiceFacturaeはバージョン 3.2、3.2.1、3.2.2 を書き出します。 - FatturaPA、イタリア:
TsgcInvoiceFatturaPAは、民間の受領者向け (FPR12) と公的機関向け (FPA12) のバージョン 1.2.3 を書き出します。 - KSeF、ポーランド:
TsgcInvoiceKSeFは構造化請求書、つまりスキーマ FA(3) を書き出します。
スペインの2つの税務システムにも対応しています。
- VeriFactu:
TsgcInvoiceVeriFactuは、連鎖した SHA-256 ハッシュ付きの登録レコードと取消レコードを作成し、レコード間のチェーンを維持し、QR コードの URL と画像を生成します。 - TicketBAI:
TsgcInvoiceTicketBAIは、直前の請求書へのチェーンを持つ 1.2.2 の請求書ファイルと取消ファイルを作成します。署名後は TBAI 識別子と QR コードを返します。
| フォーマット | クラス | 書き込み | 読み込み |
|---|---|---|---|
| UBL 2.1 の Invoice と CreditNote | TsgcInvoiceUBL | はい | はい |
| UN/CEFACT CII D16B | TsgcInvoiceCII | はい | はい |
| XRechnung、UBL または CII | TsgcInvoiceDocument | はい | はい |
| Peppol BIS Billing 3.0、UBL | TsgcInvoiceDocument | はい | はい |
| Factur-X / ZUGFeRD XML、5つのプロファイル | TsgcInvoiceFacturX | はい | はい |
| Facturae 3.2、3.2.1、3.2.2 | TsgcInvoiceFacturae | はい | いいえ |
| FatturaPA 1.2.3 | TsgcInvoiceFatturaPA | はい | いいえ |
| KSeF FA(3) | TsgcInvoiceKSeF | はい | いいえ |
| VeriFactu レコード | TsgcInvoiceVeriFactu | はい | いいえ |
| TicketBAI 1.2.2 | TsgcInvoiceTicketBAI | はい | いいえ |
請求書の送信
3つのクライアントが、文書を税務当局に届けます。
TsgcVeriFactuClientは、VeriFactu レコードを AEAT の Web サービスに送信します。各レコードの結果を読み取り、レコード数の上限と送信間の待ち時間を適用し、送信済みレコードを照会し、受領書を保存します。TsgcSdIClientは、FatturaPA ファイルをイタリアの Sistema di Interscambio (SdI) の Web サービスに送信し、ファイル名の規則を確認し、SdI が返す通知ファイルを読み取ります。TsgcKSeFOnlineClientは、対話型セッションで KSeF に請求書を送信します。セッションを開き、請求書を送信し、そのステータスと KSeF 番号を読み取り、セッションを閉じ、UPO 受領書をダウンロードします。
Peppol ネットワークでの送信
バージョン 2026.12 では、Delphi と .NET で請求書を Peppol ネットワークで送信することもできます。各部分は独立したクラスなので、フロー全体を使うことも、その中の 1 ステップだけを使うこともできます。
TsgcPeppolSMPClientは、SML と SMP で参加者を検索し、署名された SMP 応答を検証します。TsgcPeppolSBDHとsgcPeppolWrapInvoiceは、Peppol のビジネスメッセージエンベロープである SBDH を書き出します。TsgcPeppolAS4MessageとTsgcPeppolAS4Receiptは、Peppol AS4 プロファイルの AS4 メッセージを実装します。RSA-SHA256 で署名し、ペイロードは gzip で圧縮して AES-128-GCM で暗号化し、鍵の転送には RSA-OAEP を使います。TsgcPeppolClientは、SendInvoiceとResendにより、検索、エンベロープ、送信、受領書の検証を 1 回の呼び出しで行います。署名された受領書を保存し、エラーコード付きの結果オブジェクトを返します。
外部ライブラリは不要です。暗号処理、XML、AS4 のコードはライブラリに含まれており、Delphi 7 から Delphi 13 で利用できます。次の例では、TsgcPeppolClient で請求書ファイルを送信します。
uses
Classes, SysUtils,
sgcSign_Interfaces, sgcSign_Peppol_Client;
procedure SendInvoiceToPeppol(const aAccessPointKey: IsgcKeyProvider);
var
oClient: TsgcPeppolClient;
oResult: TsgcPeppolSendResult;
begin
oClient := TsgcPeppolClient.Create(nil);
oResult := TsgcPeppolSendResult.Create;
try
// key and certificate of the sending access point
oClient.KeyProvider := aAccessPointKey;
oClient.TestNetwork := True;
// the company that issues the invoice and its country
oClient.SenderID := '0088:7315458756324';
oClient.CountryC1 := 'ES';
// lookup, envelope, AS4 message, POST and receipt in one call
if oClient.SendInvoiceFile('invoice.xml', '9915:receiver', oResult) then
WriteLn('Delivered, message ' + oResult.MessageId)
else
WriteLn(oResult.ErrorCode + ': ' + oResult.ErrorText);
finally
oResult.Free;
oClient.Free;
end;
end;
プロジェクトを計画する前に、要件を確認してください。Peppol ネットワークで送信するには、OpenPeppol が発行したアクセスポイント証明書を持つ、認定された Peppol アクセスポイント (サービスプロバイダー) である必要があります。ライブラリはプロトコルを実装しますが、証明書や認定は提供しません。サービスプロバイダーを利用している企業は、通常そのプロバイダー経由で送信します。ライブラリは送信のみを行います。受信アクセスポイントと Peppol レポートはありません。参加者の検索に証明書は不要です。
送信側は、オープンソースの phase4 AS4 サーバー (バージョン 4.9.0) を相手に、ローカルのテスト PKI で相互運用性をテストしました。Delphi と .NET のライブラリのどちらでも、すべてのメッセージが受理され、すべての受領書が検証されました。本番のアクセスポイントや実際の Peppol 証明書では実行していません。デモ Demos\Delphi\Peppol と Demos\CBuilder\Peppol はライブラリに付属しています。
フロー全体を担う1つのコンポーネント
TsgcInvoiceDocument がこれらの手順をまとめます。フォーマットを選び、請求書に値を設定し、Build を呼び出します。コンポーネントは合計を計算し、そのフォーマットのルールセットで検証し、文書を書き出し、そのフォーマットの署名プロファイルで署名します。検証に失敗した場合は何も書き出されず、文書への署名にはどの sgcSign キープロバイダーも使用できます。
次の例では、EN 16931 プロファイルの Factur-X XML を書き出し、PFX ファイルの証明書で署名します。
uses
Classes, SysUtils,
sgcSign_Types, sgcSign_KeyProvider_PFX,
sgcSign_Invoice, sgcSign_Invoice_Document;
procedure BuildSignedInvoice;
var
oKeyProvider: TsgcPFXKeyProvider;
oDocument: TsgcInvoiceDocument;
begin
oKeyProvider := TsgcPFXKeyProvider.Create(nil);
oDocument := TsgcInvoiceDocument.Create(nil);
try
oKeyProvider.FileName := 'certificate.pfx';
oKeyProvider.Password := 'secret';
oKeyProvider.LoadFromFile;
// FillInvoice sets seller, buyer and lines as in the previous example
FillInvoice(oDocument.Invoice);
oDocument.Format := ifFacturXEN16931;
oDocument.Sign := True;
oDocument.KeyProvider := oKeyProvider;
// totals, validation, Factur-X XML and XAdES signature
oDocument.BuildToFile('factur-x.xml');
finally
oDocument.Free;
oKeyProvider.Free;
end;
end;
このコンポーネントは読み込みにも対応しています。LoadFromFile は UBL または CII のファイルを受け取り、Format をそのファイルの形式に設定してモデルに値を設定するため、受信した請求書を検証し、別の構文で書き直すことができます。
含まれないもの
この最初のバージョンの範囲には制限があり、それを踏まえてプロジェクトを計画する前に知っておくことをお勧めします。
- 国別フォーマットは書き込み専用です。 UBL と CII は、XRechnung、Peppol BIS、Factur-X のバリエーションも含めて、モデルに読み戻せます。Facturae、FatturaPA、KSeF、VeriFactu、TicketBAI は読み戻せません。
- Peppol での送信には認定されたアクセスポイントが必要で、送信のみです。 ライブラリはプロトコルを実装しますが、アクセスポイント証明書や認定は提供しません。受信アクセスポイントと Peppol レポートはありません。
- Factur-X は XML のみです。 Factur-X または ZUGFeRD の請求書は、この XML を埋め込んだ PDF/A-3 ファイルです。コンポーネントは XML を書き出しますが、PDF/A-3 ファイルへの埋め込みは行いません。
- KSeF の請求書は、コンポーネントが送信するだけで署名はしません。 KSeF は請求書 XML に署名しないためです。
- SdI のエンドポイントは組み込まれていません。 SdI は、チャネルの認定時に送信者へエンドポイントを通知するため、クライアントに設定してください。
入手方法
電子インボイスは、バージョン 2026.12 から sgcSign の一部です。別エディションではありません。各ユニットは完全なソースコード付きで sgcSign に同梱され、Delphi 7 から Delphi 13 および .NET で利用できます。Demos フォルダーの新しい EInvoice デモは、フォームで1つの型付き請求書に値を設定し、1つのコンポーネントで各フォーマットに合わせて作成します。
製品ページの電子インボイス · トライアル版のダウンロード · 変更履歴
ご質問やご意見はありますか。お問い合わせください。コードを書いた本人たちが返信します。
