Ir al contenido principal

¿Cómo configurar la pasarela Palomma en nuby?

Esta guíaguía te explica paso a paso cómocómo configurar la pasarela de pagos Palomma en nuby, para que tus arrendatarios puedan pagar sus facturas de forma electrónicaelectrónica usando métodosmétodos como PSE, Nequi, Daviplata y tarjetas de créditocrédito o débitodébito. Al completar esta configuración,configuración, los pagos se registraránregistrarán de forma automáticaautomática en el sistema.


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

1. ¿Qué¿Qué es Palomma? 💳

Palomma es una plataforma de pagos moderna diseñadadiseñada para LatinoaméricaLatinoamérica que permite a los negocios recibir dinero de manera escalable y eficiente. Al integrarla con nuby, tus arrendatarios podránpodrán pagar sus facturas directamente desde el portal de clientes sin necesidad de acercarse a una oficina o realizar transferencias manuales.

🔹 MétodosMé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éditocrédito y débitodébito →→ Visa, Mastercard, American Express.

🔹 Beneficios de usar Palomma:
  • Pagos en tiempo real →→ Los pagos se registran automáticamenteautomáticamente en nuby.

  • MúltiplesMúltiples métodosmétodos de pago →→ Tus clientes eligen el métodométodo que prefieran.

  • Notificaciones automáticasautomáticas →→ nuby recibe confirmaciónconfirmación del pago al instante (víavía webhooks).

  • Registro contable automáticoautomático →→ Se genera el recibo de pago y el documento contable sin intervenciónintervención manual.

  • Disponible en Colombia →→ Integrada con el ecosistema financiero colombiano.

🔹 ¿¿Para quiénquién es útilútil esta guía?guía?
  • Administradores del sistema →→ Para configurar la pasarela y habilitar los pagos electrónicos.electrónicos.

  • Gerencia →→ Para entender el impacto y los beneficios de la integración.integración.

  • Contabilidad y TesoreríaTesorería →→ Para comprender cómocómo se registran los pagos recibidos a travéstravé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únaún no tienes cuenta, puedes registrarte en su sitio web palomma.com o contactar a tu representante comercial.

📌 Requisito 2. ID de Inmobiliaria

Palomma te proporcionaráproporcionará un identificador únicoúnico para tu inmobiliaria. Es un códigocódigo corto que identifica a tu empresa dentro de la plataforma de Palomma.

  • Ejemplo de formato →→ tuespacioideal, inmobiliariaxyz

  • DóndeDónde obtenerlo →→ Desde el panel de administraciónadministración de Palomma o solicitándolosolicitá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áusará para registrar los pagos que lleguen a travéstravés de Palomma.

Si aúnaún no tienes una forma de pago específica,específica, te recomendamos crearla antes de continuar:

  1. Ve a ConfiguraciónConfiguración > Contabilidad > Formas de Pago.

  2. Crea una nueva forma de pago con un nombre descriptivo, por ejemplo: "Pago ElectrónicoElectrónico - Palomma".

  3. AsígnaleAsígnale la cuenta contable que corresponda segúnsegún tu plan de cuentas.

Importante: Solo apareceránaparecerá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ónvisualización en el módulomódulo de Pasarelas de Pago para ver la configuración.configuración.

  • Necesitas permisos de ediciónedición en el módulomódulo de Pasarelas de Pago para poder modificar y guardar la configuración.configuración.

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

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

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

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

📂 Paso 2. DirígeteDirígete a Configuraciones

  1. En el menúmenú principal, busca y haz clic en "Configuraciones".

  2. Dentro de las configuraciones, busca la opciónopción "Pasarelas de Pago".

📌 Paso 3. Visualiza las pasarelas disponibles

Al ingresar al módulomódulo verásverá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ónDescripción →→ QuéQué hace y quéqué métodosmétodos de pago soporta.

  • Estado →→ Un indicador que muestra si la pasarela estáestá Activa o Inactiva.

  • CaracterísticasCaracterísticas →→ Lista de funcionalidades de la pasarela.

  • BotónBotón "Configurar" →→ Para acceder al formulario de configuración.configuración.

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

📄 Paso 4. Selecciona Palomma

Ubica la tarjeta de Palomma y haz clic en el botónbotón "Configurar". TambiénTambién puedes acceder desde el menúmenú lateral izquierdo, donde verásverás la opciónopción "Palomma" listada junto con las demásdemás pasarelas.

