Problema
Este erro ocorre ao enviar uma requisição para alterar instruções de um boleto, porém a API identifica que nenhuma alteração efetiva foi informada.
Ao menos um campo deve ser alterado.
Durante o processamento da instrução, o sistema valida se os dados enviados realmente representam uma modificação no título registrado no banco.
Se a instrução enviada não resultar em mudança (por exemplo, informar a mesma data de vencimento já existente), a requisição será rejeitada com erro de validação.
Exemplo de requisição:
curl --location '/boleto/enviarinstrucao?configurationId=LOREMIPSUM' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGci..' \
--data '{
"numeroNoBanco": "50013",
"instrucao": "AlteracaoDeVencimento",
"data": "2026-03-29",
"testing": false
}'
Resposta da API:
{
"errors": [
"Ao menos um campo deve ser alterado."
],
"helpLink": "https://unimake.app/Problems?q=Ao+menos+um+campo+deve+ser+alterado.&type=PutInstructionsResponseException",
"status": 400,
"title": "EnviarInstrucao",
"traceId": "0HNK5SQSSP1UB-00000001",
"type": "PutInstructionsResponseException"
}
Solução
Como resolver
Antes de enviar a instrução de alteração, é necessário garantir que o dado informado realmente represente uma mudança no boleto.
- Consulte previamente os dados atuais do boleto
- Envie apenas informações diferentes das já registradas
- Evite reenviar instruções já processadas
- Valide se a alteração desejada é permitida pelo banco
Fluxo recomendado:
1 - Consultar o boleto no banco ou na API
2 - Comparar o valor atual com o novo valor desejado
3 - Enviar a instrução somente se houver alteração
Dica: implementar validações no sistema integrador evita chamadas desnecessárias e reduz erros de processamento.
Após ajustar a informação enviada, realize novamente o envio da instrução.