Tutorial de atualização Nova API

  • Renato Caetano

    (@recaetano)


    2 years, 8 months ago

    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″

    • This topic was modified 2 years, 8 months ago by Renato Caetano.
    • This topic was modified 2 years, 8 months ago by Renato Caetano. Reason: include images
    • This topic was modified 2 years, 8 months ago by Renato Caetano.
Viewing 6 replies - 1 through 6 (of 6 total)
  • Plugin Author Claudio Sanches

    (@claudiosanches)

    2 years, 8 months ago

    Então anota ai: “Username” no plugin, deve conter o dado neste campo “Usuário do Portal Meu Correio”.

    Obrigado pelo feedback, vou atualizar a descrição do campo para indicar isso, mas por enquanto atualizei a tradução para ajudar.

    Você deve ir para a página inicial da plataforma dos Correios, 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.

    Essa parte não é necessária para fazer integração com o plugin, até porque o token vai ser gerado pelo plugin, se já tiver gerado nessa etapa ai, os Correios vai retornar o mesmo token pro plugin, lembrando que esses tokens expiram depois de um dia e o plugin vai gerenciar isso para todo dia gerar um novo token.

    Entretanto eu acho valido usar isso dai como um teste e para validar se as suas informações estão corretas, mas como eu falei, não é um requerimento para o plugin funcionar.

    No nosso caso, estamos ainda sem retorno com Sedex… É exibida a mensagem no log: “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″

    Acreditamos ser alguma limitação no perfil do cliente lá nos Correios, ou da plataforma, já que o cliente em atendimento está em uma pequena cidade. Estamos acompanhando com a agência.

    Isso é realmente com os Correios, algo no contrato que impede isso ou tem algo errado do lado deles.

    Uma dica, eu percebi que você esta usando o plugin em Inglês, ele em Português fica bem mais simples para ser configurado com certeza.

    Para usar Português como língua principal no WordPress, basta ir no admin do WordPress, ir em Configurações > Geral, onde é possível trocar a língua do site (Site Language) para “Português do Brasil”.
    Fazendo isso o WordPress vai baixar e instalar a tradução para o núcleo do WordPress, com isso você pode ir em Atualizações e clicar para buscar atualizações, uma vez que procurou as atualizações, vá até a sessão “Traduções” e clique no botão para baixar as traduções também.

    Assim você vai conseguir baixar a tradução desse plugin e de vários outros, além de baixar traduções de tema e revisões da tradução do núcleo do WordPress.

    Thread Starter Renato Caetano

    (@recaetano)

    2 years, 8 months ago

    Obrigado Claudio. Sentimos a necessidade de explicar, porque este é um processo traumático (e-commerces parados) e imaginamos que tem muita gente com dificuldade. Quero aproveitar e parabenizá-lo pela dedicação e compromisso. Suas contribuições muito importantes, e a comunidade confia no seu trabalho. Espero que continue com essa energia por muito tempo!

    Thread Starter Renato Caetano

    (@recaetano)

    2 years, 8 months ago

    Aproveito a oportunidade para sugerir: Incluir Código do serviço na lista de opções. A agência está nos orientando a mudar para SEDEX Convencional. Não sabem dizer qual é entre as opções… Se tivesse o código facilitaria esta comunicação e garantiria melhor assertividade.

    Plugin Author Claudio Sanches

    (@claudiosanches)

    2 years, 8 months ago

    Obrigado pela sugestão, vou adicionar o código junto na próxima atualização.

    No seu caso não seria o “PAC CONTRATO AC”, no lugar de “PAC CONTRATO AG”?

    Plugin Author Claudio Sanches

    (@claudiosanches)

    2 years, 8 months ago

    Além que o ERP pode estar usando uma API antiga dos Correios ainda para funcionar.

    Tem também o problema que alguns usuários estão tendo do contrato estar desatualizado e precisar entrar em contato com os Correios para ativar o contrato para a API nova.

    Plugin Author Claudio Sanches

    (@claudiosanches)

    2 years, 8 months ago

    Sim, estou vendo ainda uma solução para colocar no plugin pra quem não tem contrato.

Viewing 6 replies - 1 through 6 (of 6 total)

The topic ‘Tutorial de atualização Nova API’ is closed to new replies.

Tags