Atenção!

Para a utilização na nova API dos Correios, é necessário haver contrato com os Correios.

Lojistas que utilizam cotação com os Correios de forma anônima/sem contrato deverão ou contratar os Correios ou utilizar outra forma de entrega (planilha de frete, por exemplo). Esses lojistas sem contrato não conseguirão utilizar a nova API dos Correios.

Para isso, é necessário:

  • Estar de posse do Número de Contrato
  • Possuir cadastro no sistema Meus Correios
  • Autenticar no sistema CWS Correios
  • Gerar ou obter uma senha de API


Abaixo, explica-se cada uma das etapas.

Número de Contrato

Todo lojista com contrato com os Correios possui um Número de Contrato e um Número de Cartão de Postagem (que podem ou não ser o mesmo). É necessário que o lojista esteja de posse desses números para que seja possível configurar corretamente o meio de entrega para cotação.

Segue abaixo o modelo do cartão  e onde localizar cada item

Com a nova API dos Correios, não é mais possível realizar simulações de preço e prazo com os Correios de forma anônima/sem contrato. Lojistas que desejam continuar utilizar a cotação de frete com os Correios precisarão contratar os Correios ou mudar para outro tipo de meio de entrega, visto que o web service  desde março de 2023, não está mais operacional.

Exemplo de onde é possível se localizar o número do contrato no sistema dos Correios. Para acessar, utilize o link, sfe.correios.com.br.

Após clique na opção Contratos de acordo com o print.

Cadastro no Meus Correios

A primeira etapa a ser realizada para se obter as credenciais utilizadas na nova integração é acessar o sistema chamado Meus Correios. 

https://meucorreios.correios.com.br/app/fazer-cadastro.php.

Atenção!

Caso já exista um cadastro nesse sistema, não é necessário criar um novo cadastro.

Siga as instruções do web site para a conclusão do cadastro e anote as credenciais utilizadas no cadastro, pois serão necessárias nas próximas etapas.

Login no CWS Correios

Uma vez de posse das credenciais de acesso ao sistema Meus Correios, é necessário utilizar essas mesmas credenciais para se autenticar na aplicação CWS Correios:

https://cws.correios.com.br/dashboard/pesquisa

Gerar ou obter uma senha de API

Após acessar o sistema CWS Correios (etapa imediatamente anterior), navegue até a tela de "Gestão de acesso a API's" utilizando o menu lateral e crie gere uma senha de API seguindo as instruções da tela.


Atenção!

Não é necessário gerar outra senha de API, caso o lojista já tenha gerado alguma anteriormente e a tenha anotado. 

Sugere-se evitar utilizar caracteres especiais na senha a ser utilizada.

Atenção!

Pode levar até 20 minutos para o sistema dos Correios refletir as alterações realizadas.

Informações no Cadastro do Commerce

As informações que devem ser fornecidas no cadastro de meios de entrega do Commerce, para a utilização da nova API dos Correios, são as seguintes:

  • Nome de usuário: CNPJ utilizado no cadastro na aplicação Meus Correios
  • Senha: senha/código de API gerado na tela de "Gestão de acessos a API's" do CWS Correios
  • Número do contrato: número que identifica um usuário como cliente de contrato dos Correios
    • Não é o número que identifica se o meio de entrega é PAC ou SEDEX, mas um sim um número de contrato do lojista com os Correios, fornecido pelo próprio Correios
    • Cada lojista tem o seu próprio número de contrato que é único
    • Tente utilizar primeiro o número de contrato do lojista com os Correios; no entanto, existem casos em que se deve utilizar o número do cartão postagem como alternativa.

Links úteis


  • Sem rótulos