지금까지 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, UBL 또는 CII 구문.
- Peppol BIS Billing 3.0, UBL 구문.
- Factur-X / ZUGFeRD, 다섯 가지 프로필(Minimum, Basic WL, Basic, EN 16931, Extended)의 XML이며
TsgcInvoiceFacturX를 사용합니다.
프로필로 작성해도 인보이스는 바뀌지 않으므로, 하나의 모델을 한 고객에게는 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를 받는 라이터가 있습니다.
- Facturae, 스페인:
TsgcInvoiceFacturae는 3.2, 3.2.1, 3.2.2 버전을 작성합니다. - FatturaPA, 이탈리아:
TsgcInvoiceFatturaPA는 민간 수신자(FPR12)와 공공 행정기관(FPA12)을 위한 1.2.3 버전을 작성합니다. - KSeF, 폴란드:
TsgcInvoiceKSeF는 구조화된 인보이스, 즉 FA(3) 스키마를 작성합니다.
스페인의 두 가지 세무 시스템도 지원합니다.
- 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, 다섯 가지 프로필 | 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 | 예 | 아니요 |
인보이스 전송
세 가지 클라이언트가 문서를 세무 당국에 전달합니다.
TsgcVeriFactuClient는 VeriFactu 레코드를 AEAT 웹 서비스에 제출합니다. 각 레코드의 결과를 읽고, 레코드 한도와 제출 간 대기 시간을 적용하며, 제출된 레코드를 조회하고 영수증을 저장합니다.TsgcSdIClient는 FatturaPA 파일을 이탈리아 Sistema di Interscambio(SdI) 웹 서비스로 보내고, 파일 이름 규칙을 확인하며, SdI가 반환하는 알림 파일을 읽습니다.TsgcKSeFOnlineClient는 대화형 세션으로 KSeF에 인보이스를 보냅니다. 세션을 열고, 인보이스를 보내고, 상태와 KSeF 번호를 읽고, 세션을 닫고, UPO 영수증을 다운로드합니다.
Peppol 네트워크 전송
2026.12 버전은 Delphi와 .NET에서 인보이스를 Peppol 네트워크로 전송하는 기능도 제공합니다. 각 부분은 별도의 클래스이므로 전체 흐름을 사용해도 되고 그중 한 단계만 사용해도 됩니다.
TsgcPeppolSMPClient는 SML과 SMP로 참가자를 조회하고 서명된 SMP 응답을 검증합니다.TsgcPeppolSBDH와sgcPeppolWrapInvoice는 Peppol 비즈니스 메시지 봉투인 SBDH를 작성합니다.TsgcPeppolAS4Message와TsgcPeppolAS4Receipt는 Peppol AS4 프로파일의 AS4 메시지를 구현합니다. RSA-SHA256으로 서명하고, 페이로드는 gzip으로 압축한 뒤 AES-128-GCM으로 암호화하며, 키 전송에는 RSA-OAEP를 사용합니다.TsgcPeppolClient는SendInvoice와Resend로 조회, 봉투, 전송, 수령증 검증을 한 번의 호출로 처리합니다. 서명된 수령증을 저장하고 오류 코드가 담긴 결과 객체를 반환합니다.
외부 라이브러리는 필요 없습니다. 암호화, 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을 파일의 형식으로 설정하고 모델을 채우므로, 수신한 인보이스를 검증한 뒤 다른 구문으로 다시 작성할 수 있습니다.
포함되지 않은 기능
이 첫 버전의 범위에는 한계가 있으며, 이를 바탕으로 프로젝트를 계획하기 전에 알아 두는 것이 좋습니다.
- 국가별 형식은 쓰기 전용입니다. 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 데모는 폼에서 하나의 타입 인보이스를 채우고 단일 컴포넌트로 각 형식에 맞게 빌드합니다.
제품 페이지의 전자 인보이스 · 평가판 다운로드 · 변경 내역
질문이나 의견이 있으신가요? 문의해 주세요. 코드를 작성한 사람들이 직접 답변해 드립니다.
