Para navegar esta guía, haz clic sobre la sección que desees consultar. Cada sección se expande al dar clic.

1. ¿Qué es Palomma? 💳

**Palomma** es una plataforma de pagos moderna diseñada para Latinoamérica que permite a los negocios recibir dinero de manera escalable y eficiente. Al integrarla con nuby, tus arrendatarios podrán pagar sus facturas directamente desde el portal de clientes sin necesidad de acercarse a una oficina o realizar transferencias manuales. ##### 🔹 **Métodos de pago disponibles:** - **PSE** → Transferencia bancaria directa desde cualquier banco colombiano. - **Nequi** → Billetera digital de Bancolombia. - **Daviplata** → Billetera digital de Davivienda. - **Tarjetas de crédito y débito** → Visa, Mastercard, American Express. ##### 🔹 **Beneficios de usar Palomma:** - **Pagos en tiempo real** → Los pagos se registran automáticamente en nuby. - **Múltiples métodos de pago** → Tus clientes eligen el método que prefieran. - **Notificaciones automáticas** → nuby recibe confirmación del pago al instante (vía webhooks). - **Registro contable automático** → Se genera el recibo de pago y el documento contable sin intervención manual. - **Disponible en Colombia** → Integrada con el ecosistema financiero colombiano. ##### 🔹 **¿Para quién es útil esta guía?** - **Administradores del sistema** → Para configurar la pasarela y habilitar los pagos electrónicos. - **Gerencia** → Para entender el impacto y los beneficios de la integración. - **Contabilidad y Tesorería** → Para comprender cómo se registran los pagos recibidos a través de Palomma.

2. Antes de empezar (prerrequisitos) ✅

Antes de configurar Palomma en nuby, verifica que cuentas con lo siguiente: #### 📌 Requisito 1. Cuenta activa en Palomma Debes tener un convenio vigente con **Palomma**. Si aún no tienes cuenta, puedes registrarte en su sitio web [**palomma.com**](https://palomma.com) o contactar a tu representante comercial. #### 📌 Requisito 2. ID de Inmobiliaria Palomma te proporcionará un **identificador único** para tu inmobiliaria. Es un código corto que identifica a tu empresa dentro de la plataforma de Palomma. - **Ejemplo de formato** → `tuespacioideal`, `inmobiliariaxyz` - **Dónde obtenerlo** → Desde el panel de administración de Palomma o solicitándolo a su equipo de soporte. #### 📌 Requisito 3. Forma de Pago configurada en nuby Necesitas tener al menos una **Forma de Pago** activa en nuby con una cuenta contable asignada. Esta forma de pago se usará para registrar los pagos que lleguen a través de Palomma. Si aún no tienes una forma de pago específica, te recomendamos crearla antes de continuar: 1. Ve a **Configuración > Contabilidad > Formas de Pago**. 2. Crea una nueva forma de pago con un nombre descriptivo, por ejemplo: **"Pago Electrónico - Palomma"**. 3. Asígnale la cuenta contable que corresponda según tu plan de cuentas.

**Importante:** Solo aparecerán en el selector aquellas formas de pago que tengan una **cuenta contable asociada**. Si no ves opciones disponibles, revisa que tus formas de pago tengan la cuenta contable configurada.

#### 📌 Requisito 4. Permisos de administrador - Necesitas **permisos de visualización** en el módulo de Pasarelas de Pago para ver la configuración. - Necesitas **permisos de edición** en el módulo de Pasarelas de Pago para poder modificar y guardar la configuración.

**Tip:** Si no tienes acceso al módulo, solicita al usuario administrador de tu sistema que te otorgue los permisos necesarios.

3. ¿Cómo acceder al módulo de Pasarelas de Pago? 🛠️

#### 🔐 Paso 1. Inicia sesión en nuby Ingresa a nuby con tu usuario y contraseña habituales. #### 📂 Paso 2. Dirígete a Configuraciones 1. En el **menú principal**, busca y haz clic en **"Configuraciones"**. 2. Dentro de las configuraciones, busca la opción **"Pasarelas de Pago"**. #### 📌 Paso 3. Visualiza las pasarelas disponibles Al ingresar al módulo verás una pantalla de bienvenida donde se listan todas las pasarelas disponibles en formato de tarjetas. Cada tarjeta muestra: - **Nombre de la pasarela** → Por ejemplo: Palomma, PayU, ELP. - **Descripción** → Qué hace y qué métodos de pago soporta. - **Estado** → Un indicador que muestra si la pasarela está **Activa** o **Inactiva**. - **Características** → Lista de funcionalidades de la pasarela. - **Botón "Configurar"** → Para acceder al formulario de configuración.

