​

Fatura Consolidada no Stripe

O ERPulse suporta dois modelos de cobrança 3PL. Escolha o que melhor se adapta à sua operação.

​

Modelos disponíveis

---

​

Modelo 1: Fatura Consolidada (por loja)

Uma fatura única no Stripe com um item para cada loja gerenciada.

1. Todas as subscriptions das lojas são criadas no mesmo Stripe Customer (do master)
2. Cada subscription tem metadata.empresaId identificando a loja
3. A fatura mensal vem com um item por loja

​

Criar a subscription de uma loja

1. Use o StoreSelector para trocar para a loja
2. Acesse Configurações → Faturamento
3. Escolha o plano e complete o checkout
4. A subscription é criada no Stripe Customer do master (não da loja)

​

Verificar assinatura ativa

O ERPulse verifica a assinatura de uma loja em duas etapas:

1. Direto: busca stripeSubscriptionId nas settings da loja
2. Fallback 3PL: se não encontrar, busca no Stripe Customer do master por uma subscription com metadata.empresaId da loja

​

Faturas da sub-empresa

A sub-empresa vê apenas as faturas do seu próprio Stripe Customer (se tiver stripeCustomerId nas settings). O master vê a fatura consolidada com todos os itens.

​

Migrar subscription existente

Se uma loja já tinha subscription no Stripe Customer próprio:

1. Cancele a subscription antiga no Stripe
2. Crie uma nova subscription no customer do master com metadata.empresaId da loja
3. A fatura consolidada passa a incluir a loja

​

Fatura consolidada

Para ver a fatura consolidada do master:

1. Faça login como master (sua empresa)
2. Acesse Configurações → Faturamento
3. A fatura mostra todos os itens (uma por loja)

---

​

Modelo 2: Faixas Escalonadas (pool compartilhado)

O master paga uma única subscription que sobe de faixa automaticamente conforme vincula lojas. As lojas compartilham um pool de integrações.

​

Faixas

​

Como funciona

1. O master assina o plano Professional (faixa 1) no checkout normal
2. Ao vincular uma loja (master_company_id), o sistema conta o total de lojas
3. Se cruzou o limite da faixa (ex: 4ª loja), a subscription do master é automaticamente atualizada para a próxima faixa no Stripe (com prorrogação proporcional)
4. As lojas não têm subscription própria — herdam o plano do master
5. As integrações são contadas no pool (master + todas as lojas)

​

Pool de integrações

No modelo de faixas, as integrações são compartilhadas entre todas as lojas do master:

• O limite vem do plano do master (ex: 3 na faixa 1, 10 na faixa 2)
• A contagem inclui integrações ativas do master + todas as sub-empresas
• Quando o pool enche, nenhuma loja consegue criar nova integração
• A mensagem de erro indica que o limite do plano 3PL foi atingido (não o limite da loja)

​

O que cada um vê na tela de Faturamento

​

Verificar assinatura ativa (faixas)

Para sub-empresas no modelo de faixas:

1. Direto: busca stripeSubscriptionId nas settings da loja (modelo antigo)
2. Tier do master: se não encontrar, verifica se o master tem subscription ativa → sub-empresa herda
3. Fallback 3PL antigo: busca subscription com metadata.empresaId da loja no customer do master
4. Local: verifica plan_expiry da loja

​

Migrar do modelo antigo para faixas

Se uma loja já tinha subscription própria (modelo de fatura consolidada):

1. Cancele a subscription antiga da loja no Stripe
2. Vincule a loja ao master (se ainda não estiver)
3. A loja passa a herdar o plano do master automaticamente
4. A subscription do master pode subir de faixa se o número de lojas cruzar o limite

​

Comparação de custos

→ O que é 3PL? → Vincular uma loja