> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payana.la/llms.txt
> Use this file to discover all available pages before exploring further.

# ERP en la nube u on-premise: qué cambia en la integración

> Entiende cómo se conecta Payana con tu ERP según esté en la nube o en tus propios servidores, y qué tiene que preparar tu equipo de IT en cada caso

Payana se integra con tu ERP tanto si está **en la nube** como si está **instalado en servidores propios o de un partner (on-premise)**. Las funciones de la integración son las mismas en los dos casos: lo que cambia es **cómo se comunica Payana con tu ERP**, no el alcance ni lo que puedes hacer.

* **En la nube**, tu ERP ya está disponible en internet. Basta con habilitar el acceso y entregarnos las credenciales.
* **On-premise**, tu ERP vive dentro de tu red privada. Además de las credenciales, tu equipo de IT tiene que abrir un camino seguro para que Payana pueda conectarse.

Esta página explica la diferencia de forma general, para cualquier ERP. Los pasos exactos de cada sistema están en su guía de integración, enlazada al final de esta página.

## ¿Mi ERP está en la nube u on-premise?

| | En la nube (SaaS) | On-premise |
| :- | :- | :- |
| **Dónde corre** | En la infraestructura del fabricante del ERP | En tus servidores, en un data center o en la nube de un partner que lo administra por ti |
| **Quién lo mantiene** | El fabricante | Tu equipo de IT o tu partner |
| **Acceso desde internet** | Sí, con una URL del fabricante | Normalmente no: está detrás de tu firewall |
| **Qué necesita Payana** | Credenciales de la API | Credenciales de la API **y** un camino de red hacia tu servidor |

<Warning>
  Que tu servidor esté en AWS, Azure o Google Cloud **no significa que tu ERP sea "nube"** para efectos de la integración. Si lo instaló y lo opera tu empresa o un partner (por ejemplo, un modelo *lift and shift*), técnicamente sigue siendo on-premise. Lo que importa es si el ERP está disponible en internet o solo dentro de una red privada.
</Warning>

Si no lo tienes claro, pregúntale a tu equipo de IT o al partner que administra tu ERP. Es la primera definición del proyecto: elegir mal el modelo lleva a diseñar una conexión que después no se puede construir.

### Cómo suelen estar desplegados los ERPs que integramos

| ERP | Despliegue habitual |
| :- | :- |
| NetSuite | Nube |
| Oracle Fusion Cloud ERP | Nube |
| Siigo Nube | Nube |
| Dynamics 365 Finance & Operations | Nube (es la versión que cubre la guía actual). También soportamos on-premise, con una alineación previa con tu equipo técnico |
| Dynamics 365 Business Central | Nube (es la versión que cubre la guía actual) |
| Odoo | Nube (Odoo.com, Odoo.sh) o en servidores propios (*self-hosted*) |
| Siesa | Nube (Siesa Cloud) u on-premise |
| SAP Business One | Generalmente on-premise o en la nube privada de un partner |
| SAP S/4HANA | Depende de la edición: Cloud Public Edition es nube; Private Cloud (RISE) y On-Premise se integran como on-premise |
| SAP ECC y SAP R3 | Servidores propios o de un proveedor; siempre a través de un middleware |

<Note>
  Siigo Pyme, Siigo Contador y WorldOffice funcionan con plantilla de carga masiva: no requieren ninguna conexión de red entre Payana y tu ERP.
</Note>

## Cómo funciona la conexión en cada caso

