Voltar para Central de Manuais
# Fluxo de Estrangulamento: Cotacao2 -> Coleta 2.0
## Objetivo
Permitir migracao segura do legado para o 2.0, mantendo o comportamento funcional do fluxo operacional:
1. Cotacao comercial (fonte de verdade inicial)
2. Coleta operacional (espelho evolutivo)
3. Rastreamento operacional
4. Emissao de CT-e
## Principio de Compatibilidade
- A coleta 2.0 deve preservar o mesmo `uuid` da cotacao quando clonada.
- A coleta 2.0 deve poder ser re-sincronizada a partir da cotacao antes de validar/emissao.
- Filhos da cotacao devem ser espelhados na coleta:
- volumetria
- trechos
- taxas
## Endpoints de Ponte (2.0)
- `POST /api/v1/coletas/clonar-da-cotacao/{cotacao_uuid}`
- cria ou retorna coleta 2.0 espelhada da cotacao legado
- `POST /api/v1/coletas/atualizar-coleta-cotacao`
- `POST /api/v1/coletas/atualizar_coleta_cotacao` (alias legado)
- body: `{ "token": "<uuid>" }`
- sincroniza dados da coleta com a cotacao
## Sequencia Operacional Recomendada
1. Comercial conclui/ajusta cotacao no legado.
2. Sistema chama clone para garantir coleta 2.0 criada:
- `POST /clonar-da-cotacao/{uuid}`
3. Antes de validar coleta para emissao:
- `POST /atualizar-coleta-cotacao` com token da coleta/cotacao
4. Validacao de regras:
- `POST /api/v1/coletas/validar/{uuid}`
- `GET /api/v1/coletas/validar-emissao/{uuid}`
5. Agendamento/operacao:
- `POST /api/v1/coletas/agendar/{uuid}`
6. Emissao CT-e:
- fluxo de emissao via endpoints de emissao 2.0
7. Rastreio:
- fluxo de rastreamento 2.0 usando a mesma coleta vinculada
## Regra de Ouro do Estrangulamento
Enquanto o legado continuar vivo, toda etapa critica operacional deve aceitar uma resincronizacao com a cotacao antes da emissao. Isso evita drift de dados entre comercial e operacao.