Propostas
Uma Proposta é uma proposta comercial enviada a um cliente. Ela descreve o que está sendo oferecido, a que preço e por quanto tempo a oferta é válida. Propostas possuem um ciclo de vida rico — do rascunho até a aceitação, pagamento e cumprimento — e servem como o ponto de partida do pipeline de vendas no MIDDAG Account.
Por que propostas importam
Em vendas B2B, clientes raramente compram por um carrinho de compras. Eles solicitam uma proposta, a analisam internamente, negociam termos e então aprovam. Propostas formalizam esse processo: a equipe de vendas cria uma proposta, o cliente a analisa no portal, e a aceitação aciona toda a cadeia downstream — criação de pedido, processamento de pagamento, provisionamento de entitlement.
Ciclo de vida da proposta
Toda proposta percorre um conjunto definido de estados:
| Estado | O que significa |
|---|---|
| Draft | Criada, mas ainda não enviada. Admin pode editar livremente. |
| Sent | Entregue ao cliente. Um link do portal é incluído no e-mail de notificação. |
| Viewed | Cliente abriu a proposta no portal. Timestamp registrado automaticamente. |
| Accepted | Cliente confirmou a aceitação no portal. Irreversível pelo cliente. |
| Rejected | Cliente recusou explicitamente. Um motivo é obrigatório (mínimo 10 caracteres). |
| Expired | A data de validade passou sem ação do cliente. |
| Paid | Pagamento confirmado via Stripe ou Banco Inter. |
| Fulfilled | Entitlement provisionado. Estado terminal para propostas bem-sucedidas. |
| Refunded | Pagamento foi estornado após confirmação. Pedido cancelado, HubSpot sincronizado. |
O pipeline da proposta ao entitlement
Quando um cliente aceita e paga uma proposta, este pipeline automatizado é executado:
- Proposta aceita — cliente clica em "Aceitar" no portal.
- Pedido criado — um pedido WooCommerce é gerado automaticamente a partir dos itens da proposta.
- Pagamento — o cliente paga usando os métodos disponíveis para sua entidade (Pix, Boleto ou cartão de crédito para MIDDAG BR; cartão de crédito para MIDDAG GLOBAL).
- Webhook confirma — o gateway de pagamento notifica o sistema.
- Entitlement provisionado — o sistema cria entitlements com base nos produtos do pedido.
- Fulfilled — a proposta atinge seu estado terminal. O cliente vê o novo entitlement no portal.
Itens da proposta
Cada proposta contém um ou mais itens. Cada item especifica:
- Produto ou serviço
- Quantidade
- Preço unitário
- Desconto (se houver)
- Entitlement Class que será criada após o cumprimento
Os itens são somente leitura para o cliente. Apenas o admin ou a equipe de vendas (via HubSpot) podem modificá-los.
Tratamento de expiração
Propostas possuem uma data de validade (valid_until), com padrão de 30 dias a partir da data de envio. Quando a data de validade expira:
- A proposta transiciona automaticamente para
expired. - Os botões de aceitar e recusar são desabilitados no portal.
- O cliente pode solicitar um reenvio via comentários.
- O admin pode reenviar uma proposta expirada, o que cria uma nova proposta com um novo período de validade.
Integração com HubSpot
Propostas podem se originar do HubSpot. Quando a equipe de vendas cria ou atualiza uma proposta no CRM HubSpot, um webhook notifica o MIDDAG Account:
- Proposta criada no HubSpot — um registro local é criado com itens, valores e validade mapeados dos campos do HubSpot.
- Proposta atualizada no HubSpot — o registro local é atualizado para corresponder.
- Sincronização de status é bidirecional — HubSpot envia criação e edições; MIDDAG Account devolve aceitação, rejeição e status de pagamento.
O HubSpot é a fonte de verdade para dados de vendas. Propostas originadas do HubSpot não são editáveis no admin do WordPress.
Roteamento de entidade dupla
Cada proposta é roteada para a entidade jurídica correta (MIDDAG BR ou MIDDAG GLOBAL) seguindo as mesmas regras de roteamento de pedidos e faturas. A entidade determina qual conta Stripe processa o pagamento e quais métodos de pagamento estão disponíveis.
Comentários e negociação
Clientes podem adicionar comentários a uma proposta no portal, similar a uma discussão encadeada. Isso suporta negociação sem sair da plataforma. Comentários são visíveis tanto para o cliente quanto para a equipe de vendas, e são sincronizados com o HubSpot quando a proposta se originou lá.
O que os admins veem
No admin do WordPress, a interface de gestão de propostas mostra:
- Número e status da proposta
- Organização e contato
- Valor total e moeda
- Entidade (MIDDAG BR ou MIDDAG GLOBAL)
- Data de validade
- Origem (manual ou HubSpot)
Admins podem criar propostas manualmente, editar rascunhos, reenviar propostas expiradas ou rejeitadas e monitorar o pipeline. Propostas criadas manualmente não recebem vínculo com o HubSpot, a menos que o admin associe um negócio explicitamente.
Páginas relacionadas
- Pedidos — criados automaticamente quando uma proposta é aceita e paga
- Entitlements — provisionados após o cumprimento da proposta
- Faturas — registros financeiros gerados a partir de pagamentos de propostas
- Entidades Jurídicas — como propostas são roteadas para a entidade correta