# Parceria de eventos

**Para quem:** produtor, dono de casa, gerente de organização  
**Última revisão:** 2026-08-15  
**Rotas relacionadas:** `/seller/events`, `/partner-invite/[token]`

---

## O que é parceria

Parceria conecta **duas organizações** na produção de um mesmo evento — por exemplo, uma **casa** que cede o espaço e uma **produtora** que programa o evento.

| Conceito | Descrição |
|----------|-----------|
| **Organização de produção** | Quem criou o evento (`organizationId` no banco) |
| **Organização parceira** | Quem aceita o convite (`partnerId`) |
| **Dono do evento** | Sempre a organização de produção — o evento não muda de dono |
| **Recebedor dos pagamentos** | Conta Stripe escolhida pelo dono da produção (pode ser produção ou parceira) |

Um evento só pode ter **uma parceira** por vez. Eventos **curados** não suportam parceria.

---

## Como convidar uma parceira

### Onde fazer

1. Acesse `/seller/events`
2. Expanda o card do evento
3. Na seção **Produção e parceria**, abra o painel de convite (visível quando ainda não há parceira conectada)

Guia do card: [06 — Gestão de eventos no painel](06-gestao-de-eventos-no-painel.md).

### Quem pode convidar

Apenas quem **gerencia a organização de produção** do evento:

- proprietário da org;
- colaborador `admin` ou `manager` na org;
- administrador da plataforma.

O parceiro **não** envia convites — só aceita ou recusa.

### Passo a passo

1. Em **Buscar organização**, digite ao menos **2 caracteres** do nome ou e-mail
2. Selecione a organização desejada na lista
3. Escolha o modo de envio:

| Modo | O que acontece |
|------|----------------|
| **Por link** | Gera URL `https://subcena.com/partner-invite/{token}` e copia para a área de transferência |
| **Por e-mail** | Envia convite para o **e-mail cadastrado** da organização parceira |

4. Compartilhe o link (modo link) ou aguarde o parceiro abrir o e-mail

### Regras do convite

| Regra | Detalhe |
|-------|---------|
| Organização alvo | Deve estar **ativa** e ter **e-mail** cadastrado |
| Não pode convidar | A própria organização de produção |
| Um convite pendente | Por organização alvo, por evento |
| Evento já com parceira | Não é possível enviar novos convites |
| Evento cancelado | Convites bloqueados |
| Link exclusivo | Só funciona para a organização selecionada na busca |
| Quem aceita | Precisa estar logado e **gerenciar** a org convidada |

### Acompanhar convites

Na seção **Convites enviados** do mesmo painel:

| Status | Significado |
|--------|-------------|
| **Pendente** | Aguardando resposta — pode copiar link, reenviar e-mail ou cancelar |
| **Aceito** | Parceria ativa |
| **Recusado** | Parceiro recusou |
| **Cancelado** | Produção cancelou antes da resposta |

Quando um convite é **aceito**, os demais pendentes do mesmo evento são cancelados automaticamente.

---

## Como o parceiro responde

### Receber o convite

- **Por link:** abrir `https://subcena.com/partner-invite/{token}`
- **Por e-mail:** clicar no link do e-mail (mesma URL)

### Aceitar ou recusar

1. Abrir a página do convite
2. Entrar com uma conta que **gerencie** a organização convidada
3. Clicar em **aceitar parceria** ou **recusar**

Após aceitar, o parceiro é redirecionado para o dashboard do evento em `/seller/events/{slug}`.

### Erros comuns na resposta

| Mensagem | Causa | O que fazer |
|----------|-------|-------------|
| "Você precisa gerenciar a organização convidada" | Conta logada não é dono/admin/manager da org parceira | Entrar com a conta correta |
| "Evento já possui parceira" | Outro convite foi aceito antes | Nada a fazer — parceria já fechada |
| "Convite cancelado" | Produção cancelou o convite | Pedir novo convite |
| "Evento cancelado" | Evento foi encerrado | Convite inválido |

---

## O que muda quando a parceria é aceita

| Campo | Efeito |
|-------|--------|
| `partnerId` | Organização parceira vinculada ao evento |
| `spaceId` | Se a **casa** for produção ou parceira, o espaço físico aponta para a org que é venue |
| Lista em `/seller/events` | Evento aparece para **ambas** as organizações |
| Página pública | Continua sob a organização de produção |
| Pagamentos | Caem na conta Stripe do **recebedor** configurado (padrão: dono da produção) |

---

## O que o parceiro PODE fazer

Quem gerencia a organização parceira tem acesso operacional ao evento — o mesmo nível de gestão da produção na maioria das ações:

| Ação | Parceiro pode? |
|------|----------------|
| Ver evento em `/seller/events` | Sim |
| **Editar** evento (data, lotes, descrição) | Sim |
| **Validar tickets** na porta | Sim |
| Abrir **dashboard** de vendas | Sim |
| **Pausar / abrir / encerrar** vendas | Sim |
| **Reabrir** vendas encerradas (se owner/manager da org parceira) | Sim |
| **Virar lote**, cupons, cortesias | Sim |
| **Exportar** e-mails de interessados | Sim |
| **Lista de ingressos** (checklist A4) | Sim |
| **Bar do evento** (se ativo) | Sim |
| **Dashboard** — Vendas, Público, Performance, Financeiro, Fechamento | Sim |
| **Crowdfunding** vinculado | Sim |
| **Cancelar evento** | Sim |
| Ver org de **produção** e de **parceira** no card | Sim |

