¶ Migração de Dados por ETL
¶ Visão Geral
No Petros existe a possibilidade de realizar a importação de registros através de ETLs. Toda ETL no Petros recebe um arquivo na extensão .txt e insere os dados referentes.
Este artigo é baseado nas ETLs de importação disponíveis na versão 2.05 compatíveis com todas as releases acima da 143.
¶ Importação de Dados por ETL
Atualmente existem as seguintes ETLs de importação:
Importa Cliente
Importa Condições de Venda por Item
Importa Itens
Importa Saldo de Clientes
Importa Saldo Itens
Importa Veículo Cliente
Importa Título Financeiro
Importa Orçamento Financeiro
¶ Onde Importar?
Para realizar a importação siga os passos:
| Tópico | Passo a passo |
|---|---|
 |
No Petros Retaguarda acesse a opção Administração do Sistema ➔ Gerenciamento ➔ ETL Importação |
 |
Dentro do menu selecione a ETL desejada |
 |
no botão Importar do lado direito da tela e escolha o arquivo .txt |
¶ Preparando o Arquivo
Para realizar a importação em todas as ETLs é necessário um arquivo .txt nomeado corretamente.
A maneira mais prática para criar este arquivo é utilizar uma planilha da extensão .xls ou qualquer planilha editável por softwares como o Excel e LibreOffice Planilhas.
Anexo a este artigo temos modelos de planilhas para importação. Baixe os modelos e preencha os campos de acordo com as regras de validação que serão discutidas abaixo. Com sua planilha montada, exporte-a ou salve-a no formato texto csv (.csv).
Esse arquivo pode ser facilmente renomeado para um arquivo de extensão .txt sem perder a formatação. Na exportação para texto csv lembre-se de escolher a opção de separar campos com ponto e vírgula ( ; ) e deixe os textos sem aspas. Outro detalhe é que o arquivo .txt deve, obrigatoriamente, estar em codificação UTF8 para a correta importação de caracteres especiais.
¶ Tipos de Importações
A seguir detalhararemos nas abas todos os tipos de importações que podem ser feitas por meio de ETLS.
- A ETL de importação de Itens é utilizada para criar Itens e Item X Empresa na base do cliente. O modelo da planilha e do .txt estão anexos nomeados como ETL - ImportaItens. Note que no arquivo item.txt temos vários exemplos representando vários itens diferentes que podem ser cadastrados. No Petros a ETL está nomeada como Importa Itens.
O arquivo deve ter o nome item.txt.
Cada linha do arquivo deve representar um dos itens que será importado e os dados deverão ser separados com ponto e vírgula ( ; ) conforme o exemplo a seguir:
codigo;codigo_barra;ITEM 1;[…];001
codigo;codigo_barra;ITEM 2;[…];001
¶ Informações Importantes
- 1 - O código da empresa no arquivo deve ser o mesmo codigo da empresa no Petros
- 2 - Os campos referentes à tributação não são obrigatórios para importação do arquivo, porém se optar por preencher as tributações, todos os tipos de tributações de CST e CFOP já deverão estar cadastrados no Petros e no arquivo a nomenclatura deve ser respeitada para que a importação ocorra corretamente
- 3 - Itens com códigos repetidos não são importados, os códigos devem ser obrigatoriamente diferentes entre si e diferentes de qualquer outro código de item na base
- 4 - A categoria de item deve ser exatamente igual ao Petros e a unidade de medida deve ser informada em sigla (UN para Unidade, LT para Litro, etc)
- 5 - O campo tipo_item deve ser numérico e pertencer ao conjunto:
[1] Produto
[2] Serviço
Isso significa que no arquivo de importação deve ser informado apenas o número e o Petros se encarrega de exibir a informação corretamente após o cadastro. Isso vale para os campos a seguir, que seguem a mesma regra de ser informado apenas números.
tipo_produção: [1] Própria, [2] Terceiros;
tipo_aplicação: [1] Comercialização, [2] Consumo e [3] Ativo-Imobilizado;
origem_produto: [0] Nacional, [1] Estrangeiro-exportação direta e [2] Estrangeiro-adquirido mercado interno
A ETL Importa Cliente é responsável por criar uma Pessoa e Cliente, Fornecedor e Colaborador, com os dados informados. O arquivo para importação deve ser nomeado de pessoa.txt. O material de exemplo anexado referente a esta ETL chama-se ETL - ImportaPessoa.
¶ Estejam atentos às regras a seguir
- 1 - As datas devem estar sempre no formato ‘AAAA-MM-DD’ no arquivo de importação. Por exemplo, 25/12/2016 deverá ser escrito 2016-12-25
- 2 - Os limites de crédito não são obrigatórios para criação do cliente
- 3 - O sexo deverá ser informado com um dígito numérico sendo:
[1] Masculino
[2] Feminino.
Na planilha de exemplo existem alguns campos comentados para melhor entendimento
ETL responsável por criar uma movimentação de Saldo Inicial para o item. O arquivo para importação deverás estar nomeado como item_saldo.txt. O material de exemplo está anexado ao arquivo nomeado como ETL - ImportaSaldoItem. O Saldo Inicial só pode ser criado uma vez, portanto a ETL funciona apenas 1 vez por item.
¶ Observem as regras
- 1 - O código da empresa no arquivo deve ser o mesmo codigo da empresa no Petros
- 2 - O nome do local de estoque deverá ser exatamente igual ao cadastrado no Petros, inclusive maiúsculas e minúsculas
- 3 - Como em todas as ETLs do Petros, a data deve estar no formato ‘AAAA-MM-DD’
Certifique-se que o Item esteja ativo na empresa em que a importação de saldo está sendo feita.
ETL responsável por criar condições de venda por item para clientes ou categorias de cliente já cadastrados. O nome do arquivo de importação deve ser condicao_venda_item.txt. O material de apoio está nomeado como ETL - Importa Condições de Venda por Item e está anexo a este artigo.
Atentem-se às observações a seguir sobre o preenchimento dos 14 campos obrigatórios:
Todos campos de valor deve ser maior que zero, mesmo que o campo não seja utilizado.
0 - ID_CLASSE_CLIENTE / ID_CLIENTE OBRIGATORIO
(Nome da classe ou CPF/CNPJ do cliente ou Codigo do Cliente)
O id_cliente: Poderá ser tanto o CNPJ/CPF quanto o código do cliente;
1 - ID_ITEM OBRIGATORIO
(Codigo do Item)
2 - ID_EMPRESA OBRIGATORIO
(Codigo empresa)
3 - ID_TIPO_RECEBIMENTO OBRIGATORIO
1 - ‘Espécie de Caixa’
2 - ‘Cheque a Vista’
3 - ‘Cheque-Pré’
4 - ‘Cartão de Crédito’
5 - ‘Cartão de Débito’
6 - ‘A Prazo’
7 - ‘Vale Frete’
8 - ‘Ticket’
4 - TIPO_CONDICAO OBRIGATORIO
1 - Desconto em Valor - Desconto em Valor por Unidade sobre o Preço Padrão
2 - Acréscimo em Valor - Acréscimo em Valor por Unidade sobre o Preço Padrão
3 - Desconto em % - Desconto em % sobre o Preço padrão
4 - Acréscimo em % - Acréscimo em % sobre o Preço padrão
5 - Preço Fixo
6 - Faixa de Preços - (Máximo e Mínimo) Se o preço da tabela padrão ficar abaixo do mínimo cobra-se o mínimo, se ficar acima do máximo cobra-se o máximo
11 - Preço Fixo (Financeiro)
12 - Desconto em % (Financeiro)
13 - Acréscimo em % (Financeiro)
14 - Desconto em Valor (Financeiro)
15 - Acréscimo em Valor (Financeiro)
16 - Faixa de Preços (Financeiro)
5 - PRECO_FIXO OBRIGATORIO
6 - PERCENTUAL_DESCONTO OBRIGATORIO
7 - PERCENTUAL_ACRESCIMO OBRIGATORIO
8 - DESCONTO_UNITARIO OBRIGATORIO
9 - ACRESCIMO_UNITARIO OBRIGATORIO
10 - PRECO_MINIMO OBRIGATORIO
11 - PRECO_MAXIMO OBRIGATORIO
12 - PRIORIDADE OBRIGATORIO
13 - CLASSE_CLIENTE OBRIGATORIO (1 - Classe ou 2 - Cliente)
A classe_cliente é um valor numérico e indica onde a condição de venda do item é inserida. Ela poderá ser associada tanto ao cliente quanto à uma classe de cliente, sendo [1] Insere na Classe [2] Insere no Cliente
14 - TIPO_CLIENTE_CNPJ_CPF_CODIGO OBRIGATORIO (1 - CNPJ/CPF ou 2 - CÓDIGO DA PESSOA)
No campo tipo_cliente_cnpj_cpf_codigo é definido como será tratado o id_cliente informado inicialmente. Deverá ser preenchido com uma das seguintes opções: [1] caso no id_cliente tenha sido informado o CPF ou CNPJ do cliente, ou [2] caso tenha sido informado o código do cliente.
Exemplo: UBER;888;900236;7;5;5;1;1;1;1;1;100;20;1;1
ETL - Importa Saldo de Cliente cria um título a receber de Venda a Prazo para o Cliente específico. O arquivo para importação deverá ser nomeado cliente_saldo.txt. O material de apoio anexo está nomeado como ETL - Importa Saldo de Cliente.
Note que:
A carteira de título financeiro deverá ser informada de acordo com as Carteiras de Títulos Financeiros cadastradas no Petros. O mesmo ocorre com o Tipo de Cobrança. Em ambos os casos deverá ser informada a denominação.
ETL responsável pela importação dos veículos de um cliente previamente cadastrado. O material de apoio anexo a este artigo está nomeado como ETL - Importa Veículo Cliente. Para importação o arquivo deverá ser veiculo_cliente.txt.
Vejam as observações:
O campo cnpj_cpf_codigo poderá ser preenchido com o CPF, CNPJ ou código do cliente, porém, da mesma forma que a ETL de condição de venda, no campo tipo_cnpj_codigo deverá ser informado 1 para CPF ou CNPJ e 2 para código.
No Petros essa ETL está nomeada como ETL - Importa Título Financeiro. O arquivo de importação deve ser nomeado como importa_titulo_financeiro.txt. Apenas alguns tipos de títulos podem ser importados via ETL e são eles:
Compra a Prazo
Adiantamento de Clientes
Captação de Recursos
Despesas
Saldo Credor de Funcionário
Conhecimento Frete
Venda a Prazo
Cartão de Crédito
Cartão de Débito
Cheque a Vista
Cheque Pré-Datado
Adiantamento a Fornecedores
Aplicação de Recursos
Receitas
Saldo Devedor de Funcionário
Vale Frete
Vale Motorista
- O leiaute do arquivo segue o seguinte padrão: código_empresa; pagar_receber; natureza_título; código_pessoa; número_título; número_parcela; data_emissão; data_vencimento; valor_título; código_banco; agencia_cheque; conta_cheque; cmc7_cheque.
As regras de validação do arquivo são as seguintes (nessa ordem):
CODIGO_EMPRESA: o código deverá ser de uma empresa já cadastrada no sistema;
PAGAR_RECEBER: Assume os valores:1 – Pagar;
2 – Receber.NATUREZA_TITULO: Informar o código da natureza, eles são fixos e são os seguintes:
101 - Compra a Prazo
106 - Adiantamento de Clientes
108 - Captação de Recursos
109 - Despesas
111 - Saldo Credor de Funcionário
116 - Conhecimento Frete
201 - Venda a Prazo
202 - Cartão de Crédito
203 - Cartão de Débito
204 - Cheque a Vista
205 - Cheque Pré-Datado
206 - Adiantamento a Fornecedores
208 - Aplicação de Recursos
209 - Receitas
211 - Saldo Devedor de Funcionário
213 - Vale Frete
220 - Vale MotoristaCODIGO_PESSOA: O código de uma pessoa já cadastrada no sistema;
NUMERO_TITULO: número do título do petros e comporta números e letras;
NUMERO_PARCELA: qualquer número maior que zero, por padrão, em caso de dúvidas, coloque 1;
DATA_EMISSAO e DATA_VENCIMENTO: Datas válidas no padrão: YYYY-MM-DD (Ano-Mes-Dia);
VALOR_TITULO: O valor do título com valores maiores que zero. Vírgula ou ponto poderão ser utilizados para delimitar as casas decimais, por exemplo, 2345,76 ou 2345.75 (Ambos representam o valor dois mil trezentos e quarenta e cinco reais e setenta e cinco centavos).
BANCO: Deve ser informado o código correspondendo ao banco. Esse código tem que ser o mesmo cadastrado no Petros pela tela Financeiro > Tabelas > Banco.
AGENCIA_CHEQUE: Deve ser informada a agência correspondente ao cheque (10 caracteres).
CONTA_CHEQUE: Deve ser informada a conta correspondente ao cheque (10 caracteres).
CMC7_CHEQUE: Deve ser informado o CMC7 do cheque.
Além do cuidado com esses campos, os seguintes parâmetros deverão estar marcados:
Sistema em Implantação (‘sistema.sistema_em_implantacao’),
Conta Financeira Padrão (‘financeiro.conta_financeira_padrao’),
Carteira de Cobrança Padrão (‘financeiro.carteira_cobranca_padrao’),
Tipo de Cobrança Padrão(‘financeiro.tipo_cobranca_padrao’)
Espécie Financeira Padrão(‘financeiro.especie_financeira_padrao’).
Ambos são parâmetros de empresa que podem ser encontrados no menu Administração ➔ Empresa ➔ Selecione sua Empresa ➔ Aba Financeiro/Sistema.
¶ Restrições:
Para títulos importados de natureza (202, 203), referentes à cartão de débito e crédito, é necessário que a pessoa correspondente à importação esteja com a classificação como Administradora de Cartão;
Para títulos importados de natureza (204, 205), referentes à cheque á vista ou a prazo, os campos BANCO, AGENCIA_CHEQUE, CONTA_CHEQUE e CMC7_CHEQUE devem estar preenchidos. Além disso, o código do banco deve ter um código correspondente no Petros.
- A ETL não importa títulos que considerar duplicados. Para serem duplicados, as validações são:
- 1 - Existe um título financeiro na mesma empresa informada
- 2 - Com a mesma natureza de título informada
- 3 - Com o mesmo valor do título informado
- 4 - Com o mesmo numero de título informado
- 5 - Com o mesmo numero de parcela informado
- 6 - Com a mesma data de emissão informada
Se os requisitos acima forem cumpridos o título é considerado duplicado e não é inserido pela ETL.
ETL responsável pela importação dos registro de orçamento financeiro para o sistema. Segue as regras e layout de importação:
ANO;DENOMINACAO;TIPO_DETALHE;CAMPO_1;CAMPO_2;CAMPO_3;MES;VALOR;USUARIO_GESTOR
ANO: Ano do orçamento financeiro;
DENOMINACAO: Descrição da capa do orçamento financeiro;
TIPO_DETALHE: Informa o tipo de detalhe para importação:1 - Por Categoria de Despesa, quando for esse tipo de detalhe o CAMPO_1 deverá conter a denominação de uma Categoria de Despesa. (CAMPO_2 e CAMPO_3 não será validados);
2 - Por Empresa e Categoria de Despesa, quando for esse tipo de detalhe o CAMPO_1 deverá conter o código de uma Empresa ativa e o CAMPO_2 a denominação de uma Categoria de Despesa. (CAMPO_3 não será validado);
3 - Por Tipo de Despesa, quando for esse tipo de detalhe o CAMPO_1 deverá conter o código de um Tipo de Despesa ativa. (CAMPO_2 e CAMPO_3 não será validados);
4 - Por Empresa e Tipo de Despesa, quando for esse tipo de detalhe o CAMPO_1 deverá conter o código de uma Empresa ativa e o CAMPO_2 o código de um Tipo de Despesa ativa. (CAMPO_3 não será validado);
5 - Por Centro de Resultado, quando for esse tipo de detalhe o CAMPO_1 deverá conter o código de uma Empresa ativa e o CAMPO_2 a denominação de um Centro de Resultado dessa empresa. (CAMPO_3 não será validado);
6 - Por Categoria de Despesa e Centro de Resultado, quando for esse tipo de detalhe o CAMPO_1 deverá conter a denominação de uma Categoria de Despesa, CAMPO_2 deverá conter o código de uma Empresa ativa e o CAMPO_3 a denominação de um Centro de Resultado dessa empresa;
7 - Por Tipo de Despesa e Centro de Resultado, quando for esse tipo de detalhe o CAMPO_1 deverá conter o código de um Tipo de Despesa ativa, CAMPO_2 deverá conter o código de uma Empresa ativa e o CAMPO_3 a denominação de um Centro de Resultado dessa empresa;MES: Informa o número do mês referente ao orçamento [1 até 12];
VALOR: Valor orçado;
USUARIO_GESTOR: Irá identificar o usuário gestor do detalhe. Esse campo deve representar o campo conta do cadastro de usuário no petros, esse usuário deve estar ativo e não pode ser um grupo;
¶ Download
Nas abas a seguir voc^poderá fazer o download do arquivo compactado para obter os modelos de cada ETL de importação
-
Nova ETL após issue 5011 - versão 2.22.?.?
padrão_-etl-_pessoa.xlsx -
Nova ETL após versão 3.22.?.?
etl_-_importacao_de_pessoa.xlsx