Skip to main content
Sticky

Requisições HTTP para consultar CEP


gustavo_serbena
Forum|alt.badge.img

Boa tarde pessoal, venho compartilhar com vocês como realizar a configuração das automações de HTTP para realizar consultas de CEP. 

 

CONFIGURANDO A REQUISIÇÃO 

Para gatilho, utilizamos o que fizer mais sentido para seu processo. Como ação, iremos selecionar a opção “Faça uma requisição HTTP” e iremos realizar a seguinte configuração:

Requisição para consulta de CEP
  • Method: GET
  • URLhttps://viacep.com.br/ws/[CAMPO_DINAMICO_CEP]/json/ (utilize um campo numérico pois a informação deve ir apenas números)
  • Authentication: No auth
  • Header/Value: Não precisa preencher

  • Tipo de conteúdo de requisição: JSON

  • Request body: Não precisa preencher

  • Response: Não precisa preencher (apenas caso deseje verificar o retorno da chamada. É uma boa pratica para verificar erros)

  •  

    JSON schema: Este campo será utilizado de base para dizer como é o retorno da chamada HTTP e será utilizado na configuração posterior da automação, sendo necessário para funcionar corretamente

    •     {
            "cep": "01001-000",
            "logradouro": "Praça da Sé",
            "complemento": "lado ímpar",
            "bairro": "Sé",
            "localidade": "São Paulo",
            "uf": "SP",
            "ibge": "3550308",
            "gia": "1004",
            "ddd": "11",
            "siafi": "7107"
          }

Após isso basta salvar e nomear sua automação como desejar. 

  • Caso tenha dúvidas sobre o endpoint utilizado, referente a volume de requisições acesse https://viacep.com.br/ 
  • Caso seu processo tenha um grande volume de consultas, existem APIs de consulta pagas que não irão lhe limitar, sendo necessário ajustar de acordo com a documentação da plataforma utilizada.  

 

CONFIGURANDO O RETORNO DA CONSULTA

Uma vez que já realizamos a consulta do CEP, agora precisamos retornar as informações para os campos desejados. Iremos utilizar o seguinte gatilho para o preenchimento dos valores consultados:

Gatilho para preenchimento da consulta

E como ação iremos utilizar “Atualize um campo no card ou registro conectado”. Para este cenário, iremos utilizar “Pipe atual” e então realizar o relacionamento dos campos que existem de retorno na requisição HTTP, do campo JSON schema, como no exemplo a seguir:

Configuração de atualização dos campos por requisição HTTP

Feito isso, basta apenas testar sua automação e espero ter ajudado você a otimizar seu processo!

15 replies

Ezequiel Souza
Forum|alt.badge.img+14

Muito legal, Obrigado por compartilhar.


antonio-nykael
Forum|alt.badge.img+1

Eu faço isso via Make. Bom sber que dá para fazer diretamente pelo Pipefy também. 

 

Obrigado por compartilhar. 


marcosmelo
Forum|alt.badge.img+18
  • Pipefy Legend
  • 1465 replies
  • December 4, 2023
gustavo_serbena wrote:

Boa tarde pessoal, venho compartilhar com vocês como realizar a configuração das automações de HTTP para realizar consultas de CEP. 

 

CONFIGURANDO A REQUISIÇÃO 

Para gatilho, utilizamos o que fizer mais sentido para seu processo. Como ação, iremos selecionar a opção “Faça uma requisição HTTP” e iremos realizar a seguinte configuração:

Requisição para consulta de CEP
  • Method: GET
  • URLhttps://viacep.com.br/ws/[CAMPO_DINAMICO_CEP]/json/ (utilize um campo numérico pois a informação deve ir apenas números)
  • Authentication: No auth
  • Header/Value: Não precisa preencher

  • Tipo de conteúdo de requisição: JSON

  • Request body: Não precisa preencher

  • Response: Não precisa preencher (apenas caso deseje verificar o retorno da chamada. É uma boa pratica para verificar erros)

  •  

    JSON schema: Este campo será utilizado de base para dizer como é o retorno da chamada HTTP e será utilizado na configuração posterior da automação, sendo necessário para funcionar corretamente

    •     {
            "cep": "01001-000",
            "logradouro": "Praça da Sé",
            "complemento": "lado ímpar",
            "bairro": "Sé",
            "localidade": "São Paulo",
            "uf": "SP",
            "ibge": "3550308",
            "gia": "1004",
            "ddd": "11",
            "siafi": "7107"
          }

Após isso basta salvar e nomear sua automação como desejar. 

  • Caso tenha dúvidas sobre o endpoint utilizado, referente a volume de requisições acesse https://viacep.com.br/ 
  • Caso seu processo tenha um grande volume de consultas, existem APIs de consulta pagas que não irão lhe limitar, sendo necessário ajustar de acordo com a documentação da plataforma utilizada.  

 

CONFIGURANDO O RETORNO DA CONSULTA

Uma vez que já realizamos a consulta do CEP, agora precisamos retornar as informações para os campos desejados. Iremos utilizar o seguinte gatilho para o preenchimento dos valores consultados:

