Lotes e aprovação

O lote de pagamento agrupa pagamentos do mesmo tipo e da mesma conta de pagamento para envio ao banco. Depois que o banco registra o lote, um usuário com permissão o libera (autoriza o débito) ou o rejeita.

Onde fica no painel

• Criar lote: Pagamentos > Gerenciar, ação em massa Adicionar a um Lote.
• Acompanhar, liberar e rejeitar: Pagamentos > Lotes de Pagamentos.

Criar um lote

1. Em Pagamentos > Gerenciar, marque os pagamentos.
2. Clique em Adicionar a um Lote. O modal informa quantos pagamentos entram e quantos foram retirados da seleção.
3. Clique em Criar lote.

A criação roda em segundo plano: o painel mostra Aguarde uns instantes para que a execução seja realizada. Os lotes aparecem em Lotes de Pagamentos, e cada pagamento passa a mostrar o número do lote na coluna Lote de Pagamento.

Como os pagamentos são agrupados

A Kobana cria um lote para cada combinação de tipo de pagamento e conta de pagamento. Exemplos:

• Boletos e tributos selecionados juntos, na mesma conta de pagamento, geram dois lotes.
• Pagamentos de contas de pagamento diferentes, mesmo na mesma conta financeira, geram lotes separados, para que cada lote saia por uma única conexão com o banco.

Quando o banco limita a quantidade de pagamentos por lote, a Kobana divide o grupo em quantos lotes forem necessários.

Quais pagamentos podem entrar

• Pagamentos que ainda não estão em nenhum lote.
• Situação Pendente ou Aguardando Data Agendada.
• Situação do registro Pendente (o pagamento ainda não foi enviado ao banco).
• Data de Agendamento de hoje em diante.

Pagamentos que já estão em lote ou com situação fora da regra são retirados da seleção e o painel informa quantos foram ignorados.

Envio ao banco

Na configuração padrão da conta, o lote é enviado ao banco assim que é criado. A situação do registro do lote passa por Requisitado e chega a Confirmado quando o banco aceita o lote. Quando o banco exige autorização, o lote passa para Aguardando Aprovação.

Liberar ou rejeitar um lote

1. Abra Pagamentos > Lotes de Pagamentos e clique no lote.
2. Com o lote em Aguardando Aprovação, a lateral mostra o quadro Liberação: Este lote foi registrado e para concluir o processamento você precisa autorizar ou rejeitar o lote.
3. Clique em Liberar ou Rejeitar e confirme no modal.

O quadro Liberação só aparece quando o banco da conta permite liberar o lote pela Kobana.

Depois da confirmação:

Ação	Mensagem	O que acontece
Liberar	O lote de pagamento está em processo de liberação! Por favor, aguarde o processamento do banco.	A Kobana envia a autorização ao banco. A situação do lote muda quando o banco responde.
Rejeitar	O lote de pagamento está em processo de rejeição! Por favor, aguarde o processamento do banco.	A Kobana envia a rejeição ao banco.

Regras

• Liberar e rejeitar exigem o lote em Aguardando Aprovação com o registro Confirmado. Fora disso, o painel responde O lote de pagamento não está aguardando liberação.
• Enquanto uma liberação está em andamento, o botão Liberar fica desabilitado. O mesmo vale para Rejeitar.
• Se você liberar um lote que tem uma rejeição em andamento, o modal avisa que a rejeição será cancelada. O inverso também vale.
• Em bancos que processam os pagamentos do lote um a um, a liberação vale para os pagamentos do lote que estão Aguardando Aprovação com registro Confirmado. Se nenhum estiver, o painel responde Nenhum pagamento do lote está apto a ser liberado.

Tela do lote

O título é Lote de Pagamento # seguido do ID. A lateral mostra ID, Situação, Situação do Registro, Número do Lote, Tipo de Pagamento, Conta de Pagamento e as datas de criação e atualização. As abas são:

• Pagamentos: os pagamentos do lote, com situação, quantia, data de agendamento e criação. A ação em massa Cancelar cancela os pagamentos marcados, com as regras de Gerenciar pagamentos.
• Comandos: as operações enviadas ao banco para o lote.

Lista de lotes

Colunas: ID, Situação (ícones do registro no banco e da situação do lote), Conta de Pagamento, Tipo de Pagamento, Número do Lote e Criado em.

Filtrar busca por ID do Lote, Número do Lote, Situação (várias de uma vez), Criação, Conta de Origem, UID da conta de pagamento, Tipo do Pagamento e Situação do Registro. A lista exporta em CSV, XLSX ou ODS.

As situações do lote estão em Status do pagamento.

Permissões

No módulo Pagamento, produto Lotes de Pagamento:

Ação	Permissão
Ver lotes	Ações Básicas
Criar lote (Adicionar a um Lote)	Criar
Liberar	Liberar
Rejeitar	Rejeitar

Separe as permissões Criar e Liberar entre usuários diferentes quando quiser que quem monta o lote não seja quem autoriza o débito.

Eventos de webhook

Evento	Quando
payment.batch.db.created	Lote criado.
payment.batch.db.updated	Lote alterado, inclusive mudança de situação.
payment.batch.awaiting_approval	Lote aguardando liberação.

Há também eventos por tipo de lote e operação, no formato payment.bank_billet_batch.approve.confirmed. Lista completa em Eventos de webhook.

Pela API

Referência em API v2.