Tu primera factura procesada en 10 minutos

En términos prácticos: tu programa envía una factura a nuestra API, y recibe de vuelta los datos en formato JSON — un formato que cualquier programa puede entender fácilmente.

{
  "nombre": "Juan Pérez",
  "edad": 30,
  "ciudad": "Ciudad de México"
}

Cuando le envías una factura a nuestra API, te devuelve algo así — pero con los datos de la factura:

{
  "emisor": "Papelería El Centro S.A.",
  "total": 7052.80,
  "moneda": "MXN",
  "fecha": "2024-11-15"
}

Vamos a probar la API usando una herramienta gratuita que funciona en el navegador. No necesitas instalar nada.

{
  "url": "https://invoiceextract-api-production.up.railway.app/health"
}

# Reemplaza TU_KEY con tu API key real
$key = "iek_TU_KEY_AQUI"
$base = "https://invoiceextract-api-production.up.railway.app"

Invoke-RestMethod -Uri "$base/keys/usage" `
  -Headers @{"x-api-key" = $key}

Aquí eliges cómo vas a usar la API según lo que ya sabes o el programa que estás construyendo.

pip install requests

import base64
import requests

# 1. Tu API key
API_KEY = "iek_TU_KEY_AQUI"

# 2. La ruta a tu factura PDF
ARCHIVO = "mi_factura.pdf"

# 3. Convierte el PDF a base64
with open(ARCHIVO, 'rb') as f:
    pdf_base64 = base64.b64encode(f.read()).decode()

# 4. Envía a la API
respuesta = requests.post(
    'https://invoiceextract-api-production.up.railway.app/extract',
    headers={'x-api-key': API_KEY},
    json={'file_base64': pdf_base64, 'media_type': 'application/pdf'},
)

# 5. Lee los resultados
datos = respuesta.json()['data']

print(f"Emisor:   {datos['issuer']['name']}")
print(f"Total:    ${datos['amounts']['total']} {datos['document']['currency']}")
print(f"Fecha:    {datos['document']['date']}")
print(f"Confianza: {datos['confidence'] * 100:.0f}%")

const fs = require('fs');

// 1. Tu API key y archivo
const API_KEY = 'iek_TU_KEY_AQUI';
const ARCHIVO = 'mi_factura.pdf';

// 2. Convierte y envía
const base64 = fs.readFileSync(ARCHIVO).toString('base64');

const res = await fetch(
  'https://invoiceextract-api-production.up.railway.app/extract',
  {
    method: 'POST',
    headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ file_base64: base64, media_type: 'application/pdf' }),
  }
);

const { data } = await res.json();
console.log(`Emisor:  ${data.issuer.name}`);
console.log(`Total:   $${data.amounts.total} ${data.document.currency}`);

Ahora que sabes los conceptos básicos, aquí hay algunas ideas de lo que puedes construir: