API para Desarrolladores

Integra Titan Finance con tu ERP, software de contabilidad o cualquier sistema. API REST simple y potente.

Autenticación con API Keys
Rate limiting inteligente

Inicio Rápido

1Obtén tu API Key

Ve a tu perfil y genera una API Key. Disponible en planes Pro y Business.

2Haz tu primera petición

curl https://titanfinance.es/api/v1/invoices \
  -H "X-API-Key: tk_live_tu_api_key_aqui"

3Recibe tus facturas

{
  "success": true,
  "data": [
    {
      "id": "abc-123",
      "tipo": "RECIBIDA",
      "proveedor_cliente": "Proveedor S.L.",
      "nif": "B12345678",
      "numero_factura": "F-2026/001",
      "fecha_factura": "2026-01-15",
      "base_imponible": 100.00,
      "iva_total": 21.00,
      "total_pagar": 121.00
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150
  }
}

Endpoints

Facturas

GET/api/v1/invoicesListar facturas
GET/api/v1/invoices/:idDetalle de factura
GET/api/v1/invoices/statsEstadísticas

API Keys

POST/api/v1/keysCrear API key
GET/api/v1/keysListar keys
DELETE/api/v1/keysRevocar key

WebhooksBusiness

Solo disponible en plan Business

POST/api/v1/webhooksCrear webhook
GET/api/v1/webhooksListar webhooks
DELETE/api/v1/webhooksEliminar webhook

Filtros y Paginación

GET /api/v1/invoices

ParámetroTipoDescripción
tipostringEMITIDA | RECIBIDA
desdedateFecha inicio (YYYY-MM-DD)
hastadateFecha fin (YYYY-MM-DD)
estadostringAPROBADA | REVISAR
proveedorstringBúsqueda por nombre
pagenumberPágina (default: 1)
limitnumberResultados por página (max: 100)

Ejemplo

curl "https://titanfinance.es/api/v1/invoices?tipo=RECIBIDA&desde=2026-01-01&limit=10" \
  -H "X-API-Key: tk_live_..."

Estadísticas

GET /api/v1/invoices/stats

ParámetroDescripción
periodomes_actual | trimestre | año
desde / hastaRango personalizado (YYYY-MM-DD)

Respuesta

{
  "success": true,
  "data": {
    "periodo": { "desde": "2026-01-01", "hasta": "2026-01-31" },
    "totales": {
      "facturas": 45,
      "emitidas": 12,
      "recibidas": 33
    },
    "importes": {
      "ingresos": { "base_imponible": 15000, "iva": 3150, "total": 18150 },
      "gastos": { "base_imponible": 8000, "iva": 1680, "total": 9680 }
    },
    "iva": {
      "repercutido": 3150,
      "soportado": 1680,
      "resultado": 1470
    },
    "resultado_neto": 7000
  }
}

WebhooksBusiness

Recibe notificaciones en tiempo real cuando se procesan facturas.

Eventos disponibles

  • invoice.created - Nueva factura procesada
  • invoice.updated - Factura actualizada
  • invoice.deleted - Factura eliminada
  • scan.completed - Escaneo completado

Crear webhook

curl -X POST https://titanfinance.es/api/v1/webhooks \
  -H "X-API-Key: tk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-servidor.com/webhook",
    "events": ["invoice.created"],
    "name": "Mi ERP"
  }'

Payload recibido

{
  "event": "invoice.created",
  "timestamp": "2026-01-15T10:30:00Z",
  "data": {
    "id": "abc-123",
    "tipo": "RECIBIDA",
    "proveedor_cliente": "Proveedor S.L.",
    "total_pagar": 121.00
  }
}

Límites

Plan Pro

  • 1,000 requests/día
  • 5 API keys máximo
  • Sin webhooks

Plan Business

  • Requests ilimitados
  • 5 API keys máximo
  • 10 webhooks máximo

¿Listo para integrar?

Genera tu API key y empieza a construir en minutos.

Obtener API Key