4. ConfiguraciónConfiguración paso a paso 🔧

Una vez dentro del formulario de configuraciónconfiguración de Palomma, verásverás los siguientes campos. A continuacióncontinuación te explicamos cada uno y cómocómo completarlos:


⚙️ Paso 1. Activar o desactivar Palomma

El primer campo es un interruptor (toggle) con la etiqueta "¿¿Habilitar Palomma?".

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

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


🏢 Paso 2. Ingresar el ID de Inmobiliaria en Palomma

Escribe el identificador únicoúnico de tu inmobiliaria, proporcionado por Palomma.

  • Etiqueta roja "Obligatorio" →→ Este campo es requerido cuando la pasarela estáestá activa.

  • Ejemplo →→ tuespacioideal

  • ¿¿Por quéqué es importante? →→ Este ID le permite a Palomma saber a quéqué inmobiliaria corresponde cada transaccióntransacción de pago.

Atención:Atención: Este ID debe coincidir exactamente con el que estáestá registrado en tu cuenta de Palomma. Si hay algúnalgún error, los pagos no se procesaránprocesará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éstravés de Palomma.

  • Etiqueta roja "Obligatorio" →→ Este campo es requerido cuando la pasarela estáestá activa.

  • Formato de las opciones →→ Se muestran como: Nombre de la forma de pago (códigocódigo cuenta - nombre cuenta).

🔹 ¿Qué¿Qué pasa cuando un arrendatario paga a travéstravés de Palomma?
  1. Palomma notifica a nuby que el pago fue exitoso.

  2. nuby registra automáticamenteautomáticamente el pago asociándoloasociándolo a la Forma de Pago que seleccionaste aquí.aquí.

  3. Se genera el recibo de pago y el documento contable correspondiente.

  4. Se actualiza el saldo de la factura del arrendatario.

🔹 ¿Qué¿Qué Forma de Pago seleccionar?

Te recomendamos crear una forma de pago exclusiva para Palomma. Esto te permitirá:permitirá:

  • Identificar fácilmentefácilmente los pagos electrónicoselectrónicos en tus reportes.

  • Facilitar la conciliaciónconciliación bancaria.

  • Tener claridad en las auditoríasauditorías contables.

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


🔧 Paso 4. Filtros Avanzados (opcional)

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

Campo Tipo DescripciónDescripción
¿¿Incluir facturas en borrador? Casilla Si estáestá activa, tus arrendatarios tambiéntambién veránverán las facturas en estado borrador (aúnaún no emitidas oficialmente) al consultar sus pendientes.
Resoluciones SelecciónSelección múltiplemúltiple Filtra por resoluciones de facturación.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ósitosdepósitos o ajustes).
¿¿Permitir pagar conceptos de periodos futuros? Casilla Permite que los arrendatarios paguen anticipadamente conceptos de periodos que aúnaún no han iniciado.
Rango de conceptos futuros Selector Define hasta quéqué periodo futuro se mostraránmostrarán conceptos. Opciones: Un mes, Tres meses, Seis meses o Sin límite.límite. Solo disponible si la opciónopción anterior está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ésinterés tambiéntambién queda pagado automáticamente.automáticamente.
¿¿Agrupar conceptos pertenecientes al mismo periodo? Casilla Consolida en un únicoúnico ítemítem pagable los conceptos del mismo contrato, tercero y periodo. Los conceptos negativos (descuentos o notas crédito)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áestá activa.
¿¿Enviar automáticamenteautomáticamente a la DIAN? Casilla EnvíaEnvía automáticamenteautomá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:Recomendación: Si eres nuevo con Palomma, deja los Filtros Avanzados desactivados hasta que el flujo básicobásico estéesté funcionando correctamente. Una vez confirmado, puedes habilitarlos segúnsegún las necesidades de tu inmobiliaria.


🔑 Paso 5. Campos OAuth2 (solo lectura)

VerásVerás dos campos adicionales con la etiqueta azul "Solo Lectura":

  • ID del Cliente OAuth2 →→ Identificador generado automáticamenteautomáticamente por nuby.

  • Secret Key del Cliente OAuth2 →→ Clave secreta generada automáticamenteautomáticamente por nuby.

No necesitas ingresar nada en estos campos. El sistema los genera automáticamenteautomáticamente cuando activas la pasarela y guardas la configuraciónconfiguración por primera vez.

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

