by Piensa ITUna llamada HTTP · un PDF terminado
Sus documentos, desde su aplicación. Mande los datos, reciba el PDF.
Facturas, notas crédito y débito, cuentas de cobro, recibos de caja, colillas de nómina, informes, inventario y contratos. Su aplicación manda el tipo de documento y sus datos; la respuesta es el PDF, con texto seleccionable y paginación.
POST /api/documents
curl -X POST https://docsgen.piensait.com/api/documents \
-H "authorization: Bearer $DOCGEN_API_KEY" \
-H "content-type: application/json" \
-d @cuenta-de-cobro.json \
-o cuenta.pdf
# 200 · content-type: application/pdf- tipos de documento por API
- 12
- diseños de factura
- 17
- formatos en los ejemplos
- 29
- llamada por documento
- 1
Documentos
Qué documentos puede pedir hoy
Los importes usan el mismo vocabulario en todos los diseños, así que cambiar de diseño es cambiar una palabra.
17 diseños
Factura electrónica
La representación gráfica de una factura electrónica de venta, en hoja o en tirilla POS.
type factura
1 diseño
Nota crédito
La representación gráfica de una nota crédito electrónica.
type nota-credito
1 diseño
Nota débito
La representación gráfica de una nota débito electrónica.
type nota-debito
1 diseño
Cuenta de cobro
El documento de quien no está obligado a facturar.
type cuenta-de-cobro
1 diseño
Contrato
Cualquier minuta con marcadores: arrendamiento, laboral, actas, cartas.
type contrato
2 diseños
Recibo de caja
Una entrada de dinero, con las facturas a las que se aplica.
type recibo-de-caja
1 diseño
Estado de cuenta
Lo que debe un cliente a una fecha de corte: movimientos, edades y saldo.
type estado-de-cuenta
6 diseños
Colilla de nómina
Lo devengado, lo deducido y el neto de una persona en un periodo, con contraseña si se pide.
type colilla-de-nomina
1 diseño
Informe
Una tabla con las columnas, filas y totales que usted mande, vertical u horizontal.
type informe
1 diseño
Entrada de inventario
Lo que llega a una bodega, con sus ítems, lotes, series y firmas.
type entrada-de-inventario
1 diseño
Salida de inventario
Lo que sale de una bodega y por qué, con las firmas de quien entrega y quien recibe.
type salida-de-inventario
1 diseño
Traslado entre bodegas
Un traslado entre dos bodegas, con sus fechas de salida y de llegada.
type traslado-de-inventario
Ejemplos
Así salen los documentos
Cada ejemplo es un PDF compuesto por el mismo motor que responde la API, con datos de ejemplo. Pulse uno para ver todos sus diseños y descargarlo.
Integración
No se instala nada
Lo que se integra es una llamada HTTP: se manda un JSON con el tipo de documento y sus datos, y la respuesta es el PDF.
- PHP, .NET, Java, Python, Node o una automatización sin código: si sabe hacer un POST, sabe generar documentos
- El diseño mejora sin que usted haga nada: no hay versión que actualizar ni despliegue que coordinar
- El texto es texto: se selecciona, se busca y se copia, y el documento pagina
- Los errores vienen en JSON y dicen qué falta
Empezar
Su primer PDF en cuatro pasos
Pida su clave
Escríbanos y se la entregamos. No la guardamos en ninguna parte: si se pierde, emitimos otra.Mande el ejemplo tal cual
Tome el ejemplo de su tipo de documento y mándelo sin cambiar nada. Así separa un problema de conexión de uno de datos.Cámbielo por sus datos
Reemplace los datos del ejemplo por los reales, campo por campo.Llame desde su servidor
Nunca desde el navegador: la clave viajaría en un JavaScript que cualquiera puede leer.
Garantías
Lo que el servicio no hace, y no va a hacer
Puede parecer una limitación y es una garantía: la responsabilidad de cada cifra se queda donde están los datos, en su sistema.
No calcula
Los importes llegan preparados y se pintan: no suma, no aplica IVA. Un total que no cuadra sale impreso tal como llegó.
No genera CUFE ni CUDE
Tampoco numeración autorizada ni el contenido del QR: los produce su proveedor tecnológico y aquí se dibujan. Si faltan, el documento lo dice.
No asigna consecutivos
El número lo trae usted. Numerar sería ser la fuente de verdad de la numeración legal de su empresa.
No guarda el documento
Se compone, se entrega y se olvida.
- ¿Puedo generar varios documentos en una llamada?
- Hoy no: un documento por llamada. La generación por lotes está prevista; si la necesita, díganoslo al empezar.
- ¿Puedo llamar a la API desde el navegador?
- No. La clave viajaría dentro del JavaScript que cualquiera puede leer. Su aplicación web le pide el documento a su backend, y su backend nos lo pide a nosotros.
- ¿Qué pasa si el total no cuadra con las líneas?
- Se imprime tal como llegó. El servicio no suma ni aplica impuestos.
- ¿Se pueden proteger las colillas de nómina con contraseña?
- Sí, con cifrar: true. La contraseña es el número de documento del empleado, exactamente como lo manda.
- ¿Por qué la primera llamada tarda más?
- El servicio se duerme cuando nadie lo llama y arranca solo. A partir de ahí responde en milisegundos.
Escríbanos y le entregamos su clave
Con ella, la primera llamada le devuelve un PDF hoy mismo.