sgcSign 2026.12의 전자 인보이스: 인보이스 작성, 검증, 서명

· 컴포넌트
sgcSign 2026.12의 전자 인보이스, Delphi와 .NET에서 인보이스 작성, 검증, 서명

지금까지 sgcSign은 애플리케이션이 직접 만들어야 하는 인보이스 XML에 서명하는 역할만 했습니다. 국가별 프로필은 Facturae, FatturaPA, TicketBAI 파일에 서명하는 방법을 알고 있었지만 파일이 먼저 존재해야 했고, 그 파일을 작성하는 일은 개발자의 몫이었습니다.

sgcSign 2026.12부터 라이브러리가 인보이스도 직접 만듭니다. 형식이 지정된 인보이스를 채우면 라이브러리가 합계를 계산하고, 비즈니스 규칙을 검사하고, 수신자나 세무 당국이 요구하는 형식으로 문서를 작성합니다. 국가별 프로필이 그 결과물에 서명하고, 세 가지 클라이언트가 전송합니다. 이 글에서 설명하는 모든 기능은 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는 같은 모델에서 세 가지 프로필을 쓰고 읽습니다.

프로필로 작성해도 인보이스는 바뀌지 않으므로, 하나의 모델을 한 고객에게는 XRechnung으로, 다음 고객에게는 Peppol BIS로 작성할 수 있습니다. 인보이스를 받으면 sgcInvoiceReadAny가 파일의 구문과 프로필을 감지하여 모델에 불러옵니다.

공식 규칙 ID를 사용하는 검증

TsgcInvoiceValidator는 인보이스를 EN 16931 비즈니스 규칙으로 검사하며, 요청하면 XRechnung 및 Peppol BIS Billing 3.0 규칙 세트로도 검사합니다. 규칙은 네이티브로 코딩되어 있고 XML을 작성하기 전에 모델에서 실행됩니다. 모든 메시지에는 공식 규칙 식별자, 심각도, 비즈니스 용어, 모델 내 필드 경로, 규칙 텍스트가 담겨 있어서 애플리케이션이 사용자에게 어떤 필드를 고쳐야 하는지 보여줄 수 있습니다.

아래 예제는 같은 인보이스를 두 번 검증합니다. 먼저 EN 16931 규칙을 통과하고, 그다음 XRechnung으로 검사하면 핵심 모델에는 필요 없는 판매자 연락처를 요구합니다. FillInvoice는 첫 번째 예제의 인보이스를 채우고, 양쪽 당사자의 거리 주소와 우편번호, 그리고 XRechnung이 요구하는 SEPA 계좌 이체를 추가합니다. Log는 한 줄을 출력합니다.

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;

두 번째 검증은 BR-DE-2 Seller.Contact와 BR-DE-TMP-32 Delivery.ActualDeliveryDate 두 개의 메시지를 출력합니다. 첫 번째는 치명적 오류이고, 두 번째는 경고입니다. 연락처와 배송일을 설정하면 인보이스는 경고 없이 통과합니다.

국가별 형식

세 나라는 자체 인보이스 형식을 사용하며, 각각 같은 TsgcInvoice를 받는 라이터가 있습니다.

스페인의 두 가지 세무 시스템도 지원합니다.

형식클래스쓰기읽기
UBL 2.1 Invoice 및 CreditNoteTsgcInvoiceUBL예예
UN/CEFACT CII D16BTsgcInvoiceCII예예
XRechnung, UBL 또는 CIITsgcInvoiceDocument예예
Peppol BIS Billing 3.0, UBLTsgcInvoiceDocument예예
Factur-X / ZUGFeRD XML, 다섯 가지 프로필TsgcInvoiceFacturX예예
Facturae 3.2, 3.2.1, 3.2.2TsgcInvoiceFacturae예아니요
FatturaPA 1.2.3TsgcInvoiceFatturaPA예아니요
KSeF FA(3)TsgcInvoiceKSeF예아니요
VeriFactu 레코드TsgcInvoiceVeriFactu예아니요
TicketBAI 1.2.2TsgcInvoiceTicketBAI예아니요

인보이스 전송

세 가지 클라이언트가 문서를 세무 당국에 전달합니다.

Peppol 네트워크 전송

2026.12 버전은 Delphi와 .NET에서 인보이스를 Peppol 네트워크로 전송하는 기능도 제공합니다. 각 부분은 별도의 클래스이므로 전체 흐름을 사용해도 되고 그중 한 단계만 사용해도 됩니다.

외부 라이브러리는 필요 없습니다. 암호화, 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 데모는 라이브러리에 포함되어 있습니다.

전체 흐름을 위한 하나의 컴포넌트

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 데모는 폼에서 하나의 타입 인보이스를 채우고 단일 컴포넌트로 각 형식에 맞게 빌드합니다.

제품 페이지의 전자 인보이스 · 평가판 다운로드 · 변경 내역

질문이나 의견이 있으신가요? 문의해 주세요. 코드를 작성한 사람들이 직접 답변해 드립니다.