Conexão EDI com o banco
A caixa EDI liga uma carteira de cobrança ou uma conta financeira ao banco para que a Kobana envie as remessas e receba os retornos sem que você precise baixar e subir arquivos. EDI é a sigla de Electronic Data Interchange, a troca eletrônica de documentos entre empresas e bancos.
Na maioria dos bancos, a ativação exige uma carta de autorização assinada pelo titular da conta e entregue ao gerente. A Kobana gera essa carta a partir do formulário.
Onde fica no painel
Integrações → Kobana → Bancos e Serviços → EDI → Caixas Postais:
- Configurar Novo: abre o formulário Configurar EDI.
- Configurados: lista as caixas EDI da conta.
Atalhos:
- Na lateral de uma carteira ativa, com CNAB disponível e sem envio de remessa por EDI, o quadro Conexão EDI tem os botões Ver EDIs e Configurar EDI.
- Na tela de uma conta financeira, o menu de ações tem o grupo Caixa Postal EDI com Ver Caixas Postais e Configurar EDI.
Passo a passo
- Preencha o formulário Configurar EDI.
- A Kobana gera a carta de solicitação de EDI.
- Assine a carta e envie ao gerente do banco.
- Aguarde a ativação do EDI pelo banco, acompanhando a Linha do Tempo da caixa.
Alguns bancos não exigem a carta. Nesses casos, a tela da caixa pede para você finalizar a configuração seguindo os passos indicados pelo banco e acompanhar o status pela Linha do Tempo.
Formulário Configurar EDI
O primeiro campo escolhe o tipo de recurso: Carteira de Cobrança (Boleto) ou Conta Financeira (Bancária).
| Campo | Obrigatório | Descrição |
|---|---|---|
| Carteira | Sim, para carteira | A carteira de cobrança. O formato de CNAB vem da carteira e a operação é Cobrança. |
| Conta | Sim, para conta financeira | A conta financeira. |
| Formato de CNAB | Sim, para conta financeira | CNAB 400, CNAB 240 ou CNAB 200. |
| Operação | Sim, para conta financeira | Cobrança, Extrato ou Pagamento. |
Responsável pela Carta: a pessoa que a Kobana procura se houver dúvida sobre a carta ou a integração.
| Campo | Obrigatório |
|---|---|
| Nome Completo | Sim |
| Telefone | Sim |
| Sim |
Os blocos abaixo aparecem só quando o banco exige a carta:
Proprietário da Conta: quem configura o EDI e assina a carta enviada ao gerente.
| Campo | Obrigatório |
|---|---|
| Nome Completo | Sim |
| Telefone | Sim |
| CPF | Sim |
| Sim |
Gerente da Conta: o responsável pela conta no banco, que recebe a carta.
| Campo | Obrigatório |
|---|---|
| Nome Completo | Sim |
| Telefone | Sim |
| Sim |
Logomarca da Empresa (opcional): imagem JPG ou PNG menor que 500KB, com 150x150 pixels, usada na carta.
Ao salvar, o painel mostra "EDI configurado com sucesso!".
Regras:
- Cada carteira tem no máximo uma caixa EDI.
- A carteira precisa estar ativa, ter CNAB disponível e não ter o envio de remessa por EDI já ativo.
A carta
A tela da caixa mostra o PDF da carta assim que ele fica pronto. Enquanto é gerada, aparece "A carta está sendo criada. Por favor, aguarde." Se faltar algum dado obrigatório, a tela mostra Não foi possível gerar a carta EDI, lista o que falta (por exemplo, "Telefone do responsável não informado") e oferece o botão Editar dados.
| Situação da carta na KOBANA | Significado |
|---|---|
| Carta Não criada | A carta ainda não foi gerada. |
| Carta Sendo criada | O PDF está sendo montado. |
| Carta Criada | O PDF está disponível na tela da caixa. |
Depois que a carta é gerada, a caixa deixa de ser editável: o item Alterar só aparece em caixas liberadas para edição. A exclusão de caixas EDI não está disponível no painel.
Linha do Tempo
A Linha do Tempo da caixa registra o andamento da ativação:
| Etapa | Significado |
|---|---|
| Carta gerada | A carta de autorização de EDI foi gerada na Kobana. |
| Demanda recepcionada | A demanda foi recebida para configurar o canal de transmissão. |
| Aguardando confirmação do banco | Com o canal configurado, aguarda-se a confirmação do banco de que ele está em produção. |
| Aguardando teste do cliente | O EDI foi ativado e a Kobana pede, por e-mail, um teste do cliente. |
| Aguardando validações | Ajuste necessário em algum dos lados: cliente, Kobana ou banco. |
| Caixa postal ativada | EDI ativo. Os arquivos passam a trafegar entre a Kobana e o banco. |
Na etapa Aguardando teste do cliente:
- a caixa passa a Conexão Habilitada;
- o Responsável pela Carta recebe um e-mail avisando da ativação, com os passos de teste. Para carteira: emitir um boleto de teste, verificar o retorno no dia útil seguinte e, com registro por API ativo, pagar o boleto para validar o fluxo completo. Depois do teste, responda o e-mail confirmando;
- numa caixa de carteira, a carteira passa a ter Envio de Remessa por EDI ativo, e as remessas dela passam a ser geradas e enviadas automaticamente (veja Remessas).
Numa caixa de Pagamento de conta financeira, a ativação liga a opção Remessa habilitada nas contas de pagamento e de transferência da conta financeira. Contas em que a opção já foi desligada antes continuam como estão.
Lista de caixas EDI
Colunas: ID, Identificação (com a situação da carta, a situação da conexão e um ícone que copia o Código na VAN), Empresa (nome e CNPJ do beneficiário), Conta e Criado em.
Filtros: ID, ID do Recurso, Código, Banco, Formato de CNAB, Operação, Situação da carta na KOBANA, Criado em e Habilitada em.
Permissões
Permissão Integrações → Caixas Postais:
| Ação no painel | Ação da permissão |
|---|---|
| Ver caixas EDI | Ações Básicas |
| Configurar EDI | Criar |
| Alterar | Alterar |
Eventos de webhook
| Código | Quando |
|---|---|
edi.edi_box.db.created, edi.edi_box.db.updated, edi.edi_box.db.deleted | A caixa foi criada, alterada ou removida. |
edi.edi_box.generated | Etapa Carta gerada. |
edi.edi_box.demand_received | Etapa Demanda recepcionada. |
edi.edi_box.confirming_at_bank | Etapa Aguardando confirmação do banco. |
edi.edi_box.testing_by_customer | Etapa Aguardando teste do cliente. |
edi.edi_box.waiting_for_validations | Etapa Aguardando validações. |
edi.edi_box.activated | Etapa Caixa postal ativada. |
Pela API
As caixas EDI podem ser listadas, criadas e alteradas pela API v2.