💾 Paso 6. Guardar la configuraciónconfiguración

Haz clic en el botónbotón "Guardar Configuración"Configuración".

Si la pasarela estáestá desactivada:

  • Se guardan los campos que hayas completado. Los campos OAuth2 permanecen vacíos.vacíos.

  • Palomma no apareceráaparecerá como opciónopción de pago para tus arrendatarios.

Si la pasarela estáestá activada:

  • El sistema valida que los campos obligatorios esténestén completos.

  • Si es la primera vez, se generan automáticamenteautomáticamente las credenciales OAuth2.

  • VerásVerás un mensaje de confirmación:confirmación: "ConfiguraciónConfiguración de Palomma guardada correctamente."

Atención:Atención: Si recibes un error al guardar indicando que un campo es "requerido", asegúrateasegú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équé facturas y conceptos puede ver y cobrar Palomma cuando un arrendatario consulta sus pendientes en el portal de clientes. Todos estánestán desactivados por defecto.

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


🔲 Filtro 1. ¿¿Incluir facturas en borrador?

¿Qué¿Qué hace? Cuando estáestá activo, las facturas que ya existen en el sistema pero aúnaún no han sido enviadas a la DIAN (estado «borrador»«borrador») tambiéntambié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)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é¿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íoenvío a la DIAN ocurre segúnsegún el filtro «¿«¿Enviar automáticamenteautomáticamente a la DIAN?»»: si estáestá activo, se envíaenvía de inmediato; si no, queda pendiente para envíoenvío manual.

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


📋 Filtro 2. Resoluciones

¿Qué¿Qué hace? Permite limitar quéqué facturas y conceptos son visibles en el portal de clientes segúnsegún la resoluciónresolución de facturaciónfacturación a la que pertenecen.

ConfiguraciónConfiguración Comportamiento
Ninguna resoluciónresolució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ásdemás quedan ocultas para el arrendatario.

¿Cómo¿Cómo funciona el filtro por tipo de tercero? Para cada resoluciónresolución seleccionada, el sistema tambiéntambién filtra los conceptos segúnsegún el tipo de tercero configurado en esa resoluciónresolució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: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ínealínea para residenciales, selecciona únicamenteúnicamente esa resolución.resolución.


🔲 Filtro 3. ¿¿Permitir pagar conceptos que no aplican a una factura?

¿Qué¿Qué hace? Habilita el cobro de conceptos que no generan factura, sino solo un recibo de caja (por ejemplo, depósitosdepósitos de garantía,garantía, ajustes manuales, cobros por administración,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éntambién veránverán los conceptos sin factura y podránpodrán pagarlos.

¿Qué¿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é¿Qué hace? Permite que los arrendatarios paguen anticipadamente conceptos de periodos que todavíatodaví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éntambié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áticamenteautomá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é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»futuros» (Filtro 5). Es obligatorio configurarlo para definir hasta cuántoscuántos meses hacia adelante se mostraránmostrarán los conceptos.


📅 Filtro 5. Rango de conceptos futuros

¿Qué¿Qué hace? Define hasta quéqué mes futuro puede ver y pagar el arrendatario. Este campo solo estáestá disponible cuando el Filtro 4 estáestá activo.

OpciónOpción Qué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ímitelí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»meses» y hoy siendo 15 de abril, el límitelímite es el 31 de julio (no el 15 de julio). Si seleccionas ««Sin límite»límite», ten en cuenta que podríanpodrían mostrarse conceptos muy lejanos si tienes contratos con cargos programados a futuro.

Dependencia requerida: Este campo estáestá deshabilitado si el Filtro 4 («¿«¿Permitir pagar conceptos de periodos futuros?»») no está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é¿Qué hace? Cuando está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ítems independientes del canon. El arrendatario puede pagar el canon sin pagar el interés.interés.
Activado Los intereses de mora se agrupan con la factura del canon correspondiente. Al pagar el canon, el interésinterés tambiéntambién queda pagado automáticamente.automáticamente.

¿Qué¿Qué se genera al pagar el canon con interésinterés incluido?

  1. Se registra el pago del canon.
  2. Se genera automáticamenteautomáticamente la factura del interésinterés de mora (si aúnaún no existía)existía) y queda como pagada.
  3. Se genera un recibo de caja que incluye tanto el canon como el interés.interés.
  4. El envíoenvío de la factura de interésinterés a la DIAN sigue la regla del filtro «¿«¿Enviar automáticamenteautomáticamente a la DIAN?»».

