Recebimentos

A tela Recebimentos é o histórico consolidado dos pagamentos que a Kobana registrou para as suas cobranças, qualquer que seja o meio: boleto, cobrança Pix ou Pix Automático. Cada pagamento confirmado vira uma linha, com data, valor, dados do pagador e um link para a cobrança paga. É a tela para conciliar o que entrou.

Onde fica no painel

Recebimentos > Recebimentos (o item do menu fica abaixo de Assinaturas, fora dos submenus de Boletos e Pix).

informação

O submenu Recebimentos > Boletos tem um item também chamado Recebimentos, que lista só os pagamentos de boleto. A tela descrita aqui é a que reúne todos os meios.

Como um pagamento chega aqui

O registro é criado automaticamente quando a cobrança é paga:

• Cobrança Pix: quando o banco confirma o pagamento, a cobrança passa a Pago e o recebimento é criado com Forma de Recebimento Pix. Veja Status e registro no banco.
• Cobrança de Pix Automático: quando o banco informa que a cobrança foi paga, o recebimento é criado com Forma de Recebimento Pix Automático. Veja Cobranças de Pix Automático.
• Boleto: o pagamento informado pelo banco (por API ou arquivo de retorno) ou registrado manualmente aparece com Forma de Recebimento Boleto ou Manual. Os detalhes estão na seção de boletos.

Cada cobrança Pix ou de Pix Automático gera no máximo um recebimento.

Colunas da lista

Coluna	Conteúdo
UID	Identificador do recebimento. Um ícone indica recebimento criado pela API; outro indica pagamento feito diretamente ao beneficiário.
Forma de Recebimento	Boleto, Pix, Pix Automático ou Manual. É um link para a cobrança paga.
Nome/Razão Social	Pagador da cobrança. Leva ao cadastro do cliente quando ele existe.
Vencimento	Vencimento da cobrança
Quantia Paga	Valor recebido
Data de Recebimento	Data do pagamento
Crédito em	Data do crédito na conta, quando o banco informa
Devedor é pagador	Sim, Não ou Não informado: indica se quem pagou é o próprio devedor da cobrança
Pagador	Nome e documento de quem pagou, quando o banco informa

A lista vem ordenada pela data de recebimento, da mais recente para a mais antiga.

Busca

Filtro	Descrição
UID	UID do recebimento
Tipo	Forma de recebimento. Com Pix, aparece o campo Identificador da Transação; com Boleto, o campo Nosso Número.
Data de Recebimento	Intervalo de datas
Quantia	Intervalo de valores
CNPJ/CPF do Cliente, Nome do Cliente	Dados do pagador da cobrança
Duplicado	Sim, Não ou Todos
Ordenação	Por ID, Recebimento ou Quantia paga, em ordem crescente ou decrescente

A lista pode ser exportada em CSV, XLSX ou ODS.

Recebimentos duplicados

Quando a Kobana registra mais de um pagamento para a mesma cobrança, o recebimento extra é marcado como duplicado e mostra um ícone de alerta. Ao passar o mouse, o painel mostra o UID do recebimento original; ao clicar, filtra a lista por ele. Use o filtro Duplicado para encontrar todos.

Excluir um recebimento

O ícone de lixeira exclui recebimentos de boleto, depois da confirmação "Você tem certeza que deseja excluir esse recebimento?".

Recebimentos de Pix não podem ser excluídos: o ícone aparece desabilitado com a mensagem "Não é possível excluir um recebimento de Pix".

Permissões

As ações dependem das permissões do produto Recebimentos, no módulo Recebimentos:

Ação no painel	Permissão
Ver a lista, buscar e ver os dados do pagador	Ações Básicas
Excluir recebimento de boleto	Excluir

Eventos de webhook

Código	Quando
charge.payment.db.created	Recebimento criado
charge.payment.db.updated	Recebimento alterado
charge.payment.db.deleted	Recebimento excluído
charge.payment.notified	Recebimento na situação notificado
charge.payment.confirmed	Recebimento na situação confirmado
charge.payment.canceled	Recebimento na situação cancelado
charge.payment.duplicated	Pagamento marcado como duplicado

Pela API

Os recebimentos podem ser consultados pela API v2.