Importação de transferências por planilha
A importação cria várias transferências de uma vez a partir de uma planilha em CSV. Cada linha vira uma transferência, com as mesmas regras de validação da criação pelo formulário.
Onde fica no painel
Financeiro > Transferências > Importar.
A tela traz as instruções do formato, os links Baixar Exemplo em CSV, Baixar Exemplo em Excel e Acessar no Google Sheets, e uma área para arrastar o arquivo.
Formato do arquivo
- A primeira linha é o cabeçalho com os nomes das colunas; as demais são as transferências.
- Os campos são separados por vírgula. Textos com vírgula ou quebra de linha vão entre aspas.
- A ordem das colunas não importa, e maiúsculas e minúsculas no cabeçalho também não.
Colunas
| Coluna | Obrigatória | Descrição |
|---|---|---|
| Valor (ou Quantia) | Sim | Valor da transferência em reais. |
| Conta financeira de origem (ou UID da conta financeira de origem) | Sim | UID da conta financeira de onde sai o dinheiro. |
| Tipo | Sim | Pix, TED ou Interna (entre contas do mesmo banco). |
| Data de agendamento | Não | Data da transferência. Não pode ser no passado. |
| Vencimento | Não | Data de expiração. Passada essa data sem efetivação, a transferência muda para Vencido. |
| Nome do beneficiário | Sim, salvo depósito judicial | Nome de quem recebe. |
| CPF/CNPJ do beneficiário | Sim, salvo depósito judicial | Documento de quem recebe. |
| Tipo de Pix | Sim, no Pix | Chave ou Dados bancários. |
| Tipo de chave Pix | Sim, no Pix por chave | CPF, CNPJ, Email, Telefone ou Aleatória. |
| Chave Pix | Sim, no Pix por chave | A chave do destino. |
| Número do banco (ou Código do banco, ou COMPE) | Sim, em TED e Pix por dados bancários | Código COMPE do banco de destino. |
| ISPB | Não | Código ISPB do banco de destino. Precisa combinar com o COMPE. |
| Número da agência | Sim, em TED, Interna e Pix por dados bancários | Só números. |
| Dígito da agência | Depende do banco | Na transferência Interna é obrigatório. |
| Número da conta | Sim, em TED, Interna e Pix por dados bancários | Só números. |
| Dígito da conta | Sim, em TED, Interna e Pix por dados bancários | Número ou X. |
| Tipo de conta | Não | Corrente (padrão), Poupança ou Pagamento. |
| ID externo (ou Código externo) | Não | Identificador seu. Precisa ser único na conta. |
| Etiquetas (ou Tags) | Não | Etiquetas da transferência. |
| Dados personalizados | Não | Dados extras em formato JSON. |
A planilha indica a conta financeira, não a conta de transferência. A Kobana escolhe a conta de transferência dessa conta financeira que atende o tipo da transferência.
Passo a passo
- Abra Financeiro > Transferências > Importar.
- Baixe um dos arquivos de exemplo e preencha as linhas.
- Arraste o arquivo para a área de envio. O painel mostra a pré-visualização.
- Clique em Iniciar Importaçao.
O que acontece depois
A importação roda em segundo plano. Linhas com dados incorretos ou inconsistentes não são importadas e o erro aparece em "Arquivos Enviados". As linhas corretas são importadas mesmo que outras tenham erro.
As transferências importadas aparecem em Gerenciar com a situação Pendente e seguem o mesmo ciclo das criadas no formulário. Veja Acompanhamento, edição e cancelamento.
Pela API
A importação também pode ser feita pela API v1.