> ## Documentation Index
> Fetch the complete documentation index at: https://tournaments-partners.exuratech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errores de competencias

> Cómo interpretar fallos de inscripción CRM y lectura sin duplicar participantes.

| HTTP | Caso frecuente | Acción del CRM |
| - | - | - |
| `401` | Clave CRM ausente, incorrecta o rotada | Actualiza el secreto del servidor; no reintentes con la misma clave inválida |
| `404` | UUID de competencia desconocido | Verifica el UUID entregado por el administrador |
| `409` | Inscripción cerrada, login ya registrado o evento reutilizado con otro login | Revisa la respuesta y el estado del evento; no generes otro ID para ocultar el conflicto |
| `422` | Login no existe en la conexión o cuerpo inválido | Comprueba servidor, login y datos enviados |
| `502` | Falló la verificación del login en MT5 | Reintenta con el mismo `Idempotency-Key` después de revisar MT5 |
| `503` | Conexión MT5 o historial temporalmente no disponible | Espera y reintenta según el endpoint |

Ante timeout o pérdida de respuesta de inscripción, conserva el mismo login y `Idempotency-Key` para el reintento. Cuando el servidor ya guardó el evento, devuelve el participante existente. No uses la clave CRM desde el navegador ni registres cuerpos con información sensible en logs públicos.

> [!NOTE]
>
> El ranking puede tardar hasta la siguiente sincronización del worker en reflejar una operación. `generated_at` indica cuándo respondió la API y `last_sync_at` cuándo se actualizó cada participante.

Para torneos, consulta los códigos y permisos de [Referencia API de torneos](/broker/torneos-api); su inscripción no utiliza la clave ni la idempotencia CRM de esta página.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.