Sincronização e idempotência
- Serialize os eventos por externalId. Não processe simultaneamente admissão, atualização, revogação e reconvite da mesma pessoa.
- Em falha de rede ou 500, use espera exponencial com jitter e um número máximo de tentativas. Preserve externalId e, no reconvite, a mesma idempotencyKey do evento.
- Em 429, reduza a frequência. Não suponha a presença de cabeçalho Retry-After.
- Após resposta perdida, reconcilie a lista. Não gere nova matrícula para contornar erro.
Criação concorrente pode retornar 409: repita o mesmo upsert com o mesmo externalId para alcançar o vínculo vencedor. Outros conflitos exigem corrigir o fluxo antes de repetir.