Tutorial Atualização – Nova API
-
Fizemos um tutorial que foi marcado como SPAM por isso segue novamente.
Sabemos que cada caso pode ser diferente, mas vou compartilhar aqui o que fizemos e nossa experiência até aqui para economizar tempo dos colegas.
Começamos removendo o plugin anterior (fizemos backup para retornar como de costume). Instalamos o novo plugin e seguimos para a interface dos Correios para validar o contrato: https://cws.correios.com.br/
Importante: aqui há um login e senha informado pelos Correios, consulte o gestor do contrato na agência e aproveite para perguntar qual é o seu “Cartão de Postagem”.
Ao efetuar login, vá primeiro para “Gestão de acesso a API’s, e clique em “Regerar código”. O código gerado não ficará disponível para consulta… Você deve salvá-lo, pois depois só terá opção de gerar um novo. Além disso, a plataforma dos Correios está sobrecarragada, portanto poderá demorar até mais de uma hora para que seu código seja validado e ativo.
Fique atento nesta tela… Nela há a informação: “Usuário do Portal Meu Correio”. No plugin achamos que deviamos informar o usuário de acesso â plataforma (somente números) e isso nos custou algum tempo, porque ao tentar capturar a lista de serviços disponíveis, era gerado um erro.
Então anota ai: “Username” no plugin, deve conter o dado neste campo “Usuário do Portal Meu Correio”.
Uma vez gerado o código, que no plugin é chamado de Access code, você poderá testar a disponibilidade, clicando em “Início”. Em seguida, clicar em “Credenciais”… O usuário já vem preenchido, cole o Access Code (Código de acesso as APIs), que você gerou e o Cartão de Postagem. E em seguida clique em “gerar token”. O Token não será solicitado na integração, pois o plugin já faz a geração de token automaticamente.
Uma vez concluídas estas etapas, vá para o Woocommerce -> Configurações -> Integrações -> Correios e entre com as informações:
1. Username (Usuário do Portal Meu Correio).
2. Access Code (Código de acesso as APIs).
3. Posting Card (Cartão de Postagem).Salve e “depois” clique no botão “Update Services List”.
Aguarde a mensagem de sucesso. É esta rotina que irá capturar todos os serviços disponíveis no contrato vigente, lá nos Correios.
Uma vez concluída esta etapa, vá para a aba “Entrega” -> Woocommerce ->Configurações ->Entrega.
Mesmo que você já tenha Métodos cadastrados, terá que criar novos… Os métodos antigos aparecerão como (Legacy). Clique em “adicionar método de entrega” e escolha “Correios (New API).
Em seguida clique em “Editar” no novo método adicionado.
Nesta tela será possível escolher o serviço, e definir o CEP de postagem (origem do produto). Também é possível marcar a caixa ” Show estimated delivery time” para que seja exibida uma estimativa de prazo de entrega nas consultas de frete disponíveis na sua loja.
Adicione as modalidades (métodos). Ative e teóricamente é tudo que você precisa para fazer funcionar.IMPORTANTE: Em algumas localidades, o SEDEX contrato não está disponível, neste caso selecione: SEDEX CONTRATO AG, os demais retornarão erro deste tipo:
“msgs”:[“ERP-006: CEP de origem nao pode postar para CEP de destino.”],”date”:”2023-09-19T02:17:21″,”path”:”uri=/preco/v1/nacional/03158″
-
Começamos removendo o plugin anterior (fizemos backup para retornar como de costume). Instalamos o novo plugin e seguimos para a interface dos Correios para validar o contrato: https://cws.correios.com.br/
No caso só é necessário se estiver usando outro plugin para integrar com os Correios, se estiver usando uma versão mais antiga deste daqui da para atualizar sem problema algum.
Fique atento nesta tela… Nela há a informação: “Usuário do Portal Meu Correio”. No plugin achamos que deviamos informar o usuário de acesso â plataforma (somente números) e isso nos custou algum tempo, porque ao tentar capturar a lista de serviços disponíveis, era gerado um erro.
Então anota ai: “Username” no plugin, deve conter o dado neste campo “Usuário do Portal Meu Correio”.Estou atualizando no plugin para usar o termo o título do campo no formulário para facilitar isso.
Mas note que na integração não fala que são apenas números para o nome de usuário.
Username (Usuário do Portal Meu Correio).
Access Code (Código de acesso as APIs).
Posting Card (Cartão de Postagem).Note que o plugin tem tradução completa para Português do Brasil. Verifique se você escolheu “Português do Brasil” como idioma do site no painel do WordPress em Configurações > Geral.
Depois de fazer isso, vá até Atualizações no painel e clique para buscar novas atualizações, feito isso no final da página tem uma sessão chamada “Traduções”, clique nela para baixar e instalar todas as traduções de temas, plugins e correções da atualização do WordPress.
Você precisa realizar um contrato com os correios utilizando um cnpj com certificado digital. Existem 4 modalidades de contratos: clube correios – grátis(até 25% de desconto nos envios por sedex e pac, pagamento no balcão), bronze 1: grátis (com benefícios de coleta no endereço acima de 11 unidades, até 25% de desconto nos envios por sedex e pac, pagamento dos envios no próximo mês), prata 1- 1000 reais de envios, ouro – 2500 reais de envio. Após o envio da documentação em até dois dias úteis você recebe o número do cartão de postagem por email.
Link de cadastro para o cartão de postagem (login e cadastro no final da página antes do footer): https://www.correios.com.br/correios-facil#
O código de acesso para o woocommerce deve ser gerado a partir desta conta cnpj dos correios, ou seja o usuário do correio fácil (cartão de postagem) e o que gera o código de acesso devem ser os mesmos.
link para gerar código de acesso do woocommerce: https://cws.correios.com.br/
Até agora continua a mesma mensagem.. .ja chequei varias vezes… todos os dígitos dos 3 campos estão corretos… No site dos correios o token é gerado normalmente… Mas no site continua a mensagem “Não foi possível recuperar a lista de serviços!”. Encontrei o log… não estava achando porque achei que estava ornado por data, mas não estava… no log tem a seguinte mensagem:
{“msgs”:[“CON-012: Os serviços não foram encontrados. Contrato: 9XXXXXXX0, CNPJ: 4XXXXXXXXXXXX6, cartão de postagem: 00XXXXXXX”],”date”:”2023-09-20T10:12:15″,”path”:”uri=/meucontrato/v1/empresas/4XXXXXXXXXXXX6/contratos/9XXXXXXXX0/cartoes/00XXXXXXXXX/servicos”} [headers] => WpOrg\Requests\Response\Headers Object ( …..
[status_code] => 404 [protocol_version] => 1.1 [success] => [redirects] => 0
Ou seja a configuração está correta, pois no código do log ele identificou o numero do contrato e o cnpj corretos… Estou certo? Ë alguma coisa com a minha conta lá nos correios que não habilitaram os serviços nessa nova API?
The topic ‘Tutorial Atualização – Nova API’ is closed to new replies.
