Definições para exportação do movimento de emissão de documentos fiscais.
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.

O movimento desejado refere-se a notas fiscais de venda (que gerem faturamento) ou que representem algum tipo de envio de produtos para clientes, representantes e outros, como por exemplo bonificações, brindes, amostras, etc. Não é necessário considerar notas fiscais de venda de imobilizado, transferências, devoluções, beneficiamento e outras que não estejam ligadas a comercialização de produtos de forma direta ou indireta.

Além de Notas Fiscais, exportar dados de Cupons Fiscais seguindo as mesmas premissas. As diferentes origens de informações (NFs, cupons, etc) podem estar em arquivo único ou arquivos individualizados.

A rotina de geração dos dados deve possuir um filtro de datas (data inicial e final). A data a ser filtrada refere-se a data de emissão da nota fiscal.

Não exportar (gerar) documentos fiscais cancelados, ou pelo menos criar campo identificador de que o documento esteja nessa situação.

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.

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. Vales 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.

As informações básicas necessárias são:

• Número do documento fiscal;

• Série e/ou tipo do documento;

• Natureza de Operação ou identificador do tipo de operação;

• Cliente;

• Informações pertinentes ao cliente como cidade, UF, etc;

• Representante / vendedor;

• Produto;

• Quantidade vendida;

• Unidade de medida de venda;

• Valor da venda;

• Valor dos impostos;

• Valor da comissão;

• Descontos / Acréscimos;

• Prazos de vencimento (parcelas).
  

As informações podem ser divididas da seguinte maneira:

Cabeçalho do Documento Fiscal.

• Número do Documento;

• Série e/ou tipo do documento:

  • Se o cliente utilizar mais de uma série de NFs;

  • ou utilizar esse campo como identificador se o cliente utilizar cupons fiscais e for utilizado um único arquivo para exportar os dados.

• Natureza da Operação ou identificador do tipo de operação (código fiscal):

  • Se não houver um cadastro de Naturezas de Operação:

    • Gravar nesse campo o código utilizado no documento fiscal;

  • Havendo um cadastro de Naturezas de Operação:

    • Se houver um campo determinando o tipo da transação (venda, bonificação, amostras) gravar essa informação;

    • e Gravar o código da Natureza (chave estrangeira) de uso interno.

    OBS: Se o sistema permitir a determinação da natureza de operação por item do documento (mais de um código fiscal na mesma NF), gerar essa informação nos Itens do Documento Fiscal.
    

• Valor total do documento - valor contábil / de cobrança:

  • Valor líquido a pagar pelo destinatário, já aplicados os descontos e acréscimos eventuais.

• Valor do ICMS gerado;

• Valor do IPI gerado;

• Cliente (destinatário) da transação:

  • Se estiver sendo importado o cadastro de clientes:

    • Informar apenas o código do cliente;

  • Se não estiver sendo importado o cadastro de clientes ou o sistema permitir a emissão com clientes avulsos:

    • Código do cliente;

    • Nome/razão social do cliente;

    • CNPJ/CPF;

    • Cidade / UF.

• Representante / vendedor;

  • Criar tantos campos quanto necessário se houver uma política de comissões distribuídas;

• Percentual da comissão se único para o documento (não for item a item);

• Alíquota de ICMS se único para o documento (não for item a item);

• Percentual de desconto de ICMS se venda para Zona Franca - Suframa;

• Alíquota de IPI se único para o documento (não for item a item);

• Alíquota de ISQN se único para o documento (não for item a item);

• Alíquota do imposto de substituição tributária se único para o documento (não for item a item);

• Valor ou percentual de desconto aplicado ao total do documento;

• Valor ou percentual de acréscimo aplicado ao total do documento;

• Valor ou percentual de outras despesas aplicado ao total do documento;

• Valor ou percentual de fretes;

Itens do Documento Fiscal.

• Número do Documento;

• Série e/ou tipo do documento - vide observações do Cabeçalho;

• Produto:

  • Se estiver sendo importado o cadastro de produtos:

    • Informar apenas o código do produto.

  • Se não estiver sendo importado o cadastro de produtos ou o sistema permitir a utilização de produtos avulsos / preenchidos no ato da emissão:

    • Código do produto;

    • Descrição;

    • Classificação fiscal;

    • Unidade de medida de venda se diferente da unidade de estoque ou se for produto avulso;

• Quantidade;

• Valor unitário ou total sem IPI;

• Alíquota ou valor do ICMS se item a item;

• Alíquota ou valor do IPI se item a item;

• Alíquota ou valor do ISQN se item a item;

• Alíquota ou valor do imposto de substituição tributária se item a item;

• Percentual ou valor da comissão se item a item;

Parcelamento (condições de pagamento).

• Número do Documento;

• Série e/ou tipo do documento - vide observações do Cabeçalho;

• Data de vencimento da parcela ou quantidade de dias;

• Valor ou percentual da parcela.
  
  

Se desejado, gerar os parcelamentos no cabeçalho do documento. Nesse caso, deve-se utilizar uma quantidade fixa de parcelamentos mesmo que não utilizado no documento - preencher os parcelamentos não utilizados com brancos ou zeros - , ou ainda criar campo indicando a quantidade de parcelas. Os parcelamentos devem ser os últimos campos do registro.

Para efeitos de estatística e análise, podem ser agregados outros campos de informações cadastrais ou relativos ao documento, conforme disponibilidade do sistema. Alguns exemplos são:

• Rota de venda;

• Região;

• Gerente;

• Frete CIF/FOB se não utilizado o campo frete do cabeçalho.