Configurando uma integração com o RM

Você irá configurar uma conexão com o RM. Essa configuração é muito simples, você precisará das seguintes informações:

• Chave de API da integração: gerada pelo Portal do Aprovador. Você pode verificar como obtê-la através do artigo Como configurar uma integração?;
• O diretório da biblioteca do RM (RM.Net).
• O Alias do banco de dados.
• Os Webservices do RM habilitados ou habilitá-los durante a instalação.
• Usuário e senha do RM com permissões para executar os processos de aprovação.
• Usuário e senha do banco de dados com permissão para leitura.

Para adicionar a integração:

O primeiro passo é verificar se os WebServices estão ativos, como mostrado no artigo Como habilitar os WebServices do RM? do Blog do Aprovador. Caso não estejam, ative-os, seguindo os passos do artigo.

Abra o Aprovador Conector, caso ele já esteja em execução, você poderá abri-lo através do ícone do Aprovador na área de notificações do Windows.

Clique no botão + no canto inferior esquerdo para adicionar uma nova integração. É necessário informar qual o tipo de integração que está sendo criada (Produção ou Sandbox), lembrando que Sandbox é utilizado para integrações de homologação. A chave de API somente será adicionada se o tipo de integração for compatível com o tipo para o qual a chave foi criada. Após isso, informe a chave de API. É importante citar que somente uma integração deve ser criada por chave de API.     

                                                                                                     

O formulário para configurar uma integração com o RM será apresentado. Ele estará dividido nas abas Conexão, Pacotes, Usuários e Relatórios. Na aba Conexão serão informados. 

• O diretório onde a biblioteca do RM (RM.Net) está instalado.

 

• O Alias do banco de dados e usuário e senha com, no mínimo, permissão para leitura no banco de dados.

 

• A URL do WebService e usuário e senha com permissão para ler e escrever no RM.

• Um diretório específico para armazenamento dos anexos (opcional).           

          

Na aba pacotes poderão ser escolhidos os módulos em que o Aprovador pesquisará as pendências no RM. O cliente deve selecionar e configurar aqueles que deseja que o Aprovador realize a busca por pendências. Esses módulos encontram-se abaixo.  

Nucleus

O Nucleus possui três campos que podem ser habilitados e um para que o cliente escolha o período em que o Aprovador realizará a busca por pendências.

O primeiro campo definirá se usuários aprovadores precisam, obrigatoriamente, possuir consultas SQL para que recebem documentos para aprovar. Se o campo “É obrigatório o uso de consultas SQL” estiver marcado, cada usuário receberá os documentos referentes ao retorno da consulta criada para ele na aba usuários, aqueles que não possuírem consultas, não receberão documentos.

Clientes que utilizam a aprovação por item e desejam faturar o movimento após a aprovação do último item devem marcar o segundo campo “Faturar após aprovação do último item”.

O terceiro campo “Cancelar movimentos rejeitados” faz com que o Aprovador cancele o movimento que foi rejeitado pelo usuário. Caso esse campo não esteja marcado, o movimento continuará pendente no RM, e retornará ao Aprovador se for alterado.

Por fim, o período que o Aprovador utilizará para buscar pendências no ERP deverá ser definido. Por padrão, a busca é realizada nas pendências criadas nos últimos 30 dias.

Nucleus - Faturamento de movimento

O Nucleus – Faturamento de movimento possui um campo que pode ser habilitado, outro para a definição do tipo que aquele movimento se tornará após o faturamento, além do campo para que o cliente escolha o período em que o Aprovador realizará a busca por pendências.

Da mesma forma que para o Nucleus, o primeiro campo definirá se usuários aprovadores precisam, obrigatoriamente, possuir consultas SQL para que recebem documentos para aprovar. Se o campo “É obrigatório o uso de consultas SQL”. Se o campo estiver marcado, cada usuário receberá os documentos referentes ao retorno da consulta criada para ele na aba usuários, aqueles que não possuírem consultas, não receberão documentos.

No campo “Tipo de movimentos”, é possível escolher qual tipo o movimento se tornará após aprovados todos os itens e faturado o movimento. Também é possível escolher o tipo de movimento que o movimento se tornará inserindo uma consulta SQL. Todos os movimentos incluídos nessa parametrização serão faturados após a aprovação de todos os itens do movimento.

Por fim, o período que o Aprovador utilizará para buscar pendências no ERP deverá ser definido. Por padrão, a busca é realizada nas pendências criadas nos últimos 30 dias.

Agilis

O Agilis possui um campo que o fluxo do Agilis deve ser configurado outro para que o cliente escolha o período em que o Aprovador realizará a busca por pendências.

O campo “Tipos de atendimento” utiliza o fluxo do Agilis para definir o que será feito com o documento após aprovação ou rejeição. Dentro do campo, é possível escolher para qual etapa o documento será enviado em cada caso.

Os tipos de atendimento deverão ser adicionados para que o Aprovador busque por atendimentos no Agilis.

Após adicionados os movimentos, o fluxo de atendimento deverá ser configurado para cada etapa para onde seguirão, ou se serão concluídos os atendimentos, quando aprovados pelo usuário. Da mesma forma, os atendimentos reprovados terão suas próximas etapas ou cancelamento definido.

As etapas de conclusão do atendimento devem ter a opção “Conclusão” marcadas.

O período que o Aprovador utilizará para buscar pendências no ERP deverá ser definido. Por padrão, a busca é realizada nas pendências criadas nos últimos 30 dias.

Fluxus – Borderos/ Fluxus - Acordos financeiros/ Solum – Pedidos extras 

Fluxus – Borderos é o modulo, que quando ativo, buscará os borderôs pendentes e os levarão para aprovação.

Da mesma forma, o Fluxus – Acordos financeiros encaminhará os acordos financeiros para a aprovação.

Finalmente, o Solum – Pedidos extras encaminha as requisições de materiais extras para um projeto para aprovação.

Em todos os três acima, apenas se escolherá o período que o Aprovador utilizará para buscar pendências no ERP deverá ser definido. Por padrão, a busca é realizada nas pendências criadas nos últimos 30 dias.

 

Na aba usuários, deverá ser cadastrada, para cada um dos usuários, a consulta SQL, que deverá ser realizada para cada um deles, caso o cliente deseje realizá-las para que retornem quem deve receber as pendencias para aprovação.

 Na aba relatórios, deverá ser configurado para cada relatório, o movimento que, quando realizado, o enviará em anexo ao documento. Existem dois tipos possíveis para configuração:

• Relatório genérico: Passa como parâmetro o código do movimento. Sempre que aquele movimento for realizado, será gerado o relatório cadastrado para o ID do movimento.
• Mapa de cotação: Sempre o que o movimento cadastrado for realizado, será gerado o mapa de cotação cadastrado no RM.

 

Após finalizar a digitação, clique no botão Aplicar para salvar as alterações e depois, na parte superior da tela no botão Iniciar Serviço, para iniciar o serviço de sincronização do Aprovador Conector.

Pronto! A sua integração com o RM está concluída. Neste ponto, o Aprovador está sincronizando os documentos com o seu ERP. Para verificar se a integração está funcionando normalmente você pode acompanhar os logs da integração, veja mais detalhes na FAQ Como faço para acompanhar os logs das integrações?.

Com a integração funcionando, veja como cadastrar novos usuários para aprovar documentos.

* Totvs RM são marcas registradas de propriedade da Totvs S/A.