Lista de errores de Midaz

Nuestras APIs de Midaz devuelven un objeto de error estructurado para todos los errores con el fin de simplificar el diagnóstico de problemas. El formato es el siguiente:

{
   "code":"<error_code>",
   "title":"<error_title>",
   "message":"<error_message>"
}

Definiciones de campos

code: Un identificador único y estable para el error.
title: Un resumen breve del problema.
message: Orientación detallada para resolver el error.

Detalles de error a nivel de campo Para problemas específicos de campos individuales, un objeto fields proporciona contexto adicional. Ejemplos:

{
   "code":"0009",
   "title":"Missing Fields in Request",
   "message":"Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.",
   "fields": {
      "{{field}}": "{{field}} is a required field"
   }
}

Errores de Midaz

Consulte la siguiente tabla para códigos de error y sus descripciones:

Código	Título	Mensaje	Traducción
0002	Ledger Name Conflict	A ledger named {{name}} already exists in your organization. Please rename the ledger, or if you want to use the same name, consider creating a new ledger for a different division.	Ya existe un ledger llamado {{name}} en su organización. Por favor, renombre el ledger o, si desea usar el mismo nombre, considere crear un nuevo ledger para una división diferente.
0003	Asset Name or Code Duplicate	An asset with the same name or code already exists in your ledger. Please modify the name or code of your new asset.	Ya existe un activo con el mismo nombre o código en su ledger. Por favor, modifique el nombre o código de su nuevo activo.
0004	Code Uppercase Requirement	The code must be in uppercase. Please ensure that the code is in uppercase format and try again.	El código debe estar en mayúsculas. Por favor, asegúrese de que el código esté en formato de mayúsculas e intente nuevamente.
0005	Currency Code Standard Compliance	Currency-type assets must comply with the ISO-4217 standard. Please use a currency code that conforms to ISO-4217 guidelines.	Los activos de tipo moneda deben cumplir con el estándar ISO-4217. Por favor, utilice un código de moneda que cumpla con las directrices ISO-4217.
0007	Entity Not Found	No entity was found for the given ID. Please make sure to use the correct ID for the entity you are trying to manage.	No se encontró ninguna entidad para el ID proporcionado. Por favor, asegúrese de usar el ID correcto para la entidad que intenta gestionar.
0008	Action Not Permitted	This action is not permitted in the current environment. Contact an administrator if you believe this is an error.	Esta acción no está permitida en el entorno actual. Contacte a un administrador si cree que se trata de un error.
0009	Missing Fields in Request	Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.	Su solicitud carece de uno o más campos obligatorios. Por favor, consulte la documentación para asegurarse de que todos los campos necesarios estén incluidos en su solicitud.
0014	Segment ID Inactive	The segment with ID {{id}} is currently inactive. Please activate the segment before proceeding.	El segmento con ID {{id}} está actualmente inactivo. Por favor, active el segmento antes de continuar.
0015	Duplicate Segment Name Error	A segment with the name {{name}} already exists for this ledger ID {{ledgerId}}. Please try again with a different ledger or name.	Ya existe un segmento con el nombre {{name}} para este ledger ID {{ledgerId}}. Por favor, intente nuevamente con un ledger o nombre diferente.
0017	Invalid Script Format Error	The script provided in your request is invalid or in an unsupported format. Please verify the script format and try again.	El script proporcionado en su solicitud es inválido o tiene un formato no soportado. Por favor, verifique el formato del script e intente nuevamente.
0018	Insufficient Funds Error	The transaction could not be completed due to insufficient funds in the account. Please add sufficient funds to your account and try again.	La transacción no pudo completarse debido a fondos insuficientes en la cuenta. Por favor, agregue fondos suficientes a su cuenta e intente nuevamente.
0019	Account Ineligibility Error	One or more accounts listed in the transaction are not eligible to participate. Please review the account statuses and try again.	Una o más cuentas incluidas en la transacción no son elegibles para participar. Por favor, revise los estados de las cuentas e intente nuevamente.
0020	Alias Unavailability Error	The alias {{alias}} is already in use. Please choose a different alias and try again.	El alias {{alias}} ya está en uso. Por favor, elija un alias diferente e intente nuevamente.
0021	Parent Transaction ID Not Found	The parentTransactionId {{parentTransactionId}} does not correspond to any existing transaction. Please review the ID and try again.	El parentTransactionId {{parentTransactionId}} no corresponde a ninguna transacción existente. Por favor, revise el ID e intente nuevamente.
0022	Immutable Field Error	The {{field}} field cannot be modified. Please remove this field from your request and try again.	El campo {{field}} no puede ser modificado. Por favor, elimine este campo de su solicitud e intente nuevamente.
0023	Transaction Timing Restriction	You can only perform another transaction using {{assetCode}} of {{amount}} from {{source}} to {{destination}} after {{timestampUnlock}}. Please wait until the specified time to try again.	Solo puede realizar otra transacción usando {{assetCode}} de {{amount}} desde {{source}} hacia {{destination}} después de {{timestampUnlock}}. Por favor, espere hasta el momento especificado para intentar nuevamente.
0024	Account Status Transaction Restriction	The current statuses of the source and/or destination accounts do not permit transactions. Change the account status(es) and try again.	Los estados actuales de las cuentas de origen y/o destino no permiten transacciones. Cambie el/los estado(s) de la(s) cuenta(s) e intente nuevamente.
0025	Insufficient Account Balance Error	The account {{accountId}} does not have sufficient balance. Please try again with an amount that is less than or equal to the available balance.	La cuenta {{accountId}} no tiene saldo suficiente. Por favor, intente nuevamente con un monto menor o igual al saldo disponible.
0026	Transaction Method Restriction	Transactions involving {{assetCode}} are not permitted for the specified source and/or destination. Please try again using accounts that allow transactions with {{assetCode}}.	Las transacciones con {{assetCode}} no están permitidas para el origen y/o destino especificado. Por favor, intente nuevamente usando cuentas que permitan transacciones con {{assetCode}}.
0029	Invalid Parent Account ID	The specified parent account ID does not exist. Please verify the ID is correct and try your request again.	El ID de cuenta padre especificado no existe. Por favor, verifique que el ID sea correcto e intente su solicitud nuevamente.
0032	Invalid Country Code	The provided country code in the ‘address.country’ field does not conform to the ISO-3166 alpha-2 standard. Please provide a valid alpha-2 country code.	El código de país proporcionado en el campo ‘address.country’ no cumple con el estándar ISO-3166 alpha-2. Por favor, proporcione un código de país alpha-2 válido.
0033	Invalid Code Format	The ‘code’ field must be alphanumeric, in upper case, and must contain at least one letter. Please provide a valid code.	El campo ‘code’ debe ser alfanumérico, en mayúsculas, y debe contener al menos una letra. Por favor, proporcione un código válido.
0034	Asset Code Not Found	The provided asset code does not exist in our records. Please verify the asset code and try again.	El código de activo proporcionado no existe en nuestros registros. Por favor, verifique el código de activo e intente nuevamente.
0035	Portfolio ID Not Found	The provided portfolio ID does not exist in our records. Please verify the portfolio ID and try again.	El ID de portafolio proporcionado no existe en nuestros registros. Por favor, verifique el ID de portafolio e intente nuevamente.
0036	Segment ID Not Found	The provided segment ID does not exist in our records. Please verify the segment ID and try again.	El ID de segmento proporcionado no existe en nuestros registros. Por favor, verifique el ID de segmento e intente nuevamente.
0037	Ledger ID Not Found	The provided ledger ID does not exist in our records. Please verify the ledger ID and try again.	El ID de ledger proporcionado no existe en nuestros registros. Por favor, verifique el ID de ledger e intente nuevamente.
0038	Organization ID Not Found	The provided organization ID does not exist in our records. Please verify the organization ID and try again.	El ID de organización proporcionado no existe en nuestros registros. Por favor, verifique el ID de organización e intente nuevamente.
0039	Parent Organization ID Not Found	The provided parent organization ID does not exist in our records. Please verify the parent organization ID and try again.	El ID de organización padre proporcionado no existe en nuestros registros. Por favor, verifique el ID de organización padre e intente nuevamente.
0040	Invalid Type	The provided ‘type’ is not valid. Accepted types are: currency, crypto, commodities, or others. Please provide a valid type.	El ‘type’ proporcionado no es válido. Los tipos aceptados son: currency, crypto, commodities u others. Por favor, proporcione un tipo válido.
0041	Token Missing	A valid token must be provided in the request header. Please include a token and try again.	Se debe proporcionar un token válido en el encabezado de la solicitud. Por favor, incluya un token e intente nuevamente.
0042	Invalid Token	The provided token is expired, invalid or malformed. Please provide a valid token and try again.	El token proporcionado está expirado, es inválido o tiene un formato incorrecto. Por favor, proporcione un token válido e intente nuevamente.
0043	Insufficient Privileges	You do not have the necessary permissions to perform this action. Please contact your administrator if you believe this is an error.	No tiene los permisos necesarios para realizar esta acción. Por favor, contacte a su administrador si cree que se trata de un error.
0046	Internal Server Error	The server encountered an unexpected error. Please try again later or contact support.	El servidor encontró un error inesperado. Por favor, intente nuevamente más tarde o contacte al soporte.
0047	Bad Request	The server could not understand the request due to malformed syntax. Please check the listed fields and try again.	El servidor no pudo entender la solicitud debido a una sintaxis incorrecta. Por favor, verifique los campos listados e intente nuevamente.
0050	Metadata Key Length Exceeded	The metadata key {{key}} exceeds the maximum allowed length. Please use a shorter key.	La clave de metadatos {{key}} excede la longitud máxima permitida. Por favor, utilice una clave más corta.
0051	Metadata Value Length Exceeded	The metadata value {{key}} exceeds the maximum allowed length. Please use a shorter value.	El valor de metadatos {{key}} excede la longitud máxima permitida. Por favor, utilice un valor más corto.
0052	Account ID Not Found	The provided account ID does not exist in our records. Please verify the account ID and try again.	El ID de cuenta proporcionado no existe en nuestros registros. Por favor, verifique el ID de cuenta e intente nuevamente.
0053	Unexpected Fields in the Request	The request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.	El cuerpo de la solicitud contiene más campos de los esperados. Por favor, envíe solo los campos permitidos según la documentación. Los campos inesperados están listados en el objeto fields.
0055	Asset ID Not Found	The specified asset ID does not exist in the provided ledger. Please verify the asset ID and try again.	El ID de activo especificado no existe en el ledger proporcionado. Por favor, verifique el ID de activo e intente nuevamente.
0056	No Assets Found	No assets were found for the specified ledger. Please create an asset or verify the ledger exists.	No se encontraron activos para el ledger especificado. Por favor, cree un activo o verifique que el ledger exista.
0057	No Segments Found	No segments were found for the specified ledger. Please create a segment or verify the ledger exists.	No se encontraron segmentos para el ledger especificado. Por favor, cree un segmento o verifique que el ledger exista.
0058	No Portfolios Found	No portfolios were found for the specified ledger. Please create a portfolio or verify the ledger exists.	No se encontraron portafolios para el ledger especificado. Por favor, cree un portafolio o verifique que el ledger exista.
0065	Invalid Path Parameter	The provided path parameter {{parameter_name}} is not in the expected format. Please ensure the parameter adheres to the required format and try again.	El parámetro de ruta proporcionado {{parameter_name}} no tiene el formato esperado. Por favor, asegúrese de que el parámetro cumpla con el formato requerido e intente nuevamente.
0066	Invalid Account Type	The provided ‘type’ is not valid. Accepted types are: deposit, savings, loans, marketplace, cerditCard or external. Please provide a valid type.	El ‘type’ proporcionado no es válido. Los tipos aceptados son: deposit, savings, loans, marketplace, cerditCard o external. Por favor, proporcione un tipo válido.
0067	Invalid Metadata Nesting	The metadata object cannot contain nested values. Please ensure that the value {{value}} is not nested and try again.	El objeto de metadatos no puede contener valores anidados. Por favor, asegúrese de que el valor {{value}} no esté anidado e intente nuevamente.
0068	Operation ID Not Found	The provided operation ID does not exist in our records. Please verify the operation ID and try again.	El ID de operación proporcionado no existe en nuestros registros. Por favor, verifique el ID de operación e intente nuevamente.
0069	No Operations Found	No operations were found for the given query parameters. Please adjust your filters and try again.	No se encontraron operaciones para los parámetros de consulta proporcionados. Por favor, ajuste sus filtros e intente nuevamente.
0071	No Transactions Found	No transactions were found for the given query parameters. Please adjust your filters and try again.	No se encontraron transacciones para los parámetros de consulta proporcionados. Por favor, ajuste sus filtros e intente nuevamente.
0073	Transaction Value Mismatch	The values for the source, the destination, or both do not match the specified transaction amount. Please verify the values and try again.	Los valores del origen, el destino, o ambos, no coinciden con el monto de la transacción especificado. Por favor, verifique los valores e intente nuevamente.
0074	External Account Modification Prohibited	Accounts of type ‘external’ cannot be deleted or modified as they are used for traceability with external systems. Please review your request and ensure operations are only performed on internal accounts.	Las cuentas de tipo ‘external’ no pueden ser eliminadas ni modificadas ya que se utilizan para la trazabilidad con sistemas externos. Por favor, revise su solicitud y asegúrese de que las operaciones se realicen solo en cuentas internas.
0079	Date Range Exceeds Limit Error	The range between ‘initialDate’ and ‘finalDate’ exceeds the permitted limit of {{limit}} months. Please adjust the dates and try again.	El rango entre ‘initialDate’ y ‘finalDate’ excede el límite permitido de {{limit}} meses. Por favor, ajuste las fechas e intente nuevamente.
0080	Pagination Limit Exceeded	The pagination limit exceeds the maximum allowed of {{pageLimit}} items per page. Please verify the limit and try again.	El límite de paginación excede el máximo permitido de {{pageLimit}} elementos por página. Por favor, verifique el límite e intente nuevamente.
0081	Invalid Sort Order	The ‘sort_order’ field must be ‘asc’ or ‘desc’. Please provide a valid sort order and try again.	El campo ‘sort_order’ debe ser ‘asc’ o ‘desc’. Por favor, proporcione un orden de clasificación válido e intente nuevamente.
0082	Invalid Query Parameter	One or more query parameters are in an incorrect format. Please check the following parameters ‘{{parameter}}’ and ensure they meet the required format before trying again.	Uno o más parámetros de consulta tienen un formato incorrecto. Por favor, verifique los siguientes parámetros ‘{{parameter}}’ y asegúrese de que cumplan con el formato requerido antes de intentar nuevamente.
0083	Invalid Date Range Error	Both ‘initialDate’ and ‘finalDate’ fields are required and must be in the ‘yyyy-mm-dd’ format. Please provide valid dates and try again.	Los campos ‘initialDate’ y ‘finalDate’ son obligatorios y deben estar en el formato ‘yyyy-mm-dd’. Por favor, proporcione fechas válidas e intente nuevamente.
0084	Duplicate Idempotency Key	The idempotency key ‘{{key}}’ is already in use. Please provide a unique key and try again.	La clave de idempotencia ‘{{key}}’ ya está en uso. Por favor, proporcione una clave única e intente nuevamente.
0085	Account Alias Not Found	The provided account Alias does not exist in our records. Please verify the account Alias and try again.	El Alias de cuenta proporcionado no existe en nuestros registros. Por favor, verifique el Alias de cuenta e intente nuevamente.
0086	Race condition detected	A race condition was detected while processing your request. Please try again	Se detectó una condición de carrera al procesar su solicitud. Por favor, intente nuevamente.
0087	Transaction Revert already exist	Transaction revert already exists. Please try again.	La reversión de transacción ya existe. Por favor, intente nuevamente.
0088	Transaction is already a reversal	Transaction is already a reversal. Please try again	La transacción ya es una reversión. Por favor, intente nuevamente.
0089	Transaction can’t be reverted	Transaction can’t be reverted. Please try again	La transacción no puede ser revertida. Por favor, intente nuevamente.
0091	ID cannot be used as the parent ID	The provided ID cannot be used as the parent ID. Please choose a different one.	El ID proporcionado no puede ser usado como ID padre. Por favor, elija uno diferente.
0092	No Balances Found	No balances were found for the given query parameters. Please adjust your filters and try again.	No se encontraron saldos para los parámetros de consulta proporcionados. Por favor, ajuste sus filtros e intente nuevamente.
0093	Balance Cannot Be Deleted	Balance cannot be deleted because it still has funds in it or has active operations.	El saldo no puede ser eliminado porque aún tiene fondos o tiene operaciones activas.
0094	Invalid Request Body	The request body is invalid or could not be parsed. Please check JSON structure and field types.	El cuerpo de la solicitud es inválido o no pudo ser analizado. Por favor, verifique la estructura JSON y los tipos de campos.
0099	Transaction Status Invalid	Transaction cannot be reverted because its status is not APPROVED	La transacción no puede ser revertida porque su estado no es APPROVED.
0100	Operation Route Title Already Exists	An operation route with the specified title already exists. Please use a different title and try again.	Ya existe una ruta de operación con el título especificado. Por favor, utilice un título diferente e intente nuevamente.
0101	Operation Route Not Found	The provided operation route does not exist in our records. Please verify the operation route and try again.	La ruta de operación proporcionada no existe en nuestros registros. Por favor, verifique la ruta de operación e intente nuevamente.
0102	No Operation Routes Found	No operation routes were found for the given query parameters. Please adjust your filters and try again.	No se encontraron rutas de operación para los parámetros de consulta proporcionados. Por favor, ajuste sus filtros e intente nuevamente.
0103	Invalid Operation Route Type	The provided operation route type is not valid. Accepted types are ‘source’ or ‘destination’. Please provide a valid operation type.	El tipo de ruta de operación proporcionado no es válido. Los tipos aceptados son ‘source’ o ‘destination’. Por favor, proporcione un tipo de operación válido.
0104	Missing Operation Routes in Request	Your request must include at least one operation route of each type (debit and credit). Please refer to the documentation to ensure these fields are properly populated.	Su solicitud debe incluir al menos una ruta de operación de cada tipo (débito y crédito). Por favor, consulte la documentación para asegurarse de que estos campos estén correctamente completados.
0105	Transaction Route Not Found	The provided transaction route does not exist in our records. Please verify the transaction route and try again.	La ruta de transacción proporcionada no existe en nuestros registros. Por favor, verifique la ruta de transacción e intente nuevamente.
0106	No Transaction Routes Found	No transaction routes were found for the given query parameters. Please adjust your filters and try again.	No se encontraron rutas de transacción para los parámetros de consulta proporcionados. Por favor, ajuste sus filtros e intente nuevamente.
0107	Operation Route Linked to Transaction Routes	The operation route cannot be deleted because it is linked to one or more transaction routes. Please remove the operation route from all transaction routes before attempting to delete it.	La ruta de operación no puede ser eliminada porque está vinculada a una o más rutas de transacción. Por favor, elimine la ruta de operación de todas las rutas de transacción antes de intentar eliminarla.
0108	Duplicate Account Type Key Value Error	An account type with the specified key value already exists for this organization and ledger. Please use a different key value or update the existing account type.	Ya existe un tipo de cuenta con el valor de clave especificado para esta organización y ledger. Por favor, utilice un valor de clave diferente o actualice el tipo de cuenta existente.
0109	Account Type Not Found Error	The account type you are trying to access does not exist or has been removed.	El tipo de cuenta al que intenta acceder no existe o ha sido eliminado.
0110	No Account Types Found	No account types were found for the specified ledger. Please create an account type or verify the ledger exists.	No se encontraron tipos de cuenta para el ledger especificado. Por favor, cree un tipo de cuenta o verifique que el ledger exista.
0111	Invalid Account Rule Type	The provided ‘account.ruleType’ is not valid. Accepted types are ‘alias’ or ‘account_type’. Please provide a valid rule type.	El ‘account.ruleType’ proporcionado no es válido. Los tipos aceptados son ‘alias’ o ‘account_type’. Por favor, proporcione un tipo de regla válido.
0112	Invalid Account Rule Value	The provided ‘account.validIf’ is not valid. Please provide a string for ‘alias’ or an array of strings for ‘account_type’.	El ‘account.validIf’ proporcionado no es válido. Por favor, proporcione una cadena de texto para ‘alias’ o un arreglo de cadenas para ‘account_type’.
0120	Invalid Characters	The field ‘keyValue’ contains invalid characters. Use only letters, numbers, underscores and hyphens.	El campo ‘keyValue’ contiene caracteres inválidos. Utilice solo letras, números, guiones bajos y guiones.
0123	Duplicated Alias Key Value Error	An account alias with the specified key value already exists for this organization and ledger. Please use a different key value.	Ya existe un alias de cuenta con el valor de clave especificado para esta organización y ledger. Por favor, utilice un valor de clave diferente.
0124	Additional Balance Creation Not Allowed	Additional balances are not allowed for external account type.	No se permiten saldos adicionales para el tipo de cuenta external.

Primeros pasos

Organizations API

Ledgers API

Assets API

Account Types API

Accounts API

Portfolios API

Segments API

Balances API

Transactions API

Operations API

Operation Routes API

Transaction Routes API

Metadata Indexes API

Manejo de errores

Lista de errores de Midaz

Errores de Midaz

Primeros pasos

Organizations API

Ledgers API

Assets API

Account Types API

Accounts API

Portfolios API

Segments API

Balances API

Transactions API

Operations API

Operation Routes API

Transaction Routes API

Metadata Indexes API

Manejo de errores

​Errores de Midaz

Errores de Midaz