Oi, DEV! 👋
Crie sua conta para acessar mais recursos do portal.

e-Bank NúmeroContratoinválidoOperaçãocanceladaRegisterResponseException

Número de Contrato não encontrado ou inválido. Operação cancelada.

Este erro ocorre ao tentar consumir uma API do banco Sicoob sem informar corretamente o número de contrato. Esse número é obrigatório e corresponde ao código do cliente junto ao Sicoob, utilizado para identificação n...

Atualizado em 15 de abr. de 2025, 19:01

Problema

Este erro ocorre ao tentar consumir uma API do banco Sicoob sem informar corretamente o número de contrato.
Esse número é obrigatório e corresponde ao código do cliente junto ao Sicoob, utilizado para identificação nas operações bancárias.

Solução

Verifique se o campo correspondente ao número de contrato do Sicoob foi informado corretamente na requisição.
Este código é fornecido diretamente pelo Sicoob no momento da homologação ou ativação da conta bancária para integrações.

Dicas para validação:

  • Certifique-se de que o número informado é exatamente o mesmo fornecido pelo Sicoob, sem espaços ou caracteres extras.
  • Confirme com o gerente da conta ou suporte do Sicoob qual é o número de contrato habilitado para emissão ou consulta de boletos.
  • Verifique se o número de contrato corresponde ao ambiente utilizado (produção ou homologação), pois pode variar.
  • Garanta que o número de contrato esteja corretamente associado à credencial/autenticação utilizada na requisição.
Sem o número de contrato válido, as operações com o Sicoob não serão autorizadas e serão automaticamente canceladas pela API.