Saltar al contenido principal
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:
codetitlemessage
0001Duplicate Ledger ErrorA ledger with the specified name already exists in this division. Please rename the ledger or choose a different division.
0002Ledger Name ConflictA 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.
0003Asset Name or Code DuplicateAn asset with the same name or code already exists in your ledger. Please modify the name or code of your new asset.
0004Code Uppercase RequirementThe code must be in uppercase. Please ensure that the code is in uppercase format and try again.
0005Currency Code Standard ComplianceCurrency-type assets must comply with the ISO-4217 standard. Please use a currency code that conforms to ISO-4217 guidelines.
0006Unmodifiable Field ErrorYour request includes a field that cannot be modified. Please review your request and try again, removing any uneditable fields.
0007Entity Not FoundNo entity was found for the given ID. Please make sure to use the correct ID for the entity you are trying to manage.
0008Action Not PermittedThis action is not permitted in the current environment. Contact an administrator if you believe this is an error.
0009Missing Fields in RequestYour request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.
0010Account Type ImmutableThe account type specified cannot be modified. Please ensure the correct account type is being used and try again.
0011Inactive Account Type ErrorThe account type specified cannot be set to INACTIVE. Please ensure the correct account type is being used and try again.
0012Account Balance Deletion ErrorAn account or sub-account cannot be deleted if it has a remaining balance. Please ensure all remaining balances are transferred before attempting to delete.
0013Resource Already DeletedThe resource you are trying to delete has already been deleted. Ensure you are using the correct ID and try again.
0014Segment ID InactiveThe segment with ID {{id}} is currently inactive. Please activate the segment before proceeding.
0015Duplicate Segment Name ErrorA segment with the name {{name}} already exists for this ledger ID {{ledgerId}}. Please try again with a different ledger or name.
0016Balance Remaining Deletion ErrorThe asset cannot be deleted because there is a remaining balance. Please ensure all balances are cleared before attempting to delete.
0017Invalid Script Format ErrorThe script provided in your request is invalid or in an unsupported format. Please verify the script format and try again.
0018Insufficient Funds ErrorThe transaction could not be completed due to insufficient funds in the account. Please add sufficient funds to your account and try again.
0019Account Ineligibility ErrorOne or more accounts listed in the transaction are not eligible to participate. Please review the account statuses and try again.
0020Alias Unavailability ErrorThe alias {{alias}} is already in use. Please choose a different alias and try again.
0021Parent Transaction ID Not FoundThe parentTransactionId {{parentTransactionId}} does not correspond to any existing transaction. Please review the ID and try again.
0022Immutable Field ErrorThe {{field}} field cannot be modified. Please remove this field from your request and try again.
0023Transaction Timing RestrictionYou can only perform another transaction using {{assetCode}} of {{amount}} from {{source}} to {{destination}} after {{timestampUnlock}}. Please wait until the specified time to try again.
0024Account Status Transaction RestrictionThe current statuses of the source and/or destination accounts do not permit transactions. Change the account status(es) and try again.
0025Insufficient Account Balance ErrorThe account {{accountId}} does not have sufficient balance. Please try again with an amount that is less than or equal to the available balance.
0026Transaction Method RestrictionTransactions involving {{assetCode}} are not permitted for the specified source and/or destination. Please try again using accounts that allow transactions with {{assetCode}}.
0027Duplicate Transaction Template Code ErrorA transaction template with the specified code already exists for your ledger. Please use a different code and try again.
0028Duplicate Asset Pair ErrorA pair for the specified assets already exists. Please update the existing entry instead of creating a new one.
0029Invalid Parent Account IDThe specified parent account ID does not exist. Please verify the ID is correct and try your request again.
0030Mismatched Asset CodeThe parent account ID is associated with a different asset code than the one specified. Please make sure the asset code matches the parent account.
0031Chart Type Not FoundThe specified chart type does not exist. Please provide a valid chart type and refer to the documentation.
0032Invalid Country CodeThe 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.
0033Invalid Code FormatThe ‘code’ field must be alphanumeric, in upper case, and must contain at least one letter. Please provide a valid code.
0034Asset Code Not FoundThe provided asset code does not exist in our records. Please verify the asset code and try again.
0035Portfolio ID Not FoundThe provided portfolio ID does not exist in our records. Please verify the portfolio ID and try again.
0036Segment ID Not FoundThe provided segment ID does not exist in our records. Please verify the segment ID and try again.
0037Ledger ID Not FoundThe provided ledger ID does not exist in our records. Please verify the ledger ID and try again.
0038Organization ID Not FoundThe provided organization ID does not exist in our records. Please verify the organization ID and try again.
0039Parent Organization ID Not FoundThe provided parent organization ID does not exist in our records. Please verify the parent organization ID and try again.
0040Invalid TypeThe provided ‘type’ is not valid. Accepted types are: currency, crypto, commodities, or others. Please provide a valid type.
0041Token MissingA valid token must be provided in the request header. Please include a token and try again.
0042Invalid TokenThe provided token is expired, invalid or malformed. Please provide a valid token and try again.
0043Insufficient PrivilegesYou do not have the necessary permissions to perform this action. Please contact your administrator if you believe this is an error.
0044Permission Enforcement ErrorThe enforcer is not configured properly. Please contact your administrator if you believe this is an error.
0045JWK Fetch ErrorThe JWK keys could not be fetched from the source. Please verify the source environment variable configuration and try again.
0046Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.
0047Bad RequestThe server could not understand the request due to malformed syntax. Please check the listed fields and try again.
0048Invalid DSL File FormatThe submitted DSL file is in an incorrect format. Please ensure that the file follows the expected structure and syntax.
0049Empty DSL FileThe submitted DSL file is empty. Please provide a valid file with content.
0050Metadata Key Length ExceededThe metadata key {{key}} exceeds the maximum allowed length. Please use a shorter key.
0051Metadata Value Length ExceededThe metadata value {{key}} exceeds the maximum allowed length. Please use a shorter value.
0052Account ID Not FoundThe provided account ID does not exist in our records. Please verify the account ID and try again.
0053Unexpected Fields in the RequestThe 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.
0054IDs Not Found for AccountsNo accounts were found for the provided IDs. Please verify the IDs and try again.
0055Asset ID Not FoundThe specified asset ID does not exist in the provided ledger. Please verify the asset ID and try again.
0056No Assets FoundNo assets were found for the specified ledger. Please create an asset or verify the ledger exists.
0057No Segments FoundNo segments were found for the specified ledger. Please create a segment or verify the ledger exists.
0058No Portfolios FoundNo portfolios were found for the specified ledger. Please create a portfolio or verify the ledger exists.
0059No Organizations FoundNo organizations were found in the search. Please review the search criteria and try again.
0060No Ledgers FoundNo ledgers were found in the search. Please review the search criteria and try again.
0061Balance Update FailedThe balance could not be updated for the specified account ID. Please verify the account ID and try again.
0062No Account IDs ProvidedNo account IDs were provided for the balance update. Please provide valid account IDs and try again.
0063Failed To Retrieve Accounts By AliasesThe accounts could not be retrieved using the specified aliases. Please verify the aliases for accuracy and try again.
0064No Accounts FoundNo accounts were found in the search. Please review the search criteria and try again.
0065Invalid Path ParameterThe provided path parameter {{parameter_name}} is not in the expected format. Please ensure the parameter adheres to the required format and try again.
0066Invalid Account TypeThe provided ‘type’ is not valid. Accepted types are: deposit, savings, loans, marketplace, cerditCard or external. Please provide a valid type.
0067Invalid Metadata NestingThe metadata object cannot contain nested values. Please ensure that the value {{value}} is not nested and try again.
0068Operation ID Not FoundThe provided operation ID does not exist in our records. Please verify the operation ID and try again.
0069No Operations FoundNo operations were found for the given query parameters. Please adjust your filters and try again.
0070Transaction ID Not FoundThe provided transaction ID does not exist in our records. Please verify the transaction ID and try again.
0071No Transactions FoundNo transactions were found for the given query parameters. Please adjust your filters and try again.
0072Invalid Transaction TypeOnly one transaction type (amount, share, or remaining) must be specified for each entry. Please review your input and try again.
0073Transaction Value MismatchThe values for the source, the destination, or both do not match the specified transaction amount. Please verify the values and try again.
0074External Account Modification ProhibitedAccounts 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.
0075Audit Record Not RetrievedThe record could not be retrieved for audit. Please verify that the submitted data is correct and try again.
0076Audit Tree Record Not FoundThe record does not exist in the audit tree. Please ensure the audit tree is available and try again.
0077Invalid Date Format ErrorThe initialDate, finalDate, or both are in the incorrect format. Please use the yyyy-mm-dd format and try again.
0078Invalid Final Date ErrorThe finalDate cannot be earlier than the initialDate. Please verify the dates and try again.
0079Date Range Exceeds Limit ErrorThe range between ‘initialDate’ and ‘finalDate’ exceeds the permitted limit of {{limit}} months. Please adjust the dates and try again.
0080Pagination Limit ExceededThe pagination limit exceeds the maximum allowed of {{pageLimit}} items per page. Please verify the limit and try again.
0081Invalid Sort OrderThe ‘sort_order’ field must be ‘asc’ or ‘desc’. Please provide a valid sort order and try again.
0082Invalid Query ParameterOne 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.
0083Invalid Date Range ErrorBoth ‘initialDate’ and ‘finalDate’ fields are required and must be in the ‘yyyy-mm-dd’ format. Please provide valid dates and try again.
0084Duplicate Idempotency KeyThe idempotency key ‘{{key}}’ is already in use. Please provide a unique key and try again.
0085Account Alias Not FoundThe provided account Alias does not exist in our records. Please verify the account Alias and try again.
0086Race condition detectedA race condition was detected while processing your request. Please try again
0087Transaction Revert already existTransaction revert already exists. Please try again.
0088Transaction is already a reversalTransaction is already a reversal. Please try again
0089Transaction can’t be revertedTransaction can’t be reverted. Please try again
0090Transaction Ambiguous AccountTransaction cannot use the same account in sources and destinations.
0091ID cannot be used as the parent IDThe provided ID cannot be used as the parent ID. Please choose a different one.
0092No Balances FoundNo balances were found for the given query parameters. Please adjust your filters and try again.
0093Balance Cannot Be DeletedBalance cannot be deleted because it still has funds in it or has active operations.
0094Invalid Request BodyThe request body is invalid or could not be parsed. Please check JSON structure and field types.
0095Message Broker UnavailableThe server encountered an unexpected error while connecting to Message Broker. Please try again later or contact support.
0096Invalid Account AliasThe alias contains invalid characters. Please verify the alias value and try again.
0097Overflow ErrorThe request could not be completed due to an overflow. Please check the values and try again.
0098Invalid Pending TransactionExternal accounts cannot be used for pending transactions in source operations. Please check the accounts and try again.
0099Transaction Status InvalidTransaction cannot be reverted because its status is not APPROVED
0100Operation Route Title Already ExistsAn operation route with the specified title already exists. Please use a different title and try again.
0101Operation Route Not FoundThe provided operation route does not exist in our records. Please verify the operation route and try again.
0102No Operation Routes FoundNo operation routes were found for the given query parameters. Please adjust your filters and try again.
0103Invalid Operation Route TypeThe provided operation route type is not valid. Accepted types are ‘source’ or ‘destination’. Please provide a valid operation type.
0104Missing Operation Routes in RequestYour 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.
0105Transaction Route Not FoundThe provided transaction route does not exist in our records. Please verify the transaction route and try again.
0106No Transaction Routes FoundNo transaction routes were found for the given query parameters. Please adjust your filters and try again.
0107Operation Route Linked to Transaction RoutesThe 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.
0108Duplicate Account Type Key Value ErrorAn 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.
0109Account Type Not Found ErrorThe account type you are trying to access does not exist or has been removed.
0110No Account Types FoundNo account types were found for the specified ledger. Please create an account type or verify the ledger exists.
0111Invalid Account Rule TypeThe provided ‘account.ruleType’ is not valid. Accepted types are ‘alias’ or ‘account_type’. Please provide a valid rule type.
0112Invalid Account Rule ValueThe provided ‘account.validIf’ is not valid. Please provide a string for ‘alias’ or an array of strings for ‘account_type’.
0113Corrupted Account RuleThe 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.
0114Transaction Route Not InformedThe transaction route is not informed. Please inform the transaction route for this transaction.
0115Invalid Transaction Route IDThe provided transaction route ID is not a valid UUID format. Please provide a valid UUID for the transaction route.
0116Accounting Route Count MismatchThe operation routes count does not match the transaction route cache. Please verify your route configuration.
0117Accounting Route Not FoundThe operation route ID was not found in the transaction route cache. Please verify the route configuration.
0118Accounting Alias Validation FailedThe operation alias does not match the expected alias defined in the accounting route rule.
0119Accounting Account Type Validation FailedThe account type does not match any of the expected account types defined in the accounting route rule.
0120Invalid CharactersThe field ‘keyValue’ contains invalid characters. Use only letters, numbers, underscores and hyphens.
0121Invalid Future Date ErrorThe transactionDate cannot be a future date. Please provide a valid date.
0122Invalid Field for Pending Transaction ErrorPending transactions do not support the transactionDate field. To proceed, please remove it from your request.
0123Duplicated Alias Key Value ErrorAn account alias with the specified key value already exists for this organization and ledger. Please use a different key value.
0124Additional Balance Creation Not AllowedAdditional balances are not allowed for external account type.
0125Invalid Transaction ValueNegative or zero transaction values are not allowed. The send_value must be greater than zero.
0126Default Balance Not FoundDefault balance must be created first for this account.
0127Account Creation FailedThe account could not be created because the default balance could not be created. Please try again.
0128Transaction Backup Cache FailedThe server encountered an unexpected error while adding the transaction to the backup cache. Please try again later or contact support.
0129Transaction Backup Cache Marshal FailedThe 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.
0131Invalid Datetime Format ErrorThe parameter is in the incorrect format. Please use the correct datetime format and try again.
0132Metadata Index Already ExistsA metadata index with the same key already exists for this entity. Please use a different key from the existing index.
0133Metadata Index Not FoundThe specified metadata index does not exist. Please verify the index name and try again.
0134Invalid Metadata Key FormatThe metadata key format is invalid. Keys must start with a letter and contain only alphanumeric characters and underscores.
0135Metadata Index Limit ExceededThe maximum number of metadata indexes has been reached for this entity. Please delete unused indexes before creating new ones.
0136Metadata Index Creation FailedThe metadata index could not be created. Please try again later or contact support.
0137Metadata Index Deletion ForbiddenSystem indexes cannot be deleted. Please ensure you are deleting a custom metadata index.
0138Invalid Entity NameThe provided entity name is not valid.
0139Transaction Backup Cache Retrieval FailedThe transaction could not be retrieved from the backup cache internal function. Please ensure the transaction exists in the cache before processing balances.
0140Invalid TimestampThe provided timestamp is invalid. Timestamps cannot be in the future.
0141No Balance Data at DateNo balance data is available at the specified date.
0142Missing Required Query ParameterThe required query parameter is missing from the request.
0143Payload Too LargeThe request payload exceeds the maximum allowed size of 64KB.
0144JSON Nesting Depth ExceededThe JSON payload exceeds the maximum allowed nesting depth of 10 levels. Please flatten your data structure.
0145JSON Key Count ExceededThe JSON payload exceeds the maximum allowed number of keys (100). Please reduce the number of keys in your payload.
0146Tenant Not ProvisionedThe tenant has not been provisioned. Please ensure the tenant is properly configured.
0147Unknown Settings FieldThe settings contain an unknown field. Only known settings fields are allowed.
0148Invalid Settings Field TypeA settings field has an invalid type. Please verify the expected type for the field.
0149Settings Field at Root LevelA settings field must be nested under the correct parent key. Please verify the expected structure.
0150Route Not BidirectionalThe operation route does not allow bidirectional transactions. Only routes with operation type ‘bidirectional’ can be reverted.
0151Missing CounterpartThe route requires at least one debit and one credit operation (counterpart validation).
0152Direction Route MismatchThe operation direction is not compatible with the route operation type.
0153No Source for ActionThe action requires at least one source operation route. Please add a source route for this action.
0154No Destination for ActionThe action requires at least one destination operation route. Please add a destination route for this action.
0155Invalid Route ActionThe action is not a valid route action. Please provide a valid action value.
0156Duplicate Action RouteThe operation route is already assigned to the action. Please remove the duplicate entry.
0157No Routes for ActionNo routes found for the action. Please configure operation routes for this action in the transaction route.
0158Too Many Operation RoutesThe number of operation routes exceeds the maximum allowed. Please reduce the number of operation routes and try again.
0159Service SuspendedThe service is suspended for this tenant.
0160Tenant Not FoundThe specified tenant was not found.
0161Tenant Service UnavailableThe tenant service is unavailable. Please try again later.
0162Scenario Not Allowed For DirectionThe accounting scenario is not allowed for the specified operation direction.
0163Reserve Group IncompleteThe reserve group (hold, commit, cancel) must be complete.
0164Direct Scenario RequiredThe direct scenario is required when other scenarios are present.
0165Revert Only BidirectionalThe revert scenario is only allowed for bidirectional operation routes.
0166Accounting Entry Field RequiredA required field is missing in the accounting entry.