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

e-Bank boletocobrançacarteiravariação carteiraconvênionumeroVariacaoCarteira

Convenio/Carteira/Variacao nao cadastrado

Este erro ocorre quando os dados da carteira ou da variação da carteira utilizados para registrar o boleto não correspondem aos dados cadastrados no convênio junto ao banco. Também pode ocorrer quando e...

Atualizado em 2 de set. de 2026, 11:37

Problema

Este erro ocorre quando os dados da carteira ou da variação da carteira utilizados para registrar o boleto não correspondem aos dados cadastrados no convênio junto ao banco.

Também pode ocorrer quando essas informações não foram configuradas no e-Bank ou não foram enviadas no JSON da requisição.

Dependendo do banco, a carteira e sua variação são informações obrigatórias para identificar corretamente o convênio de cobrança.

Exemplo dos campos envolvidos:

{
    "testing": true,
    "boleto": {
        ...
        "carteira": "string",
        "numeroVariacaoCarteira": "string"
        ...
    }
}

Solução

Verifique inicialmente a configuração da conta utilizada para emissão do boleto e confirme se os campos Carteira e Variação da Carteira estão preenchidos com os valores fornecidos pelo banco para o convênio.

Caso essas informações sejam enviadas diretamente no JSON da requisição, verifique os campos:

  • carteira
  • numeroVariacaoCarteira

Os valores informados devem corresponder exatamente à carteira e à variação habilitadas pelo banco para o convênio utilizado.

Caso tenha dúvida sobre quais valores utilizar, consulte os dados do convênio no Internet Banking ou entre em contato com o gerente responsável pela conta.

Na mensagem de erro retornada pelo e-bank, são exibidas as carteiras implementadas para o banco em questão, procure por:

Carteiras implementadas para o banco <BANCO>:
informe: carteira: <CARTEIRA>
numeroVariacaoCarteira: <VARIAÇÃO>