Facturación por API: facturas Veri*factu desde tu código o tu asistente de IA

Qué puedes hacer por API

La API REST cubre el ciclo completo de facturación, con los mismos datos y las mismas reglas que el panel:

• Clientes: crear, editar, listar, con NIF o sin él (clientes particulares).
• Facturas: crear borradores, finalizar (número correlativo + huella encadenada + QR Veri*factu), rectificativas, simplificadas, recurrentes.
• Cobros: registrar pagos totales o parciales.
• Gastos: crear, consultar, editar y borrar gastos.
• Consultas: facturas, presupuestos, modelos (303, 130, 390, 349, 347, 202), exportación para la gestoría.

La documentación interactiva (OpenAPI) está disponible en tu cuenta; los endpoints viven bajo https://api.contix.es/api/v1/.

Autenticación: tu API-Key

En Ajustes → API-Keys creas un key con permiso de lectura o de escritura. Se muestra una sola vez, se guarda con hash y lo puedes revocar en un clic. Después, cada petición lleva el key como Bearer-Token:

curl https://api.contix.es/api/v1/invoices \
  -H "Authorization: Bearer cx_live_TU_KEY"

No hay OAuth-Dance ni registro de aplicación: un key, una cabecera, listo.

Ejemplo: emitir una factura Veri*factu en tres llamadas

1. Crear el cliente (una vez):

curl -X POST https://api.contix.es/api/v1/customers \
  -H "Authorization: Bearer cx_live_TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_name": "Empresa Ejemplo SL",
    "company_name": "Empresa Ejemplo SL",
    "nif": "B12345678",
    "email": "facturas@ejemplo.es"
  }'

2. Crear la factura (borrador):

curl -X POST https://api.contix.es/api/v1/invoices \
  -H "Authorization: Bearer cx_live_TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": 42,
    "issue_date": "2026-07-07",
    "tax_rate": 21,
    "items": [
      {"description": "Desarrollo web, julio", "quantity": 1, "unit_price": 900}
    ]
  }'

3. Finalizar: aquí se asigna el número correlativo, se calcula la huella encadenada y se genera el QR:

curl -X POST https://api.contix.es/api/v1/invoices/123/finalize \
  -H "Authorization: Bearer cx_live_TU_KEY"

# → {"invoice_number": "F-2026-0042", "current_hash": "e746e9…", …}

El PDF con QR sale de GET /api/v1/invoices/123/pdf. Mientras la factura es borrador se puede editar o borrar; una vez finalizada es inmutable: igual que en el panel, porque es el mismo motor.

MCP: conecta Claude, ChatGPT o Cursor

contix incluye un servidor MCP (Model Context Protocol): el estándar con el que los asistentes de IA usan herramientas externas. Endpoint:

https://api.contix.es/api/v1/mcp
Authorization: Bearer cx_live_TU_KEY

Herramientas disponibles (entre otras): list_customers, list_invoices, create_invoice, finalize_invoice, record_payment, list_expenses, create_expense, update_expense, delete_expense, list_suppliers y get_modelo. Tu asistente puede responder «¿qué facturé a X en junio?», crear el cliente, preparar la factura y, tras tu confirmación explícita, emitirla con su número, huella y QR Veri*factu, registrar el cobro y gestionar tus gastos (crear, editar y borrar). El ciclo completo, sin abrir el panel.

Emitir es irreversible (la factura entra en la cadena Veri*factu), por eso la herramienta exige una confirmación explícita del usuario antes de finalizar. Lo único que aún no está como herramienta MCP (el escaneo OCR de tickets) ya está en la API REST: nada del ciclo depende del panel web.

Conectar con Claude (recomendado, sin API-Key)

contix soporta OAuth 2.1: en Claude.ai o Claude Desktop entras en Conectores (en los ajustes de Claude) y eliges «Añadir conector personalizado»: pegas la URL del servidor y confirmas el login con tu cuenta de contix. No necesitas copiar ninguna clave.

https://api.contix.es/api/v1/mcp

Con Claude Code (CLI) es un único comando:

claude mcp add --transport http contix https://api.contix.es/api/v1/mcp

Conectar con ChatGPT

Requiere plan Plus (o superior) con el modo desarrollador activado. En Conectores (en los ajustes de ChatGPT) añades un conector personalizado con la misma URL del servidor; ChatGPT te lleva al login de contix.

Conectar con Cursor (u otro cliente stdio)

Cursor y otros editores todavía no hablan HTTP+OAuth directamente, así que se conectan vía mcp-remote con tu API-Key (Ajustes → API-Keys en tu panel) como cabecera:

{
  "mcpServers": {
    "contix": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.contix.es/api/v1/mcp",
        "--header",
        "Authorization: Bearer cx_live_TU_KEY"
      ]
    }
  }
}

No existe un botón/deeplink público de tipo «Add to Claude» para servidores MCP externos (Anthropic solo lo ofrece dentro de su Directory oficial una vez listado ahí), por eso la conexión es siempre manual: pegar la URL en el apartado de Conectores.

Seguridad y límites

• Permisos por key: lectura o escritura, se eligen al crearlo.
• Revocación en un clic y caducidad opcional. Los keys se guardan con hash: ni contix puede volver a leerlos.
• Límite: 120 peticiones/minuto por key.
• Reservado al panel web: exportación completa de datos, borrado de cuenta y la suscripción. Un key filtrado no puede llevarse tu cuenta.

Preguntas frecuentes

¿Una factura creada por API es válida ante Veri*factu?

Sí. API y panel usan el mismo motor: numeración correlativa, huella encadenada, QR. Para la AEAT no hay diferencia.

¿Puedo facturar desde Claude o ChatGPT?

Sí, el ciclo completo vía MCP: crear el cliente, preparar la factura, emitirla (con confirmación explícita, es irreversible) y registrar el cobro.

¿La API cuesta aparte?

No. Está incluida en el único plan: 12 €/mes + IVA. La API, el MCP y la conexión con IA son parte del producto, no un extra que se contrata aparte.

¿Hay entorno de pruebas?

La prueba de 30 días es el entorno de pruebas: cuenta completa, sin tarjeta. Las facturas de prueba que no finalices no consumen numeración.