Reading time: 8 minutes
Olá, me chamo Adilio Costa, no post de hoje iremos aprender como configurar mashups no protheus 12. Todos nós sabemos o quanto é chato quando temos que fazer algum cadastro no protheus e nesse cadastro precisamos fornecer várias informações, com o intuito de resolver boa parte desse problema foi disponibilizado no ERP protheus o recurso de mashups.
Caso você não conheça, o mashups é um recurso do protheus onde podemos configurar o ERP para se comunicar com sites da própria totvs ou sites de terceiros para obtermos informações automaticamente quando vamos efetuar um tipo de cadastro.
Por exemplo, quando vamos fazer o cadastro de um fornecedor(SA2) e precisamos obter várias informações dele, tais como, razão social, nome fantasia, inscrição estadual etc, podemos configurar o recurso de mashups onde fazemos a comunicação do protheus com o site da receita federal(na base de dados da receita) para obter essas informações automaticamente. Nesse post iremos aprender como configurar.
A seguir iremos ver as 4 etapas para configuração do mashups no protheus 12:
1 – Etapa:Criação de usuário e senha no portal Totvs Mashups
2 – Etapa: Validar o recurso de mashups que vamos utilizar
3 – Etapa: Configuração do mashups no Protheus 12
4 – Etapa: Validar no ERP protheus 12 o mashup criado
Vamos então iniciar:
1 – Etapa:Criação de usuário e senha no portal Totvs Mashups:
Primeiro devemos fazer um cadastro básico de usuário e senha no portal totvs mashups para que possamos fazer uma validação do mashups que vamos configurar, ou seja, pra sabermos se este serviço está funcionando, para isso clique em http://protheusadvpl.com.br/criacao-usuario-totvs-mashups e clique no link Criar conta do Totvs Mashups, conforme a imagem abaixo:
Na próxima tela informe seu login, senha, nome completo, empresa(opcional) e email:
Após criar seu usuário você receberá um link por email para validar o seu cadastro, acesse esse link para ativá-lo.
2 – Etapa: Validar o recurso de mashups que vamos utilizar.
Ao efetuar o login você irá visualizar vários serviços de mashups, no nosso exemplo iremos utilizar o mashup de serviço da receita federal de consulta de CNPJ:
Ao clicar no link Receita Federal – Consulta de CNPJ, você será direcionado para a tela que é mostrada na imagem abaixo:
Informe um CNPJ para ser consultado na base da receita federal(1), após isso clique no botão “Não sou um robô“(2), esse botão é um captcha(recurso utilizado pelo serviço da receita federal para garantir que quem está passando as informações solicitadas é um humano e não um software(robô)), após isso, surgirá uma nova janela pra que você marque a opção conforme aparece na seguinte tela:
Após marcar a opção aparecerá a seguinte tela solicitando que marque as imagens para validação do capcha:
Após marcar todas as imagens clique em “verificar” e aguarde o botão “Não sou robô” ficar cinza(desabilitado) e clique em “executar“(3), conforme é mostrado na imagem abaixo:
Ao final você verá os dados do CNPJ informado, conforme a imagem abaixo:
Assim validamos o recurso de mashups da receita, agora podemos configurá-lo no protheus 12.
3 – Etapa: Configuração do mashups no Protheus 12
Para configurar o mashups no protheus entre no módulo configurador:
Após isso clique em Ambiente->Cadastros->Mashups conforme é mostrado na imagem abaixo:
Após isso você será direcionado para a tela conforme a imagem abaixo, clique no “+” para adicionarmos um serviço de mashups:
Após isso aparecerá a seguinte tela:
Selecione o ALIAS(1), tabela que irá receber em seus campos os valores retornado no mashups da receita federal, nesse caso estamos selecionando a tabela de fornecedores SA2:
Após isso clique em “Outras Ações“(1) e “Mashups“(2):
Após isso você será direcionado para a tela com uma lista de serviços de mashups disponíveis, selecione o recurso de mashups da receita federal de consulta de CNPJ que fizemos a validação e clique em “Salvar“:
Após selecionar o mashups será mostrado a seguinte tela:
Após isso clique em “Outras Ações“(1) e em “Parâmetros“(2):
Na próxima etapa vamos entender o significado das opções mostrado na tela:
Conforme podemos ver, temos na tela de parâmetros de envio e retorno esperados o cabeçalho, onde informamos a origem dos parâmetros enviados ao mashups da receita(1) e a partir de que campos da SA2(fornecedores) virão esses valores(2)(A2_CGC), campo de CNPJ da tabela SA2, no cabeçalho também temos o tipo que deve ser informado, no caso, STRING e informa também que é obrigatório informar esse campo.
No item de baixo temos o campo de capcha, de onde a origem virá do usuário, pois é ele que vai marcar as opções, garantindo que é um humano que está passando aquelas informações, o valor esperado no capcha é STRING e é obrigatório informá-lo.
Na parte dos itens da tela(Retornos esperados), nós informamos quais campos da tabela SA2(fornecedores)(3) receberão os valores retornados pelo mashups da receita(4), nesse caso informamos que os campos A2_NOME(coluna Campo) receberá a RAZAO SOCIAL(coluna parâmetro), A2_NREDUZ(coluna Campo) receberá o NOME FANTASIA(coluna parâmetro), A2_NATUREZ(coluna Campo), receberá o NATUREZA JURIDICA(coluna parâmetro), o campo A2_END receberá o ENDERECO(coluna parâmetro), o campo A2_MUN(coluna Campo) receberá o nome da CIDADE(coluna parâmetro), A2_EST(coluna Campo) receberá o ESTADO(coluna Parâmetro), A2_TEL(coluna Campo) receberá o retorno de TELEFONE(coluna Parâmetro), após isso, cliquemos em “Salvar“:
Após isso você será direcionado para a próxima tela e clique em “Salvar”:
Assim finalizamos a configurações do mashups da receita no ERP protheus 12 conforme mostrado na imagem abaixo:
4 – Etapa: Validar no ERP protheus 12 o mashup criado
Para isso entramos no protheus pelo módulo compras:
No módulo compras entre em Atualizações->Cadastros->Fornecedores(rotina Mata020.prx), informe o CNPJ(1) a ser consultado e clique no botão”Outras Ações“(2), os campos que estão vazios(indicados pelas setas) serão preenchidos automaticamente:
Na próxima tela que aparece clique em mashups:
Na próxima etapa surgirá a seguinte tela, clique no mashup da receita apresentado(1):
A seguir surgirá a tela para selecionarmos as imagens, marque a opção apresentada:
Na próxima tela surgirá as imagens para marcar:
Aguarde aparecer a confirmação da validação do mashup conforme a imagem abaixo, clique em OK:
Na próxima tela veremos os campos do fornecedor preenchidos automaticamente:
Bem pessoal, com isso finalizamos mais um post, de como configurar o mashups no protheus 12, espero que você tenha entendido. Qualquer dúvida, sugestão, elogio ou crítica, deixe abaixo o seu comentário. Se esse post lhe ajudou compartilhe ele nas suas redes sociais para que possa ajudar também outras pessoas. Deixe também nos seus comentários quais temas você gostaria que eu abordasse aqui blog/site ProtheusAdvpl.
Grande abraço a você meu amigo(a) e até um próximo post.
Referências:
http://tdn.totvs.com/display/framework/Mashups
http://tdn.totvs.com/pages/releaseview.action?pageId=224443860