code: Un identificador único y estable para el error.title: Un resumen breve del problema.message: Orientación detallada para resolver el error.
fields proporciona contexto adicional.
Ejemplos:
Errores de Midaz
Consulte la siguiente tabla para códigos de error y sus descripciones:
code | title | message |
|---|---|---|
| 0001 | Duplicate Ledger Error | A ledger with the specified name already exists in this division. Please rename the ledger or choose a different division. |
| 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. |
| 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. |
| 0004 | Code Uppercase Requirement | The code must be in uppercase. Please ensure that the code is in uppercase format and try again. |
| 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. |
| 0006 | Unmodifiable Field Error | Your request includes a field that cannot be modified. Please review your request and try again, removing any uneditable fields. |
| 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. |
| 0008 | Action Not Permitted | This action is not permitted in the current environment. Contact an administrator if you believe this is an 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. |
| 0010 | Account Type Immutable | The account type specified cannot be modified. Please ensure the correct account type is being used and try again. |
| 0011 | Inactive Account Type Error | The account type specified cannot be set to INACTIVE. Please ensure the correct account type is being used and try again. |
| 0012 | Account Balance Deletion Error | An account or sub-account cannot be deleted if it has a remaining balance. Please ensure all remaining balances are transferred before attempting to delete. |
| 0013 | Resource Already Deleted | The resource you are trying to delete has already been deleted. Ensure you are using the correct ID and try again. |
| 0014 | Segment ID Inactive | The segment with ID {{id}} is currently inactive. Please activate the segment before proceeding. |
| 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. |
| 0016 | Balance Remaining Deletion Error | The asset cannot be deleted because there is a remaining balance. Please ensure all balances are cleared before attempting to delete. |
| 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. |
| 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. |
| 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. |
| 0020 | Alias Unavailability Error | The alias {{alias}} is already in use. Please choose a different alias and try again. |
| 0021 | Parent Transaction ID Not Found | The parentTransactionId {{parentTransactionId}} does not correspond to any existing transaction. Please review the ID and try again. |
| 0022 | Immutable Field Error | The {{field}} field cannot be modified. Please remove this field from your request and try again. |
| 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. |
| 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. |
| 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. |
| 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}}. |
| 0027 | Duplicate Transaction Template Code Error | A transaction template with the specified code already exists for your ledger. Please use a different code and try again. |
| 0028 | Duplicate Asset Pair Error | A pair for the specified assets already exists. Please update the existing entry instead of creating a new one. |
| 0029 | Invalid Parent Account ID | The specified parent account ID does not exist. Please verify the ID is correct and try your request again. |
| 0030 | Mismatched Asset Code | The parent account ID is associated with a different asset code than the one specified. Please make sure the asset code matches the parent account. |
| 0031 | Chart Type Not Found | The specified chart type does not exist. Please provide a valid chart type and refer to the documentation. |
| 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. |
| 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. |
| 0034 | Asset Code Not Found | The provided asset code does not exist in our records. Please verify the asset code and try again. |
| 0035 | Portfolio ID Not Found | The provided portfolio ID does not exist in our records. Please verify the portfolio ID and try again. |
| 0036 | Segment ID Not Found | The provided segment ID does not exist in our records. Please verify the segment ID and try again. |
| 0037 | Ledger ID Not Found | The provided ledger ID does not exist in our records. Please verify the ledger ID and try again. |
| 0038 | Organization ID Not Found | The provided organization ID does not exist in our records. Please verify the organization ID and try again. |
| 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. |
| 0040 | Invalid Type | The provided ‘type’ is not valid. Accepted types are: currency, crypto, commodities, or others. Please provide a valid type. |
| 0041 | Token Missing | A valid token must be provided in the request header. Please include a token and try again. |
| 0042 | Invalid Token | The provided token is expired, invalid or malformed. Please provide a valid token and try again. |
| 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. |
| 0044 | Permission Enforcement Error | The enforcer is not configured properly. Please contact your administrator if you believe this is an error. |
| 0045 | JWK Fetch Error | The JWK keys could not be fetched from the source. Please verify the source environment variable configuration and try again. |
| 0046 | Internal Server Error | The server encountered an unexpected error. Please try again later or contact support. |
| 0047 | Bad Request | The server could not understand the request due to malformed syntax. Please check the listed fields and try again. |
| 0048 | Invalid DSL File Format | The submitted DSL file is in an incorrect format. Please ensure that the file follows the expected structure and syntax. |
| 0049 | Empty DSL File | The submitted DSL file is empty. Please provide a valid file with content. |
| 0050 | Metadata Key Length Exceeded | The metadata key {{key}} exceeds the maximum allowed length. Please use a shorter key. |
| 0051 | Metadata Value Length Exceeded | The metadata value {{key}} exceeds the maximum allowed length. Please use a shorter value. |
| 0052 | Account ID Not Found | The provided account ID does not exist in our records. Please verify the account ID and try again. |
| 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. |
| 0054 | IDs Not Found for Accounts | No accounts were found for the provided IDs. Please verify the IDs and try again. |
| 0055 | Asset ID Not Found | The specified asset ID does not exist in the provided ledger. Please verify the asset ID and try again. |
| 0056 | No Assets Found | No assets were found for the specified ledger. Please create an asset or verify the ledger exists. |
| 0057 | No Segments Found | No segments were found for the specified ledger. Please create a segment or verify the ledger exists. |
| 0058 | No Portfolios Found | No portfolios were found for the specified ledger. Please create a portfolio or verify the ledger exists. |
| 0059 | No Organizations Found | No organizations were found in the search. Please review the search criteria and try again. |
| 0060 | No Ledgers Found | No ledgers were found in the search. Please review the search criteria and try again. |
| 0061 | Balance Update Failed | The balance could not be updated for the specified account ID. Please verify the account ID and try again. |
| 0062 | No Account IDs Provided | No account IDs were provided for the balance update. Please provide valid account IDs and try again. |
| 0063 | Failed To Retrieve Accounts By Aliases | The accounts could not be retrieved using the specified aliases. Please verify the aliases for accuracy and try again. |
| 0064 | No Accounts Found | No accounts were found in the search. Please review the search criteria and try again. |
| 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. |
| 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. |
| 0067 | Invalid Metadata Nesting | The metadata object cannot contain nested values. Please ensure that the value {{value}} is not nested and try again. |
| 0068 | Operation ID Not Found | The provided operation ID does not exist in our records. Please verify the operation ID and try again. |
| 0069 | No Operations Found | No operations were found for the given query parameters. Please adjust your filters and try again. |
| 0070 | Transaction ID Not Found | The provided transaction ID does not exist in our records. Please verify the transaction ID and try again. |
| 0071 | No Transactions Found | No transactions were found for the given query parameters. Please adjust your filters and try again. |
| 0072 | Invalid Transaction Type | Only one transaction type (amount, share, or remaining) must be specified for each entry. Please review your input and try again. |
| 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. |
| 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. |
| 0075 | Audit Record Not Retrieved | The record could not be retrieved for audit. Please verify that the submitted data is correct and try again. |
| 0076 | Audit Tree Record Not Found | The record does not exist in the audit tree. Please ensure the audit tree is available and try again. |
| 0077 | Invalid Date Format Error | The initialDate, finalDate, or both are in the incorrect format. Please use the yyyy-mm-dd format and try again. |
| 0078 | Invalid Final Date Error | The finalDate cannot be earlier than the initialDate. Please verify the dates and try again. |
| 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. |
| 0080 | Pagination Limit Exceeded | The pagination limit exceeds the maximum allowed of {{pageLimit}} items per page. Please verify the limit and try again. |
| 0081 | Invalid Sort Order | The ‘sort_order’ field must be ‘asc’ or ‘desc’. Please provide a valid sort order and try again. |
| 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. |
| 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. |
| 0084 | Duplicate Idempotency Key | The idempotency key ‘{{key}}’ is already in use. Please provide a unique key and try again. |
| 0085 | Account Alias Not Found | The provided account Alias does not exist in our records. Please verify the account Alias and try again. |
| 0086 | Race condition detected | A race condition was detected while processing your request. Please try again |
| 0087 | Transaction Revert already exist | Transaction revert already exists. Please try again. |
| 0088 | Transaction is already a reversal | Transaction is already a reversal. Please try again |
| 0089 | Transaction can’t be reverted | Transaction can’t be reverted. Please try again |
| 0090 | Transaction Ambiguous Account | Transaction cannot use the same account in sources and destinations. |
| 0091 | ID cannot be used as the parent ID | The provided ID cannot be used as the parent ID. Please choose a different one. |
| 0092 | No Balances Found | No balances were found for the given query parameters. Please adjust your filters and try again. |
| 0093 | Balance Cannot Be Deleted | Balance cannot be deleted because it still has funds in it or has active operations. |
| 0094 | Invalid Request Body | The request body is invalid or could not be parsed. Please check JSON structure and field types. |
| 0095 | Message Broker Unavailable | The server encountered an unexpected error while connecting to Message Broker. Please try again later or contact support. |
| 0096 | Invalid Account Alias | The alias contains invalid characters. Please verify the alias value and try again. |
| 0097 | Overflow Error | The request could not be completed due to an overflow. Please check the values and try again. |
| 0098 | Invalid Pending Transaction | External accounts cannot be used for pending transactions in source operations. Please check the accounts and try again. |
| 0099 | Transaction Status Invalid | Transaction cannot be reverted because its status is not APPROVED |
| 0100 | Operation Route Title Already Exists | An operation route with the specified title already exists. Please use a different title and try again. |
| 0101 | Operation Route Not Found | The provided operation route does not exist in our records. Please verify the operation route and try again. |
| 0102 | No Operation Routes Found | No operation routes were found for the given query parameters. Please adjust your filters and try again. |
| 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. |
| 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. |
| 0105 | Transaction Route Not Found | The provided transaction route does not exist in our records. Please verify the transaction route and try again. |
| 0106 | No Transaction Routes Found | No transaction routes were found for the given query parameters. Please adjust your filters and try again. |
| 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. |
| 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. |
| 0109 | Account Type Not Found Error | The account type you are trying to access does not exist or has been removed. |
| 0110 | No Account Types Found | No account types were found for the specified ledger. Please create an account type or verify the ledger exists. |
| 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. |
| 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’. |
| 0113 | Corrupted Account Rule | The account rule data in the operation route is internally inconsistent (unknown rule type or malformed validIf value). This indicates a data integrity issue — please verify the operation route configuration. |
| 0114 | Transaction Route Not Informed | The transaction route is not informed. Please inform the transaction route for this transaction. |
| 0115 | Invalid Transaction Route ID | The provided transaction route ID is not a valid UUID format. Please provide a valid UUID for the transaction route. |
| 0116 | Accounting Route Count Mismatch | The operation routes count does not match the transaction route cache. Please verify your route configuration. |
| 0117 | Accounting Route Not Found | The operation route ID was not found in the transaction route cache. Please verify the route configuration. |
| 0118 | Accounting Alias Validation Failed | The operation alias does not match the expected alias defined in the accounting route rule. |
| 0119 | Accounting Account Type Validation Failed | The account type does not match any of the expected account types defined in the accounting route rule. |
| 0120 | Invalid Characters | The field ‘keyValue’ contains invalid characters. Use only letters, numbers, underscores and hyphens. |
| 0121 | Invalid Future Date Error | The transactionDate cannot be a future date. Please provide a valid date. |
| 0122 | Invalid Field for Pending Transaction Error | Pending transactions do not support the transactionDate field. To proceed, please remove it from your request. |
| 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. |
| 0124 | Additional Balance Creation Not Allowed | Additional balances are not allowed for external account type. |
| 0125 | Invalid Transaction Value | Negative or zero transaction values are not allowed. The send_value must be greater than zero. |
| 0126 | Default Balance Not Found | Default balance must be created first for this account. |
| 0127 | Account Creation Failed | The account could not be created because the default balance could not be created. Please try again. |
| 0128 | Transaction Backup Cache Failed | The server encountered an unexpected error while adding the transaction to the backup cache. Please try again later or contact support. |
| 0129 | Transaction Backup Cache Marshal Failed | The server encountered an unexpected error while serializing the transaction for the backup cache. Please try again later or contact support. |
| 0130 | (Reserved) | This error code is reserved and currently unassigned. |
| 0131 | Invalid Datetime Format Error | The parameter is in the incorrect format. Please use the correct datetime format and try again. |
| 0132 | Metadata Index Already Exists | A metadata index with the same key already exists for this entity. Please use a different key from the existing index. |
| 0133 | Metadata Index Not Found | The specified metadata index does not exist. Please verify the index name and try again. |
| 0134 | Invalid Metadata Key Format | The metadata key format is invalid. Keys must start with a letter and contain only alphanumeric characters and underscores. |
| 0135 | Metadata Index Limit Exceeded | The maximum number of metadata indexes has been reached for this entity. Please delete unused indexes before creating new ones. |
| 0136 | Metadata Index Creation Failed | The metadata index could not be created. Please try again later or contact support. |
| 0137 | Metadata Index Deletion Forbidden | System indexes cannot be deleted. Please ensure you are deleting a custom metadata index. |
| 0138 | Invalid Entity Name | The provided entity name is not valid. |
| 0139 | Transaction Backup Cache Retrieval Failed | The transaction could not be retrieved from the backup cache internal function. Please ensure the transaction exists in the cache before processing balances. |
| 0140 | Invalid Timestamp | The provided timestamp is invalid. Timestamps cannot be in the future. |
| 0141 | No Balance Data at Date | No balance data is available at the specified date. |
| 0142 | Missing Required Query Parameter | The required query parameter is missing from the request. |
| 0143 | Payload Too Large | The request payload exceeds the maximum allowed size of 64KB. |
| 0144 | JSON Nesting Depth Exceeded | The JSON payload exceeds the maximum allowed nesting depth of 10 levels. Please flatten your data structure. |
| 0145 | JSON Key Count Exceeded | The JSON payload exceeds the maximum allowed number of keys (100). Please reduce the number of keys in your payload. |
| 0146 | Tenant Not Provisioned | The tenant has not been provisioned. Please ensure the tenant is properly configured. |
| 0147 | Unknown Settings Field | The settings contain an unknown field. Only known settings fields are allowed. |
| 0148 | Invalid Settings Field Type | A settings field has an invalid type. Please verify the expected type for the field. |
| 0149 | Settings Field at Root Level | A settings field must be nested under the correct parent key. Please verify the expected structure. |
| 0150 | Route Not Bidirectional | The operation route does not allow bidirectional transactions. Only routes with operation type ‘bidirectional’ can be reverted. |
| 0151 | Missing Counterpart | The route requires at least one debit and one credit operation (counterpart validation). |
| 0152 | Direction Route Mismatch | The operation direction is not compatible with the route operation type. |
| 0153 | No Source for Action | The action requires at least one source operation route. Please add a source route for this action. |
| 0154 | No Destination for Action | The action requires at least one destination operation route. Please add a destination route for this action. |
| 0155 | Invalid Route Action | The action is not a valid route action. Please provide a valid action value. |
| 0156 | Duplicate Action Route | The operation route is already assigned to the action. Please remove the duplicate entry. |
| 0157 | No Routes for Action | No routes found for the action. Please configure operation routes for this action in the transaction route. |
| 0158 | Too Many Operation Routes | The number of operation routes exceeds the maximum allowed. Please reduce the number of operation routes and try again. |
| 0159 | Service Suspended | The service is suspended for this tenant. |
| 0160 | Tenant Not Found | The specified tenant was not found. |
| 0161 | Tenant Service Unavailable | The tenant service is unavailable. Please try again later. |
| 0162 | Scenario Not Allowed For Direction | The accounting scenario is not allowed for the specified operation direction. |
| 0163 | Reserve Group Incomplete | The reserve group (hold, commit, cancel) must be complete. |
| 0164 | Direct Scenario Required | The direct scenario is required when other scenarios are present. |
| 0165 | Revert Only Bidirectional | The revert scenario is only allowed for bidirectional operation routes. |
| 0166 | Accounting Entry Field Required | A required field is missing in the accounting entry. |