<Tabs>
  <Tab title="ERP en la nube">
    ```mermaid theme={null}
    flowchart LR
        Payana -->|"HTTPS + credenciales de API"| ERP["Tu ERP (URL del fabricante)"]
    ```

    Payana se conecta directo a la API de tu ERP por internet, con las credenciales que tu equipo genera para la integración. No hay que configurar VPN, firewall ni middleware.

    Tu equipo solo tiene que:

    1. Crear el usuario o la aplicación de integración en el ERP.
    2. Darle los permisos que indica la guía de tu ERP.
    3. Entregarnos las credenciales por un canal seguro.
  </Tab>

  <Tab title="ERP on-premise">
    ```mermaid theme={null}
    flowchart LR
        Payana -->|"Camino de red seguro"| Red["Tu red privada"] --> ERP["API de tu ERP"]
    ```

    Tu ERP no está disponible en internet, así que Payana no puede llegar a él por sí sola. Antes de conectar, tu equipo tiene que resolver tres cosas:

    1. **Habilitar la API del ERP** y verificar que responde. Por ejemplo, la Service Layer en SAP Business One o los servicios OData en SAP S/4HANA.
    2. **Abrir un camino de red** entre Payana y esa API. Las opciones están en la siguiente sección.
    3. **Crear el usuario de integración** y entregarnos las credenciales por un canal seguro.
  </Tab>
</Tabs>

## Opciones de conectividad para un ERP on-premise

Hay tres formas de abrir el camino de red. Tu equipo de IT elige la que se ajuste a sus políticas de seguridad.

| | Endpoint público + whitelist | VPN site-to-site | A través de tu middleware |
| :- | :- | :- | :- |
| **Qué se hace** | Se publica la API del ERP en internet y solo se permite el tráfico desde las IPs de Payana | Se crea un túnel cifrado entre tu red y la nube de Payana | Payana se conecta a tu capa de integración, que traduce las llamadas hacia el ERP |
| **Qué se expone a internet** | Un puerto o URL, limitado a las IPs de Payana | Nada: el tráfico viaja dentro del túnel | El endpoint del middleware |
| **Cuándo conviene** | Es la opción más rápida de implementar | Cuando tu política de seguridad no permite publicar el ERP | Cuando ya tienes un middleware, o cuando el ERP lo exige (por ejemplo, SAP ECC y SAP R3) |
| **Coordinación necesaria** | Tu equipo de redes configura el firewall | Reunión técnica entre tu administrador de redes y el equipo de ingeniería de Payana | Tu equipo o tu partner desarrolla y despliega las interfaces |

<Tabs>
  <Tab title="Endpoint público + whitelist">
    <Steps>
      <Step title="Publica la API del ERP">
        Configura tu firewall para permitir tráfico entrante HTTPS hacia la API del ERP (o hacia el middleware que la expone).
      </Step>

      <Step title="Permite solo las IPs de Payana">
        Crea una regla para que **solo** las IPs fijas de Payana puedan conectarse. Te compartimos las IPs de producción y las de pruebas durante el onboarding.
      </Step>

      <Step title="Usa un certificado SSL válido">
        Configura un certificado válido para el dominio. Si tu ERP usa un certificado autofirmado, avísanos antes de las pruebas.
      </Step>
    </Steps>
  </Tab>

  <Tab title="VPN site-to-site">
    Se configura un túnel VPN site-to-site (IPSec) entre tu firewall o router corporativo y la nube de Payana. Requiere una reunión técnica entre tu administrador de redes (o el de tu partner) y el equipo de ingeniería de Payana.

    Para preparar esa reunión, ten a mano:

    * La IP pública fija del equipo donde se configura la VPN (firewall o router).
    * La marca y el modelo de ese equipo (por ejemplo, Fortinet, Cisco o Palo Alto).
    * La IP privada o la subred del servidor del ERP, y los rangos internos que Payana debe poder alcanzar.
    * Los puertos y protocolos de la API del ERP.
    * El tipo de ruteo que prefieres: estático o dinámico (BGP, con su número de ASN).
    * Si hay NAT de tu lado de la red.
    * Los requisitos de cifrado IPSec/IKE de tu empresa, si los tienes.
    * Un contacto técnico para coordinar la configuración.

    Con esa información, Payana configura su lado del túnel y te comparte los parámetros para que tu equipo configure el suyo.

    <Tip>
      Que el túnel figure como activo no garantiza la conexión. Tu equipo también tiene que rutear la red de Payana a través del túnel y permitir en el firewall el tráfico desde esa red hacia el puerto de la API del ERP, y las respuestas de vuelta.
    </Tip>
  </Tab>

  <Tab title="A través de tu middleware">
    Si tu empresa ya usa una herramienta de integración (por ejemplo, SAP Integration Suite, SAP PI/PO, MuleSoft, Dell Boomi o un desarrollo propio), Payana puede conectarse a ella en vez de conectarse directo al ERP. El middleware se encarga de la autenticación hacia afuera y de traducir cada llamada al formato que entiende tu ERP.

    Ten en cuenta que:

    * El middleware también tiene que estar disponible para Payana: en la nube, con endpoint público y whitelist, o por VPN.
    * Las interfaces del middleware las construye y despliega **tu equipo o tu partner**. Si más adelante quieres integrar un dato nuevo, también pasa por su ciclo de desarrollo.
  </Tab>
