CLI Dattos: comandos e capacidades

Este artigo é a referência dos comandos da CLI Dattos, organizados por área. Todos aceitam --help para a documentação completa de flags, e dattos status-glossary explica o significado de qualquer status retornado pela plataforma. Para instalação e autenticação, veja "CLI Dattos: instalação e primeiros passos".

Fluxos e execução (dattos etl)

O grupo central da CLI — cobre o ciclo de vida dos fluxos de preparação de dados e conciliação:

• Criar e construir com o Dattos AI: etl create --name <nome> cria a análise; etl add-source --etl <id> --file <arquivo> adiciona fontes (xlsx, csv, pdf, xml); etl pipeline create "<descrição em linguagem natural>" --etl <id> constrói o fluxo completo com inteligência artificial (aceita --rules <documento> com as regras de negócio). O atalho etl new faz tudo em uma chamada.

• Executar: etl start <id> --date <AAAA-MM-DD> dispara a execução para uma data de referência; --file sobe o arquivo antes, --wait acompanha até concluir, --incremental preserva os dados já carregados.

• Acompanhar e gerenciar: etl execution-status <id> --date <data>, etl list, etl get <id>, etl resolve <código> (traduz código para identificadores), etl datasources <id>, etl publish <id> (promove o rascunho a versão publicada) e etl activate/etl deactivate.

• Backup e restauração: etl download <id> baixa o blueprint .xdtt do fluxo; etl upload <id> --file <blueprint> restaura.

• Construção avançada: para montar o fluxo etapa a etapa por programação, existem etl add-step, etl connect, etl set-params, etl add-matching, etl components (catálogo e parâmetros de cada etapa), etl formulas (referência da Fórmula Dattos), etl sql-help e etl step-data (amostra da saída de uma etapa).

Consulta de resultados

• dattos loads: loads get <análise> <data> retorna o carregamento e seus conjuntos de dados; loads list-dates lista as datas de referência com dados.

• dattos datasets: datasets search <análise> <load> <dataset> consulta as linhas do resultado, com paginação e filtros em JSON.

• dattos matching: matching status traz os totais da conciliação (conciliados, pendentes), matching summary o resumo por coluna e matching get os registros.

Exportação (dattos reports)

• reports generate <análise> --load-id <id> --dataset-id <id> --format csv|xlsx — geração assíncrona.

• reports status acompanha e reports download <análise> <reportId> --output <arquivo> baixa o resultado.

Administração

• dattos users: listar, criar, atualizar, bloquear e excluir usuários; users set-roles define os perfis.

• dattos roles: gestão dos perfis de privacidade — CRUD, escopo de pastas (roles folders) e níveis de aprovação de conciliação (roles approval-levels).

• dattos connectors: conectores de banco de dados — criar, testar (connectors test), ativar/desativar.

• dattos calendars: consulta dos calendários de execução.

• dattos batch: operações em massa — batch batch-start --ids <lista> --date <data> executa várias análises em sequência; batch batch-create --file <usuarios.json> cria usuários em lote.

• dattos folders: navegação e seleção do contexto de pasta.

Utilitários

• dattos doctor [--deep] — diagnóstico de configuração, conectividade e autenticação.

• dattos config profile list|switch — perfis para múltiplas instâncias/ambientes.

• dattos cache — gerenciamento do cache local de consultas (TTL de 5 minutos; operações de escrita invalidam automaticamente).

• dattos mcp install <ferramenta> — configura o servidor MCP nos assistentes de inteligência artificial (veja o artigo de MCP).

• dattos version e dattos status-glossary.

Comportamento e limites

• Arquivos aceitos no upload: .csv, .edi, .ofx, .pdf, .rem, .ret, .txt, .xlsx, .xls, .xlsb, .xml.

• Limite de requisições: ao receber HTTP 429, a CLI reexecuta automaticamente até 3 vezes com espera progressiva (5s, 10s, 20s).

• Tempo limite: 30s nas chamadas comuns; 120s em upload e download; 10 minutos nos fluxos de inteligência artificial (streaming).

• Códigos de saída: 0 sucesso, 1 erro da API, 2 autenticação/configuração — os erros saem em JSON no stderr com next_step e correlation_id para suporte.

Artigos relacionados

• CLI Dattos: instalação e primeiros passos

• Conectar assistentes de inteligência artificial via MCP

• Introdução às integrações