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, contenido con IA, identificadores de catálogo, distribución previa 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, contenido con IA, identificadores de catálogo, distribución previa 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
Contenido con IA: si ha declarado el uso de IA, y la música o las portadas generadas con IA que detectamos
Identificadores de catálogo: si sus ISRC son válidos y si otra parte ya ha reclamado los derechos de una grabación
Distribución previa: si el lanzamiento o sus pistas ya están en tiendas a través de otra distribuidora
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 marca el informe actual como obsoleto: los resultados ya no reflejan el último estado de su lanzamiento. Edite tanto como quiera y, después, solicite un nuevo análisis desde la página del lanzamiento en la aplicación o a través del endpoint de actualización para integraciones. El análisis se vuelve a ejecutar y el informe se actualiza con los nuevos resultados. Puede repetir este ciclo tantas veces como necesite, dentro de un límite de uso justo sobre cuántos análisis nuevos puede iniciar por lanzamiento y hora.

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 un análisis completo y actualizado: si ha editado el lanzamiento después de la última ejecución, el informe queda obsoleto, así que solicite un nuevo análisis y deje que termine 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.
Evidencia	En los problemas de fechas, duplicados y distribución previa, los lanzamientos coincidentes que encontramos, para que pueda comprobar usted mismo el conflicto (véase más abajo).

Bloqueante frente a informativo

Los problemas bloqueantes deben resolverse antes de que pueda confirmar el lanzamiento para revisión. Corrija lo que describan, ejecute un nuevo análisis 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.

Evidencia en un problema

Algunos problemas incluyen evidencia para ayudarle a comprobar un aviso sin conjeturas: los lanzamientos existentes que coincidieron con el suyo. La verá en los problemas de fechas, duplicados y distribución previa. Cada coincidencia muestra el título y el artista de la pista coincidente, el título de su lanzamiento, la fecha de lanzamiento y el ISRC, además de un enlace a una tienda donde ese lanzamiento está disponible, y a cuáles de sus pistas afecta. Se enumeran hasta tres coincidencias por pista. Use la evidencia para confirmar si el conflicto es real (por ejemplo, una subida anterior suya) antes de decidir cómo responder.

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.
stale	`true` cuando ha editado el lanzamiento (o cualquiera de sus pistas) después del último análisis completado, de modo que los resultados ya no reflejan el estado actual. Cualquier edición cuenta. Solicite un nuevo análisis para actualizar el informe.
hold	Si el lanzamiento está actualmente en la espera previa a la revisión.
review_status	El estado de revisión actual del lanzamiento.
release_status	El estado general del propio lanzamiento, junto al estado específico de la revisión.
profile	El perfil de calidad aplicado a este lanzamiento, con su nombre y versión.

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 tres endpoints para ello, todos 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.

Webhook: sepa cuándo el informe está listo

En lugar de consultar los resultados de forma periódica, puede hacer que LabelGrid le avise en el momento en que un informe está listo. Suscríbase al evento de webhook release.preflight.report_ready: se dispara en cuanto Preflight QC termina de analizar un lanzamiento en la espera previa a la revisión, incluida cada vez que se completa un nuevo análisis que usted solicita. Recibe exactamente un evento por ciclo de análisis.

Suscríbase igual que a los demás eventos de webhook de lanzamientos de LabelGrid, desde la configuración de webhooks en la aplicación o a través de la API. Cada evento lleva un resumen compacto de la ejecución, nunca los propios problemas:

Identificadores del lanzamiento: release_id, label_id, release_cat y release_title.
generated_at: cuándo se generó este informe. Coincide con el propio generated_at del informe.
profile: el perfil de calidad con el que se calcularon los recuentos, como {name, version}.
counts: los totales blocking, informational y requires_feedback. El recuento requires_feedback se solapa con los otros dos.

Use los recuentos para decidir si necesita actuar y, después, recupere el informe en sí para ver el detalle. El patrón de integración recomendado:

Suscríbase a release.preflight.report_ready.
En cada evento, llame a Obtener el informe de calidad para leer el conjunto completo de problemas.
Corrija y vuelva a ejecutar: tras editar un lanzamiento en espera, llame al endpoint de actualización para iniciar un nuevo análisis; el webhook se dispara de nuevo cuando se completa.
Decida y confirme desde sus propias herramientas una vez que el lanzamiento supere su listón.

Para la referencia completa del payload y el funcionamiento de los webhooks (la firma, los reintentos y el sobre), consulte Webhooks.

Obtener el informe de calidad

