Remessas

O arquivo de remessa reúne, no formato CNAB do banco (CNAB 400 ou CNAB 240, conforme a carteira ou a conta), as instruções que a Kobana precisa entregar ao banco por arquivo. Há dois tipos de remessa:

Tipo de Operação	Origem	Exemplos de instrução
Recebimento	Carteira de cobrança	Entrada de Título (registro do boleto), Pedido de Baixa, Alteração do Vencimento, Protestar
Pagamento	Conta financeira	Registro e cancelamento de pagamentos e transferências enviados por arquivo

Onde fica no painel

Integrações → Kobana → Bancos e Serviços → EDI. O menu lateral dessas telas tem:

• Comandos Pendentes, com os itens Recebimentos e Pagamentos: instruções que ainda não entraram em nenhum arquivo.
• Arquivos de Remessa: os arquivos gerados.
• Registros de Remessa: cada linha de boleto que já entrou (ou vai entrar) em uma remessa.

Na tela de uma carteira de cobrança, a aba Remessas lista as remessas daquela carteira.

Comandos Pendentes

Quando uma instrução de boleto segue por arquivo (por exemplo, o registro de um boleto numa carteira sem API), a Kobana cria uma ocorrência pendente para o boleto. O mesmo vale para pagamentos e transferências de uma conta financeira que operam por arquivo. A tela explica: "Estes são comandos a serem enviados para o banco (ou provedor financeiro) que ainda não entraram em um arquivo CNAB de Remessa."

Recebimentos

Lista as ocorrências de boleto pendentes com: ID, Carteira, Boleto, nome do pagador, vencimento, valor, Ocorrência (por exemplo, "Entrada de Título"), data de criação e "Processado em" (mostra Pendente enquanto a ocorrência não entrou em um arquivo).

Filtros: Vencimento (de/até), Criado (de/até), Ocorrência, Carteira e ID do Boleto.

Ações:

• Gerar Remessa: com uma única carteira ativa, o botão gera a remessa dela. Com mais de uma, o botão vira Gerar remessa para... e abre a lista de carteiras ativas.
• Ações em lote sobre as linhas marcadas: Gerar Remessa (gera remessas só com as ocorrências selecionadas) e Não enviar (exclui as ocorrências selecionadas da lista; o painel avisa que a operação não pode ser desfeita).
• Ícone de lixeira (Não enviar) em uma linha: remove o boleto da lista de envio para o banco.

O mesmo "Não enviar para o banco" existe na tela do boleto e remove as ocorrências pendentes daquele boleto.

Pagamentos

Lista as linhas pendentes de pagamentos e transferências com: ID, Origem do Recurso (conta financeira), pagamento, beneficiário, vencimento, valor, Ocorrência (Registro ou Cancelamento), data de criação e "Processado em".

Ações:

• Gerar Remessa ou Gerar remessa para...: gera a remessa da conta financeira escolhida. Sem linhas pendentes para a conta, o painel mostra "Não há pagamentos pendentes da conta financeira selecionada para criação de remessa."
• Lixeira (Não enviar) em uma linha: remove o pagamento da lista. Uma linha que já entrou em uma remessa não pode mais ser removida.

informação

Pagamentos e transferências só seguem por arquivo quando a conta de pagamento ou de transferência está com Remessa habilitada. Uma caixa EDI de Pagamento ativa para a conta financeira liga essa opção nas contas dela. Veja Conexão EDI com o banco.

Como a remessa é gerada

Há dois caminhos:

1. Manual, pelo botão Gerar Remessa em Comandos Pendentes.
2. Automático: a Kobana gera remessas periodicamente para
   • carteiras com Envio de Remessa por EDI ativo (campo mostrado na lateral da carteira), quando há ocorrências pendentes e a conta tem assinatura ativa;
   • contas financeiras com linhas de pagamento pendentes.

Cada remessa reúne no máximo 3.000 ocorrências pendentes de uma mesma carteira ou conta financeira. O que sobrar fica pendente para a remessa seguinte.