¿Qué¿Qué pasa si el interésinterés no tiene canon asociado? Si un interésinterés de mora no encuentra una factura de canon pendiente a la cual adjuntarse (por ejemplo, el canon ya fue pagado pero el interésinterés quedóquedó pendiente), se cobrarácobrará de forma independiente como ítemítem separado en el portal.


📦 Filtro 7. ¿¿Agrupar conceptos pertenecientes al mismo periodo?

¿Qué¿Qué hace? Cuando está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único ítemí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í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ítem pagable. El arrendatario los paga juntos en una sola transacción.transacción.

Reglas de agrupación: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)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í,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éditocré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ítem agrupado (no apareceráaparecerá en el portal) para evitar saldos negativos.

Dependencia requerida: Este filtro está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ónrazón es que solo tiene sentido agrupar conceptos cuando hay conceptos sueltos visibles en el portal.

¿Cuándo¿Cuándo conviene activarlo? Si tu inmobiliaria suele facturar al arrendatario varios conceptos del mismo periodo (canon + administraciónadministració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équé conceptos pagar individualmente, déjalodéjalo desactivado.


🔲 Filtro 8. ¿¿Enviar automáticamenteautomáticamente a la DIAN?

¿Qué¿Qué hace? Cuando estáestá activo, nuby envíaenvía automáticamenteautomáticamente a la DIAN las facturas que se paguen o generen a travéstravés de Palomma y que requieran envíoenví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íanenvían automáticamenteautomáticamente. Quedan pendientes de envíoenvío manual desde el módulomódulo de facturación.facturación.
Activado Inmediatamente despuésdespués del pago, nuby intenta enviar la factura a la DIAN. Si el envíoenvío es exitoso, la factura queda en estado ««pagada y enviada a la DIAN»DIAN».

¿Qué¿Qué pasa si el envíoenvío a la DIAN falla?

  • El pago siempre queda registrado, independientemente del resultado del envíoenvío a la DIAN.
  • La factura queda marcada como ««pagada, pendiente de envíoenvío a la DIAN»DIAN».
  • Puedes reintentar el envíoenvío manualmente desde el módulomódulo de Facturación.Facturación.

Dependencia requerida: Este campo está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ónrazón es que el envíoenvío automáticoautomático solo tiene efecto cuando alguno de esos filtros puede generar o pagar facturas que aúnaún no han sido enviadas a la DIAN.


📊 Resumen de dependencias entre filtros

Campo Depende de Cuando se activa, puede generar automáticamenteautomáticamente
¿¿Incluir facturas en borrador? —— (independiente) Recibo de caja al pagar. Factura enviada a la DIAN si el Filtro 7 estáestá activo.
Resoluciones —— (independiente) No genera documentos adicionales; solo filtra qué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ésinteré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ónpresentación en el portal y, al pagar, un solo recibo de caja + una sola factura agrupada por contrato (cuando aplique).
¿¿Enviar automáticamenteautomáticamente a la DIAN? Requiere al menos uno de: Filtro 1, Filtro 4 o Filtro 6 activo EnvíoEnvío electrónicoelectrónico a la DIAN de las facturas generadas.
6. ConfiguraciónConfiguración en el portal de Palomma 🌐

DespuésDespués de guardar la configuraciónconfiguración en nuby con la pasarela activada, debes completar la integraciónintegración desde el lado de Palomma. Para ello, debes copiar y proporcionar al equipo de Palomma tus credenciales de conexiónconexión, quienes se encargaránencargarán de realizar la configuraciónconfiguración directamente en su portal.

AsegúrateAsegúrate de enviarles la siguiente información: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ónconfiguración de Palomma dentro de nuby.

  • Secret Key: Visible en el formulario de configuraciónconfiguración de Palomma dentro de nuby.

7. Resumen de campos del formulario 📋

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

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

Una vez configurada la integración,integración, este es el flujo que ocurre cuando un arrendatario paga una factura a travéstravé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étodométodo de pago entre las opciones disponibles.

  3. Es redirigido al checkout seguro de Palomma, donde selecciona su métodométodo preferido (PSE, Nequi, Daviplata o tarjeta).

  4. Palomma procesa el pago con la entidad financiera correspondiente.

  5. El banco confirma la transaccióntransacció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ónnotificación y registra el pago automáticamente: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ónconfirmación del pago exitoso.

🔹 Seguridad de la comunicacióncomunicación

Las credenciales OAuth2 (Client ID y Client Secret) garantizan que las notificaciones de pago entre Palomma y nuby sean auténticasauténticas y seguras:

  • Cada notificaciónnotificación de Palomma incluye estas credenciales.

  • nuby valida que la notificaciónnotificación sea legítimalegítima antes de registrar el pago.

  • Esto previene fraudes y notificaciones falsas de pago.

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

Antes de dar por terminada la configuración,configuración, verifica los siguientes puntos:

📋 Checklist en nuby

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

📋 Checklist en el portal de Palomma

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

¿¿Puedo guardar la configuraciónconfiguración sin completar todos los campos?

SíSí, pero depende del estado del interruptor:

  • Si el interruptor estáestá desactivado: puedes guardar con campos vacíosvacíos sin problema.

  • Si el interruptor estáestá activado: el ID de Inmobiliaria y la Forma de Pago son obligatorios.


¿¿Puedo tener Palomma y otras pasarelas activas al mismo tiempo?

Sí.Sí. Puedes tener múltiplesmúltiples pasarelas activas simultáneamentesimultáneamente (por ejemplo, Palomma, PayU y ELP). Tus arrendatarios veránverán todas las opciones disponibles al momento de pagar y podránpodrán elegir la que prefieran.


¿Qué¿Qué pasa si cambio el ID de Inmobiliaria despuésdespués de recibir pagos?

  • Los pagos anteriores no se ven afectados (ya fueron procesados).

  • Los nuevos pagos usaránusarán el nuevo ID.

  • Importante: AsegúrateAsegúrate de que el nuevo ID tambiéntambién estéesté configurado en el portal de Palomma.


¿¿Puedo cambiar la Forma de Pago despuésdespués de recibir pagos?

Sí.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ántascuántas veces desactives o reactives la pasarela. Solo se regeneran si se elimina manualmente el registro del cliente OAuth.


¿¿Por quéqué los campos OAuth2 estánestán vacíosvacíos si la pasarela estáestá activa?

Posibles causas:

  • No guardaste la configuraciónconfiguración despuésdespués de activar la pasarela. Haz clic en "Guardar Configuración"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¿Cómo sésé si un pago fue registrado correctamente?

Cuando un pago se registra correctamente a travéstravé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óntransacción visible en el áreaárea de clientes.


¿Cómo¿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.elimínalo.

  3. Regresa al formulario de Pasarelas de Pago y guarda la configuraciónconfiguración nuevamente con la pasarela activa.

  4. Se generarángenerarán nuevas credenciales.

  5. Actualiza las nuevas credenciales en el portal de Palomma.

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

11. SoluciónSolución de problemas 🔍
Problema Posible causa SoluciónSolución
No aparecen opciones en el campo "Forma de Pago" Las formas de pago no tienen cuenta contable asociada. Ve a ConfiguraciónConfiguración > Contabilidad > Formas de Pago y asigna una cuenta contable a la forma de pago deseada.
Error al guardar: campo "requerido" El interruptor estáestá activado pero faltan campos obligatorios. Completa el ID de Inmobiliaria y selecciona una Forma de Pago.
Los campos OAuth2 estánestán vacíosvacíos despuésdespués de guardar Error al crear el cliente OAuth2 o configuraciónconfiguración no guardada correctamente. Desactiva la pasarela, guarda, reactiva y guarda nuevamente.
Los pagos no se registran automáticamenteautomá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ódulomódulo de Pasarelas de Pago No tienes los permisos necesarios. Solicita al administrador del sistema que te otorgue permisos de visualizaciónvisualización y ediciónedición del módulo.módulo.
No puedo editar los campos (formulario deshabilitado) Tienes permisos de solo lectura. Solicita al administrador que te otorgue permisos de ediciónedición en el módulo.módulo.
12. Resumen rápidorá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ánregistrarán los pagos.

  5. (Opcional) Expande la secciónsección "Filtros Avanzados" para personalizar quéqué facturas y conceptos puede ver Palomma.

  6. Activa el interruptor "¿¿Habilitar Palomma?".

  7. Haz clic en "Guardar Configuración"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éstravés de Palomma.

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

Para másmás informacióninformación sobre Palomma, visita su sitio web oficial: palomma.com o su documentacióndocumentación técnicatécnica en docs.palomma.com