**Nota:** Puedes tener múltiples pasarelas activas simultáneamente (por ejemplo, Palomma y PayU). Tus arrendatarios podrán elegir su método de pago preferido al momento de pagar.

#### 📄 Paso 4. Selecciona Palomma Ubica la tarjeta de **Palomma** y haz clic en el botón **"Configurar"**. También puedes acceder desde el **menú lateral izquierdo**, donde verás la opción **"Palomma"** listada junto con las demás pasarelas.

4. Configuración paso a paso 🔧

Una vez dentro del formulario de configuración de Palomma, verás los siguientes campos. A continuación te explicamos cada uno y cómo completarlos: --- #### ⚙️ Paso 1. Activar o desactivar Palomma El primer campo es un interruptor (*toggle*) con la etiqueta **"¿Habilitar Palomma?"**.

Estado del interruptor	¿Qué sucede?
Desactivado (gris)	Palomma no aparece como opción de pago para tus arrendatarios. Puedes guardar la configuración sin completar todos los campos.
Activado (verde)	Palomma aparece como método de pago disponible. Los campos "ID de Inmobiliaria" y "Forma de Pago" se vuelven obligatorios.

**Recomendación:** Completa primero los campos obligatorios (ID de Inmobiliaria y Forma de Pago) y luego activa el interruptor. De esta forma evitarás errores de validación al guardar.

--- #### 🏢 Paso 2. Ingresar el ID de Inmobiliaria en Palomma Escribe el **identificador único** de tu inmobiliaria, proporcionado por Palomma. - **Etiqueta roja "Obligatorio"** → Este campo es requerido cuando la pasarela está activa. - **Ejemplo** → `tuespacioideal` - **¿Por qué es importante?** → Este ID le permite a Palomma saber a qué inmobiliaria corresponde cada transacción de pago.

**Atención:** Este ID debe coincidir **exactamente** con el que está registrado en tu cuenta de Palomma. Si hay algún error, los pagos no se procesarán correctamente.

--- #### 💰 Paso 3. Seleccionar la Forma de Pago Selecciona del listado la **Forma de Pago** que quieres usar para registrar los pagos recibidos a través de Palomma. - **Etiqueta roja "Obligatorio"** → Este campo es requerido cuando la pasarela está activa. - **Formato de las opciones** → Se muestran como: `Nombre de la forma de pago (código cuenta - nombre cuenta)`. ##### 🔹 **¿Qué pasa cuando un arrendatario paga a través de Palomma?** 1. Palomma notifica a nuby que el pago fue exitoso. 2. nuby registra automáticamente el pago asociándolo a la **Forma de Pago** que seleccionaste aquí. 3. Se genera el **recibo de pago** y el **documento contable** correspondiente. 4. Se actualiza el saldo de la factura del arrendatario. ##### 🔹 **¿Qué Forma de Pago seleccionar?** Te recomendamos crear una forma de pago exclusiva para Palomma. Esto te permitirá: - Identificar fácilmente los pagos electrónicos en tus reportes. - Facilitar la conciliación bancaria. - Tener claridad en las auditorías contables.

**Sugerencia:** Si aún no tienes una forma de pago específica, créala desde **Configuración > Contabilidad > Formas de Pago** con nombre **"Pago Electrónico - Palomma"** y asígnale la cuenta contable que corresponda.

--- #### 🔧 Paso 4. Filtros Avanzados (opcional) Dentro del formulario de configuración encontrarás una sección llamada **"Filtros Avanzados"**, plegada por defecto. Haz clic en su título para expandirla. Estos filtros controlan qué facturas y conceptos puede ver y cobrar Palomma. **Si no configuras ninguno, la pasarela solo mostrará facturas pendientes ya emitidas.**

