Dúvida
Como faço para configurar serviços do Mashups?
Ambiente
Protheus – Configurador – A partir da versão 11
Solução
Mashups são funcionalidades que permitem a configuração de alguns serviços de terceiros para importar informações para dentro do Protheus, como por exemplo serviços de CEP, consulta de CNPJ ou CPF, Sintegra, etc.
Antes da configuração dos serviços no Configurador, é necessário instalar e configurar o Proxy Mashup, conforme instruções do link abaixo:
http://tdn.totvs.com/pages/viewpage.action?pageId=224443860
Após a instalação, siga o procedimento abaixo no Configurador para cada serviço do Mashups que queira implementar:
01. Acesse o Configurador > Ambiente > Cadastros > Mashups
02. Clique em Incluir
03. Na janela que irá abrir, clique em Outras Ações > Mashups
04. Selecione o serviço de Mashup desejado e clique em Salvar
05. Em Alias, selecione a tabela que irá utilizar este serviço de Mashup
06. Clique em Outras Ações > Parâmetros
07. Nesta tela, serão configurados os Parâmetros Enviados (informações que serão enviadas para o serviço de Mashup) e os Retornos Esperados (os campos da tabela que receberão informações do serviço de Mashup baseado nos parâmetros enviados)
08. No exemplo, utilizaremos os dados de Parâmetros Enviados e Retornos Esperados do Mashup da Receita Federal – Consulta de CNPJ
Parâmetros Enviados:
Abaixo da coluna Origem, clique 2 vezes no campo, onde abrirá um combo com as opções "1- Sistema" e "2 - Usuário". A opção Sistema serve para que o parâmetro de envio seja lido diretamente do campo preenchido na tabela, indicado em "Campo". A opção Usuário serve para que o parâmetro de envio seja solicitado "manualmente" no momento de execução do Mashup, indicando em "Tipo Objeto" qual objeto enviará a informação, se será um objeto do tipo "Get" (campo de digitação de texto) ou um objeto do tipo "Combo" (uma lista de opções).
Retornos Esperados:
Nessa área são exibidos os retornos possíveis do serviço de Mashups escolhidos. Os parâmetros estão listados na coluna "Parâmetro". Você pode definir quais deles quer importar para a tabela, bastando clicar 2 vezes na coluna "Campo" do parâmetro correspondente, e selecionando o campo da tabela que receberá a informação (por exemplo, na tabela SA1, selecionar o campo A1_END para o parâmetro ENDERECO)
09. Após concluir, clique em Salvar, depois em Salvar novamente
10. Na rotina selecionada para o uso do serviço de Mashups (no nosso exemplo, o cadastro de Clientes), preencha os campos que você selecionou como Envio de Sistema (no nosso caso, o CNPJ), então clique em Outras Ações > Mashups
11. Selecione o serviço de Mashup que deseja utilizar (no nosso caso, Receita Federal – Consulta de CNPJ)
Obs.: os Mashups da Receita Federal especificamente, necessitam de Recaptcha. Maiores detalhes sobre Recaptcha nas Observações do final desta página.
12. Após os dados terem sido validados pelo órgão responsável e retornados com sucesso, aparecerá um “check” ao lado do Mashup
13. Clique em OK e as informações serão carregadas no Cadastro, nos campos selecionados previamente
Obs.: O Mashup da Receita Federal - Consulta de CNPJ, possui uma particularidade. A Atividade Econômica principal sempre será atribuída na Propriedade ATIVIDADE PRINCIPAL, conforme parametrização, pois ele é único e obrigatório, não possuindo a opção de seleção. Sobre as Atividades Secundárias, elas serão listadas para que a Propriedade ATIVIDADE seja selecionada e levada para o campo conforme parametrização do Mashup.
Importante:
- Certifique-se de liberar o acesso à URL http://mashups.totvs.com.br no servidor onde está o Protheus (Antivírus, Firewall, Proxy, ou outro tipo de bloqueio de rede);
- Certifique-se de iniciar o serviço do Protheus e do Proxy Mashup com o usuário Administrador do Sistema Operacional;
- Se precisar atualizar o Proxy Mashup, o processo consiste em desinstalar o atual, baixar uma versão mais recente e instalar novamente;
- O Mashup é baseado em consumo de web services de terceiros. Eventualmente podem ocorrer oscilações nos serviços desses terceiros, ocasionando indisponibilidade temporária no respectivo serviço dentro do Protheus;
- Se for utilizar o serviço de Mashup da Receita Federal de Consulta de CNPJ e/ou CPF, é necessário ter o arquivo recaptcha.exe na pasta do Smartclient. Maiores informações sobre o Recaptcha neste artigo: https://centraldeatendimento.totvs.com/hc/pt-br/articles/360025040092-MP-FRAME-Recaptcha-no-Mashup-da-Receita-Federal