Correios + Javascript = ❤ Conheça o “Correios Brasil” a solução mais completa para trabalhar com todos os serviços dos correios 📬

Lucas Finoti
3 min readMay 13, 2020

--

Descomplicando os Correios! 📬

A maior dificuldade quando estamos trabalhando com alguma aplicação específica é encontrar uma solução que seja mais geral para os nossos problemas, então usamos diversos pacotes para sanar essa deficiência e isso pode ficar complicado para a manutenção das nossas dependências. Nos últimos dias estive trabalhando no desenvolvimento de um E-Commerce e naturalmente deveria trabalhar com a API dos correios para calcular preços e prazos dos produtos e quando estava procurando por soluções viáveis encontrei diversas alternativas mas nenhuma que fosse de fato completa, por isso resolvi desenvolver por mim mesmo uma forma mais geral para trabalhar com os correios, englobando todas as fases das compras, desde o planejamento do usuário até a chegada do produto em sua casa.

Desenvolvi um pacote que é capaz rastrear o CEP e informações sobre o endereço do usuário para facilitar no preenchimento de formulários, calcular o valor da entrega por todos os meios oferecidos pelos correios(SEDEX, PAC e etc…), assim como o prazo da entrega e as limitações encontradas no endereço fornecido e quando o usuário comprasse o produto poderia acompanhar o desenrolar do mesmo pelo próprio site, permitindo assim uma maior interação do usuário com o e-commerce, além de ser de uma enorme comodidade pois conseguiria acompanhar tudo em um só lugar.

Meu Linkedin.

O que é o Correios Brasil ?

O Correios Brasil é uma ferramenta completa para quem procura facilidade para sua aplicação, otimizando sua loja virtual e seu serviço com funcionalidades como: consultar informações sobre o CEP, calcular o preço e os prazos das entregas das encomendas e também realizar seu rastreio tudo em um único lugar, agilizando assim os processos e demandas do dia a dia. Portanto, poupando seu tempo, por isso aproveite o pacote e não esqueça de deixar uma estrela no repositório, obrigado!

Os correios brasil é dividido atualmente em 3 módulos.

CepBrasil — Responsável por realizar a consulta de um determinado CEP;

CorreiosBrasil — Responsável por calcular os valores de entrega, prazos assim como as demais informações referentes ao envio de encomendas;

RastreioBrasil — Responsável por realizar o rastreio de encomendas (Nacionais e Internacionais).

Mas enfim, vamos ao que realmente interessa… Vamos começar a CODAR !

Como instalar.

npm install correios-brasil — save

Como consultar um CEP.

Para maior comodidade, é realizado uma sanitização dos ceps usados em todo o package eliminando tudo que não for interessante e facilitando sua utilização.

Atualmente a consulta é realizada apenas pelo serviço do ViaCEP do IBGE, futuramente irei integrar mais serviços para tornar o pacote bem mais completo para vocês ;)

Exemplo de como utilizar a classe CepBrasil

Como consultar o preço e o prazo de entrega de uma encomenda

“args” é composto por diversos argumentos necessários para obtermos uma resposta correta, a descrição deles, assim como os sua formatação é muito bem explicada na documentação do pacote no Github e no NPM ou você pode encontra-las na documentação do próprio correios caso ainda tenha alguma dúvida.

Exemplo de como utilizar a classe CorreiosBrasil

Como rastrear múltiplas encomendas.

Atualmente a consulta é realizada pelo site https://www.linkcorreios.com.br/ para múltiplas encomendas.

Exemplo de como utilizar a classe RastreioBrasil

Se você gostou da proposta do correios-brasil, deixe sua estrela no repositório, umas palminhas aqui e o mais importante não se esqueça de deixar seu feedback e suas dicas.

--

--

Lucas Finoti

Chi non ha uno scopo non prova quasi mai diletto in nessuna operazione.