Preflight QC

Preflight QC es un complemento premium que le ofrece un control de calidad profesional de sus lanzamientos. Envíe un lanzamiento y Preflight QC lo analiza de principio a fin: metadatos, fechas de lanzamiento, audio, portada y documentación de licencias. Usted recibe un informe de calidad claro y accionable. Corrija lo que señale a su propio ritmo y, cuando esté satisfecho, confirme el lanzamiento para revisión.

Para sellos e integradores de la API, Preflight QC funciona como una pieza de construcción. Obtenga el informe de calidad de forma programática, intégrelo en su propio flujo de QA, condicione su proceso interno de aprobación a sus resultados y confirme lanzamientos para revisión de forma automática. Su equipo define el listón de calidad y Preflight QC hace el análisis.

Un lanzamiento que llega limpio avanza rápido por la revisión. Preflight QC le lleva hasta ahí antes de enviarlo.

Qué es Preflight QC

Con Preflight QC activado en su cuenta, enviar un lanzamiento para distribución no lo manda directamente a la cola de revisión. En su lugar, el lanzamiento entra en una espera previa a la revisión (“pendiente de su revisión”) mientras Preflight QC ejecuta su análisis de calidad: metadatos, fechas de lanzamiento, audio, portada y documentación de licencias. El resultado es un informe de calidad, y lo que construya sobre él depende de usted:

• Su propio flujo de trabajo de QA (API). Pase su catálogo por el análisis de calidad, obtenga el informe de forma programática en su propio flujo de QA, condicione su proceso interno de aprobación a los resultados y confirme cada lanzamiento para revisión solo cuando supere su propio listón. Consulte Uso de la API para integraciones.
• El flujo en la aplicación. Lea el informe en la página del lanzamiento, corrija lo que señale y confirme cuando esté conforme.

En ambos casos, la confirmación es lo que pasa el lanzamiento a la cola de revisión normal: nada entra en revisión hasta que usted dé el visto bueno.

Preflight QC añade una etapa de calidad antes de la revisión. No cambia lo que ocurre después: una vez que confirma, su lanzamiento pasa por el mismo proceso de validación y revisión que cualquier otro lanzamiento.

Cómo obtener Preflight QC

Preflight QC es un complemento premium que nuestro equipo activa por cuenta. Para activarlo en la suya, póngase en contacto con nuestro equipo de ventas e indíquele que desea Preflight QC.

Una vez activado, verá el nuevo paso de espera y confirmación la próxima vez que envíe un lanzamiento para distribución.

El flujo de trabajo de Preflight QC

Este es el recorrido completo de un lanzamiento con Preflight QC activado, desde el envío hasta la revisión.

1. Envíe su lanzamiento para distribución

Cree y complete su lanzamiento como de costumbre y, luego, envíelo para distribución. Con Preflight QC activado, esto no pone el lanzamiento en la cola de revisión de inmediato. En su lugar, el lanzamiento pasa a una espera previa a la revisión y se marca como pendiente de su revisión.

2. Se ejecuta el análisis de calidad

Mientras su lanzamiento está en espera, Preflight QC lo analiza de principio a fin. Cubre:

• Metadatos: títulos, artistas, créditos y otros datos del lanzamiento y de las pistas
• Fechas de lanzamiento: la configuración de fechas y las versiones del lanzamiento
• Audio: los archivos de audio que ha subido
• Portada: la imagen de portada
• Licencias: cuando una versión, un sample o algo similar necesita documentación de respaldo

El análisis suele terminar unos minutos después de que se completen la subida y la transcodificación. Mientras sigue en curso, el informe de calidad indica que las comprobaciones están en progreso y todavía no muestra ningún problema.

3. Lea su informe de calidad

Cuando el análisis termine, abra el informe de calidad del lanzamiento para ver qué necesita su atención, si es que hay algo. Puede leerlo en dos lugares:

• A través de la API pública, para su propio flujo de QA: consulte Uso de la API más abajo.
• En la aplicación, en la página del lanzamiento.

El informe enumera cada problema con un título claro y un mensaje que describe qué corregir. Consulte Cómo interpretar el informe de calidad para saber cómo leer los campos.

4. Corrija lo que se señale

Repase los problemas de su informe:

• Problemas de metadatos: edite los datos del lanzamiento o de la pista.
• Problemas de audio o portada: sustituya el archivo afectado.
• Problemas que piden una respuesta: responda en el hilo de notas del problema o suba el documento solicitado (por ejemplo, una licencia de una versión o un sample).

Editar su lanzamiento mientras está en espera vuelve a ejecutar las partes pertinentes del análisis, y el informe se actualiza con los nuevos resultados. Puede repetir este ciclo tantas veces como necesite.

5. Confirme el lanzamiento

Cuando su informe esté limpio, o haya resuelto todo lo que necesitaba, confirme el lanzamiento. En la aplicación es un botón de confirmación en el lanzamiento; para integraciones es el endpoint de confirmación.

La confirmación saca el lanzamiento de la espera y lo pasa a la cola de revisión normal. Para confirmar es necesario que el análisis esté completo: si ha editado el lanzamiento después de la última ejecución, espere al informe actualizado antes de confirmar.

6. Revisión normal

Después de confirmar, su lanzamiento se revisa igual que cualquier otro. Para saber qué ocurre durante la revisión, los tiempos de revisión y los posibles resultados, consulte Validación y revisión.

Cómo interpretar el informe de calidad

El informe de calidad tiene dos partes: una lista de problemas y un pequeño bloque de detalles del informe sobre la propia ejecución.

Problemas

Cada problema del informe describe algo que revisar. Los campos con los que trabajará:

Campo	Qué le indica
Título	Un nombre breve y en lenguaje sencillo del problema.
Mensaje	Qué es el problema y qué hacer al respecto.
Gravedad	La importancia del problema, para ayudarle a priorizar.
Bloqueante	Si el problema debe resolverse antes de que pueda confirmar (véase más abajo).
Requiere respuesta	Si el problema necesita una respuesta escrita o un documento subido por usted.
Descripción personalizada	Detalles adicionales específicos de su lanzamiento, cuando están disponibles.
Pistas afectadas	A qué pistas se aplica el problema. Los problemas a nivel de lanzamiento no enumeran pistas concretas.

Bloqueante frente a informativo

• Los problemas bloqueantes deben resolverse antes de que pueda confirmar el lanzamiento para revisión. Corrija lo que describan, deje que el análisis se vuelva a ejecutar y desaparecerán de su informe.
• Los problemas informativos están ahí para señalar algo que merece un vistazo, pero no le impiden confirmar. Revíselos y confirme cuando esté listo.

Problemas que requieren respuesta

Algunos problemas no se resuelven solo con editar: necesitan algo de usted, como una explicación escrita o un documento de respaldo (por ejemplo, una licencia de una versión o un sample). Se marcan como requiere respuesta. Para resolver uno, responda en el hilo de notas del problema o suba el documento solicitado antes de confirmar.

Los detalles del informe

Junto a los problemas, el informe incluye algunos detalles sobre la ejecución:

Campo	Qué le indica
generated_at	Cuándo se generó el informe actual. Está vacío mientras el primer análisis sigue en curso.
checks_in_progress	true mientras el análisis sigue en curso; la lista de problemas estará vacía hasta que termine.
hold	Si el lanzamiento está actualmente en la espera previa a la revisión.
review_status	El estado de revisión actual del lanzamiento.
profile	El perfil de calidad aplicado a este lanzamiento.

Uso de la API para integraciones

Si desarrolla sobre la API pública de LabelGrid, puede integrar Preflight QC en su propio pipeline: pase cada lanzamiento por el análisis de calidad, lleve el informe a su propio flujo de QA, condicione su proceso interno de aprobación a los resultados y confirme para revisión desde sus propias herramientas. Preflight QC ofrece dos endpoints para ello, ambos con la misma autenticación por token Bearer que el resto de la API pública. Para consultar los esquemas de solicitud y respuesta completos y siempre actualizados, vea la referencia de la API.

Obtener el informe de calidad

GET /v4/public/lanzamientos/{id}/quality-report
Authorization: Bearer YOUR_API_TOKEN

Devuelve el informe de calidad actual del lanzamiento. La respuesta incluye:

• issues[]: una entrada por problema, cada una con code (una cadena estable; consulte Trabajar con los códigos de problema), title, message, severity, is_blocking, requires_feedback, custom_description y affected_tracks.
• report: generated_at, checks_in_progress, hold, review_status y profile.

