Integração

A tela Configurações de Integração – visão UAU API permite configurar a comunicação entre o ERP UAU e serviços externos que dependem da UAU API para realizar integrações automatizadas. Nessa visão, o usuário informa os dados necessários para que o sistema consiga se conectar à API — como a URL externa da UAU API, além de usuário e senha administrativos do UAU. Essa configuração é fundamental para habilitar integrações com diversos serviços externos, garantindo que o UAU possa trocar informações de forma segura e padronizada.

1. Na seção Definições Gerais, no campo URL da UAU API, cole o endereço externo de acesso à API (uma URL que começa com o protocolo HTTPS);
2. Nos campos Usuário e senha UAU, preencha com os respectivos dados do administrador do sistema UAU da empresa;
3. Na janela Api, usuário e senha válidos. Pronto para salvar a configuração, clique em Ok;
4. Clique em Testar conectividade para validar a conexão;
5. Para salvar, clique em Confirmar, localizado no lado esquerdo superior da tela.

A tela de Criação de Webhooks no ERP UAU permite configurar integrações capazes de receber atualizações de dados em tempo real. Por meio dessa funcionalidade, o sistema envia automaticamente informações para um endpoint configurado sempre que um evento relevante ocorre no UAU — como alterações de vendas, unidades, obras ou produtos. Assim, em vez de realizar consultas constantes via UAU API, os webhooks garantem que as integrações recebam notificações imediatas e atualizadas conforme as mudanças acontecem.

A tela de Configurações de Armazenamento de Arquivos permite definir como o ERP UAU fará o gerenciamento e o envio de anexos dentro do sistema, seja utilizando pastas locais em rede ou serviços de armazenamento em nuvem. Por meio dessa visão, o usuário pode configurar opções como usuário de rede — garantindo acesso centralizado às pastas, mesmo para usuários sem permissão no Windows — e ativar integrações para armazenamento externo conforme a necessidade da empresa. Essa configuração é essencial para que o UAU consiga realizar anexos de forma segura, padronizada e acessível a todos os módulos que utilizam arquivos vinculados.

1. Na seção Domínio e usuário administrador de rede, no campo Domínio da rede, informe o domínio da rede do Windows que será usado pelo usuário de rede do UAU (somente informar quando o usuário estiver dentro de uma rede local de domínio AD);
2. No campo Usuário do Windows, informe o nome do usuário do Windows com permissões de administrador que será usado pelo UAU;
3. No campo Senha do usuário, informe a senha do usuário do Windows com permissõesde administrador que será usado pelo UAU;
4. Clique em Gravar.

A tela Assinaturas digitais apresenta a configuração dos serviços de assinaturas digitais integrados ao sistema. Nela, é possível selecionar quais serviços estarão ativos e visualizar informações como código, nome, descrição e data de cadastro. A Autenticação permite definir as credenciais necessárias para comunicação com a plataforma de assinaturas. O Ambiente de Produção, permite o usuário habilitar e configurar quais processos do sistema utilizarão assinaturas digitais, como Geral (Documento), Cadastro de Fornecedores, Financeiro, Pessoal, entre outros. É possível configurar opções de envio de mensagens relacionadas ao processo de assinatura, incluindo SMS, e-mail e WhatsApp.

A tela Armazenamento permite configurar como os anexos serão gravados dentro do UAU. Nela, o usuário define se os arquivos serão armazenados em serviços externos (como AWS S3) ou em um caminho de rede interno. Também é possível habilitar o uso de um usuário administrador de rede, garantindo que mesmo usuários sem permissão no Windows consigam anexar arquivos pelo sistema. Além disso, a tela reúne links e configurações essenciais para integrar e gerenciar anexos de forma centralizada.

A tela de Configuração do RabbitMQ no Virtuau permite definir os parâmetros necessários para que o ERP UAU utilize o RabbitMQ como message broker. O RabbitMQ atua como intermediário no envio de mensagens assíncronas entre o UAU e o banco de dados, ajudando a distribuir processos e melhorar a escalabilidade e a performance das rotinas do sistema. Antes de configurar, é necessário que o serviço do RabbitMQ esteja instalado na máquina/servidor.

1. Na seção Informe os dados de configuração do RabbitMQ, no campo Server Hostname/IP, informe o IP;
2. No campo Porta (Padrão 5672), informe o código da porta;
3. Informe os dados nos campos Usuário e Senha;
4. Clique no botão Testar;
5. Clique em Gravar;
6. Para consultar os logs, na seção Logs de eventos na fila, escolha entre Entrada ou Saída no campo Tipo;
7. No campo Período, informe o período que deseja buscar, caso queira buscar todos, deixe o campo em branco;
8. Clique em Consultar.

