Integrar Dcycle: API, CLI o MCP por categoría de dato

La mayoría de las personas trabajan con Dcycle desde la web, y en casi todos los casos es suficiente. Pero Dcycle también puede conectarse directamente con tus propios sistemas para que los datos entren y salgan sin que nadie tenga que pinchar por las pantallas. Esta guía explica —en lenguaje sencillo— qué puedes conectar y qué no, cuándo merece la pena, a quién hay que involucrar y qué riesgos y beneficios tiene. Todo está organizado por categoría de dato (logística, flota, facturas, etc.).

La documentación técnica completa está en code.dcycle.io. Esta página es la guía de decisión que va antes.

¿Necesito integrar de verdad?

Usa la web cuando tus datos son puntuales y los introduces a mano. Plantéate conectar cuando:

• Tienes muchos datos que cargar de golpe (cientos o miles de filas).
• La misma carga se repite a menudo (cada día, semana o mes).
• Quieres que Dcycle hable con otro sistema que ya usas (un ERP, una herramienta de flota, un almacén de datos).

Las 3 formas de conectar

Hay tres puertas de entrada a Dcycle. No eliges una para siempre: distintos equipos pueden usar puertas distintas para tareas distintas.

	API	CLI	MCP
Qué es	Una conexión directa entre programas	Una herramienta que se usa desde el terminal	Un puente para un asistente de IA
Para qué va mejor	Crear un enlace a medida y siempre activo con otro sistema	Cargar ficheros y automatizar tareas repetitivas	Preguntar por tus datos —y crear registros— en lenguaje natural
Quién lo monta	Desarrollo / IT	Un perfil técnico (cómodo con el terminal, pero hace falta algo más)	Casi cualquiera — conectas un asistente de IA
Tiempo de puesta en marcha	Días o semanas (es un proyecto)	Minutos para instalar; horas para un script	Minutos
Mantenimiento	Medio — alguien es dueño del código	Bajo	Muy bajo — no hay código que mantener
Apoyo técnico necesario	Alto	Medio–alto	Bajo
Ventaja principal	Totalmente a medida, en tiempo real	Rápido para cargas masivas y automatización	Sin perfil técnico — lee y crea datos conversando
Inconveniente principal	El que más cuesta montar y mantener	Lee y escribe, pero necesita un perfil técnico	Crea registros de uno en uno — todavía sin cargas masivas

Estas son las cuatro preguntas que la gente se hace más a menudo — y qué puerta responde a cada una:

¿Puedo subir muchos datos de golpe? Sí. Casi todas las categorías admiten un fichero CSV (una exportación sencilla de hoja de cálculo). Para facturas y recibos de suministros también puedes subir el PDF y Dcycle lo lee automáticamente. El resto de categorías usan CSV o la API en vez de PDF.

¿Puede la carga hacerse sola, sin hacerla a mano cada vez? Sí — eso es automatizar. Una carga que hoy haces cada día o cada semana puede pasar a ejecutarse en minutos, ella sola. Tu empresa solo necesita un sitio donde correr la tarea automática (un servidor o tarea programada, o el sistema donde tu equipo técnico guarda su código) más una clave de acceso. Lo que a una persona le llevaba una hora a la semana pasa a ejecutarse sin que nadie esté delante.

¿Puedo acceder a mis datos rápido sin entrar a la web? Sí. Con el asistente de IA (MCP) basta con conectarlo, sin conocimientos técnicos. Con la herramienta de terminal (CLI) necesitas a un perfil técnico. Ponerlo en marcha lleva minutos; un proceso a medida, de horas a días. Si algo falla, lo arregla tu equipo técnico (o quien lo montó).

¿Puedo sacar, filtrar y mantener mis datos al día? Sí. Tienes historial de cambios y exportaciones, así que puedes seguir qué cambió — y cargar al ritmo que necesites: al instante según van pasando las cosas (API), por lotes cada día o semana (CLI), o con consultas puntuales cuando quieras (MCP).

Cuándo usar cada una

La tabla de arriba te dice qué es cada puerta. Esto te dice cuál elegir, qué estás invirtiendo y qué obtienes a cambio.

API — un puente permanente y automático

• Úsala cuando quieras conectar Dcycle con otro sistema que ya usas (un ERP, una herramienta de flota o transporte, un almacén de datos, tu propia app), para que los datos crucen sin que nadie los toque — y cuando los necesites en tiempo real o en volumen continuo.
• Objetivo: eliminar por completo la carga manual; los datos aparecen en Dcycle en cuanto se crean en el otro sistema.
• Inversión: es un proyecto de desarrollo. Necesita a tu equipo de IT o desarrollo, lleva de días a semanas construirlo y luego alguien tiene que ser dueño del código. El mayor esfuerzo de los tres.
• Beneficios: totalmente a medida, en tiempo real, sin intervención humana, y escala a cualquier volumen.
• Ejemplo: cada compra registrada en tu ERP se envía a Dcycle automáticamente, sin paso de exportación.

CLI — cargas masivas de ficheros y automatización, sin construir una app

