# Resolución de problemas

Esta página lista los síntomas más comunes al ejecutar el SDK Demo App y cómo resolver cada uno.

| Síntoma | Resolución |
| :--- | :--- |
| `Unsupported class file major version` en la sincronización | El JDK de Gradle no es 21. Consulta el Paso 2 del [Inicio rápido](/es/getnet-toolbox/sdk-demo-app/first-steps-demo/quickstart). |
| `Could not find com.pagonxt.sdk:brazil-hml` | Falta el repositorio Maven local incluido para la variante. Confirma que `apolo-sdk-local-maven/brazil/<buildType>` existe — por ejemplo `brazil/hml` para la variante `brazilHml`. |
| El código QR sigue con las credenciales de ejemplo | La preview de Compose no se reconstruyó después de que editaste el payload. Abre `MandatoryCredentialsQrCode_Preview` o `FullCredentialsQrCode_Preview` y haz clic en **Build & Refresh**. Consulta el Paso 4 del [Inicio rápido](/es/getnet-toolbox/sdk-demo-app/first-steps-demo/quickstart). |
| Las credenciales se guardaron, pero el warm-up falla y el menú principal no aparece | El código de estado del warm-up indica la causa: `401` para `clientId` o `clientSecret` no válidos, `404` para un terminal no registrado, `400` o `422` para los valores de `terminalCode` o del sub-merchant. Consulta los errores de warm-up en la [Referencia de códigos de error](/es/getnet-toolbox/sdk-white-label/reference-sdk/error-codes). |
| La pantalla Setup no aparece y la aplicación mantiene las credenciales anteriores | Persisten en la base de datos de la aplicación después del primer guardado. Bórralas con el botón de reset en el encabezado de la pantalla **Home**, en **Settings → Apps → Apolo DevKit → Storage → Clear data**, o reinstalando la aplicación. |
| La aplicación abre, pero la venta, el reembolso o la impresión fallan | El terminal no está listo. Revisa el POS y los servicios Platform y Middleware en [Requisitos previos](/es/getnet-toolbox/sdk-demo-app/first-steps-demo/prerequisites). |
| Los colores o los recibos no cambian | Son personalizaciones de tiempo de build. Dispara un `reinitialize(…)` — un ciclo de `shutdown()` y `setup(…)` — para aplicarlas. |

## Siguientes pasos

* [Inicio rápido](/es/getnet-toolbox/sdk-demo-app/first-steps-demo/quickstart) — los pasos de build y ejecución referenciados arriba.
* [Referencia de códigos de error](/es/getnet-toolbox/sdk-white-label/reference-sdk/error-codes) — los códigos de resultado del SDK y sus categorías de causa.