Como cadastrar uma carteira emissora de boletos (ativação EDI)?
Na Fintera temos dois emissores de Boletos Bancários, sendo eles: PJBank e Boletos Fintera.
Dica: Saiba a diferença entre eles, acessando o artigo: Diferenças entre PJ Bank e Boletos Fintera
E quando um cliente solicita o cadastro de uma carteira de cobrança, para suas emissões de boletos via Faturamento com os Boletos Fintera, o processo de ativação da EDI é realizado na Kobana.
⚠️ Atenção!
Verifique antes se o banco que o cliente utiliza está disponível na Kobana para emissão de boletos: Através de quais bancos posso integrar e emitir boletos bancários na Fintera?
Observe o mesmo abaixo:
1º passo: Solicitação de dados ao cliente
O primeiro passo, após apresentar e explicar como o Boletos Fintera funciona é confirmar Empresa/Entidade e Banco da carteira, verificando principalmente se Nome Fantasia/Razão Social e CNPJ em questão está vinculado corretamente no banco correspondente.
Tendo estas informações você criará uma linha na planilha de acompanhamento de homologação de boletos:

E em seguida enviará um e-mail ao cliente solicitando os dados necessários para o cadastrado inicial da carteira, sendo eles:
REPRESENTANTE LEGAL DA EMPRESA:
- Nome/Sobrenome
- CPF
- Telefone
DADOS DA EMPRESA:
- Rua
- CEP
- Nº
- Complemento
- Bairro
- Estado
- Cidade
- Logomarca da empresa (a imagem deve ser menor que 500KB, ter 150x150 pixels e estar nos formatos JPG ou PNG)
DADOS BANCÁRIOS:
- Número e Dígito da Agência
- Número da Carteira
- Código do Cedente: nem todos os bancos solicitam, você precisará confirmar no artigo da Kobana (ao final desta seção)
- Nome do Gerente
- Telefone do Gerente
- E-mail do Gerente
- Número e Dígito da Conta
- Último Nosso Número: identificador numérico do boleto, sendo exibido no próprio boleto
- Último Sequencial da Remessa identificador da remessa, sendo apresentado e verificado na remessa com ajuda da Kobana (caso o cliente não saiba)
- Formato do arquivo remessa (CNAB 240 ou CNAB 400)
BOLETO DE TESTE: emissão de boleto no Faturamento para confirmação do funcionamento da EDI
- Nome do Responsável
- E-mail do Responsável
- Celular do Responsável
Artigo Kobana base: https://ajuda.kobana.com.br/pt-BR/articles/8822007-quais-informacoes-preciso-para-cadastrar-minha-carteira-de-cobranca
2º passo: Cadastrar uma subconta na Kobana
Após o cliente enviar TODOS os dados solicitados, realizaremos na Kobana o cadastro de uma subconta da seguinte forma:
Importante: caso o cliente já possua 1 ou + carteiras cadastradas no Boletos Fintera (Kobana) você precisará seguir a partir das instruções do 3º passo em diante, pulando esta seção.
1) Acessado a Kobana clique sobre o menu Administração > Conta > Subcontas:

2) Crie uma subconta selecionando o botão Nova Subconta:

3) Informe os seguintes dados requisitados:
- Apelido: nome de fácil identificação nas subcontas
- CNPJ da empresa
- Razão Social
- Nome Fantasia
- E-mail: este é o e-mail de repassa criado e identificado na coluna E-mail criado da planilha de acompanhamento da homologação dos boletos

3º passo: Cadastrar carteira na Kobana
Cadastrada a subconta, acesse pela visão da mesma utilizando a ação Logar nesta subconta:
Em tela selecione o menu Recebimentos > Boletos > Carteiras:

Após clique sobre o botão Cadastre sua primeira carteira de recebimento:

E depois selecione o banco em que cadastrará a carteira:

Em seguida você deverá informar os dados conforme cada campo e página solicitar. E ao final deste processo você baixará o arquivo remessa de teste.

4º passo: Envio de arquivo remessa e pedido de retorno
Encaminhe o arquivo remessa de teste ao cliente via e-mail, solicitando que o mesmo adicione o documento no Internet Banking em Homologação (teste) de seu banco. E no dia seguinte solicite o arquivo retorno ao seu cliente.
Esta remessa e retorno são para a correta validação dos dados cadastrados na carteira da Kobana.
Encaminhado o retorno, acesse a subconta e no menu Recebimentos > Boletos > Carteiras clique sobre a ação Finalizar Homologação. Após anexe o retorno enviado:

Atenção!
Caso este não apresente um retorno, é importante verificar com o banco/gerente do cliente o motivo.
Normalmente o erro é devido a carteira estar sendo utilizada para emissão de mais boletos, interferindo com os dados do último Nosso Número e Sequencial.
Neste caso informe ao atendimento da Kobana que o cliente está emitindo boleto e, por isso, o retorno não foi identificado.
Eles orientarão em como seguir com a ativação da carteira.
5º passo: Envio e ativação da comunicação via EDI
A EDI é a comunicação via VAN (E-Sales) realizada por responsabilidade da Kobana e seu parceiro junto ao banco, esta é a que realiza o envio interno das remessas ao banco, solicita os retornos, confirma os registros, cancelamentos, alterações e recebimento.
Sua ativação será realizada e acompanhada pela Kobana. Para verificar a mesma na menu Recebimentos > Boletos > Carteiras selecione a ação Ver EDIs:

Caso o EDI ainda não tenha sido registrado, como no exemplo abaixo, selecione a ação +:

Preencha os dados requisitados:

- Responsáveis pela Carta de EDI: é o Responsável legal da empresa.
Se não o identificar para seleção, sendo o cadastro da primeira carteira, você precisará criar um + Novo Responsável.
Neste você informará Nome, CPF, E-mail (pode ser do contato do funcionário que está realizando a homologação) e endereço da empresa:

- Gerente do Banco: caso não tenha este cadastrado para seleção, o mesmo processo de cadastro será realizado, onde você informará o Nome, E-mail e Telefone:

- Tipo de recurso: no caso da homologação de Boletos selecionamos a opção Carteira:

- Recurso: selecione qual carteira (se tiver mais de uma) esta EDI refere-se:

- Logomarca: adicione a logo da empresa correspondente:

Feito este processo a Carta de EDI foi gerada:

6º passo: Acompanhamento ativação da EDI
Após a geração da Carta de Ativação da EDI, a carta ficará disponível para você na tela da Kobana e será enviada ao seu e-mail (o usuário da kobana).
A Kobana não vai enviar e-mails ao banco! Mas enviará e-mails a você informando que a demanda ainda não foi recebida e se você pode verificar com o banco como está a demanda lá.
Assim, será necessário encaminha-la ao cliente e solicitar que o mesmo assine e envie ao gerente bancário, para seguimento com o processo de ativação de EDI do banco.
Para acompanhar a ativação da EDI, basta logar como a subconta e selecionar Recebimentos > Boletos > Carteiras:

Após, clique em Ver EDIs:

Será exibida uma nova guia no navegador com a EDI da carteira, selecionar a ação Ver EDI:

E acompanhe o status visualizando a Linha do Tempo - Carta de EDI:

Importante: é sempre bom confirmar com a Kobana a recepção da demanda de ativação. Principalmente se o cliente enviou o e-mail de contato entre o banco e VAN, exemplo:




Você deverá saber quando a VAN recepcionou a demanda de ativação da EDI do banco através do seguinte status/atualização na Linha do Tempo da EDI:

7º passo: Ativação da EDI
Após a recepção de confirmação da ativação da EDI, será necessário a realização do vinculo interno com a carteira criada na Kobana.
Para isto, acesse a Conta do cliente e na aba Empresas selecione a ação abrir e, após clique sobre o acesso do Staff do Faturamento da empresa em que foi habilitado a carteira:

Neste identifique novamente a empresa e botão + Nova Carteira junto a separação da Kobana:

Selecionado o botão uma nova tela será exibida, solicitando o ID da carteira e Token:

O ID da Carteira é identificado ao acessar a subconta, no menu Recebimentos > Boletos > Carteiras:

E o Token no menu Integrações > API Kobana > Token de API:

Realizado este preenchimento o cliente conseguirá observar a carteira em seu módulo Faturamento no menu Configurações > Configurações > Cobrança e como opção de seleção em seus faturamento.
Agora basta encaminhar as instruções para emissão de boleto de teste, para confirmar o registro e confirmação de recebimento.
Atenção! Neste ponto é importante confirmar o último Nosso Número e Sequencial, caso o cliente ainda esteja emitindo boletos por fora (até a homologação), pois se este não estiver atualizado o boleto de teste não será registrado.
Neste inicio o boleto só apresentará a confirmação de registro no dia seguinte a sua emissão.
Após todos os testes terem sido realizados é só confirmar com o cliente se o mesmo deseja ativar a API - registro em até 10 minutos.
Processo de ativação da API descrita em: https://ajuda.fintera.com.br/article/717-como-ativar-a-api-de-uma-carteira-de-cobranca