Mientras el análisis sigue en curso, el informe devuelve checks_in_progress: true con una lista issues vacía. Consulte el endpoint periódicamente hasta que generated_at tenga un valor, normalmente unos minutos después de que terminen la subida y la transcodificación, y luego lea los problemas.

Un ejemplo de respuesta una vez terminado el análisis:

{
  "issues": [
    {
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "hold": true,
    "review_status": "…",
    "profile": "…"
  }
}

Confirmar el lanzamiento para revisión

POST /v4/public/lanzamientos/{id}/confirm-review
Authorization: Bearer YOUR_API_TOKEN

Saca el lanzamiento de la espera y lo pasa a la cola de revisión normal: el equivalente por API del botón de confirmación de la aplicación.

Para confirmar es necesario que el análisis esté completo. Si el lanzamiento se editó después de la última ejecución del análisis, el informe se está regenerando y el endpoint devuelve un conflicto. Cuando ocurra, vuelva a solicitar el informe de calidad, espere hasta que generated_at tenga de nuevo un valor y reintente la confirmación.

Trabajar con los códigos de problema

Si construye lógica sobre el informe de calidad, básela en el code del problema:

• code es una cadena estable en formato slug (por ejemplo, audio.trailing-silence). Puede mapear los códigos en su sistema y construir lógica sobre ellos con seguridad.
• Los títulos y mensajes son textos para personas. Pueden refinarse con el tiempo, así que nunca base su lógica en el texto: úselo solo para mostrarlo.
• Pueden aparecer códigos nuevos a medida que la cobertura de Preflight QC se amplía. Trate los códigos que no reconozca de forma genérica: muestre el title y el message de la respuesta en lugar de fallar.
• Sus informes le enseñan los códigos que importan. A medida que pasa lanzamientos por Preflight QC, los códigos relevantes para su catálogo van apareciendo de forma natural en sus propios informes de calidad.
• Qué cubre el análisis. Los problemas se agrupan en estas categorías: metadatos del lanzamiento y de las pistas, fechas y versiones del lanzamiento, calidad del audio, portada, y licencias y documentación.

El catálogo de problemas

Para mapear los problemas al construir su propio flujo de trabajo de QA, recupere el catálogo completo de forma programática:

GET /v4/public/issue-definitions
Authorization: Bearer YOUR_API_TOKEN

Devuelve todos los problemas que pueden aparecer en un informe de calidad, indexados por su código de cadena estable, con el título, la plantilla del mensaje, la gravedad, el indicador de bloqueo y requires_feedback. El endpoint solo está disponible para cuentas con el complemento Preflight QC.

Preguntas frecuentes

¿Y si el análisis sigue en curso?

El informe mostrará checks_in_progress: true sin problemas enumerados todavía. Esto es normal justo después de enviar. Espere unos minutos tras completarse la subida y la transcodificación y vuelva a comprobar: en la aplicación el informe se actualiza solo y, a través de la API, puede consultarlo periódicamente hasta que generated_at tenga un valor.

¿Puedo editar mi lanzamiento mientras está en espera?

Sí. Editar un lanzamiento en la espera previa a la revisión vuelve a ejecutar las partes pertinentes del análisis y actualiza el informe, de modo que puede corregir los problemas y ver los resultados actualizados sin salir de la espera. Solo recuerde que, tras una edición, deberá esperar al informe actualizado antes de poder confirmar.

¿Qué ocurre después de confirmar?

Su lanzamiento sale de la espera y entra en la cola de revisión normal, donde se revisa como cualquier otro. Consulte Validación y revisión para saber cómo funciona la revisión, cuánto tarda y los posibles resultados.

¿Puedo devolver un lanzamiento a borrador?

Sí: mientras su lanzamiento está en la espera previa a la revisión y todavía no lo ha confirmado, no ha entrado en revisión, así que puede seguir editándolo o dejarlo como borrador y volver más tarde. Solo entra en la cola de revisión cuando usted lo confirma.

¿Tengo que corregir todos los problemas antes de confirmar?

Debe resolver los problemas bloqueantes antes de poder confirmar. Los problemas informativos no le impiden confirmar, pero merecen un vistazo: dejar todo lo posible resuelto antes de la revisión es la vía más rápida hacia la aprobación.

---

¿Preguntas sobre Preflight QC? Póngase en contacto con nuestro equipo; estaremos encantados de ayudarle.