Depois de criada, a remessa é processada em segundo plano: a Kobana monta o conteúdo CNAB, numera o arquivo e marca as ocorrências incluídas com a data de processamento. A tela mostra "Remessa criada. Gere outra remessa caso tenha mais pendências. Aguarde processamento."

Status

Situação	Significado
Aguardando	A remessa foi criada e o arquivo ainda está sendo montado. O download ainda não está disponível.
Processado	O arquivo CNAB está pronto para download.
Enviado	A Kobana entregou o arquivo ao banco pela conexão EDI.

Aguardando -> Processado -> Enviado

O status Enviado só aparece quando a própria Kobana entrega o arquivo. Se você baixa a remessa e envia ao banco por conta própria, ela continua em Processado.

Envio ao banco

• Carteira com Envio de Remessa por EDI ativo ou remessa de conta financeira: assim que a remessa fica Processado, a Kobana a envia pela caixa EDI ativa da carteira ou da conta. Na lateral da remessa, o campo Enviado por Conexão on-line registra quando isso aconteceu, e a remessa passa a Enviado.
• Sem conexão EDI: baixe o arquivo e envie ao banco pelo canal que o banco oferece (internet banking ou software do banco).

Se a conta tem uma Caixa Postal do tipo EDI ativa e habilitada, uma cópia de cada remessa processada vai para a caixa de saída dela.

Arquivos de Remessa

A lista mostra: UID, ID Externo, Origem do Recurso (carteira ou conta financeira), Remessa (nome do arquivo), Tipo de Operação, Formato CNAB, Sequencial, Total de Títulos, Criada em, Processado em e Situação. Um ícone marca as remessas geradas pela API.

Filtros: Tipo de Operação (Recebimento ou Pagamento) e, conforme a escolha, Carteira ou Conta Financeira, Situação e Criação (de/até).

A tela da remessa mostra as ocorrências incluídas no arquivo e, na lateral, ID, Tipo, Situação, Origem do Recurso, Total de Títulos, Processado em, Criada em e Gerado por (Kobana ou Cliente).

Download

Disponível em Ações → Download na tela da remessa e pelo ícone de nuvem na lista, a partir do status Processado. Antes de baixar, o painel pede confirmação:

• se a Kobana já enviou a remessa ao banco, o aviso informa a data do envio e pede para não reenviar, sob risco de cobrança em dobro dos boletos;
• caso contrário, o aviso pede cautela: não reenvie uma remessa que já foi enviada ao banco.

O arquivo é baixado com a codificação Windows-1252, a usada pelos bancos.

Exclusão

Ações → Excluir aparece só em remessas de carteira sem Envio de Remessa por EDI ativo. Remessas de conta financeira não podem ser excluídas pelo painel.

Ao excluir, as ocorrências da remessa voltam para Comandos Pendentes e entram na próxima remessa gerada. O painel avisa: só exclua remessas que não foram enviadas ao banco, porque enviar o mesmo boleto duas vezes pode gerar cobrança em dobro.

Registros de Remessa

Cada registro é uma linha de boleto em uma remessa: "Cada registro representa uma linha presente em um arquivo de remessa que foi gerado pela Kobana para ser enviado para o banco." A lista mostra ID, Remessa, Ocorrência, Boleto, Carteira, Criado em e Processado em.

Filtros: Código (ocorrência), Carteira, ID da Remessa, ID do Boleto, Criado em e Processado em.

Permissões

As telas de remessa usam a permissão Recebimentos → CNAB:

Ação no painel	Ação da permissão
Ver Comandos Pendentes, Arquivos e Registros de Remessa	Ações Básicas
Gerar Remessa	Criar
Excluir remessa, Não enviar	Excluir

Eventos de webhook

Código	Quando
remittance.created	A remessa foi criada.
remittance.processed	O arquivo ficou pronto (status Processado).
remittance.sent	A Kobana enviou a remessa ao banco (status Enviado).
remittance.downloaded	Alguém baixou o arquivo.
remittance.deleted	A remessa foi excluída.
bank_billet_remittance.created, bank_billet_remittance.updated, bank_billet_remittance.deleted	Uma ocorrência de boleto foi criada, alterada ou removida.

Pela API

Remessas e registros de remessa têm endpoints na API v2 e na API v1.