A tela de Plataforma Senior é o ponto de acesso onde se realizam as configurações essenciais para a integração do UAU XT com a Senior X Platform. Nessa área, o usuário consegue visualizar e gerenciar informações relacionadas ao Domínio e ao Tenant, elementos fundamentais para estruturar ambientes independentes, seguros e personalizados dentro da plataforma. O Domínio representa uma unidade organizacional que agrupa entidades relacionadas, enquanto o Tenant corresponde a uma instância isolada, com dados, usuários e configurações próprias. É justamente esse Tenant que será integrado ao UAU XT, permitindo que recursos da Senior X sejam utilizados de forma unificada no ambiente do sistema. Essa integração possibilita uma experiência mais completa, expandindo as funcionalidades disponíveis e proporcionando maior flexibilidade na gestão dos ambientes.

O que é Domain e Tenant?

Domain (Domínio): Refere-se a uma unidade lógica de organização, onde entidades relacionadas são agrupadas. Representa uma área funcional ou divisão organizacional dentro da X Platform.

Tenant: É uma instância independente e isolada de um aplicativo dentro de um Domain. Cada Tenant atua como uma entidade autônoma, possuindo configurações, dados e usuários exclusivos.

Importância desses Conceitos

• A criação de Domain e Tenant proporciona flexibilidade na organização e personalização dos ambientes.
• Permite isolar dados e configurações, assegurando ambientes seguros e adaptados às necessidades específicas.
• Facilita a administração de diversos ambientes ou clientes, pois cada Tenant pode ser configurado de maneira independente.

1. No campo Domínio, insira o domínio do tenant;
2. No campo Tenant, informe o nome do tenant;
3. No campo Access key, insira o valor do access key;
4. No campo Scret key, insira a secret key (por segurança a Secret Key só pode ser visualizada no momento de sua criação);
5. No campo URL da plataforma, informe a url (a URL da plataforma é obtida automaticamente baseado no tipo de banco de dados que você está utilizando - Teste ou Produção);
6. No campo URL do Edocs, insira o endereço do Edocs;
7. Clique em Confirmar, localizado no canto superior esquerdo da tela, para gravar as configurações.

A tela Bancário centraliza as configurações necessárias para habilitar a comunicação entre o sistema e as instituições financeiras BTG Pactual e Itaú. Nela, é possível selecionar o banco de integração, definir o ambiente de uso (teste ou produção) e vincular os padrões de cobrança cadastrados para cada empresa, incluindo carteira e conta bancária. Além disso, essa tela apresenta os recursos voltados à segurança e consentimento, permitindo registrar o consentimento bancário do cliente conforme o padrão selecionado, visualizar escopos autorizados e acompanhar dados como usuário responsável e data de cadastro. Em configurações avançadas, a tela também possibilita a geração e gestão do par de chaves RSA (pública e privada), utilizado para criptografar e validar informações trocadas com o banco durante a integração — garantindo sigilo, autenticação e integridade dos dados transmitidos. Com esses recursos, a tela Bancário oferece uma visão completa e estruturada das configurações financeiras, assegurando que todas as integrações bancárias funcionem corretamente e com a segurança exigida pelos padrões de mercado.

1. Na seção Configurações do Webservice de integração com o HCM, no campo URL do Webservice, informe o link;
2. No campo Usuário, informe o usuário HCM de acesso ao webservice;
3. No campo Senha, informe a senha;
4. No campo Identificador da integração, informe o identificador (no máximo 10 caracteres);
5. Clique em Testar para validar a conexão;
6. Clique em Gravar.

1. Na seção Configurações de empresa, clique no botão Novo;
2. No campo Empresa, selecione a empresa do UAU;
3. No campo Empresa HCM, informe o código da empresa HCM;
4. No campo Filial HCM, informe o código da filial HCM;
5. Clique em Gravar para salvar o vínculo;
6. Para editar um vínculo existente, abra o vínculo desejado com duplo clique e realize as alterações e clique em Gravar;
7. Para excluir um vínculo, clique no ícone de lixeira localizado na primeira coluna ou abra o vínculo desejado com duplo clique e clique no botão Excluir.

1. Na seção Configurações de vínculo com o planejamento da obra, clique no botão Novo;
2. No campo CIF HCM, informe o CIF a ser configurado;
3. No campo Insumo, informe o código do insumo do UAU (mostra apenas insumos gerais ativos);
4. No campo Est. cargo, clique no ícone de lupa e selecione o cargo do HCM desejado;
5. No campo Empresa, selecione o código e descrição da empresa do UAU (mostra apenas empresas configuradas na integração HCM e das quais tenha permissão);
6. No campo Obra, selecione o código e descrição da obra do UAU (mostra apenas obras da empresa selecionada e das quais o usuário tenha permissão);
7. No campo Mês planejamento, defina qual data será utilizada para apropriação do mês planejado;
8. Em Replanejar automático escolha pelo botão de alternância: Sim (posicionado à direita) será considerado a opção Antecipado, na falta de quantidade/verba planejada no mês de custo, será antecipado dos meses seguintes para o mês de custo. Não (posicionado à esquerda) será considerado a opção Mês, será utilizado somente as quantidades/verbas planejadas de um único mês;
9. No campo Período de vigência, informe a data de início e término do vínculo (Data de término é opcional);
10. Clique em Gravar para salvar a configuração;
11. Para editar um vínculo existente, abra o vínculo desejado com duplo clique e realize as alterações e clique em Gravar;
12. Para excluir um vínculo, clique no ícone de lixeira localizado na primeira coluna ou abra o vínculo desejado com duplo clique e clique no botão Excluir.

