Carnês

O carnê divide uma cobrança em parcelas e emite um boleto para cada uma, todos de uma vez. Você informa o valor da parcela, a quantidade de parcelas, a data da primeira e o período entre elas; a Kobana calcula o vencimento das demais. Quando as datas ou os valores não seguem um padrão, você pode personalizar parcela a parcela.

Cada parcela é um boleto comum: aparece na lista de boletos com o número da parcela, é registrado na carteira escolhida e segue as regras de multa, juros, desconto e notificação do boleto avulso.

Onde fica no painel

• Recebimentos → Carnês → Gerenciar: lista dos carnês da conta, com busca.
• Recebimentos → Carnês → Importar: criação em massa a partir de arquivo CSV.
• Criar → Carnê: formulário de novo carnê (também acessível pelo botão de novo carnê na lista).

Os carnês também aparecem na aba Carnês da ficha do cliente (CRM → Gerenciar Clientes) e na aba Carnês da carteira de cobrança.

A lista mostra, para cada carnê: ID, nome do cliente, Quantia por período (por exemplo, "R$ 100,00 / mês"), Parcelas, Primeira parcela, Última parcela e Situação.

Criar um carnê

1. Abra Criar → Carnê.
2. Escolha a Carteira e, se a conta tiver modelos de boleto, o Modelo. Com uma única carteira ativa, ela é usada sem perguntar.
3. Preencha Primeira parcela, Valor da parcela, Parcelas e Período.
4. Preencha os dados do cliente e as demais seções que quiser usar (veja a tabela abaixo).
5. Clique em Adicionar Carnê.

O painel volta para a lista com a mensagem "Carnê cadastrado com sucesso!". A emissão dos boletos acontece em seguida, em segundo plano: abra o carnê para acompanhar.

Campos principais

Campo	Obrigatório	Descrição
Carteira	Sim	Carteira de cobrança que emite os boletos. Só aparecem carteiras ativas.
Modelo	Não	Modelo de boleto aplicado a todas as parcelas. O campo só aparece quando a conta tem modelos cadastrados.
Primeira parcela	Sim	Data de vencimento da primeira parcela. Não pode ser no passado.
Valor da parcela	Sim	Valor de cada boleto, em reais. Deve ser maior que zero.
Parcelas	Sim	Quantidade de parcelas, de 1 a 300.
Período	Sim	Intervalo entre os vencimentos: Semanal, Quinzenal, Mensal, Bimestral, Trimestral, Semestral ou Anual.

Seções adicionais do formulário, iguais às do boleto avulso:

Seção	Obrigatório	Descrição
Dados do Cliente e Endereço do cliente	Sim (nome, CPF/CNPJ, endereço, bairro, cidade e estado)	Pagador de todas as parcelas.
Demonstrativo e Instruções para o Caixa	Não	Textos impressos no boleto. Aceitam variáveis.
Multa, Juros e Desconto	Não	Encargos e desconto aplicados a cada parcela. A data limite de desconto da primeira parcela não pode ficar no passado.
Documento (opcional)	Não	Número, tipo e data do documento de origem.
Beneficiário final (opcional)	Não	Nome e CPF/CNPJ do beneficiário final.
Informações para remessa (opcional)	Não	Dias corridos para baixa, dias para protesto e dias corridos para negativação (de 0 a 99).
Pagamento Divergente (opcional)	Não	Regras para aceitar pagamento com valor diferente do boleto.
Etiquetas (Tags)	Não	Etiquetas copiadas para todos os boletos do carnê.
Notificações	Não	Nome do arquivo de boleto enviado ao cliente nas notificações. Aceita variáveis; vazio, usa a palavra "boleto" com o ID.

Como os vencimentos são calculados

A primeira parcela vence na data informada. Cada parcela seguinte vence um período depois da anterior:

Período	Intervalo
Semanal	7 dias
Quinzenal	15 dias
Mensal	1 mês
Bimestral	2 meses
Trimestral	3 meses
Semestral	6 meses
Anual	1 ano

