컴플라이언스와 보관
하이브리드 PDF/A-3b 전자 인보이스를 위한 Factur-X API
공개 E-Invoice Render 엔드포인트를 통해 EN 16931 CII XML이 내장된 Factur-X PDF/A-3b 인보이스를 생성합니다.
주 API E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render 시스템 ERP / 청구 백엔드 / 컴플라이언스 업무 흐름 / 재무 자동화 서비스
해결할 작업
ERP 또는 청구 시스템이 올바른 구조화 인보이스 데이터를 만든 뒤, 렌더링된 인보이스 PDF를 EN 16931 CII XML이 내장된 Factur-X PDF/A-3b로 패키징합니다.
이 API를 쓰는 경우
- 공개 E-Invoice Render 엔드포인트에서 기본 지원 Factur-X 출력이 필요합니다.
- 자체 시스템이 인보이스에 대해 유효한 EN 16931 CII XML을 이미 보유하고 있습니다.
- Factur-X 메타데이터와 연관 파일 연결이 포함된 PDF/A-3b 패키징이 필요합니다.
- capabilities 엔드포인트로 현재 게시된 e-invoice 계약을 확인하고 싶습니다.
대체하지 않는 것
- gPdf가 인보이스의 비즈니스 의미나 세금 판단을 만들어주기를 원합니다.
- OpenAPI 목록에 나열되지 않은 XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e 또는 기타 표준의 기본 지원 출력이 필요합니다.
- Chorus Pro 또는 다른 정부 포털로 직접 제출해야 합니다.
호출할 endpoint
/api/v1/e-invoice/render
E-Invoice Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/e-invoice/capabilities
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/e-invoice/render - 최소 Factur-X 패키지 형태.
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"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": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- E-Invoice Render를 통한 Factur-X 패키징.
- 하이브리드 인보이스 PDF를 위한 PDF/A-3b 프로파일 처리.
- 표준 메타데이터와 함께 CII XML을 연관 파일로 내장.
- 문서화된 인라인 PDF 전달 또는 객체 전달 작업 동작.
자체 시스템이 책임지는 것
- 정확한 EN 16931 CII XML, 인보이스 번호, 세금 로직, 구매자 및 판매자 데이터, 적격성.
- 외부 검증, 수신자 규칙, 포털 제출, 법적 해석.
- 저장, 감사 추적, 재시도 로직, 고객 또는 포털로의 전달.
운영 전 체크리스트
- CII XML을 gPdf에 보내기 전에 검증합니다.
- settings.profile을 pdfa-3b로 설정하거나 생략해 e-invoice 기본값이 적용되게 합니다.
- settings.e_invoice.standard = factur_x 및 settings.e_invoice.profile = en16931을 사용합니다.
- 반환된 PDF를 자체 Factur-X validator 검증 흐름으로 검증합니다.
- 제출과 수신자 라우팅은 render API 밖에 둡니다.
지원 범위의 경계
- 공개 기본 지원 전자 인보이스 출력은 EN 16931 CII XML을 포함한 Factur-X 또는 ZUGFeRD입니다.
- gPdf는 인보이스를 정부 또는 구매자 포털에 제출하지 않습니다.
- 비즈니스, 세금, XML 정확성은 자체 시스템이 담당합니다.
Factur-X는 전자 인보이스 패키징 업무 흐름입니다
Factur-X는 사람이 읽을 수 있는 PDF와 기계가 읽을 수 있는 EN 16931 CII XML을 결합합니다. 공개 gPdf 엔드포인트는 이 조합을 PDF/A-3b 출력으로 패키징합니다. 인보이스의 비즈니스 의미를 결정하거나 파일을 포털에 제출하지는 않습니다.
FAQ
- 어느 엔드포인트가 Factur-X를 렌더링하나요?
- settings.e_invoice.standard를 factur_x로 설정해 POST /api/v1/e-invoice/render를 사용하세요.
- gPdf가 EN 16931 XML을 생성하나요?
- 자체 시스템이 CII XML을 제공하고 그 비즈니스 정확성을 담당합니다. gPdf는 이를 하이브리드 PDF로 패키징합니다.
- 이 페이지에서 gPdf는 XRechnung을 지원하나요?
- 아니요. 이 페이지는 OpenAPI 목록에 나열된 공개 Factur-X 계약으로 제한됩니다.
- gPdf가 Factur-X 인보이스를 포털에 제출하나요?
- 아니요. 제출과 수신자 라우팅은 render API 밖에 남습니다.