Gatilho para preenchimento da consulta

E como ação iremos utilizar “Atualize um campo no card ou registro conectado”. Para este cenário, iremos utilizar “Pipe atual” e então realizar o relacionamento dos campos que existem de retorno na requisição HTTP, do campo JSON schema, como no exemplo a seguir:

Configuração de atualização dos campos por requisição HTTP

Feito isso, basta apenas testar sua automação e espero ter ajudado você a otimizar seu processo!

 

 

 

Obrigado por compartilhar 


marcosmelo
Forum|alt.badge.img+18
  • Pipefy Legend
  • 1465 replies
  • December 4, 2023
antonio-nykael wrote:

Eu faço isso via Make. Bom sber que dá para fazer diretamente pelo Pipefy também. 

 

Obrigado por compartilhar. 

 

Boa alternativa 


Lais Laudari

Massa @gustavo_serbena!
Muito obrigada por compartilhar aqui com todos!😃


aslay.clevisson
Forum|alt.badge.img

Muito massa Gustavo! Obrigado pelo compartilhamento!

Apesar da explicação, não consegui fazer esse processo funcionar. Tenho uma automação do tipo, estou usando formulário com URL pública para preenchimento. Gostaria que quando o usuário preenchesse o campo CEP, o restante dos campos como logradouro e etc,  fossem preenchidos. 

Algum material que poderia resolver esse problema?


gustavo_serbena
Forum|alt.badge.img
aslay.clevisson wrote:

Muito massa Gustavo! Obrigado pelo compartilhamento!

Apesar da explicação, não consegui fazer esse processo funcionar. Tenho uma automação do tipo, estou usando formulário com URL pública para preenchimento. Gostaria que quando o usuário preenchesse o campo CEP, o restante dos campos como logradouro e etc,  fossem preenchidos. 

Algum material que poderia resolver esse problema?

Opa, tudo certo? 

Pelo que entendi você está utilizando ela em campos do formulário público, correto? Se sim, nesse caso não temos como utilizar as automações nesse cenário, visto que no momento ainda não existe uma informação básica para as automações, no caso o card id

 

Ou o problema seria outro? Se sim, consegue me dar mais detalhes, consigo tentar te auxiliar por aqui


aslay.clevisson
Forum|alt.badge.img

Opa!

Seria isso mesmo, seria uma atualização mais dinâmica a medida que o formulário está sendo preenchido. Pelo visto, não temos solução para o caso por ora, obrigadão pela ajuda!


gustavo_serbena
Forum|alt.badge.img
aslay.clevisson wrote:

Opa!

Seria isso mesmo, seria uma atualização mais dinâmica a medida que o formulário está sendo preenchido. Pelo visto, não temos solução para o caso por ora, obrigadão pela ajuda!

Exatamente, no momento automações e atualizações mais dinâmicas, no startform não temos essa possibilidade infelizmente, espero ter ajudado. 


Leandro Almeida
Pipefy Staff
Forum|alt.badge.img+7

Muito Bom! 


email-websites
Forum|alt.badge.img

Cheguei até o tópico, através do curso realizado.
Repeti os proceidmentos. Achei que tivesse feito alguma coisa errada, mas descobri que a automação funciona nos cards, mas não funciona no formulário público, e é justamente onde faria mais sentido esta automação. Oferecer ao cliente a facilidade de preenchimento automático, facilitando o trabalho de fornecimento das informações. 
Alguma solução está sendo pensada para que funcione também no Form?


  • New Member
  • 1 reply
  • August 22, 2024

Boa tarde! Para configurar a automação de consultas de CEP, escolha um gatilho apropriado, selecione “Faça uma requisição HTTP” e ajuste a configuração conforme necessário para seu processo.

Para mais dicas, você pode conferir o FM Whatsapp, onde outros compartilham experiências e soluções.


vinicius-cleim

Obrigado por compartilhar!

Estou tendo problema com o RETORNO DA CONSULTA DO CEP realizei a configuração da automação de acordo com as instruções acima. Na minha primeira tentativa obtive sucesso em realizar a consulta, porém não obtenho mais o retorno da consulta. Já apaguei e realizei novamente o processo mas não obtive mais sucesso. Alguém sabe o que pode ter ocorrido? 

 


fernanda.cunha
Community Manager

Olá @vinicius-cleim, tudo certo? Você chegou a entrar em contato com o nosso time de suporte? Pode acessar o chat direto da plataforma ou mandar um email para support@pipefy.com, acredito que nosso time vai conseguir te auxiliar melhor nessa questão.


vinicius-cleim
fernanda.cunha wrote:

Olá @vinicius-cleim, tudo certo? Você chegou a entrar em contato com o nosso time de suporte? Pode acessar o chat direto da plataforma ou mandar um email para support@pipefy.com, acredito que nosso time vai conseguir te auxiliar melhor nessa questão.

Olá @fernanda.cunha!
Obrigado, abri um chamado com o time de suporte sim.


Cookie policy

We use cookies to enhance and personalize your experience. If you accept you agree to our full cookie policy. Learn more about our cookies.

 
Cookie settings