Como configurar Mashup de CEP Protheus?!

Como configurar Mashup de CEP Protheus?!

Como configurar Mashup de CEP Protheus?!

Vamos aprender hoje a como configurar o Mashup de CEP do sistema Protheus. Primeiro para contextualizar responderemos as seguintes perguntas: O que é Mashup?! E como utiliza-lo poderá trazer benefícios a minha empresa?!

Mashup é um dos recursos da TOTVS para consultar informações de interesse público disponibilizada na web. Permitindo assim o aproveitamento da informação no sistema. Para isso o Mashup precisa ser configurado para cada tabela aonde você deseja utilizá-lo.  A estrutura da solução de Mashup proposta, permite acessar o conteúdo desejado e inserir automaticamente no cadastro do Protheus.

Já tendo o Protheus instalado como configurar Mashup de cep dos Correios?! O processo deve ser feito em duas etapas:

  1. Configuração
    • Acessar o configurador, sigacfg, para isso geralmente tem que ter a senha do administrador ou um usuário com permissão de administrador.
    • Siga o menu Ambiente-> Cadastro-> Mashup opção incluir.
    • Botão Ações Relacionadas -> Mashups localize a opção “Correios – Pesquisa de CEP” e marque a caixa com “X”. E clique em ok. Note que são preenchidos os automaticamente os campos Mashup, Título e Descrição.
    • 3protheus_novo_mashup_cep_correios

      Como configurar mashup cep Protheus – marcando mashup de cep

    • No campo Alias informe a tabela na qual você deseja configurar o mashup, no caso estaremos configurando na tabela de cliente SA1. Existe uma consulta nesse campo que pode ser utilizada para localizar.
    • Clique no botão ações relacionadas -> Parâmetros conforme mostra imagem abaixo.
    • protheus_novo_mashup_cep_parametros

      Como configurar mashup de cep Protheus – Parametrizar

    • Será aberta uma tela contendo informações dos parâmetros de envio e de retorno esperados. Na parte superior ficam os campos de envio, ou seja, são o(s) campo(s) que eu irei informar manualmente pra que a web localize essa informação que eu estou precisando. Nesse exemplo aqui devemos informar a origem se é de sistema ou de usuário no nosso caso será de sistema. Na coluna campo em baixo deverá ser informado aonde fica o campo do CEP no sistema poder ser digitado A1_CEP ou consultado pela lupa ou F3.
    • 5protheus_novo_mashup_cep_parametros_configurando

      Como configurar mashup de cep Protheus – parametrizando envios e retornos.

    • Sobre a parte de retornos devem ser informados quais campos vão receber as informações fornecidas pelos webservice. Nesse caso você pode digitar o nome do campo se já souber ou consultar clicando na lupa ou F3.
  2. Testes de validação:
    • Entre no Protheus pelo módulo financeiro.
    • Acesse o menu Atualizações -> Cadastros -> Clientes.
    • Para testar o Mashup Clique na opção incluir e preencha o campo de envio que nesse exemplo foi o de cep preencha o campo de cep com o cep do cliente.
    • Clique no botão Ações Relacionadas-> Mashups.
    • protheus_novo_mashup_cep_novo_cliente

      Como configurar mashup de cep protheus – Testando mashup cep

    • Aparecerá a tela com o Mashup do Correio de cep você deverá clicar na figura à esquerda. Aguarde ele consultar os dados, isso depende diretamente de conexão de internet, velocidade de conexão e disponibilidade do serviço. Quando bem sucedida aparecerá um check em verde após o nome “Correios – Pesquisa de CEP”. Clique em ok.
    • 7protheus_novo_mashup_cep_novo_cliente_puxando

      Como configurar mashup de cep Protheus – obtendo informações do webservice.

    • O sistema retornará para a tela de cadastro de cliente com os dados preenchidos. Observe que os campos informados em retornos esperados estão preenchidos com as informações fornecidas pelos correios.
    • 8protheus_novo_mashup_cep_cliente_prenchido

      Como configurar mashup de cep Protheus – retornos esperados.

Esse recurso de configurar Mashup de cep Protheus tem facilitado e garantido informação de fonte de segura de muitas empresas. Depois que aprendeu a como configurar Mashup de CEP Protheus, desfrute desse recurso e bom trabalho!

