Operações no Mapaprop — Guia Completo
PARTE 1 — Manual do Usuário
1. O que são as Operações?
Uma operação é o registro de uma transação comercial sobre uma propriedade: uma reserva, uma venda, um aluguel, uma permuta ou uma perda. É o "o que aconteceu, quando, com quem e a que preço" de cada movimentação do imóvel.
Exemplo concreto
A sua corretora María fecha uma reserva de um apartamento por USD 130.000 com sinal de USD 5.000. Uma semana depois, o comprador assina o contrato e a venda é fechada por USD 128.000 (negociou USD 2.000 a menos). O Mapaprop guarda uma única operação que passou por dois estados: primeiro
Reservada, depoisVendida. Essa operação fica registrada com: preço de publicação (USD 139.000), oferta do comprador (USD 130.000), sinal (USD 5.000), preço de fechamento (USD 128.000), comprador, proprietário, corretor responsável, filial, datas. Tudo isso alimenta os seus relatórios de gestão e o seu histórico comercial.
2. Para que serve?
As Operações existem porque, antes, o Mapaprop guardava apenas o estado atual de cada propriedade (vendida, alugada, etc.) sem contexto. Com as Operações agora você pode:
| Necessidade do negócio | Como as Operações ajudam |
|---|---|
| Saber quanto cada corretor faturou | Relatório "Minhas Operações" + ranking em "Imobiliária" |
| Medir a sua diferença de negociação | Relatório "Diferença" — diferença entre publicação e fechamento |
| Calcular comissões por operação | Cada deal guarda a comissão em valor fixo ou % |
| Ver o histórico completo de uma propriedade | Painel "Operações" na ficha de cada imóvel |
| Identificar as suas melhores filiais | Relatório "Imobiliária" com ranking de corretores |
| Comparar a sua rede de franquias (BusinessManager) | Relatório "Rede" com drill-down por escritório |
| Ter auditoria comercial completa | Nada é apagado fisicamente. Se o administrador excluir uma operação, fica registrado quem, quando e por quê |
3. Como uma operação é composta
Cada operação tem 4 partes de informação:
3.1 Estado
Indica em que momento do ciclo está a operação. Só pode ser um destes:
| Estado | Significado | Cor |
|---|---|---|
| Reservada | Operação aberta, em negociação | Âmbar |
| Vendida | Fechada como venda | Verde |
| Alugada | Fechada como aluguel tradicional | Verde |
| Aluguel por temporada | Fechada como aluguel por temporada | Verde (igual a alugada) |
| Permutada | Fechada como permuta de imóveis | Verde |
| Perdida | A operação caiu sem se concretizar | Vermelho |
⚠️ Uma operação fechada (Vendida / Alugada / etc.) NÃO pode ser revertida. Se depois a operação cai, é preciso criar uma operação nova com estado
Perdida. A fechada permanece como histórico.
3.2 Tipo
Indica de que tipo de transação se trata. É derivado automaticamente do tipo de operação que a propriedade cadastrada tenha (Venda, Aluguel, Temporada, Permuta).
3.3 Dados econômicos
| Campo | Quando é preenchido | Para quê |
|---|---|---|
| Preço de publicação | É copiado automaticamente da propriedade ao criar a operação | Comparar com o fechamento real |
| Oferta de reserva | O comprador fez esta oferta ao reservar | Negociação inicial |
| Valor de reserva (sinal) | Se houve sinal, quanto pagou | Caixa antecipado |
| Preço de fechamento | O que finalmente foi assinado | Receita real, base para a comissão |
| Comissão ⚠️ | Valor fixo ou percentual sobre o fechamento — obrigatória ao fechar (Vendida / Alugada). Em aluguel e aluguel por temporada só se exibe Valor fixo (veja a nota abaixo) | Receita da imobiliária, base para os relatórios de operações fechadas |
3.4 Participantes
- Vendedor / Proprietário: quem era dono do imóvel (da sua lista de contatos).
- Comprador / Inquilino: quem fez a operação (da sua lista de contatos).
- Corretor responsável: o usuário do Mapaprop que abriu a operação.
- Filial: a filial à qual pertence a operação (é herdada da propriedade).
4. Dois modos para registrar uma operação: Básico e Business
Quando você fecha uma operação a partir da ficha de uma propriedade, abre-se a janela "Fechamento de Operação". Ali você pode escolher entre 2 formas de registrá-la:
4.1 Modo Básico
- O que faz? Apenas muda o estado da propriedade (Reservada / Vendida / Alugada / Suspensa) e opcionalmente registra um preço de fechamento.
- O que NÃO faz? Não guarda contatos, nem comissão, nem histórico detalhado. Não gera operação rastreável nos relatórios.
- Quem usa? Imobiliárias pequenas que só precisam marcar o estado das suas propriedades sem se preocupar com relatórios de gestão.
- Plano necessário: qualquer um (Free, Plus, Pro+, Business).
4.2 Modo Business (recomendado)
- O que faz? Cria uma operação completa com todos os dados: contatos, oferta, sinal, fechamento, comissão, comentários. Depois aparece em todos os relatórios.
- Plano necessário: Business ou Business Manager (planos 56 e 57).
4.3 Tabela comparativa
| Característica | Básico | Business |
|---|---|---|
| Muda o estado da propriedade | ✅ | ✅ |
| Guarda o preço de fechamento | ✅ (opcional) | ✅ (obrigatório nos fechamentos) |
| Guarda contatos | ❌ | ✅ |
| Guarda o sinal | ❌ | ✅ |
| Guarda a comissão | ❌ | ✅ |
| Aparece nos relatórios | ❌ | ✅ |
| Contribui para a diferença | ❌ | ✅ |
| Plano | Qualquer um | Business |
💡 Recomendação: se você tem o plano Business, use sempre o modo Business. É a única forma de aproveitar os relatórios de gestão.
4.4 Decisão por plano
| Seu plano | O que acontece ao abrir o modal |
|---|---|
| Free / Plus / Pro+ | Mostra os 2 modos. Se você escolher o modo Business → janela de upgrade para o plano Business |
| Business / BusinessManager | Entra direto no modo Business (não mostra o seletor) |
5. Como registrar uma operação passo a passo
5.1 Criar uma reserva
- Entre na ficha da propriedade → botão "Fechamento de Operação".
- A janela abre. Escolha "Reservada" entre as opções de estado.
- Se você tem Business, vai para o wizard por etapas:
- Estado: você já escolheu Reservada.
- Tipo de operação (aparece só ao reservar sobre as suas próprias propriedades): você escolhe como a operação é composta — Uma única ponta (você representa uma parte), Dupla ponta (você leva vendedor E comprador) ou Co-brokering (o comprador foi trazido por outro broker do seu escritório ou da sua rede no Mapaprop). Em Dupla ponta e Co-brokering o sistema cria 2 operações vinculadas (veja §7.12). Há ainda uma opção "Operação externa" que leva você a Minhas Operações para registrar uma operação sobre uma propriedade que não está no Mapaprop (veja §7.10).
- Valores: informe a oferta do comprador. Se houve sinal, marque a caixa de seleção e informe o valor.
- Participantes: vincule vendedor e comprador a partir dos seus contatos. Você pode escolher um já vinculado à propriedade, buscá-lo ou criá-lo na hora. Qualquer contato que você vincule aqui também fica vinculado à propriedade — você vai vê-lo depois na ficha, na aba Contatos (o vendedor como Dono, o comprador como Interessado).
- Comentários: opcional, para deixar contexto interno.
- Clique em Salvar Operação.
A propriedade fica marcada como Reservada e aparece um chip vermelho "Operação em processo" na sua ficha.
5.2 Fechar a operação (Vendida / Alugada / etc.)
Há 2 formas de chegar ao fechamento:
Opção A — A partir da ficha da propriedade:
- Clique em "Gerenciar Operação" (botão vermelho). Leva você ao detalhe da operação reservada.
- Ali você escolhe o estado de destino: Fechar como Vendida / Fechar como Alugada / etc.
- A janela pede o Preço de fechamento e a Comissão — ambos os campos são obrigatórios ao fechar (as outras seções ficam recolhidas porque você já tinha os dados carregados).
- Clique em Atualizar Operação.
Opção B — Direto a partir da ficha da propriedade:
- Clique em "Fechamento de Operação".
- Você escolhe o estado terminal diretamente (ex.: Vendida).
- A janela abre com os dados da reserva pré-carregados. Você preenche fechamento e comissão.
- Salvar.
Comissão obrigatória ao fechar (desde 2026-05-29)
Ao fechar uma operação como Vendida ou Alugada, a comissão é obrigatória. Você pode indicá-la de duas formas (basta uma):
- Valor fixo (ex.: USD 6.300)
- Percentual sobre o preço de fechamento (ex.: 3%)
Se você preencher uma, a outra é calculada automaticamente. O botão "Confirmar Operação" fica desabilitado até que a comissão seja preenchida.
Motivo: os relatórios de operações fechadas (/deals/business, /deals/network, diferença de negociação) usam a comissão para calcular receitas totais, médias e métricas acionáveis. Sem esse dado os relatórios perdem valor.
Para reservas e perdas a comissão continua sendo opcional.
Comissão em Aluguel e Aluguel por Temporada (desde 2026-05-30)
Em operações de aluguel e aluguel por temporada, o campo de comissão exibe apenas Valor fixo — a opção Percentual % não aparece, e tampouco o aviso de "a comissão supera o preço de fechamento".
Motivo: o preço que o sistema usa como "fechamento" é o aluguel mensal, mas a comissão real é acordada sobre o contrato (tipicamente 1 mês sobre o valor anual). Calcular um % contra o mensal dava valores sem sentido (ex.: 122% para uma comissão de um mês) e disparava um aviso falso permanente. Até que o sistema modele um "valor base de comissão" separado do preço de fechamento, em aluguel/temporada você informa diretamente o Valor fixo da comissão acordada.
Depois do fechamento:
- A operação fica com estado terminal e data de fechamento.
- A propriedade fica marcada como Vendida (ou Alugada se foi rent / temp / exchange).
- É registrado no histórico de preços da propriedade.
- Aparece no relatório de "Minhas Operações" do corretor que fechou.
5.3 Cancelar uma reserva (Perdida)
Quando uma reserva não se concretiza:
- A partir da ficha da propriedade → "Gerenciar Operação" → estado Perdida.
- Ou a partir do detalhe da operação → botão vermelho "Cancelar reserva".
- Salvar.
A operação passa a Perdida (não pode ser revertida), a propriedade volta a Disponível automaticamente, e fica registrada como perda nos relatórios (contribui para a "taxa de perda" do corretor).
5.4 Editar enquanto a operação está em andamento
Enquanto a operação estiver Reservada você pode corrigir os seus dados sem mudar o estado. Há dois caminhos:
- A partir do detalhe da operação (
/deals/[id]) → botão "Editar": abre uma janela para ajustar oferta e moeda, sinal, contatos (vendedor / comprador) e comentários. A comissão não se altera aqui — é preenchida apenas ao fechar. Este botão é para administradores da conta. - A partir da ficha da propriedade → "Gerenciar Operação": a janela abre com seções recolhíveis (Estado / Valores / Participantes / Comentários) para editar o que você precisar.
💡 Antes só era possível editar uma reserva a partir de "Gerenciar Operação" na ficha da propriedade. Desde 2026-08 também há um botão "Editar" direto no detalhe da operação, para não ter que voltar à propriedade.
5.5 Voltar uma propriedade para "Disponível"
Se uma propriedade está reservada e o cliente mudou de ideia sem formalizar a perda, você NÃO pode mandá-la direto para Disponível enquanto ela tiver uma operação em andamento. O Mapaprop bloqueia você com uma mensagem:
"Há uma operação reservada em andamento. Para mudar o estado da propriedade você precisa resolvê-la em Gerenciar Operação ou marcá-la como Perdida."
Dois caminhos:
- Clique em "Marcar como perdida" a partir da mensagem de bloqueio → cancela a reserva e libera a propriedade em um único clique.
- Clique em "Gerenciar Operação" → resolver manualmente (fechamento concretizado ou perda).
Isso evita que fiquem operações órfãs (reservadas no sistema, mas a propriedade já foi colocada à venda de novo).
5.6 Mudar o estado de uma propriedade já vendida/alugada
Se a propriedade está vendida (operação fechada) e você quer voltar a colocá-la à venda, você pode:
- Marcá-la como Disponível a partir da ficha (isso NÃO afeta a operação fechada — ela continua ali como histórico).
- Criar uma nova operação quando chegar outra reserva. O histórico ficará com: deal antigo (vendido) + deal novo (reservado/fechado/perdido).
6. Os 6 relatórios de operações
Todos acessíveis a partir do menu Painel → Relatórios.
6.1 Todas as operações (/deals)
Listagem completa e filtrável de todas as operações da sua conta.
- Filtros: período (de/até), tipo de operação, estado, ponta (vendedora/compradora — veja §7.9), origem (própria/externa/excluída — veja §7.11), filial, corretor.
- Mini-cards no topo com 12 KPIs ao vivo (veja §6.7) que respeitam os filtros aplicados.
- Tabela com colunas: Id (número da operação, ex.
#1234, com link direto para o detalhe), Propriedade, Corretor / Filial (o corretor responsável e a sua filial), Contato, Tipo, Ponta (badge verde Vendedora / roxo Compradora / cinza Ambas), Origem (badge cinza 🏠 Própria / roxo 🔗 Externa / vermelho 🗑️ Excluída), Estado, Oferta, Fechamento, Comissão, Data. Uma linha pode exibir também um ícone de alerta quando a operação faz parte de um par vinculado com uma anomalia (veja §7.12). - Chips de filtros ativos com X para remover individualmente.
- Botão "+ Adicionar operação" (admins): cria operação manual sem propriedade associada (veja §7.10). | Botão "Ver excluídas" (com contador) | Somente administrador da conta |
- Exportar para CSV para análise externa (respeita os filtros).
- Mobile: cards em vez de tabela.
- Quem vê: admins (main / manager). Os corretores são redirecionados automaticamente para "Minhas Operações".
6.2 Minhas Operações (/deals/my-deals)
Dashboard pessoal do corretor. Pensado para que cada corretor meça a sua performance.
- Identificação da sua filial no topo (logo ou ícone + nome + endereço + contato).
- KPIs: reservas abertas, fechadas no período, comissões ARS, comissões USD.
- Taxas: fechamento e perda.
- Listas rápidas: reservas abertas + últimos fechamentos com clique para ver o detalhe.
- Botão "+ Adicionar operação": permite registrar uma operação manual sobre uma propriedade externa (veja a seção 7.10).
- Quem vê: todos. Os corretores veem apenas o que é seu automaticamente.
6.3 Imobiliária (/deals/business)
Estatísticas consolidadas da sua imobiliária com ranking de corretores.
- Identificação do seu escritório no topo (logo + nome + dados do customer).
- KPIs globais: reservas, fechamentos, comissões, taxas.
- Ranking de corretores: tabela ordenada por fechamentos com volume e taxa de fechamento.
- Distribuição por tipo de operação: barras visuais (venda / aluguel / etc.).
- Fechamentos por mês: tabela de evolução temporal.
- Quem vê: admins (main / manager / adminMain). Os corretores não.
6.4 Rede (/deals/network)
Visão cross-office para gestores de redes de franquias. Disponível apenas no plano BusinessManager.
- KPIs agregados de toda a rede.
- Ranking de franquias: tabela com drill-down (clicar em uma franquia leva você à "Imobiliária" dela).
- Quem vê: apenas o Gestor de Rede (BusinessManager) e o suporte do Mapaprop.
6.5 Captações (/deals/captations)
Relatório de propriedades aprovadas pela moderação e pendentes no período.
- Captações aprovadas: quantas propriedades novas passaram pelo controle de moderação.
- Pendentes: quantas estão aguardando aprovação.
- Efetividade: % de captações que terminaram em fechamento (cálculo aproximado).
- Fechamentos do período: para contraste.
- Tabela: detalhe por propriedade.
- Quem vê: todos os perfis.
ℹ️ Nota sobre a efetividade: o cálculo é aproximado — divide os fechamentos do período pelas captações do período sem verificar se os fechamentos correspondem realmente às propriedades captadas. É um guia, não um funil exato.
6.6 Diferença de Negociação (/deals/brecha)
Três métricas-chave da sua negociação:
- Publicação para oferta: quanto menos os compradores oferecem em relação ao preço publicado (em média).
- Oferta para fechamento: quanto se ajusta entre a oferta inicial e o fechamento.
- Desconto final total: a diferença entre publicação e fechamento. É medido direto (publicação contra fechamento), não é a subtração dos dois indicadores anteriores.
- Sinal médio: % do fechamento que é cobrado como sinal.
Os três indicadores não se somam nem se subtraem entre si. Cada um é calculado como média sobre as operações que têm os dados de que esse indicador precisa (e na mesma moeda), então podem se basear em quantidades diferentes de operações. Por isso, por exemplo, um "6,7% a menos" em publicação→oferta e um "1,3% a mais" em oferta→fechamento não dão "5,4%" de desconto final: são grupos de operações diferentes.
A tela explica isso por conta própria:
- Cada indicador mostra sobre quantas operações foi calculado.
- Um detalhe por operação lista quais operações alimentam cada número (e marca as que não contribuem, por exemplo por terem oferta e fechamento em moedas diferentes).
- O botão "Somente dados completos" recalcula os três indicadores usando unicamente as operações com publicação + oferta + fechamento na mesma moeda → assim os três números ficam sobre o mesmo grupo e sim são comparáveis entre si.
- Quem vê: admins (main / manager / adminMain). Os corretores não (é informação estratégica de gestão). No dashboard da imobiliária há um acesso direto "Ver análise de diferença".
6.7 Mini-cards de KPIs (em todos os relatórios)
Acima de cada listagem de operações (/deals, my-deals, branch, network) há uma grade de 12 mini-cards com métricas ao vivo. Todas respeitam os filtros aplicados (período, filial, etc.). Cada card tem tooltip ao passar o mouse com a fórmula exata do cálculo.
Linha 1 — Volume e contagens:
| Card | O que mostra | Como é calculado |
|---|---|---|
| Volume fechado equivalente | Volume total com toggle USD/ARS | Soma dos fechamentos convertidos. Cada deal em ARS é convertido para USD usando o dólar do momento do fechamento (snapshot histórico). |
| Volume fechado USD | Total nativo USD | Somente deals fechados em USD. Sem conversão. |
| Volume fechado ARS | Total nativo ARS | Somente deals fechados em ARS. Sem conversão. |
| Reservas abertas | Quantidade | Deals reservados pendentes de fechar ou cair. |
| Fechados | Quantidade | Deals em estado terminal positivo (vendido / alugado / temporada / permuta). |
| Perdas | Quantidade | Reservas canceladas. |
Linha 2 — Performance + mix (só aparece se houver deals fechados):
| Card | O que mostra | Como é calculado |
|---|---|---|
| Comissão fechada 🟢 | Total ganho por moeda | Soma do campo "Comissão - Valor" dos fechamentos do período (ARS e USD se aplicáveis). |
| Comissão média | Ticket médio | Comissão total ÷ quantidade de fechamentos. Prioriza USD se houver. |
| Taxa de fechamento | % de sucesso | Fechados ÷ (fechados + perdas) × 100. Cor: 🟢 verde se > 60%, 🟡 âmbar 30-60%, 🔴 vermelho < 30%. |
| Dias até o fechamento méd. | Velocidade | Média de dias entre a abertura (reserva) e o fechamento. Mede quão rápido você fecha. |
| Origem | Próprias vs Externas | Fechamentos sobre propriedades da sua conta vs externas (veja §7.11). |
| Ponta | Vendedora vs Compradora | Fechamentos como ponta vendedora (minha propriedade) vs compradora (operação manual). Reflete o perfil do corretor. |
💡 A linha 2 é nova (maio de 2026). Se o período não tiver fechamentos, só se exibe a linha 1.
7. Regras importantes
7.1 Uma única reserva por propriedade
Cada propriedade pode ter uma única operação em estado Reservada ao mesmo tempo. Se você tentar criar uma segunda reserva, o sistema usa a existente.
7.2 Excluir uma operação (e por que a rastreabilidade se mantém)
O administrador da conta pode excluir uma operação em qualquer estado (reservada ou fechada). É uma ação definitiva: não pode ser desfeita.
Como funciona, e por que você não perde a rastreabilidade:
- A operação deixa de contar em todos os seus relatórios e listagens (KPIs, diferença, rankings, etc.) — como se não existisse para a gestão.
- Mas nada é apagado fisicamente: a operação é conservada e fica registrado quem a excluiu, quando e com que motivo (o motivo é obrigatório). Essa informação fica no Histórico de alterações da operação, para auditoria.
- Para vê-las, em "Todas as operações" há um botão "Ver excluídas" (somente para o administrador da conta) que mostra quantas há e as lista com o seu motivo e data. A partir dali você abre cada uma e vê o detalhe marcado como excluída.
- Se a operação fazia parte de um par vinculado (co-brokering ou dupla ponta), ao excluir uma ponta o sistema oferece excluir também a outra (quando é do seu mesmo escritório). Se você deixar o par pela metade, a operação que resta exibe um alerta de discordância.
- Se a operação estava Reservada, ao excluí-la a propriedade volta a Disponível (é liberada e, se estava compartilhada em uma rede, volta a aparecer nas buscas da rede) — igual a uma Perda. Excluir uma operação já fechada (Vendida/Alugada) não muda o estado da propriedade.
Quando usar: uma operação cadastrada por engano, uma duplicata ou um teste. Se, em vez disso, a operação foi real mas não se concretizou, o correto é marcá-la como Perdida (assim ela fica nos relatórios como uma perda, que é informação de gestão válida).
Não confunda com uma propriedade excluída (§7.4): se você apagar a propriedade, as suas operações são conservadas e continuam contando nos relatórios (marcadas como "(excluída)"). Excluir a operação é outra coisa: a tira dos relatórios. São duas ações diferentes.
7.3 Estados terminais não se reabrem
Uma vez que uma operação passa a Vendida / Alugada / Perdida / etc., esse estado fica fixo. Se você precisar registrar uma nova negociação sobre a mesma propriedade, cria uma operação nova.
7.4 As propriedades excluídas conservam as suas operações
Se você excluir uma propriedade do sistema, as operações associadas não são apagadas. Ficam acessíveis a partir da listagem global com um snapshot dos dados básicos do imóvel (endereço, código, zona) mas marcadas como "(excluída)".
7.5 Diferença de negociação: preencha sempre o preço de fechamento
Para que a diferença funcione bem, certifique-se de sempre preencher o campo "Preço de fechamento" ao fechar uma operação (é obrigatório no modo Business). O preço de oferta é opcional mas recomendado.
7.6 Operação em processo bloqueia mudanças de estado da propriedade
Se uma propriedade tem uma reserva ativa, você não pode mudar o seu estado para Disponível ou Suspensa sem antes resolver a reserva (fechá-la como Vendida/Alugada/etc. ou marcá-la como Perdida). O sistema avisa você com uma mensagem e oferece marcá-la como perdida em um único clique.
7.7 O tipo de operação é derivado do tipo da propriedade
Quando você cria uma nova operação sobre uma propriedade de aluguel, a operação nasce com tipo "Aluguel" automaticamente. Você não precisa escolhê-lo. Se a propriedade é de venda, nasce como "Venda". Isso evita inconsistências entre o tipo da propriedade e o tipo da operação.
7.8 Todo fechamento nasce a partir de uma reserva
Regra: você não pode fechar uma operação como Vendida / Alugada / Permutada / Aluguel por temporada diretamente sobre uma propriedade que está Disponível ou Suspensa. Primeiro você tem que criar uma Reserva, e a partir dela fechá-la.
Por quê: a reserva é o momento em que se registra a oferta, o sinal (se houver), os participantes (vendedor + comprador) e a cotação do dólar na abertura. Sem essa informação a operação fechada fica incompleta e se perde a rastreabilidade para os relatórios (diferença de negociação, comissões, captações, etc.).
Como funciona na interface:
- No modal "Fechamento de Operação" sobre uma propriedade disponível ou suspensa, os cards de estados terminais (Vendida / Permutada / etc.) aparecem desabilitados em cinza.
- Você só pode clicar em Reservada ou Suspensa a partir de uma propriedade disponível.
- Uma vez criada a reserva, você vai para Ver Operação (
/deals/[id]) e a partir dali encontra o botão "Fechar como X" (Vendida / Alugada / Permutada / Temporada).
Exceção possível (em avaliação): aluguel por temporada poderia permitir fechamento direto no futuro porque costuma fechar rápido sem negociação prévia. Por enquanto a regra se aplica universalmente. Essa decisão fica anotada no roadmap do produto.
Se você precisar registrar um fechamento sobre uma operação que já aconteceu "fora do sistema" (ex.: você cadastra uma venda histórica para os relatórios): crie a reserva com dados mínimos (oferta = preço de fechamento, sinal 0) e depois feche-a como Vendida. O processo é de 2 cliques.
7.9 Ponta vendedora vs compradora (pd_side)
Cada operação tem um campo ponta (pd_side) que indica o papel da sua imobiliária nessa transação:
| Valor | Significado | Quando se aplica |
|---|---|---|
seller_side | Ponta vendedora | A sua imobiliária representa o proprietário que vende/aluga. A propriedade está na sua conta Mapaprop. |
buyer_side | Ponta compradora | A sua imobiliária leva o comprador/inquilino. A propriedade pertence a outra imobiliária ou é externa. |
both | Ambas as pontas | Você representa ambas as partes na mesma operação (reservado para uso futuro, não atribuído automaticamente no MVP). |
Como é atribuída automaticamente ao criar:
- Modal aberto a partir da ficha de uma propriedade da sua conta (ou do seu corretor) → a operação nasce como
seller_side. - Modal aberto como operação manual sem propriedade (property externa) → a operação nasce como
buyer_side.
Não é preciso que o usuário escolha a ponta: o sistema a infere pelo contexto. Se no futuro você precisar registrar ambas as pontas, esse fluxo ficará disponível.
Onde você vê na interface: na página /deals/[id] há um chip que mostra "Ponta vendedora", "Ponta compradora" ou "Ambas as pontas" dependendo do valor do campo.
Comissão por ponta (implementado em 2026-07-30): quando uma operação tem dois brokers (um co-brokering) ou quando uma mesma imobiliária leva as duas pontas (par direto dupla-ponta), o sistema cria duas operações vinculadas — uma por ponta — e cada uma leva a sua própria comissão. A comissão é preenchida ao fechar cada ponta (Vendida/Alugada), nunca ao reservar, e cada ponta é fechada separadamente. Nos relatórios, o par conta como uma operação (o volume não é duplicado), mas as duas comissões somam. Veja §7.11.
7.10 Operação manual com propriedade externa
Quando usar: quando a propriedade em que você está trabalhando não está cadastrada na sua conta Mapaprop. Por exemplo:
- Você leva um comprador para ver uma propriedade de outra imobiliária.
- Você trabalha em cobrokerage informal com um colega e quer deixar registro da operação.
- Você registra uma venda histórica de uma propriedade que nunca foi publicada na sua plataforma.
Como criar uma operação manual:
| Perfil | Onde encontrar o botão |
|---|---|
| Admin / Main / Manager | /deals (listagem global) → botão "+ Adicionar operação" |
| Corretor (vendor) | /deals/my-deals → botão "+ Adicionar operação" |
O botão abre o mesmo modal de operação, mas em modo "manual" (sem propriedade da conta vinculada).
💡 Você também chega a partir de uma propriedade: se você está registrando uma operação sobre uma das suas propriedades e na etapa "Tipo de operação" percebe que na verdade a operação é sobre outra propriedade que não está no Mapaprop, escolha a opção "Operação externa". Ela leva você direto a Minhas Operações, onde você a registra com o botão "+ Adicionar operação". Existe para que essa opção esteja à vista e não seja preciso saber de antemão onde se cadastram as operações externas.
Como o modal fica no modo manual:
- Header: ícone roxo 🔗 + título "Operação Externa" + badge roxo "Ponta compradora".
- Banner explicativo roxo no topo: "Operação sobre uma propriedade que não está no Mapaprop. Você é ponta compradora..."
O que o modal pede — campos obrigatórios marcados com *:
- Tipo de operação (4 botões tipo card com ícone):
- 🏷️ Venda
- 🔑 Aluguel
- 📅 Aluguel por Temporada
- 🔄 Permuta
Os rótulos e a ordem vêm do sistema multi-país (mesmo seletor que você vê ao cadastrar uma propriedade). Se no futuro o Mapaprop operar em outros países, os rótulos são traduzidos automaticamente.
- Endereço da propriedade (input de texto livre, máx. 255 caracteres). Exemplo: "Av. Cabildo 1234, CABA". Serve para identificar a operação em listagens e relatórios — sem isso o deal fica como "Sem endereço registrado".
- Filial ⚠️ (obrigatória desde 2026-05-29 para Admin / Main / Manager): a que filial da sua imobiliária corresponde a operação. Se você não a escolher, o botão "Próximo" fica desabilitado. Para o corretor a sua filial é atribuída automaticamente e este campo não aparece.
- Estado (cards): só aparecem Reservada e os terminais (Vendida / Alugada / etc. dependendo do tipo escolhido). Os cards Disponível e Suspensa ficam ocultos: não se aplicam a propriedades externas.
- Oferta e valores: idem operação normal (oferta, sinal/reserva, fechamento, comissão). Lembre-se de que ao fechar (Vendida/Alugada) a comissão é obrigatória (veja §5.2).
- Participantes: seletor de contatos para Vendedor/Proprietário (a contraparte, costuma ser um broker ou o dono direto) e Comprador/Inquilino (o seu cliente). Ambos opcionais mas recomendados para a rastreabilidade. Em modo externo o "vendedor" é cadastrado como contato local sem se vincular formalmente a uma propriedade (não há property no sistema).
- Comentários: campo livre.
Navegação entre etapas do wizard (melhoria 2026-05-29)
Se você selecionar Vendedor e Comprador na etapa de Participantes e depois clicar em "Voltar" para revisar valores, os contatos selecionados continuam marcados ao voltar. Antes eles se perdiam e era preciso buscá-los de novo.
Isso se aplica tanto no modo manual (operação externa) quanto em operações sobre propriedades do seu catálogo.
Limitações dependendo do perfil:
| Aspecto | Admin / Main / Manager | Corretor |
|---|---|---|
| Pode criar operação manual | ✅ | ✅ |
| Estado inicial disponível | Qualquer um (Reservada / fechamento direto) | Somente Reservada |
| Fechamento da operação | ✅ | ❌ (quem faz é o admin/main) |
| branchId atribuído | O que ele escolher | Automaticamente a sua filial (não pode alterá-lo) |
Caso de uso típico para o corretor: "Acompanhei um comprador para ver um apartamento de outra imobiliária, ele ficou interessado, reservei de maneira informal. Quero deixar registro para não perder a operação." → crie uma operação manual Reservada a partir de "Minhas Operações". Quando a operação se concretizar, avise o seu admin para que ele a feche como Vendida ou Alugada.
Dica: se a contraparte é outra imobiliária ou um broker colega, você pode cadastrar esse contato com tipo "Broker" (veja a seção 8.5) e vinculá-lo ao campo Vendedor da operação. Assim você tem a rastreabilidade de com quem trabalhou o cobrokerage.
7.11 Origem da operação: Própria / Externa / Co-brokering / Dupla ponta / Excluída
Cada operação tem um campo "Origem" que a classifica. As origens Co-brokering e Dupla ponta marcam a ponta compradora de uma operação vinculada (veja §7.12). Permite filtrar e entender num relance que tipo de operação você está olhando.
| Origem | Quando é atribuída | Como aparece na interface |
|---|---|---|
| 🏠 Própria | Operação criada sobre uma propriedade da sua conta Mapaprop (caso normal). | Badge cinza "Própria" na coluna e no filtro. Sem banner especial em /deals/[id]. |
| 🔗 Externa | Operação manual sem propriedade associada (criada com o botão "+ Adicionar operação"). A propriedade não está na sua conta — é de outra imobiliária ou de um colega. | Badge roxo "Externa" na coluna e no filtro. Banner roxo em /deals/[id]: "Operação externa — sem propriedade associada. Ponta compradora...". |
| 🤝 Co-brokering | A ponta compradora de uma operação em que outro broker (do seu escritório ou da sua rede no Mapaprop) trouxe o comprador. A propriedade vive na ponta vendedora; esta ponta não leva propriedade própria. | Badge verde "Co-brokering" na coluna e no filtro. Em /deals/[id], card "Operação vinculada" apontando para a outra ponta. |
| 👥 Dupla ponta | A ponta compradora de um fechamento direto dupla-ponta: um mesmo escritório/corretor leva as duas pontas (vendedor + comprador). São criadas 2 operações vinculadas, uma por ponta. | Badge azul claro "Dupla ponta" na coluna e no filtro. Em /deals/[id], card "Operação vinculada" apontando para a outra ponta. |
| 🗑️ Excluída | Operação cuja propriedade original foi apagada do sistema. A operação é preservada como registro histórico (apagar a propriedade não apaga a operação — veja §7.4; diferente de excluir a operação, §7.2). | Badge vermelho "Excluída" na coluna e no filtro. Banner vermelho em /deals/[id]: "Propriedade excluída — os dados do deal se mantêm como registro histórico". Se houver snapshot, mostra os dados no momento da exclusão. |
Filtrar por origem: em /deals o dropdown "Origem" tem 4 opções: Todas / Própria / Externa / Excluída. Útil para:
- Ver apenas operações manuais do período (origem Externa) e medir o seu volume de cobrokerage informal.
- Auditar operações órfãs (origem Excluída) e decidir se limpá-las ou conservá-las.
- Filtrar apenas operações internas (origem Própria) para relatórios "limpos" sem manuais nem órfãs.
Exemplo concreto:
- Você levou um comprador a um apartamento da Remax em março. Cadastrou uma operação manual a partir de "Minhas Operações" → operação com origem Externa, ponta Compradora.
- Em abril você fechou uma venda da sua propriedade código MP007 com um comprador habitual → origem Própria, ponta Vendedora.
- Em maio você excluiu a propriedade MP007 do catálogo (decidiu não recolocá-la) → a operação de abril muda para origem Excluída automaticamente, mas conserva o código MP007 como dado histórico (snapshot).
💡 A origem é atribuída pelo sistema automaticamente. Não é algo que você cadastre manualmente.
7.12 Operações vinculadas: co-brokering e dupla ponta
Às vezes uma operação não é uma só: são duas operações vinculadas, uma por cada ponta (a vendedora e a compradora). Acontece em dois casos:
- Co-brokering — o comprador foi trazido por outro broker (do seu escritório ou da sua rede no Mapaprop). Cada escritório administra e fecha a sua ponta, com a sua comissão.
- Par direto dupla-ponta — você (um mesmo escritório/corretor) leva as duas pontas: representa o vendedor E o comprador. São criadas igualmente duas operações vinculadas, uma por ponta, cada uma com a sua comissão.
Em ambos os casos:
- São criadas 2 operações em
/deals, com badge "Co-brokering" (verde) ou "Dupla ponta" (azul), unidas entre si (card "Operação vinculada" no detalhe). - A comissão de cada ponta é preenchida ao fechar essa ponta (Vendida/Alugada), nunca ao reservar.
- Cada ponta é fechada separadamente (uma pode fechar e a outra cair). O sistema marca com um ícone de alerta (na listagem
/dealse no detalhe/deals/[id]) duas anomalias do par: - Estados diferentes: uma ponta fechou e a outra caiu.
- Preços de fechamento diferentes: as duas pontas fecharam (Vendida / Alugada) mas com preços de fechamento diferentes. Como é a mesma propriedade deveria haver um único preço de venda — a comissão sim difere por ponta, o preço de fechamento não. O alerta avisa você para que revise e corrija.
- Ao fechar ou cancelar (perda) uma ponta, o sistema oferece fazer o mesmo com a outra ("Fechar também a operação vinculada?" / "Cancelar também a operação vinculada?"). É um atalho de conveniência, não automático: você confirma, e cada ponta conserva o seu próprio fechamento com a sua própria comissão. Só aparece quando a outra ponta é do seu mesmo escritório e continua aberta.
- Nos relatórios, o par conta como uma operação (o volume não é duplicado), mas as duas comissões somam.
Como se cria: ao registrar uma reserva sobre a sua propriedade (com Business), o wizard tem uma etapa "Tipo de operação" onde você escolhe:
- Dupla ponta → você leva as duas pontas (vendedor + comprador). O sistema cria automaticamente as 2 operações vinculadas.
- Co-brokering → o comprador foi trazido por outro broker. Você escolhe a contraparte com um seletor em cascata: escritório → filial → corretor. Você pode escolher um colega do seu próprio escritório ou de qualquer outro escritório da sua rede no Mapaprop (redes com diretório e co-brokering), com a sua filial e o seu corretor. O sistema cria as 2 operações vinculadas.
- Uma única ponta → registra-se uma única operação (captação ou ponta única, sem vínculo).
A comissão de cada ponta é preenchida ao fechar essa ponta, nunca ao reservar. (Antes isso era escolhido com uma caixa "É um co-brokering" na etapa de estado; desde 2026-08 é uma etapa própria com as 3 opções.)
Co-brokering entre dois corretores, passo a passo — um corretor reserva sobre a propriedade de outro; o corretor da outra ponta recebe um email e entra direto na sua operação. Cada um vê e administra apenas a sua ponta:
E quando o colega é de OUTRO escritório da sua rede — o fluxo é o mesmo, mas a contraparte é escolhida por cascata (escritório → filial → corretor) e cada escritório vê a propriedade e a operação a partir do seu lado (a compradora a vê como ficha de rede):
E o outro lado: quando é você quem traz o comprador para uma propriedade de outro escritório da sua rede. Você entra a partir do catálogo de Propriedades de Rede, reserva como ponta compradora (a contraparte —o escritório dono— se resolve sozinha) e esse escritório recebe o email para gerenciar a sua ponta vendedora:
7.13 Fechar uma operação em conjunto com outra imobiliária (co-brokering): apenas dentro da sua rede (MLS)
Fechar uma operação em conjunto com outra imobiliária só é possível quando as duas imobiliárias pertencem à mesma rede imobiliária (MLS) no Mapaprop. Não é uma configuração que se ativa: é um requisito. Se as duas imobiliárias não compartilham uma rede, a opção de escolher esse outro escritório não está disponível no co-brokering.
- Com um colega do seu próprio escritório (a sua mesma conta) o co-brokering está sempre disponível.
- Com outra imobiliária (outro escritório) o co-brokering aparece unicamente se as duas são membros da mesma rede. O seletor de contraparte (escritório → filial → corretor) só lista os escritórios da sua rede.
⚠️ Sem uma rede compartilhada não há co-brokering entre imobiliárias diferentes. A rede é o requisito que o habilita; não é algo que se resolva a partir da configuração da operação.
A propriedade de rede fica vinculada ao seu contato comprador
Quando você co-brokereia uma propriedade de outro escritório da sua rede (você leva a ponta compradora, a propriedade vive no outro escritório), essa propriedade de rede fica associada ao seu contato comprador:
- Você vai vê-la na ficha do contato comprador, identificada como propriedade de rede, junto com as demais propriedades que esse contato tenha vinculadas.
- A partir da ficha dessa propriedade de rede você pode voltar à sua operação: o vínculo funciona nos dois sentidos (contato → propriedade de rede → sua operação).
Tudo isso vive dentro do contexto da rede compartilhada: sem a rede, nem o co-brokering entre imobiliárias diferentes nem esses vínculos existem. Mais detalhe sobre como se comportam as propriedades de rede em Propriedade de Rede / MLS.
8. Casos especiais
8.1 Corretor sem filial atribuída
Se um corretor do sistema não tem filial atribuída, ele pode acessar Operações mas verá toda a conta (não se aplica o filtro por filial). Recomendação: sempre atribuir uma filial ao cadastrar o corretor.
8.2 Você fez downgrade do plano Business para Free/Plus
- As suas operações existentes não são apagadas, continuam no sistema.
- Você perde o acesso aos relatórios de operações e ao modo Business.
- Você não pode criar operações novas (volta ao modo Básico, que só muda o estado da propriedade).
- Se você voltar para Business, recupera o acesso completo e todas as suas operações históricas.
8.3 Corretor de uma filial olha propriedade de outra
Isso é comum em redes com múltiplas filiais. O corretor:
- Pode ver sim o histórico de operações de qualquer propriedade da conta (leitura cross-branch).
- Não pode ver o detalhe de operações que não são da sua filial (em vez disso vê "🔒 Nome da outra filial").
- Não pode criar nem fechar operações sobre propriedades de outras filiais.
8.4 Migração de dados antigos sem tipo correto
Se você tem operações cadastradas antes de abril de 2026, o campo "tipo" pode estar como "Venda" mesmo que a propriedade seja de aluguel (era um bug). Há um script SQL que recalcula os tipos de operações antigas com base no tipo da propriedade. Se você precisar que seja aplicado na sua conta, entre em contato com o suporte.
8.5 Contatos broker (colegas imobiliários)
Quando você cria um contato novo a partir do CRM ou do modal de operação, há um seletor "Tipo de contato" com duas opções:
| Tipo | Etiqueta automática | Quando usá-lo |
|---|---|---|
| Pessoa (padrão) | Nenhuma ao criar. As etiquetas são atribuídas automaticamente ao vincular o contato a uma propriedade (Inquilino, Dono, Interessado, etc.). | Clientes finais: compradores, inquilinos, proprietários. |
| Broker / Colega | "Broker" (tag id 17, cor violeta) | Corretores ou imobiliárias com quem você co-trabalha informal ou formalmente. |
Casos de uso do tipo Broker:
- Uma imobiliária amiga que traz compradores para propriedades suas (cobrokerage).
- Um colega de outra conta Mapaprop com quem você compartilha operações de vez em quando.
- A contraparte vendedora em uma operação manual: a property é deles, você leva o comprador.
Como aparece no CRM: a tag "Broker" aparece automaticamente no filtro de etiquetas do CRM junto com as tags habituais (Inquilino, Dono, Interessado, etc.). Você pode filtrar todos os seus brokers rapidamente para ver com quem você tem relações ativas.
A tag Broker não substitui as demais. Se um broker também é comprador em alguma operação, ele pode ter ambas as etiquetas (a de Broker atribuída ao criar o contato, e a de Interessado atribuída ao vinculá-lo a uma propriedade).
9. Perguntas frequentes
Por que não consigo ver o botão "Fechamento Business"? O seu plano não inclui Operações. Você precisa do Business (serviço 56) ou do BusinessManager (serviço 57).
Por que um corretor não vê "Todas as operações" no menu? Por design. Os corretores veem apenas "Minhas Operações" (a sua versão filtrada pela sua filial e autoria). A listagem global é para admins.
Por que um indicador de diferença me dá 0% ou sem dados? Cada indicador é calculado apenas com as operações que têm os preços de que esse indicador precisa, na mesma moeda: "Publicação para oferta" precisa de publicação + oferta; "Oferta para fechamento" precisa de oferta + fechamento; "Desconto final" precisa de publicação + fechamento. Se nenhuma operação do período tem esses dados (ou estão em moedas diferentes), esse indicador fica sem base. Preencha sempre os 3 preços na mesma moeda para que as operações contribuam para os três. O botão "Somente dados completos" mostra a você unicamente essas operações completas.
Posso apagar uma operação cadastrada por engano? Sim: o administrador da conta pode excluí-la (deixa de contar nos relatórios e fica registrado quem, quando e por quê — é definitivo, veja §7.2). Se a operação foi real mas não se concretizou, é melhor marcá-la como Perdida para que fique nos relatórios como uma perda.
Marco uma propriedade como Vendida sem o modo Business. Perco alguma coisa? Sim. A mudança fica na propriedade (estado e preço de fechamento) mas não gera operação rastreável: não aparece nos relatórios, não contribui para a diferença, não há registro de comprador/vendedor. Para gestão real, use o modo Business.
Por que o tipo das minhas operações novas diz "Aluguel" quando crio a partir de uma propriedade de aluguel? É o comportamento esperado: o tipo é derivado do tipo da propriedade. Antes de abril de 2026 todas nasciam como "Venda" (bug), agora se infere corretamente.
Posso ver operações de propriedades que já apaguei? Sim. Na listagem global aparecem com um snapshot dos dados do imóvel e a nota "(excluída)".
Quando aparece o botão "Marcar como perdida" automático? Quando você tenta mudar o estado de uma propriedade reservada para Disponível ou Suspensa sem fechar a operação. O sistema detecta isso e oferece a você resolver com um clique.
Para que serve o tipo de contato "Broker"? Para distinguir os seus colegas imobiliários dos seus clientes finais no CRM. Um broker é alguém com quem você co-trabalha, não um comprador ou proprietário. Ao marcá-lo como Broker ao criar o contato, é atribuída automaticamente a etiqueta "Broker" e ele aparece no filtro de etiquetas do CRM.
Posso criar uma operação se a propriedade não está na minha conta? Sim. É a operação manual (veja a seção 7.10). Você a usa quando trabalha como ponta compradora sobre uma propriedade de outra imobiliária ou que não está publicada no Mapaprop.
Por que aparece um alerta em um par de operações vinculadas? Em um co-brokering ou dupla ponta, as duas operações deveriam fechar ao mesmo preço (é a mesma propriedade; o que difere por ponta é a comissão, não o preço de fechamento). Se as duas pontas fecharam com preços de fechamento diferentes, ou ficaram em estados diferentes (uma fechada e a outra caída), o sistema marca a operação com um ícone de alerta na listagem e no detalhe para que você a revise.
Em um co-brokering, posso escolher um corretor de outro escritório da minha rede? Sim. Ao montar um co-brokering, o seletor de contraparte desce em cascata escritório → filial → corretor e deixa você escolher tanto um colega do seu próprio escritório quanto de qualquer outro escritório da sua rede no Mapaprop (redes com diretório e co-brokering). Só são exibidos dados públicos do outro escritório (nome, filial, corretor), nunca a sua informação privada.
Posso fechar uma operação em conjunto com outra imobiliária? Sim, mas apenas se as duas imobiliárias pertencem à mesma rede (MLS) no Mapaprop. Não é uma configuração: é um requisito. Se elas não compartilham uma rede, a opção de escolher esse outro escritório no co-brokering não está disponível. Quando você co-brokereia uma propriedade de rede, essa propriedade fica vinculada ao seu contato comprador (você a vê na ficha do contato, identificada como propriedade de rede) e você pode voltar à sua operação a partir da ficha da propriedade de rede. Veja §7.13.
O que acontece com uma propriedade de rede quando eu a reservo, vendo ou alugo? Quando você coloca em um estado não disponível (Reservada, Vendida, Alugada ou Suspensa) uma propriedade que você compartilha em uma rede MLS, essa propriedade sai automaticamente das buscas da rede: os demais membros deixam de encontrá-la ao buscar. Não é apagada nem excluída. Quem já tem uma operação aberta sobre ela —por exemplo a outra ponta de um co-brokering— continua vendo-a pela sua ficha, com o link que já tinha. E se a operação cai e a propriedade volta a estar Disponível, reaparece sozinha nas buscas da rede, sem que você tenha que voltar a compartilhá-la. Mais detalhe em Propriedade de Rede / MLS.
PARTE 2 — Referência Operacional (suporte / admins de conta)
Esta parte é pensada para suporte do Mapaprop, comercial e admins de conta que precisam responder consultas de clientes com precisão: quem pode fazer o quê, o que cada plano requer, e como as telas se comportam dependendo do perfil.
10. Perfis do sistema
O Mapaprop tem 4 perfis de acesso, com alcance diferente sobre a conta.
| Nome humano | O que faz | Plano habilitante |
|---|---|---|
| Admin Principal | Dono ou admin da conta. Acesso total à conta, todos os relatórios, todos os deals. | Qualquer plano (o módulo de Operações requer Business) |
| Gestor de Rede | Gestor de uma rede de franquias. Vê toda a rede em read-only e administra os seus próprios deals. | BusinessManager (serviço 57) |
| Corretor / Vendedor | Corretor comercial. Cria reservas na sua filial e vê apenas as suas operações. | Qualquer plano (a conta o cadastra) |
| Admin Mapaprop | Equipe interna do Mapaprop para suporte e debug. | N/A |
Nesta doc, "admin" sem prefixo significa Admin Principal ou Gestor de Rede (ambos os perfis têm permissões de gestão sobre a conta). "Admin Mapaprop" é citado explicitamente quando se aplica.
11. Matriz de permissões por ação
| Ação | Admin Principal | Gestor de Rede | Corretor | Admin Mapaprop |
|---|---|---|---|---|
Ver hub /stats/deals | ✅ | ✅ | ✅ (só 2 cards visíveis) | ✅ |
| Relatório "Todas as operações" | ✅ | ✅ | ❌ (redireciona para Minhas Operações) | ✅ |
| Relatório "Minhas Operações" | ✅ | ✅ | ✅ (auto-filtrado ao que é seu) | ✅ |
| Relatório "Imobiliária" | ✅ | ✅ | ❌ | ✅ |
| Relatório "Rede" | ❌ | ✅ | ❌ | ✅ |
| Relatório "Captações" | ✅ | ✅ | ✅ | ✅ |
| Relatório "Diferença" | ✅ | ✅ | ❌ | ✅ |
| Criar operação sobre propriedade própria | ✅ | ✅ | ✅ (só estado Reservada) | — |
| Criar operação manual (propriedade externa) | ✅ | ✅ | ✅ (só Reservada, na sua filial) | — |
| Fechar operação (Vendida / Alugada / etc.) | ✅ | ✅ | ❌ | — |
| Cancelar reserva (Perdida) | ✅ | ✅ | ❌ | — |
| Editar campos de uma operação | ✅ (qualquer op) | ✅ (qualquer op) | ✅ (só se ele a abriu) | — |
| Ver lista de operações de uma propriedade | ✅ | ✅ | ✅ (cross-filial, só leitura) | — |
| Ver detalhe completo de uma operação | ✅ | ✅ | ✅ (só da sua filial) | — |
| Excluir operação (definitivo, auditado) | ✅ | ❌ | ❌ | ✅ |
| Ver operações excluídas ("Ver excluídas") | ✅ | ❌ | ❌ | ✅ |
Regras-chave:
- O corretor apenas abre reservas. Não fecha nem cancela — essas decisões são tomadas pelo admin da conta.
- Somente o administrador da conta pode excluir uma operação (definitivo e auditado — veja §7.2). Um erro de cadastro é excluído; uma operação real que não se concretizou é marcada como Perdida.
- O corretor pode ler o histórico de qualquer filial mas não pode modificar deals fora da sua.
12. Permissões por tela
Hub /stats/deals
Os cards do hub são gateados por perfil:
| Card | Admin Principal | Gestor de Rede | Corretor | Admin Mapaprop |
|---|---|---|---|---|
| Todas as operações | ✅ | ✅ | ❌ (oculto) | ✅ |
| Minhas Operações | ✅ | ✅ | ✅ | ✅ |
| Imobiliária | ✅ | ✅ | ❌ (oculto) | ✅ |
| Rede | ❌ | ✅ | ❌ | ✅ |
| Captações | ✅ | ✅ | ✅ | ✅ |
| Diferença | ✅ | ✅ | ❌ (oculto) | ✅ |
Os cards aparecem visualmente para todos os planos (incluído o Free), mas ao clicar sem Business dispara-se o modal de upgrade.
/deals (Todas as operações)
| Elemento | Comportamento |
|---|---|
| Acesso à tela | Corretor: redireciona automaticamente para "Minhas Operações" |
| Botão "+ Adicionar operação" | Somente admin (Principal / Gestor de Rede / Admin Mapaprop) |
| Filtros (filial, corretor, estado, tipo, datas, ponta, origem) | Somente admin |
| Mini-cards de KPIs no topo | Visível para todos os que entram |
| Chips de filtros ativos + "Limpar" | Visível para todos os que entram |
| Cards mobile / Tabela desktop | Mesmo dado, layout responsivo |
| Botão "Exportar CSV" | Somente admin |
| Botão "Ver" em cada linha | Somente admin |
/deals/my-deals (Minhas Operações)
| Elemento | Comportamento |
|---|---|
| Botão "+ Adicionar operação" | Visível para todos os perfis (admin e corretor) — abre o modal em modo manual (sem propriedade) |
| Faixa superior de identificação | Filial do corretor (logo ou ícone + nome + endereço + contato) |
| Listagem "Reservas abertas" | Corretor: apenas as suas. Admin: toda a conta |
| Listagem "Últimos fechamentos" | Igual ao anterior |
Para o corretor, ao usar "+ Adicionar operação", o branchId é atribuído automaticamente à sua filial e o estado inicial só pode ser Reservada.
/deals/[id] (Detalhe de uma operação)
| Elemento | Admin | Corretor (mesma branch) | Corretor (outra branch) |
|---|---|---|---|
| Ver detalhe | ✅ | ✅ | ❌ (404) |
| Botões "Fechar como X" | ✅ (se houver reserva) | ❌ | ❌ |
| Botão "Editar" (reserva em andamento) | ✅ (se estiver Reservada) | ❌ (desabilitado) | ❌ |
| Botão "Cancelar reserva" (Perdida) | ✅ | ❌ | ❌ |
| Clicar no nome de contato abre painel lateral | ✅ | ✅ | ❌ |
| Chip de Ponta (vendedora / compradora / ambas) | ✅ | ✅ | ❌ |
Painel "Operações" na ficha da propriedade
| Elemento | Admin | Corretor (mesma branch) | Corretor (outra branch) |
|---|---|---|---|
| Ver listagem completa | ✅ | ✅ (cross-filial) | ✅ (cross-filial) |
| Botão "Ver detalhe" em cada linha | ✅ | ✅ só deals da sua filial | ❌ → mostra 🔒 [Nome da Filial] |
| Botão "Nova operação" | ✅ | ✅ se a propriedade é da sua filial | ❌ (oculto) |
| Link "Ver todas as operações" | ✅ | ❌ (redireciona para Minhas Operações) | ❌ (redireciona para Minhas Operações) |
O corretor lê o histórico de qualquer propriedade da conta, mas só modifica deals da sua filial.
Modal "Fechamento de Operação"
Quais entry points o abrem e quem os vê?
| Entry point | Visível para |
|---|---|
| Botão "Fechamento de Operação" na ficha da propriedade | Admin. Corretor: só se a propriedade é da sua filial. |
| Botão "Nova operação" no painel "Operações" | Igual ao anterior |
Botão "+ Adicionar operação" em /deals | Somente admin |
Botão "+ Adicionar operação" em /deals/my-deals | Todos os perfis (modo manual / propriedade externa) |
| Botões "Fechar como X" no detalhe do deal | Somente admin |
O que o modal mostra dependendo de plano e perfil?
| Elemento | Free / Plus / Pro+ | Admin com Business | Corretor com Business |
|---|---|---|---|
| Modo Básico (só muda o estado da propriedade) | ✅ (seletor de modo) | (pula seletor) | (pula seletor) |
| Modo Business (registra deal completo) | ❌ → janela de upgrade | ✅ | ✅ |
| Botão "Gerenciar Operação" (vermelho) | n/a | ✅ se houver reserva | ✅ se houver reserva na sua filial |
| Botão "Ver Operação" (verde) | n/a | ✅ se houver deal fechado | ✅ se houver deal fechado na sua filial |
| Cancelar reserva (Perdida) | n/a | ✅ | ❌ (só o admin cancela) |
| Cards "Disponível" e "Suspensa" em modo manual | n/a | Ocultos | Ocultos |
| Seletor de filial em modo manual | n/a | ✅ | ❌ (automático à sua filial) |
Detalhes do comportamento do modal:
- Tags no header: o modal mostra o tipo de operação (Venda/Aluguel/etc.) e o tipo de propriedade (Apartamento/Casa/etc.) como chips, derivados da propriedade.
- "Oferta de reserva" + "Valor de reserva": ao fechar uma reserva existente, a seção Valores mostra estes 2 campos (com fundo âmbar) como referência.
- "Origem do Comprador": aparece dentro de Valores ao fechar uma operação. É opcional.
- "Fechar como X" abre direto em Valores: ao entrar a partir de um botão de fechamento, a seção Estado fica recolhida (a decisão já foi tomada) e se abre diretamente Valores para confirmar o preço de fechamento.
Sub-relatórios do hub
| Tela | Admin Principal | Gestor de Rede | Admin Mapaprop | Corretor |
|---|---|---|---|---|
| Minhas Operações | ✅ | ✅ | ✅ | ✅ (auto-filtrado) |
| Imobiliária | ✅ | ✅ | ✅ | ❌ |
| Rede | ❌ | ✅ | ✅ | ❌ |
| Captações | ✅ | ✅ | ✅ | ✅ |
| Diferença | ✅ | ✅ | ✅ | ❌ |
my-deals e branch têm uma faixa de identificação no topo:
my-deals: filial do corretor (logo ou ícone + nome + endereço + contato).branch: escritório / customer (logo + nome + dados).
13. Plano necessário
13.1 Sistema completo de Operações
Requer plano Business (serviço 56) ou BusinessManager (serviço 57).
Para Free / Plus / Pro+:
- O menu "Relatórios de Operações" aparece, mas ao clicar dispara-se o modal de upgrade.
- O botão "Fechamento Business" no modal de operação é bloqueado com o modal de upgrade.
- O backend rejeita endpoints do módulo de deals.
13.2 Modo Básico do modal
Não requer plano — disponível para todos. É a única função do módulo de operações que é free. Só muda o estado da propriedade (Reservada / Vendida / Alugada / Suspensa) e opcionalmente registra o preço de fechamento. Não gera deal rastreável, não contribui para relatórios.
13.3 Por que a decisão
O sistema de Operações existe principalmente para gestão comercial profissional: medir performance, ranking, diferença. Isso justifica o plano Business. Customers pequenos que só precisam marcar uma propriedade como vendida têm o modo Básico.