# ¿Cómo crear un contrato de venta en nuby?

Esta guía te explica **paso a paso** cómo registrar un **contrato de venta** en nuby: qué campos debes diligenciar, cómo funciona el sistema de **comisiones**, qué validaciones aplica el sistema y qué ocurre **automáticamente** una vez guardas el contrato.

<div class="page-content" dir="auto" id="bkmrk-"><div dir="auto">---

</div></div><p class="callout success">Para navegar esta guía, haz clic sobre la sección que desees consultar. Cada sección se expande al dar clic.</p>

<div class="page-content" dir="auto" id="bkmrk-1.-%C2%BFqu%C3%A9-es-un-contra"><div dir="auto">  <details><summary>1. ¿Qué es un contrato de venta en nuby? 🏠</summary>

Un **contrato de venta** en nuby registra el negocio entre tu inmobiliaria, el **vendedor** (propietario del inmueble) y el **comprador**. Sirve para llevar el control centralizado de:

- El **inmueble** que se vendió.
- El **valor de la venta**.
- La **comisión** que le corresponde a la inmobiliaria (y al asesor, si aplica).
- Las **facturas** y **pagos** relacionados con el negocio.

Al crear el contrato, nuby registra automáticamente el inmueble como **vendido** y abre las pestañas de **Facturas Relacionadas** y **Pagos Relacionados**, desde donde podrás facturar la comisión y registrar los pagos correspondientes.

##### 🔹 **¿Para quién es útil esta guía?**

- **Asesores comerciales y administradores** que gestionan las ventas de inmuebles.
- **Área de cartera**, para hacer seguimiento a los pagos de comisiones.
- **Contabilidad**, para comprender el saldo inicial del contrato y su ciclo de facturación.

</details>  <details><summary>2. Antes de empezar (prerrequisitos) ✅</summary>

Antes de crear el contrato de venta, asegúrate de que todos los siguientes elementos estén correctamente configurados en el sistema. Si falta alguno, el sistema no te permitirá guardar el contrato.

#### 📌 Requisito 1. La propiedad debe estar activa y ser de tipo venta

nuby solo permite asociar al contrato propiedades que:

- Estén registradas en el módulo **Propiedades** con el tipo **"Venta"** o **"Venta y Arriendo"**.
- Tengan estado **Activo** (no canceladas ni ya vendidas).

<p class="callout info">**Tip:** Si al escribir el nombre de la propiedad no aparece en la lista desplegable, verifica que esté creada con el tipo correcto y que su estado sea Activo en el módulo de Propiedades.</p>

#### 📌 Requisito 2. El vendedor (propietario) debe estar en Terceros

El campo **Vendedor** se completa automáticamente cuando seleccionas la propiedad, pero requiere que el propietario de la propiedad esté registrado en el módulo **Terceros** como tipo **Propietario**.

#### 📌 Requisito 3. El comprador debe estar en Terceros

El comprador del inmueble debe existir previamente en el módulo **Terceros** con sus datos básicos: tipo de identificación, número de documento, nombres, dirección, teléfono y correo electrónico. Estos datos son necesarios para emitir facturas electrónicas en su nombre.

#### 📌 Requisito 4. El asesor debe estar en Terceros (si aplica)

Si la venta fue intermediada por un asesor que comisiona, ese asesor también debe estar registrado en el módulo **Terceros**. De lo contrario, no aparecerá en el listado del campo **Asesor de Venta**.

#### 📌 Requisito 5. Concepto "Comisión de Contrato IVA" configurado

Para poder crear facturas desde el contrato de venta, es necesario configurar el concepto que nuby usará al generar la factura. Este concepto define si se cobra o no IVA y a qué cuentas contables se registra.

- Ve a **Herramientas &gt; Configuraciones &gt; Contratos**.
- Asegúrate de que el parámetro **"Concepto contrato de venta"** tenga asignado un concepto válido (por ejemplo, "Comisión de Contrato IVA").

<p class="callout warning">**Importante:** Sin este concepto configurado podrás crear el contrato, pero al intentar crear facturas desde él verás una alerta y el botón de facturación no funcionará.</p>

#### 📌 Requisito 6. Sin contrato activo previo para la misma propiedad

