Documentación

Todo lo que necesitas para leer los datos de tu programa de gestión desde Power BI, Excel, tu CRM o un asistente de IA. ¿Prefieres que te lo dejemos montado? Escríbenos a hola@datavivo.es.

1. Empezar en 3 pasos

  1. Crea tu cuenta (14 días gratis, sin tarjeta).
  2. Instala el agente de Windows en el equipo donde están tus datos y elige qué tablas publicar. Solo lectura y sin abrir puertos.
  3. En el panel, crea una API key y copia el ejemplo listo para Power BI, Excel, tu CRM o la IA.

2. Autenticación

Cada petición lleva tu API key (empieza por dvk_) en la cabecera X-API-Key. También se acepta Authorization: Bearer dvk_…. La clave se muestra una sola vez al crearla: guárdala como una contraseña y revócala desde el panel si se pierde.

3. Consultar datos

Sustituye tu-empresa por el identificador de tu cuenta (aparece en el panel).

# Tablas disponibles y sus columnas
curl -H "X-API-Key: dvk_..." https://datavivo.es/api/v1/tu-empresa

# Filas de una tabla (JSON)
curl -H "X-API-Key: dvk_..." "https://datavivo.es/api/v1/tu-empresa/clientes?limit=100"
ParámetroPara qué
limitFilas por página (100 por defecto; el máximo depende del plan).
offsetFilas que se saltan, para paginar: offset=0, offset=100…
fieldsSolo estas columnas, separadas por comas: fields=CODIGO,NOMBRE.
formatjson (por defecto) o csv para Excel.

Las fechas llegan en formato ISO 8601 (2026-11-19) y los importes decimales como texto, para no perder céntimos.

4. Filtros

Añade COLUMNA=valor a la URL, o COLUMNA__operador=valor. Se combinan con «y» (hasta 20 por consulta).

OperadorSignificaEjemplo
(ninguno) o eqigual aCIUDAD=Madrid
nedistinto deESTADO__ne=BAJA
gt · gtemayor que · mayor o igualSALDO__gte=1000
lt · ltemenor que · menor o igualFECHA__lt=2026-01-01
likecontiene (comodín %, sin distinguir mayúsculas)NOMBRE__like=%25lopez%25
inuno de la listaCODIGO__in=1,2,3

En una URL, el % se escribe %25.

5. Power BI y Excel

En el panel, pestaña Power BI, elige una tabla y copia la consulta. En Power BI: Obtener datos → Consulta en blanco → Editor avanzado, pega y acepta. La consulta descarga todas las filas página a página y aplica a cada columna su tipo (número, fecha, texto). Para actualizar, basta con Actualizar.

En Excel sirve la misma consulta (Datos → Obtener datos → Desde otras fuentes → Consulta en blanco), o un CSV con ?format=csv.

Power BI y Excel son marcas de Microsoft. DataVivo es compatible con ellos, pero no está afiliado a Microsoft.

6. Asistentes de IA (MCP)

Con el plan Pro o superior, Claude, ChatGPT y otros asistentes compatibles con MCP pueden consultar tus tablas en lenguaje natural, siempre en solo lectura y solo sobre las tablas que autorizas.

URL:      https://datavivo.es/mcp
Cabecera: Authorization: Bearer dvk_...

# Claude Code
claude mcp add --transport http tu-empresa https://datavivo.es/mcp --header "Authorization: Bearer dvk_..."

El panel (pestaña IA (MCP)) te da la configuración exacta para Claude Desktop y otros clientes. Herramientas disponibles: list_resources y query_resource.

7. Límites por plan

PlanPeticiones/mesPor minutoFilas por peticiónTablasIA (MCP)
Prueba gratuita2.000120 5003Sí
Starter10.000120 1.0005—
Pro100.000300 5.00025Sí
Business500.0001200 10.000IlimitadasSí

8. Errores

Los errores se devuelven en JSON con un mensaje en español en el campo detail.

CódigoQué pasaQué hacer
400Parámetro o filtro no válidoRevisa el nombre de la columna y el operador
401API key ausente, inválida o revocadaCrea una nueva en el panel
402Prueba terminada o cuota mensual agotadaElige o amplía tu plan en el panel
403La clave no tiene acceso a esa tablaRevisa los permisos de la clave
404La tabla no existe o no está publicadaConsulta el catálogo: /api/v1/tu-empresa
429Demasiadas peticiones por minutoEspera unos segundos y reintenta
503 · 504El agente local está apagado o no respondeComprueba que el equipo y el servicio del agente están en marcha
¿Eres desarrollador?

Prueba la API desde el navegador en la referencia interactiva (OpenAPI 3.1, descargable en /openapi.json). El código del agente es abierto: github.com/DataVivo/DataVivo-agent.