# Aplicaciones para otras empresas

Qué es una aplicación del catálogo, cómo se publica desde la consola de desarrolladores y cómo llega a cada empresa con sus propias credenciales.

Una aplicación del catálogo es una aplicación tuya que cualquier empresa de UTILIA OS puede instalar desde **Ajustes › Aplicaciones › Explorar**. La creas y la publicas desde la [consola de desarrolladores](https://os.utilia.ai/docs/developers/console/overview), con tu cuenta de desarrollador. La empresa ve su ficha, acepta lo que podrá hacer y elige con qué persona actuará; UTILIA OS entrega entonces a tu servidor unas credenciales propias de esa instalación. Tú no ves ninguna clave de la empresa y la empresa no ve ninguna clave tuya.

## En qué se diferencia de lo demás

**Dos formas de que una empresa use una aplicación**

### Creada por la empresa (Una empresa, una clave)

La empresa crea la aplicación en Ajustes › Creadas por tu empresa, le concede permisos y usa su clave con sus propios datos: su web, su programa o su producto.

### Instalada del catálogo (Una clave por instalación)

La publicas tú desde la consola de desarrolladores, con una ficha que revisa UTILIA. Cada empresa que la instala recibe su propia instalación, con su clave y su clave de firma, que solo llegan a tu servidor.

Hay otras dos formas de conectar software con UTILIA OS que no pasan por el catálogo:

- **Una clave de API de la organización** (`utk_…`), para los scripts y automatizaciones de una empresa con sus propios datos. No se publica ni se instala. Ver [Claves de API de la organización](https://os.utilia.ai/docs/developers/organization-api-keys/overview).
- **Conectar una IA por MCP**, para que un asistente trabaje con los datos de una persona, con su inicio de sesión. Ver [Primeros pasos con MCP](https://os.utilia.ai/docs/developers/mcp/quickstart).

Si dudas entre ellas, [Elegir credencial](https://os.utilia.ai/docs/developers/getting-started/choose-credential) lo resuelve con un árbol de decisión.

## Dónde se publica

Se publica desde la consola de desarrolladores, en `platform.os.utilia.ai`, con una **cuenta de desarrollador** aparte de tu empresa. Desde ella creas la aplicación, preparas su ficha, la pruebas en empresas de prueba, la envías a revisión y ves quién la instala. Cómo se crea la cuenta está en [Crear tu cuenta y entrar en la consola](https://os.utilia.ai/docs/developers/console/signup).

**Consola de desarrolladores · Acme Recordatorios**

Pestañas: Resumen, Ficha, Revisión, Precio, Conexión y Claves.

1. El nombre de la aplicación y el estado de su ficha: Borrador, En revisión, Publicada…
2. Resumen, Ficha, Revisión, Precio, Conexión, Claves, Avisos, Registros, Pruebas, Instalaciones y Ventas. Cada persona ve las que su rol le deja abrir.
3. Lo siguiente: el paso que toca, como completar la ficha, probarla o enviarla.
4. Desactivar la aplicación: deja de llamar a la API y de recibir avisos en el acto, también en las empresas que la tienen instalada. No se borra nada.

_Cada pestaña es su propia dirección: un aviso o un enlace te lleva a la pestaña exacta._

Si tu empresa ya tiene una integración propia en «Creadas por tu empresa» y quieres ofrecerla a otras, su menú tiene **Publicar en el catálogo de UTILIA OS**: te lleva a la consola, que prepara la ficha con sus datos sin copiar ninguna clave. Lo explica [Vincular la consola con tu empresa](https://os.utilia.ai/docs/developers/console/company-link).

## Cómo llega a cada empresa

**De tu ficha a la primera instalación**

1. [**Tu ficha**](https://os.utilia.ai/docs/developers/apps-platform/listing) (Consola de desarrolladores): Textos, imágenes, permisos, direcciones, datos y precio.
2. [**UTILIA la revisa**](https://os.utilia.ai/docs/developers/apps-platform/review) (Revisión): Una persona de UTILIA comprueba la ficha y la instala. Si no: te pedimos cambios o la rechazamos, con el motivo.
3. **Una empresa la instala** (Ajustes › Aplicaciones › Explorar): Acepta los permisos y elige la persona responsable.
4. [**Tu servidor canjea el código**](https://os.utilia.ai/docs/developers/apps-platform/installation-and-exchange) (API externa): Recibe la clave y la clave de firma de esa instalación, una sola vez. Si no: a los 30 minutos la instalación queda en Falta conectar.
5. [**Trabajas con su clave**](https://os.utilia.ai/docs/developers/apps-platform/webhooks) (API y avisos): Llamas a la API y recibes los avisos de esa empresa.

_La revisión ocurre una vez por versión; el canje, una vez por instalación._

## Qué recibe tu servidor

Por cada empresa que instala tu aplicación, tu servidor recibe una **instalación**: su identificador, el de la empresa y su nombre, los permisos que concedió, los avisos que le llegarán y dos credenciales:

- **La clave de API de la instalación** (`utl_…`), que va en la cabecera `X-Api-Key` de cada llamada a la [API externa](https://os.utilia.ai/docs/developers/api). Actúa con los permisos de la persona responsable que eligió la empresa, recortados por los permisos que concedió, por su plan y por los datos que esa persona puede ver. Nunca con más.
- **La clave de firma de los avisos** de esa instalación, con la que compruebas que cada aviso viene de UTILIA OS.

Las dos se entregan **una sola vez**, al canjear el código de la instalación. Lo explica [La instalación y el canje del código](https://os.utilia.ai/docs/developers/apps-platform/installation-and-exchange).

**Lo que conviene recordar**

- Validez del código de instalación: 30 minutos
- Veces que se entregan las credenciales: 1. Si se pierden, la empresa vuelve a conectar.
- Permisos que puede pedir una ficha: 26. Una lista cerrada: nada que mueva dinero.

## Gratis o de pago

Cada ficha tiene un modelo de precio: **Gratis**, **Necesita cuenta en tu servicio**, si conecta con un servicio que la empresa contrata aparte, o **De pago en UTILIA**. Las de pago se compran dentro de UTILIA OS. UTILIA las vende por tu cuenta, factura a cada empresa y te transfiere tu parte, que es el precio sin impuestos menos la comisión de UTILIA, del 10 %, y las comisiones de Stripe. Lo cuenta [Cómo se venden tus aplicaciones](https://os.utilia.ai/docs/developers/pricing-and-payouts/overview).

## Lo que el catálogo no permite

Una aplicación del catálogo solo puede pedir los permisos de una [lista cerrada](https://os.utilia.ai/docs/developers/apps-platform/permissions). Ninguna puede mover dinero, emitir, enviar ni anular facturas, ver los datos fiscales de los clientes ni gestionar las claves o los avisos de la empresa que la instala. Si tu producto necesita algo de eso con una empresa concreta, esa empresa crea su propia aplicación y le concede ella esos permisos, bajo su control.

Toda ficha que vayan a ver otras empresas pasa una revisión humana de UTILIA, sea «Pública» o «Solo con el enlace», y también cada versión nueva: lo detalla [Revisión de la ficha](https://os.utilia.ai/docs/developers/apps-platform/review).

Lo que ve la empresa que instala está en [Explorar e instalar aplicaciones](https://os.utilia.ai/docs/guides/integrations/explore-and-install).