Campo	Tipo	Descripción
¿Incluir facturas en borrador?	Casilla	Si está activa, tus arrendatarios también verán las facturas en estado borrador (aún no emitidas oficialmente) al consultar sus pendientes.
Resoluciones	Selección múltiple	Filtra por resoluciones de facturación. Si no seleccionas ninguna, se incluyen facturas de todas las resoluciones.
¿Permitir pagar conceptos que no aplican a una factura?	Casilla	Permite cobrar conceptos que generan recibo de caja pero no factura (por ejemplo, depósitos o ajustes).
¿Permitir pagar conceptos de periodos futuros?	Casilla	Permite que los arrendatarios paguen anticipadamente conceptos de periodos que aún no han iniciado.
Rango de conceptos futuros	Selector	Define hasta qué periodo futuro se mostrarán conceptos. Opciones: Un mes, Tres meses, Seis meses o Sin límite. Solo disponible si la opción anterior está activa.
¿Incluir los intereses de mora en la factura del canon?	Casilla	Los intereses de mora pendientes se adjuntan como detalle adicional a la factura de canon correspondiente. Al pagar la factura, el interés también queda pagado automáticamente.
¿Agrupar conceptos pertenecientes al mismo periodo?	Casilla	Consolida en un único ítem pagable los conceptos del mismo contrato, tercero y periodo. Los conceptos negativos (descuentos o notas crédito) se descuentan solo si existe un concepto positivo con saldo suficiente en el mismo periodo. Solo disponible si al menos una de las dos opciones anteriores de conceptos está activa.
¿Enviar automáticamente a la DIAN?	Casilla	Envía automáticamente a la DIAN las facturas generadas desde la pasarela. Solo disponible si se activa al menos una de las tres opciones anteriores (borrador, futuros o intereses de mora).

**Recomendación:** Si eres nuevo con Palomma, deja los Filtros Avanzados desactivados hasta que el flujo básico esté funcionando correctamente. Una vez confirmado, puedes habilitarlos según las necesidades de tu inmobiliaria.

--- #### 🔑 Paso 5. Campos OAuth2 (solo lectura) Verás dos campos adicionales con la etiqueta azul **"Solo Lectura"**: - **ID del Cliente OAuth2** → Identificador generado automáticamente por nuby. - **Secret Key del Cliente OAuth2** → Clave secreta generada automáticamente por nuby. **No necesitas ingresar nada en estos campos.** El sistema los genera automáticamente cuando activas la pasarela y guardas la configuración por primera vez.

Situación	¿Qué muestran los campos OAuth2?
Pasarela desactivada	Vacíos, con el texto: "Este valor se asignará automáticamente al guardar la configuración".
Primera vez que activas y guardas	Se generan automáticamente y muestran los valores generados.
Ya existían credenciales anteriores	Se mantienen las credenciales existentes (no se regeneran).

--- #### 💾 Paso 6. Guardar la configuración Haz clic en el botón **"Guardar Configuración"**. **Si la pasarela está desactivada:** - Se guardan los campos que hayas completado. Los campos OAuth2 permanecen vacíos. - Palomma no aparecerá como opción de pago para tus arrendatarios. **Si la pasarela está activada:** - El sistema valida que los campos obligatorios estén completos. - Si es la primera vez, se generan automáticamente las **credenciales OAuth2**. - Verás un mensaje de confirmación: *"Configuración de Palomma guardada correctamente."*

**Atención:** Si recibes un error al guardar indicando que un campo es **"requerido"**, asegúrate de haber completado el ID de Inmobiliaria y seleccionado una Forma de Pago.

5. Filtros Avanzados: funcionamiento detallado ⚙️

Los Filtros Avanzados son opciones adicionales que controlan exactamente qué facturas y conceptos puede ver y cobrar Palomma cuando un arrendatario consulta sus pendientes en el portal de clientes. **Todos están desactivados por defecto.**

**¿Cómo acceder?** Dentro del formulario de configuración de Palomma, haz clic en el encabezado de la sección **«Filtros Avanzados»** para expandirla. La sección aparece plegada por defecto.

--- #### 🔲 Filtro 1. ¿Incluir facturas en borrador? **¿Qué hace?** Cuando está activo, las facturas que ya existen en el sistema pero aún **no han sido enviadas a la DIAN** (estado «borrador») también aparecen como pendientes de pago en el portal de clientes.

Estado del filtro	Comportamiento
Desactivado (por defecto)	Solo se muestran facturas en estado emitido (ya enviadas a la DIAN o en proceso de envío). Las borradores son invisibles para el arrendatario.
Activado	Se muestran tanto las facturas emitidas como las facturas en borrador. El arrendatario puede pagar cualquiera de ellas.

**¿Qué se genera al pagar una factura en borrador?** 1. Se registra el pago de la factura. 2. Se genera el recibo de caja. 3. El envío a la DIAN ocurre **según el filtro «¿Enviar automáticamente a la DIAN?»**: si está activo, se envía de inmediato; si no, queda pendiente para envío manual.

**Importante:** Si activas este filtro, asegúrate de revisar tus borradores periódicamente. Si hay borradores con errores o que no deberían cobrarse aún, el arrendatario podría pagarlos antes de que los corrijas.

