Período de viagem
Por que a ativação do eSIM só é liberada quando a viagem se aproxima.
Todo pedido carrega uma data de viagem (travelDate, obrigatória) e,
opcionalmente, uma data de retorno (travelReturnDate). Essa data não é apenas
informativa: ela governa quando o cliente pode ativar o eSIM.
A regra dos 90 dias
A ativação só é permitida quando faltam até 90 dias para a data da viagem.
Se a viagem está a mais de 90 dias, a ativação é bloqueada com uma mensagem orientando o cliente a tentar mais perto da viagem (e a falar com a agência em caso de dúvida). O pedido continua válido — apenas a ativação fica retida até entrar na janela.
Por que esse limite existe
A validade do plano (validityDays) começa a contar a partir da ativação/uso
do eSIM, não da compra. Um eSIM ativado meses antes da viagem consumiria a
validade antes mesmo de o cliente embarcar — ele foi feito para funcionar nos
dias próximos à viagem. O limite de 90 dias evita esse desperdício e reduz
falhas de emissão precoce.
Criar cedo, ativar perto
Vale separar dois momentos:
| Momento | Quando pode acontecer |
|---|---|
| Criar o pedido | A qualquer tempo — inclusive com meses de antecedência. |
| Ativar o eSIM | Só dentro da janela de 90 dias antes da travelDate. |
Ou seja, você pode registrar a venda com antecedência; o que espera a janela é a ativação pelo cliente.
Recomendações de integração
- Defina a
travelDatecom precisão — é ela que abre a janela de ativação. - Se vender com muita antecedência, oriente o cliente a ativar quando a viagem se aproximar (ou reenvie o link nessa época).
- Trate o bloqueio por janela como um estado temporário esperado, não como erro de integração.