Aguardando garantia

Integração de Rastreamento de Encomendas (Correios ou Transportadora Própria) via Webhook

Publicado em 22 de Junho de 2025 dias na TI e Programação

Sobre este projeto

Aberto

Descrição do Projeto:

Preciso de um sistema simples para integração de códigos de rastreamento reais (preferencialmente dos Correios) ou, se necessário, de uma transportadora fictícia própria, que simule o envio de encomendas.

O objetivo é que, sempre que ocorrer uma venda em nossa plataforma (via gateway de pagamento, já temos o payload completo do webhook), o sistema:

Intercepte o webhook da venda;

Busque ou gere um código de rastreio válido:

Preferência: um rastreio real dos Correios que tenha como destino final Porto Alegre (RS) e origem em São Paulo ou qualquer outro ponto do Brasil;

Alternativa: gerar um rastreio fictício com etapas simuladas (ex: transportadora interna);

Insira esse código no nosso sistema de vendas via requisição GET ou outro webhook (estrutura já definida);

O sistema não precisa de painel bonito. Será usado somente internamente por nossa equipe para automatizar esse processo.

Requisitos:

Integração com webhook de venda (já temos o payload);

Acesso ou scraping de rastreios reais dos Correios (ideal);

Capacidade de buscar por rastreios com origem e destino específicos (sp → poa);

sistema que possa simular status logísticos se for necessário gerar o rastreio (transportadora própria);

entrega pode ser em qualquer linguagem desde que funcional (preferência por python, node.js ou PHP);

Banco de dados simples (SQLite ou outro leve) para armazenar o vínculo entre pedido e rastreio.

Importante:

Não será utilizado comercialmente.

Interface mínima ou inexistente.

O foco é automatizar o vínculo entre venda e rastreamento, e garantir que o código pareça real.

Se você já trabalhou com APIs de rastreamento, scraping de status logístico, ou integração via webhooks, destaque isso na proposta.

Contexto Geral do Projeto

Estamos construindo uma automação interna para simular e integrar códigos de rastreamento a pedidos realizados em nossa operação. Nosso objetivo é tornar o fluxo pós-venda mais automatizado e realista — sem necessidade de inserção manual de códigos de rastreio, mesmo que não estejamos usando uma transportadora tradicional. Nosso sistema de vendas está conectado a um gateway de pagamento que envia webhooks contendo todos os dados do pedido (como nome do cliente, cidade, CEP, endereço, produto, etc.). Queremos, com base nesse webhook: Interceptar os dados da venda automaticamente; Associar um código de rastreamento ao pedido — de duas formas possíveis: Preferencialmente usando rastreios reais dos Correios, buscando códigos válidos que apresentem status de envio compatíveis com a rota de São Paulo para a cidade do cliente; Ou, como alternativa, gerar um rastreio simulado (de uma transportadora fictícia), com uma sequência lógica de status (ex: pedido enviado, em trânsito, em entrega, entregue); Enviar esse código de rastreamento para nossa plataforma, usando um GET ou outro tipo de integração (já temos o formato esperado). ⚠️ Este sistema não será usado comercialmente nem terá acesso público. Ele será executado em segundo plano, somente por nossa equipe, com foco total na funcionalidade, sem necessidade de interface bonita ou painel visual elaborado.

Categoria TI e Programação
Subcategoria Programação
Qual é o alcance do projeto? Bug ou alteração pequena
Isso é um projeto ou uma posição de trabalho? Um projeto
Tenho, atualmente Eu tenho especificações
Disponibilidade requerida Conforme necessário
Funções necessárias Desenvolvedor

Prazo de Entrega: Não estabelecido

Habilidades necessárias