Crie seu Primeiro Entitlement
O Entitlement é o registro central do MIDDAG Account. Ele representa um fato simples: "A Organização X tem acesso ao Produto/Serviço Y." Toda licença, contrato, fatura e solicitação de serviço se conecta a um entitlement. Se você quer saber o que um cliente possui, basta olhar os entitlements dele.
Em operação normal, entitlements são criados automaticamente quando o cliente faz um pedido pelo WooCommerce. Mas para a configuração inicial, você vai criar um manualmente para entender como o sistema funciona.
O que você vai precisar
- Pelo menos uma Organização já criada e verificada (veja Crie sua Primeira Organização)
- Plugin MIDDAG Account instalado com as Entitlement Classes configuradas
Passo 1: Abra a lista de Entitlements
Na barra lateral do admin do WordPress, navegue até MIDDAG Account > Entitlements. Clique em New Entitlement.
Passo 2: Selecione a Organização
Escolha a qual Organização este entitlement pertence. Este é o cliente que vai "possuir" este entitlement. Comece a digitar o nome da organização e selecione no dropdown.
Dica: Selecionar uma Organização é opcional. Entitlements podem existir sem uma — útil para gift cards, acesso promocional ou clientes pessoa física. Para este guia de início rápido, recomendamos vincular a uma Organização para que você veja o fluxo completo do ciclo de vida.
Passo 3: Selecione a Entitlement Class
Todo entitlement tem uma Class que determina qual tipo de produto ou serviço ele representa. O MIDDAG Account vem com seis classes padrão:
| Class | Prefixo | O que representa | Exemplo |
|---|---|---|---|
| Plugin | PLG | Uma licença de software | "Acme Corp tem uma licença do MIDDAG Forms Pro" |
| Environment | ENV | Uma instalação de hospedagem gerenciada | "Acme Corp tem um ambiente WordPress de staging" |
| Service | SVC | Um serviço contínuo ou projeto de consultoria | "Acme Corp tem um contrato de consultoria recorrente" |
| Order | ORD | Um entitlement genérico de compra | "Acme Corp comprou um pacote de relatórios personalizados" |
| Affiliate | AFL | Participação no programa de parceiros | "Acme Corp é um parceiro afiliado" |
| Education | EDU | Acesso a treinamentos, cursos ou mentoria | "Acme Corp tem acesso à Admin Academy" |
Selecione a classe que corresponde ao que você está testando. Para um primeiro teste, Plugin (PLG) ou Order (ORD) são boas escolhas.
INFO
As Entitlement Classes são configuráveis nas configurações do admin. Você pode renomeá-las, ajustar seu comportamento ou criar novas para se adequar ao seu negócio. Elas ficam armazenadas no banco de dados, não em código fixo.
Passo 4: Defina as datas
| Campo | O que significa |
|---|---|
| Start Date | Quando este entitlement se torna ativo. Normalmente hoje, para uma nova compra. |
| Expiration Date | Quando o acesso expira se não for renovado. Defina para um ano a partir de hoje para uma assinatura anual típica, ou deixe vazio para acesso perpétuo. |
Passo 5: Preencha os detalhes do produto
Insira o nome do produto ou serviço e uma descrição opcional. Se você está vinculando a um produto WooCommerce existente, pode selecioná-lo aqui — mas para um teste manual, um nome descritivo é suficiente.
Passo 6: Salve
Clique em Save. O sistema vai:
- Gerar um Entitlement Code único e imutável
- Definir o status como Active
- Exibir o entitlement no registro da Organização
Entendendo o Entitlement Code
Todo entitlement recebe um código neste formato:
{CLASS}-{YEAR}{MONTH}{SEQ}Por exemplo: PLG-2026050001
- PLG — o prefixo da classe (Plugin)
- 2026 — o ano
- 05 — o mês
- 0001 — o número sequencial (o primeiro entitlement Plugin criado em maio de 2026)
Este código é:
- Único — nenhum outro entitlement compartilha o mesmo código
- Imutável — uma vez atribuído, nunca muda
- Legível — você consegue identificar a classe e a data aproximada de criação de relance
- Visível para o cliente — os clientes veem este código no portal, em e-mails e ao abrir solicitações de suporte
Quando um cliente liga para o suporte e diz "tenho uma dúvida sobre o PLG-2026050001", sua equipe sabe exatamente do que ele está falando.
Os quatro estados do ciclo de vida
Todo entitlement está sempre em um dos quatro estados:
| Estado | O que significa | Como acontece | O que vem depois |
|---|---|---|---|
| Active | O cliente tem acesso. Tudo funciona normalmente. | Criado (manualmente ou por compra). Ou reativado a partir de outro estado. | Permanece ativo até expirar, ser suspenso ou cancelado. |
| Suspended | O acesso está temporariamente pausado. | Geralmente disparado por uma falha de pagamento. Um admin também pode suspender manualmente. | Pode voltar a Active se o pagamento for recuperado. Pode ir para Cancelled se não for resolvido. |
| Expired | A data de fim do entitlement passou sem renovação. | Automático quando a data de expiração é atingida. | Pode voltar a Active se o cliente renovar. Pode ir para Cancelled após um período de carência. |
| Cancelled | Revogado permanentemente. | Ação do admin, ou automático após suspensão/expiração prolongada sem resolução. | Pode ser reativado (cenário de reconquista), mas isso é uma ação intencional do admin. |
Quando um entitlement muda de estado, tudo conectado a ele acompanha. Se um entitlement Plugin é suspenso, a licença associada é suspensa. Se um entitlement Service expira, o contrato vinculado reflete isso.
Verifique se funcionou
Após salvar, confirme o seguinte:
- Lista de entitlements — seu novo entitlement aparece com o código, classe, organização e status Active corretos
- Detalhes da Organização — navegue até a Organização e confira a aba Entitlements. Seu entitlement deve aparecer lá.
- Formato do código — o código segue o padrão
{CLASS}-{YEAR}{MONTH}{SEQ}
Lembre-se: isto é um teste manual
Em produção, você não vai criar entitlements manualmente. O fluxo normal é:
- O cliente faz um pedido pelo WooCommerce
- O pagamento é confirmado (via Stripe, Pix, Boleto ou outro gateway)
- O MIDDAG Account cria automaticamente o entitlement com a classe correta
- Recursos derivados (licença, contrato, ambiente) são provisionados automaticamente
Esta criação manual existe para que você possa verificar se o sistema está configurado corretamente antes de conectá-lo ao seu fluxo de comércio.
Próximos passos
- Execute seu primeiro ciclo de vida — conecte um produto WooCommerce a uma Entitlement Class e teste o fluxo automatizado completo, da compra ao provisionamento