Actualizar una Cuenta
Utilice este endpoint para actualizar los detalles de una Cuenta.
Semántica de fusión: este endpoint sigue el estándar RFC 7396 JSON Merge Patch. Enviar un null explícito para segmentId, entityId o portfolioId borra el campo; omitir un campo deja su valor actual sin cambios.
Nota: las cuentas de tipo external son inmutables y están gestionadas por el sistema. Intentar actualizar una de ellas devuelve un error 400/403.
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 de la cuenta.
Cuerpo
El nombre de la Cuenta.
256Define si la cuenta debe estar bloqueada.
El identificador único de la Entidad responsable de la Cuenta.
256El identificador único del Portafolio asociado.
El identificador único del Segmento que se utiliza para agrupar la Cuenta.
Un objeto que contiene información sobre el estado. Importante: Si no se proporciona, el estado predeterminado será 'ACTIVE'.
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.
Respuesta
Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.
El identificador único de la Cuenta.
El identificador único de la Organización.
El identificador único del Ledger.
El código que identifica el Activo utilizado en la Cuenta.
El nombre de la Cuenta.
256Un identificador único y fácil de usar para la cuenta. Se utiliza para referenciar la cuenta en transacciones y otras operaciones.
Especifica el Tipo de Cuenta asociado a la cuenta.
Define si la cuenta debe estar bloqueada.
El identificador único de la Cuenta matriz.
El identificador único de la Entidad responsable de la Cuenta.
El identificador único del Portafolio asociado.
El identificador único del Segmento que se utiliza para agrupar la Cuenta.
Un objeto que contiene información sobre el estado.
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.
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).