nuby valida que no exista ya un contrato de venta en estado **Activo** para la misma propiedad. Si ya existe uno, el sistema te mostrará el mensaje:

*"Ya existe un contrato de venta activo para esta propiedad."*

En ese caso, deberás cancelar el contrato anterior antes de crear uno nuevo.

</details>  <details><summary>3. ¿Cómo acceder al formulario de creación? 📂</summary>

#### 🔐 Paso 1. Inicia sesión en nuby

Ingresa a nuby con tu usuario y contraseña habituales.

#### 📂 Paso 2. Ve al módulo de Contratos

1. En el **menú principal** de la parte superior, haz clic en **"Contratos"**.
2. Se desplegará el submenú de la izquierda con las opciones del módulo.
3. Haz clic en **"Contratos de Venta"**.

#### ➕ Paso 3. Crea un nuevo contrato

En la pantalla de listado **"Contratos de Ventas"**, verás en la parte superior derecha el botón **"Crear Contrato de Venta"**. Haz clic en él.

El sistema te llevará al formulario **"Crear Contratos de Ventas"**, con la pestaña **"Información de Contrato"** activa.

<p class="callout info">**Tip:** Si ya tienes el contrato creado y quieres editarlo, puedes hacer clic sobre el código del contrato en el listado o usar el botón de edición (ícono de lápiz) al final de la fila.</p>

</details>  <details><summary>4. Campos del formulario "Registro de Contratos de Venta" ✍️</summary>

El formulario está organizado en tres columnas. A continuación te explicamos cada campo:

#### 📋 Columna 1 — Datos del inmueble y comisión

<table><thead><tr><th>Campo</th><th>Obligatorio</th><th>Descripción</th></tr></thead><tbody><tr><td>**Propiedad**</td><td>Sí ✱</td><td>Escribe la dirección o código del inmueble. Solo aparecen propiedades activas de tipo *Venta* o *Venta y Arriendo*. Al seleccionarla, el sistema autocompleta los campos **Vendedor** y **Valor de Venta**.</td></tr><tr><td>**Vendedor**</td><td>Sí ✱</td><td>Se completa automáticamente con el propietario del inmueble seleccionado. Puedes ajustarlo si el vendedor es una persona diferente al propietario registrado.</td></tr><tr><td>**Valor de Venta (Valor Neto)**</td><td>Sí ✱</td><td>Precio de venta del inmueble. Se autocompleta desde la propiedad pero puede modificarse. Este es el valor sobre el que se calculará la comisión si eliges el tipo *Porcentaje*.</td></tr><tr><td>**Tipo de Comisión**</td><td>No</td><td>Define cómo se calcula la comisión de la inmobiliaria: **Porcentaje** (% del valor de venta) o **Valor** (monto fijo en pesos). Al seleccionar una opción, aparecerá el campo correspondiente.</td></tr></tbody></table>

#### 📋 Columna 2 — Comprador y comisión

<table><thead><tr><th>Campo</th><th>Obligatorio</th><th>Descripción</th></tr></thead><tbody><tr><td>**Comprador**</td><td>Sí ✱</td><td>Escribe el nombre o número de documento del comprador. Debe estar previamente registrado en el módulo **Terceros**. No puede ser la misma persona que el Vendedor.</td></tr><tr><td>**¿Quién Paga Comisión?**</td><td>No</td><td>Visible cuando el *Tipo de Cobro* es **Solo Comisión** (modo por defecto en contratos nuevos). Opciones: **Paga el Vendedor** o **Paga el Comprador**. Define a quién se le genera la factura de comisión.</td></tr><tr><td>**Porcentaje Comisión**</td><td>Condicional ✱</td><td>Visible cuando el *Tipo de Comisión* es **Porcentaje**. Ingresa un valor entre 1 y 100. El sistema calcula automáticamente el valor de la comisión.</td></tr><tr><td>**Valor Comisión**</td><td>Condicional ✱</td><td>Visible cuando el *Tipo de Comisión* es **Valor**. Ingresa el monto fijo en pesos que cobra la inmobiliaria por la venta.</td></tr></tbody></table>

#### 📋 Columna 3 — Asesor de venta

