> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erpulse.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fatura Consolidada no Stripe

> Como a faturação 3PL funciona — uma fatura no Stripe com todos os clientes.

# Fatura Consolidada no Stripe

Como operador 3PL, você pode ter **uma fatura única** no Stripe com um item para cada loja gerenciada.

## Como funciona

```mermaid theme={null}
graph TD
    G["Gateway de pagamento\n(sua empresa)"]
    G --> S1["Assinatura: Loja A\nR$ 99/mês"]
    G --> S2["Assinatura: Loja B\nR$ 99/mês"]
    G --> S3["Assinatura: futuras lojas..."]
    G --> F["→ Uma fatura mensal\ncom todos os itens"]

    style G fill:#c8e6c9,stroke:#2e7d32,color:#1b5e20
    style S1 fill:#bbdefb,stroke:#1565c0,color:#0d47a1
    style S2 fill:#bbdefb,stroke:#1565c0,color:#0d47a1
    style S3 fill:#e3f2fd,stroke:#90caf9,color:#1565c0
    style F fill:#ffe0b2,stroke:#e65100,color:#bf360c
```

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)

<Info>
  O ERPulse identifica automaticamente que a loja é uma sub-empresa (`master_company_id` preenchido) e usa o Stripe Customer do master.
</Info>

## 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

<Warning>
  Se a subscription foi criada antes da migração para 3PL (loja com Stripe Customer próprio), o fallback não vai encontrá-la. É necessário migrar a subscription para o customer do master.
</Warning>

## 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)

→ [O que é 3PL?](/3pl/o-que-e-3pl)
→ [Vincular uma loja](/3pl/vincular-loja)