Especificações para exportação de dados cadastrais.
Formato livre.

Esse documento deve ser entendido como um guia básico para a geração de informações a serem importadas no WWC. O grande objetivo é atender o cliente, em suas características de dados e negócio. As tabelas e campos são sugestões, podendo e devendo sofrer adaptações. A rotina de importação será construída e personalizada a partir das definições e leiautes utilizados.

Considerações gerais.

Para importar dados de outro sistemas, deve-se observar algumas premissas de formatos e conteúdos das informações.

Abaixo estão descritas especificações genéricas, que podem depender e sofrer adaptações conforme o sistema de origem dos dados. Por exemplo, se no sistema administrativo de origem não existir um cadastro de cidades e essa informação é digitada diretamente no cadastro do cliente, ignorar a especificação do código da cidade e entender como nome da cidade.

Podem existir situações de campos que ou não se aplicam ao sistema ou ao cliente alvo. Nesses casos, não é necessário preencher com dados em branco ou similar. Simplesmente ignorar o campo - não exportar/gerar nada relativo ao campo. O objetivo é que o leiaute seja flexível e adaptável. Em nenhum momento espera-se uma estrutura rígida conforme as especificações relacionadas.

Por outro lado, podem existir informações características ao sistema ou ao cliente não relacionadas nesse documento. O desenvolvedor pode e deve se sentir a vontade em complementar informações (acrescentar campos) que achar pertinentes a integridade dos dados ou as características do cliente.

Estão especificadas diversas origens de informações. As origens a serem utilizadas e aproveitadas podem variar conforme a necessidade e solicitação do cliente.

Formatos de arquivos válidos.

Existem diferentes possibilidades para o formato dos arquivos de dados a serem importados:

• DBF (dBase V);

  • Os tipos de dados conforme a especificação nativa do formato.

• Texto com separadores: Os campos podem ter comprimento fixo ou variável, com caractere separador de campos;

  • O separador de campos pode ser tabulação (ascii 9), ponto e vírgula ou algum outro caractere a escolha que não conflite com os dados;

  • Registros, um por linha, finalizados por CR (ascii 13) ou CR/LF (ascii 13 / 10);

  • Os campos de valores podem estar formatados ou não com separador de milhar e separador decimal;

  • Campos de data formatados ou não com separadores (/);

  • Campos texto podem conter acentuação.

• CSV:

  • Campos de largura variável;

  • Campos com separados por "," (vírgula) ou ";" (ponto e vírgula);

  • Informações de texto entre aspas duplas;

    • Se houverem caracteres aspas a serem exportados, gerar duas aspas duplas seguidas.

  • Valores numéricos com separador decimal "." (ponto) sem separador de milhar;

  • Campos de data no formato #aaaa/mm/dd#;

  • Registros separados por avanço de linha: CR ou CR/LF.

• Texto com tamanho fixo: Similar a arquivos de transferência bancária, os campos sempre com tamanho fixo sem necessidade de separadores de campos. Valem as regras descritas na especificação "Texto com separadores";

• XLS: Formato Excel.

OBS: Os campos de mesmo tipo devem preferencialmente obedecer um padrão nos diferentes locais de utilização. Favor não utilizar, por exemplo, campo numérico com separador decimal em um local e sem separador em outro.

Optando por campos de largura fixa, campos textos devem ser alinhados a esquerda com preenchimento de espaços (ascii 32) e campos numéricos alinhados a direita precedidos com zeros (ascii 48).

Exceto para o formato DBF, os dados de diferentes tabelas podem ser exportados em um arquivo único. Nesse caso, utilizar como primeiro campo de cada linha um identificador do tipo de registro (TR) ou criar linhas separadoras dos tipos de dados.

Para facilitar a operação do usuário/cliente, definir de forma fixa ou configurável o nome e local do(s) arquivo(s) exportado(s).

Documentação e definição dos leiautes.

Deve ser fornecido documentação dos leiautes utilizados contendo:

• Nome do(s) arquivo(s) e finalidade;

• Se contém acentuação, qual o conjunto de caracteres utilizado (DOS, Windows, etc);

• Separador dos campos se aplicável;

• Identificação do tipo de registro quando exportação em único arquivo;

• Para os campos (algumas opções podem ser opcionais conforme o formato de exportação escolhido):

  • Nome do campo e finalidade;

  • Tamanho (largura, quantidade de caracteres);

  • Separador decimal e de milhar ou quantidade de casas inteiras e decimais;

  • Se campos tipo data utilizam ou não separadores e qual o formato utilizado (dd/mm/aaaa, aaaammdd, etc);

Além da descrição dos leiautes, disponibilizar uma amostra dos arquivos exportados.

Tabelas de dados.

Observar que segue detalhamento genérico, sabendo-se que os dados disponíveis podem variar conforme o programa utilizado. Considerar as peculiaridades do sistema origem, adaptando as informações conforme a necessidade. Pode haver acréscimo de campos que sejam pertinentes ou então desconsiderar os campos sugeridos se não aplicáveis.

Nas especificações abaixo, entender código para tabela relacionada como chave estrangeira da tabela.