--- #### 📋 Filtro 2. Resoluciones **¿Qué hace?** Permite limitar qué facturas y conceptos son visibles en el portal de clientes según la **resolución de facturación** a la que pertenecen.

Configuración	Comportamiento
Ninguna resolución seleccionada (por defecto)	Se muestran las facturas y conceptos de todas las resoluciones activas.
Una o varias resoluciones seleccionadas	Solo se muestran las facturas y conceptos que pertenecen a las resoluciones elegidas. Las demás quedan ocultas para el arrendatario.

**¿Cómo funciona el filtro por tipo de tercero?** Para cada resolución seleccionada, el sistema también filtra los conceptos según el **tipo de tercero** configurado en esa resolución (inquilino o propietario). Esto garantiza que un inquilino solo vea los conceptos que le corresponden y un propietario vea los suyos.

**Caso de uso típico:** Si manejas varias resoluciones (por ejemplo, una para arriendos residenciales y otra para locales comerciales) y solo quieres habilitar el pago en línea para residenciales, selecciona únicamente esa resolución.

--- #### 🔲 Filtro 3. ¿Permitir pagar conceptos que no aplican a una factura? **¿Qué hace?** Habilita el cobro de conceptos que **no generan factura**, sino solo un recibo de caja (por ejemplo, depósitos de garantía, ajustes manuales, cobros por administración, etc.).

Estado del filtro	Comportamiento
Desactivado (por defecto)	Solo se pueden pagar conceptos que generan factura. Los conceptos sin factura no aparecen en el portal.
Activado	Los arrendatarios también verán los conceptos sin factura y podrán pagarlos.

**¿Qué se genera al pagar este tipo de concepto?** - Se genera **solo el recibo de caja**. No se crea ninguna factura. - El pago queda registrado en el sistema con la Forma de Pago configurada en Palomma. --- #### 🔲 Filtro 4. ¿Permitir pagar conceptos de periodos futuros? **¿Qué hace?** Permite que los arrendatarios paguen **anticipadamente** conceptos de periodos que todavía no han iniciado (por ejemplo, pagar en abril el canon de mayo).

Estado del filtro	Comportamiento
Desactivado (por defecto)	Solo se muestran conceptos del periodo actual y anteriores (pendientes). Los periodos futuros no son visibles.
Activado	Se muestran también los conceptos de periodos futuros dentro del rango configurado (ver Filtro 5).

**Consideraciones importantes:** - Aplica solo a **conceptos**, tanto facturables como no facturables. **Nunca se muestran facturas de periodos futuros** directamente. - Si el concepto futuro **genera factura**, esa factura se **crea automáticamente** en el momento del pago y queda registrada como pagada. - Si el concepto futuro **no genera factura**, se genera solo el recibo de caja (siempre que el Filtro 3 esté activo, o bien si el concepto no requiere factura por su naturaleza).

**Dependencia:** Al activar este filtro se habilita el campo **«Rango de conceptos futuros»** (Filtro 5). Es obligatorio configurarlo para definir hasta cuántos meses hacia adelante se mostrarán los conceptos.

--- #### 📅 Filtro 5. Rango de conceptos futuros **¿Qué hace?** Define **hasta qué mes futuro** puede ver y pagar el arrendatario. Este campo solo está disponible cuando el Filtro 4 está activo.

Opción	Qué conceptos se muestran
Un mes (por defecto)	Solo el mes siguiente al actual. Ej: si hoy es 15 de abril, se muestran conceptos con periodo hasta el 31 de mayo.
Tres meses	Hasta tres meses hacia adelante. Ej: desde hoy 15 de abril, hasta el 31 de julio.
Seis meses	Hasta seis meses hacia adelante.
Sin límite	Todos los conceptos futuros ya cargados en el sistema, sin importar su periodo.

**Nota sobre el rango:** El rango cubre el **mes calendario completo**. Por ejemplo, con «Tres meses» y hoy siendo 15 de abril, el límite es el **31 de julio** (no el 15 de julio). Si seleccionas «Sin límite», ten en cuenta que podrían mostrarse conceptos muy lejanos si tienes contratos con cargos programados a futuro.

**Dependencia requerida:** Este campo está **deshabilitado** si el Filtro 4 («¿Permitir pagar conceptos de periodos futuros?») no está activo. Debe activarse primero ese filtro para poder configurar el rango.

