
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
500+ usuários cadastrados e mais de 1.000 etiquetas emitidas por mês.
Em produção
- Minha entrega
- 500+ usuários cadastrados e mais de 1.000 etiquetas mensais. Integrei 10 transportadoras: Correios, Jadlog, J&T Express, Loggi, Total Express, Buslog, Azul Cargo, Braspress, DHL e FedEx. Pedidos de 5 plataformas: Shopify, Nuvemshop, Yampi, Tray e Bling; Mercado Pago/PIX e DC-e na SEFAZ-PR. Também desenvolvi agente de IA para suporte, com rastreio, ocorrências e encaminhamento humano.
- 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, aplicativo Expo e API para cotação, etiquetas, rastreamento e carteira. Integrações com 10 transportadoras e 5 plataformas de e-commerce/ERP, 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
- 10 transportadoras: Correios, Jadlog, J&T Express, Loggi, Total Express, Buslog, Azul Cargo, Braspress, DHL e FedEx.
- Agente de IA para suporte logístico com consulta de rastreio e ocorrências, contexto de evidências, workflow persistente e encaminhamento humano.
- 5 plataformas de pedidos e expedição: 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 500+ usuários cadastrados e mais de 1.000 etiquetas emitidas por mês, conforme informação do titular em novembro de 2026. Cadastros não equivalem a usuários ativos ou clientes pagantes; as operações disponíveis e a homologação variam por integração.


