Introducción

Genere facturas, cuentas de cobro, recibos, colillas de nómina y contratos en PDF desde su aplicación con una llamada HTTP.

Todo lo que se ve en el catálogo —facturas, cuentas de cobro, recibos, contratos— puede salir también desde otro sistema, sin que nadie entre a llenar nada. Su aplicación manda los datos, y recibe el PDF terminado.

Estas guías explican cómo, qué hay que mandar y qué esperar. Están pensadas para el equipo técnico que va a hacer la conexión.

El servicio está en línea

Escríbanos y le entregamos su clave; con ella, la primera llamada le devuelve un PDF hoy mismo.

POST https://docsgen.piensait.com/api/documents

Esa es la dirección estable. Si algún día movemos el servicio de sitio, usted no se entera.

Lo primero: no se instala nada

No hay que copiar este proyecto dentro del suyo, ni instalar un paquete, ni mantener una librería al día. 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.

Eso significa que da igual en qué esté escrito su sistema. PHP, .NET, Java, Python, Node, una automatización sin código: si sabe hacer un POST, sabe generar documentos.

Y significa también que el diseño mejora sin que usted haga nada. Cuando afinamos una plantilla o añadimos un formato, sus documentos salen mejor en la siguiente llamada; no hay versión que actualizar ni despliegue que coordinar.

Por qué no le entregamos el código

Podríamos darle una librería para que la instale. No lo hacemos a propósito.

El motor que dibuja los documentos vive en un solo sitio. Si cada aplicación se llevara una copia, en seis meses habría media docena de motores parecidos y ninguno igual: el mismo documento saldría distinto según quién lo generara, y arreglar algo obligaría a arreglarlo seis veces. Ya nos pasó dentro de este mismo proyecto con el pie de página de nueve plantillas, y acabó distinto en cada una.

Un solo motor detrás de una llamada es lo que hace que su factura y la nuestra se vean iguales.

Qué documentos puede pedir hoy

Tipo	Qué es
`factura`	La representación gráfica de una factura electrónica de venta
`nota-credito`	La representación gráfica de una nota crédito electrónica
`nota-debito`	La representación gráfica de una nota débito electrónica
`cuenta-de-cobro`	El documento de quien no está obligado a facturar
`recibo-de-caja`	Una entrada de dinero, con las facturas a las que se aplica
`estado-de-cuenta`	Lo que debe un cliente a una fecha de corte: movimientos, edades y saldo
`colilla-de-nomina`	Lo devengado, lo deducido y el neto de una persona en un periodo de nómina
`informe`	Una tabla con las columnas, filas y totales que usted mande, vertical u horizontal
`entrada-de-inventario`	Lo que llega a una bodega, con sus ítems, lotes, series y firmas
`salida-de-inventario`	Lo que sale de una bodega y por qué, con las firmas de quien entrega y quien recibe
`traslado-de-inventario`	Un traslado entre dos bodegas, con sus fechas de salida y de llegada
`contrato`	Cualquier minuta con marcadores: arrendamiento, laboral, actas, cartas

Lo que todavía no sale por esta vía

El resto del catálogo —cotización, pedido, orden de compra y compañía— todavía no sale por esta vía. Se ve y se descarga desde la aplicación, pero no responde a una llamada. Están en fila para pasar al mismo motor; le decimos cuáles y cuándo antes de que usted comprometa nada.

Lo decimos así de claro porque es el tipo de detalle que arruina una integración cuando se descubre tarde.

Por dónde seguir

Primera llamada: la llamada, los cuerpos de ejemplo y los cuatro pasos para empezar.
Autenticación: por qué la clave nunca va al navegador.
Errores: qué significa cada código y qué hacer.
Qué va dentro de data y Elegir el diseño.
Lo que el servicio no hace, y sus límites de hoy.
Cada tipo de documento: notas crédito y débito, recibo de caja, estado de cuenta, colilla de nómina, informe, inventario y contratos.

La referencia de la API describe cada ruta del servicio.