• Úsala cuando cargas datos desde ficheros (CSV o Excel) o repites la misma tarea a mano, y quieres ahorrar tiempo sin encargar un desarrollo a medida.
• ¿Se puede automatizar? Sí — este es su punto fuerte. Puedes meter un comando de la CLI dentro de una tarea programada (un proceso que corre solo cada noche o cada semana) o dentro del sistema donde tu equipo técnico ya automatiza su trabajo.
• Casos en los que encaja: «cada lunes, coge el CSV de envíos de la semana y súbelo solo»; «sube el consumo de combustible de la flota a principio de cada mes»; «carga las compras de proveedores cada noche desde una exportación».
• ¿Para quién es? Un perfil técnico. Estar cómodo con el terminal es el punto de partida, pero hace falta algo más: instalar herramientas, manejar claves de acceso y escribir un pequeño script. También se puede manejar con un asistente de IA, pero la herramienta sigue teniendo que estar instalada en el ordenador de esa persona y puede resultar algo más complicada que las otras opciones.
• Objetivo: automatizar cargas repetitivas de ficheros sin un proyecto de integración completo.
• Inversión: instalar y entrar lleva minutos; un comando puntual, minutos. Un proceso automatizado (un pequeño script más una programación) lleva horas y lo monta mejor un perfil técnico. El mantenimiento del día a día es bajo.
• Beneficios: el mejor equilibrio esfuerzo-resultado para cargas masivas y periódicas — rápido de empezar y se automatiza sin un gran proyecto.
• Ejemplo: una tarea nocturna que sube el CSV de logística del día ella sola.

MCP — pregunta (y ahora crea) tus datos en lenguaje natural

• Úsala cuando quieras trabajar con tus datos hablando con un asistente de IA, sin entrar a la web ni programar: preguntas rápidas, análisis puntual, un informe al momento — y ahora también crear registros (una factura, un vehículo, un viaje, una compra) con solo describirlos.
• Objetivo: acceso rápido y conversacional a tus datos —consulta y carga ligera— sin fricción técnica.
• Inversión: conectar el asistente lleva minutos. Sin código y sin mantenimiento — la opción más barata.
• Beneficios: curva técnica cero; ideal para perfiles de negocio y de sostenibilidad. Lee tus datos y crea registros individuales por chat.
• Límite: todavía no hace cargas masivas — crea los registros de uno en uno, y algunos tipos de dato aún no se pueden crear así. Para cargar muchas filas de golpe, usa CSV o la CLI.
• Ejemplo: pídele al asistente las emisiones de la flota de este trimestre, o dile «añade una factura de electricidad de 1.200 kWh para la oficina de Madrid» y la crea.

Por categoría de dato

Cada fila indica qué puedes conectar y cómo. Las ventajas e inconvenientes de cada método están en la tabla comparativa de arriba.

Categoría	Cómo cargarla	Notas
Logística — envíos (ISO 14083 / GLEC)	Fichero CSV, o API para un flujo en directo	Buena para automatizar si envías a diario
Flota / vehículos (Scope 1)	CSV o Excel, o API	—
Instalaciones (oficinas, naves, plantas)	CSV, API o CLI; una a una con MCP	Sueles tener pocas — sirve cualquier método
Facturas de energía (Scope 1 y 2)	PDF (lectura auto.), CSV, CLI o API	Las victorias más fáciles — la lectura del PDF es la que más ahorra
Cadena de suministro / compras (Scope 3.1)	CSV (web o CLI), API; una a una con MCP	Encaja cuando tus compras ya viven en un ERP
Viajes, hoteles y desplazamientos (Scope 3.6 y 3.7)	CSV (hoteles y encuestas), o API	—
Transporte — arriba/abajo (Scope 3.4 y 3.9)	CSV o Excel, o API	—
Factores de emisión personalizados	CSV, vía CLI	No disponible por MCP
Análisis de ciclo de vida (LCA)	Excel o fichero, o API	El lienzo visual se hace en la web

Qué no se puede (o no conviene) integrar

Riesgos, beneficios y a quién involucrar

Beneficios. Menos trabajo manual, menos errores de copiar y pegar, y datos más frescos porque las cargas ocurren según un calendario en vez de cuando alguien se acuerda.

Riesgos que conviene prever.

• Las claves de acceso son como contraseñas. Quien tiene la clave puede enviar datos: guárdala de forma segura y nunca la compartas en texto plano.
• Dependencia de quien lo montó. Un enlace a medida necesita un responsable. Si esa persona se va, alguien tiene que tomar el relevo.
• Cambios con el tiempo. A medida que la plataforma evoluciona, una integración a medida puede necesitar pequeños ajustes. La herramienta de terminal y el puente de asistente de IA absorben la mayor parte de esto por ti.

A quién involucrar.

• Tu equipo de IT o desarrollo — para la API, para la herramienta de terminal (CLI) y para las cargas automáticas y programadas.
• La persona responsable de los datos de sostenibilidad — para las cargas por CSV y para el puente de asistente de IA (lectura, informes y carga ligera).
• Soporte de Dcycle — para confirmar qué permite tu plan y para dirigir a tu equipo técnico a code.dcycle.io con los detalles de configuración.