Crea integraciones

Algunas de las apps más valiosas conectan una app SOIS existente con un servicio externo. Un ejemplo común: sincronizar facturas desde la app de contabilidad de SOIS con QuickBooks. Esta guía explica cómo una app de integración lee los datos de SOIS de forma segura y se conecta a un servicio externo.

Las apps de integración son una categoría de primer nivel. Leen los datos de otra app a través de un contrato gobernado, nunca su base de datos directamente, y solo con el consentimiento del tenant.

Dos caras de una integración

Una app de integración habla con dos cosas:

  1. Una app SOIS (por ejemplo contabilidad, almacén o contactos). Lees o escribes sus datos a través de su contrato publicado.
  2. Un servicio externo (por ejemplo QuickBooks). Lo llamas con las propias credenciales del tenant.

Declara con qué te integras

Tu proyecto declara las apps SOIS de las que depende. Esa declaración hace dos cosas: indica a SOIS qué contratos puede usar tu app, y permite al tenant ver y aprobar el acceso cuando instala tu app.

Lee los datos de SOIS a través del contrato

Tu app no toca las tablas de otra app. Lee a través del contrato de esa app, un conjunto estable de operaciones y formas de datos. Tu agente construye tu mapeo contra esas formas. Durante el desarrollo trabajas con datos de ejemplo representativos, así que puedes construir y previsualizar todo el flujo sin una conexión en vivo.

En tiempo de ejecución, el acceso está gobernado:

  • El tenant aprueba el acceso entre apps cuando instala tu app. Forma parte de los scopes que solicita tu app.
  • El contrato impone qué puede leer o escribir tu app. El aislamiento del tenant nunca se debilita.

Conecta el servicio externo

Las credenciales externas pertenecen al tenant, no a ti. Tu app declara las credenciales que necesita (por ejemplo una conexión OAuth), y cada tenant que instala aporta las suyas. Nunca retienes las credenciales de otro tenant.

Ejemplo: sincronizar facturas con QuickBooks

  1. Declara que tu app se integra con la app de contabilidad.
  2. Pídele a tu agente que lea la forma de la factura de contabilidad y construya un mapeo de una factura SOIS a una factura QuickBooks. Construye y previsualiza contra facturas de ejemplo.
  3. Declara las credenciales OAuth de QuickBooks que necesita tu app.
  4. Cuando un tenant instala tu app, aprueba el acceso a contabilidad y conecta su propia cuenta de QuickBooks.
  5. En tiempo de ejecución, tu app lee las facturas a través del contrato de contabilidad y las envía a QuickBooks con las credenciales del tenant, normalmente según una programación o un disparador.

Buenas prácticas

  • Mapea los campos de forma explícita y gestiona los casos en que un servicio externo espera datos que tu fuente no tiene.
  • Falla con suavidad. Si el servicio externo no está disponible, reintenta en lugar de perder datos.
  • Solicita solo los scopes que necesitas. Los tenants aprueban un acceso reducido más rápido y confían más en él.

Próximos pasos