Skip to main content
“El Fees Engine devuelve respuestas de error consistentes y estructuradas. Esto le ayuda a comprender rápidamente qué salió mal y cómo solucionarlo.

​
Formato de error

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

​
Definiciones de campos

  • code – Un identificador único y estable para el error. Útil para el manejo programático y solicitudes de soporte.
  • title – Un resumen corto y legible del problema.
  • message – Orientación detallada para ayudarle a resolver el error.
Esta estructura garantiza que siempre obtenga retroalimentación procesable cuando algo no salga como se esperaba.

​
Errores del Fees Engine

Los siguientes errores pueden ocurrir al interactuar con los endpoints del Fees Engine. Cada error sigue nuestra estructura estándar, lo que facilita la depuración y respuesta a problemas de manera programática. Consulte la tabla a continuación para obtener una lista de posibles códigos de error, qué significan y cómo resolverlos.

​
400

CodeTitleMessage
FEE-0001Unexpected 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.
FEE-0002Missing 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.
FEE-0003Bad requestThe server could not understand the request due to malformed syntax. Please check the listed fields and try again.
FEE-0005Calculation field type invalidThe Calculation field type is invalid. Values can only be percentage or fixed.
FEE-0006Invalid query parameterOne or more query parameters are in an incorrect format. Please check the following parameters ‘parametros_erros’ and ensure they meet the required format before trying again.
FEE-0007Invalid date format errorThe ‘initialDate’, ‘finalDate’, or both are in the incorrect format. Please use the ‘yyyy-mm-dd’ format and try again.
FEE-0008Invalid final date errorThe ‘finalDate’ cannot be earlier than the ‘initialDate’. Please verify the dates and try again.
FEE-0009Date range exceeds limit errorThe range between ‘initialDate’ and ‘finalDate’ exceeds the permitted limit of %v months. Please adjust the dates and try again.
FEE-0010Invalid 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.
FEE-0011Pagination limit exceededThe pagination limit exceeds the maximum allowed of %v items per page. Please verify the limit and try again.
FEE-0012Entity 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.
FEE-0014Account not found MidazFailed to find account on Midaz. Please check the credit account passed.
FEE-0015minimumAmount greater than maximumAmountminimumAmount value is greater than maximumAmount.
FEE-0016Invalid path parameterPath parameters is in an incorrect format. Please check the following parameter and ensure they meet the required format before trying again.
FEE-0018Package already existsThere is a Package with same index values for [organizationId, ledgerId, segmentId, chartOfAccounts, minimumAmount, mininumAmountScale, maximumAmount, maximumAmountScale]
FEE-0019Invalid header parameterOne or more headers parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again.
FEE-0020Missing headerHeaders parameters is required. Please check the following header parameters %v and ensure they are passing the values correctly.
FEE-0022Failed to calculate feeError to make the calculation of a fee about a transaction.
FEE-0023Missing calculation modelThe calculation model is required to Fee.
FEE-0024originalAmount is required when priority is oneFor Priority equals to one, referenceAmount must be ‘originalAmount’ for fee.
FEE-0025Failed to apply rule: flatFee or percentualapplicationRule flatFee or percentual must have exactly 1 calculation for Fee.
FEE-0026Invalid calculation type: percentualThe calculation type percentual must be ‘percentage’ for Fee.
FEE-0027Invalid calculation type: flatFeeThe calculation type flatFee must be ‘flat’ for Fee.
FEE-0028Missing required fee fieldsAll fields of a new Fee must be filled. Please check again the payload passed.
FEE-0029Calculation field is required for feePlease fill the Calculation object correctly. All calculation fields must be filled.
FEE-0030referenceAmount is not validField reference amount must be originalAmount or afterFeesAmount.
FEE-0031Invalid applicationRuleField application rule must be maxBetweenTypes, flatFee or percentual.
FEE-0032Error Calculation Type InvalidField calculation type must be percentage or flat.
FEE-0033maximumAmount less than minimumAmountmaximumAmount value is less than minimumAmount.
FEE-0034Invalid maximumAmountScaleThe specified maximumAmountScale is not valid. It results in a maximumAmount that is less than the minimumAmount.
FEE-0035Invalid minimumAmountScaleThe specified minimumAmountScale is not valid. It results in a minimumAmount that is greater than the maximumAmount.
FEE-0036Failed to find package amount dataThe package does not contain amount data in the database.
FEE-0037Package filtering errorFailed to filter a single package by chartOfAccount, segmentID, and maximum/minimum amount. Either no package was found or multiple packages matched the criteria.
FEE-0038Package amount range overlapThe maximumAmount and minimumAmount of the new package overlap with the amount range of an existing package.
FEE-0039Invalid sort orderInvalid sort_order value. Expected ‘asc’ or ‘desc’.
FEE-0040Error to Distribute ValuesError to try distribute the values of Send object. Please check the data passed.
FEE-0041Failed to apply rule: maxBetweenTypesapplicationRule maxBetweenTypes must have more than 1 calculation for Fee %v.
FEE-0042Invalid segmentIDThe specified segmentID is not a valid UUID. Please check the value passed.
FEE-0043Invalid ledgerIDThe specified ledgerID is not a valid UUID. Please check the value passed.
FEE-0044Unmarshalling errorinvalid value for field ‘%s’: expected type ‘%s’, but got ‘%s’.

​
401

CodeTitleMessage
FEE-0013Invalid fee priorityThe priority field in fees is invalid. Field can not be repeated.

​
403

CodeTitleMessage
FEE-0017Nothing to updateFields not passed correctly. There is nothing to update.

​
500

CodeTitleMessage
FEE-0004Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.

​
503

CodeTitleMessage
FEE-0021Invalid transaction typeOnly one transaction type (‘amount’, ‘share’, or ‘remaining’) must be specified in the ‘%v’ field for each entry. Please review your input and try again.