Skip to main content
La integración de Payana con Siesa te permite operar tu ciclo de cuentas por pagar sin salir de Payana: causar facturas de servicios, cruzarlas contra entradas de compra, consultar tus CxP registradas en Siesa y registrar egresos hacia el ERP.
Siesa ofrece dos módulos de conexión con aplicaciones externas: Connekta (el módulo tradicional de APIs) y Apigee (un gateway más reciente que algunos clientes ya tienen habilitado). Payana funciona con ambos — si tienes Apigee, solo se agrega un campo de autenticación adicional en la configuración, pero la experiencia desde Payana es idéntica.

Qué puedes hacer con la integración

Además de registrar documentos, Payana lee de tu Siesa la información con la que se arman los formularios y se concilia la operación:

Requisitos para la integración

Antes de conectar, tu equipo (o tu aliado Siesa) necesita dejar habilitado lo siguiente. Sin esto la conexión no se puede completar.
El módulo de consultas dinámicas es imprescindible. Buena parte de la integración — CxP, egresos, entradas de compra, tipos de documento, condiciones de pago, impuestos y retenciones, mandatos y anticipos — no existe como consulta estándar de Siesa: se resuelve con consultas dinámicas que se dan de alta en tu instancia. Si tu licencia o tu usuario no tiene habilitado el módulo de consultas dinámicas (Generador de consultas en Siesa HUB), la integración queda limitada a los maestros básicos y no puede operar el ciclo de cuentas por pagar. Confírmalo con Siesa al inicio del proyecto, no durante la implementación.

1. Acceso al módulo de conexión

Acceso a Connekta o Siesa HUB con permiso para:
  • Crear y publicar consultas dinámicas (el módulo mencionado arriba).
  • Consumir consultas estándar (los catálogos API_v2_*).
  • Consumir conectores estándar y dinámicos, que son los que registran los documentos en el ERP.
En Siesa HUB estos permisos se asignan por usuario desde Administración → Permisos: Micro servicios, Conectores estándar, Conectores dinámicos, Consultas estándar y Consultas dinámicas.

2. Credenciales

Si tu instancia usa Apigee, además de estos datos se agrega el campo de autenticación propio del gateway. El resto de la configuración es igual.

3. Consultas dinámicas a dar de alta

Payana entrega los scripts SQL de cada consulta; tu equipo o tu aliado Siesa las crea en el módulo de consultas dinámicas con el prefijo acordado.
Algunas consultas solo se habilitan si tu operación las necesita: por ejemplo, MANDATOS únicamente para empresas que operan bajo mandato, y ENTRADAS_COMPRA si vas a causar con cruce de EC.

4. Conectores de causación habilitados

El registro de documentos en Siesa se hace a través de conectores de importación. Necesitamos que estén habilitados para el usuario de integración y conocer su id y su nombre:
  • Causación directa de servicios — conector de documento de compra de servicios.
  • Causación con cruce de Entrada de Compra — conector de factura con entrada del módulo comercial.
  • Registro de egresos — los tipos de egreso que vayas a usar desde Payana.

Causación directa de servicios

Desde el módulo financiero de Siesa, puedes causar facturas de servicios completando el formulario de causación en Payana. Los campos disponibles — Servicio, Motivo, Centro de costos, Centro de operaciones, Unidad de negocio e impuestos — se consultan directamente desde tu Siesa, por lo que siempre reflejan tu parametrización actual.
Los valores que Siesa aplica al registrar (como impuestos y retenciones) dependen de la parametrización de tu empresa en el ERP.

Causación con cruce de Entrada de Compra

Para facturas de compras, Payana puede vincularlas a una Entrada de Compra (EC) existente en Siesa, cerrando el ciclo logístico y contable en un solo paso. Algunas particularidades de este flujo que es importante tener en cuenta:
  • Se necesita una EC creada en Siesa primero. Payana cruza contra EC; si aún solo tienes una Orden de Compra, primero debe generarse la EC en Siesa.
  • El cruce es completo, no parcial. Al seleccionar una EC, sus líneas se toman tal como están registradas. Si hay diferencias frente a la factura del proveedor, la corrección se hace en Siesa antes de cruzar.
  • Puedes cruzar varias EC en una misma factura, siempre que cada una se tome completa.
  • Las retenciones las aplica Siesa automáticamente según la parametrización de proveedor, locación y servicio. No es posible modificarlas desde Payana.

Importación de CxP

Payana puede consultar e importar las cuentas por pagar ya registradas en Siesa, para que queden visibles y operables dentro de Payana. Esto permite gestionar el pago de esas obligaciones sin necesidad de salir del ERP o hacer doble registro.
La importación de CxP puede tomar algunos minutos dependiendo del volumen de registros, dado los tiempos de respuesta de las consultas en Siesa.

Registro de egresos

Payana puede registrar egresos directamente en Siesa a través de los tipos de egreso habilitados en tu módulo de conexión. Dependiendo de la configuración de tu empresa, algunos tipos de egreso pueden requerir una parametrización específica por proveedor o caso antes de estar disponibles.

Consideraciones

  • Sin consultas dinámicas no hay ciclo de cuentas por pagar. Es la dependencia más importante de esta integración: conviene validarla con Siesa antes de arrancar.
  • Lo que el front de Siesa permite no siempre está disponible vía integración. Los conectores tienen un alcance definido; algunas operaciones que puedes hacer manualmente en Siesa no están expuestas hacia aplicaciones externas.
  • Si un documento no aparece al buscar (una EC, un proveedor, un tipo de egreso), lo más probable es que el ERP no se haya sincronizado recientemente. Ejecuta una sincronización desde Payana y vuelve a intentarlo.
  • Si un documento falla al registrarse, el mensaje de error puede no ser descriptivo. Contacta a soporte de Payana con el detalle del error para que podamos identificar la causa junto con Siesa.