Saltar al contenido principal
El Fees Engine devuelve respuestas de error consistentes y estructuradas. Esto te ayuda a entender 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 estable y único para el error. Útil para el manejo programático y solicitudes de soporte.
  • title – Un resumen breve y legible del problema.
  • message – Orientación detallada para ayudarte a resolver el error.
Esta estructura asegura que siempre obtengas retroalimentación accionable cuando algo no sale como se esperaba.

​
Errores de Fees Engine

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

​
400

CódigoTítuloMensajeTraducción
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.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 se enumeran en el objeto de campos.
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.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.
FEE-0003Bad requestThe 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 indicados e intente de nuevo.
FEE-0005Calculation field type invalidThe Calculation field type is invalid. Values can only be percentage or flat.El tipo de campo de Cálculo es inválido. Los valores solo pueden ser percentage o flat.
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.Uno o más parámetros de consulta tienen un formato incorrecto. Por favor, verifique los siguientes parámetros ‘parametros_erros’ y asegúrese de que cumplan con el formato requerido antes de intentar de nuevo.
FEE-0007Invalid date format errorThe ‘initialDate’, ‘finalDate’, or both are in the incorrect format. Please use the ‘yyyy-mm-dd’ format and try again.El ‘initialDate’, ‘finalDate’, o ambos tienen un formato incorrecto. Por favor, use el formato ‘yyyy-mm-dd’ e intente de nuevo.
FEE-0008Invalid final date errorThe ‘finalDate’ cannot be earlier than the ‘initialDate’. Please verify the dates and try again.El ‘finalDate’ no puede ser anterior al ‘initialDate’. Por favor, verifique las fechas e intente de nuevo.
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.El rango entre ‘initialDate’ y ‘finalDate’ excede el límite permitido de %v meses. Por favor, ajuste las fechas e intente de nuevo.
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.Ambos campos ‘initialDate’ y ‘finalDate’ son obligatorios y deben estar en el formato ‘yyyy-mm-dd’. Por favor, proporcione fechas válidas e intente de nuevo.
FEE-0011Pagination limit exceededThe pagination limit exceeds the maximum allowed of %v items per page. Please verify the limit and try again.El límite de paginación excede el máximo permitido de %v elementos por página. Por favor, verifique el límite e intente de nuevo.
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.No se encontró ninguna entidad para el ID proporcionado. Por favor, asegúrese de usar el ID correcto para la entidad que está intentando gestionar.
FEE-0014Account not found on MidazFailed to find account ‘%v’ on Midaz. Please check the creditaccount passed.No se pudo encontrar la cuenta ‘%v’ en Midaz. Por favor, verifique la creditaccount proporcionada.
FEE-0015minimumAmount greater than maximumAmountminimumAmount value is greater than maximumAmount.El valor de minimumAmount es mayor que 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.Los parámetros de ruta tienen un formato incorrecto. Por favor, verifique el siguiente parámetro y asegúrese de que cumpla con el formato requerido antes de intentar de nuevo.
FEE-0018Package already existsThere is a Package with same index values for [organizationId, ledgerId, segmentId, transactionRoute, minimumAmount, maximumAmount]Ya existe un Package con los mismos valores de índice para [organizationId, ledgerId, segmentId, transactionRoute, minimumAmount, maximumAmount]
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.Uno o más parámetros de encabezado tienen un formato incorrecto. Por favor, verifique los siguientes parámetros y asegúrese de que cumplan con el formato requerido antes de intentar de nuevo.
FEE-0020Missing headerHeaders parameters is required. Please check the following header parameters %v and ensure they are passing the values correctly.Los parámetros de encabezado son obligatorios. Por favor, verifique los siguientes parámetros de encabezado %v y asegúrese de que estén pasando los valores correctamente.
FEE-0022Failed to calculate feeError to make the calculation of a fee about a transaction.Error al realizar el cálculo de una tarifa sobre una transacción.
FEE-0023Missing calculation modelThe calculation model is required to Fee.El modelo de cálculo es obligatorio para Fee.
FEE-0024originalAmount is required when priority is oneFor Priority equals to one, referenceAmount must be ‘originalAmount’ for fee.Para Priority igual a uno, referenceAmount debe ser ‘originalAmount’ para fee.
FEE-0025Failed to apply rule: flatFee or percentualapplicationRule flatFee or percentual must have exactly 1 calculation for Fee.La applicationRule flatFee o percentual debe tener exactamente 1 cálculo para Fee.
FEE-0026Invalid calculation type: percentualThe calculation type percentual must be ‘percentage’ for Fee.El tipo de cálculo percentual debe ser ‘percentage’ para Fee.
FEE-0027Invalid calculation type: flatFeeThe calculation type flatFee must be ‘flat’ for Fee.El tipo de cálculo flatFee debe ser ‘flat’ para Fee.
FEE-0028Missing required fee fieldsAll fields of a new Fee must be filled. Please check again the payload passed.Todos los campos de una nueva Fee deben estar completados. Por favor, verifique nuevamente el payload proporcionado.
FEE-0029Calculation field is required for feePlease fill the Calculation object correctly. All calculation fields must be filled.Por favor, complete el objeto Calculation correctamente. Todos los campos de cálculo deben estar completados.
FEE-0030referenceAmount is not validField reference amount must be originalAmount or afterFeesAmount.El campo reference amount debe ser originalAmount o afterFeesAmount.
FEE-0031Invalid applicationRuleField application rule must be maxBetweenTypes, flatFee or percentual.El campo application rule debe ser maxBetweenTypes, flatFee o percentual.
FEE-0032Invalid calculation typeField calculation type must be percentage or flat.El campo calculation type debe ser percentage o flat.
FEE-0033maximumAmount less than minimumAmountmaximumAmount value is less than minimumAmount.El valor de maximumAmount es menor que minimumAmount.
FEE-0034Package filtering errorFailed to filter a single package by transactionRoute, segmentID, and maximum/minimum amount. Either no package was found or multiple packages matched the criteria.No se pudo filtrar un solo paquete por transactionRoute, segmentID y monto máximo/mínimo. No se encontró ningún paquete o varios paquetes coincidieron con los criterios.
FEE-0035Package amount range overlapThe maximumAmount and minimumAmount of the new package overlap with the amount range of an existing package.El maximumAmount y minimumAmount del nuevo paquete se solapan con el rango de montos de un paquete existente.
FEE-0036Invalid sort orderInvalid ‘sort_order’ value. Expected ‘asc’ or ‘desc’.Valor de ‘sort_order’ inválido. Se esperaba ‘asc’ o ‘desc’.
FEE-0037Error to distribute valuesError to try distribute the values of send object. Please check the data passed.Error al intentar distribuir los valores del objeto enviado. Por favor, verifique los datos proporcionados.
FEE-0038Failed to apply rule: maxBetweenTypesapplicationRule maxBetweenTypes must have more than 1 calculation for Fee %v.La applicationRule maxBetweenTypes debe tener más de 1 cálculo para Fee %v.
FEE-0039Invalid segmentIDThe specified segmentID is not a valid UUID. Please check the value passed.El segmentID especificado no es un UUID válido. Por favor, verifique el valor proporcionado.
FEE-0040Invalid ledgerIDThe specified ledgerID is not a valid UUID. Please check the value passed.El ledgerID especificado no es un UUID válido. Por favor, verifique el valor proporcionado.
FEE-0041Unmarshalling errorInvalid value for field ‘%s’: expected type ‘%s’, but got ‘%s’.Valor inválido para el campo ‘%s’: se esperaba el tipo ‘%s’, pero se obtuvo ‘%s’.
FEE-0042Error to convert valuesThe value of the field %s is invalid. Remember to use dot (.) as decimal separator instead of comma (,). Example: use 1000.50 instead of 1000,50.El valor del campo %s es inválido. Recuerde usar punto (.) como separador decimal en lugar de coma (,). Ejemplo: use 1000.50 en lugar de 1000,50.
FEE-0043originalAmount is required when isDeductibleFrom is trueFor isDeductibleFrom true, referenceAmount must be ‘originalAmount’ for ‘%s’.Para isDeductibleFrom true, referenceAmount debe ser ‘originalAmount’ para ‘%s’.
FEE-0044applicationRule invalid valueapplicationRule is invalid, Err: %v.applicationRule es inválido, Err: %v.
FEE-0045forbidden to access MidazError to access Midaz. Please check the client credentials to access Midaz for creditAccount %v validation.Error al acceder a Midaz. Por favor, verifique las credenciales del cliente para acceder a Midaz para la validación de creditAccount %v.
FEE-0046calculation value percentage invalidCalculation value is invalid can not utrapass 100%%. Please check the calculation value for Fee %v..El valor de cálculo es inválido, no puede superar el 100%%. Por favor, verifique el valor de cálculo para Fee %v..
FEE-0047calculation value flat invalidCalculation value is invalid can not utrapass the minimum amount %v. Please check the calculation value for Fee %v.El valor de cálculo es inválido, no puede superar el monto mínimo %v. Por favor, verifique el valor de cálculo para Fee %v.
FEE-0048error to access MidazError to access Midaz to validate creditAccount %v. Please check the client credentials to access Midaz.Error al acceder a Midaz para validar creditAccount %v. Por favor, verifique las credenciales del cliente para acceder a Midaz.
FEE-0049deductible value forbiddenCan not update deductible value to true. The calculation value is bigger than 100%% for Fee %v.No se puede actualizar el valor deductible a true. El valor de cálculo es mayor que 100%% para Fee %v.
FEE-0050deductible value forbiddenCan not update deductible value to true. Calculation value is bigger than the minimum amount %v for Fee %v.No se puede actualizar el valor deductible a true. El valor de cálculo es mayor que el monto mínimo %v para Fee %v.
FEE-0051Invalid page parameterQuery parameter page is invalid. The page must be greater than 0.El parámetro de consulta page es inválido. La página debe ser mayor que 0.

​
401

CódigoTítuloMensajeTraducción
FEE-0013Invalid fee priorityThe priority field in fees is invalid. Field can not be repeated.El campo de prioridad en fees es inválido. El campo no puede estar repetido.

​
403

CódigoTítuloMensajeTraducción
FEE-0017Nothing to updateFields not passed correctly. There is nothing to update.Los campos no se proporcionaron correctamente. No hay nada que actualizar.

​
500

CódigoTítuloMensajeTraducción
FEE-0004Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.El servidor encontró un error inesperado. Por favor, intente de nuevo más tarde o contacte a soporte.

​
503

CódigoTítuloMensajeTraducción
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.Solo se debe especificar un tipo de transacción (‘amount’, ‘share’ o ‘remaining’) en el campo ‘%v’ para cada entrada. Por favor, revise su entrada e intente de nuevo.