CLI Dattos: comandos y capacidades

Este artículo es la referencia de los comandos de la CLI Dattos, organizados por área. Todos aceptan --help para la documentación completa de las banderas, y dattos status-glossary explica el significado de cualquier estado devuelto por la plataforma. Para la instalación y la autenticación, consulta "CLI Dattos: instalación y primeros pasos".

Flujos y ejecución (dattos etl)

El grupo central de la CLI: cubre el ciclo de vida de los flujos de preparación de datos y conciliación:

• Crear y construir con Dattos AI: etl create --name <nome> crea el análisis; etl add-source --etl <id> --file <arquivo> añade fuentes (xlsx, csv, pdf, xml); etl pipeline create "<descrição em linguagem natural>" --etl <id> construye el flujo completo con inteligencia artificial (acepta --rules <documento> con las reglas de negocio). El atajo etl new hace todo en una sola llamada.

• Ejecutar: etl start <id> --date <AAAA-MM-DD> inicia la ejecución para una fecha de referencia; --file sube el archivo antes, --wait sigue hasta que termine, --incremental conserva los datos ya cargados.

• Seguir y gestionar: etl execution-status <id> --date <data>, etl list, etl get <id>, etl resolve <código> (traduce el código a identificadores), etl datasources <id>, etl publish <id> (promueve el borrador a la versión publicada) y etl activate/etl deactivate.

• Copia de seguridad y restauración: etl download <id> descarga el blueprint .xdtt del flujo; etl upload <id> --file <blueprint> restaura.

• Construcción avanzada: para montar el flujo paso a paso mediante programación, existen etl add-step, etl connect, etl set-params, etl add-matching, etl components (catálogo y parámetros de cada etapa), etl formulas (referencia de la Fórmula Dattos), etl sql-help y etl step-data (muestra de la salida de una etapa).

Consulta de resultados

• dattos loads: loads get <análise> <data> devuelve la carga y sus conjuntos de datos; loads list-dates lista las fechas de referencia con datos.

• dattos datasets: datasets search <análise> <load> <dataset> consulta las filas del resultado, con paginación y filtros en JSON.

• dattos matching: matching status muestra los totales de la conciliación (conciliados, pendientes), matching summary el resumen por columna y matching get los registros.

Exportación (dattos reports)

• reports generate <análise> --load-id <id> --dataset-id <id> --format csv|xlsx — generación asíncrona.

• reports status sigue el proceso y reports download <análise> <reportId> --output <arquivo> descarga el resultado.

Administración

• dattos users: listar, crear, actualizar, bloquear y eliminar usuarios; users set-roles define los perfiles.

• dattos roles: gestión de los perfiles de privacidad — CRUD, alcance de carpetas (roles folders) y niveles de aprobación de conciliación (roles approval-levels).

• dattos connectors: conectores de base de datos — crear, probar (connectors test), activar/desactivar.

• dattos calendars: consulta de los calendarios de ejecución.

• dattos batch: operaciones masivas — batch batch-start --ids <lista> --date <data> ejecuta varias análisis en secuencia; batch batch-create --file <usuarios.json> crea usuarios en lote.

• dattos folders: navegación y selección del contexto de carpeta.

Utilidades

• dattos doctor [--deep] — diagnóstico de configuración, conectividad y autenticación.

• dattos config profile list|switch — perfiles para múltiples instancias/entornos.

• dattos cache — gestión de la caché local de consultas (TTL de 5 minutos; las operaciones de escritura invalidan automáticamente).

• dattos mcp install <ferramenta> — configura el servidor MCP en los asistentes de inteligencia artificial (consulta el artículo de MCP).

• dattos version y dattos status-glossary.

Comportamiento y límites

• Archivos aceptados en la carga: .csv, .edi, .ofx, .pdf, .rem, .ret, .txt, .xlsx, .xls, .xlsb, .xml.

• Límite de solicitudes: al recibir HTTP 429, la CLI se vuelve a ejecutar automáticamente hasta 3 veces con espera progresiva (5s, 10s, 20s).

• Tiempo límite: 30s en las llamadas comunes; 120s en carga y descarga; 10 minutos en los flujos de inteligencia artificial (streaming).

• Códigos de salida: 0 éxito, 1 error de la API, 2 autenticación/configuración — los errores salen en JSON por stderr con next_step y correlation_id para soporte.

Artículos relacionados

• CLI Dattos: instalación y primeros pasos

• Conectar asistentes de inteligencia artificial vía MCP

• Introducción a las integraciones