> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Lista de errores de Fees Engine > El **Fees Engine** devuelve respuestas de error consistentes y estructuradas. Esto te ayuda a comprender rápidamente qué salió mal y cómo solucionarlo. 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** ```jsonon JSON theme={null} { "code": "", "title": "", "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 | `code` | `title` | `message` | | -------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FEE-0001 | 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. | | FEE-0002 | 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. | | FEE-0003 | Bad request | The server could not understand the request due to malformed syntax. Please check the listed fields and try again. | | FEE-0005 | Calculation field type invalid | The Calculation field type is invalid. Values can only be percentage or flat. | | FEE-0006 | Invalid query parameter | One 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-0007 | Invalid date format error | The 'initialDate', 'finalDate', or both are in the incorrect format. Please use the 'yyyy-mm-dd' format and try again. | | FEE-0008 | Invalid final date error | The 'finalDate' cannot be earlier than the 'initialDate'. Please verify the dates and try again. | | FEE-0009 | Date range exceeds limit error | The range between 'initialDate' and 'finalDate' exceeds the permitted limit of %v months. Please adjust the dates and try again. | | FEE-0010 | 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. | | FEE-0011 | Pagination limit exceeded | The pagination limit exceeds the maximum allowed of %v items per page. Please verify the limit and try again. | | FEE-0012 | 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. | | FEE-0013 | Invalid fee priority | The priority field in fees is invalid. Field can not be repeated. | | FEE-0014 | Account not found on Midaz | Failed to find account '%v' on Midaz. Please check the account alias passed. | | FEE-0015 | minimumAmount greater than maximumAmount | minimumAmount value is greater than maximumAmount. | | FEE-0016 | Invalid path parameter | Path parameters is in an incorrect format. Please check the following parameter and ensure they meet the required format before trying again. | | FEE-0017 | Nothing to update | No updatable fields were provided. Please include at least one field to update. | | FEE-0018 | Package already exists | There is a Package with same index values for \[organizationId, ledgerId, segmentId, transactionRoute, minimumAmount, maximumAmount] | | FEE-0019 | Invalid header parameter | One 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-0021 | Invalid transaction type | Only one transaction type ('amount', 'share', or 'remaining') must be specified in the '%v' field for each entry. Please review your input and try again. | | FEE-0020 | Missing header | Headers parameters is required. Please check the following header parameters %v and ensure they are passing the values correctly. | | FEE-0022 | Failed to calculate fee | Error to make the calculation of a fee about a transaction. | | FEE-0023 | Missing calculation model | The calculation model is required to Fee. | | FEE-0024 | originalAmount is required when priority is one | For Priority equals to one, referenceAmount must be 'originalAmount' for fee. | | FEE-0025 | Failed to apply rule: flatFee or percentual | applicationRule flatFee or percentual must have exactly 1 calculation for Fee. | | FEE-0026 | Invalid calculation type: percentual | The calculation type percentual must be 'percentage' for Fee. | | FEE-0027 | Invalid calculation type: flatFee | The calculation type flatFee must be 'flat' for Fee. | | FEE-0028 | Missing required fee fields | All fields of a new Fee must be filled. Please check again the payload passed. | | FEE-0029 | Calculation field is required for fee | Please fill the Calculation object correctly. All calculation fields must be filled. | | FEE-0030 | referenceAmount is not valid | Field reference amount must be originalAmount or afterFeesAmount. | | FEE-0031 | Invalid applicationRule | Field application rule must be maxBetweenTypes, flatFee or percentual. | | FEE-0032 | Invalid calculation type | Field calculation type must be percentage or flat. | | FEE-0033 | maximumAmount less than minimumAmount | maximumAmount value is less than minimumAmount. | | FEE-0034 | Package filtering error | Failed to filter a single package by transactionRoute, segmentID, and maximum/minimum amount. Either no package was found or multiple packages matched the criteria. | | FEE-0035 | Package amount range overlap | The maximumAmount and minimumAmount of the new package overlap with the amount range of an existing package. | | FEE-0036 | Invalid sort order | Invalid 'sort\_order' value. Expected 'asc' or 'desc'. | | FEE-0037 | Error to distribute values | Error to try distribute the values of send object. Please check the data passed. | | FEE-0038 | Failed to apply rule: maxBetweenTypes | applicationRule maxBetweenTypes must have more than 1 calculation for Fee %v. | | FEE-0039 | Invalid segmentID | The specified segmentID is not a valid UUID. Please check the value passed. | | FEE-0040 | Invalid ledgerID | The specified ledgerID is not a valid UUID. Please check the value passed. | | FEE-0041 | Unmarshalling error | Invalid value for field '%s': expected type '%s', but got '%s'. | | FEE-0042 | Error to convert values | The 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. | | FEE-0043 | originalAmount is required when isDeductibleFrom is true | For isDeductibleFrom `true`, referenceAmount must be 'originalAmount' for '%s'. | | FEE-0044 | applicationRule invalid value | applicationRule is invalid, Err: %v. | | FEE-0045 | forbidden to access Midaz | Error to access Midaz. Please check the client credentials to access Midaz for creditAccount %v validation. | | FEE-0046 | calculation value percentage invalid | Calculation value is invalid can not utrapass 100%%. Please check the calculation value for Fee %v.. | | FEE-0047 | calculation value flat invalid | Calculation value is invalid can not utrapass the minimum amount %v. Please check the calculation value for Fee %v. | | FEE-0048 | error to access Midaz | Error to access Midaz to validate creditAccount %v. Please check the client credentials to access Midaz. | | FEE-0049 | deductible value forbidden | Can not update deductible value to true. The calculation value is bigger than 100%% for Fee %v. | | FEE-0050 | deductible value forbidden | Can not update deductible value to true. Calculation value is bigger than the minimum amount %v for Fee %v. | | FEE-0051 | Invalid page parameter | Query parameter page is invalid. The page must be greater than 0. | | FEE-0053 | Invalid billing package type | The billing package type is invalid. Valid types are 'volume' and 'maintenance'. | | FEE-0054 | Missing volume fields | Volume billing packages require: eventFilter (transactionRoute, status), pricingModel, tiers, assetCode, debitAccountAlias, and creditAccountAlias. | | FEE-0055 | Missing maintenance fields | Maintenance billing packages require: feeAmount, assetCode, maintenanceCreditAccount, and accountTarget. | | FEE-0056 | Invalid pricing model | The pricing model is invalid. Valid models are 'tiered' and 'fixed'. | | FEE-0057 | Invalid pricing tier | Pricing tier configuration is invalid. Each tier must have minQuantity and unitPrice. Tiers must not overlap. | | FEE-0058 | Billing route overlap | A billing package already exists for this organization, ledger, and transaction route combination. | | FEE-0063 | Invalid billing period | The billing period format is invalid. Use 'YYYY-MM' (monthly), 'YYYY-Www' (weekly), or 'YYYY-MM-DD' (daily) format. | | FEE-0064 | Invalid free quota | The free quota value is invalid. Must be a non-negative integer. | | FEE-0065 | Invalid discount tier | Discount tier configuration is invalid. Each tier must have minQuantity and discountPercentage between 0 and 100. | | FEE-0067 | Invalid count mode | The count mode is invalid. Valid modes are 'perRoute' and 'perAccount'. | | FEE-0069 | Invalid account target | The accountTarget must have exactly one of segmentId, portfolioId, or aliases. Aliases limited to 100 entries. | | FEE-0070 | Invalid fee amount | The fee amount is invalid. It must be a positive value greater than zero. | ### 404 | `code` | `title` | `message` | | -------- | -------------------------- | -------------------------------------------------------------------------------- | | FEE-0052 | Billing package not found | No billing package was found for the given ID. | | FEE-0059 | Target account not found | The target account was not found or is inactive in Midaz. | | FEE-0061 | No active billing packages | No active billing packages were found for the specified organization and ledger. | ### 422 | `code` | `title` | `message` | | -------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------- | | FEE-0060 | Billing calculation failed | Failed to calculate billing. Check the error details for the specific package and resource that caused the failure. | | FEE-0062 | Segment resolution failed | Failed to resolve accounts for the configured segment. Verify the segment exists and try again. | | FEE-0068 | Service dependency unavailable | A required service is temporarily unavailable. Please try again later. | ### 500 | `code` | `title` | `message` | | -------- | --------------------- | -------------------------------------------------------------------------------------- | | FEE-0004 | Internal Server Error | The server encountered an unexpected error. Please try again later or contact support. |