O Papel do WooCommerce
MIDDAG Account e WooCommerce funcionam como duas camadas complementares. O WooCommerce é o motor de comércio — ele cuida de produtos, precificação, carrinho, checkout, pagamentos, frete e impostos. O MIDDAG Account é o motor de ciclo de vida — ele cuida de organizações, entitlements, licenças, contratos, serviços, renovações e políticas.
Nenhum sistema substitui o outro. Cada um é responsável por um conjunto distinto de responsabilidades.
O que o WooCommerce gerencia
| Responsabilidade | Detalhes |
|---|---|
| Catálogo de produtos | Nomes, descrições, imagens, preços, variações, categorias |
| Carrinho e checkout | Não é voltado ao cliente — pedidos são criados pelo admin, cotações ou automação |
| Processamento de pagamentos | Stripe (cartão de crédito), Banco Inter (Pix, Boleto) via plugins de gateway |
| Assinaturas | Cobrança recorrente, prorrateio, upgrade/downgrade, retentativa via WC Subscriptions |
| Cálculo de impostos | Alíquotas, classes de imposto, cálculo automático |
| Frete | Métodos e zonas de frete (pouco usado — maioria dos produtos é digital) |
| Cupons | Códigos de desconto, percentual ou valor fixo |
| Armazenamento de pedidos | Registros de pedidos armazenados no HPOS (High-Performance Order Storage) |
O que o MIDDAG Account gerencia
| Responsabilidade | Detalhes |
|---|---|
| Organizações | Contas de clientes, colaboradores, CNPJs/tax IDs, entidade de faturamento |
| Entitlements | O que o cliente tem acesso, com classe, status e expiração |
| Licenças | Chaves de licença, limites de ativação, downloads (classe PLG) |
| Ambientes | Instâncias de hospedagem gerenciada (classe ENV) |
| Serviços/Contratos | Contratos de serviço contínuo, saldos de créditos (classe SVC) |
| Policy Engine | Regras de renovação, reembolso, cancelamento, recuperação de pagamento e SLA |
| Roteamento dual-entity | Roteamento de transações para MIDDAG BR ou MIDDAG GLOBAL com base nos dados do cliente |
| Sincronização de faturas | Sincronização de faturas Stripe com o domínio local, vinculando a pedidos e entitlements |
| Notas fiscais (NFSe) | Emissão de NFSe via ISSNet (somente entidade BR) |
A fronteira
O elo entre os dois sistemas é o mapeamento de produtos. Cada produto WooCommerce possui um campo meta (_middag_entitlement_class) que indica ao MIDDAG Account qual tipo de entitlement criar quando um cliente adquire o produto.
Quando configurar no WooCommerce
- Criar ou editar produtos (nome, preço, descrição, imagens)
- Configurar gateways de pagamento (Stripe, Banco Inter)
- Configurar alíquotas e classes de imposto
- Gerenciar cupons e descontos
- Revisar detalhes de pedidos e status de pagamento
- Ajustar configurações de assinatura (intervalos de cobrança, agendas de retentativa)
Quando configurar no MIDDAG Account
- Mapear produtos para Entitlement Classes
- Definir overrides de políticas (renovação, reembolso, cancelamento, SLA)
- Gerenciar organizações e seus colaboradores
- Revisar status e ciclo de vida de entitlements
- Configurar regras de roteamento dual-entity
- Configurar templates e timing de notificações
- Gerenciar chaves de licença e provisionamento de ambientes
O WooCommerce é invisível para os clientes
Os clientes nunca interagem diretamente com o WooCommerce. O portal do cliente usa a terminologia do MIDDAG Account — "pedidos" e "faturas", não "pedidos WooCommerce". O checkout não é uma vitrine WooCommerce tradicional. Pedidos são criados via cotações, ações do admin ou automação, e os clientes pagam pelo portal.
As páginas de administração do WooCommerce são usadas exclusivamente pela equipe de operações no back office do WordPress.
Plugins satélites
Dois plugins WooCommerce adicionais estendem a camada de comércio:
| Plugin | Finalidade | Relação com o MIDDAG Account |
|---|---|---|
woocommerce-banco-inter | Gateway de pagamento Banco Inter (Pix, Boleto) | Integra via hooks de pagamento padrão do WC |
woocommerce-quotes | Entidade de cotação no WooCommerce | MIDDAG Account consome via hooks e API |
Ambos são mantidos pela MIDDAG e integram por meio de hooks do WooCommerce — nunca por acoplamento direto de código.
Páginas relacionadas
- Produtos e Entitlement Classes -- como produtos mapeiam para Entitlement Classes
- Pedidos e Entitlements -- o pipeline de pedido para entitlement
- Conectar WooCommerce -- guia de configuração inicial
- Pedidos -- referência do conceito de pedido