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.
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 atual deverá eventualmente cair em desuso.
Exemplo de onde é possível se localizar o número do contrato no sistema dos Correios:
(print do sistema sfe.correios.com.br
)
Cadastro no Meus Correios
A primeira etapa a ser realizada para se obter as credenciais utilizadas na nova integração com os Correios é acessar um sistema chamado Meus Correios. Caso ainda não se possua cadastro nesse sistema, pode-se utilizar o link abaixo:
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, alternativamente.
Links úteis
- Documentação da nova API dos Correios: https://www.correios.com.br/atendimento/developers/arquivos/manual-de-integracao-cliente-contrato-apis.pdf/