Pular para o conteúdo principal
Formato do erro 
{
   "code": "<error_code>",
   "title": "<error_title>",
   "message": "<error_message>"
}
Definição dos campos
  • code – Um identificador único e estável para o erro. Útil para tratamento programático e solicitações de suporte.
  • title – Um resumo curto e legível do problema.
  • message – Orientação detalhada para ajudá-lo a resolver o erro.
Essa estrutura garante que você sempre receba feedback acionável quando algo não sair como esperado.

​
Erros do Fees Engine

Os seguintes erros podem ocorrer ao interagir com os endpoints do Fees Engine. Cada erro segue nossa estrutura padrão, facilitando a depuração e a resposta a problemas de forma programática. Consulte a tabela abaixo para uma lista de possíveis códigos de erro, o que eles significam e como resolvê-los.

​
400

CódigoTítuloMensagemTradução
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.O corpo da requisição contém mais campos do que o esperado. Por favor, envie apenas os campos permitidos conforme a documentação. Os campos inesperados estão listados no objeto fields.
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.Sua requisição está sem um ou mais campos obrigatórios. Por favor, consulte a documentação para garantir que todos os campos necessários estejam incluídos na sua requisição.
FEE-0003Bad requestThe server could not understand the request due to malformed syntax. Please check the listed fields and try again.O servidor não conseguiu entender a requisição devido à sintaxe malformada. Por favor, verifique os campos listados e tente novamente.
FEE-0005Calculation field type invalidThe Calculation field type is invalid. Values can only be percentage or flat.O tipo do campo Calculation é inválido. Os valores só podem ser percentage ou 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.Um ou mais parâmetros de consulta estão em formato incorreto. Por favor, verifique os seguintes parâmetros ‘parametros_erros’ e garanta que atendam ao formato exigido antes de tentar novamente.
FEE-0007Invalid date format errorThe ‘initialDate’, ‘finalDate’, or both are in the incorrect format. Please use the ‘yyyy-mm-dd’ format and try again.O ‘initialDate’, ‘finalDate’, ou ambos estão em formato incorreto. Por favor, use o formato ‘yyyy-mm-dd’ e tente novamente.
FEE-0008Invalid final date errorThe ‘finalDate’ cannot be earlier than the ‘initialDate’. Please verify the dates and try again.O ‘finalDate’ não pode ser anterior ao ‘initialDate’. Por favor, verifique as datas e tente novamente.
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.O intervalo entre ‘initialDate’ e ‘finalDate’ excede o limite permitido de %v meses. Por favor, ajuste as datas e tente novamente.
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 os campos ‘initialDate’ e ‘finalDate’ são obrigatórios e devem estar no formato ‘yyyy-mm-dd’. Por favor, forneça datas válidas e tente novamente.
FEE-0011Pagination limit exceededThe pagination limit exceeds the maximum allowed of %v items per page. Please verify the limit and try again.O limite de paginação excede o máximo permitido de %v itens por página. Por favor, verifique o limite e tente novamente.
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.Nenhuma entidade foi encontrada para o ID fornecido. Por favor, certifique-se de usar o ID correto para a entidade que você está tentando gerenciar.
FEE-0014Account not found on MidazFailed to find account ‘%v’ on Midaz. Please check the creditaccount passed.Falha ao encontrar a conta ‘%v’ no Midaz. Por favor, verifique o creditaccount informado.
FEE-0015minimumAmount greater than maximumAmountminimumAmount value is greater than maximumAmount.O valor de minimumAmount é maior 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.O parâmetro de caminho está em formato incorreto. Por favor, verifique o seguinte parâmetro e garanta que atenda ao formato exigido antes de tentar novamente.
FEE-0018Package already existsThere is a Package with same index values for [organizationId, ledgerId, segmentId, transactionRoute, minimumAmount, maximumAmount]Já existe um Package com os mesmos 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.Um ou mais parâmetros de cabeçalho estão em formato incorreto. Por favor, verifique os seguintes parâmetros e garanta que atendam ao formato exigido antes de tentar novamente.
FEE-0020Missing headerHeaders parameters is required. Please check the following header parameters %v and ensure they are passing the values correctly.Os parâmetros de cabeçalho são obrigatórios. Por favor, verifique os seguintes parâmetros de cabeçalho %v e garanta que estejam passando os valores corretamente.
FEE-0022Failed to calculate feeError to make the calculation of a fee about a transaction.Erro ao realizar o cálculo de uma taxa sobre uma transação.
FEE-0023Missing calculation modelThe calculation model is required to Fee.O modelo de cálculo é obrigatório para a Fee.
FEE-0024originalAmount is required when priority is oneFor Priority equals to one, referenceAmount must be ‘originalAmount’ for fee.Para Priority igual a um, referenceAmount deve ser ‘originalAmount’ para a fee.
FEE-0025Failed to apply rule: flatFee or percentualapplicationRule flatFee or percentual must have exactly 1 calculation for Fee.A applicationRule flatFee ou percentual deve ter exatamente 1 cálculo para a Fee.
FEE-0026Invalid calculation type: percentualThe calculation type percentual must be ‘percentage’ for Fee.O tipo de cálculo percentual deve ser ‘percentage’ para a Fee.
FEE-0027Invalid calculation type: flatFeeThe calculation type flatFee must be ‘flat’ for Fee.O tipo de cálculo flatFee deve ser ‘flat’ para a Fee.
FEE-0028Missing required fee fieldsAll fields of a new Fee must be filled. Please check again the payload passed.Todos os campos de uma nova Fee devem ser preenchidos. Por favor, verifique novamente o payload informado.
FEE-0029Calculation field is required for feePlease fill the Calculation object correctly. All calculation fields must be filled.Por favor, preencha o objeto Calculation corretamente. Todos os campos de cálculo devem ser preenchidos.
FEE-0030referenceAmount is not validField reference amount must be originalAmount or afterFeesAmount.O campo reference amount deve ser originalAmount ou afterFeesAmount.
FEE-0031Invalid applicationRuleField application rule must be maxBetweenTypes, flatFee or percentual.O campo application rule deve ser maxBetweenTypes, flatFee ou percentual.
FEE-0032Invalid calculation typeField calculation type must be percentage or flat.O campo calculation type deve ser percentage ou flat.
FEE-0033maximumAmount less than minimumAmountmaximumAmount value is less than minimumAmount.O valor de maximumAmount é 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.Falha ao filtrar um único package por transactionRoute, segmentID e valor máximo/mínimo. Nenhum package foi encontrado ou múltiplos packages corresponderam aos critérios.
FEE-0035Package amount range overlapThe maximumAmount and minimumAmount of the new package overlap with the amount range of an existing package.O maximumAmount e minimumAmount do novo package se sobrepõem ao intervalo de valores de um package existente.
FEE-0036Invalid sort orderInvalid ‘sort_order’ value. Expected ‘asc’ or ‘desc’.Valor de ‘sort_order’ inválido. Esperado ‘asc’ ou ‘desc’.
FEE-0037Error to distribute valuesError to try distribute the values of send object. Please check the data passed.Erro ao tentar distribuir os valores do objeto enviado. Por favor, verifique os dados informados.
FEE-0038Failed to apply rule: maxBetweenTypesapplicationRule maxBetweenTypes must have more than 1 calculation for Fee %v.A applicationRule maxBetweenTypes deve ter mais de 1 cálculo para a Fee %v.
FEE-0039Invalid segmentIDThe specified segmentID is not a valid UUID. Please check the value passed.O segmentID especificado não é um UUID válido. Por favor, verifique o valor informado.
FEE-0040Invalid ledgerIDThe specified ledgerID is not a valid UUID. Please check the value passed.O ledgerID especificado não é um UUID válido. Por favor, verifique o valor informado.
FEE-0041Unmarshalling errorInvalid value for field ‘%s’: expected type ‘%s’, but got ‘%s’.Valor inválido para o campo ‘%s’: tipo esperado ‘%s’, mas recebido ‘%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.O valor do campo %s é inválido. Lembre-se de usar ponto (.) como separador decimal em vez de vírgula (,). Exemplo: use 1000.50 em vez de 1000,50.
FEE-0043originalAmount is required when isDeductibleFrom is trueFor isDeductibleFrom true, referenceAmount must be ‘originalAmount’ for ‘%s’.Para isDeductibleFrom true, referenceAmount deve ser ‘originalAmount’ para ‘%s’.
FEE-0044applicationRule invalid valueapplicationRule is invalid, Err: %v.applicationRule é inválida, Err: %v.
FEE-0045forbidden to access MidazError to access Midaz. Please check the client credentials to access Midaz for creditAccount %v validation.Erro ao acessar o Midaz. Por favor, verifique as credenciais do cliente para acessar o Midaz para validação do creditAccount %v.
FEE-0046calculation value percentage invalidCalculation value is invalid can not utrapass 100%%. Please check the calculation value for Fee %v..O valor do cálculo é inválido, não pode ultrapassar 100%%. Por favor, verifique o valor do cálculo para a 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.O valor do cálculo é inválido, não pode ultrapassar o valor mínimo %v. Por favor, verifique o valor do cálculo para a Fee %v.
FEE-0048error to access MidazError to access Midaz to validate creditAccount %v. Please check the client credentials to access Midaz.Erro ao acessar o Midaz para validar o creditAccount %v. Por favor, verifique as credenciais do cliente para acessar o Midaz.
FEE-0049deductible value forbiddenCan not update deductible value to true. The calculation value is bigger than 100%% for Fee %v.Não é possível atualizar o valor dedutível para true. O valor do cálculo é maior que 100%% para a Fee %v.
FEE-0050deductible value forbiddenCan not update deductible value to true. Calculation value is bigger than the minimum amount %v for Fee %v.Não é possível atualizar o valor dedutível para true. O valor do cálculo é maior que o valor mínimo %v para a Fee %v.
FEE-0051Invalid page parameterQuery parameter page is invalid. The page must be greater than 0.O parâmetro de consulta page é inválido. A página deve ser maior que 0.

​
401

CódigoTítuloMensagemTradução
FEE-0013Invalid fee priorityThe priority field in fees is invalid. Field can not be repeated.O campo priority nas fees é inválido. O campo não pode ser repetido.

​
403

CódigoTítuloMensagemTradução
FEE-0017Nothing to updateFields not passed correctly. There is nothing to update.Campos não informados corretamente. Não há nada para atualizar.

​
500

CódigoTítuloMensagemTradução
FEE-0004Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.O servidor encontrou um erro inesperado. Por favor, tente novamente mais tarde ou entre em contato com o suporte.

​
503

CódigoTítuloMensagemTradução
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.Apenas um tipo de transação (‘amount’, ‘share’ ou ‘remaining’) deve ser especificado no campo ‘%v’ para cada entrada. Por favor, revise sua entrada e tente novamente.