--- #### 🔲 Filtro 6. ¿Incluir los intereses de mora en la factura del canon? **¿Qué hace?** Cuando está activo, los intereses de mora que tenga pendientes un arrendatario **se adjuntan como detalle adicional** a la factura del canon a la que corresponden, y se cobran juntos en un solo pago.

Estado del filtro	Comportamiento
Desactivado (por defecto)	Los intereses de mora se muestran como ítems independientes del canon. El arrendatario puede pagar el canon sin pagar el interés.
Activado	Los intereses de mora se agrupan con la factura del canon correspondiente. Al pagar el canon, el interés también queda pagado automáticamente.

**¿Qué se genera al pagar el canon con interés incluido?** 1. Se registra el pago del canon. 2. Se genera **automáticamente la factura del interés de mora** (si aún no existía) y queda como pagada. 3. Se genera un recibo de caja que incluye tanto el canon como el interés. 4. El envío de la factura de interés a la DIAN sigue la regla del filtro «¿Enviar automáticamente a la DIAN?». **¿Qué pasa si el interés no tiene canon asociado?** Si un interés de mora no encuentra una factura de canon pendiente a la cual adjuntarse (por ejemplo, el canon ya fue pagado pero el interés quedó pendiente), se cobrará de forma **independiente** como ítem separado en el portal. --- #### 📦 Filtro 7. ¿Agrupar conceptos pertenecientes al mismo periodo? **¿Qué hace?** Cuando está activo, los conceptos que comparten **el mismo contrato, el mismo tercero y el mismo rango de fechas del periodo** se muestran al arrendatario como un **único ítem pagable**, cuyo valor a pagar es la suma de todos ellos. Al pagarlo, se genera un solo recibo de caja y, cuando corresponda, una sola factura agrupada por contrato.

Estado del filtro	Comportamiento
Desactivado (por defecto)	Cada concepto se muestra como un ítem independiente en el portal. El arrendatario puede pagarlos por separado.
Activado	Todos los conceptos del mismo contrato, tercero y periodo se consolidan en un solo ítem pagable. El arrendatario los paga juntos en una sola transacción.

**Reglas de agrupación:** - Se agrupan los conceptos con el **mismo contrato**, el **mismo tercero (deudor)** y el **mismo periodo** (fechas de inicio y fin idénticas). - Si en el periodo ya existe una **factura pendiente** del mismo contrato y tercero, los conceptos **no facturables** se adjuntan a esa factura (el saldo de la factura suma esos conceptos). - Los conceptos **facturables** (que al pagarse generan factura) se agrupan entre sí, pero **nunca se adjuntan a una factura pendiente existente**: al pagarlos se crea una nueva factura agrupada por contrato. - Los conceptos con **valor negativo** (descuentos o notas crédito del periodo) se descuentan del grupo, pero **solo si existe un concepto positivo del mismo periodo con saldo suficiente**. Si un descuento no encuentra un concepto positivo que lo absorba, se omite del ítem agrupado (no aparecerá en el portal) para evitar saldos negativos.

**Dependencia requerida:** Este filtro está **deshabilitado** hasta que se active al menos uno de estos dos filtros: **«¿Permitir pagar conceptos que no aplican a una factura?»** (Filtro 3) o **«¿Permitir pagar conceptos de periodos futuros?»** (Filtro 4). La razón es que solo tiene sentido agrupar conceptos cuando hay conceptos sueltos visibles en el portal.

**¿Cuándo conviene activarlo?** Si tu inmobiliaria suele facturar al arrendatario varios conceptos del mismo periodo (canon + administración + servicios + cuotas) y prefieres que el arrendatario los pague de forma consolidada (un solo recibo, una sola factura), activa este filtro. Si prefieres que el arrendatario decida qué conceptos pagar individualmente, déjalo desactivado.

--- #### 🔲 Filtro 8. ¿Enviar automáticamente a la DIAN? **¿Qué hace?** Cuando está activo, nuby envía automáticamente a la DIAN las facturas que se **paguen o generen** a través de Palomma y que requieran envío (facturas en borrador, facturas de conceptos futuros, facturas de intereses de mora).

Estado del filtro	Comportamiento
Desactivado (por defecto)	Las facturas generadas o pagadas desde la pasarela no se envían automáticamente. Quedan pendientes de envío manual desde el módulo de facturación.
Activado	Inmediatamente después del pago, nuby intenta enviar la factura a la DIAN. Si el envío es exitoso, la factura queda en estado «pagada y enviada a la DIAN».