<table><thead><tr><th>Campo</th><th>Obligatorio</th><th>Descripción</th></tr></thead><tbody><tr><td>**Asesor de Venta**</td><td>No (Sí si comisiona)</td><td>Persona que intermedió la venta. Debe estar en Terceros. Se vuelve obligatorio si activás el toggle *¿Asesor Comisiona? → SI*.</td></tr><tr><td>**¿Asesor Comisiona?**</td><td>No</td><td>Toggle **SI / NO**. Si seleccionas **SI**, se habilitan los campos adicionales para definir la comisión del asesor.</td></tr><tr><td>**Tipo de Comisión del Asesor**</td><td>Condicional ✱</td><td>Visible si *¿Asesor Comisiona? = SI*. Opciones: **Porcentaje** o **Valor**.</td></tr><tr><td>**Porcentaje / Valor Comisión Asesor**</td><td>Condicional ✱</td><td>Según el tipo elegido, ingresas el porcentaje (1-100) o el monto fijo en pesos que recibe el asesor. El valor del asesor no puede superar el valor de la comisión de la inmobiliaria.</td></tr></tbody></table>

</details>  <details><summary>5. ¿Cómo funciona el sistema de comisiones? 💰</summary>

nuby permite definir **dos tipos de comisión** independientes: uno para la **inmobiliaria** y otro (opcional) para el **asesor**. Ambos funcionan igual:

#### 💡 Porcentaje

Cuando eliges **Porcentaje**, ingresa el porcentaje de comisión (entre 1 y 100). El sistema calcula automáticamente el valor de la comisión multiplicando el porcentaje por el **Valor de Venta (Valor Neto)**.

*Ejemplo: Si el valor de venta es $200.000.000 y la comisión es del 3%, el sistema calcula automáticamente $6.000.000.*

#### 💡 Valor fijo

Cuando eliges **Valor**, ingresa directamente el monto en pesos que cobra la inmobiliaria o el asesor, independientemente del precio de venta.

#### 🏦 ¿Quién paga la comisión?

El campo **¿Quién Paga Comisión?** define a **quién le genera la factura** el sistema cuando creas una factura desde el contrato:

- **Paga el Vendedor:** la factura de comisión se le emite al propietario del inmueble.
- **Paga el Comprador:** la factura de comisión se le emite al comprador del inmueble.

<p class="callout info">**Nota sobre el Tipo de Cobro:** En los contratos nuevos el tipo de cobro predeterminado es **Solo Comisión**, lo que significa que nuby solo lleva el registro de la comisión de la inmobiliaria. Si tu inmobiliaria también cobra el valor total de la venta (actuando como intermediario de pago), el tipo de cobro puede configurarse como **Cobro Total**, en cuyo caso el saldo del contrato equivale al valor completo de venta y el responsable del pago siempre es el Comprador.</p>

</details>  <details><summary>6. Paso a paso para guardar el contrato 🚀</summary>

1. **Selecciona la propiedad.** Escribe la dirección o código en el campo **Propiedad** y elige de la lista desplegable. Al seleccionarla, nuby autocompleta automáticamente los campos **Vendedor** y **Valor de Venta**.
2. **Verifica el Vendedor.** El campo se llena automáticamente con el propietario de la propiedad. Si es correcto, continúa; si necesitas cambiarlo, búscalo en el campo.
3. **Verifica o ajusta el Valor de Venta.** El sistema lo carga desde la ficha de la propiedad. Si el valor acordado es diferente, corrígelo directamente en el campo.
4. **Elige el Tipo de Comisión** de la inmobiliaria: *Porcentaje* o *Valor*. Según lo que elijas, aparecerá el campo correspondiente para ingresar el porcentaje o el monto.
5. **Selecciona el Comprador.** Escribe su nombre o número de documento en el campo **Comprador**. Debe ser una persona distinta al Vendedor; si coinciden, el sistema te mostrará una alerta.
6. **Define quién paga la comisión** en el campo **¿Quién Paga Comisión?**: el vendedor o el comprador.
7. **Ingresa el porcentaje o valor de comisión** en el campo que apareció al elegir el tipo.
8. **(Opcional) Asesor de Venta.** Si la venta fue intermediada por un asesor, selecciónalo en el campo **Asesor de Venta**.
    
    
    - Si el asesor también comisiona, activa el toggle **¿Asesor Comisiona? → SI**.
    - Aparecerán los campos de tipo de comisión, porcentaje o valor del asesor. Completa esa información.
