Operaciones en Mapaprop — Guía Completa

PARTE 1 — Manual del Usuario

1. ¿Qué son las Operaciones?

Una operación es el registro de una transacción comercial sobre una propiedad: una reserva, una venta, un alquiler, una permuta, o una caída. Es el "qué pasó, cuándo, con quién y a qué precio" de cada movimiento del inmueble.

Ejemplo concreto

Tu asesor María toma una reserva de un departamento por USD 130.000 con seña de USD 5.000. Una semana después, el comprador firma boleto y se cierra la venta por USD 128.000 (negoció USD 2.000 menos). Mapaprop guarda una sola operación que pasó por dos estados: primero Reservada, después Vendida. Esa operación queda registrada con: precio de publicación (USD 139.000), oferta del comprador (USD 130.000), seña (USD 5.000), precio de cierre (USD 128.000), comprador, propietario, asesor responsable, sucursal, fechas. Todo eso alimenta tus reportes de gestión y tu historial comercial.

2. ¿Para qué te sirve?

El modo Básico solo cambia el estado de la propiedad: reservada, vendida, alquilada. Las Operaciones expanden ese gesto: la misma acción pasa a dejar el registro completo de la transacción —con quién, a qué precio, con qué comisión y en qué fecha—. Con eso podés:

3. Cómo se compone una operación

Cada operación tiene 4 piezas de información:

3.1 Estado

Indica en qué momento del ciclo está la operación. Solo puede ser uno de estos:

⚠️ Una operación cerrada (Vendida / Alquilada / etc) NO se puede revertir. Si después la operación se cae, hay que crear una operación nueva con estado Caída. La cerrada queda como historial.

3.2 Tipo

Indica de qué tipo de transacción es. Se deriva automáticamente del tipo de operación que tenga la propiedad cargada (Venta, Alquiler, Temporario, Permuta).

3.3 Datos económicos

3.4 Participantes

• Vendedor / Propietario: quien estaba dueño del inmueble (de tu lista de contactos).
• Comprador / Inquilino: quien hizo la operación (de tu lista de contactos).
• Asesor responsable: el usuario de Mapaprop que abrió la operación.
• Sucursal: la sucursal a la que pertenece la operación (se hereda de la propiedad).

4. Dos modos para registrar una operación: Básico y Business

Cuando cerrás una operación desde la ficha de una propiedad, se abre la ventana "Cierre de Operación". Ahí podés elegir entre 2 formas de registrarla:

4.1 Modo Básico

• ¿Qué hace? Solo cambia el estado de la propiedad (Reservada / Vendida / Alquilada / Suspendida) y opcionalmente registra un precio de cierre.
• ¿Qué NO hace? No guarda contactos, ni comisión, ni historial detallado. No genera operación trackeable en los reportes.
• ¿Quién lo usa? Inmobiliarias chicas que solo necesitan marcar el estado de sus propiedades sin preocuparse por reportes de gestión.
• Plan requerido: cualquiera (Free, Plus, Pro+, Business).

4.2 Modo Business (recomendado)

• ¿Qué hace? Crea una operación completa con todos los datos: contactos, oferta, seña, cierre, comisión, comentarios. Después aparece en todos los reportes.
• Plan requerido: Business o Business Manager (planes 56 y 57).

4.3 Tabla comparativa

💡 Recomendación: si tenés el plan Business, usá siempre el modo Business. Es la única forma de aprovechar los reportes de gestión.

4.4 Decisión por plan

5. Cómo registrar una operación paso a paso

5.1 Crear una reserva

1. Entrá a la ficha de la propiedad → botón "Cierre de Operación".
2. La ventana abre. Elegí "Reservada" entre las opciones de estado.
3. Si tenés Business, vas al wizard por pasos:

• Estado: ya elegiste Reservada.
• Tipo de operación (aparece solo al reservar sobre tus propias propiedades): elegís cómo se compone la operación — Una sola punta (representás una parte), Doble punta (llevás vendedor Y comprador) o Co-brokering (el comprador lo trajo otro broker de tu oficina o de tu red en Mapaprop). En Doble punta y Co-brokering el sistema crea 2 operaciones vinculadas (ver §7.12). Hay además una opción "Operación externa" que te lleva a Operaciones para registrar una operación sobre una propiedad que no está en Mapaprop (ver §7.10).
• Montos: ingresá la oferta del comprador. Si hubo seña, marcá el checkbox y poné el monto.
• Participantes: vinculá vendedor y comprador desde tus contactos. Podés elegir uno ya vinculado a la propiedad, buscarlo o crearlo en el momento. Cualquier contacto que vincules acá también queda vinculado a la propiedad — lo vas a ver después en la ficha, en la solapa Contactos (el vendedor como Dueño, el comprador como Interesado).
• Comentarios: opcional, para dejar contexto interno.

4. Click Guardar Operación.

La propiedad queda marcada como Reservada y aparece un chip rojo "Operación en proceso" en su ficha.

5.2 Cerrar la operación (Vendida / Alquilada / etc)

Hay 2 formas de llegar al cierre:

Opción A — Desde la ficha de la propiedad:

1. Click en "Gestionar Operación" (botón rojo). Te lleva al detalle de la operación reservada.
2. Ahí elegís el estado destino: Cerrar como Vendida / Cerrar como Alquilada / etc.
3. La ventana te pide el Precio de cierre y la Comisión — ambos campos son obligatorios al cerrar (las otras secciones quedan colapsadas porque ya tenías los datos cargados).
4. Click Actualizar Operación.

Opción B — Desde la ficha de la propiedad directo:

1. Click en "Cierre de Operación".
2. Elegís el estado terminal directamente (ej: Vendida).
3. La ventana abre con los datos de la reserva pre-cargados. Completás cierre y comisión.
4. Guardar.

Después del cierre:

• La operación queda con estado terminal y fecha de cierre.
• La propiedad queda marcada como Vendida (o Alquilada si fue rent / temp / exchange).
• Se registra en el historial de precios de la propiedad.
• Aparece en el reporte de "Mis Operaciones" del asesor que cerró.

5.3 Cancelar una reserva (Caída)

Cuando una reserva no se concreta:

1. Desde la ficha de la propiedad → "Gestionar Operación" → estado Caída.
2. O desde el detalle de la operación → botón rojo "Cancelar reserva".
3. Guardar.

La operación pasa a Caída (no se puede revertir), la propiedad vuelve a Disponible automáticamente, y queda registrada como caída en los reportes (aporta a la "tasa de caída" del asesor).

5.4 Editar mientras la operación está en curso

Mientras la operación esté Reservada podés corregir sus datos sin cambiar el estado. Hay dos caminos:

• Desde el detalle de la operación (/deals/[id]) → botón "Editar": abre una ventana para ajustar oferta y moneda, seña, contactos (vendedor / comprador) y comentarios. La comisión no se toca acá — se carga recién al cerrar. Este botón es para administradores de la cuenta.
• Desde la ficha de la propiedad → "Gestionar Operación": la ventana abre con secciones colapsables (Estado / Montos / Participantes / Comentarios) para editar lo que necesites.

5.5 Volver una propiedad a "Disponible"

Si una propiedad está reservada y el cliente cambió de opinión sin formalizar caída, NO podés mandarla directo a Disponible mientras tenga una operación en curso. Mapaprop te bloquea con un mensaje:

"Hay una operación reservada en curso. Para cambiar el estado de la propiedad tenés que resolverla desde Gestionar Operación o marcarla Caída."

Dos caminos:

• Click en "Marcar como caída" desde el mensaje de bloqueo → cancela la reserva y libera la propiedad de un solo click.
• Click en "Gestionar Operación" → resolver manualmente (cierre concretado o caída).

Esto evita que queden operaciones huérfanas (reservadas en el sistema pero la propiedad ya fue puesta a la venta de nuevo).

5.6 Cambiar el estado de una propiedad ya vendida/alquilada

Si la propiedad está vendida (operación cerrada) y querés volver a ponerla a la venta, podés:

1. Marcarla como Disponible desde la ficha (esto NO afecta la operación cerrada — sigue ahí como historial).
2. Crear una nueva operación cuando llegue otra reserva. El histórico te quedará con: deal viejo (vendido) + deal nuevo (reservado/cerrado/caído).

6. Las pantallas de operaciones y sus tres ámbitos

En el menú lateral, Operaciones abre el módulo completo:

Los tres ámbitos

Las pantallas del módulo —el listado, las estadísticas, la brecha y las captaciones— responden la misma pregunta sobre tres universos distintos. El ámbito se elige con los selectores de arriba a la derecha:

6.1 Operaciones (/deals)

Es la pantalla de trabajo de todos los roles. Un administrador ve las operaciones de toda la cuenta; un asesor entra a la misma pantalla y ve las suyas. El asesor llega por Mis Operaciones y aterriza en esta misma pantalla, ya acotada a lo suyo.

