Lotes e aprovação

O lote de transferência agrupa várias transferências do mesmo tipo, que saem pela mesma conta de transferência, para enviá-las ao banco de uma vez. Nos bancos que exigem aprovação, o lote fica Aguardando Aprovação até alguém da sua empresa liberar ou rejeitar o lote.

Onde fica no painel

• Para criar lotes: Financeiro > Transferências > Gerenciar, selecionando transferências na lista.
• Para acompanhar, liberar e rejeitar: Financeiro > Transferências > Lotes de Transferência.

Criar um lote

1. Abra Financeiro > Transferências > Gerenciar. Se quiser, filtre a lista.
2. Marque as transferências que vão para o lote (ou selecione todas as do filtro).
3. Clique na ação Adicionar a um Lote.
4. Confira o aviso no modal Adicionar a um Lote e clique em Criar lote.

O painel responde "A transferência selecionada foi enviada para criar o lote. Aguarde uns instantes para que a execução seja realizada." (ou a mesma mensagem no plural). A criação roda em segundo plano e a lista é atualizada quando termina.

Quais transferências entram

Só entram transferências que:

• ainda não estão em um lote;
• ainda não foram enviadas ao banco (situação do registro Pendente);
• estão nas situações Pendente ou Aguardando Data Agendada;
• não têm data de agendamento no passado.

As demais são ignoradas, e a mensagem informa quantas ficaram de fora "por já estar em lote ou ter status inválido". Se nenhuma servir, o painel avisa que as transferências selecionadas não podem ser adicionadas ao lote.

Como as transferências são agrupadas

A Kobana cria um lote para cada combinação de tipo de transferência e conta de transferência. Por exemplo:

• se a seleção tem TED e Pix na mesma conta financeira e conta de transferência, são criados 2 lotes;
• se há transferências em contas de transferência diferentes da mesma conta financeira, cada conta de transferência ganha seu próprio lote, para que cada lote saia por uma única conexão.

Quando o banco tem um limite de itens por lote, um grupo maior que o limite é dividido em vários lotes.

Depois de entrar em um lote, a transferência não muda mais de lote e não pode ser editada.

Lista de lotes

Financeiro > Transferências > Lotes de Transferência.

Coluna	Conteúdo
ID	Número do lote, com link para o detalhe.
Situação	Dois ícones: registro no banco e situação do lote.
Conta de Transferência	Banco e conta de transferência do lote.
Total de Transferências	Quantidade de transferências no lote.
Criado em	Data e hora de criação.

Clique em Filtrar para buscar por Situação (aceita várias), ID do Lote, Criação (De / Até), Conta de Origem, UID da conta de transferência e Situação do Registro.

Detalhe do lote

O título é "Lote de Transferência #" seguido do número. A aba Transferências lista as transferências do lote (ID, Situação, Beneficiário, Quantia, Agendado para, Criado em) e a aba Comandos mostra as operações enviadas ao banco para o lote.

A lateral mostra ID, Tipo (Pix, TED ou Entre Contas do Mesmo Banco), Situação, Situação do Registro, Conta de Transferência, Criado em e Atualizado em.

Situações do lote

Situação	Significado
Pendente	Lote criado, ainda não processado pelo banco.
Aguardando Aprovação	O banco registrou o lote e aguarda a liberação.
Aprovado	O lote foi liberado e aguarda a efetivação.
Reprovado	O lote foi rejeitado na etapa de aprovação.
Finalizando	O banco está concluindo o lote.
Confirmado	O lote foi efetivado.
Rejeitado	O banco recusou o lote.
Cancelado	O lote foi cancelado.

A Situação do Registro do lote usa os mesmos valores da transferência: Pendente, Requisitado, Confirmado, Rejeitado e Falha. Quando o banco rejeita o registro do lote, a situação do lote passa para Rejeitado.

info

O envio do lote ao banco logo após a criação depende de uma regra de automação da sua conta, habilitada pela equipe da Kobana. Sem essa regra, o lote fica Pendente.

Liberar ou rejeitar um lote

Quando o lote está Aguardando Aprovação e o banco aceita aprovação pela Kobana, a lateral do detalhe mostra o quadro Liberação, com o texto "Este lote foi registrado e para concluir o processamento você precisa autorizar ou rejeitar o lote." e os botões Liberar e Rejeitar.

1. Abra o lote em Lotes de Transferência.
2. Clique em Liberar ou em Rejeitar.
3. Confirme: "Você tem certeza que deseja aprovar este Lote de Transferência?" ou "Você tem certeza que deseja rejeitar este Lote de Transferência?".

A Kobana envia o comando ao banco e mostra "O lote está em processo de liberação! Por favor, aguarde o processamento do banco." (ou "...de rejeição!"). A situação do lote e das transferências muda quando o banco responde.

Regras:

• Só lotes Aguardando Aprovação e com registro Confirmado podem ser liberados ou rejeitados. Fora disso, o painel responde "O lote não está aguardando liberação." (ou "...rejeição.").
• Enquanto há um comando de liberação em andamento, o botão Liberar fica desabilitado; o mesmo vale para Rejeitar.
• Rejeitar um lote com liberação em andamento cancela o comando de liberação, e o contrário também. O modal de confirmação avisa quando isso vai acontecer.
• Em lotes cujas transferências são enviadas ao banco uma a uma, a liberação e a rejeição valem para as transferências do lote que estão Aguardando Aprovação com registro Confirmado. Sem nenhuma nessa condição, o painel responde "Nenhuma transferência do lote está apta a ser liberada." (ou "...rejeitada.").

Aprovação de transferência avulsa

O painel não tem botão de aprovação para transferência fora de lote. A aprovação individual existe pela API, nos bancos que a suportam.

Cancelar transferências do lote

1. Abra o lote e fique na aba Transferências.
2. Marque as transferências (ou selecione todas).
3. Clique na ação Cancelar.
4. Confirme no modal Cancelar transferências com Sim, continuar.

O painel responde "As transferências selecionadas foram enviadas para cancelamento. Aguarde uns instantes para que a execução seja realizada.". Cada transferência segue a mesma regra do cancelamento individual: sem registro no banco, é cancelada na hora; com registro, a Kobana envia um comando de cancelamento ao banco. Transferências Confirmado ou Rejeitado não são canceladas. Veja Acompanhamento, edição e cancelamento.

Permissões

Módulo Pagamento, produto Lotes de Transferência:

Ação	Libera
Ações Básicas	Ver a lista e o detalhe dos lotes
Criar	Adicionar transferências a um lote
Liberar	Aprovar um lote
Rejeitar	Rejeitar um lote

Cancelar transferências dentro do lote usa a permissão Alterar do produto Transferências.

Webhooks

Evento	Quando
transfer.batch.db.created	O lote foi criado.
transfer.batch.db.updated	O lote foi alterado.
transfer.batch.db.deleted	O lote foi excluído.
transfer.batch.awaiting_approval	O lote passou para Aguardando Aprovação.
transfer.<tipo>_batch.<operação>.<resultado>	Uma operação do lote com o banco foi solicitada ou terminou.

<tipo> é pix, ted ou internal; <operação> é register, approve, reprove, cancel, get ou sync; <resultado> é requested, confirmed, failed ou error. Exemplo: transfer.ted_batch.approve.confirmed. A lista completa está em eventos de webhook.

Pela API

Na API v2 há criação de lotes Pix, TED e entre contas, listagem e consulta de lotes, e liberação, rejeição e cancelamento de lote.