Visite o www.userfunction.com.br para ver mais artigos!

Por favor deixe as suas dúvidas nos comentários aqui abaixo, terei prazer em respondê-los.

17 comentários

  • SANDRA MACHADO

    OLA,

    CONFIGUREI UM MASHUP PARA PEGAR O ENDEREÇO PELO CNPJ.
    VOCÊ SABE ME DIZER COMO POSSO CONFIGURAR PARA QUE O MASHUP TRAGA O NUMERO JUNTO AO ENDEREÇO ?

    OBRIGADA !

    • Oi Sandra! Faz assim no retorno do nr da casa você coloca também o campo do endereço A1_END ou A2_END dependo da tabela que você está configurando. Então como tanto o endereço como o numero estarão apontando para o campo de endereço o sistema vai concatenar ao final do endereço. Espero ter ajudado! Grata!

  • Lucas Amicci

    Boa tarde!
    Configurei o mashup da maneira que você explicou entretanto quando puxei o CEP no cadastro de cliente, o protheus me retornou a seguinte mensagem:

    The remote server returned an error: (403) Forbidden.
    Em: SOAPCEPConsultaState.OnExecute

    Sabe me dizer o porque isso está acontecendo?
    Obrigado.

    • Oi, Isso ainda não aconteceu comigo, mas como o mashup consulta um serviço web, verifique seu firewall e antivírus. Pode ser que um dos dois esteja bloqueando seu acesso ao serviço dos correios. Se alguém tiver passado por isso comente aqui compartilhe.Grata!

      • Jepherson

        Estou com o mesmo problema

      • Bom dia pessoal, configurei o mashup de buscar os dados na receita pelo CNPJ e após informar o captcha do site da receita na tela do Protheus ele dá a msg: A execução do mashup foi cancelada. Bom aqui na empresa temos um Mikrotik que gerencia a rede, alguém sabe se é algum bloqueio de porta ou algo assim que tenho que liberar?

        • Oi Charlles, bom dia! Realmente os bloqueios de rede influenciam bastante e isso deve ser verificado pra que você consiga ter sucesso nessa configuração. Um bom teste é tentar fazer a mesma consulta manualmente no site da receita e ver se consegue ou tem algum bloqueio realmente na rede. Espero que ajude, Grata,

  • Joao

    Estou com esse peoblema tb, consulta cep nos correios funciona mas o cpf e cnpn pela receita, nao…. alguma dica?

  • Gustavo

    Quando digitamos o cnpj do cliente aparece o captcha, mas não importa quantas vezes digitemos (maísculas e minusculas), sempre volta ao captcha como se nao estivessemos digitando errado…e isso não acontecia

    • Oi Gustavo! Tiveram mudanças no serviço de mashup fornecido pela receita. Ouvi comentar algo relacionado a ser obrigatório o envio além no cpf/cnpj também da data de abertura/nascimento. Sugiro que você verifique como funciona essa consulta manualmente no site da receita, para que você possa veja o que precisa ser alterado no seu mashup. Grata.

  • Celio De Jesus Silva

    Boa Noite. Parece incrível, mas será que alguém em todo a Web tem como configurar certinho a Cotação de Moedas pelo Banco Central pelo Mashups do Protheus? Procurei em todo lugar que pude na internet com vários tipos de pesquisa e a única coisa que acho e como configurar Cep e CNPJ, isso foi de grande ajuda. Mas Cotação de Moedas nem no TDN.

  • Patricia

    ola
    vi no seu exemplo de mashup do cep, que ele trouxe o numero do endereço, ele deveria trazer mesmo? Pois na minha consulta só retorna o endereço (sem numero)

    • Oi Patricia! Vai depender do CEP escolhido. A maioria realmente não tem o numero vinculado, mas alguns ceps de grande condomínios por exemplo já vem o número vinculado sim. Esse foi o caso do exemplo citado por isso veio até com o numero. O Sistema vai retornar as informações que estão no site dos correios. Grata =)

  • Patricia

    obrigada=). por acaso voce sabe se dá para integrar protheus com correio para rastreamento de objetos?