Pedidos

A tela de Pedidos exibe registros de compra que fluem pelo WooCommerce. O MIDDAG Account não substitui o WooCommerce para comércio -- ele enriquece os pedidos do WooCommerce com dados de entitlement, vinculando cada compra ao ciclo de vida do cliente. É aqui que você verifica se as compras foram corretamente convertidas em entitlements.

Como os pedidos funcionam no MIDDAG Account

O WooCommerce gerencia produtos, checkout e processamento de pagamentos. O MIDDAG Account adiciona uma camada por cima:

1. Um cliente paga por um pedido (via Stripe, Banco Inter ou confirmação manual).
2. O WooCommerce marca o pedido como completed.
3. O serviço de provisionamento do MIDDAG Account lê os itens de linha do pedido e cria entitlements com base na classe configurada de cada produto.
4. Recursos downstream (licenças, ambientes, serviços) são provisionados automaticamente.

Os pedidos no MIDDAG Account são somente leitura -- você os cria e gerencia no WooCommerce. O MIDDAG Account exibe a visualização enriquecida com dados de entitlement.

Visualização em lista

Abra MIDDAG Account > Pedidos para ver todos os pedidos com o contexto do MIDDAG Account.

Colunas

Coluna	O que exibe
Pedido #	Número do pedido WooCommerce (clicável -- abre a visualização de detalhes)
Data	Data do pedido
Organização	A organização cliente à qual este pedido pertence
Valor	Total do pedido com moeda (BRL ou USD)
Status do Pagamento	Concluído, Processando, Em Espera, Reembolsado, Cancelado ou Falhou
Entidade de Cobrança	MIDDAG BR ou MIDDAG GLOBAL
Entitlements	Códigos de entitlement criados a partir deste pedido (badges clicáveis)

A coluna Entitlements é a adição principal que o MIDDAG Account oferece. Cada código de entitlement aparece como um badge clicável. Se um pedido ainda não possui entitlements (ex.: ainda processando), a coluna exibe "Pendente" em amarelo. Se a criação do entitlement falhou, exibe "Erro" em vermelho.

Filtros

• Buscar -- por número do pedido, nome da organização ou código de entitlement
• Status do Pagamento -- filtrar por Concluído, Processando, Em Espera, Reembolsado, Cancelado ou Falhou
• Entidade de Cobrança -- filtrar por MIDDAG BR, MIDDAG GLOBAL ou Todos
• Intervalo de datas -- filtrar por data do pedido
• Possui Entitlements -- filtrar para exibir apenas pedidos que criaram (ou não criaram) entitlements

Visualização de detalhes

Clique em um número de pedido para abrir a visualização de detalhes. Ela combina dados do pedido WooCommerce com informações de entitlement do MIDDAG Account.

Cabeçalho

• Número do pedido com badge de status de pagamento
• Nome da organização (link clicável para a visualização de detalhes da Organização)
• Data do pedido, valor, moeda e entidade de cobrança
• Método de pagamento (cartão Stripe, Pix, Boleto, etc.)

Status de criação do entitlement

A seção central dos detalhes do pedido mostra o que aconteceu após a conclusão do pedido:

Status	O que significa
Criado	O entitlement foi criado com sucesso. Exibe o código e o link.
Pendente	O pedido ainda não foi concluído. O entitlement será criado na conclusão.
Ignorado	O produto não possui o meta _middag_entitlement_class definido. Nenhum entitlement era esperado.
Erro	A criação do entitlement falhou. Exibe a mensagem de erro.
Duplicata bloqueada	Uma criação duplicada foi detectada e ignorada (verificação de idempotência).

Cada item de linha do pedido é listado com seu próprio status de criação de entitlement. Isso permite ver exatamente quais produtos geraram entitlements e quais não geraram.

Itens de linha com mapeamento de entitlement

A tabela de itens de linha exibe:

Coluna	O que exibe
Produto	Nome do produto
Quantidade	Quantidade comprada
Preço	Preço unitário e total da linha
Entitlement Class	A classe configurada para este produto (PLG, ENV, SVC, etc.) ou "Nenhuma"
Entitlement Criado	O código do entitlement (clicável) ou o status caso ainda não tenha sido criado

Registros vinculados

Abaixo dos itens de linha, links para registros relacionados:

• Organização -- o cliente
• Entitlements -- todos os entitlements criados a partir deste pedido
• Faturas -- registros financeiros gerados a partir deste pedido
• Orçamento -- o orçamento que originou este pedido (se aplicável)
• Assinatura -- o registro de Assinatura do WooCommerce (se este for um pedido recorrente)

Solução de problemas: entitlement não criado

Se um pedido está completed mas nenhum entitlement foi criado, verifique os seguintes itens na ordem:

1. Meta do produto ausente. Abra o produto no WooCommerce e verifique se o campo meta _middag_entitlement_class está definido com uma classe válida (PLG, ENV, SVC, ORD, AFL ou EDU). Se este campo estiver ausente, o MIDDAG Account não sabe qual tipo de entitlement criar.

2. Organização não vinculada. O pedido deve estar associado a uma Organização do MIDDAG Account. Verifique se a conta WooCommerce do cliente está vinculada a um registro de Organização. Se não estiver, o serviço de provisionamento não consegue atribuir o entitlement a um cliente.

3. Detecção de duplicata acionada. Se a mesma combinação de pedido + item de linha + classe já possui um entitlement, o sistema ignora a criação. Verifique se já existe um entitlement buscando pelo número do pedido na lista de Entitlements.

4. Webhook não disparou. Se o pagamento foi processado pelo Stripe ou Banco Inter, a mudança de status do pedido WooCommerce depende da chegada bem-sucedida do webhook de pagamento. Verifique em WooCommerce > Status > Logs se há erros de entrega de webhook.

5. Erro no provisionamento. Verifique a seção de status de criação de entitlement do pedido para mensagens de erro. Causas comuns: configuração inválida do produto, erros de banco de dados ou timeouts de integração.

Se o problema foi resolvido mas o entitlement ainda precisa ser criado, você pode aguardar o próximo ciclo de cron (que faz nova tentativa de provisionamento com falha) ou criar o entitlement manualmente.

Pedidos de assinatura

Para produtos vendidos como assinaturas (via WooCommerce Subscriptions), a tela de Pedidos exibe tanto o pedido inicial quanto os pedidos de renovação. Pedidos de renovação estendem a data de expiração do entitlement existente em vez de criar um novo.

A visualização de detalhes para pedidos de assinatura inclui:

• Status da assinatura -- Ativa, Em Espera, Cancelada, Expirada
• Próxima data de renovação
• Histórico de renovação -- lista de pedidos de renovação anteriores com datas e valores
• Impacto no entitlement -- o que aconteceu com o entitlement em cada renovação (estendido, reativado, etc.)

Páginas relacionadas

• Entitlements -- o que os pedidos criam
• Organizações -- o cliente que realizou o pedido
• Dashboard -- pedidos pendentes aparecem nos itens de ação
• Pedidos (conceito) -- o pipeline de pedido-para-entitlement em detalhe
• Entitlement Classes -- como o produto determina a Entitlement Class