Layout da Carga de Cadastro para Terceiros
INTRODUÇÃO
Os painéis do Analytics da Viasoft foram desenvolvidos para atender aos clientes da Viasoft através da importação diretamente dos bancos de dados dos sistemas Agrotitan, Petroshow, Construshow e ViaSuper. A partir dos layouts apresentados abaixo, será possível a integração do Analytics da Viasoft com outros sistemas de ERP
Objetivo
O objetivo deste documento é apresentar para futuros clientes que utilizam ERP de empresa terceiras e pretendem utilizar os painéis do Analytics da Viasoft. Especificamente, neste documentos apresenta os layout para importação de arquivos no formato CSV, Excel, ou texto, podendo também ser feita através de API ou disponibilizando os dados em um banco de dados intermediário.
Glossário
Inteiro - Deve ser preenchido no formato 9999999999
Numeric - Deve ser preenchido no formato 9999999999.99
Date - Deve ser preenchido no formato YYYYMMDD
Character - Deve ser preenchido com caracteres alfanuméricos
Meios para Integração
Existem algumas possibilidades para podem ser utilizadas para integração com o DW, sendo elas as seguintes sugestões:
Arquivo: A partir da disponibilização de arquivos nos formatos CSV, Excel, texto, Json entre outros em uma área de FTP, é possível agendar a leitura destes arquivos atualizando o DW com as informações disponibilizadas.
API: A partir da disponibilização de API’s é possível agendar a busca das informações para atualizar o DW.
Banco de Dados: A partir de um banco de dados intermediário onde serão disponibilizadas as informações conforme layout abaixo, será possível agendar a leitura destas tabelas e atualizar o DW com as informações disponibilizadas.
Modelos para Integração
Algumas possibilidades para podem ser utilizadas para controlar as integração com o DW, sendo elas as seguintes sugestões:
ULTALT: Nas estruturas de integração, possui o campo ULTALT, que consiste em informar a data da última alteração (inclusão, alteração ou exclusão) em cada registro enviado para ser integrado.
CDC: A partir de ferramenta de CDC, pode-se efetuar a integração do banco origem com o DW
Período Fixo: Determina-se um período fixo (3, 6 meses, 1 ano) de integração, ou seja, definido um período de integração a aplicação retroagem até a data em questão e integra todos os registros até a data atual.
Layout para Atender cada Painel
Painel de Análise Contábeis
LAYOUT | COMENTÁRIO |
cada_ctbestabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos Contábil |
cada_ctbccusto | Tabela de cadastro de Centro de Custos deve conter Informações dos dados Cadastrais dos Centros Contábil |
cada_ctbplanoconta | Tabela de cadastro do Plano de Contas deve conter Informações detalhadas sobre as características do Plano de Contas |
cada_ctbmodelodre | Tabela de cadastro do Modelo de DRE deve conter Informações detalhadas sobre as características dos Modelos de DRE |
Painel de Gestão de Pessoas
LAYOUT | COMENTÁRIO |
cada_rhestabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos |
cada_rhevento | Tabela de cadastro de Eventos deve conter Informações Cadastrais dos Eventos da Folha de Pagamento do Colaborador |
cada_rhfuncao | Tabela de cadastro de Funções deve conter Informações Cadastrais das Funções dos Colaboradores |
cada_rhlocal | Tabela de cadastro de Local deve conter Informações Cadastrais das Funções dos Colaboradores |
cada_rhcolaborador | Tabela de cadastro de Colaborador deve conter informações detalhadas sobre os dados Cadastrais dos Colaboradores na Empresa |
cada_rhsituacao | Tabela de cadastro de Situação deve conter Informações Cadastrais da Situação em que o Colaborador possa ter no Estabelecimento |
cada_rhmotabsenteismo | Tabela de cadastro de Motivo de Absenteísmo deve conter Informações Cadastrais dos Motivos do absenteísmo |
cada_rhmotrescisao | Tabela de cadastro de Motivo de Rescisão deve conter Informações Cadastrais dos Motivos Utilizados para Rescisão dos Colaboradores |
Painel de Análise de Vendas e Metas
LAYOUT | COMENTÁRIO |
cada_estabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos |
cada_cidade | Tabela de cadastro de Cidade deve conter informações dos dados Cadastrais das Cidades |
cada_pessoa | Tabela de cadastro de Pessoa deve conter informações detalhadas sobre os dados cadastrais dos clientes e fornecedores |
cada_endereco | Tabela de cadastro de Endereços deve conter informações do relativas ao endereço dos Clientes e Fornecedores |
cada_produto | Tabela de cadastro de Produtos deve conter informações detalhadas sobre as características de cada produto oferecido pela empresa. |
cada_configpedido | Tabela de cadastro de Pedido deve conter informações detalhadas sobre as configurações que podem ser aplicadas aos pedidos feitos pelos clientes ou fornecedores |
cada_tipooperacao | Tabela de cadastro de Tipo de Operação deve conter Informações detalhadas sobre as característica da operação de entrada ou saída |
cada_safra | Tabela de cadastro de Safra deve conter informações da periodicidade da safra |
cada_ccusto | Tabela de cadastro de Centro de Custos deve conter informações dos dados Cadastrais dos Centros de Custos da Empresa |
Painel de Análise do Fluxo de Caixa
LAYOUT | COMENTÁRIO |
cada_estabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos |
cada_cidade | Tabela de cadastro de Cidade deve conter informações dos dados Cadastrais das Cidades |
cada_pessoa | Tabela de cadastro de Pessoa deve conter informações detalhadas sobre os dados cadastrais dos clientes e fornecedores |
cada_endereco | Tabela de cadastro de Endereços deve conter informações do relativas ao endereço dos Clientes e Fornecedores |
cada_planofin | Tabela do cadastro do Plano de Contas Financeiro deve conter as informações das contas contábeis utilizadas no financeiro |
cada_situacaofin | Tabela de cadastro de Situação do Documento Financeiro deve conter as informações da situação em que o documento financeira se encontra |
cada_portador | Tabela de cadastro de Portador deve conter as informações dos dados cadastrais dos portadores financeiros que pode ser do tipo de banco ou caixa |
cada_ccusto | Tabela de cadastro de Centro de Custos deve conter informações dos dados Cadastrais dos Centros de Custos da Empresa |
cada_produto | Tabela de cadastro de Produtos deve conter informações detalhadas sobre as características de cada produto oferecido pela empresa. |
cada_confcontrato | Tabela cadastro de Contratos deve conter informações sobre os tipos de configurações de contratos de que podem ser aplicadas aos contratos de clientes ou fornecedores |
cada_safra | Tabela de cadastro de Safra deve conter informações da periodicidade da safra |
Painel de Análise de Clientes
LAYOUT | COMENTÁRIO |
cada_estabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos |
cada_cidade | Tabela de cadastro de Cidade deve conter informações dos dados Cadastrais das Cidades |
cada_pessoa | Tabela de cadastro de Pessoa deve conter informações detalhadas sobre os dados cadastrais dos clientes e fornecedores |
cada_endereco | Tabela de cadastro de Endereços deve conter informações do relativas ao endereço dos Clientes e Fornecedores |
cada_ccusto | Tabela de cadastro de Centro de Custos deve conter informações dos dados Cadastrais dos Centros de Custos da Empresa |
Painel de Análise de Compras
cada_estabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos |
cada_cidade | Tabela de cadastro de Cidade deve conter informações dos dados Cadastrais das Cidades |
cada_pessoa | Tabela de cadastro de Pessoa deve conter informações detalhadas sobre os dados cadastrais dos clientes e fornecedores |
cada_endereco | Tabela de cadastro de Endereços deve conter informações do relativas ao endereço dos Clientes e Fornecedores |
cada_produto | Tabela de cadastro de Produtos deve conter informações detalhadas sobre as características de cada produto oferecido pela empresa. |
cada_configpedido | Tabela de cadastro de Pedido deve conter informações detalhadas sobre as configurações que podem ser aplicadas aos pedidos feitos pelos clientes ou fornecedores |
cada_tipoperacao | Tabela de cadastro de Tipo de Operação deve conter Informações detalhadas sobre as característica da operação de entrada ou saída |
cada_ccusto | Tabela de cadastro de Centro de Custos deve conter informações dos dados Cadastrais dos Centros de Custos da Empresa |
Painel de Análise de Estoque
cada_estabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos |
cada_cidade | Tabela de cadastro de Cidade deve conter informações dos dados Cadastrais das Cidades |
cada_pessoa | Tabela de cadastro de Pessoa deve conter informações detalhadas sobre os dados cadastrais dos clientes e fornecedores |
cada_endereco | Tabela de cadastro de Endereços deve conter informações do relativas ao endereço dos Clientes e Fornecedores |
cada_ccusto | Tabela de cadastro de Centro de Custos deve conter informações dos dados Cadastrais dos Centros de Custos da Empresa |
cada_produto | Tabela de cadastro de Produtos deve conter informações detalhadas sobre as características de cada produto oferecido pela empresa. |
cada_produtolote | Tabela de cadastro de Lotes de Produtos deve conter informações detalhadas sobre as características dos lotes de produtos |
cada_local | Tabela de cadastro de Local de Estoque deve conter informações dos dados cadastrais dos locais onde estão sendo estocados os produtos. |
cada_tipooperacao | Tabela de cadastro de Tipo de Operação deve conter Informações detalhadas sobre as característica da operação de entrada ou saída |
cada_configpedido | Tabela de cadastro de Pedido deve conter informações detalhadas sobre as configurações que podem ser aplicadas aos pedidos feitos pelos clientes ou fornecedores |
Painel de Originação de Grãos
cada_estabelecimento | Tabela de cadastro de Estabelecimento deve conter Informações sobre os dados Cadastrais dos Estabelecimentos |
cada_cidade | Tabela de cadastro de Cidade deve conter informações dos dados Cadastrais das Cidades |
cada_pessoa | Tabela de cadastro de Pessoa deve conter informações detalhadas sobre os dados cadastrais dos clientes e fornecedores |
cada_endereco | Tabela de cadastro de Endereços deve conter informações do relativas ao endereço dos Clientes e Fornecedores |
cada_ccusto | Tabela de cadastro de Centro de Custos deve conter informações dos dados Cadastrais dos Centros de Custos da Empresa |
cada_produto | Tabela de cadastro de Produtos deve conter informações detalhadas sobre as características de cada produto oferecido pela empresa. |
cada_configcontrato | Tabela cadastro de Contratos deve conter informações sobre os tipos de configurações de contratos de que podem ser aplicadas aos contratos de clientes ou fornecedores |
cada_configromaneio | Tabela de cadastro de Romaneios deve conter informações detalhadas sobre as configurações que podem ser aplicadas aos romaneios de entrada ou saída |
cada_tipooperacao | Tabela de cadastro de Tipo de Operação deve conter Informações detalhadas sobre as característica da operação de entrada ou saída |
cada_local | Tabela de cadastro de Local de Estoque deve conter informações dos dados cadastrais dos locais onde estão sendo estocados os produtos. |
cada_safra | Tabela de cadastro de Safra deve conter informações da periodicidade da safra |
Layout
CADA_ESTABELECIMENTO - Tabela de cadastro de Estabelecimento deve conter informações sobre os dados Cadastrais dos Estabelecimentos
Chave Única: IDESTABELECIMENTO, IDEMPRESA
COLUNA | COMENTÁRIO | TIPO | TAMANHO |
IDESTABELECIMENTO | Deve ser Preenchido com a Identificação Única do Código do Estabelecimento Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
IDEMPRESA | Deve ser Preenchido com a Identificação Única do Código da Empresa Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
RAZAO | Informação da Razão Social do Estabelecimento - Obrigatório. | Character | 80 |
FANTASIA | Informação do Nome Fantasia do Estabelecimento. | Character | 80 |
ATIVO | Indicativo da Situação do Estabelecimento. Valores Válidos: 1 = Ativo, 2 = Inativo | Inteiro |
|
CIDADE | Informação da Descrição da Cidade em que o Estabelecimento se encontra. | Character | 80 |
ESTADO | Informação da Descrição da Unidade Federativa em que o Estabelecimento se encontra. | Character | 45 |
PAIS | Informação da Descrição do País em que o Estabelecimento se encontra. | Character | 80 |
CNPJ | Informação da Descrição da CNPJ do Estabelecimento | Character | 14 |
ULTALT | Deve ser Preenchido com a Data e Hora da Última Atualização no Banco de Dados de Origem | Data e Hora |
|
DELETADO | Indicativo do registro foi excluído no banco de dados de origem. Valores Válidos: 0 = Ativo, 1 = Deletado | Inteiro |
|
CADA_CIDADE -Tabela de cadastro de Cidade deve conter informações dos dados Cadastrais das Cidades
Chave Única: IDCIDADE
COLUNA | COMENTÁRIO | TIPO | TAMANHO |
IDCIDADE | Deve ser Preenchido com a Identificação Único do Código da Cidade Proveniente do Banco de Dados de Origem - Obrigatório | Character | 10 |
DESCRCIDADE | Informação da Descrição do Nome da Cidade - Obrigatório | Character | 80 |
DESCRESTADO | Informação da Descrição da Unidade da Federação - Obrigatório | Character | 45 |
UF | Informação da Sigla da Unidade Federativa. | Character | 2 |
DESCRPAIS | Informação da Descrição do País - Obrigatório. | Character | 80 |
DESCABREVPAIS | Informação da Descrição Abreviada do País. | Character | 3 |
ULTALT | Deve ser Preenchido com a Data e Hora da Última Atualização no Banco de Dados de Origem | Data e Hora |
|
DELETADO | Indicativo do registro foi excluído no banco de dados de origem. Valores Válidos: 0 = Ativo, 1 = Deletado | Inteiro |
|
CADA_PESSOA - Tabela de cadastro de Pessoa deve conter informações detalhadas sobre os dados cadastrais dos clientes e fornecedores
Chave Única: IDPESSOA
COLUNA | COMENTÁRIO | TIPO | TAMANHO |
IDPESSOA | Deve ser Preenchido com a Identificação Única do Código da Pessoa (Cliente /Fornecedores) Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
NOME | Informação do Nome/Razão Social da Pessoa - Obrigatório. | Character | 100 |
NOMEFANTASIA | Informação do Apelido/Nome Fantasia da Pessoa. | Character | 100 |
DESCRTIPOPESSOA | Informação da Descrição do Tipo da Pessoa - Obrigatório. | Character | 100 |
DTNASCIMENTO | Informação do Data de Nascimento ou Fundação da Pessoa. | Data |
|
ESTADOCIVIL | Informação do Estado Civil da Pessoa. Valores Válidos: 1 = Solteiro, 2 = Casado, 3 = Divorciado, 4 = Separado, 5 = Viúvo ou 6 = Jurídico | Inteiro |
|
NATUREZA | Informação da Natureza da Pessoa. Valores Válidos:1 = Jurídica, 2 = Física | Inteiro |
|
FUNCIONARIO | Indicativo se a Pessoa é funcionário ou não. Valores Válidos: 1 = Sim, 2 = Não | Inteiro |
|
CONCEITO | Informação do Conceito Atribuído para a Pessoa | Character | 40 |
DTCADASTRO | Deve ser preenchido com a Data de Cadastro ou Inclusão no Banco de Dados de Origem | Data |
|
DTINATIVO | Deve ser Preenchido com a Data de Inatividade do Cadastro da Pessoa | Data |
|
SITUACAO | Indicativo da Situação do Produto. Valores Válidos: 1 = Ativo ou 2 = Inativo. | Inteiro |
|
GRUPOECONOMICO | Descrição do Grupo Econômico referente à Pessoa Física e Jurídica | Character | 100 |
ULTALT | Deve ser Preenchido com a Data e Hora da Última Atualização no Banco de Dados de Origem | Data e Hora |
|
DELETADO | Indicativo do registro foi excluído no banco de dados de origem. Valores Válidos: 0 = Ativo, 1 = Deletado | Inteiro |
|
CADA_ENDERECO -Tabela de cadastro de Endereços deve conter informações do relativas ao endereço dos Clientes e Fornecedores
Chave Única: IDENDERECO, IDESTABELECIMENTO, IDEMPRESA, IDPESSOA
COLUNA | COMENTÁRIO | TIPO | TAMANHO |
IDENDERECO | Deve ser Preenchido com a Identificação Único do Código do Endereço Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
IDESTABELECIMENTO | Deve ser Preenchido com a Identificação Única do Código do Estabelecimento Informado no Cadastro de Estabelecimento (CADA_ESTABELECIMENTO) Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
IDEMPRESA | Deve ser Preenchido com a Identificação Única do Código da Empresa Informado no Cadastro de Estabelecimento (CADA_ESTABELECIMENTO) Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
IDPESSOA | Deve ser Preenchido com a Identificação Única do Código da Pessoa Informado no Cadastro de Pessoa (CADA_PESSOA) Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
ENDERECO | Informação Detalhada do Endereço, incluindo o Logradouro, Nome da Rua, Número da Casa/Apartamento | Character | 200 |
IDCIDADE | Deve ser Preenchido com a Identificação Único do Código da Cidade Informado no Cadastro de Cidade (CADA_CIDADE) Proveniente do Banco de Dados de Origem - Obrigatório | Character | 10 |
LATITUDE | Informação da Latitude do Endereço está localizado. | Numérico |
|
LONGITUDE | Informação da Longitude do Endereço está localizado. | Numérico |
|
BAIRRO | Informação do Bairro referente ao Endereço está localizado. | Character | 80 |
REGIAO | Deve ser Preenchido com a Região que o Endereço está localizado. | Character | 80 |
ULTALT | Deve ser Preenchido com a Data e Hora da Última Atualização no Banco de Dados de Origem | Data e Hora |
|
DELETADO | Indicativo do registro foi excluído no banco de dados de origem. Valores Válidos: 0 = Ativo, 1 = Deletado | Inteiro |
|
CADA_LOCAL - Tabela de cadastro de Local de Estoque deve conter informações dos dados cadastrais dos locais onde estão sendo estocados os produtos.
Chave Única: IDENDERECO, IDESTABELECIMENTO, IDEMPRESA
COLUNA | COMENTÁRIO | TIPO | TAMANHO |
IDLOCAL | Deve ser Preenchido com a Identificação Única do Código do Local Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
IDESTABELECIMENTO | Deve ser Preenchido com a Identificação Única do Código do Estabelecimento Informado no Cadastro de Estabelecimento (CADA_ESTABELECIMENTO) Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
IDEMPRESA | Deve ser Preenchido com a Identificação Única do Código da Empresa Informado no Cadastro de Estabelecimento (CADA_ESTABELECIMENTO) Proveniente do Banco de Dados de Origem - Obrigatório | Inteiro |
|
DESCRICAO | Informação da Descrição do Local de Estoque - Obrigatório. | Character | 60 |
ULTALT | Deve ser Preenchido com a Data e Hora da Última Atualização no Banco de Dados de Origem | Data e Hora |
|
DELETADO | Indicativo do registro foi excluído no banco de dados de origem. Valores Válidos: 0 = Ativo, 1 = Deletado | Inteiro |
|
CADA_PRODUTO - Tabela de cadastro de Produtos deve conter informações detalhadas sobre as características de cada produto oferecido pela empresa.
Chave Única: IDPRODUTO, IDESTABELECIMENTO, IDEMPRESA
COLUNA | COMENTÁRIO | TIPO |