컴플라이언스와 보관
PDF/A-3b 하이브리드 인보이스를 위한 ZUGFeRD API
공개 gPdf E-Invoice Render 엔드포인트를 사용해 EN 16931 CII XML이 내장된 ZUGFeRD PDF/A-3b 인보이스를 생성합니다.
주 API E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render 시스템 ERP / 청구 백엔드 / 독일 재무 업무 흐름 / 컴플라이언스 자동화 서비스
해결할 작업
ERP 또는 청구 시스템이 올바른 인보이스 데이터를 준비한 뒤, 인보이스 PDF 출력을 EN 16931 CII XML이 내장된 ZUGFeRD PDF/A-3b로 패키징합니다.
이 API를 쓰는 경우
- 공개 E-Invoice Render 엔드포인트에서 기본 지원 ZUGFeRD 출력이 필요합니다.
- 자체 시스템이 인보이스에 대해 유효한 EN 16931 CII XML을 이미 보유하고 있습니다.
- ZUGFeRD 메타데이터와 연관 파일 연결이 포함된 PDF/A-3b 패키징이 필요합니다.
- 더 넓은 전자 인보이스 및 Factur-X 페이지와 짝을 이루는 명확한 형제 페이지가 필요합니다.
대체하지 않는 것
- XRechnung 기본 생성 또는 포털 제출이 필요합니다.
- gPdf가 세금을 계산하거나, 인보이스 의미를 추론하거나, 회계 기록에서 XML을 생성해야 합니다.
- 공개 OpenAPI 계약에 나열되지 않은 표준이 필요합니다.
호출할 endpoint
/api/v1/e-invoice/render
E-Invoice Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/e-invoice/capabilities
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/e-invoice/render - 최소 ZUGFeRD 패키지 형태.
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "zugferd",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "ZUGFeRD invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- E-Invoice Render를 통한 ZUGFeRD 패키징.
- 하이브리드 인보이스 출력을 위한 PDF/A-3b 프로파일 처리.
- ZUGFeRD 메타데이터와 함께 CII XML을 연관 파일로 내장.
- 문서화된 인라인 PDF 또는 객체 전달 동작.
자체 시스템이 책임지는 것
- EN 16931 CII XML 정확성, 인보이스 데이터, 세금 로직, 구매자와 판매자의 의미.
- 외부 검증, 수신자 요구사항, 포털 제출, 법적 해석.
- 재시도 동작, 저장, 감사 증거, 고객 전달.
운영 전 체크리스트
- settings.e_invoice.standard = zugferd 및 settings.e_invoice.profile = en16931을 설정합니다.
- format = cii, encoding = utf8인 CII XML을 사용합니다.
- settings.profile을 pdfa-3b로 설정하거나 생략해 e-invoice 기본값이 적용되게 합니다.
- 반환된 PDF를 자체 ZUGFeRD 검증 흐름으로 검증합니다.
- XRechnung 또는 포털 제출 작업은 이 엔드포인트 밖에 둡니다.
지원 범위의 경계
- 이 페이지는 E-Invoice Render를 통한 ZUGFeRD 출력을 다룹니다.
- XRechnung 기본 생성을 주장하지 않습니다.
- 인보이스 비즈니스 데이터와 XML 유효성은 자체 시스템이 담당합니다.
ZUGFeRD는 e-invoice 렌더링 경로를 사용합니다
ZUGFeRD는 별도의 루트 엔드포인트가 아닙니다. POST /api/v1/e-invoice/render의
settings.e_invoice.standard 필드로 선택합니다. 같은 책임 경계가 적용됩니다.
gPdf는 PDF/A-3b 하이브리드 인보이스를 패키징하고, 인보이스 사실과 XML
유효성은 자체 시스템이 담당합니다.
FAQ
- 어느 엔드포인트가 ZUGFeRD를 렌더링하나요?
- settings.e_invoice.standard를 zugferd로 설정해 POST /api/v1/e-invoice/render를 사용하세요.
- 이 페이지가 XRechnung을 다루나요?
- 아니요. 이 페이지는 공개 ZUGFeRD 계약으로 제한됩니다. 여기서는 XRechnung을 기본 지원 출력으로 주장하지 않습니다.
- gPdf가 CII XML을 생성하나요?
- 자체 시스템이 EN 16931 CII XML을 제공하고 그 정확성을 담당합니다.
- 결과를 검증할 수 있나요?
- 검증 맥락에는 자체 ZUGFeRD 검증 흐름과 gPdf validator 페이지를 사용하세요.