Tutorial de atualiza??o Nova API

  • 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 a 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 1 year, 2 months ago by Renato Caetano.
    • This topic was modified 1 year, 2 months ago by Renato Caetano. Reason: include images
    • This topic was modified 1 year, 2 months ago by Renato Caetano.
Viewing 6 replies - 1 through 6 (of 6 total)
  • Plugin Author Claudio Sanches

    (@claudiosanches)

    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)

    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)

    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)

    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)

    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)

    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