</Tabs>

<Note>
  Si ninguna opción es clara o viable para tu empresa, agenda una reunión técnica con el equipo de onboarding de Payana para definir el camino.
</Note>

## Qué cambia para tu equipo si el ERP es on-premise

* **Participa tu equipo de IT o tu partner.** La configuración de red, la API y los permisos dependen de ellos, no solo del equipo de finanzas.
* **La API tiene que estar activa.** Muchas instalaciones on-premise tienen la API apagada o bloqueada por el firewall. Antes de entregarnos las credenciales, verifica que responde desde fuera de tu red.
* **El usuario de integración tiene que ser dedicado.** No uses un usuario personal. Configúralo para que su contraseña no caduque o define cómo se va a rotar: cuando cambie, puedes [actualizar las credenciales](/integraciones-erps/actualizar-credenciales) desde Payana.
* **Conviene tener un ambiente de pruebas.** Si tu ERP tiene un ambiente de pruebas (sandbox, desarrollo o QA), validamos ahí la conexión antes de pasar a producción.

## Quién hace qué

| Tarea | Tu equipo (IT o partner) | Payana |
| :- | :- | :- |
| Confirmar si el ERP es nube u on-premise | ✓ | |
| Habilitar la API del ERP y verificar que responde | ✓ | |
| Crear el usuario de integración y sus permisos | ✓ | |
| Compartir las IPs fijas de Payana | | ✓ |
| Configurar el firewall o la whitelist | ✓ | |
| Configurar la VPN site-to-site | ✓ (su lado del túnel) | ✓ (su lado del túnel) |
| Desarrollar y desplegar interfaces en el middleware, si aplica | ✓ | Define qué datos necesita |
| Entregar las credenciales por un canal seguro | ✓ | |
| Probar la conexión y configurar la integración en Payana | Acompaña | ✓ |

<Warning>
  Nunca compartas contraseñas, secretos o parámetros de la VPN por email o chat. Coordina con nuestro equipo un canal seguro para el intercambio.
</Warning>

## Preguntas para tu equipo de IT

Con estas respuestas definimos la mejor forma de conectarnos. Las guías de cada ERP incluyen un cuestionario más detallado.

<AccordionGroup>
  <Accordion title="Despliegue">
    1. ¿Dónde está alojado tu ERP? En la nube del fabricante, en servidores propios, en un data center o en la nube de un partner.
    2. ¿Qué versión o edición del ERP usan?
    3. ¿Tienen un partner que administre el ERP? ¿Quién es y cómo se coordina un cambio técnico con él?
  </Accordion>

  <Accordion title="Conectividad">
    4. ¿La API del ERP puede estar disponible a través de un endpoint público?
    5. ¿Necesitan agregar las IPs de Payana a una whitelist para aceptar el tráfico?
    6. Si no se puede usar un endpoint público, ¿pueden configurar una VPN site-to-site contra la red de Payana?
    7. ¿Tienen un middleware o herramienta de integración? ¿Cuál?
  </Accordion>

  <Accordion title="Ambientes">
    8. ¿El ERP tiene ambientes de prueba? ¿Tienen datos parecidos a los de producción?
  </Accordion>