**¿Qué pasa si el envío a la DIAN falla?** - El **pago siempre queda registrado**, independientemente del resultado del envío a la DIAN. - La factura queda marcada como **«pagada, pendiente de envío a la DIAN»**. - Puedes reintentar el envío manualmente desde el módulo de Facturación.

**Dependencia requerida:** Este campo está **deshabilitado** hasta que se active al menos uno de estos tres filtros: **«¿Incluir facturas en borrador?»**, **«¿Permitir pagar conceptos de periodos futuros?»** o **«¿Incluir los intereses de mora en la factura del canon?»**. La razón es que el envío automático solo tiene efecto cuando alguno de esos filtros puede generar o pagar facturas que aún no han sido enviadas a la DIAN.

--- #### 📊 Resumen de dependencias entre filtros

Campo	Depende de	Cuando se activa, puede generar automáticamente
¿Incluir facturas en borrador?	— (independiente)	Recibo de caja al pagar. Factura enviada a la DIAN si el Filtro 7 está activo.
Resoluciones	— (independiente)	No genera documentos adicionales; solo filtra qué se muestra.
¿Permitir conceptos sin factura?	— (independiente)	Recibo de caja (sin factura).
¿Permitir conceptos futuros?	— (independiente)	Factura (si el concepto la requiere) + recibo de caja.
Rango de conceptos futuros	Requiere Filtro 4 activo	No genera documentos; define el alcance del Filtro 4.
¿Incluir intereses de mora?	— (independiente)	Factura de interés de mora + recibo de caja.
¿Agrupar conceptos del mismo periodo?	Requiere Filtro 3 o Filtro 4 activo	No genera documentos nuevos: consolida la presentación en el portal y, al pagar, un solo recibo de caja + una sola factura agrupada por contrato (cuando aplique).
¿Enviar automáticamente a la DIAN?	Requiere al menos uno de: Filtro 1, Filtro 4 o Filtro 6 activo	Envío electrónico a la DIAN de las facturas generadas.

6. Configuración en el portal de Palomma 🌐

Después de guardar la configuración en nuby con la pasarela activada, debes completar la integración desde el lado de Palomma. Para ello, **debes copiar y proporcionar al equipo de Palomma tus credenciales de conexión**, quienes se encargarán de realizar la configuración directamente en su portal. Asegúrate de enviarles la siguiente información: - **Dominio de la instancia de nuby:** Es la URL o enlace desde el cual ingresas habitualmente al sistema. - **Client ID:** Visible en el formulario de configuración de Palomma dentro de nuby. - **Secret Key:** Visible en el formulario de configuración de Palomma dentro de nuby.

7. Resumen de campos del formulario 📋

Esta tabla resume todos los campos disponibles en el formulario de configuración de Palomma:

Campo	Tipo	Obligatorio	Editable	Descripción
¿Habilitar Palomma?	Interruptor	No	Sí	Activa o desactiva la pasarela de pago Palomma.
ID de Inmobiliaria en Palomma	Texto	Al activar	Sí	Identificador único de la inmobiliaria proporcionado por Palomma.
Forma de Pago	Selector	Al activar	Sí	Forma de pago que se usará para registrar los pagos recibidos a través de esta pasarela.
¿Incluir facturas en borrador?	Casilla	No	Sí	Incluye facturas en estado borrador al consultar pendientes desde Palomma.
Resoluciones	Selección múltiple	No	Sí	Filtra las facturas disponibles por resoluciones de facturación. Sin selección = todas las resoluciones.
¿Permitir pagar conceptos sin factura?	Casilla	No	Sí	Permite cobrar conceptos que generan recibo de caja pero no factura.
¿Permitir pagar conceptos futuros?	Casilla	No	Sí	Permite pagos anticipados de conceptos de periodos futuros.
Rango de conceptos futuros	Selector	No	Sí	Hasta qué periodo futuro se muestran conceptos (Un mes / Tres meses / Seis meses / Sin límite). Requiere opción anterior activa.
¿Incluir intereses de mora?	Casilla	No	Sí	Adjunta los intereses de mora a la factura de canon correspondiente para cobrarlos juntos.
¿Agrupar conceptos del mismo periodo?	Casilla	No	Sí	Consolida en un solo ítem pagable los conceptos del mismo contrato, tercero y periodo. Requiere Filtro 3 o Filtro 4 activos.
¿Enviar automáticamente a la DIAN?	Casilla	No	Sí	Envía automáticamente a la DIAN las facturas generadas por la pasarela. Disponible solo con filtros avanzados activos.
ID del Cliente OAuth2	Texto	No	No (generado)	Identificador del cliente OAuth2, generado automáticamente al activar y guardar.
Secret Key del Cliente OAuth2	Texto	No	No (generado)	Clave secreta del cliente OAuth2, generada automáticamente al activar y guardar.

