# Versiones de la ficha y cambios de permisos

Las versiones de una ficha publicada, qué cambia en cada empresa al aprobar una nueva, cómo pedir más o menos permisos y cómo retirarla del catálogo.

Una ficha aprobada queda **publicada** con esa versión congelada. Cualquier cambio posterior, hecho en la consola de desarrolladores, prepara la versión siguiente, que vuelve a revisión mientras las empresas siguen viendo, instalando y, si es de pago, comprando la publicada. Esta página explica qué cambia en las empresas que ya tienen tu aplicación cuando se aprueba una versión nueva.

## Cómo funcionan las versiones

- **Solo hay una versión abierta a la vez**: un borrador o una en revisión. Cambiar una ficha publicada crea la versión siguiente, copiada de la última. La consola te lo dice encima de la ficha: «Lo que cambies prepara la versión 4. La publicada sigue disponible mientras tanto.»
- **Lo enviado no se cambia.** Para corregir una versión en revisión, se cancela el envío; para corregir una ya decidida, se crea otra.
- **Al aprobarse, sustituye a la anterior**, que queda en el historial como «Sustituida por la versión 4». Las empresas que tienen instalada tu aplicación pasan a ver la ficha nueva.
- **Novedades de esta versión** es lo que leen esas empresas: escribe lo que cambia para ellas.

Antes de cambiar algo que la ficha declara (permisos, datos que guardas, para qué, dónde, proveedores de IA, direcciones, avisos, modelo de precio, planes, precios o prueba gratis), envía la versión nueva y espera a su aprobación: tu aplicación tiene que seguir haciendo lo que dice la versión publicada. Cómo afectan los cambios de precio a quien ya está suscrito está en [Modelos de precio y planes](https://os.utilia.ai/docs/developers/pricing-and-payouts/pricing#cambiar-el-precio).

## Pedir más permisos o menos

**Una versión que pide más permisos**

1. **Envías la versión nueva** (Tu ficha): Con los permisos nuevos y su «para qué».
2. **UTILIA la aprueba** (Revisión): Ve cuántas empresas tendrán que aceptarlos.
3. **Cada empresa decide** (Instaladas): Ve «Acme pide más permisos» y decide. Si no: con Ahora no sigue con los que tenía.
4. **Recibes APP_ACCESS_CHANGED** (Tu servidor): De cada empresa que los acepta.

_Mientras una empresa no acepta, tu aplicación sigue con los permisos que tenía._

Mientras tanto, esa instalación aparece como `ACCESS_PENDING` en la API, con los permisos nuevos en `pendingScopes`. Para aceptar, la persona responsable de la empresa tiene que tener también lo que piden; si no, la empresa elige antes otra persona responsable. Algunas no aceptarán nunca: tu aplicación tiene que seguir funcionando con los permisos de antes.

Si la versión nueva **pide menos**, al aprobarse se quitan solos de todas las instalaciones y te llega `APP_ACCESS_CHANGED` con los que se quitan. Las empresas no tienen que hacer nada.

## Lo que cambia en cada instalación al aprobarla

Cuando UTILIA aprueba una versión, cada instalación que ya existe se pone al día con ella:

- la **dirección de avisos** y los **avisos que recibirá**, recalculados con los permisos que esa empresa te tiene concedidos;
- el **nombre**, la **frase corta**, la **web** y el **icono** con los que la empresa ve tu aplicación;
- los **permisos**, si la versión pide menos.

Por eso, si cambias la dirección de avisos, prepara la nueva antes de enviar: en cuanto se aprueba, todas las instalaciones avisan allí. Un aviso nuevo que dependa de un permiso que una empresa aún no te ha concedido no le llega hasta que lo acepte. La dirección de instalación es siempre la de la versión publicada: cuando una empresa vuelve a conectar, va a la vigente.

## Retirar la ficha del catálogo

**Retirar del catálogo** hace que deje de aparecer en Explorar y que ya no se pueda instalar ni comprar. Las empresas que tienen instalada tu aplicación la siguen usando, y las claves de sus instalaciones siguen funcionando, pero mientras esté retirada ninguna puede volver a conectarla. **Volver a publicar** la devuelve con la última versión aprobada, sin pasar otra vez por la revisión.

Retirar la ficha no desinstala nada. Si dejas de dar el servicio de una aplicación gratuita, avisa con al menos 30 días a las empresas que la tienen y aplica lo que dice [Desinstalación, suspensión y datos](https://os.utilia.ai/docs/developers/apps-platform/uninstall-and-data). Si es de pago, retirarla no termina las suscripciones, que siguen renovándose: para terminar la venta está «Dejar de vender», que explica [Reembolsos, disputas e impagos](https://os.utilia.ai/docs/developers/pricing-and-payouts/refunds-and-disputes#dejar-de-vender).

## Si UTILIA la suspende

UTILIA puede suspender tu aplicación en todas las empresas a la vez, por un problema de seguridad, un uso indebido de los datos, un requerimiento de una autoridad, un incumplimiento de las Normas del catálogo o porque tu cuenta de desarrollador esté suspendida. Qué pasa entonces con las instalaciones y con los datos está en [Desinstalación, suspensión y datos](https://os.utilia.ai/docs/developers/apps-platform/uninstall-and-data). Si no estás de acuerdo, recurre la suspensión desde la pestaña **Revisión**: lo explica [Revisión de la ficha](https://os.utilia.ai/docs/developers/apps-platform/review#cómo-responder-o-recurrir).