Pedidos
Um Pedido é um registro de compra. No MIDDAG Account, o WooCommerce cuida do comércio — produtos, checkout, pagamentos e assinaturas — enquanto o MIDDAG Account cuida do que acontece após a compra: criar entitlements, rastrear ciclo de vida e conectar tudo à organização do cliente.
Os clientes nunca veem o WooCommerce. O portal do cliente usa sua própria terminologia ("pedidos" e "faturas", não "pedidos WooCommerce") e sua própria interface. O WooCommerce é o motor de backoffice, visível apenas para o time admin.
Como pedidos criam entitlements
Este é o pipeline principal. Quando um cliente conclui uma compra, o MIDDAG Account cria automaticamente os entitlements que dão acesso ao que foi comprado:
Passo a passo:
- O pagamento é confirmado — via webhook do Stripe (cartão de crédito), webhook do Banco Inter (Pix ou boleto) ou confirmação manual do admin.
- O status do pedido WooCommerce muda para completed — isso dispara o hook padrão do WooCommerce.
- O serviço de provisionamento do MIDDAG Account analisa o pedido — lê cada item e verifica o metadado
_middag_entitlement_classdo produto para determinar qual classe de entitlement criar. - Um entitlement é criado para cada item — com código único, status
activee vinculado ao pedido e à organização. - Os recursos derivados são provisionados — uma Licença para itens PLG, um Ambiente para itens ENV, um Serviço e Contrato para itens SVC, e assim por diante.
O pipeline inteiro roda automaticamente. Após o cliente pagar, ele tem seus entitlements e acesso em segundos — sem necessidade de intervenção do admin.
Idempotência
Se um webhook de pagamento dispara duas vezes (o que acontece na prática), o sistema não cria entitlements duplicados. Ele verifica se já existe um entitlement para a mesma combinação de pedido + item + classe e pula a criação se encontrar um.
Ciclo de vida do pedido e ciclo de vida do entitlement
O status do pedido no WooCommerce se mapeia para o comportamento do entitlement:
| Status do pedido WooCommerce | Efeito no entitlement |
|---|---|
| Completed | Entitlement criado com status active |
| Processing | Nenhum entitlement ainda — o pagamento ainda está sendo confirmado |
| On hold | Nenhum entitlement ainda — aguardando pagamento manual (boleto) |
| Refunded | Entitlement cancelado (reembolso total) ou permanece ativo (parcial, conforme política) |
| Cancelled | Entitlement cancelado |
| Failed | Nenhum entitlement criado |
Para assinaturas (gerenciadas pelo WooCommerce Subscriptions):
| Evento da assinatura | Efeito no entitlement |
|---|---|
| Renovação paga | Entitlement permanece ativo, data de expiração estendida |
| Renovação falhou | Payment Recovery Policy consultada — pode suspender o entitlement |
| Cancelada | Entitlement move para expirado ou cancelado (conforme política) |
| Upgrade | Mesmo entitlement, atributo de plano muda |
| Downgrade | Mesmo entitlement, atributo de plano muda (pode requerer aprovação) |
O WooCommerce Subscriptions cuida de toda a complexidade da cobrança recorrente: pro-rata, cálculos de upgrade/downgrade e tentativas de pagamento. O adaptador de assinaturas do MIDDAG Account traduz esses eventos em transições de ciclo de vida do entitlement.
Impacto de reembolso e cancelamento
Quando um pedido é reembolsado ou cancelado, o impacto no entitlement depende do tipo:
- Reembolso total — O entitlement vinculado é cancelado. Os recursos derivados (licenças, ambientes, serviços) são desativados. A Refund Policy controla se isso acontece automaticamente ou requer aprovação do admin.
- Reembolso parcial — O entitlement permanece ativo por padrão. O admin pode ajustar manualmente o entitlement se o reembolso parcial justificar acesso reduzido.
- Cancelamento do pedido — O entitlement é cancelado. Se o entitlement já foi provisionado, os recursos derivados são desativados.
A Refund Policy (configurável através da Policy Engine) controla:
- Quantos dias após a compra um reembolso é permitido
- Se reembolsos abaixo de um limite são processados automaticamente
- Se créditos são perdidos, mantidos ou ajustados proporcionalmente
- Se o entitlement é automaticamente cancelado após um reembolso total
De onde vêm os pedidos
Pedidos no MIDDAG Account podem ser originados de vários caminhos:
| Origem | Como funciona |
|---|---|
| Proposta aceita | Cliente aceita uma proposta no portal, pedido WooCommerce é criado automaticamente, link de pagamento é enviado |
| Compra direta | Admin cria um pedido no WooCommerce manualmente |
| Renovação de assinatura | WooCommerce Subscriptions cria um pedido de renovação automaticamente |
| Negócio do HubSpot | Um negócio no HubSpot sincroniza com uma proposta, que converte em pedido |
Independente da origem, o pipeline de criação de entitlements funciona da mesma forma.
Roteamento dual-entidade
Todo pedido é roteado para a entidade legal MIDDAG correta — MIDDAG BR (Brasil) ou MIDDAG GLOBAL (LLC nos EUA) — com base na identificação fiscal da organização, configuração de entidade de cobrança, configuração do produto ou moeda. Isso determina qual conta Stripe processa o pagamento e quais regras fiscais se aplicam.
O roteamento é automático, mas pode ser sobrescrito por um admin por transação.
O que os admins veem
No WordPress admin, a visão de pedidos mostra:
- Número do pedido e data
- Nome da organização
- Valor e moeda
- Status do pagamento
- Entidade de cobrança (BR ou GLOBAL)
- Códigos de entitlements vinculados
Admins também têm um dashboard financeiro que agrega dados de ambas as entidades:
- Receita total por período (mensal, trimestral, anual)
- Receita por entidade (BR vs GLOBAL)
- Pagamentos pendentes (boletos não pagos, faturas em aberto)
- Faturas em atraso
- Assinaturas ativas vs canceladas
O dashboard financeiro é exclusivo para admins — clientes não têm acesso. Os clientes veem seu próprio histórico de pedidos pelo portal, com a terminologia do MIDDAG Account (nunca rótulos do WooCommerce).
Páginas relacionadas
- Entitlements — o que os pedidos criam
- Entitlement Classes — como o produto determina qual classe de entitlement é criada
- Políticas — regras de reembolso, renovação e recuperação de pagamento
- Organizações — a entidade cliente à qual os pedidos pertencem
- Como os Conceitos se Conectam — o diagrama completo de relacionamentos