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
- 31
- diseños de factura
- 17
- formatos en los ejemplos
- 43
- 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
18 diseños
Cuenta de cobro
El documento de quien no está obligado a facturar.
type cuenta-de-cobro
1 diseño
Cotización
Lo que se ofrece y a qué precio, antes de que haya pedido.
type cotizacion
5 diseños
Propuesta comercial
Varias hojas para presentar un servicio: portada con foto y el cliente, alcance, planes y tarifas.
type propuesta-comercial
1 diseño
Pedido
Lo que un cliente pidió, con sus cantidades y su total.
type pedido
1 diseño
Requisición
Lo que un área solicita comprar, antes de la orden.
type requisicion
1 diseño
Orden de compra
Lo que se le encarga a un proveedor, con sus condiciones de pago.
type orden-de-compra
1 diseño
Factura de compra
La compra registrada a un proveedor, con su desglose de impuestos.
type factura-de-compra
1 diseño
Documento equivalente
La compra a quien no está obligado a facturar.
type documento-equivalente
1 diseño
Anticipo
Un pago por adelantado, con el concepto al que se imputa.
type anticipo
1 diseño
Comprobante de egreso
La salida de dinero a un beneficiario, con lo que se le paga.
type comprobante-de-egreso
1 diseño
Contrato
Cualquier minuta con marcadores: arrendamiento, laboral, actas de propiedad horizontal, comunicaciones y 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
1 diseño
Extracto de fondo de inversión
Los movimientos de un periodo en pesos y en unidades, con el cierre del saldo, para el titular de una inversión.
type extracto-de-fondo
5 diseños
Certificado tributario
Lo que un agente retenedor le retuvo a un tercero en un año gravable: retefuente, reteIVA, reteICA o el IVA facturado.
type certificado-retencion
7 diseños
Orden de trabajo
Mantenimiento correctivo o preventivo: el equipo, las tareas, los materiales y las firmas.
type orden-de-trabajo
8 diseños
Soporte de recepción
Quién recibió un trabajo, cuándo y con qué firma, con el histórico de entregas de la orden.
type soporte-de-recepcion
6 diseños
Permiso de trabajo
La autorización de una tarea de alto riesgo, con sus controles verificados y sus firmas.
type permiso-de-trabajo
5 diseños
Etiqueta de equipo
La etiqueta adhesiva de una máquina: su código, su ubicación y un QR.
type etiqueta-de-equipo
7 diseños
Inspección de seguridad
La lista de chequeo de un área o un equipo, con sus hallazgos y responsables.
type inspeccion-de-seguridad
7 diseños
Entrega de EPP
Qué elementos de protección se entregaron a quién, con la firma de recibido.
type entrega-de-epp
6 diseños
Charla preoperacional
El análisis de trabajo seguro del día, con sus riesgos y los asistentes firmando.
type charla-preoperacional
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
1 diseño
Etiqueta de radicado
La etiqueta de recepción documental, con consecutivo, fecha, remitente, folios y un QR.
type etiqueta-de-radicado
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.