GET /api/public/releases/{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 id, code (una cadena estable; consulte Trabajar con los códigos de problema), title, message, status, severity, is_blocking, requires_feedback, custom_description y affected_tracks. En los problemas de fechas, duplicados y distribución previa, la entrada lleva además un array evidence (véase más abajo).
report: generated_at, checks_in_progress, stale, hold, review_status, release_status y profile (un objeto con name y version). stale es true cuando el lanzamiento o cualquiera de sus pistas se editó después del último análisis completado; vuelva a ejecutar el análisis con el endpoint de actualización antes de confirmar.

Mientras el análisis sigue en curso, el informe devuelve checks_in_progress: true con una lista issues vacía. Si prefiere no usar webhooks, consulte este 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. Para que se le avise en el momento en que el informe esté listo, use el webhook de informe listo.

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

{
  "issues": [
    {
      "id": "12345",
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "status": "confirmed",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456],
      "evidence": [
        {
          "affected_track_id": 456,
          "track_title": "Matched track title",
          "artist": "Matched artist",
          "release_title": "Matched release",
          "release_date": "2024-03-01",
          "isrc": "USRC12345678",
          "store_url": "https://…"
        }
      ]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "stale": false,
    "hold": true,
    "review_status": "…",
    "release_status": "…",
    "profile": { "name": "quality_report", "version": 2 }
  }
}

Cada elemento de evidence describe un lanzamiento existente que coincidió con el suyo: affected_track_id (a cuál de sus pistas se aplica la coincidencia), el track_title, artist, release_title, release_date e isrc coincidentes, y un store_url que apunta a una página de tienda donde la coincidencia está disponible. Se enumeran como máximo tres coincidencias por pista, y la clave solo está presente en los tipos de problema anteriores.

Solicitar un nuevo análisis

POST /api/public/releases/{id}/quality-report/refresh
Authorization: Bearer YOUR_API_TOKEN

Inicia un nuevo ciclo de análisis de Preflight QC para un lanzamiento en espera. Editar un lanzamiento en espera no vuelve a ejecutar las comprobaciones por sí solo: solo marca el informe actual como obsoleto (report.stale: true). Cuando termine de editar, llame a este endpoint para volver a ejecutar el análisis; cuando el ciclo se completa, el webhook de informe listo se dispara y report.stale vuelve a false.

Una llamada correcta devuelve 202 Accepted:

{
  "status": "refreshing",
  "checks_in_progress": true,
  "review_status": "pending_customer_review",
  "release_status": "to_review"
}

La llamada es idempotente mientras hay un ciclo en curso: volver a llamarla devuelve el mismo cuerpo en progreso, no pone en cola un segundo análisis y no cuenta contra su presupuesto. Otras respuestas que debería gestionar:

409 not_in_customer_review_hold: el lanzamiento no está actualmente en espera para su revisión de Preflight QC.
409 refresh_coalesced: un análisis de este lanzamiento se completó hace un momento, así que no se puso nada en cola. Reintente después de lo indicado en la cabecera Retry-After (segundos).
429 preflight_recheck_limit_reached: ha alcanzado el presupuesto de uso justo de 6 ciclos de análisis iniciados por lanzamiento y hora móvil. La cabecera Retry-After (segundos) le indica cuándo se permite la siguiente actualización. Consultar un análisis en curso es gratis; solo iniciar un nuevo ciclo consume presupuesto.
403 RELEASE_NOT_VALIDATED: el lanzamiento debe superar la validación antes de que pueda iniciarse un nuevo análisis (la misma regla que para distribuir); ejecute la validación primero.
403 pre_review_qc_not_enabled: Preflight QC no está activado para la cuenta propietaria.

Confirmar el lanzamiento para revisión

POST /api/public/releases/{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 un análisis completo y actualizado. Dos conflictos que gestionar:

409 checks_in_progress: el análisis sigue en curso. Espere al webhook de informe listo (o consulte periódicamente hasta que generated_at tenga un valor) y luego reintente.
409 checks_stale: el lanzamiento se editó después del último análisis completado (report.stale es true). Llame al endpoint de actualización, espere al nuevo informe y luego 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, contenido con IA, identificadores de catálogo, distribución previa, 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 /api/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, requires_feedback y su categoría (type). La respuesta también incluye el perfil de calidad con el que se calculó el catálogo, como {name, version}. 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. A través de la API puede suscribirse al webhook de informe listo para recibir una notificación en el momento en que esté listo, o consultarlo periódicamente hasta que generated_at tenga un valor.

¿Puedo editar mi lanzamiento mientras está en espera?

Sí, edite con total libertad: un lanzamiento en la espera previa a la revisión sigue siendo totalmente editable. Editar no vuelve a ejecutar las comprobaciones por sí solo; marca el informe actual como obsoleto. Cuando termine sus cambios, solicite un nuevo análisis (desde la página del lanzamiento en la aplicación o el endpoint de actualización para integraciones) para ver los resultados actualizados sin salir de la espera. El nuevo análisis debe completarse antes de que pueda 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.

¿Aún no usas LabelGrid?

Todo lo que acabas de leer está disponible en nuestra plataforma.

Descubre lo que LabelGrid puede hacer →