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

# O que é 3PL?

> Entenda o modelo 3PL no ERPulse — um operador logístico gerenciando múltiplas lojas.

# O que é 3PL?

**3PL (Third-Party Logistics)** é o modelo onde você, como operador logístico, gerencia múltiplas lojas (clientes e-commerce) em um único painel. Cada loja mantém seus dados isolados (pedidos, produtos, estoque), mas você vê tudo agregado e pode trocar entre lojas.

## Como funciona no ERPulse

```mermaid theme={null}
graph TD
    M["Operador 3PL\n(sua empresa)"]
    M --> L1["Loja 1\n(Cliente A)"]
    M --> L2["Loja 2\n(Cliente B)"]
    M --> L3["Loja 3\n(futuros clientes)"]

    style M fill:#c8e6c9,stroke:#2e7d32,color:#1b5e20
    style L1 fill:#bbdefb,stroke:#1565c0,color:#0d47a1
    style L2 fill:#bbdefb,stroke:#1565c0,color:#0d47a1
    style L3 fill:#e3f2fd,stroke:#90caf9,color:#1565c0
```

* Cada loja é uma **company** (tenant isolado com partição própria)
* O operador 3PL é um **usuário** com acesso a múltiplas companies via `user_companies`
* O campo `master_company_id` vincula a loja ao operador master

## O que o operador 3PL vê

| Recurso                  | Descrição                                                     |
| ------------------------ | ------------------------------------------------------------- |
| **StoreSelector**        | Seletor de lojas no topo do painel com opção "Todas as lojas" |
| **Fulfillment agregado** | Pedidos de todas as lojas em uma só tela, com coluna "Loja"   |
| **Dashboard agregado**   | Estatísticas consolidadas de todas as lojas                   |
| **Fatura consolidada**   | Uma fatura no Stripe com todos os clientes (Fase 1)           |
| **Aba 3PL**              | Em Configurações, para vincular/desvincular lojas             |

## O que cada loja vê

Cada loja (sub-empresa) continua com seu painel isolado — pedidos, produtos, integrações, etc. O operador da loja não vê as outras lojas nem o painel 3PL.

## Pré-requisitos

* O operador 3PL precisa ter role `owner` ou `admin` na empresa master
* A permissão `operator:view` é necessária para acessar as rotas 3PL
* A permissão `operator:manage` é necessária para vincular/desvincular lojas

## Próximos passos

* [Como vincular uma loja](/3pl/vincular-loja)
* [Usando o seletor de lojas](/3pl/seletor-de-lojas)
* [Fatura consolidada no Stripe](/3pl/fatura-consolidada)