Gerenciar a Renovação de um Entitlement

Um entitlement está se aproximando da data de expiração. Esta receita cobre a verificação da política de renovação, o tratamento da renovação automática, a renovação manual quando necessária, a extensão da data de expiração e a verificação do status renovado.

Pré-requisitos

• Acesso de admin ao WordPress.
• Um entitlement com status active que possui uma data de expiração próxima.
• A assinatura Stripe ou o método de pagamento da Organização está ativo (para renovação automática).

Passos

Parte A: Verificar a política de renovação

Passo 1. Vá em MIDDAG Account > Entitlements e abra o entitlement que está se aproximando da expiração.

Passo 2. Verifique o campo Expiration Date. O sistema envia lembretes configuráveis antes da expiração:

Lembrete	Quando é enviado
Primeiro	30 dias antes da expiração
Segundo	15 dias antes da expiração
Final	7 dias antes da expiração

Passo 3. Verifique a seção Renewal Policy na página de detalhes do entitlement. A política é resolvida por meio da hierarquia de 5 níveis (entitlement > produto > organização > classe > global). Configurações principais:

Configuração	O que controla
auto_renew	Se o sistema tenta a renovação automática.
renewal_period	Por quanto tempo a renovação estende (ex.: 12 meses).
renewal_price	Preço do período de renovação (pode diferir do original).
reminder_schedule	Quando os e-mails de lembrete são enviados antes da expiração.

Passo 4. Para verificar ou alterar a política para este entitlement específico, vá à aba Policy Overrides. Qualquer valor definido aqui sobrescreve os padrões da classe, organização e global.

Parte B: Fluxo de renovação automática

Passo 5. Se auto_renew estiver habilitado e o cliente tiver um método de pagamento válido cadastrado:

1. O sistema cria uma cobrança de renovação via Stripe no momento configurado antes da expiração.
2. Se o pagamento for bem-sucedido, a data de expiração do entitlement é estendida pelo período de renovação.
3. O status do entitlement permanece active -- nenhuma interrupção ocorre.
4. O cliente e o admin são notificados da renovação bem-sucedida.
5. Uma nova fatura é gerada no Stripe e sincronizada com o MIDDAG Account.

Passo 6. Para verificar se a renovação automática foi concluída: abra o entitlement e confirme que a Expiration Date avançou. Verifique também MIDDAG Account > Invoices para a fatura de renovação.

Passo 7. Se a renovação automática falhou (pagamento recusado, cartão expirado):

1. O sistema notifica o cliente para atualizar seu método de pagamento.
2. Dependendo da PaymentRecoveryPolicy, o entitlement pode ser suspenso ou receber um período de carência para nova tentativa.
3. Veja Suspender por Inadimplência para o fluxo completo de suspensão.

Parte C: Renovação manual

Passo 8. Se a renovação automática estiver desabilitada, ou se o cliente quiser renovar manualmente:

Opção 1 -- Renovação iniciada pelo admin:

1. Abra a página de detalhes do entitlement.
2. Clique em Renew Entitlement.
3. Defina a nova data de expiração (o sistema pré-preenche com base no período de renovação).
4. Opcionalmente, vincule um novo pedido WooCommerce ou proposta para o pagamento da renovação.
5. Clique em Confirm Renewal.

Opção 2 -- Renovação iniciada pelo cliente (via portal):

1. O cliente faz login e navega até My Products.
2. Ele vê um botão "Renew" ao lado dos entitlements que estão se aproximando da expiração.
3. Ele clica em Renew, revisa os termos e preço da renovação e prossegue para o pagamento.
4. Após o pagamento, a data de expiração do entitlement é estendida automaticamente.

Opção 3 -- Via nova proposta:

1. Crie uma nova proposta para a renovação. Veja Emitir uma Proposta Comercial.
2. Quando o cliente aceitar e pagar, o sistema pode estender o entitlement existente ou criar um novo (dependendo da configuração do produto).

Parte D: Verificar a renovação

Passo 9. Vá em MIDDAG Account > Entitlements e abra o entitlement.

Passo 10. Confirme:

• Status é active.
• Expiration Date avançou pelo período de renovação.
• Uma fatura de renovação existe em Invoices.
• Os recursos derivados não foram afetados: licenças permanecem ativas, ambientes estão rodando, contratos de serviço continuam.

Passo 11. Para entitlements PLG: verifique se a data de expiração da licença foi estendida para corresponder ao novo período do entitlement. As ativações de site existentes permanecem intactas.

Passo 12. Para entitlements SVC: verifique se o Contrato vinculado foi renovado ou se um novo contrato foi criado. Verifique se o CreditBalance foi reabastecido, se aplicável.

Resultado esperado

• A data de expiração do entitlement foi estendida.
• O status permanece active sem interrupção do serviço.
• Uma fatura ou registro de pagamento de renovação existe.
• Recursos derivados (licenças, serviços, ambientes) continuam sem interrupção.
• O cliente vê a data de expiração atualizada no portal.

Leitura complementar

• Fluxo de Compra e Renovação -- o fluxo completo de renovação.
• Políticas -- como as políticas de renovação são configuradas em cada nível da hierarquia.
• Suspender por Inadimplência -- o que acontece quando a renovação automática falha.