O parceiro passa a ver o evento na lista porque a plataforma busca eventos onde sua org é `partnerId`.

---

## O que o parceiro NÃO PODE fazer

| Ação | Quem pode | Por quê |
|------|-----------|---------|
| **Convidar** outra parceira | Só a org de **produção** | O convite exige permissão na org que criou o evento |
| **Alterar conta de recebimento** dos pagamentos | Só o **proprietário** da org de produção | Configuração financeira do dono do evento |
| Transferir **propriedade** do evento para a parceira | Ninguém via parceria | `organizationId` não muda — parceria não é transferência de evento |
| Aceitar convite em nome de outra org | Só quem gerencia a org **convidada** | Validação no aceite do token |
| Convidar a própria org de produção | Bloqueado | Regra de negócio |

### Pagamentos — atenção especial

- Os repasses Stripe vão para a conta vinculada ao `userId` do evento (recebedor).
- Por padrão, o recebedor é o **dono da organização de produção**.
- O dono da produção pode trocar o recebedor para o dono da parceira — **somente se ambos tiverem Stripe ativo**.
- O parceiro **não** vê o seletor de conta de recebimento; só o proprietário da produção.

### Equipe e Stripe

- Colaboradores da org parceira (admin/manager) também acessam o evento.
- A conta Stripe usada nos pagamentos é do **usuário recebedor**, não da organização em si.
- Colaboradores operam o evento, mas repasses vão para a conta Stripe do dono configurado.

---

## Após a parceria estar ativa

No card expandido, a seção **Produção e parceria** mostra:

| Elemento | Função |
|----------|--------|
| Card da **Produção** | Org que criou o evento + status Stripe |
| Card do **Parceiro** | Org conectada + status Stripe |
| **Conta de recebimento** | (Só dono da produção) Escolher onde caem os pagamentos |
| **Remover parceria** | Desfaz o vínculo — ação permanente |
| **Crowdfunding** | Vincular campanha ao evento |

### Remover parceria

O botão **Remover parceria** desassocia a organização parceira do evento. O evento continua existindo sob a produção original; ingressos já vendidos não são afetados automaticamente.

**Antes de remover:** alinhe com o parceiro e confira fechamento financeiro no dashboard.

### Fechamento e divisão

No dashboard do evento, a seção **Fechamento** permite apurar receitas e custos entre produção e parceira — incluindo opção de repassar custos ao parceiro. Ver [07 — Dashboards](07-dashboards.md).

---

## Cenários comuns

### Casa + produtora

| Papel | Org típica | Papel na parceria |
|-------|------------|-------------------|
| Casa | `isVenue: true` | Parceira (espaço físico) ou produção |
| Produtora | produtora | Produção (programação) ou parceira |

Quem cria o evento é sempre a **produção**. A casa, se for venue, vira o `spaceId` do evento quando aceita como parceira.

### Só operação compartilhada

Duas produtoras podem fazer parceria: uma cria, convida a outra, e ambas operam vendas e validação. O recebedor dos pagamentos é definido pelo dono da produção.

### Parceiro é colaborador, não dono

Se o gerente da org parceira é **colaborador** (não proprietário), ele ainda pode aceitar o convite e operar o evento — desde que tenha role `admin` ou `manager` na org parceira.

---

## Fluxo completo

```mermaid
sequenceDiagram
  participant Prod as Org de produção
  participant Plataforma as Subcena
  participant Parceiro as Org parceira

  Prod->>Plataforma: Busca org e envia convite
  Plataforma->>Parceiro: Link ou e-mail
  Parceiro->>Plataforma: Aceita convite
  Plataforma->>Plataforma: Vincula partnerId
  Plataforma->>Prod: Evento com parceira ativa
  Plataforma->>Parceiro: Evento visível em /seller/events
  Prod->>Plataforma: Define conta de recebimento (opcional)
```

---

## Problemas comuns

| Sintoma | Causa provável | O que fazer |
|---------|----------------|-------------|
| Não acho a org na busca | Nome/e-mail diferente ou org inativa | Confirme e-mail cadastrado; peça para org ativar perfil |
| "Já existe convite pendente" | Convite anterior não respondido | Cancele o pendente ou aguarde resposta |
| Parceiro não vê o evento | Convite não aceito ou conta errada | Aceitar com conta que gerencia a org convidada |
| Parceiro não altera recebedor | Só dono da produção pode | Dono da produção acessa Produção e parceria |
| Conta de recebimento não aparece | Stripe inativo em uma das orgs | Ambos donos completam Stripe em `/seller` |
| Evento curado sem parceria | Fluxo não suportado | Parceria só em eventos de produção direta |

---

## Referências relacionadas

| Guia | Conteúdo |
|------|----------|
| [06 — Gestão de eventos no painel](06-gestao-de-eventos-no-painel.md) | Onde fica o painel de convite no card |
| [07 — Dashboards](07-dashboards.md) | Fechamento e divisão entre parceiros |
| [02 — Organização](02-organizacao.md) | Equipe, colaboradores e tipos de org |
| [Stripe e taxas](../pagamentos/stripe-e-taxas.md) | Contas de recebimento e repasses |