Sumrio

Importao de arquivos CSV................................................................................................................2

Tabela 1 Clientes, Fornecedores e Colaboradores........................................................................2
Tabela 2 Contas a Pagar, Contas a Receber .................................................................................4
Tabela 3 Lanamentos ..................................................................................................................6
Exemplos de arquivos de importao...................................................................................................7

Importao de arquivos CSV.

possvel importar Clientes, Fornecedores, Colaboradores, Contas a Pagar, Contas a
Receber e Lanamentos. Para que isso seja possvel, os dados devem estar em um arquivo texto no
formato CSV. Esse arquivo deve conter obrigatoriamente na primeira linha um cabealho com o
nome de mapeamento das colunas, ou seja, arquivos sem cabealho no sero importados. No
existe uma ordem definida para as colunas no cabealho, bastando que cabealho contenha as
colunas com os nomes de mapeamento corretos para que os valores sejam importados. Na
ocorrncia de erro em algum valor durante a importao, este no ser importado, porem, os demais
dados, tanto das outras colunas sero importadas normalmente.
As colunas devem estar separadas por ';' (Ponto e Virgula) ou ',' (Virgula) . Os valores devem
estar delimitados por (Aspas Duplas) ou ' (Aspas Simples). Para que uma coluna seja ignorada,
basta deixar seu nome de mapeamento em branco ( ).
O cabealho deve estar identificado com nomes de mapeamento de acordo as opes listadas na
coluna Nome de mapeamento. Note que em alguns mapeamentos existem varias opes
disponveis para nomes.

Tabela 1 Clientes, Fornecedores e Colaboradores.

Nomes de mapeamento

Descrio

tipo

Largura

Observao

'nome' ou 'nome fantasia' Nome do cliente ou

Empresa

texto

100 Campo obrigatrio.

'razao social'

Razo social da
empresa.

texto

100

'pessoa'

Identifica pessoa
jurdica e fsica.

texto

'cpf 'ou 'c.p.f'

Nmero do CPF

texto

14 Coluna chave. *
Formato: 000.000.000-00.

'cnpj' ou 'c.n.p.j'

Nmero do CNPJ

texto

18 Coluna chave. *
Formato: 00.000.000/0000-00

'fundacao'

Data da fundao da
empresa

texto

Formato: DD/MM/AAAA

'capital social' ou
'capsocial'

Capital social da
empresa

Decimal

Formato: 99999999999,99.

'nascimento' ou
'data nascimento'

Data de nascimento,
para pessoas fsica.

data

'sexo'

Sexo, caso seja pessoa

fsica

texto

'empresa'

Empresa onde trabalha, texto

caso seja pessoa fsica

'fone' ,'fone1' ,'telefone'

ou 'telefone1'

Nmero de telefone

texto

20

'fone2' ou 'telefone2'

Nmero de telefone 2

texto

20

'fone3' ou 'telefone3'

Nmero de telefone 3

texto

20

'fax'

Nmero de Fax

texto

20

'celular'

Numero do celular

texto

20

1 Para pessoas jurdicas:

'J' ou 'Jurdica'.
Para pessoas fsicas:
'F' ou 'Fsica'.
Qualquer outro valor incluindo vazio, vai
ser interpretado como fsica.

10 Formato: DD/MM/AAAA
Valores vlidos : 'Masculino' ou 'M',
'Feminino' ou 'F'
100

'email' ou 'email1'

Endereo de email

texto

50

'email2'

Endereo de e-mail 2

texto

50

'web' ou 'home page'

Endereo na web.

texto

100

'endereco' , ' endereco1',

'rua' , 'rua1'

Localizao: Rua,
Avenida.

texto

200

'complemento', '
complemento1'

Complemento para o
endereo 1

texto

200

'num' ou 'numero'

Nmero para o
endereo 1

nmero

'bairro' ou 'bairro1'

Nome do bairro o
endereo 1.

texto

50

'cidade', 'cidade1' , 'ibge'

ou 'codibge'

Nome ou cdigo do
IBGE da cidade do
endereo 1.

texto

50 A coluna deve ser utilizada para informar o

nome ou o cdigo do IBGE da cidade.
Ateno: ao se optar por utilizar o cdigo
do IBGE deve se usar o formato com 7
dgitos.
ex.: '5300108' ou 'Braslia'.

'cep' ou 'cep1'

Nmero do CEP

texto

'endereco2' ou 'rua2'

Localizao : Rua,
Avenida

texto

200

'complemento2'

Complemento para o
endereo 2.

texto

200

'num2' ou 'numero2'

Nmero para o
endereo 2.

nmero

'bairro2'

Nome do bairro o
endereo 2.

texto

50

'cidade2' , 'ibge2' ou
'codibge2'

