API de estados de cuenta PDF para exportaciones de cuenta y facturación
Genere PDF de estados de cuenta, facturación y actividad con filas multipágina, totales, metadatos y ajustes PDF/A opcionales para archivo.
/api/v1/pdf/render Renderizar PDF de estados de cliente, cuenta o facturación desde datos de periodo, saldos iniciales, partidas, ajustes y totales, para que los usuarios puedan descargar un registro consistente para revisión o retención.
Cuándo usar esta API
- Su sistema ya controla saldos, periodos del estado, filas de transacciones y totales.
- Necesita una exportación PDF para historial de cuenta, resúmenes de facturación o flujos financieros.
- Necesita salida multipágina repetible con encabezados, pies de página y secciones de resumen.
- Puede necesitar salida PDF/A para flujos de archivo.
Qué no sustituye
- Necesita conectividad bancaria, conciliación contable o asesoramiento financiero.
- Necesita estados cifrados y PDF/A en la misma solicitud de renderizado. La API pública Render trata los ajustes de seguridad y los perfiles PDF/A como mutuamente excluyentes.
- Necesita empaquetado XML de factura electrónica. Use el endpoint E-Invoice Render para eso.
Qué endpoint llamar
/api/v1/pdf/render
JSON Render es la ruta predeterminada para este flujo.
/api/v1/template-render
Úsalo cuando el flujo necesite la ruta API relacionada, un contrato de plantilla o una consulta de capacidades.
Solicitud mínima
POST /api/v1/pdf/render - portada de estado con totales del periodo.
{
"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" }
}
]
}
]
}
Qué gestiona gPdf
- Renderizado de páginas de estado mediante DocumentRequest.
- Bloques de texto, tablas, secciones de totales, numeración de páginas, metadatos y ajustes de perfil PDF/A.
- Template Render para un diseño de estado y contrato de campos estables.
- Salida PDF binaria adecuada para descarga o almacenamiento por su sistema.
Qué controla su sistema
- Lógica de periodos, saldos de cuenta, datos de transacciones, reglas de moneda e identidad del cliente.
- Política de archivo, control de acceso, nombres de archivo y entrega segura.
- Cualquier conciliación, aprobación de auditoría o representación financiera regulada.
Checklist de producción
- Pruebe descripciones de transacción largas, alto número de filas, periodos vacíos y saldos negativos.
- Genere un ID de solicitud para cada renderizado de estado.
- Decida si renderizar bajo demanda o almacenar cada estado después del cierre de periodo.
- Use PDF/A solo cuando la política de archivo del estado lo requiera.
- Mantenga el control de acceso y la autenticación del cliente fuera de la API de renderizado.
Límites de la promesa
- gPdf no calcula saldos de cuenta ni concilia libros contables.
- La API renderiza estados PDF; su sistema controla la corrección financiera.
- La salida PDF/A es un ajuste de renderizado, no un sustituto de una política de retención.
Los estados son documentos de periodo
Una página de estado debe partir de un conjunto cerrado de hechos de negocio: cuenta, periodo, saldo inicial, filas de actividad, ajustes y saldo final. gPdf no decide esos hechos. Los renderiza en un diseño PDF que sus usuarios pueden descargar o su sistema puede almacenar.
Manejo de conjuntos grandes de filas
Para números altos de filas, diseñe el estado como una composición repetible con regiones de tabla, secciones de resumen y números de página. Use JSON Render mientras ajusta el diseño. Pase a Template Render cuando el contrato de campos sea estable.
FAQ
- ¿gPdf puede calcular saldos de estados de cuenta?
- No. Su sistema envía el periodo, saldos, filas y totales. gPdf renderiza el PDF.
- ¿Los estados PDF pueden usar PDF/A?
- Sí, JSON Render admite ajustes de perfil PDF/A. Su política de archivo decide si PDF/A es obligatorio.
- ¿Los estados deberían usar Template Render?
- Normalmente sí después de estabilizar el diseño. Template Render permite que los clientes envíen datos de periodo sin repetir coordenadas de página.
- ¿gPdf almacena estados?
- No. Las solicitudes estándar de renderizado devuelven la respuesta PDF. Su sistema controla almacenamiento y acceso.