컴플라이언스와 보관
보관용 PDF 생성을 위한 PDF/A API
보관 워크플로를 위해 JSON Render 요청에서 PDF/A 출력을 생성하고, PDF/A 프로파일과 전자 인보이스 패키징의 경계를 명확히 구분합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 컴플라이언스 백엔드 / 아카이브 서비스 / ERP 내보내기 서비스 / 문서 자동화 서비스
해결할 작업
비즈니스 워크플로에 보관 친화적인 PDF가 필요할 때 구조화된 문서 요청에서 PDF/A 프로파일 출력을 생성하고, 내장 XML 인보이스 패키징이 필요할 때만 E-Invoice Render를 선택합니다.
이 API를 쓰는 경우
- 렌더 설정에서 특정 PDF/A 프로파일을 선택해야 하는 워크플로입니다.
- 보관용 인보이스, 명세서, 보고서 또는 일반 문서 출력이 필요합니다.
- PDF/A-3b 전자 인보이스 패키징보다 더 넓은 범위의 일반 PDF/A 페이지가 필요합니다.
- 생성된 파일을 자체 보관 승인 워크플로로 검증할 수 있습니다.
대체하지 않는 것
- Factur-X 또는 ZUGFeRD와 내장 EN 16931 CII XML이 필요합니다. E-Invoice Render를 사용하세요.
- 검증 전용 워크플로가 필요합니다. 검증 맥락은 validator 페이지를 사용하세요.
- 같은 요청에서 암호화된 출력과 PDF/A가 모두 필요합니다. 공개 Render API에서는 보안 설정과 PDF/A 프로파일 설정이 상호 배타적입니다.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/e-invoice/render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - 일반 PDF/A 출력 설정.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive-ready document",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- JSON Render 요청의 PDF/A 프로파일 설정.
- 텍스트, 표, 이미지, 바코드, 메타데이터와 프로파일 출력을 포함한 문서 렌더링.
- E-Invoice Render 경로를 통한 PDF/A-3b 전자 인보이스 패키징.
- 공통 오류 동작을 사용하는 바이너리 PDF 응답.
자체 시스템이 책임지는 것
- 보관 정책, 프로파일 선택, 검증 워크플로, 보존, 법적 승인.
- 문서의 업무상 의미, 비즈니스 데이터, 필요한 외부 증거.
- 저장소, 접근 제어, 향후 마이그레이션 정책.
운영 전 체크리스트
- 아카이브 또는 고객이 요구하는 PDF/A 프로파일을 선택합니다.
- 출력을 검증기와 보존 승인 워크플로에 통과시킵니다.
- 공개 문서에 호환 계약이 추가되기 전까지 PDF/A와 보안 설정은 별도 렌더 흐름으로 분리합니다.
- 내장 CII XML이 필요하면 E-Invoice Render를 사용합니다.
- 보존 정책에 따라 원본 데이터 또는 반환된 PDF를 저장합니다.
지원 범위의 경계
- PDF/A 출력은 법적 전자 인보이스 패키징과 같지 않습니다.
- gPdf는 보관 승인 또는 검증 워크플로를 대체하지 않습니다.
- 보존과 컴플라이언스 해석은 호출 시스템의 책임입니다.
PDF/A는 프로파일 선택입니다
일반 보관용 문서에서는 렌더 설정을 통해 PDF/A를 선택합니다. 이 방식은 워크플로를 JSON Render에 가깝게 유지합니다. 호출 시스템이 문서를 설명하고 필요한 프로파일을 설정합니다.
전자 인보이스 패키징은 별개의 문제입니다. 문서에 Factur-X 또는 ZUGFeRD와 내장 CII XML이 필요하다면 E-Invoice Render 엔드포인트를 사용하세요.
FAQ
- 일반 PDF/A 출력에는 어떤 엔드포인트를 사용해야 하나요?
- 일반 PDF/A 출력에는 적절한 settings.profile 값을 지정해 POST /api/v1/pdf/render를 사용하세요.
- 언제 E-Invoice Render가 필요한가요?
- 문서가 내장 CII XML을 포함한 Factur-X 또는 ZUGFeRD PDF/A-3b 패키지여야 할 때 E-Invoice Render를 사용하세요.
- gPdf가 보관 승인까지 검증하나요?
- 아니요. gPdf는 PDF/A 출력을 렌더링합니다. 출력이 아카이브 또는 고객 승인 정책을 충족하는지는 호출 시스템에서 검증해야 합니다.
- PDF/A를 보안 설정과 함께 사용할 수 있나요?
- 현재 공개 Render API에서는 사용할 수 없습니다. settings.profile과 settings.security는 상호 배타적이며, 잘못 조합하면 검증에 실패합니다.