Central de Ajuda Ir para o site da Olist Meus chamados

Como funciona a integração com os Correios

Para utilizar a integração com os Correios no E-commerce da Olist, você pode optar por duas modalidades: sem contrato ou com contrato. Cada uma possui características e funcionalidades diferentes.

Sem contrato

É possível utilizar a integração com os Correios mesmo sem possuir um contrato. Nesse caso:

  • A postagem dos pedidos deve ser realizada diretamente no balcão de uma agência dos Correios;
  • Não há serviço de coleta dos pedidos;
  • Não é possível realizar o rastreamento das encomendas pela plataforma.

Para essa modalidade, recomendamos cadastrar a forma de entrega utilizando uma  planilha de frete com os valores de balcão praticados pelos Correios.
 

 
 

Com contrato

Se você possui (ou pretende contratar) um contrato com os Correios, terá acesso a funcionalidades adicionais, como:

  • Coleta dos pedidos;
  • Cotação de frete integrada ao ERP;
  • Demais recursos disponíveis conforme o contrato firmado com os Correios.

Caso ainda não possua um contrato, entre em contato com uma agência dos Correios, preferencialmente a mais próxima da sua empresa, para verificar os planos disponíveis.

Após a contratação, siga as orientações deste artigo para configurar a integração.

Configurações prévias

Antes de iniciar a integração com os Correios, é necessário configurar algumas informações no painel administrativo.

  • Acesse Configurações > Entrega > Configurações Gerais e preencha os seguintes campos:
  • CEP de origem: informe o CEP do local de onde os pedidos serão enviados.
  • Dias da semana: selecione os dias em que as postagens dos pedidos serão realizadas.
  • Horário de corte: defina o horário limite para processamento dos pedidos. Pedidos realizados após esse horário serão considerados para postagem no próximo dia útil configurado.

O que é necessário para a integração?

  •  Usuário: Utilizado para acessar o painel dos Correios.
  • Senha: Utilizada para acessar o painel dos Correios.
  • Cartão de postagem: Código do cartão nos Correios.
  • Valor declarado: Habilite o gatilho para definir se utilizará este serviço adicional, que garante a indenização do objeto no valor declarado em caso de avaria ou extravio.
  • Aviso de recebimento: o AR é um serviço adicional dos Correios que permite ao remetente obter a comprovação da entrega realizada ao destinatário.

Com o AR habilitado, o serviço adicional será considerado no cálculo e na postagem da encomenda, caso você opte por utilizá-lo. Para que o AR seja associado corretamente ao objeto, é necessário informá-lo no momento da emissão da etiqueta ou da preparação da postagem.

Importante: se a encomenda for apresentada em uma agência dos Correios sem o AR ter sido configurado previamente, o serviço poderá não ser vinculado ao objeto.
Com o AR desabilitado, a postagem será realizada normalmente, sem a contratação desse serviço adicional. A utilização do AR pode gerar custos adicionais, de acordo com as condições do seu contrato com os Correios.

 Códigos dos serviços contratados

*Os serviços efetivamente disponíveis podem variar conforme as características e condições do contrato firmado com os Correios.

  • Sedex: Código serviço 03220
  • Sedex Reverso: Código serviço 03247
  • Sedex 10: Código serviço 03158
  • Sedex 12: Código serviço 03140
  • PAC: Código serviço 03298
  • PAC Reverso: Código serviço 03301
  • Mini Envios: Código serviço 04227

Observação: Em caso de dúvidas referente o código de serviço a ser utilizado em sua operação, contate o suporte dos Correios.

 
 

Passo a passo para integração

No Correios WebService

Caso ainda não tenha um Token API, siga o passo a passo abaixo:

  1. Acesse o painel CWS para resgate do token API.
  2. Na plataforma, clique em Gestão de acesso a API's no menu lateral esquerdo.

  1. Preencha com a senha utilizada para logar no portal e clique em Gerar código (caso já possua um token, o botão exibirá Regerar código).

  1. Copie o token API exibido e salve em um local seguro.

Observação: Caso você utilize o token dos Correios em diferentes plataformas, ao gerar um novo token, lembre-se de atualizá-lo em todos os demais sistemas ou locais onde ele estiver configurado. 

 
 
 

No admin da loja

1. Cadastre a integração

Acesse Configurações > Entrega > Integrações, clique no ícone de lápis ao lado de Correios e preencha os campos:

  • Código da empresa: Usuário utilizado para logar no Correios WS.
  • Senha: Token API gerado anteriormente.
  • Cartão postagem: Código do cartão de postagem enviado pelos Correios no fechamento do contrato.
  • Declarar valor: habilite ou desabilite essa opção de acordo com a sua necessidade. 
  • Aviso de recebimento: habilite ou desabilite essa opção de acordo com a sua necessidade. 

2. Cadastre os grupos de entrega

Acesse Configurações > Entrega > Grupos de Entrega. Clique no ícone "+" no canto superior direito, preencha o nome do grupo (PAC ou SEDEX), habilite o grupo e clique em Salvar.

Importante: crie um grupo de entrega individual para cada modalidade (PAC e SEDEX).

 

3. Adicione as formas de entrega

Acesse Configurações > Entrega > Formas de entrega, clique no ícone "+" no canto superior direito e preencha os campos da seguinte forma:

  • Nome: PAC ou SEDEX.
  • Descrição: PAC ou SEDEX.
  • Origem: Correios.
  • Tipo de Entrega: Selecione o grupo de entrega criado.
  • Código de serviço: Informe o código do serviço contratado.

 
 
 
 

Entenda como funciona os dados de preenchimento

Usuário

Informe o usuário fornecido pelos Correios.

Na maioria dos contratos, esse campo corresponde ao CNPJ da empresa contratante. Já nos contratos mais recentes, o padrão adotado também é o CNPJ.

Caso tenha dúvidas sobre qual informação utilizar, consulte o contrato firmado com os Correios ou entre em contato com os canais de atendimento da instituição.


Senha

Neste campo, informe o código de acesso às APIs dos Correios, gerado no portal Correios Web Services (CWS).

Atualmente, esse código possui 40 caracteres, o que pode ajudar na validação do preenchimento.

Caso ainda não tenha gerado esse código, consulte o material com o passo a passo para emissão no portal dos Correios.


Cartão de Postagem

Informe o número do Cartão de Postagem com 10 dígitos.

Se o número informado pelos Correios possuir menos de 10 caracteres, complete-o adicionando zeros à esquerda até atingir o total de 10 dígitos.

Exemplo:

Cartão informado pelos Correios:12345678
Preenchimento no ERP:0012345678


Token

O Token é utilizado pelo sistema para realizar a autenticação da integração com os Correios.

Quando necessário, essa informação é disponibilizada pelos próprios Correios durante a configuração do acesso. Caso tenha dúvidas sobre esse dado, consulte a documentação ou os canais oficiais de atendimento dos Correios.

 
 

Em caso de contingência operacional dos Correios

Se houver uma indisponibilidade ou imprevisto nos serviços dos Correios, você poderá utilizar planilhas de frete como alternativa para manter as cotações funcionando.

Após criar as formas de entrega, envie um e-mail para ajuda.ecommerce@olist.com solicitando a geração das planilhas de frete.

Informação

A integração online é recomendada para o uso habitual, pois consulta informações atualizadas dos Correios em tempo real e reduz a necessidade de manutenção manual de prazos e preços. A planilha é indicada para situações pontuais de contingência, como instabilidades temporárias e indisponibilidades operacionais.

 
 
 

 

Sua dúvida foi esclarecida?