9. **Haz clic en "Guardar Contrato".** El sistema validará todos los campos y, si todo está correcto, guardará el contrato.

<p class="callout success">**¡Listo!** Después de guardar, el sistema te llevará de vuelta al formulario del contrato ya creado, mostrando el número de código asignado. Las pestañas **"Facturas Relacionadas"** y **"Pagos Relacionados"** estarán disponibles para continuar el proceso.</p>

</details>  <details><summary>7. Validaciones que aplica el sistema ⚠️</summary>

Antes de guardar, nuby verifica automáticamente las siguientes condiciones. Si alguna no se cumple, el sistema muestra una alerta en pantalla y no permite continuar.

<table><thead><tr><th>Validación</th><th>Mensaje del sistema</th><th>Cómo resolverlo</th></tr></thead><tbody><tr><td>Campos obligatorios vacíos</td><td>Resalta en rojo los campos faltantes</td><td>Completa los campos **Propiedad**, **Vendedor**, **Comprador** y **Valor de Venta**.</td></tr><tr><td>Comprador igual al Vendedor</td><td>Alerta de duplicado en tercero</td><td>El comprador y el vendedor deben ser personas (terceros) diferentes. Verifica que hayas seleccionado al comprador correcto.</td></tr><tr><td>Ya existe un contrato activo para la propiedad</td><td>"Ya existe un contrato de venta activo para esta propiedad."</td><td>Primero cancela el contrato activo existente y luego crea el nuevo.</td></tr><tr><td>Valor de comisión del asesor mayor a la comisión de la inmobiliaria</td><td>Alerta en el campo de valor del asesor</td><td>El monto del asesor no puede ser superior al de la comisión de la inmobiliaria. Reduce el porcentaje o valor.</td></tr><tr><td>Propiedad no válida para venta</td><td>La propiedad no aparece en el listado</td><td>Verifica que la propiedad tenga tipo *Venta* o *Venta y Arriendo* y que su estado sea **Activo**.</td></tr></tbody></table>

<p class="callout warning">**Doble envío del formulario:** nuby protege el formulario contra doble envío. Si haces clic en **"Guardar Contrato"** dos veces, el sistema procesará solo el primero y descartará el duplicado automáticamente.</p>

</details>  <details><summary>8. ¿Qué ocurre automáticamente al guardar? ⚡</summary>

Al hacer clic en **"Guardar Contrato"** y que el sistema lo acepte, ocurren las siguientes acciones de forma automática:

#### 🔢 1. Asignación del código (consecutivo)

El sistema asigna un **número de código único** al contrato, siguiendo el consecutivo de los contratos de venta existentes. Este número es visible en el listado y en el encabezado del contrato.

#### 🏠 2. La propiedad queda marcada como "Vendida"

nuby cambia automáticamente el estado del inmueble a **Vendida** en el módulo de Propiedades. Esto significa que la propiedad dejará de aparecer en el listado de propiedades disponibles para nuevos contratos de venta o de arriendo.

#### 💳 3. Se calcula el saldo inicial del contrato

Dependiendo del tipo de cobro configurado:

- **Solo Comisión** (predeterminado): el saldo inicial es igual al **valor de la comisión**. Este es el monto que la inmobiliaria irá facturando y cobrando.
- **Cobro Total**: el saldo inicial es igual al **valor total de venta**. La inmobiliaria actúa como intermediario completo de cobro.

#### ✅ 4. El contrato queda en estado "Activo"

El contrato recién creado siempre inicia en estado **Activo**, listo para facturar y recibir pagos.

<p class="callout info">**Siguiente paso recomendado:** Una vez guardado el contrato, abre la pestaña **"Facturas Relacionadas"** para emitir la factura de la comisión al comprador o vendedor. Consulta la guía *"¿Cómo crear una factura para un contrato de venta en nuby?"* para continuar el proceso.</p>

</details>  <details><summary>9. Estados del contrato de venta 🔄</summary>