• Filtros de fecha, en una sola línea: cuatro atajos (últimos 14 días, 30 días, 90 días, este año) más Desde / Hasta. Se aplican al toque, sin botón "Filtrar".
• Botón "Más filtros": abre el resto en una ventana — tipo de operación, estado, parte (vendedora/compradora — ver §7.9), origen (propia/externa/eliminada — ver §7.11), y para administradores también sucursal y asesor. El número al lado del botón te dice cuántos tenés puestos, así sabés que la lista viene acotada aunque la ventana esté cerrada.
• El filtro de Asesor aparece cuando elegís una sucursal, y lista solo los asesores de esa sucursal.
• Mini-cards arriba con 12 KPIs en vivo (ver §6.5) que respetan los filtros aplicados.
• Tabla con columnas: Id (número de la operación, ej. #1234, con link directo al detalle), Propiedad, Agente / Sucursal (el asesor responsable y su sucursal), Contacto, Tipo, Parte (badge verde Vendedora / morado Compradora / gris Ambas), Origen (badge gris 🏠 Propia / morado 🔗 Externa / rojo 🗑️ Eliminada), Estado, Oferta, Cierre, Comisión, Fecha. Una fila puede mostrar además un ícono de alerta cuando la operación es parte de un par vinculado con una anomalía (ver §7.12).
• Ordená por columna: Id, Oferta, Cierre, Comisión y Fecha se ordenan haciendo click en el encabezado (un segundo click invierte, un tercero vuelve al orden original). Los importes se agrupan por moneda y se ordenan por monto dentro de cada una: no se convierte nada, porque una comisión de ARS 89.000 y una de USD 600.000 no se comparan por el número suelto.
• Tres cards de brecha debajo de los KPIs, y son clickeables: te llevan al reporte completo (§6.4) con el mismo ámbito y el mismo período.
• Chips de filtros activos con X para quitar individualmente.
• Botón "+ Agregar operación": crea una operación manual sin propiedad asociada (ver §7.10). Lo ven todos los roles.
• Botón "Ver eliminadas" (con contador): solo el administrador de la cuenta.
• Exportar a CSV para análisis externo (respeta los filtros).
• Paginación de 20 filas cuando hay más de 20.
• Mobile: cards en lugar de tabla (sin paginar: se listan todas).
• Quién lo ve: todos los roles. Lo que cambia es el alcance, no la pantalla — ver el aviso de abajo.

6.2 Estadísticas de Operaciones (/stats/deals)

El reporte analítico del módulo: la misma información del listado, pero agregada y graficada para leer tendencias en vez de operaciones sueltas.

• Evolución diaria: cuántas operaciones se abrieron, cerraron y cayeron cada día.
• Cierres por mes: cuántas cerraron en cada mes. Se agrupa por el mes del cierre, mientras que el período de arriba filtra por la fecha de apertura — por eso puede aparecer un mes posterior al rango elegido.
• Mix por tipo de operación y detalle por tipo, con volumen y comisión por moneda. Nada se convierte a una sola moneda: sumar pesos con dólares daría un número sin significado.
• Ranking de agentes: ordenado por cierres, con volumen, comisión y tasa de cierre. No se le muestra al asesor, porque un ranking de un renglón con uno mismo no informa nada.
• Cierres del período: los más recientes, con click para ver el detalle de la operación en un modal, sin perder los filtros.
• Los mismos KPIs que ves en "Operaciones", calculados por el mismo lugar: no hay dos números para lo mismo.
• Arranca en los últimos 90 días, igual que el listado, la brecha y las captaciones.
• Los mismos tres ámbitos que el resto del módulo (ver arriba): tu cuenta, o el agregado de una red con bajada a una oficina.
• Selector de sucursal para admins. Un asesor no lo ve: el sistema le acota el reporte a lo suyo desde el servidor.
• Quién lo ve: requiere plan Business o superior. Los asesores lo ven acotado a sus propias operaciones.

6.3 Captaciones (/deals/captations)

Reporte de propiedades aprobadas por moderación y pendientes en el período.

• Captaciones aprobadas: cuántas propiedades nuevas pasaron el control de moderación.
• Pendientes: cuántas están esperando aprobación.
• Efectividad: % de captaciones que terminaron en cierre (cálculo aproximado).
• Cierres del período: para contraste.
• Gráfico de línea con dos series a lo largo del período: solicitadas y aprobadas. Los KPIs dicen cuánto; la línea dice cuándo, y la distancia entre las dos curvas es lo que tarda la moderación.
• Arranca en los últimos 90 días.
• Los tres ámbitos (ver arriba). En ámbito de red aparece además una columna Oficina: sin ella, las captaciones de varias inmobiliarias se leerían como si fueran de una sola.
• Tabla: detalle por propiedad. Al hacer click en una propiedad se abre su ficha lateral, sin sacarte del reporte; desde la ficha podés ir a la propiedad completa.
• Quién lo ve: todos los roles, cada uno con su ámbito. Requiere plan Business o superior.

ℹ️ Nota sobre efectividad: el cálculo es aproximado — divide cierres del período sobre captaciones del período sin verificar si los cierres corresponden realmente a las propiedades captadas. Es una guía, no un funnel exacto.

6.4 Brecha de Negociación (/deals/brecha)

Cuánto se movió el precio entre lo que publicaste, lo que te ofrecieron y lo que finalmente cerraste. Son cuatro números, y el reporte te deja ver de dónde sale cada uno, operación por operación.

• Quién lo ve: todos los roles, cada uno con su ámbito — el asesor entra y ve su propia brecha. Requiere plan Business o superior.
• Cómo se llega: por el menú Operaciones → Brecha de Negociación, o con click en cualquiera de las tres cards de brecha de Operaciones y de Estadísticas, que llegan con el ámbito y el período ya puestos.
• Arranca en los últimos 90 días. La brecha es un promedio: con los cierres de un solo mes la muestra suele ser de dos o tres operaciones, y ahí el número no dice nada.
• Los tres ámbitos (ver arriba). En ámbito de red, el click en una operación abre su detalle en una ventana en vez de navegar: la operación es de otra cuenta y su dirección directa no te correspondería.

Los cuatro indicadores

En cada card, la flecha marca la dirección y el texto de abajo la dice en palabras.

Cómo se calculan — tres cosas que explican los números que ves

El botón "Solo datos completos" resuelve justamente eso: recalcula los tres indicadores usando únicamente las operaciones que tienen publicación, oferta y cierre en la misma moneda. Así los tres salen del mismo grupo y sí son comparables entre sí.

El detalle, operación por operación

Debajo de las cards hay una tabla con cada operación cerrada del período y sus tres precios. Te dice:

• A qué indicador alimenta cada operación, con las etiquetas Pub→Oferta, Oferta→Cierre y Total — o "No aporta", con el motivo cuando las monedas no coinciden.
• La punta (vendedora / compradora) y, en ámbito de red, la oficina dueña de la operación.

Hacé click en cualquier fila y se abre la explicación de esa negociación: sus tres brechas, la escalera de precios desde la publicación hasta el cierre, y cómo se compara con el promedio del período ("cediste tanto más que el promedio"). El #número de la operación sigue siendo un link a su detalle completo.

Si el período trae más de 200 cierres, la tabla muestra los primeros 200 y te lo avisa. Los cuatro indicadores de arriba, en cambio, siempre se calculan sobre todas las operaciones del período.

6.5 Mini-cards de KPIs (en todos los reportes)

Arriba del listado de Operaciones (/deals), en cualquiera de sus tres ámbitos, hay una grilla de 12 mini-cards con métricas en vivo. Todas respetan los filtros aplicados (período, sucursal, etc.). Cada card tiene tooltip al hacer hover con la fórmula exacta del cálculo.

Fila 1 — Volumen y conteos:

Fila 2 — Performance + mix (solo aparece si hay deals cerrados):

💡 Si el período no tiene cierres, solo se muestra la fila 1.

Debajo de las mini-cards hay tres cards grandes con las brechas de negociación del período: publicación→oferta, oferta→cierre y publicación→cierre. Son clickeables y te llevan al reporte completo (§6.4) con el mismo ámbito y el mismo período.

7. Reglas importantes

7.1 Una sola reserva por propiedad

Cada propiedad puede tener una sola operación en estado Reservada al mismo tiempo. Si intentás crear una segunda reserva, el sistema usa la existente.

7.2 Eliminar una operación (y por qué la trazabilidad se mantiene)

El administrador de la cuenta puede eliminar una operación en cualquier estado (reservada o cerrada). Es una acción definitiva: no se puede deshacer.

Cómo funciona, y por qué no perdés trazabilidad:

• La operación deja de contar en todos tus reportes y listados (KPIs, brecha, rankings, etc.) — como si no existiera para la gestión.
• Pero nada se borra físicamente: la operación se conserva y queda registrado quién la eliminó, cuándo y con qué motivo (el motivo es obligatorio). Esa información queda en el Historial de cambios de la operación, para auditoría.
• Para verlas, en "Todas las operaciones" hay un botón "Ver eliminadas" (solo para el administrador de la cuenta) que muestra cuántas hay y las lista con su motivo y fecha. Desde ahí abrís cada una y ves el detalle marcado como eliminada.
• Si la operación era parte de un par vinculado (co-brokering o doble punta), al eliminar una punta el sistema te ofrece eliminar también la otra (cuando es de tu misma oficina). Si dejás el par a medias, la operación que queda muestra una alerta de discordancia.
• Si la operación estaba Reservada, al eliminarla la propiedad vuelve a Disponible (se libera y, si estaba compartida en una red, vuelve a aparecer en las búsquedas de la red) — igual que con una Caída. Eliminar una operación ya cerrada (Vendida/Alquilada) no cambia el estado de la propiedad.

Cuándo usarla: una operación cargada por error, un duplicado o una prueba. Si en cambio la operación fue real pero no se concretó, lo correcto es marcarla Caída (así queda en los reportes como una caída, que es información de gestión válida).

No la confundas con una propiedad eliminada (§7.4): si borrás la propiedad, sus operaciones se conservan y siguen contando en los reportes (marcadas como "(eliminada)"). Eliminar la operación es otra cosa: la saca de los reportes. Son dos acciones distintas.

7.3 Estados terminales no se reabren

Una vez que una operación pasa a Vendida / Alquilada / Caída / etc, ese estado queda fijo. Si necesitás registrar una nueva negociación sobre la misma propiedad, creás una operación nueva.

7.4 Las propiedades eliminadas conservan sus operaciones

Si eliminás una propiedad del sistema, las operaciones asociadas no se borran. Quedan accesibles desde el listado global con un snapshot de los datos básicos del inmueble (dirección, código, zona) pero marcadas como "(eliminada)".

7.5 Brecha de negociación: completá siempre el precio de cierre

Para que la brecha funcione bien, asegurate de siempre completar el campo "Precio de cierre" al cerrar una operación (es obligatorio en el modo Business). El precio de oferta es opcional pero recomendado.

7.6 Operación en proceso bloquea cambios de estado de la propiedad

Si una propiedad tiene una reserva activa, no podés cambiar su estado a Disponible o Suspendida sin antes resolver la reserva (cerrarla como Vendida/Alquilada/etc o marcarla Caída). El sistema te avisa con un mensaje y te ofrece marcarla como caída en un solo click.

7.7 Tipo de operación se deriva del tipo de la propiedad

Cuando creás una nueva operación sobre una propiedad de alquiler, la operación nace con tipo "Alquiler" automáticamente. No tenés que elegirlo. Si la propiedad es de venta, nace como "Venta". Esto evita inconsistencias entre tipo de propiedad y tipo de operación.

7.8 Todo cierre nace desde una reserva

Regla: no podés cerrar una operación como Vendida / Alquilada / Permutada / Alquiler temporario directamente sobre una propiedad que está Disponible o Suspendida. Primero tenés que crear una Reserva, y desde ahí cerrarla.

Por qué: la reserva es el momento donde se registra la oferta, la seña (si hay), los participantes (vendedor + comprador) y la cotización del dólar al abrir. Sin esa info la operación cerrada queda incompleta y se pierde trazabilidad para reportes (brecha de negociación, comisiones, captaciones, etc).

Cómo funciona en la UI:

• En el modal "Cierre de Operación" sobre una propiedad disponible o suspendida, los cards de estados terminales (Vendida / Permutada / etc) aparecen deshabilitados en gris.
• Solo podés clickear Reservada o Suspendida desde una propiedad disponible.
• Una vez creada la reserva, vas a Ver Operación (/deals/[id]) y desde ahí encontrás el botón "Cerrar como X" (Vendida / Alquilada / Permutada / Temporario).

Excepción posible (en evaluación): alquiler temporario podría permitir cierre directo en el futuro porque suele cerrarse rápido sin negociación previa. Por ahora la regla aplica universal. Esta decisión queda anotada en el roadmap del producto.

Si necesitás registrar un cierre sobre una operación que ya pasó "fuera del sistema" (ej: cargás una venta histórica para reportes): creá la reserva con datos mínimos (oferta = precio de cierre, seña 0) y luego cerrala como Vendida. El proceso es de 2 clicks.

7.9 Punta vendedora vs compradora (pd_side)

Cada operación tiene un campo punta (pd_side) que indica el rol de tu inmobiliaria en esa transacción:

Cómo se asigna automáticamente al crear:

• Modal abierto desde la ficha de una propiedad de tu cuenta (o de tu agente) → la operación nace como seller_side.
• Modal abierto como operación manual sin propiedad (property externa) → la operación nace como buyer_side.

No hace falta que el usuario elija la punta: el sistema la infiere del contexto. Si en el futuro necesitás registrar ambas puntas, ese flujo quedará disponible.

Dónde lo ves en la UI: en la página /deals/[id] hay un chip que muestra "Punta vendedora", "Punta compradora" o "Ambas puntas" según el valor del campo.

Comisión por punta (implementado 2026-07-30): cuando una operación tiene dos brokers (un co-brokering) o cuando una misma oficina lleva las dos puntas (par directo doble-punta), el sistema crea dos operaciones vinculadas — una por punta — y cada una lleva su propia comisión. La comisión se carga al cerrar cada punta (Vendida/Alquilada), nunca al reservar, y cada punta se cierra por separado. En los reportes, el par cuenta como una operación (el volumen no se duplica), pero las dos comisiones suman. Ver §7.11.

7.10 Operación manual con propiedad externa

Cuándo usar: cuando la propiedad que estás trabajando no está cargada en tu cuenta Mapaprop. Por ejemplo:

• Llevás a un comprador a ver una propiedad de otra inmobiliaria.
• Trabajás en cobrokerage informal con un colega y querés dejar track de la operación.
• Registrás una venta histórica de una propiedad que nunca se publicó en tu plataforma.

Cómo crear una operación manual:

El botón abre el mismo modal de operación, pero en modo "manual" (sin propiedad de la cuenta vinculada).

💡 También llegás desde una propiedad: si estás registrando una operación sobre una de tus propiedades y en el paso "Tipo de operación" te das cuenta de que en realidad la operación es sobre otra propiedad que no está en Mapaprop, elegí la opción "Operación externa". Te lleva directo a Operaciones, donde la registrás con el botón "+ Agregar operación". Existe para que esa opción esté a la vista y no haya que saber de antemano dónde se cargan las operaciones externas.

Cómo se ve el modal en modo manual:

• Header: ícono morado 🔗 + título "Operación Externa" + badge morado "Punta compradora".
• Banner explicativo morado arriba: "Operación sobre una propiedad que no está en Mapaprop. Sos punta compradora..."

Qué pide el modal — campos obligatorios marcados con *:

1. Tipo de operación  (4 botones tipo card con ícono):

• 🏷️ Venta
• 🔑 Alquiler
• 📅 Alquiler Temporario
• 🔄 Permuta

Los labels y orden vienen del sistema multi-país (mismo selector que ves al cargar una propiedad). Si en el futuro Mapaprop opera en otros países, los labels se traducen automáticamente.

2. Dirección de la propiedad  (input texto libre, max 255 caracteres). Ejemplo: "Av. Cabildo 1234, CABA". Sirve para identificar la operación en listados y reportes — sin esto el deal queda como "Sin dirección registrada".
3. Sucursal ⚠️ (obligatoria desde 2026-05-29 para Admin / Main / Manager): a qué sucursal de tu inmobiliaria corresponde la operación. Si no la elegís, el botón "Siguiente" queda deshabilitado. Para vendor se asigna automáticamente su sucursal y este campo no aparece.
4. Estado  (cards): solo aparecen Reservada y los terminales (Vendida / Alquilada / etc según el tipo elegido). Los cards Disponible y Suspendida se ocultan: no aplican a propiedades externas.
5. Oferta y montos: ídem operación normal (oferta, seña/reserva, cierre, comisión). Recordá que al cerrar (Vendida/Alquilada) la comisión es obligatoria (ver §5.2).
6. Participantes: selector de contactos para Vendedor/Propietario (la contraparte, suele ser un broker o el dueño directo) y Comprador/Inquilino (tu cliente). Ambos opcionales pero recomendados para trazabilidad. En modo externo el "vendedor" se cargan como contactos locales sin vincularse formalmente a una propiedad (no hay property en el sistema).
7. Comentarios: campo libre.

Limitaciones según rol:

Caso de uso típico para el vendor: "Acompañé a un comprador a ver un departamento de otra inmobiliaria, quedó interesado, lo reservé de manera informal. Quiero dejar track para no perder la operación." → creá una operación manual Reservada desde "Operaciones", con el botón "+ Agregar operación". Cuando la operación se concrete, avisale a tu admin para que la cierre como Vendida o Alquilada.

Tip: si la contraparte es otra inmobiliaria o un broker colega, podés cargar ese contacto con tipo "Broker" (ver sección 8.5) y vincularlo al campo Vendedor de la operación. Así tenés trazabilidad de con quién trabajaste el cobrokerage.

7.11 Origen de la operación: Propia / Externa / Co-brokering / Doble punta / Eliminada

Cada operación tiene un campo "Origen" que la clasifica. Los orígenes Co-brokering y Doble punta marcan la punta compradora de una operación vinculada (ver §7.12). Permite filtrar y entender de un vistazo qué tipo de operación estás mirando.

Filtrar por origen: en /deals el dropdown "Origen" tiene 4 opciones: Todos / Propia / Externa / Eliminada. Útil para:

• Ver solo operaciones manuales del período (origen Externa) y medir tu volumen de cobrokerage informal.
• Auditar operaciones huérfanas (origen Eliminada) y decidir si limpiarlas o conservarlas.
• Filtrar solo operaciones internas (origen Propia) para reportes "limpios" sin manuales ni huérfanas.

Ejemplo concreto:

• Llevaste un comprador a un departamento de Remax en marzo. Cargaste una operación manual desde "Operaciones" → operación con origen Externa, punta Compradora.
• En abril cerraste una venta de tu propiedad código MP007 con un comprador habitual → origen Propia, punta Vendedora.
• En mayo eliminaste la propiedad MP007 del catálogo (decidiste no relistarla) → la operación de abril cambia a origen Eliminada automáticamente, pero conserva el código MP007 como dato histórico (snapshot).

💡 El origen lo asigna el sistema automáticamente. No es algo que cargues manualmente.

7.12 Operaciones vinculadas: co-brokering y doble punta

A veces una operación no es una sola: son dos operaciones vinculadas, una por cada punta (la vendedora y la compradora). Pasa en dos casos:

• Co-brokering — el comprador lo trajo otro broker (de tu oficina o de tu red en Mapaprop). Cada oficina administra y cierra su punta, con su comisión.
• Par directo doble-punta — vos (una misma oficina/agente) llevás las dos puntas: representás al vendedor Y al comprador. Se crean igual dos operaciones vinculadas, una por punta, cada una con su comisión.

En ambos casos:

• Se crean 2 operaciones en /deals, con badge "Co-brokering" (verde) o "Doble punta" (azul), unidas entre sí (card "Operación vinculada" en el detalle).
• La comisión de cada punta se carga al cerrar esa punta (Vendida/Alquilada), nunca al reservar.
• Cada punta se cierra por separado (una puede cerrarse y la otra caerse). El sistema marca con un ícono de alerta (en el listado /deals y en el detalle /deals/[id]) dos anomalías del par:
• Estados distintos: una punta cerró y la otra cayó.
• Precios de cierre distintos: las dos puntas cerraron (Vendida / Alquilada) pero con precios de cierre diferentes. Como es la misma propiedad debería haber un solo precio de venta — la comisión sí difiere por punta, el precio de cierre no. La alerta te avisa para que revises y corrijas.
• Al cerrar o cancelar (caída) una punta, el sistema te ofrece hacer lo mismo con la otra ("¿Cerrar también la operación vinculada?" / "¿Cancelar también la operación vinculada?"). Es un atajo de conveniencia, no automático: vos confirmás, y cada punta conserva su propio cierre con su propia comisión. Solo aparece cuando la otra punta es de tu misma oficina y sigue abierta.
• En los reportes, el par cuenta como una operación (el volumen no se duplica), pero las dos comisiones suman.

Cómo se crea: al registrar una reserva sobre tu propiedad (con Business), el wizard tiene un paso "Tipo de operación" donde elegís:

• Doble punta → llevás vos las dos puntas (vendedor + comprador). El sistema crea automáticamente las 2 operaciones vinculadas.
• Co-brokering → el comprador lo trajo otro broker. Elegís la contraparte con un selector en cascada: oficina → sucursal → agente. Podés elegir un colega de tu propia oficina o de cualquier otra oficina de tu red en Mapaprop (redes con directorio y co-brokering), con su sucursal y su agente. El sistema crea las 2 operaciones vinculadas.
• Una sola punta → se registra una sola operación (captación o punta única, sin vínculo).

La comisión de cada punta se carga al cerrar esa punta, nunca al reservar.

Co-brokering entre dos agentes, paso a paso — un agente reserva sobre la propiedad de otro; el agente de la otra punta recibe un email y entra directo a su operación. Cada uno ve y administra solo su punta:

Y cuando el colega es de OTRA oficina de tu red — el flujo es el mismo, pero la contraparte se elige por cascada (oficina → sucursal → agente) y cada oficina ve la propiedad y la operación desde su lado (la compradora la ve como ficha de red):

Y el otro lado: cuando sos vos quien trae al comprador para una propiedad de otra oficina de tu red. Entrás desde el catálogo de Propiedades de Red, reservás como punta compradora (la contraparte —la oficina dueña— se resuelve sola) y esa oficina recibe el email para gestionar su punta vendedora:

7.13 Cerrar una operación en conjunto con otra inmobiliaria (co-brokering): solo dentro de tu red (MLS)

Cerrar una operación en conjunto con otra inmobiliaria solo es posible cuando las dos inmobiliarias pertenecen a la misma red inmobiliaria (MLS) en Mapaprop. No es una configuración que se activa: es un requisito. Si las dos inmobiliarias no comparten una red, la opción de elegir a esa otra oficina no está disponible en el co-brokering.

• Con un colega de tu propia oficina (tu misma cuenta) el co-brokering está siempre disponible.
• Con otra inmobiliaria (otra oficina) el co-brokering aparece únicamente si las dos son miembros de la misma red. El selector de contraparte (oficina → sucursal → agente) solo lista las oficinas de tu red.

⚠️ Sin una red compartida no hay co-brokering entre inmobiliarias distintas. La red es el requisito que lo habilita; no es algo que se resuelva desde la configuración de la operación.

La propiedad de red queda vinculada a tu contacto comprador

Cuando co-brokereás una propiedad de otra oficina de tu red (vos llevás la punta compradora, la propiedad vive en la otra oficina), esa propiedad de red queda asociada a tu contacto comprador:

• La vas a ver en la ficha del contacto comprador, identificada como propiedad de red, junto con el resto de propiedades que ese contacto tenga vinculadas.
• Desde la ficha de esa propiedad de red podés volver a tu operación: el vínculo funciona en los dos sentidos (contacto → propiedad de red → tu operación).

Todo esto vive dentro del contexto de la red compartida: sin la red, ni el co-brokering entre inmobiliarias distintas ni estos vínculos existen. Más detalle sobre cómo se comportan las propiedades de red en Propiedad de Red / MLS.

8. Casos especiales

8.1 Asesor sin sucursal asignada

Si un vendor del sistema no tiene sucursal asignada, puede acceder a Operaciones pero verá toda la cuenta (no se aplica el filtro por sucursal). Recomendación: siempre asignar sucursal al alta del asesor.

8.2 Bajaste de plan Business a Free/Plus

• Tus operaciones existentes no se borran, siguen en el sistema.
• Perdés acceso a los reportes de operaciones y al modo Business.
• No podés crear operaciones nuevas (volvés al modo Básico, que solo cambia estado de propiedad).
• Si volvés a Business, recuperás el acceso completo y todas tus operaciones históricas.

8.3 Asesor de una sucursal mira propiedad de otra

Esto es común en redes con múltiples sucursales. El asesor:

• Sí puede ver el historial de operaciones de cualquier propiedad de la cuenta (lectura cross-branch).
• No puede ver el detalle de operaciones que no son de su sucursal (en su lugar ve "🔒 Nombre de la otra sucursal").
• No puede crear ni cerrar operaciones sobre propiedades de otras sucursales.

8.4 Migración de datos viejos sin tipo correcto

Si tenés operaciones cargadas antes de abril 2026, el campo "tipo" puede estar como "Venta" aunque la propiedad sea de alquiler (era un bug). Hay un script SQL que recalcula los tipos de operaciones viejas en base al tipo de la propiedad. Si necesitás que se aplique en tu cuenta, contactá a soporte.

8.5 Contactos broker (colegas inmobiliarios)

Cuando creás un contacto nuevo desde el CRM o desde el modal de operación, hay un selector "Tipo de contacto" con dos opciones:

Casos de uso del tipo Broker:

• Una inmobiliaria amiga que te trae compradores a propiedades tuyas (cobrokerage).
• Un colega de otra cuenta Mapaprop con quien compartís operaciones de vez en cuando.
• La contraparte vendedora en una operación manual: la property es de ellos, vos llevás el comprador.

Cómo aparece en el CRM: el tag "Broker" aparece automáticamente en el filtro de etiquetas del CRM junto con los tags habituales (Inquilino, Dueño, Interesado, etc). Podés filtrar todos tus brokers rápidamente para ver con quiénes tenés relaciones activas.

El tag Broker no reemplaza a los demás. Si un broker también es comprador en alguna operación, puede tener ambas etiquetas (la de Broker asignada al crear el contacto, y la de Interesado asignada al vincularlo a una propiedad).

9. Preguntas frecuentes

¿Por qué no puedo ver el botón "Cierre Business"? Tu plan no incluye Operaciones. Necesitás Business (servicio 56) o BusinessManager (servicio 57).

Soy asesor: ¿"Todas las operaciones" y "Mis Operaciones" me muestran lo mismo? Sí. Las dos te llevan a la misma pantalla, y en las dos ves únicamente tus operaciones: el alcance lo aplica el servidor, no el link. "Mis Operaciones" existe para que el nombre diga lo que vas a encontrar.

Entonces, ¿un asesor puede ver las operaciones de sus compañeros? No. El alcance lo aplica el servidor: cada asesor recibe únicamente las operaciones de su sucursal que él registró, y lo mismo vale para los totales de las mini-cards. Compartir la pantalla no significa compartir los datos.

¿Por qué un indicador de brecha me da 0% o sin datos? Cada indicador se calcula solo con las operaciones que tienen los precios que ese indicador necesita, en la misma moneda: "Publicación a oferta" necesita publicación + oferta; "Oferta a cierre" necesita oferta + cierre; "Descuento final" necesita publicación + cierre. Si ninguna operación del período tiene esos datos (o están en monedas distintas), ese indicador queda sin base. Cargá siempre los 3 precios en la misma moneda para que las operaciones aporten a los tres. El botón "Solo datos completos" te muestra únicamente esas operaciones completas.

¿Puedo borrar una operación cargada por error? Sí: el administrador de la cuenta puede eliminarla (deja de contar en los reportes y queda registrado quién, cuándo y por qué — es definitivo, ver §7.2). Si la operación fue real pero no se concretó, mejor marcala Caída para que quede en los reportes como una caída.

Marco una propiedad como Vendida sin el modo Business. ¿Pierdo algo? Sí. El cambio queda en la propiedad (estado y precio de cierre) pero no genera operación trackeable: no aparece en los reportes, no aporta a la brecha, no hay registro de comprador/vendedor. Para gestión real, usá el modo Business.

¿Por qué el tipo de mis operaciones nuevas dice "Alquiler" cuando creo desde una propiedad de alquiler? Es el comportamiento esperado: el tipo de la operación se deriva del tipo de la propiedad.

¿Puedo ver operaciones de propiedades que ya borré? Sí. En el listado global aparecen con un snapshot de los datos del inmueble y la nota "(eliminada)".

¿Cuándo aparece el botón "Marcar como caída" automático? Cuando intentás cambiar el estado de una propiedad reservada a Disponible o Suspendida sin cerrar la operación. El sistema lo detecta y te ofrece resolver con un click.

¿Para qué sirve el tipo de contacto "Broker"? Para distinguir a tus colegas inmobiliarios de tus clientes finales en el CRM. Un broker es alguien con quien co-trabajás, no un comprador o propietario. Al marcarlo como Broker al crear el contacto, se le asigna automáticamente la etiqueta "Broker" y aparece en el filtro de etiquetas del CRM.

¿Puedo crear una operación si la propiedad no está en mi cuenta? Sí. Es la operación manual (ver sección 7.10). La usás cuando trabajás de punta compradora sobre una propiedad de otra inmobiliaria o que no está publicada en Mapaprop.

¿Por qué me aparece una alerta en un par de operaciones vinculadas? En un co-brokering o doble punta, las dos operaciones deberían cerrar al mismo precio (es la misma propiedad; lo que difiere por punta es la comisión, no el precio de cierre). Si las dos puntas cerraron con precios de cierre distintos, o quedaron en estados distintos (una cerrada y la otra caída), el sistema marca la operación con un ícono de alerta en el listado y en el detalle para que la revises.

En un co-brokering, ¿puedo elegir un agente de otra oficina de mi red? Sí. Al armar un co-brokering, el selector de contraparte baja en cascada oficina → sucursal → agente y te deja elegir tanto un colega de tu propia oficina como de cualquier otra oficina de tu red en Mapaprop (redes con directorio y co-brokering). Solo se muestran datos públicos de la otra oficina (nombre, sucursal, agente), nunca su información privada.

¿Puedo cerrar una operación en conjunto con otra inmobiliaria? Sí, pero solo si las dos inmobiliarias pertenecen a la misma red (MLS) en Mapaprop. No es una configuración: es un requisito. Si no comparten una red, la opción de elegir a esa otra oficina en el co-brokering no está disponible. Cuando co-brokereás una propiedad de red, esa propiedad queda vinculada a tu contacto comprador (la ves en la ficha del contacto, identificada como propiedad de red) y podés volver a tu operación desde la ficha de la propiedad de red. Ver §7.13.

¿Qué pasa con una propiedad de red cuando la reservo, la vendo o la alquilo? Cuando ponés en un estado no disponible (Reservada, Vendida, Alquilada o Suspendida) una propiedad que compartís en una red MLS, esa propiedad sale automáticamente de las búsquedas de la red: los demás miembros dejan de encontrarla al buscar. No se borra ni se elimina. Quien ya tenga una operación abierta sobre ella —por ejemplo la otra punta de un co-brokering— la sigue viendo por su ficha, con el link que ya tenía. Y si la operación se cae y la propiedad vuelve a estar Disponible, reaparece sola en las búsquedas de la red, sin que tengas que volver a compartirla. Más detalle en Propiedad de Red / MLS.

PARTE 2 — Referencia Operativa (soporte / admins de cuenta)

Esta parte está pensada para soporte de Mapaprop, comercial, y admins de cuenta que necesitan responder consultas de clientes con precisión: quién puede hacer qué, qué requiere cada plan, y cómo se comportan las pantallas según el rol.

10. Roles del sistema

Mapaprop tiene 4 perfiles de acceso, con distinto alcance sobre la cuenta.

En esta doc, "admin" sin prefijo significa Admin Principal o Gestor de Red (ambos roles tienen permisos de gestión sobre la cuenta). "Admin Mapaprop" se llama explícitamente cuando aplica.

11. Matriz de permisos por acción

Reglas clave:

• El asesor solo abre reservas. No cierra ni cancela — esas decisiones las toma el admin de la cuenta.
• Solo el administrador de la cuenta puede eliminar una operación (definitivo y auditado — ver §7.2). Un error de carga se elimina; una operación real que no se concretó se marca Caída.
• El asesor puede leer historial de cualquier sucursal pero no puede modificar deals fuera de la suya.

12. Permisos por pantalla

Entradas del menú "Operaciones"

Las entradas se muestran con cualquier plan, pero al hacer click sin Business se dispara el modal de upgrade. "Red" exige además Business Manager.

/deals (Operaciones)

/deals/[id] (Detalle de una operación)

Panel "Operaciones" en ficha de propiedad

El asesor lee el historial de cualquier propiedad de la cuenta, pero solo modifica deals de su sucursal.

Modal "Cierre de Operación"

¿Qué entry points lo abren y quién los ve?

¿Qué muestra el modal según plan y rol?

Detalles del comportamiento del modal:

• Tags en el header: el modal muestra el tipo de operación (Venta/Alquiler/etc.) y el tipo de propiedad (Departamento/Casa/etc.) como chips, derivados de la propiedad.
• "Oferta de reserva" + "Monto de reserva": al cerrar una reserva existente, la sección Montos muestra estos 2 campos (con fondo ámbar) como referencia.
• "Origen del Comprador": aparece dentro de Montos al cerrar una operación. Es opcional.
• "Cerrar como X" abre directo en Montos: al entrar desde un botón de cierre, la sección Estado queda colapsada (la decisión ya está tomada) y se abre directamente Montos para confirmar el precio de cierre.

13. Plan requerido

13.1 Sistema completo de Operaciones

Requiere plan Business (servicio 56) o BusinessManager (servicio 57).

Para Free / Plus / Pro+:

• El menú Operaciones se ve completo, pero al hacer click en cualquiera de sus reportes se dispara el modal de upgrade.
• El botón "Cierre Business" en el modal de operación se bloquea con modal de upgrade.
• El backend rechaza endpoints del módulo de deals.

13.2 Modo Básico del modal

No requiere plan — disponible para todos. Es la única función del módulo de operaciones que es free. Solo cambia el estado de la propiedad (Reservada / Vendida / Alquilada / Suspendida) y opcionalmente registra precio de cierre. No genera deal trackeable, no aporta a reportes.

13.3 Por qué la decisión

El sistema de Operaciones existe principalmente para gestión comercial profesional: medir performance, ranking, brecha. Eso justifica el plan Business. Customers chicos que solo necesitan marcar una propiedad como vendida tienen el modo Básico.