Integração da API Frota162 com aplicação
18/08/2026 às 17:53Descrição do Projeto:
Segue também PRD abaixo com os passos já mapeados:
1. Setup - credenciais, sandbox e confirmação com a Frota162
Objetivo: preparar tudo que depende do fornecedor antes de escrever código.
2. Backend - módulo fleet-fine-integration: gateway de saída (indicate-driver / update)
Objetivo: criar o módulo backend novo e a camada de chamadas de saída para a API Frota162, seguindo o scaffold obrigatório (apps/service-hub-platform-backend/ia-context/SCAFFOLD_IMPLEMENTACAO_BACKEND.md).
3. Backend - recebimento de webhook (ingestão assíncrona)
Objetivo: criar o endpoint público que recebe os eventos da Frota162 (multa nova, atualização de multa, notificação nova/atualizada, status de indicação de motorista) e processá-los de forma assíncrona e idempotente.
4. Backend - mapear eventos de multa/notificação para o domínio FleetFine existente
Objetivo: alimentar a entidade FleetFine já existente (modules/fleet) a partir dos eventos processados da Frota162, sem criar um domínio de multa paralelo.
Contexto: hoje modules/fleet/domain/entity/fleet-fine.entity.ts é alimentada só por importação manual de planilha do "Ecar" (ver modules/fleet/domain/service/ecar-fine-status.mapper.ts como exemplo de mapper equivalente). Esta subtask cria o mapper equivalente para a fonte Frota162.
5. Backend - Indicação de motorista (NIC) via API v2 (beta) e alertas de prazo
Objetivo: implementar a submissão formal de indicação de condutor (NIC/AIT) usando a API v2 (beta) da Frota162, incluindo acompanhamento assíncrono de status e alerta de prazo legal.
6. CI/CD - secrets, variáveis e pipeline
Objetivo: garantir que o novo módulo tenha suas credenciais e variáveis corretamente provisionadas em cada ambiente e que os workflows existentes cubram o build do módulo novo.
Contexto: o backend já usa dois workflows (ci-dev.yml para PR->dev, ci-release.yml para PR->hml/main), ambos com Node 24, lint + build (testes/cobertura saíram do CI desde 2026-08-04, mas continuam obrigatórios localmente - ia-context/CICD_PIPELINES.md §3.7).
7. Docker / Infraestrutura - exposição pública do endpoint de webhook
Objetivo: garantir que o endpoint de recebimento de webhook (subtask 3) seja alcançável publicamente via HTTPS pela Frota162, sem abrir superfície de ataque desnecessária.
8. Testar o cadastro do webhook em hml apontando para o domínio público de homologação, validando entrega ponta a ponta a partir do sandbox da Frota162.
Critério de conclusão: rota pública validada em hml recebendo evento real do sandbox da Frota162, sem exigir mudança de imagem Docker além do código da subtask 3.
Bloqueada por: subtask 3 (endpoint implementado) e 6 (variáveis provisionadas em hml).
Objetivo: garantir que o módulo novo atenda ao padrão obrigatório de testes do scaffold (ia-context/SCAFFOLD_IMPLEMENTACAO_BACKEND.md §9-10) antes de qualquer PR ser aberto.
9. Documentação - ia-context do módulo novo
Objetivo: cumprir a exigência do scaffold de documentar toda integração externa nova em ia-context, seguindo o modelo já usado para a integração Control iD.
Referência de formato: apps/service-hub-platform-backend/ia-context/FLEET_GATEHOUSE_CONTROLID.md (objetivo, feature flag, fluxo passo a passo, envs, limitações conhecidas, contexto de decisões).
10. (Fase opcional) E-mail padronizado de contestação às locadoras via Resend
Objetivo: atender ao pedido de negócio registrado em comentário do card por Otávio Anjos ("em conversa com Juliano, ele pediu um email com formato e todos os dados para questionamento para as Locadoras"), reaproveitando a integração Resend já existente no módulo notification.
Habilidades desejadas:
Desenvolvimento Back-End Desenvolvimento de API Engenharia de Sistemas Integração Integração de Dados
Arquivos anexados:
Entre ou Cadastre-se para ver os arquivos anexados.
Atividades do cliente nesse projeto:
Última visualização: 28/08/2026 às 12:03
Informações adicionais
| Categoria: | Web, Mobile & Software |
|---|---|
| Subcategoria: | Desenvolvimento Web |
| Orçamento: | Aberto |
| Nível de experiência: | Iniciante |
| Visibilidade: | Público |
| Propostas: | 78 |
| Interessados: | 89 |
| Tempo restante: | |
| Valor Mínimo: | R$ 50,00 |
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
-
Submetido: | Oferta: Privado | Duração estimada: Privado
Atualizar newsletter no Beehiiv - inglês necessário - Se você já trabalhou com Beehiiv antes, essa tarefa pode ser sua. A tarefa é atualizar o design da minha conta no Beehiiv e publicar dois artigos que já estão escr...
Melhorias em módulo de disparo em massa no Whaticket - Quero fazer melhorias no módulo que possuo de disparo. Segue o vídeo do que eu quero, as opções e, abaixo, as principais funções. https://youtu.be/ArBUcK...
Redesign e reestruturação do site, incluindo novas páginas - ANA DECANINI Plano de Ação - Fase 2 Sites: manualtherapystudio.com / anadecaninirmt.com PEDIDO DE ORÇAMENTO - Reformulação da Home, incluindo Header e Footer - C...
Implantação do ERP UAU/GLOBALTEC - vendas e financeiro - Procuro uma pessoa com ampla experiência como usuário do ERP UAU/GLOBALTEC, especialmente nos módulos de vendas e financeiro, entre outros módulos do ERP.
Gestão de lojas no Mercado Livre e Shopee - Olá! Tenho uma farmácia/perfumaria física em São Roque-SP e estou procurando um prestador de serviço/freelancer com experiência em Mercado Livre e Shopee. ...
