Integração com os Correios (SIGEP WEB)

Neste artigo, você aprenderá a utilizar as requests para integração com os Correios por meio do SIGEP WEB no Ideris. Essa integração tem como objetivo facilitar o gerenciamento de postagens, permitindo gerar etiquetas, códigos de rastreamento e listas de postagens de forma ágil.

O que é o SIGEP WEB?

O SIGEP WEB é uma plataforma dos Correios que simplifica o processo de envio de encomendas. Com ele, você pode:

• Gerar e imprimir etiquetas de envio;
• Acompanhar códigos de rastreamento;
• Gerar listas de postagens.

Endpoints Disponíveis

1. Buscar Etiquetas dos Correios

• URL: https://apiv3.ideris.com.br/order/{orderId}/contract/{contractId}/service/{serviceId}/correios 

• Método: GET
• Objetivo:
  Retorna as etiquetas dos Correios vinculadas a um pedido específico, contrato e serviço.
• Parâmetros na URL:
  • {orderId}: ID do pedido.
  • {contractId}: ID do contrato do SIGEP.
  • {serviceId}: ID do serviço utilizado.

2. Gerar Etiqueta dos Correios

• URL: https://apiv3.ideris.com.br/order/{orderId}/correios 

• Método: POST
• Objetivo:
  Gera uma etiqueta para envio pelos Correios, vinculada a um contrato do SIGEP WEB.
• Parâmetros na URL:
  • {orderId}: ID do pedido.

Dicas Importantes

1. Certifique-se de que o contrato do SIGEP WEB está configurado corretamente no painel do Ideris.
   
   • Isso garantirá que as etiquetas sejam geradas sem erros.
2. Revise os dados do pedido antes de gerar a etiqueta.
   
   • Informações incorretas podem causar falhas no envio ou atrasos.
3. Respeite os limites de requisição da API.
   
   • Consulte o Swagger para mais detalhes sobre throttling e formatos obrigatórios.

Documentação Eletrônica

A documentação completa da API está disponível em um ambiente eletrônico no endereço Swagger.

• Acesso: Não é necessário token para consultar essa documentação.
• Objetivo: Retornar exemplos de objetos padrão, permitindo que você teste as integrações sem precisar de credenciais de acesso.

Se precisar de mais ajuda com este processo, nossa equipe de suporte está pronta para atender você. É só clicar no ícone do whatsapp no canto inferior direito de qualquer página do seu painel Ideris ou abrir um ticket. 

Conte sempre conosco. Até a próxima!