Carteiras de cobrança

A carteira de cobrança (ou carteira de recebimento) é o contrato que a sua empresa tem com o banco para emitir boletos numa conta corrente. Na Kobana, a carteira guarda os dados desse contrato (banco, agência, conta, convênio, beneficiário) e é por ela que cada boleto é gerado e registrado.

Para receber por boleto, a carteira precisa estar contratada no banco antes. Se ainda não tem, peça a contratação à sua agência.

Onde fica no painel

Menu Recebimentos > Boletos > Carteiras. A lista pode ser filtrada e, para quem tem permissão de alterar carteiras, permite ações em massa (veja Configurações da carteira).

Navegação

• Cadastro de carteira — passo a passo para cadastrar uma carteira
• Homologação — validação da carteira por boleto de teste e arquivo de remessa
• Ativação por API — registro online dos boletos pela conexão com o banco
• Configurações da carteira — dados do beneficiário, nosso número, remessa, proteção por senha, valores padrão e carteira padrão
• Boleto híbrido — QR Code Pix no boleto

Situações da carteira

Situação	O que significa
Rascunho	Situação anterior a Homologação Pendente.
Homologação Pendente	A carteira foi cadastrada e ainda precisa ser homologada ou ter o registro por API ativado.
Em homologação	A homologação começou: o boleto de teste e o arquivo de remessa foram gerados.
Em validação	A Kobana aguarda o arquivo de retorno ou o valor do boleto de teste para concluir a homologação.
Ativa	A carteira pode emitir boletos.
Inativa	A carteira foi desativada.

Só carteiras Ativas aparecem para emissão de boletos.

Homologação Pendente ──► Em homologação ──► Em validação ──► Ativa
Homologação Pendente ──────────────────────────────────────► Ativa   (registro por API ativado)
qualquer situação ──► Inativa

Enquanto a carteira não está ativa, a tela dela mostra "Para continuar e gerar boletos, primeiro deve completar ao menos uma das opções abaixo:", com as opções de homologação e de conexão por API que o banco oferece.

Ações da carteira

Na tela da carteira, menu Ações:

Ação	Quando aparece	O que faz
Alterar	Sempre	Edita os dados da carteira. Veja Configurações da carteira.
Configurar Boleto Híbrido	Sempre	Configura o QR Code Pix nos boletos. Veja Boleto híbrido.
Iniciar Homologação / Finalizar Homologação	Carteira com remessa CNAB, em Homologação Pendente ou Em validação	Veja Homologação.
Alterar Configuração	Carteira ativa	Valores padrão dos boletos da carteira.
Gerar Remessa	Carteira ativa com remessa CNAB	Gera o arquivo de remessa com os comandos pendentes da carteira.
Novo Boleto	Carteira ativa	Abre a emissão de boleto nesta carteira.
Buscar Boletos	Carteira ativa	Lista os boletos da carteira.
Ativar Webservice	Carteira ativa, quando o banco oferece registro por API e ele ainda não está ativo	Veja Ativação por API.
Alterar Conexão	Carteira ativa com conexão associada	Troca a conexão usada pela carteira.
Definir como padrão / Definir como padrão (Desfazer)	Carteira ativa	Marca ou desmarca a carteira padrão.
Baixar Arquivo Remessa	Carteira Em homologação ou Em validação, com a remessa de homologação processada	Baixa o arquivo de remessa da homologação.
Excluir	Carteira sem envio de remessa por EDI	Exclui a carteira.

A tela da carteira também tem abas com os boletos, assinaturas, carnês, remessas e retornos dela.

Carteira padrão

A carteira padrão é usada nos boletos em que nenhuma carteira é informada. Ao marcar, o painel pede confirmação: "Os próximos boletos gerados usarão esta carteira caso a carteira não seja informada.". A primeira carteira que fica ativa na conta passa a ser a padrão automaticamente.

Excluir uma carteira

Ações > Excluir pede confirmação e exclui a carteira em segundo plano ("Carteira enviada para ser excluída!"). Uma carteira com conexão ativa com o banco por VAN/EDI não pode ser excluída: remova a integração antes.

Alerta de segurança

Quando a carteira ativa não tem proteção por senha configurada, a tela dela mostra o Alerta de Segurança recomendando ativar a proteção por senha dos boletos, com o link Ative a proteção por senha. Veja Configurações da carteira.

Permissões

Ação	Permissão no módulo Carteiras de Cobrança
Ver carteiras, definir como padrão	Ações Básicas
Cadastrar, homologar	Criar
Alterar, ações em massa	Alterar
Ativar registro por API	Ativar API
Excluir	Excluir

Eventos de webhook

Evento	Quando
bank_billet_account.created	A carteira foi cadastrada.
bank_billet_account.homologation_started	A homologação começou.
bank_billet_account.homologation_failed	A homologação falhou.
bank_billet_account.activated	A carteira foi ativada.
bank_billet_account.updated	A carteira foi alterada.
bank_billet_account.deleted	A carteira foi excluída.

A lista completa está em Eventos de webhook.

Pela API

Carteiras também podem ser consultadas e gerenciadas pela API v2.