1. Na seção Configurações do processo de pagamento, clique no botão Novo;
2. No campo CIF HCM, informe o código do CIF do HCM (apenas números, maior que zero);
3. No campo Tipo fornecedor, escolha entre as opções: 0 – Empregados/Terceiros/Dependentes, 1 – Fornecedor pré-fixado ou 2 – Fornecedor HCM;
4. No campo Fornecedor, selecione um fornecedor entre as pessoas ativas, física ou jurídica (o preenchimento deste campo só é obrigatório apenas se selecionar o tipo 1 – Fornecedor pré-fixado no campo anterior);
5. No campo Gerar processo de serviço, utilize o botão de alternância (sim = lado direito e não = lado esquerdo) para definir se os processos de pagamento deste CIF serão de serviço;
6. No campo Serviço do processo, selecione um código de serviço (este campo é obrigatório se for um processo de serviço);
7. No campo Insumo do processo, selecione o insumo (este campo define se os processos de pagamento deste CIF terão um insumo personalizado para o item. Caso não seja preenchido, o item do processo será o insumo planejado);
8. No campo Gerar documento fiscal, utilize o botão de alternância (sim = lado direito e não = lado esquerdo) para definir se será gerado documento fiscal de forma automática e habilitar os campos Espécie e Dt. Doc. fiscal;
9. Caso seja habilitado a opção Sim no campo anterior, preencha os campos Espécie e Dt. Doc. fiscal;
10. No campo Encargo, utilize o botão de alternância (sim = lado direito e não = lado esquerdo) para definir se será gerado documento fiscal de forma automática, se escolher a alternância Sim, desabilita processo de serviço e habilita campos de imposto e receita;
11. No campo Agrupa CIF, utilize o botão de alternância (sim = lado direito e não = lado esquerdo) para definir se as pendências deste CIF serão agrupadas para gerar do processo de pagamento, se escolher a alternância Sim, habilita os campos Fornecedor proc. agrupado e Agrupar com outros CIF’s;
12. Caso seja habilitado a opção Sim no campo anterior, selecione o forncedor no campo Fornecedor proc. agrupado;
13. No campo Agrupa com outris CIF’s, utilize o botão de alternância (sim = lado direito e não = lado esquerdo) para definir se as pendências deste CIF poderão ser agrupadas com as de outro CIF para gerar processo de pagamento;
14. Clique em Gravar pra salvar as configurações;
15. Para editar um vínculo existente, abra o vínculo desejado com duplo clique e realize as alterações e clique em Gravar;
16. Para excluir um vínculo, clique no ícone de lixeira localizado na primeira coluna ou abra o vínculo desejado com duplo clique e clique no botão Excluir.

1. Na seção Configurações contábeis, clique no botão Novo;
2. No campo Empresa, selecione o código e descrição da empresa do UAU (apenas empresas configuradas na integração HCM e das quais o usuário tenha permissão);
3. No campo Conta reduzida, utilize o botão de alternância (sim = lado direito e não = lado esquerdo) para definir se receberá o código da conta ou da conta reduzida;
4. No campo Período de vigência, defina mês e ano de início e fim;
5. Em Detalhamento dos lançamentos contábeis, selecione os campos para agrupamento dos lançamentos contábeis;
6. Clique em Gravar pra salvar as configurações;
7. Para editar um vínculo existente, abra o vínculo desejado com duplo clique e realize as alterações e clique em Gravar;
8. Para excluir um vínculo, clique no ícone de lixeira localizado na primeira coluna ou abra o vínculo desejado com duplo clique e clique no botão Excluir.

Na tela Configuração de Arquivos é possível cadastrar e gerenciar os parâmetros necessários para a importação de arquivos no sistema. Nela, o usuário define as características do arquivo que será importado, como descrição, tipo de estrutura, tipo de arquivo (ex.: TXT) e status da configuração (ativo ou inativo). Além disso, a tela permite realizar o mapeamento entre os campos do arquivo e os campos internos do sistema (UAU), informando a correspondência de cada campo e sua respectiva posição no arquivo. Esse mapeamento garante que os dados sejam interpretados corretamente durante o processo de importação. A funcionalidade também disponibiliza opções para criar, gravar, excluir, cancelar e pesquisar configurações, facilitando o controle e a manutenção dos layouts utilizados, especialmente em rotinas como a gestão de débitos de financiamento, assegurando padronização, rastreabilidade e integridade das informações importadas.

1. Clique em Novo;
2. No campo Descrição, informe uma descrição para a configuração;
3. No campo Status, escolha entre as opções Ativo ou Inativo;
4. No campo Tipo de arquivo, escolha entre as opções TXT ou XLSX;
5. Na garde com os campos do UAU e de Arquivo, defina a posição de cada um. Na coluna Posição,clique na linha correspondente ao campo UAU desejado, e coloque o número da posição;
6. Clique em Gravar.