</AccordionGroup>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Tienen integración con mi ERP si está on-premise?">
    Para los ERPs que integramos de forma nativa, sí: lo que cambia es la conectividad, no la integración. Tu equipo tiene que habilitar la API y resolver una de las [opciones de conectividad](#opciones-de-conectividad-para-un-erp-on-premise).

    La excepción son las versiones on-premise de algunos ERPs, cuya guía todavía no está documentada. En ese caso, escríbenos y lo validamos con tu equipo de IT en una reunión técnica.
  </Accordion>

  <Accordion title="Tengo Dynamics 365 Finance & Operations en servidores propios. ¿Funciona?">
    Sí, también soportamos Dynamics 365 F\&O on-premise. La [guía de Dynamics 365 F\&O](/integraciones-erps/dynamics-fo) describe la versión en la nube; si tu instancia está instalada en servidores propios, hace falta una alineación con tu equipo técnico para definir cómo se conecta Payana. Agenda una reunión técnica con el equipo de onboarding.
  </Accordion>

  <Accordion title="Mi ERP está en AWS o Azure. ¿Es nube?">
    No necesariamente. Si tu empresa o un partner instaló y opera el ERP en esa infraestructura, se integra como on-premise. Es "nube" cuando el fabricante del ERP lo ofrece como servicio y lo opera por ti.
  </Accordion>

  <Accordion title="¿Payana instala algo en mis servidores?">
    No. En las tres opciones de esta página, Payana se conecta a la API de tu ERP o a tu middleware. Lo que configura tu equipo es la red (firewall o VPN) y el acceso a la API.
  </Accordion>

  <Accordion title="¿Es seguro abrir mi ERP a Payana?">
    Cada opción limita quién puede conectarse. Con whitelist, solo las IPs fijas de Payana pueden llegar a tu API. Con VPN, el tráfico viaja cifrado dentro de un túnel y tu ERP no se publica en internet. En todos los casos, Payana usa un usuario de integración dedicado, con los permisos que tú defines.
  </Accordion>

  <Accordion title="Mi ERP no está en la lista de integraciones. ¿Qué opciones tengo?">
    Tu equipo de tecnología puede integrarlo con la API de Payana. En ese modelo, tu sistema le envía a Payana los datos maestros y recibe los comprobantes por webhook: Payana no accede a tu ERP, así que no hace falta abrirle tu red. Por eso, en este modelo no importa si tu ERP está en la nube u on-premise: Payana solo habilita los endpoints y tu equipo es quien los llama. Revisa la guía [Registro de facturas en ERPs externos](/api-reference/guias-de-integracion/registro-de-facturas-erp).
  </Accordion>
</AccordionGroup>

## Guías por ERP

<CardGroup cols={2}>
  <Card title="SAP Business One" href="/integraciones-erps/sap-b1">
    Service Layer, endpoint público o VPN site-to-site.
  </Card>

  <Card title="SAP S/4HANA" href="/integraciones-erps/sap-4hana">
    Cloud Public, Private Cloud (RISE) y On-Premise.
  </Card>

  <Card title="SAP ECC" href="/integraciones-erps/sap-ecc">
    Integración a través de middleware y BAPIs.
  </Card>

  <Card title="SAP R3" href="/integraciones-erps/sap-r3">
    Integración a través de middleware y BAPIs.
  </Card>

  <Card title="Dynamics 365 Finance & Operations" href="/integraciones-erps/dynamics-fo">
    OData con Microsoft Entra ID.
  </Card>

  <Card title="Dynamics 365 Business Central" href="/integraciones-erps/dynamics-bc">
    API REST con Microsoft Entra ID.
  </Card>

  <Card title="Odoo" href="/integraciones-erps/odoo">
    Odoo.com, Odoo.sh o self-hosted.
  </Card>

  <Card title="Siesa" href="/integraciones-erps/siesa">
    Connekta o Apigee.
  </Card>

  <Card title="NetSuite" href="/integraciones-erps/netsuite">
    Token-Based Authentication.
  </Card>

  <Card title="Oracle Fusion" href="/integraciones-erps/oracle-fusion">
    REST APIs con OAuth 2.0.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.