Correios: ligar e configurar a integração (contrato, cartão de postagem e código de acesso)

O que a integração faz

Com o contrato conectado, o Hap fala direto com a API dos Correios: cota SEDEX e PAC mostrando valor e prazo, cria a pré-postagem, devolve a etiqueta em PDF pronta para imprimir, gera a declaração de conteúdo e traz o rastreio do objeto. O código de rastreio volta para o pedido, então quem abre a venda vê o mesmo número que o cliente recebe.

Trava dupla: recurso ligado + integração ativa

São duas chaves diferentes e as duas precisam estar ligadas. A primeira é o recurso "Etiqueta de envio pelos Correios", em Configurações Gerais > Recursos em teste, que só o administrador enxerga — é ele que faz o card Correios aparecer em Integrações. A segunda é a caixa "Integração ativa", dentro do próprio painel dos Correios. Com apenas uma das duas ligadas, nenhuma tela do ERP oferece etiqueta: o campo "Canal de envio" nem chega a aparecer no pedido.

Onde acessar o painel

1. 1

   Abra Configurações > Integrações. O card Correios fica na lista de integrações disponíveis, com a situação atual: "Pendente" e o aviso "Configurar contrato" enquanto o contrato não estiver cadastrado.

   123

2. 2

   Clique em "Abrir painel". O caminho completo aparece no topo da tela: CONFIGURAÇÕES > INTEGRAÇÕES > CORREIOS.

Preencher a conexão

A primeira seção do painel é a Conexão: a caixa "Integração ativa", o ambiente, o usuário do Meu Correios, o código de acesso e o cartão de postagem, com o botão "Testar conexão" logo abaixo. O selo no canto superior direito acompanha o preenchimento e passa de "Não configurado" para "Integração ativa".

12345678

1. 1

   Ambiente: escolha Produção para despachar de verdade. Homologação existe para testes do time técnico e gera etiqueta que a agência não aceita.

2. 2

   Usuário do Meu Correios: o mesmo login que a empresa usa no portal dos Correios.

3. 3

   Código de acesso: gere no portal Correios Web Services (o link está na própria tela), logado com a conta do Meu Correios da empresa. É a senha do COMPONENTE — não a senha de login do portal.

4. 4

   Cartão de postagem: o número do cartão vinculado ao contrato, apenas os dígitos.

5. 5

   Clique em "Testar conexão". Dando certo, o Hap autentica de verdade nos Correios e mostra o contrato, a DR e a lista de APIs que o cartão libera — e guarda isso no painel.

Serviços e CEP de origem

Marque apenas os serviços que existem no seu contrato: são eles que aparecem na cotação. Os serviços de contrato (SEDEX Contrato e PAC Contrato) são os que passam pelo cartão de postagem e formam o caminho normal da integração. O serviço padrão precisa estar entre os marcados — é ele que já vem escolhido quando o operador abre a tela de envio.

O CEP de origem substitui o CEP do cadastro da empresa na cotação e na etiqueta. Preencha quando o galpão que despacha não é a sede: cotar a partir do CEP errado muda a faixa de preço e o prazo. Em branco, o sistema usa o CEP da empresa.

Embalagem padrão

Peso e dimensões vêm primeiro do que foi digitado na tela de envio, depois do pedido, depois do cadastro do produto. Os valores desta seção são a última rede de segurança: só entram quando nada mais informou o número. A tela de envio mostra de onde veio cada valor antes de imprimir, porque peso chutado costuma virar cobrança extra na agência.

Os campos de mínimo existem porque os Correios recusam objeto menor que o tamanho mínimo do serviço — o Hap ajusta a medida para o mínimo antes de cotar. Já a soma máxima das dimensões apenas avisa, não bloqueia: o limite real varia por serviço e por contrato.

Serviços adicionais e rótulo

Valor declarado (019), aviso de recebimento (001) e mão própria (002) marcados aqui já chegam marcados na tela de envio, e o operador ainda pode mudar pedido a pedido. O valor declarado sugere o valor do pedido — declarar mais do que o real só encarece o frete, sem benefício. O tipo de rótulo (Padrão ou Reduzido) e a observação padrão (até 200 caracteres) valem para todas as etiquetas.

Salvar e conferir

1. 1

   Marque "Integração ativa" na seção Conexão.

2. 2

   Clique em "Salvar configuração" no fim da tela.

3. 3

   Confira o selo no topo: deve passar de "Não configurado" para "Integração ativa", ao lado do ambiente e do número do contrato.

4. 4

   Abra um pedido de venda já salvo, no novo layout, e confira se o campo "Canal de envio" aparece na aba Transporte.