Skip to main content

PDF Tools API

API para generar facturas PDF

Integra generar facturas PDF en tu backend, tareas por lotes o producto sin mantener una infraestructura propia de PDF.

Create API KeyRead full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/invoice-generator/pdf

Use your API Key in the x-api-key header.

Use case

Úsalo para convertir datos de facturación en recibos o facturas PDF listos para enviar. La herramienta web sirve para revisión manual; la API, para automatización estable del lado servidor.

cURL example

curl -X POST https://itextmaster.com/api/external/invoice-generator/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'invoiceNumber=INV-001' \
  -F 'fromName=Your Company' \
  -F 'billToName=Client Name' \
  -F 'items=[{"description":"Consulting","quantity":10,"rate":150}]' \
  --output invoice.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/invoice-generator/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'invoiceNumber=INV-001' \
  -F 'fromName=Your Company' \
  -F 'billToName=Client Name' \
  -F 'items=[{"description":"Consulting","quantity":10,"rate":150}]' \
  --output invoice.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/invoice-generator/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "invoiceNumber": "INV-001",
    "from": { "name": "Your Company", "email": "you@example.com" },
    "billTo": { "name": "Client Name", "email": "client@example.com" },
    "items": [{ "description": "Consulting", "quantity": 10, "rate": 150 }]
  }' \
  --output invoice.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/invoice-generator/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  invoiceNumber: 'INV-001',
  from: { name: 'Your Company', email: 'you@example.com' },
  billTo: { name: 'Client Name', email: 'client@example.com' },
  items: [{ description: 'Consulting', quantity: 10, rate: 150 }]
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('invoice.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/invoice-generator/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'invoiceNumber': 'INV-001',
        'from': {'name': 'Your Company', 'email': 'you@example.com'},
        'billTo': {'name': 'Client Name', 'email': 'client@example.com'},
        'items': [{'description': 'Consulting', 'quantity': 10, 'rate': 150}],
    },
)
response.raise_for_status()

with open('invoice.pdf', 'wb') as f:
    f.write(response.content)

Error codes

400invalid_invoice_payload

El JSON de factura está mal formado o le faltan campos obligatorios.

401invalid_api_key

Falta x-api-key, no es válida o fue rotada.

402insufficient_credits

La cuenta no tiene API Credits suficientes.

500invoice_pdf_generation_failed

Falló la generación del PDF de factura. Los Credits se devuelven automáticamente si falla.

Limits

  • Necesita un PDF válido o datos de entrada correctos.
  • Llama a la API desde el servidor para no exponer tu API Key.
  • Prueba archivos representativos antes de procesar lotes grandes.

Response headers

invoice.pdf con cabeceras de Credits consumidos y saldo restante.

Content-Type
Tipo MIME del archivo generado, normalmente application/pdf o application/zip.
Content-Disposition
Nombre de descarga del archivo generado.
X-Credits-Charged
Credits cobrados por la solicitud correcta.
X-Credit-Balance
Saldo de API Credits después de la solicitud.

FAQ

¿Cuánto cuesta API para generar facturas PDF?

Cada solicitud correcta usa API Credits; si el procesamiento falla, se devuelven automáticamente. Cada usuario con sesión recibe 100 free API Credits al mes, y 1,000 Credits = $1.

¿Las herramientas web usan API Credits?

No. Las herramientas que procesan en el navegador no consumen API Credits. Solo cuentan las solicitudes con API Key.

¿Puedo llamar la API desde el navegador?

No es recomendable. Guarda la API Key en tu backend, cola o automatización del servidor.

Start with 100 free API Credits

Create an API Key, test API para generar facturas PDF, and buy more Credits only when automation volume grows.

Get API KeyView full API docs