Nos períodos a partir de Mensal, as parcelas mantêm o mesmo dia do mês da primeira; quando o mês não tem esse dia (por exemplo, dia 31 em um mês de 30 dias), o vencimento cai no último dia do mês. A última parcela não pode vencer mais de 5.500 dias (cerca de 15 anos) depois da data de criação.

Personalizar o carnê

Para definir datas e valores diferentes por parcela:

1. Preencha Primeira parcela, Valor da parcela, Parcelas (mais de uma) e Período. O botão Personalizar carnê fica habilitado.
2. Clique em Personalizar carnê. O formulário lista cada parcela ("Parcela 1", "Parcela 2"…) com a data e o valor calculados.
3. Ajuste a data de vencimento e o Valor da parcela de cada linha.
4. Clique em Adicionar Carnê.

No carnê personalizado, o Período passa a ser "Personalizado". As parcelas são numeradas pela ordem das datas de vencimento, a Primeira parcela e a Última parcela passam a ser a menor e a maior data informadas, e a Quantia exibida é a média dos valores. Para desistir da personalização antes de salvar, clique em Voltar.

Situação do carnê

Situação	Significado
Gerando	O carnê foi salvo e os boletos ainda estão sendo criados.
Processado	Todos os boletos foram criados e estão em emissão.
Boletos Gerados	Todos os boletos do carnê saíram da emissão sem falha.

Gerando ──► Processado ──► Boletos Gerados

Ao processar o carnê, a Kobana também vincula o pagador a um cliente do CRM: usa o cliente da conta com o mesmo CPF/CNPJ ou cadastra um novo.

Acompanhar e compartilhar

Na lista, clique no ID ou no ícone de visualizar. A tela do carnê tem as abas:

• Carnê: a prévia do carnê, com link para abri-lo. Enquanto os boletos não estão prontos, aparece "Aguarde, o carnê estará pronto em alguns instantes".
• Parcelas (N): os boletos do carnê, em ordem de parcela, com valor e situação de cada um.
• Observações: anotações internas sobre o carnê, que você pode editar e salvar a qualquer momento.
• Compartilhar: o Link do Carnê e o Link do PDF, para enviar ao cliente.

A barra lateral mostra os dados do carnê: situação, parcelas, quantia, período, primeira e última parcela, carteira, modelo, multa, juros, desconto e as informações para remessa.

Os dados de cobrança de um carnê (valor, datas, cliente, encargos) não podem ser alterados depois de criado. Para mudar uma parcela, edite o boleto correspondente; para refazer o carnê inteiro, exclua-o e crie outro.

Excluir um carnê

1. Na tela do carnê, abra Ações → Excluir.
2. Opcionalmente, marque Escolher o motivo de cancelamento dos boletos e escolha o motivo.
3. Clique em Sim, continuar.

O carnê sai da lista com a mensagem "Carnê apagado." e, em seguida, a Kobana cancela as parcelas. Os boletos com situação Pago, Cancelado, Estornado ou Bloqueado não são cancelados. Todos os boletos do carnê, cancelados ou não, deixam de estar vinculados a ele e continuam na lista de boletos.

aviso

A exclusão cancela os boletos do carnê que ainda podem ser cancelados e não pode ser desfeita.

Permissões

Os carnês fazem parte do produto de cobrança do plano contratado. No cadastro de usuários, as permissões ficam em Recebimentos → Carnês:

Ação	Permite
Ações Básicas	Ver a lista, a busca e o carnê; editar as observações.
Criar	Criar carnês.
Excluir	Excluir carnês.
Importar	Importar carnês por arquivo.
Exportar	Exportar carnês.

Eventos de webhook

Evento	Quando
installment.created	Os boletos do carnê foram criados.
installment.processed	O carnê passou para a situação Processado.
installment.generated	O carnê passou para a situação Boletos Gerados.
installment.deleted	O carnê foi excluído.

Cada parcela também dispara os eventos do próprio boleto.

Pela API

Os carnês podem ser criados, listados, consultados e excluídos pela API: veja a referência da API v1 e a referência da API v2.