Nome ou cdigo do
IBGE da cidade do
endereo 2.

texto

50 A coluna deve ser utilizada para informar o

nome ou o cdigo do IBGE da cidade.
Ateno: ao se optar por utilizar o cdigo
do IBGE deve se usar o formato com 7
dgitos. ex.: '5300108' ou 'Braslia'.

'cep2'

Nmero do CEP

texto

'observacoes',
'observacao', 'nota', ou
'notas'

Informaes adicionais texto

'rg', 'r.g' ou 'identidade'

Nmero de identidade
para pessoa fsica.

texto

20

'inscricao estadual', ou
'i.e'

Nmero da inscrio
estadual, para pessoa
jurdica.

texto

20

Formato: 00000-000

Formato: 00000-000
2000

* COLUNAS CHAVE.
Para a importao de Clientes, Fornecedores ou Colaboradores so utilizadas duas colunas
chave. A pesquisa realizada nas colunas 'CPF' para pessoas fsicas e 'CNPJ' para pessoas Jurdica.
Antes de importar os dados, feita uma busca para tentar localizar algum registro que tenha valores
iguais a uma dessas colunas e, caso seja encontrado um registro correspondente, esse ser
atualizado de acordo com os valores informados no arquivo.

Tabela 2 Contas a Pagar, Contas a Receber

Nomes de mapeamento

Descrio

tipo

Largura

Observao

'cliente', 'fornecedor',
'favorecido',
'colaborador', 'nome' ou
'nomefantasia'

Nome do cliente

texto

100 Caso o CPF ou CNPJ informado esteja

cadastrado no jFinanas, esta coluna no
precisa ser mapeada no cabealho. O CPF
e CNPJ so as chaves para a busca do
cliente ou favorecido no jFinanas para a
associao do registro.

'cpf' ou 'c.p.f'

C.P.F para pessoa fsica texto

14 O sistema faz uma busca pelo C.P.F

informado e, caso encontre algum registro,
associa com o lanamento.
Formato: 000.000.000-00

'cnpj' ou 'c.n.p.j'

C.N.P.J para pessoa

jurdica.

texto

18 O sistema faz uma busca pelo C.N.P.J

informado e, caso encontre algum registro,
associa com o lanamento.
Formato: 00.000.000/0000-00

'historico'

Informaes adicionas
sobre lanamento

texto

'emissao','data', 'emissao'
ou 'dataemissao'.

Data da emisso do
lanamento.

data

10 Formato: DD/MM/AAAA

'numero','documento',
'numerodoc',
'numerodocumento',
'numdoc'

Identifica o nmero do
documento.

texto

20 Coluna chave. *
Caso j exista uma conta a pagar ou a
receber com o mesmo nmero que est
sendo importado, esta ser editada e
ter seus campos alterados de acordo
com os valores informados no arquivo.

'portador'

Portador do
lanamento.

texto

50

'vencimento', ' vencto'

Data do vencimento do data

lanamento

'valor'

Valor total do
lanamento

'juros'

Valor do juro cobrado decimal

aps o vencimento

Formato: 9,99 ou 9.

'tipo juros'

Especifica o mtodo de texto

calculo dos juros.

Deve conter uma das seguintes expresses:

Para que o clculo seja dirio:
'Diariamente'
'Dia'
'D'
Para que o clculo seja mensal:
'Mensalmente'
'Ms'
'M'

'frequencia'

Define a freqncia do
lanamento.

texto

Deve conter uma das seguintes expresses:

'nica'
'Diariamente'
'Semanal'
'Cada 15 dias'
'Mensal'
'Bimestral'
'Trimestral'
Semestral'
'Anual'

'fim frequncia' ou

Define se o lanamento texto

deve conter uma das seguintes expresses:

decimal

100

10 Caso no seja informado o vencimento ser

importado com a data corrente.
Formato: DD/MM/AAAA.
Campo Obrigatrio. Se o valor for zero
ou vazio, o registro no ser importado.
Formato: 99999999999,99.

'fimfrequencia'

ser contnuo ou ter

uma data de
encerramento.

Com Parcelas: 'Sim' ou 'S'

Sem Parcelas: 'No' ou 'N'.

'numero vezes', 'novezes', Quantidade de parcelas inteiro

'numerovezes', 'parcelas' do lanamento.

O parcelamento s vai ser considerado

quando a coluna 'fim frequencia' estiver
marcado com 'Sim' ou 'S'.

'observacoes',
'observao', 'nota',
'notas', 'obs'

Informaes adicionais texto

do lanamento.

'forma pagamento',
'formapgto',
'formapagamento'

Define como ser

texto
efetuado o lanamento
da programao. Ao
iniciar, o jFinanas
lana automaticamente
os lanamentos
marcados com a opo
para lanamento
automtico que estejam
vencendo.