Un contrato de venta en nuby puede encontrarse en uno de los siguientes estados:

<table><thead><tr><th>Estado</th><th>Descripción</th><th>Acciones disponibles</th></tr></thead><tbody><tr><td>**Activo**</td><td>El contrato está vigente. Se pueden crear facturas y registrar pagos.</td><td>Editar datos, crear facturas, registrar pagos, cancelar contrato.</td></tr><tr><td>**Finalizado**</td><td>El contrato se completó: el saldo quedó en cero y todos los cobros se saldaron.</td><td>Solo consulta. No se pueden crear más facturas ni pagos.</td></tr><tr><td>**Cancelado**</td><td>El contrato fue cancelado manualmente.</td><td>Solo consulta. La propiedad vuelve al estado **Activo** automáticamente al cancelar.</td></tr></tbody></table>

#### ❌ ¿Cómo cancelar un contrato?

Al editar un contrato **Activo**, aparece el botón **"Cancelar Contrato"** (de color rojo) en la parte inferior del formulario. Al hacer clic, el sistema pedirá una confirmación. Al confirmar:

- El contrato pasa a estado **Cancelado**.
- La propiedad vuelve automáticamente al estado **Activo**, quedando disponible para nuevos contratos.

<p class="callout danger">**Atención:** La cancelación de un contrato es irreversible. Si el contrato tiene facturas o pagos asociados, deberás gestionarlos por separado antes de cancelar, ya que el sistema no los eliminará automáticamente.</p>

<p class="callout warning">**Campos bloqueados:** Si el contrato ya tiene facturas o pagos relacionados, los campos del formulario quedarán **deshabilitados** (en gris) para proteger la integridad de los registros. Solo podrás cancelar el contrato o agregar nuevas facturas y pagos.</p>

</details>  <details><summary>10. Preguntas frecuentes 💬</summary>

#### ❓ ¿Por qué no aparece la propiedad que busco en el campo "Propiedad"?

El campo solo muestra propiedades con tipo **Venta** o **Venta y Arriendo** y estado **Activo**. Verifica en el módulo de Propiedades que la propiedad cumpla ambas condiciones.

#### ❓ ¿El Vendedor siempre es el propietario de la propiedad?

Por defecto, nuby autocompleta el campo Vendedor con el propietario registrado en la ficha de la propiedad. Sin embargo, puedes modificarlo manualmente si el vendedor es una persona diferente.

#### ❓ ¿Puedo cambiar el Valor de Venta después de guardar?

Sí, siempre y cuando el contrato no tenga facturas ni pagos relacionados. Si ya existen documentos asociados, los campos quedarán bloqueados para proteger la consistencia de los registros.

#### ❓ ¿Qué pasa si el asesor no está registrado en Terceros?

Si el asesor no aparece al escribir su nombre en el campo **Asesor de Venta**, es porque aún no está registrado. Ve al módulo **Terceros** y créalo antes de continuar.

#### ❓ ¿Puede haber varios contratos de venta para la misma propiedad?

Solo puede existir **un contrato Activo** por propiedad al mismo tiempo. Si necesitas crear uno nuevo, primero cancela el contrato activo existente. Los contratos en estado *Cancelado* o *Finalizado* no bloquean la creación de uno nuevo.

#### ❓ ¿Dónde puedo ver el listado de todos los contratos de venta?

En el módulo **Contratos &gt; Contratos de Venta**. La tabla muestra el código, la propiedad, el vendedor, el comprador, el valor de venta, la comisión y el estado de cada contrato. Puedes usar los filtros y exportar a Excel, PDF o CSV.

#### ❓ ¿Qué debo configurar para que las facturas del contrato generen contabilidad?

Para que la facturación del contrato genere asientos contables correctos, deben estar configurados:

- El **concepto "Comisión de Contrato IVA"** en **Herramientas &gt; Configuraciones &gt; Contratos**.
- Las **cuentas contables del concepto** (ingreso, IVA, retenciones) según el plan de cuentas de tu inmobiliaria.
- Una **resolución DIAN** activa en el módulo de Contabilidad.

Consulta la guía *"¿Cómo crear una factura para un contrato de venta en nuby?"* para el detalle completo del proceso de facturación.

</details></div></div>