Crear una factura PDF

Facturar como subproducto del software, no como tarea

Cada venta, renovación de suscripción o pedido completado termina necesitando un documento que el cliente pueda abrir, revisar y conservar para su propia contabilidad — pero los datos detrás de ese documento ya existen en su sistema en el instante en que ocurre la transacción. La api generar factura pdf está pensada para esa brecha: ya conoce las partidas, el impuesto, los totales; este endpoint convierte esos datos en el documento que su cliente realmente espera, sin que nadie toque una herramienta de facturación.

Qué va en la solicitud

Envía JSON estructurado que describe la factura — datos del emisor y del receptor, partidas con cantidades y precios unitarios, el impuesto aplicable, la fecha de vencimiento y sus elementos de marca como logo y colores — y el servicio lo maqueta como un PDF con formato correcto y desglose de partidas. Los totales se calculan y presentan como los espera un contador: subtotal, desglose de impuestos y total general claramente separados, así el documento se lee como una factura real y no como un volcado de hoja de cálculo.

Cómo funcionan la generación y la entrega

Llama a POST /pdf/invoice con su payload y recibe de inmediato un task_id, sin esperar sobre una conexión abierta. El PDF se construye de forma asíncrona en nuestra red global, y una vez listo le avisamos por webhook firmado — la opción natural para sistemas de facturación que necesitan adjuntar la factura a un correo o a un portal de cliente de forma automática — o por un enlace firmado válido 24 horas cuando una persona solo necesita obtener un documento.

Dónde encaja en la automatización de facturación

Está diseñada para correr sin supervisión: una plataforma de suscripciones que genera una factura por cada renovación, un marketplace que produce una factura con la marca del vendedor por cada pedido completado, un sistema contable que agrupa las facturas de fin de mes para cada cuenta abierta. Como cada llamada devuelve un task_id y confirma la entrega por webhook, generar la factura se vuelve un paso disparado por la propia transacción — el mismo instante en que se captura el pago o se confirma un pedido — y no una tarea aparte en la lista de alguien.

Precio transparente y manejo seguro

El cobro es de $0.040 por solicitud más $0.001 por documento, una tarifa publicada, sin tokens ni créditos inventados. Una tarea que falla nunca se cobra; reintentamos tres veces antes de devolver un error claro en lugar de un fallo silencioso. El acceso requiere saldo prepago — sin plan gratuito ni prueba — que es lo que mantiene el servicio rápido y sin abuso; las solicitudes sin saldo reciben un 402. Los datos de la factura se eliminan tras la ventana de retención y nunca se usan para entrenar nada.