Passo 1 para RELATÓRIOS e CONSULTAS financeiras rápidas (web service).

Use quando a pessoa quer DADOS: inadimplência, contas a pagar, fluxo de caixa, boletos, vencimentos, lançamentos. Busque pela intenção dela (ex.: 'boleto', 'inadimplencia') e depois chame descrever_metodo no que achar. Para OPERAR o Ahreas como no painel (importar consumo, emitir, cadastrar), use listar_telas.

Detalha um método: serviço, parâmetros, formato e se lê ou grava.

Executa um método do Ahreas com a credencial da instalação.

Leitura roda direto. Método que grava (ou de efeito incerto) exige confirmar=true, e escrita ainda depende de AHREAS_PERMITIR_ESCRITA.

O que está de pé: os dois web services, o catálogo e a credencial.

Passo 1 para OPERAR o Ahreas como no painel web (383 telas da instalação).

Use quando a pessoa quer FAZER algo que se faz na tela: importar leitura de consumo (gás/água), emitir boleto, lançar, cadastrar, processar emissão, gerar remessa — ou quando listar_metodos não achou um método para a consulta. Busque pela intenção (ex.: 'consumo', 'boleto', 'emissão') e chame descrever_tela no caminho que achar para ver os campos e as ações.

Detalha uma tela: os campos que ela pede e as ações (botões) disponíveis.

Aciona uma tela: preenche os campos e dispara o botão, por HTTP.

Consulta roda direto. Ação que altera o ERP exige confirmar=true e AHREAS_PERMITIR_ESCRITA, e antes disso mostre à pessoa o que vai rodar.

Sobe um arquivo em QUALQUER tela de importação e, com confirmação, processa.

Serve para toda tela que recebe arquivo (leitura de consumo, retorno bancário, lote de lançamentos, etc.) — nada é específico de um fluxo. Descubra a tela em listar_telas e os botões em descrever_tela (acao_processar é o que grava; acao_reconhecer, se existir, é o que a tela dispara ao aceitar o arquivo).

Primeiro chame SEM confirmar: o arquivo é enviado e a tela o reconhece — o próprio Ahreas pode preencher campos a partir dele — sem gravar; mostre o resultado à pessoa. Só depois do sim dela, chame de novo com confirmar=true.

Confere se o modo telas está de pé: login web, catálogo e forma das telas.

Por ser replay de tela, o modo telas depende da forma do painel. Esta ferramenta faz login, conta as telas do menu e abre uma amostra delas para confirmar que ainda têm forma reconhecível (campos e ações) — um alarme caso a Ahreas mude o painel. Passe caminho para checar uma tela específica antes de uma operação importante nela.