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.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.
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.