Lista todas as entidades disponíveis no Claro Gerencial, indicando quais suportam consulta (output) e quais suportam envio (input). Use esta ferramenta para descobrir quais entidades existem antes de usar as demais.

Obtém registros de uma entidade do Claro Gerencial (WebService de Output). Use esta ferramenta para consultar/baixar dados do sistema.

Parâmetros:

• entidade: slug da entidade (ex: 'clientes', 'pedidos', 'visitas'). Use 'listar_entidades' para ver todas as opções.

• completa: True para carga completa (todos os registros), False para carga incremental (apenas novos/alterados desde a última consulta).

• usuario/senha: opcionais, usam as variáveis de ambiente CLARO_USUARIO/CLARO_SENHA por padrão.

• ambiente: opcional, 'homologacao' ou 'producao'. Padrão: variável CLARO_AMBIENTE.

Retorna um ticket que pode ser usado em 'gerar_arquivo' para gerar um arquivo FTP. Se a quantidade de registros retornados atingir o limite, faça novas chamadas com completa=False até que o retorno venha vazio.

Gera um arquivo FTP com os registros obtidos anteriormente via 'obter_registros'. Use o ticket retornado por 'obter_registros' para solicitar que o conteúdo seja disponibilizado via FTP. O arquivo ficará disponível em até 2 horas.

Parâmetros:

• ticket: ticket retornado por 'obter_registros'.

• entidade: slug da mesma entidade usada em 'obter_registros'.

• usuario/senha/ambiente: opcionais, usam variáveis de ambiente por padrão.

Envia registros em XML para importação no Claro Gerencial (WebService de Input). Use esta ferramenta para inserir, alterar ou excluir registros no sistema.

O XML deve seguir o schema XSD da entidade (use 'obter_schema_xml' para validar). Cada registro no XML deve conter o campo DbAcao: I (Inclusão), A (Alteração), E (Exclusão).

Parâmetros:

• entidade: slug da entidade de destino.

• xml: string contendo o XML completo a ser enviado.

• usuario/senha/ambiente: opcionais.

Retorna um ticket para acompanhar o status via 'obter_status'.

Consulta o status de um envio de registros pelo ticket (WebService de Input). Use após 'enviar_registros' para acompanhar o processamento.

Códigos de status: 0 - Na Fila para importação 1 - Registros sendo transferidos para o SGR 2 - Verificar preenchimento das informações 3 - Verificar se registros de exclusão existem 4 - Verificar registros de inclusão repetidos 5 - Verificar campos de cadastros relacionados 6 - Atualizar log para Inclusão 7 - Atualizar log para Alteração 8 - Atualizar log para Exclusão 9 - Envio Finalizado 99 - Erro ao Enviar

Quando status=9 (Envio Finalizado), o campo Conteudo traz o log detalhado com registros importados e eventuais erros.

Obtém o schema XSD (XML Schema Definition) de uma entidade para validação antes do envio (WebService de Input).

Use esta ferramenta para verificar a estrutura esperada do XML antes de chamar 'enviar_registros'. O schema define os campos obrigatórios, tipos e formato esperado para cada entidade.

Parâmetros:

• entidade: slug da entidade.

• usuario/senha/ambiente: opcionais.