sgcSign 2026.12 の電子インボイス: 請求書の作成、検証、署名

· コンポーネント
sgcSign 2026.12 の電子インボイス、Delphi と .NET での請求書の作成、検証、署名

これまで 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つを書き込み、読み込みます。

プロファイルで書き出しても請求書は変わらないため、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 を受け取るライターがあります。

スペインの2つの税務システムにも対応しています。

フォーマットクラス書き込み読み込み
UBL 2.1 の Invoice と CreditNoteTsgcInvoiceUBLはいはい
UN/CEFACT CII D16BTsgcInvoiceCIIはいはい
XRechnung、UBL または CIITsgcInvoiceDocumentはいはい
Peppol BIS Billing 3.0、UBLTsgcInvoiceDocumentはいはい
Factur-X / ZUGFeRD XML、5つのプロファイルTsgcInvoiceFacturXはいはい
Facturae 3.2、3.2.1、3.2.2TsgcInvoiceFacturaeはいいいえ
FatturaPA 1.2.3TsgcInvoiceFatturaPAはいいいえ
KSeF FA(3)TsgcInvoiceKSeFはいいいえ
VeriFactu レコードTsgcInvoiceVeriFactuはいいいえ
TicketBAI 1.2.2TsgcInvoiceTicketBAIはいいいえ

請求書の送信

3つのクライアントが、文書を税務当局に届けます。

Peppol ネットワークでの送信

バージョン 2026.12 では、Delphi と .NET で請求書を Peppol ネットワークで送信することもできます。各部分は独立したクラスなので、フロー全体を使うことも、その中の 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 をそのファイルの形式に設定してモデルに値を設定するため、受信した請求書を検証し、別の構文で書き直すことができます。

含まれないもの

この最初のバージョンの範囲には制限があり、それを踏まえてプロジェクトを計画する前に知っておくことをお勧めします。

入手方法

電子インボイスは、バージョン 2026.12 から sgcSign の一部です。別エディションではありません。各ユニットは完全なソースコード付きで sgcSign に同梱され、Delphi 7 から Delphi 13 および .NET で利用できます。Demos フォルダーの新しい EInvoice デモは、フォームで1つの型付き請求書に値を設定し、1つのコンポーネントで各フォーマットに合わせて作成します。

製品ページの電子インボイス · トライアル版のダウンロード · 変更履歴

ご質問やご意見はありますか。お問い合わせください。コードを書いた本人たちが返信します。