Actualizar un Saldo
Utilice este endpoint para actualizar la información de un saldo existente.
Encabezados
El tipo de medio del recurso. El valor recomendado es application/json.
Un identificador único utilizado para rastrear y seguir cada solicitud.
Token JWT bearer para autenticación.
Requerido cuando PLUGIN_AUTH_ENABLED=true (obligatorio en despliegues multiinquilino).
Opcional en el modo OSS de inquilino único predeterminado.
Formato: Bearer <token>
Parámetros de ruta
El identificador único de la Organización asociada al Ledger.
El identificador único del Ledger asociado.
El identificador único del saldo que desea recuperar.
Cuerpo
Si es verdadero, indica que el saldo puede ser utilizado para enviar transacciones.
Si es verdadero, indica que el saldo puede ser utilizado para recibir transacciones.
Cuando se proporciona, reemplaza las configuraciones existentes en su totalidad. Use esto para alternar allowOverdraft o ajustar overdraftLimit. La dirección no puede cambiarse vía update — es inmutable después de la creación.
Respuesta
Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.
El identificador único del Saldo.
El identificador único de la Organización.
El identificador único del Ledger.
El identificador único de la Cuenta.
El alias de la cuenta utilizada en la operación.
El identificador único del saldo en el contexto de la cuenta.
El nombre del activo utilizado en la operación.
Saldo disponible anterior.
Monto retenido/reservado.
Versión del saldo, que se actualiza con cada transacción.
El tipo de cuenta.
Si es verdadero, indica que el saldo puede ser utilizado para enviar transacciones.
Si es verdadero, indica que el saldo puede ser utilizado para recibir transacciones.
La dirección contable del saldo. Saldos credit crecen en crédito y disminuyen en débito; saldos debit crecen en débito y disminuyen en crédito. Definida en la creación e inmutable.
credit, debit La cantidad de overdraft actualmente consumida por este saldo, como string decimal. Siempre no negativa; "0" cuando el saldo no tiene overdraft activo.
Configuración opcional por saldo (overdraft, alcance). null para saldos legados sin configuraciones personalizadas.
Vista computada del estado del saldo en el momento de la respuesta. Siempre presente; nunca persistida. Recalculada a partir de available, onHold, overdraftUsed y settings en cada lectura.
Fecha y hora de creación (UTC).
Fecha y hora de la última actualización (UTC).
Fecha y hora de la eliminación lógica, si aplica (UTC).
Un objeto que contiene pares clave-valor para agregar como metadatos, donde el campo name es la clave y el campo value es el valor. Por ejemplo, para agregar un Centro de Costo, use 'costCenter': 'BR_11101997'.
Restricciones: las claves deben tener como máximo 100 caracteres; los valores de cadena de texto, como máximo 2000 caracteres. No se permiten objetos anidados (los valores deben ser cadena de texto, número o booleano), la estructura no puede exceder una profundidad máxima de 10, y se permite un máximo de 100 claves.