Basicamente, imagina-se as seguintes tabelas (origens) de dados:

• Produtos de venda e materiais (insumos);

• Alíquotas ou valores de IPI;

• Alíquotas de ICMS de venda (quando diferenciadas por produto);

• Unidades de medida;

• Grupos e/ou famílias de classificação dos produtos e materiais;

• Custos de materiais (aquisição, reposição);

• Operações e atividades;

• Fichas técnicas de produtos;

• Preços de venda;

• Países e unidades federativas;

• Cidades;

• Clientes (pessoas);

• Representantes e/ou vendedores;

• Comissões - atrelar o percentual de comissões na tabela determinante, seja produtos, grupos, etc.

Produtos e Materiais.
Cadastro dos produtos de venda (fabricados ou comprados) bem como de matérias-primas (insumos) quando aplicável.

• Código identificador;

• Descrição;

• Descrição de venda;

• Unidade de medida ou código para tabela relacionada;

• Código para grupo de classificação em tabela relacionada ;

  • ou identificador do tipo (produto de venda, insumo, etc);

• Alíquota de IPI (percentual ou valor) ou código para tabela relacionada;

• Alíquota de ICMS de venda ou código para tabela relacionada.
  
  

Unidades de medida.
As diferentes unidades de medida utilizadas.

• Código identificador (ou sigla);

• Descrição;

• Sigla.
  
  

Grupos de Classificação
Se os produtos e materiais tiverem agrupamentos e classificações determinados por outra(s) tabela(s). Havendo tabelas independentes representando uma hierarquia de cadastros, descrever na documentação a forma de relacionamento.

• Código identificador;

• Descrição;

• Sendo um cadastro hierárquico único:

• Nível;

• Código do pai ou nulo (vazio) quando primeiro nível;
  
  

Alíquotas de IPI
Se houver uma tabela de alíquotas agrupadas por classificação fiscal ou similar quando houverem diferentes valores ou alíquotas de IPI.

• Código identificador ou classificação fiscal;

• Descrição;

• Valor fixo ou percentual;

• Identificador se Valor Fixo ou Percentual.
  
  

Alíquotas de ICMS.
Havendo alíquotas diferenciadas entre os produtos para o cálculo de ICMS de venda, descrever as diferentes alíquotas ou bases de cálculos envolvidas.

Custos de Materiais.
Relacionar o último custo de aquisição ou reposição (conforme o desejado), já descontados ou acrescidos os impostos e outras despesas pertinentes.

• Código identificador do produto/material;

• Custo;

• Data do custo.
  
  

Operações e atividades.
Havendo fichas técnicas de composição para os produtos, relacionar o cadastro de elementos de mão de obra (roteiro de fabricação) utilizados e sua relação com centros de custos se aplicável.

• Código identificador;

• Descrição;

• Identificador se a opção é utilizada como tempo ou quantidade;

• Código do Centro de Custos;

• Custo hora ou custo minuto se calculado/disponível no sistema origem;
  
  

Fichas técnicas de produtos.
Relacionar os elementos que compõem a estrutura dos produtos, tanto os insumos quanto o roteiro de fabricação (mão de obra).

• Código do produto;

• Utilização do item: Produção ou Preparação (setup);

• Tipo do item: Se o item é Produto ou Operação;

• Código do item: Produto ou Operação;

• Quantidade utilizada ou tempo: Descrever na documentação a unidade de medida do tempo (horas, minutos, etc) e a maneira da informação (tempo real ou convertido para decimais).
  
  OBS: Havendo fichas alternativas para efeito de PCP, considerar (exportar) apenas a ficha padrão.
  
  

Preços de Venda.
Se não for utilizado o programa WWC para a formação dos preços de venda, exportar os preços calculados pelo sistema de origem. Se aplicável, exportar em diferentes listas de preços.

• Código da Lista de preços;

• Código do Produto;

• Preço de venda.
  
  

Países e Unidades Federativas.
Quando exportado o cadastro de clientes e havendo cadastros relacionados.

• Países

  • Código Identificador;

  • Nome.

• Unidades Federativas;

  • Código identificador;

  • Nome;

  • Sigla;

  • Código do País.
    
    

Cidades
Valem as observações acima.

• Código identificador;

• Nome;

• Código da unidade federativa.
  
  

Clientes (pessoas).
Não havendo tabelas relacionadas para cidades (e como conseqüência Ufs e países), informar o nome (conteúdo) conforme o sistema de origem. Havendo tabelas relacionadas, informar os códigos e desconsiderar os campos quando redundantes.

• Código identificador;

• Nome;

• Tipo: Pessoa Física ou Jurídica;

• Sexo;

• CNPJ ou CPF;

• Inscrição Estadual ou documento de identidade;

• Endereço;

• Bairro;

• CEP;

• Cidade - Código ou nome;

• UF;

• País;

• Telefone (podem ser informados 2 telefones);

• Ramal;

• Celular;

• Fax;

• Email;

• Observações gerais.
  

Representantes e/ou vendedores.

• Código identificador;

• Nome.