Configuração da Integração com os Correios
A API de Integração com os Correios permite utilizar serviços específicos dos Correios:
- Criação de pré-postagem.
- Cotação de preço e prazo.
Pré-requisitos
Antes de configurar a integração, é necessário obter com o cliente:
- As credenciais de acesso aos serviços WebService dos Correios (Usuário e Senha).
Passo a passo da configuração
Passo 1: Obter código de acesso as API’s
- Acesse o portal dos correios (https://cws.correios.com.br/acesso-componentes)
- Ao acessar o link acima utilizando o usuário e senha do cliente, será redirecionado para uma tela de geração do código, bastando apenas preencher o campo de senha e regerar o código.
- Ao acessar o link acima utilizando o usuário e senha do cliente, será redirecionado para uma tela de geração do código, bastando apenas preencher o campo de senha e regerar o código.
- Utilizar o botão “Regerar código”.
- Utilizando essa opção, caso tenha um código já gerado, será questionado se deseja gerar um novo. Caso não tenha conhecimento do código atual e deseja gerar um novo, clique em “Sim” e salve o novo código gerado.
- Salve o novo código gerado.
Passo 2: Configurar diretivas no sistema
- Acesse o ERP Vexta » Vendas » Conferências de Pedido
- Acesse as diretivas, e vá até na sessão “Correios”.
- Preencha as seguintes diretivas:
- CNPJ: CNPJ da empresa
- Código do contrato dos correios
- E-mail: E-mail da empresa
- Senha: Código gerado no passo 1
- URL da API Vexta de integração com Correios: URL do serviço, algo como http://api4.vexta.com.br/integracao-correios/config
- Verifique se todos os valores estão corretos e foram adicionados para o usuário necessário.
Passo 3: Testar a integração
- Gere uma expedição.
- Na tela de expedição, clique no botão “Etiqueta dos Correios”.
- Verifique se os dados foram gerados corretamente, e se o PDF da etiqueta está correto.
Parâmetros e Configurações
Principais campos utilizados
Campo | Descrição |
---|---|
Usuário | Usuário de login utilizado no Correios |
Senha | Apesar do nome senha, na diretiva utilizamos o valor do código gerado no passo 1 |
CNPJ | CNPJ vinculado ao contrato |
Extras
Acessando a documentação dos Correios:
- Na tela inicial, será necessário clicar no botão de Credenciais, com o ícone de cadeado.
- Na tela de credenciais, será necessário preencher o código de acesso a API e o Cartão postagem. Após preenchidos, clique em Gerar token.
- Com isso, já será possível realizar as requisições na documentação dos Correios.