
Tela de acesso do aplicativo Expo. Cotação, envios e carteira usam a mesma API do painel web; esses fluxos estão descritos ao lado.
Envio Fácil Encomendas
Plataforma logística em produção, com mais de 550 usuários cadastrados.
Em produção
- Minha entrega
- Plataforma em produção com mais de 550 usuários cadastrados. Desenvolvi integrações de transportadoras e e-commerce, pagamentos PIX, emissão de DC-e com a SEFAZ-PR e recebimento de webhooks com persistência antes da fila.
- Decisão técnica
- Gravar o evento no PostgreSQL antes de depender do Redis. Uma rotina recupera os eventos pendentes e tenta enfileirá-los novamente.
- Comportamento implementado
- Se o enfileiramento falha, o evento recebido permanece registrado para retomada. A confirmação de PIX também pode retomar a emissão vinculada ao pagamento.
- 01Webhook recebido
- 02Evento persistido
- 03Fila e retomada
- TypeScript
- NestJS
- React / Next.js
- Expo
- PostgreSQL
- Redis
Sobre o projeto
Problema
Reunir cotação, contratação e rastreamento de transportadoras com regras e respostas diferentes, mantendo a consistência entre envio, cobrança e etiqueta.
Solução
Painel web e aplicativo Expo para cotação, etiquetas, rastreamento e carteira. Integra transportadoras, pedidos de e-commerce, pagamentos Mercado Pago/PIX e DC-e com a SEFAZ-PR.
Minha participação
Desenvolvimento e manutenção de backend, interface web e app Expo; integrações de frete e e-commerce, fluxos financeiros e tratamento de erros operacionais.
Arquitetura e desafios técnicos
Monólito modular NestJS/TypeScript, com domínio, casos de uso e adaptadores separados. PostgreSQL/TypeORM persistem a operação; Bull/Redis executam filas e rotinas agendadas. Outbox/inbox liga eventos a efeitos como emissão de etiquetas após confirmação de PIX. React/Next.js e Expo consomem a API com TanStack Query.
Qualidade e confiabilidade
Validação HTTP, autenticação e permissões por contexto. Transações, consumidores idempotentes, verificação de webhooks e retries com backoff tratam reenvios e falhas externas. Há testes Jest de fluxos e adaptadores, métricas operacionais e ambiente Docker.
Entregas
- Integrações com Correios, Jadlog, J&T Express e Loggi para operação de fretes.
- Pedidos e expedição conectados a Shopify, Nuvemshop, Yampi, Tray e Bling.
- DC-e com SEFAZ-PR via SOAP, certificado A1 e assinatura XML, incluindo autorização, consulta e cancelamento.
- Carteira, recargas PIX e retomada da emissão vinculada à confirmação do pagamento.
- Webhooks de e-commerce persistidos antes do enfileiramento, com recuperação após falhas de Redis.
Situação atual
Em produção, com mais de 550 usuários cadastrados, conforme dado informado em outubro de 2026. O número não representa usuários ativos mensais nem empresas pagantes. A homologação e o uso em produção de cada conector são acompanhados separadamente.