8. ¿Cómo funciona el flujo de pago? 🔄

Una vez configurada la integración, este es el flujo que ocurre cuando un arrendatario paga una factura a través de Palomma: 1. **El arrendatario ingresa al portal de clientes** de nuby y selecciona la factura que desea pagar. 2. **Elige Palomma como método de pago** entre las opciones disponibles. 3. **Es redirigido al checkout seguro de Palomma**, donde selecciona su método preferido (PSE, Nequi, Daviplata o tarjeta). 4. **Palomma procesa el pago** con la entidad financiera correspondiente. 5. **El banco confirma la transacción** y Palomma recibe la respuesta. 6. **Palomma notifica a nuby** mediante un webhook que incluye las credenciales OAuth2. 7. **nuby valida la autenticidad** de la notificación y registra el pago automáticamente: - Registra el pago de la factura. - Genera el recibo de pago. - Crea el documento contable. - Actualiza el saldo de la factura. 8. **El arrendatario recibe confirmación** del pago exitoso. ##### 🔹 **Seguridad de la comunicación** Las credenciales OAuth2 (Client ID y Client Secret) garantizan que las notificaciones de pago entre Palomma y nuby sean auténticas y seguras: - Cada notificación de Palomma incluye estas credenciales. - nuby valida que la notificación sea legítima antes de registrar el pago. - Esto previene fraudes y notificaciones falsas de pago.

9. Verificación de la integración ✔️

Antes de dar por terminada la configuración, verifica los siguientes puntos: #### 📋 Checklist en nuby

\#	Verificación
1	El interruptor de Palomma está activado (verde).
2	El campo ID de Inmobiliaria tiene un valor ingresado.
3	El campo Forma de Pago tiene una opción seleccionada.
4	El campo ID del Cliente OAuth2 muestra un valor (no está vacío).
5	El campo Secret Key del Cliente OAuth2 muestra un valor (no está vacío).
6	Al guardar, se recibió un mensaje de éxito (sin errores).

#### 📋 Checklist en el portal de Palomma

\#	Verificación
1	El Client ID está configurado (copiado desde nuby).
2	El Client Secret está configurado (copiado desde nuby).
3	La URL de webhook está configurada correctamente.
4	La prueba de conexión fue exitosa (si la opción está disponible).

10. Preguntas frecuentes ❓

#### ¿Puedo guardar la configuración sin completar todos los campos? **Sí**, pero depende del estado del interruptor: - Si el interruptor está **desactivado**: puedes guardar con campos vacíos sin problema. - Si el interruptor está **activado**: el ID de Inmobiliaria y la Forma de Pago son obligatorios. --- #### ¿Puedo tener Palomma y otras pasarelas activas al mismo tiempo? **Sí.** Puedes tener múltiples pasarelas activas simultáneamente (por ejemplo, Palomma, PayU y ELP). Tus arrendatarios verán todas las opciones disponibles al momento de pagar y podrán elegir la que prefieran. --- #### ¿Qué pasa si cambio el ID de Inmobiliaria después de recibir pagos? - Los **pagos anteriores no se ven afectados** (ya fueron procesados). - Los **nuevos pagos** usarán el nuevo ID. - **Importante:** Asegúrate de que el nuevo ID también esté configurado en el portal de Palomma. --- #### ¿Puedo cambiar la Forma de Pago después de recibir pagos? **Sí.** El cambio solo afecta a los pagos **futuros**. Los pagos anteriores mantienen la forma de pago que estaba configurada al momento de recibirlos. --- #### ¿Las credenciales OAuth2 cambian si desactivo y reactivo Palomma? **No.** Las credenciales se generan **una sola vez** y se mantienen permanentemente, sin importar cuántas veces desactives o reactives la pasarela. Solo se regeneran si se elimina manualmente el registro del cliente OAuth. --- #### ¿Por qué los campos OAuth2 están vacíos si la pasarela está activa? Posibles causas: - **No guardaste la configuración** después de activar la pasarela. Haz clic en "Guardar Configuración". - **Hubo un error al generar las credenciales.** Intenta desactivar, guardar, reactivar y guardar nuevamente. - **Las credenciales fueron eliminadas** de forma manual. En este caso, desactiva y reactiva la pasarela para regenerarlas. --- #### ¿Cómo sé si un pago fue registrado correctamente? Cuando un pago se registra correctamente a través de Palomma, ocurre lo siguiente: - Se genera el **pago de la factura**. - Se genera el **recibo de caja**. - Se genera el **documento contable**. - La factura actualiza su **saldo**. - Si el saldo queda en cero, la factura cambia a estado **pagada**. - Se crea un **registro de transacción** visible en el área de clientes. --- #### ¿Cómo regenero las credenciales OAuth2 si fueron comprometidas? Si sospechas que las credenciales fueron expuestas: 1. Ve a **Configuraciones > API** en nuby. 2. Ubica el cliente OAuth de Palomma y elimínalo. 3. Regresa al formulario de Pasarelas de Pago y guarda la configuración nuevamente con la pasarela activa. 4. Se generarán nuevas credenciales. 5. **Actualiza las nuevas credenciales en el portal de Palomma.**

