Este manual está em construção. Portanto, alguns links podem direcionar para páginas com conteúdo em desenvolvimento.

Integração

Essa tela visa demonstrar como configurar todas as parametrizações necessárias para a integração entre HCM e UAU. Aqui é demonstrado como realizar a conexão dos sistemas, incluindo orientações sobre permissões, cadastro de empresas, configuração dos webservices e demais etapas essenciais para garantir o correto funcionamento da integração HCM x UAU. Também é possível realizar Configurações de Integração para trabalhar com serviços externos no UAU, como de assinatura digital e armazenamento de arquivos em nuvem.

O que você pode fazer

Local: Menu > Módulo da sua escolha > Utilitários > Configurações > Integração.

Integrações

UAU API

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.
  • Os campos Usuário e senha UAU, é o usuário que será utilizado nas integrações do UAU por serviços externos quando é necessário fazer atualizações no banco de dados.
  • Se a UAU API da sua empresa tem apenas uma URL com o protocolo http, é necessário que a empresa adquira e instale um certificado SSL no servidor que contém a UAU API.
Webhook UAU

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.


  1. Clique em Adicionar webhook, localizado no lado equerdo superior;
  2. No campo Nome, preencha um nome para o webhook;
  3. No campo Url, informe a url ou endpoint para onde serão realizadas as requisições e o evento que deseja escutar;
  4. Em Lista de eventos, selecione o evento desejado;
  5. Clique em Gravar;
  6. Para editar um Webhook cadastrado, na grade Webhook cadastrados escolha qual deseja editar e abra com duplo clique. Relalize as alterações necessárias e clique em Gravar;
  7. Para excluir um Webhook cadastrado, na grade Webhook cadastrados escolha qual deseja excluir, use a tecla Delete do teclado ou abra com duplo clique e clique em Excluir;
  • Os campos Usuário e senha UAU, é o usuário que será utilizado nas integrações do UAU por serviços externos quando é necessário fazer atualizações no banco de dados.
  • As permissões da tela Webhook UAU são controladas pelo programa de permissão GECONFIGWEBHOOK.
Usuário de rede

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.

É possivel configurar um usuário administrador da rede (que possui acesso a todas as pastas pelo Windows) para acessar as pastas que serão realizados os anexos, ou seja, mesmo que um usuário que esteja acessando o Windows não tenha acesso à pasta, quando estiver configurado usuário administrador nessa tela, o usuário sem acesso pelo Windows irá conseguir anexar arquivos pelo UAU.

Integrações HCM

Comunicação (WS)

As configurações dessa tela, são necessárias para a comunicação e troca de informações com o folha de pagamento do HCM.

  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.
Empresa

As configurações dessa tela, são necessárias para realizar o vínculo entre as empresas do UAU e as empresas/filiais do HCM.

  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.

Regras e validações

  • O vínculo é sempre realizado entre empresas (não há como selecionar obra).
  • Não é permitido excluir uma configuração se houver integração de planejamento da obra para a empresa.
  • Não é permitido alterar ou excluir uma configuração se houver pendência financeira importada para a empresa.
  • Não é permitido vincular duas empresas (UAU) com o mesmo conjunto de empresa e filial do HCM.
Planejamento da Obra

As configurações dessa tela, são necessárias para configurar o vínculo entre os Códigos de Integração Financeira (CIF) do HCM e o planejamento da obra do UAU.

  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.

Regras e validações

  • É necessário liberar o acesso à tabela R024CAR no HCM, para que seja possível consultar os cargos.
  • Não é permitido repetir a mesma configuração para CIF HCM, Estrutura de cargo/Cargo, Empresa, Obra e Período de vigência.
  • Os campos CIF HCM, Insumo, Mês planejado e Replanejar automático, são obrigatórios.
  • Se preencher Estrutura de cargo, o campo Cargo também deve ser preenchido.
  • Não permitir Inclusão/Alteração/Exclusão para uma configuração que possua pendência com processo de integração/Contas a pagar gerado em sua vigência.
  • A grade não é editável e todas as ações são realizadas pela tela de manutenção.
  • Permissões de acesso controlam as ações de inclusão, alteração e exclusão (programa: GEPLANOBRAHCM).
Processo de pagamento

As configurações dessa tela, são necessárias para configurar os parâmetros de integração dos Códigos de Integração Financeira (CIF) para geração de pagamentos no UAU a partir da folha calculada no HCM.

  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.

Regras e validações

  • Não permitir mais de um cadastro com o mesmo CIF HCM.
  • Campos obrigatórios: CIF HCM, Tipo fornecedor e Fornecedor (quando aplicável).
  • Se Gerar documento fiscal estiver marcado, os campos Espécie e Dt. Doc. fiscal são obrigatórios.
  • Se Gerar processo de serviço estiver marcado, o campo Serviço do processo é obrigatório e outros campos de agrupamento, documento fiscal e insumo do processo são desabilitados.
  • Se o campo Encargo estiver marcado, os campos Tipo imposto e Código de receita são obrigatórios e processo de serviço é desabilitado.
  • Permissões controladas pelo programa GEPROCPAGTOHCM para inclusão, alteração e exclusão.
  • Não permitir alteração/exclusão para configuração com pendência de processo de integração.
  • A grade é não editável, todas as ações são realizadas via tela de manutenção.
  • Caso o Insumo do processo, não seja informado, o processo será gerado com o mesmo insumo de vínculo ao planejamento (SI).
Contabilidade

As configurações dessa tela, são necessárias para configurar os parâmetros de integração dos Códigos de Integração Financeira (CIF) para geração de pagamentos no UAU a partir da folha calculada no HCM.

  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.

Regras e validações

  • Os campos Empresa e Mês de início são obrigatórios.
  • Não permite mais de uma configuração para a mesma empresa e período de vigência.
  • A grade Configurações contábeis exibe: Empresa, Descrição da empresa, Conta reduzida, Mês de início, Mês de término, Data de alteração e Usuário.
  • A grade Agrupamento dos lançamentos exibe: Campo, Descrição campo, Data criação e Usuário.
  • As colunas dos grids não são editáveis.
  • Permissões controladas pelo programa GECONFIGCONTABILHCM para inclusão, alteração e exclusão.
  • O gerenciamento dos lançamentos contábeis sincronizados é de responsabilidade do usuário.

Este artigo ajudou você?