'numero boleto',
'numeroboleto',
'noboleto', 'boleto'.

Representao
texto
numrica do cdigo de
barras do documento.

'competencia', 'data'
'competencia',
'datacompetencia'

Data da competncia do data

lanamento.

10 Formato : DD/MM/AAAA

'serie' ou 'seriedoc'

Srie do documento

10

'multa'

Valor da multa aps o decimal

vencimento

Formato: 9,99 ou 9.

'conta'

nesta coluna deve ser

informado o nmero da
conta a qual o
lanamento esta
associado.

Lanamentos sem informao de conta

podero ser associados a uma conta
escolhida no ato da importao.

data

2000

deve conter uma das seguintes expresses:

Para lanamento manual: 'Manual' ou
'M'.
Para lanamento automtico: 'Auto' ou
'A'.

100

'plano de conta', 'plano de Associa o lanamento a texto

contas', 'planconta'.
um registro do plano de
contas. Caso o registro
no seja encontrado o
mesmo cadastrado.

O registro do plano de conta deve estar

com o caminho completo, e cada nvel
deve estar separado por : (Dois pontos).
por exemplo : 'Comercial:Vendas'

'centro de custo', 'centro Associa o lanamento a texto

de custos'.
um centro de custo.
Caso o registro no seja
encontrado o mesmo
cadastrado.

O registro do centro de custo deve estar

com o caminho completo, e cada nvel
deve estar separado por : (Dois pontos).
por exemplo : 'Administrao:Financeiro'

'tipodoc',
'tipodocumento',
'tipo documento',
'tipo do documento'

Identifica o tipo de texto

documento.

Exemplos:
'Cheque', 'Duplicata', 'Boleto' etc.

'meio de pagamento'
'meiodepagamento'

Identifica o tipo de
pagamento.

Exemplos:
'Dinheiro', 'Cheque', 'Carto de Crdito'
etc.

* COLUNA CHAVE
Para a importao de lanamentos de contas a pagar/receber a coluna 'numero documento'
ser utilizada como chave. Caso j exista uma conta a pagar/receber com o mesmo nmero que est
sendo importado, esta ser editada e ter seus campos alterados de acordo com os valores
informados no arquivo.

Tabela 3 Lanamentos
Nomes de mapeamento

Descrio

tipo

Largura

Observao

'data', 'vencimento',
'vencto', 'data
vencimento',
'datavencimento',
'datavencto'.

Data do lanamento

data

'valor', 'credito', 'receita',

'despesa'.

Valor total do
lanamento.

decimal

'cliente', 'favorecido',
'fornecedor','colaborador',
'nomefantasia', 'nome',
'cpf', 'c.p.f', 'cnpj','c.n.p.j'.

Nome, CPF ou CNPJ

do Cliente ou
Favorecido associado
ao lanamento.

texto

100

texto

100 O registro do plano de conta deve estar

com o caminho completo, e cada nvel
deve estar separado por : (Dois pontos).
por exemplo : 'Financeiro:Depsitos'.

'centro de custo',
'centro de custos'

Associa o lanamento a texto

um centro de custo.
Caso o registro no seja
encontrado o mesmo
cadastrado.

O registro do centro de custo deve estar

com o caminho completo, e cada nvel
deve estar separado por : (Dois pontos).
Por exemplo:
'Departamento Comercial:Vendas'

'competencia',
'competencias',
'data competencia',
'datacompetencia'

Data de competncia do data

lanamento.

10 Formato: DD/MM/YYYY

'compensacao',
'data compensacao',
'datacompensacao'

Data de compensao
do lanamento.

data

10 Formato: DD/MM/YYYY

'Histrico','hist','
historicos'

Informaes adicionas
sobre lanamento.

texto

100

'numero', 'num',
'numerodoc',
'numerodocumento'

Identifica o nmero do texto

documento

20

'Nominal'

Identifica o nome da texto

pessoa para quem o
pagamento destinado.

100

'situao','status'

Situao do
lanamento.

'observao',
'observacoes'

Informaes adicionais texto

do lanamento.

'cotao'

Valor da cotao da
moeda.

'plano de contas' , 'plano Registro do plano de

de conta', 'planodecontas', contas associado ao
'planodeconta'.
lanamento.

inteiro

Decimal

10 Formato: DD/MM/YYYY

Campo Obrigatrio. Se o valor for zero

ou vazio, o lanamento no ser importado.
Formato: 99999999999,99.

2 Valores possveis:
Normal : 10,11,13
Compensado : 20,21,23
Cancelado : 30,31,33
2000
Formato: 999999,99.

Exemplos de arquivos de importao

Clientes , Fornecedores, Colaboradores.

Contas a pagar, Contas a Receber.

Lanamentos.