> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/nucleo/cuxial-banking/troubleshooting.md).

# Problemas frecuentes

Problemas habituales de Cuxial Banking, con su causa y su solución.

Los problemas más habituales tras instalar Cuxial Banking, con la causa y la solución de cada uno.

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia o arranca después del banco. Cuxial Banking necesita OneSync, `ox_lib`, `oxmysql` y `cuxial_bridge`.

**Solución.** Activa OneSync y arranca antes las dependencias:

{% code title="server.cfg" %}

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_banking
```

{% endcode %}

</details>

<details>

<summary>Todas las operaciones fallan y la consola muestra un paso de base de datos en rojo</summary>

**Causa.** Un paso de base de datos falló al arrancar. El banco deja de aplicar el resto para no dejar las tablas a medias, y rechaza las operaciones hasta que la base de datos esté lista.

**Solución.** Lee las líneas en rojo de la consola del servidor: indican el paso y el motivo que da la base de datos. Una causa habitual es un usuario de base de datos sin permiso para crear o modificar tablas. Corrige la causa y reinicia el recurso; continúa desde el paso que falló.

</details>

<details>

<summary>He editado un archivo de data/ y no ha cambiado nada</summary>

**Causa.** Tras el primer arranque, las secciones general, cuentas, tarjetas, préstamos, ahorros, cheques, recompensas, puntuación de crédito, cajeros, admin y logs se leen de la base de datos, no de los archivos.

**Solución.** Cambia el valor en `/bankadmin` → Config. Para volver a cargar el archivo, reinicia el recurso y pulsa el botón de restablecer de esa sección en el panel. Consulta [Dónde viven los ajustes](/scripts/es/nucleo/cuxial-banking/configuration.md#donde-viven-los-ajustes).

</details>

<details>

<summary>El efectivo sale a 0, o fallan los depósitos y los retiros</summary>

**Causa.** El banco está contando el efectivo como un ítem de inventario llamado `money`, y tu servidor usa otro ítem o guarda el efectivo en el framework.

**Solución.** En `/bankadmin` → Config → General, pon como ítem de efectivo el que use tu inventario, o desactiva el efectivo como ítem. Antes del primer arranque, hazlo en los archivos como se indica en [Instalación](/scripts/es/nucleo/cuxial-banking/installation.md).

</details>

<details>

<summary>No hay blips de banco ni opción de target en las sucursales</summary>

**Causa.** Una de estas:

* No hay en marcha ningún target soportado por `cuxial_bridge`.
* Las sucursales no llegaron a crearse, porque la tabla de puntos ya tenía filas o `BankLocations` estaba vacío en el primer arranque.
* `ShowBankBlips` está desactivado, lo que oculta solo los blips.

**Solución.** Arranca tu target antes que el banco. Después abre `/bankadmin` → Puntos y revisa la lista; crea ahí las sucursales si está vacía.

</details>

<details>

<summary>He cambiado BankLocations y las sucursales no se han movido</summary>

**Causa.** `data/banks.lua` solo se lee en el primer arranque, para rellenar una tabla de puntos vacía.

**Solución.** Mueve, añade o elimina sucursales desde `/bankadmin` → Puntos.

</details>

<details>

<summary>El NPC de la sucursal no aparece</summary>

**Causa.** Los NPC los muestra `cuxial_interactions`. Sin él, o cuando el punto no tiene modelo de ped, la sucursal es una zona de target.

**Solución.** Arranca `cuxial_interactions` y ponle un modelo de ped al punto en `/bankadmin` → Puntos. El banco recoge el cambio cuando ese recurso arranca o se detiene; no hace falta reiniciar.

</details>

<details>

<summary>El cajero dice que no tengo tarjeta</summary>

**Causa.** Un cajero solo se abre a un jugador que lleve una tarjeta activa. También puede que falten los ítems de tarjeta en el inventario, de modo que el banco no pudo entregar ninguna.

**Solución.** Pide una tarjeta en una sucursal. Si el pedido falla, comprueba que `card_standard`, `card_premium` y `card_elite` existen en tu inventario con `stack = false`, y que el `item` de cada nivel en los ajustes coincide con esos nombres.

</details>

<details>

<summary>Usar el cheque, el talonario o el recibo no hace nada</summary>

**Causa.** Los ítems no están registrados en el inventario, o sus nombres no coinciden con los de los ajustes.

**Solución.** Añade las entradas de `install/items.lua` a tu inventario, mantén `consume = 0` en los tres y reinicia el servidor. El talonario solo se abre a un jefe de un trabajo.

</details>

<details>

<summary>El talonario dice que hace falta ser jefe</summary>

**Causa.** Los cheques de empresa salen de la cuenta de empresa, que solo pueden usar los jefes del trabajo.

**Solución.** Dale al jugador un rango de jefe en su trabajo.

</details>

<details>

<summary>Un trabajo no tiene cuenta de empresa</summary>

**Causa.** Las cuentas de empresa se crean al arrancar a partir de la lista de trabajos de tu framework. El trabajo aún no existía, o el framework no estuvo listo durante el primer minuto.

**Solución.** Asegúrate de que el framework arranca antes que el banco y reinicia `cuxial_banking`. Los trabajos nuevos reciben su cuenta en el siguiente arranque.

</details>

<details>

<summary>Los jugadores nunca reciben nóminas en el banco</summary>

**Causa.** El banco no genera sueldos. Solo guarda las nóminas que le envían otros recursos.

**Solución.** Llama a [`AddPaycheck`](/scripts/es/nucleo/cuxial-banking/developers.md#addpaycheck) desde el recurso que paga los sueldos.

</details>

<details>

<summary>Las compras hechas en otros recursos no salen en el historial</summary>

**Causa.** Una de estas:

* `LogExternalBankChanges` está desactivado.
* El servidor usa ESX. Este registro requiere QBox o QBCore.
* El otro recurso usó `AddMoney` o `RemoveMoney` del banco, que no anotan historial.

**Solución.** Activa la opción en `/bankadmin` → Config → General, o anota tú el apunte con [`AddTransaction`](/scripts/es/nucleo/cuxial-banking/developers.md#addtransaction).

</details>

<details>

<summary>/bankadmin dice que no tengo permiso</summary>

**Causa.** Tu personaje no tiene en tu framework el permiso fijado en `admin.permission`, `'admin'` por defecto.

**Solución.** Concédete ese permiso en el framework. En ESX el grupo debe ser `admin` o `superadmin`. Consulta [Comandos y permisos](/scripts/es/nucleo/cuxial-banking/commands.md#permisos).

</details>

<details>

<summary>No llega ningún log a Discord</summary>

**Causa.** La convar está vacía, o ese tipo de log está desactivado.

**Solución.** Añade el webhook a `server.cfg` con `set`, no en los archivos del recurso:

{% code title="server.cfg" %}

```cfg
set cuxial_banking_webhook "https://discord.com/api/webhooks/..."
```

{% endcode %}

Después comprueba en `/bankadmin` → Config → Logs que los logs y ese tipo de log están activados.

</details>

<details>

<summary>La opción de target no abre nada, o la pantalla se queda vacía</summary>

**Causa.** La interfaz no carga. La carpeta `web/build` falta o está incompleta, normalmente por una subida parcial.

**Solución.** Comprueba que `web/build/index.html` y la carpeta `web/build/assets` existen dentro del recurso. Si no, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cuxial.com/scripts/es/nucleo/cuxial-banking/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.