Revisión y directorio

Los estados de una app#

Enviar#

1. 1

   Completar la lista de comprobación

   Solo puedes enviarla cuando todo esté hecho: nombre (de 2 a 60 caracteres), logo, descripción, web, dirección de la política de privacidad, e-mail de soporte, al menos una URI de redirección válida (una dirección https en una app confidencial), una conexión con tu negocio de prueba, al menos una solicitud con estado 2xx en los últimos 14 días y, si tu app tiene un webhook, al menos una entrega correcta en los últimos 30 días.

   Consola › App › Revisión

2. 2

   Enviar a revisión

   El estado pasa a «En revisión». Durante ese tiempo la app no se puede editar. Mientras Flavoso no haya decidido, «Retirar el envío» la devuelve a desarrollo.

   Consola › App › Revisión

3. 3

   Esperar la decisión

   Normalmente, unos pocos días laborables. La decisión llega por e-mail; si es un rechazo, incluye el motivo. En ese caso, editas la app y la vuelves a enviar.

Qué se revisa#

• Los datos están completos y las direcciones son accesibles.
• El nombre y el logo no inducen a error: ninguna marca de terceros, nada que dé a entender que la app es de Flavoso.
• La app solo solicita los permisos que necesita para su finalidad.

Lista de comprobación antes de enviar#

• Has probado todo el flujo con el negocio de prueba: conectar, pedidos, carta, casos de error, desconectar.
• Los tokens están cifrados en tu servidor, y el client secret nunca está en una app ni en el navegador.
• El token de actualización de cada conexión se renueva en un único sitio, y siempre se guarda el nuevo.
• Las firmas de los webhooks se comprueban y los duplicados se reconocen por el id.
• Cada POST lleva una Idempotency-Key; los 429 y 5xx se reintentan con pausas cada vez mayores.
• livemode: false nunca acaba en datos reales.
• app.disconnected e invalid_grant al renovar llevan a un aviso claro con «Volver a conectar»; unauthorized_client muestra «bloqueada temporalmente» y conserva los tokens.
• Tu software muestra con qué negocio está conectado y puede desconectarse (DELETE /connection).
• Alguien lee la dirección de soporte.

Después de la aprobación#

Una vez aprobada tu app, cualquier propietario puede conectarla, y la pantalla de consentimiento muestra «Revisada por Flavoso».

• Se aplican al momento: los cambios en la descripción y en el e-mail de soporte, y la eliminación de una URI de redirección.
• Esperan una nueva revisión: el nombre, el logo, la web, la dirección de la política de privacidad, las URI de redirección nuevas, los permisos adicionales y los datos nuevos del directorio (categoría, lema, dirección de instalación). Hasta entonces se aplica la versión revisada.

El directorio de apps#

Toda app aprobada aparece en el directorio de apps, donde los negocios la encuentran: en el panel, en Ajustes, Integraciones, y públicamente en flavoso.com/<idioma>/integrations. Así un negocio ve con qué puede conectarse. La ficha se gestiona en los ajustes de tu app y forma parte de la lista de comprobación antes de enviarla a revisión:

En el directorio solo aparecen apps aprobadas, y aparecen todas. Una app aprobada no se puede retirar del directorio; si ya no quieres ofrecerla, elimínala. Si una app se bloquea, su ficha desaparece.

La marca Flavoso#

• Escribe Flavoso así: una sola palabra, con F mayúscula. No lo uses en el nombre de tu app de forma que parezca un producto de Flavoso («Flavoso Caja»); «Caja X para Flavoso» sí está bien.
• El logo de Flavoso no es el icono de tu app.
• «Revisada por Flavoso» solo lo muestra Flavoso, en la pantalla de consentimiento y en el directorio. No afirmes ninguna asociación, certificación o recomendación que no exista.
• El botón se llama «Conectar con Flavoso» (para otros idiomas, consulta Autenticación).

Bloqueo#

Si una app infringe las condiciones para desarrolladores o se usa de forma abusiva, Flavoso puede bloquearla. A partir de entonces sus tokens se rechazan con 401, las entregas se omiten y nadie puede volver a conectarla. Sus conexiones se mantienen: si Flavoso levanta el bloqueo, todo sigue funcionando.

Durante ese tiempo, el endpoint de token responde a una renovación con 400 unauthorized_client, no con invalid_grant. Conserva los tokens, muestra «bloqueada temporalmente» y vuelve a intentarlo más tarde. Pueden faltar eventos del periodo del bloqueo, incluso en GET /events, sin que gap lo indique. Por eso, cuando termine el bloqueo, concilia los datos a través de las listas, por ejemplo con GET /orders?updated_since=….

Eliminar una app#

Puedes eliminar tu app en sus ajustes. Así terminan todas sus conexiones y ningún token de la app sigue siendo válido. No se puede deshacer; para empezar de nuevo, crea una app nueva.