**Atención:** Después de regenerar las credenciales, debes actualizar los valores en el portal de Palomma inmediatamente. De lo contrario, los webhooks de pago dejarán de funcionar.

11. Solución de problemas 🔍

Problema	Posible causa	Solución
No aparecen opciones en el campo "Forma de Pago"	Las formas de pago no tienen cuenta contable asociada.	Ve a Configuración > Contabilidad > Formas de Pago y asigna una cuenta contable a la forma de pago deseada.
Error al guardar: campo "requerido"	El interruptor está activado pero faltan campos obligatorios.	Completa el ID de Inmobiliaria y selecciona una Forma de Pago.
Los campos OAuth2 están vacíos después de guardar	Error al crear el cliente OAuth2 o configuración no guardada correctamente.	Desactiva la pasarela, guarda, reactiva y guarda nuevamente.
Los pagos no se registran automáticamente	Las credenciales OAuth2 no coinciden entre nuby y Palomma, o la URL de webhook es incorrecta.	Verifica que las credenciales en el portal de Palomma coincidan con las de nuby y que la URL de webhook sea correcta.
No tengo acceso al módulo de Pasarelas de Pago	No tienes los permisos necesarios.	Solicita al administrador del sistema que te otorgue permisos de visualización y edición del módulo.
No puedo editar los campos (formulario deshabilitado)	Tienes permisos de solo lectura.	Solicita al administrador que te otorgue permisos de edición en el módulo.

12. Resumen rápido 🚀

Para configurar Palomma en nuby, sigue estos pasos: 1. Ve a **Configuraciones > Pasarelas de Pago**. 2. Haz clic en **"Configurar"** en la tarjeta de Palomma. 3. Ingresa el **ID de Inmobiliaria** proporcionado por Palomma. 4. Selecciona la **Forma de Pago** con la que se registrarán los pagos. 5. (*Opcional*) Expande la sección **"Filtros Avanzados"** para personalizar qué facturas y conceptos puede ver Palomma. 6. Activa el **interruptor** "¿Habilitar Palomma?". 7. Haz clic en **"Guardar Configuración"** → Se generan las credenciales OAuth2. 8. **Copia las credenciales OAuth2** generadas. 9. Ingresa al portal de **Palomma** y configura las credenciales y la URL de webhook. 10. **¡Listo!** Tus arrendatarios ya pueden pagar a través de Palomma. ##### 🔹 **Reglas clave:**

Regla	Comportamiento
Campos obligatorios	Solo son requeridos cuando el interruptor está activado.
Credenciales OAuth2	Se generan automáticamente al activar por primera vez. No se regeneran si ya existen.
Forma de Pago	Se usa para clasificar contablemente los pagos recibidos vía Palomma.
Múltiples pasarelas	Puedes tener Palomma y otras pasarelas activas al mismo tiempo.

Para más información sobre Palomma, visita su sitio web oficial: [*palomma.com*](https://palomma.com) o su documentación técnica en [*docs.palomma.com*](https://docs.palomma.com)

\#	Verificación
1	El interruptor de Palomma está activado (verde).
2	El campo ID de Inmobiliaria tiene un valor ingresado.
3	El campo Forma de Pago tiene una opción seleccionada.
4	El campo ID del Cliente OAuth2 muestra un valor (no está vacío).
5	El campo Secret Key del Cliente OAuth2 muestra un valor (no está vacío).
6	Al guardar, se recibió un mensaje de éxito (sin errores).

\#	Verificación
1	El Client ID está configurado (copiado desde nuby).
2	El Client Secret está configurado (copiado desde nuby).
3	La URL de webhook está configurada correctamente.
4	La prueba de conexión fue exitosa (si la opción está disponible).