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…), 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": "[email protected]"
  }'

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 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 (presupuestos y el escaneo OCR de tickets) ya está en la API REST — nada del ciclo depende del panel web.

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: 7 €/mes · IVA incluido. En otras suites la integración por API o la conexión con IA es un add-on o un plan superior; en contix es parte del producto.

¿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.