청구와 재무
계정 및 청구 내보내기를 위한 명세서 PDF API
여러 페이지 행, 합계, 메타데이터, 선택적 PDF/A 보관 설정을 포함한 계정, 청구, 활동 명세서 PDF를 생성합니다.
주 API JSON Render
ENDPOINT
/api/v1/pdf/render 시스템 청구 백엔드 / 계정 시스템 / ERP 내보내기 서비스 / SaaS 리포팅 서비스
해결할 작업
기간 데이터, 기초 잔액, 품목 행, 조정, 합계에서 고객, 계정, 청구 명세서 PDF를 렌더링해 사용자가 검토하거나 보관할 일관된 기록을 다운로드할 수 있게 합니다.
이 API를 쓰는 경우
- 잔액, 명세서 기간, 거래 행, 합계를 이미 자체 시스템이 관리합니다.
- 계정 이력, 청구 요약, 재무 업무 흐름을 위한 PDF 내보내기가 필요합니다.
- 헤더, 푸터, 요약 섹션이 있는 반복 가능한 여러 페이지 출력이 필요합니다.
- 보관 업무 흐름을 위해 PDF/A 출력이 필요할 수 있습니다.
대체하지 않는 것
- 은행 연결, 원장 대사, 재무 자문이 필요합니다.
- 같은 렌더 요청에서 암호화된 명세서와 PDF/A가 모두 필요합니다. 공개 Render API는 보안 설정과 PDF/A 프로파일 설정을 상호 배타적으로 처리합니다.
- 전자 인보이스 XML 패키징이 필요합니다. 이 경우 E-Invoice Render endpoint를 사용하세요.
호출할 endpoint
/api/v1/pdf/render
JSON Render가 이 처리 흐름의 기본 경로입니다.
/api/v1/template-render
관련 API 경로, 템플릿 계약 또는 capability 조회가 필요할 때 사용합니다.
최소 request
POST /api/v1/pdf/render - 기간 합계가 포함된 명세서 표지 페이지.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "letter",
"elements": [
{
"type": "text",
"x": 18,
"y": 20,
"content": "Account Statement",
"style": { "font_size": 18, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 18,
"y": 38,
"content": "Period: 2026-05-01 to 2026-05-31\nOpening balance: $1,240.00\nClosing balance: $1,890.25",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf가 처리하는 것
- 명세서 페이지에 대한 DocumentRequest 렌더링을 처리합니다.
- 텍스트 블록, 표, 합계 섹션, 페이지 번호, 메타데이터, PDF/A 프로파일 설정을 처리합니다.
- 안정적인 명세서 레이아웃과 필드 계약에는 Template Render를 제공합니다.
- 자체 시스템이 다운로드하거나 저장하기에 적합한 바이너리 PDF 출력을 제공합니다.
자체 시스템이 책임지는 것
- 명세서 기간 로직, 계정 잔액, 거래 데이터, 통화 규칙, 고객 식별.
- 보관 정책, 접근 제어, 파일명 지정, 안전한 전달.
- 모든 대사, 감사 승인, 규제 대상 재무 표시.
운영 전 체크리스트
- 긴 거래 설명, 많은 행 수, 빈 기간, 음수 잔액을 테스트합니다.
- 모든 명세서 렌더링에 대해 요청 ID를 생성합니다.
- 요청 시 렌더링할지, 기간 마감 후 각 명세서를 저장할지 결정합니다.
- 명세서 보관 정책이 요구할 때만 PDF/A를 사용합니다.
- 접근 제어와 고객 인증은 render API 밖에 둡니다.
지원 범위의 경계
- gPdf는 계정 잔액을 계산하거나 원장을 대사하지 않습니다.
- API는 명세서 PDF를 렌더링하고, 재무적 정확성은 자체 시스템이 담당합니다.
- PDF/A 출력은 렌더 설정이지, 보관 정책을 대체하지 않습니다.
명세서는 기간 기준 문서입니다
명세서 페이지는 계정, 기간, 기초 잔액, 활동 행, 조정, 기말 잔액처럼 닫힌 비즈니스 사실 집합에서 시작해야 합니다. gPdf는 그 사실을 결정하지 않습니다. 사용자가 다운로드하거나 자체 시스템이 저장할 수 있는 PDF 레이아웃으로 렌더링합니다.
많은 행 처리
행 수가 많다면 표 영역, 요약 섹션, 페이지 번호를 갖춘 반복 가능한 레이아웃으로 명세서를 설계하세요. 레이아웃을 조정하는 동안에는 JSON Render를 사용하고, 필드 계약이 안정되면 Template Render로 옮기세요.
FAQ
- gPdf가 명세서 잔액을 계산할 수 있나요?
- 아니요. 자체 시스템이 기간, 잔액, 행, 합계를 보냅니다. gPdf는 PDF를 렌더링합니다.
- 명세서 PDF에 PDF/A를 사용할 수 있나요?
- 네, JSON Render는 PDF/A 프로파일 설정을 지원합니다. PDF/A 필요 여부는 자체 보관 정책이 결정합니다.
- 명세서에는 Template Render를 써야 하나요?
- 레이아웃이 안정된 뒤에는 보통 그렇습니다. Template Render를 사용하면 호출자가 페이지 좌표를 반복하지 않고 기간 데이터만 보낼 수 있습니다.
- gPdf가 명세서를 저장하나요?
- 아니요. 표준 렌더 요청은 PDF 응답을 반환합니다. 저장과 접근 제어는 자체 시스템이 담당합니다.