Manual do Programador Versão 1.0: Maio/2015

Transcrição

1 Versão 1.0: Maio/2015

2 Sumário Objetivo do... 3 Formato dos Dados... 3 Conteúdo dos s... 5 Avaliação e Testes... 6 Expectativa de Prazos... 8 Padrão do de Vendas... 9 Padrão do de Estoque Padrão do de Clientes Padrão do arquivo de Força de Vendas Padrão do de Produtos Informações Adicionais Exemplo de Aplicação do Detalhamento do Tabela de Mensagens de Erro Utilizadas no Processo de Validação Exemplos do Resumo de Avalição de s Com Situações de Erros a serem Tratadas pelo Desenvolvedor/Operador Sem Situações de Erros, s Prontos para Avaliação de Conteúdo Exemplo do Detalhamento de Avaliação de s Com Situações de Erros a serem Tratadas pelo Desenvolvedor/Operador Sem Situações de Erros, s Prontos para Avaliação de Conteúdo Exemplo do Detalhamento de Avaliação de Coerência Com Situações de Erros a serem Tratadas pelo Desenvolvedor/Operador Sem Situações de Erros, s Prontos para Avaliação de Conteúdo Exemplo de Avaliação de Conteúdo para Aceite

3 Objetivo do Prover as informações necessárias para o desenvolvimento dos arquivos que devem ser transmitidos diariamente contendo as informações de Vendas, Clientes, Estoque, Força de Vendas e Produtos para o ambiente de publicação dos fornecedores que integram a rede Danone. Formato dos Dados As informações devem ser enviadas em arquivos de formato texto plano, com registro de tamanho fixo e de acordo com o padrão de formatação estabelecido para cada tipo de informação, que trata os seguintes aspectos: Nomenclatura dos arquivos gerados Para facilitar a identificação e o acompanhamento do envio dos arquivos, por parte das pessoas envolvidas com este processo, foi estabelecido um padrão de nomenclatura que, em li nhas gerais, utiliza, para cada tipo de informação enviada, um prefixo que a identifica, uma sigla indicando o fornecedor a que a informação se refere e a data de geração do arquivo. Estrutura dos arquivos Para especificar os formatos para cada tipo de informação enviada estão sendo consideradas as seguintes informações: 1. Tipo de Registro: As informações enviadas nos arquivos são dispostas em linhas e cada tipo de arquivo tem tipos específicos de linhas (registros), que representam cada tipo de informação necessário para compor o arquivo. 2. Descrição do campo: Identifica e nomeia o dado que o campo representa. 3. Tipo de dado: Alfanumérico (A): Para este tipo de dado o alinhamento do campo deve ser feito à esquerda e quando a informação for menor que o tamanho especificado para o campo, as posições que restarem à direita devem ser preenchidas com espaços em branco; Data (D): Os campos que representarem datas devem ser informados no formato Ano (4 dígitos) + Mês (2 dígitos) + Dia (2 dígitos) conforme o exemplo: 30/05/2016 deve ser enviado no formato ; 3

4 Numérico (N): Para este tipo de dado o alinhamento do campo deve ser feito à direita e quando a informação for menor que o tamanho especificado para o campo, as posições que restarem à esquerda devem ser preenchidas com zeros; 4. Tamanho em posições: Indica exatamente quantas posições dentro do registro o campo deve ocupar. 5. Posição inicial: Indica exatamente a posição (quantidade de caracteres contados a partir do início do registro) onde o conteúdo de cada um dos campos deve ser colocado. 6. Formatação: Cada um dos campos tem um formato específico para a apresentação de seu conteúdo no arquivo, para este formato utilizamos a seguinte codificação: Campos do tipo alfanumérico têm seu formato identificado pela sigla X e entre parênteses quantos caracteres devem ser utilizados, exemplo: um campo alfanumérico de 15 posições terá a representação de formato igual a X (15) ; Campos do tipo numérico e com conteúdo representado por um número inteiro têm seu formato identificado pela sigla 9 e entre parênteses quantos caracteres devem ser utilizados, exemplo: um campo numérico de 10 posições terá representação do formato igual a 9(10) ; Campos do tipo numérico e com conteúdo representado por um número com casas decimais têm seu formato identificado pela sigla 9 para indicar os números, V para indicar que, a partir de uma determinada posição, os números representam casas decimais, porém sem utilizar um separador entre inteiros e decimais ou a sigla., para representar o número com casas decimais, para números negativos o sinal de - deve ocupar a primeira posição do campo. Exemplo de formatos para um campo numérico com duas casas decimais e tamanho de 10 posições com conteúdo de 15,30 Para o formato 9(8) v9(2) o preenchimento correto será ; 4

5 Para o formato 9(7).9(2) o preenchimento correto será ; Exemplo de formato numérico de 7 posições 9(7) para um valor negativo com conteúdo de -35 será Preenchimento obrigatório: Esta informação indica se o campo deve ser preenchido com um conteúdo valido e não nulo, ou seja, se o campo for obrigatório não poderá ser preenchido com valores considerados nulos para cada tipo de dado: Alfanumérico (A): Se o campo for obrigatório não poderá ser preenchido totalmente com espaços em branco; Data (D): Se o campo for obrigatório não poderá ser preenchido totalmente com zeros (que caracteriza uma data nula); Numérico (N): Se o campo for obrigatório não poderá ser preenchido totalmente com zeros ou zeros e ponto. ; 8. Conteúdo esperado: Indica o que deve ser considerado para preencher o campo, que pode ser um valor fixo, que será apresentado entre aspas ou a descrição com mais detalhes do campo. 9. Validação específica: Indica se serão realizadas validações específicas para o campo, como verificação de dados que possuem dígito verificar ou alguma regra de formação. 10. Nomenclatura dos arquivos: Garantir que os arquivos (txt) tenham a nomenclatura correta, sendo obrigatório que iniciem com o CNPJ do Distribuidor seguido do hífen ( _), Ex.: _VENDAS. Conteúdo dos s O conteúdo de cada um dos tipos de informação, bem como os procedimentos a serem observados quando de sua geração, devem considerar os seguintes critérios: Abrangência: 5

6 Define qual é a amplitude da captura de informações e, portanto, que tipos de filtros devem ser considerados para definir o conteúdo de cada um dos arquivos definidos. Periodicidade: Estabelece a frequência de envio e os filtros de período considerados na geração dos arquivos. Cardinalidade: Define o agrupamento de informações que deve ser respeitado na geração dos arquivos e na distribuição dos dados entre os diferentes tipos de registros definidos para cada arquivo. Unidade de medida: Determina como os dados relacionados a medidas quantitativas e monetárias devem ser enviados com o objetivo de manter as informações coerentes. As unidades de medida devem ser coerentes e equivalentes entre todos os arquivos enviados, exemplo: se os dados de Vendas estão sendo enviados em unidades de EAN13, o arquivo de Estoque também deve utilizar esta mesma unidade de medida. Avaliação e Testes Os arquivos gerados serão submetidos, segundo nossa metodologia, a diversas avaliações e testes que contemplam etapas de verificação sintática e semântica, bem como uma etapa final de confirmação/aceite, sob a responsabilidade do Agente de Distribuição, para atestar a veracidade e equivalência das informações encaminhadas em relação a movimentação de vendas e estoque e aos cadastros de cliente, produto e força de vendas do Agente de Distribuição, considerando um mesmo período de avaliação: Etapas de verificação: 1. Avaliação de arquivos: Verificação realizada nos arquivos gerados em relação ao atendimento das características especificadas em cada detalhamento de arquivos; 2. Avaliação de coerência: 6

7 Verificação da coerência das informações fornecidas em cada arquivo e que tem relação com os demais arquivos gerados; 3. Avaliação de conteúdo: Verificação de quantidades e valores informados nos arquivos em relação aos relatórios gerenciais utilizados pelos distribuidores e que apresentem as informações relativas ao mesmo escopo de dados dos arquivos gerados, sendo de responsabilidade do agente de distribuição a confirmação dos valores enviados nos arquivos com os valores reais para cada tipo de informação. O resultado das avaliações e testes geram informações que visam auxiliar o desenvolvedor dos arquivos assim como o responsável pelo envio das informações no processo de identificação e correção das inconsistências apuradas durante o processo de validação de formato e conteúdo. As informações reportadas são: Resumo da avaliação: Sumariza o resultado das avaliações realizadas nos arquivos e também os referentes a coerência entre os arquivos, apresentando os seguintes dados: o Tipo do arquivo; o Nome do arquivo avaliado; o Mensagem que identifica o erro/problema; o Total de ocorrências. Detalhamento da avaliação dos arquivos: Apresenta todos os erros/problemas identificados em cada um dos arquivos avaliados apresentando os seguintes dados: o Tipo do arquivo; o Nome do arquivo avaliado; o Número da linha do arquivo onde foi identificado o problema; o Nome do campo que apresentou o problema; o Conteúdo do campo que apresentou o problema; o Mensagem de erro/problema; o Observações/orientações. Detalhamento da avaliação de coerência: Apresenta todos os erros/problemas identificados relacionando as informações entre os arquivos avaliados e apresentado os seguintes dados: o Tipo do arquivo; o Nome do arquivo avaliado; 7

8 o Número da linha do arquivo onde foi identificada a primeira ocorrência do problema; o Conteúdo que representa a combinação de dados que não está coerente com o conteúdo apresentado em outro arquivo relacionado ao arquivo avaliado; o Mensagem de erro/problema. Após a realização das rotinas de avaliação, estas informações são encaminhadas aos responsáveis pelo desenvolvimento dos arquivos e pelo envio das informações para que realizem as correções indicadas no processo de geração dos arquivos e/ou nas configurações e cadastros utilizados para compor os arquivos. Após as correções, os novos arquivos devem ser enviados para que o processo de validação seja realizado novamente, até que não restar mais erros. Confirmação/aceite do conteúdo dos arquivos: Apresenta um resumo das informações constantes nos arquivos para que o Agente de Distribuição confirme e dê o seu de acordo, atestando que os dados enviados nos arquivos correspondem aos dados totais de movimentação (vendas e estoque) e de cadastros (produtos, clientes e força de vendas) apresentando os seguintes dados: o Tipo do arquivo; o Nome do arquivo avaliado; o Total de registros enviados; o Totais específicos por tipo de informação: Vendas : Período contido no arquivo; Valor totalizado no arquivo avaliado pa ra cada um dos tipos de documentos em Reais ; Total de dias distintos com transações de vendas ; Pontos de vendas distintos com transação. Estoque: Data enviado no arquivo; Quantidade de produtos distintos em estoque. Força de Vendas: Quantidade de vendedores distintos; Quantidade de clientes distintos. Expectativa de Prazos Prazos padrão/expectativa para cada etapa do processo: 8

9 Desenvolvimento dos arquivos: o Período que se inicia após o estudo deste manual e compreende as tarefas necessárias para gerar o conjunto de arquivos, conforme as instruções constantes neste manual, e que se encerra com a geração e envio do primeiro conjunto de arquivos; o Entendemos que este prazo varia conforme a disponibilidade de recursos e também da plataforma tecnológica adotada pelo agente de distribuição para a realização das tarefas, porém, por experiências previas, estimamos entre 5 e 10 dias uteis, em média. Validação dos arquivos: o Período que se inicia com o envio do primeiro conjunto de arquivos desenvolvidos e considera a avaliação dos dados conforme descrito neste manual e que se encerra com a conclusão com sucesso das validações de dados; o Entre 2 e 5 dias uteis, em média, com até 3 ciclos de envio, validação e correções. Confirmação/aceite dos arquivos: o Período que se inicia com a conclusão com sucesso das validações de dados e que encerra com a formalização por parte do agente de distribuição da veracidade do conteúdo dos arquivos enviados, conforme descrito neste manual; o Em até 2 dias úteis, em média. A seguir apresentamos o detalhamento de cada um dos tipos de arquivos. Padrão do de Vendas Nomenclatura: o Prefixo = VENDAS ; o A sigla do fornecedor é informada no proces so de implantação; o Data no formato Dia + Mês + Ano + Hora + Minuto + Segundo + Milésimo de segundo; o Extensão do nome do arquivo = TXT ; o Exemplo: de Vendas gerado no dia 30/05/2016 às 15:30: para um fornecedor com sigla igual a DNN teremos: VENDASDNN txt Conteúdo do arquivo: o Abrangência: Indica as ocorrências que devem ser enviadas no arquivo, sendo: Para todas as transações consideramos que dados relativos a uma mesma transação não podem ser duplicados, o que configura um erro. Portanto se, por algum motivo, uma transação válida 9

10 armazena no banco de dados do agente de distribuição a informação referente a um mesmo produto, dentro de uma mesma transação, porém em vários registros diferentes, estes dados devem ser agregados e enviados como apenas um registro dentro do arquivo de Vendas, conforme o exemplo abaixo: Transação de Venda válida, número do documento = 005 em que na base de dados são mantidos 3 registros referente ao produto Produto A com quantidades iguais a uma unidade em cada registro. Deve ser enviado apenas um registro com a soma das quantidades dos três registros. Portanto, 3 unidades de produto e com o valor total da ocorrência para o produto Produto A. Vendas (tipo de documento P ou N e quantidade de venda positiva): Devem ser enviadas todas as transações de vendas efetuadas e válidas; Bonificações (Tipo de documento = B e quantidade de venda positiva): Devem ser enviadas todas as transações de vendas efetuadas e válidas; Devoluções (Quantidade de venda negativa): Devem ser enviadas todas as transações de devolução efetuadas, considerando a data de devolução para preencher o campo de Data de Venda e não a data da venda original, consideramos como devoluções também os cancelamentos ocorridos posteriormente ao envio da movimentação de vendas. o Periodicidade: indica o padrão para a seleção das datas de vendas que devem ser enviadas no arquivo, considerando: Fases de avaliação: Devem ser enviados apenas arquivos contendo a movimentação de períodos completos (um período, mês, por arquivo) que tenham a movimentação de vendas já encerrada para que seja possível avaliações independentes da influência de ajuste e/ou procedimentos de fechamento de vendas ; Fase de produção: Assim que o envio das informações entrar em produção, deve ser possível ao usuário gerar as informações em base diária (dia de faturamento já finalizado), preferencialmente de forma automática, ou de um período retroativo, para situações em que seja necessário o envio de dados anteriores ao período atual. o Unidades de medida: As unidades de medida devem manter uma correspondência ao código de produto considerado, portanto, quando for informado um código EAN13 (código preferencial para o envio das 10

11 informações), por exemplo, tanto a quantidade informada quanto o preço de venda devem corresponder a esta informação, ou seja, quantidade informada em unidades de EAN13 e preço de venda de um EAN13. Estrutura do arquivo: Registro cabeçalho do arquivo de Vendas : Cardinalidade: Deve ser a primeira linha do arquivo e só pode existir um registro deste tipo no arquivo. Campo Tipo Tamanho Inicial Formatação Conteúdo Obrigatório Validação Esperado Tipo do A X (1) H Registro Identificador A X (7) VENDA11 CNPJ A (14) CNPJ sem Fornecedor Máscara Registro Movimento de Vendas : Cardinalidade: Repete-se para todas as transações realizadas para um determinado fornecedor. Campo Tipo Tamanho Inicial Formatação Conteúdo Obrigatóri Validação Esperado o Tipo do A X (1) D Registro CNPJ Agente A (14) CNPJ sem máscara Distribuição Identificação Cliente A X (18) CNPJ ou CPF sem máscara Data Transação D AAAAMMD D Data da transação de venda ou devolução Número A X (20) Número de Documento controle (NF, Pedido, etc.) Código do A (14) EAN13 ou DUN14 Produto (cód. interno no caso de montagem de kit) Quantidade N (15).9(4) Em unidades compatíveis com o código de produto utilizado Preço de Venda Código Vendedor Campo Reservado N (5).9(2) Preço unitário + imposto (ICMS e ST caso seja atribuído ao seu estado) A X (20) Vendedor que realizou a venda A X (10) Preencher com brancos 11

12 Tipo Documento A X (1) Preencher com N para NF, P para Pedido ou B para Bonificação CEP N (5)-9(3) CEP do Cliente Código Lote A X (13) Código lote produto Validade A AAAAMM Validade do lote Lote Dia Validade Lote N Dd Dia da validade Pedido A X (1) Pedido sugerido Sugerido pela Danone Preço de Venda (US$) N (5).9(2) Preço unitário em Dólares (US$) Tipo de N (4) Unidade de Unidade medida para quantidade (vide tabela) Tabela Tipo de Unidade: Tipo de Unidade Descrição 0001 Unidades de Consumo 0002 Quilos Exemplo do arquivo: Validação e testes: o Avaliação do arquivo: São verificados todos os dados dos campos indicados como obrigatórios e realizadas as seguintes validações: Registro Cabeçalho: Campo CNPJ Fornecedor : Validação do CNPJ. Registro Movimento de Vendas: Campo CNPJ Agente de Distribuição : Validação do CNPJ; Campo Identificação Cliente : Validação do CNPJ/CPF; Campo Código Produto : Validação EAN13 (quando o distribuidor es tiver configurado na Danone para enviar o EAN13); Campo Preço Venda : Validação da faixa de variação do preço em relação às médias de mercado, com o objetivo de identificar erros de fracionamento; Campo Tipo de Documento : Validação dos tipos válidos ( N, P ou B ); Campo CEP : Validação do formato do CEP. 12

13 o Avaliação de coerência: São verificadas as informações que representam campos chave para relacionamento com outros arquivos enviados, conforme abaixo: Campo Identificação Cliente, este código deve constar no arquivo de Clientes; Campo Código Produto : este código deve constar nos arquivos de Estoque e Produtos; Campo Código Vendedor, este código deve constar no arquivo de Força de Vendas associado ao mesmo cliente para o qual foi feita a venda (campo Identificação do Cliente ). o Confirmação/Aceite de conteúdo: A avaliação de conteúdo é de responsabilidade do agente de distribuição e deve considerar as quantidades e preços de venda informados no arquivo para cada uma das transações por tipo de documento e demais informações destacadas no resumo de avaliação; Os totais apurados devem ser equivalentes aos apurados nos relatórios gerenciais do agente de distribuição que reportem o total geral do movimento de vendas para o mesmo período e para os mesmos produtos enviados no arquivo de vendas. Padrão do de Estoque Nomenclatura: o Prefixo = ESTOQUE ; o A sigla do fornecedor é informada no processo de implantação; o Data no formato Dia + Mês + Ano + Hora + Minuto + Segundo + Milésimo de segundo; o Extensão do nome do arquivo = TXT ; o Exemplo: de plano de visitação gerado no dia 30/05/2016 às 15:30: para um fornecedor com sigla igual a DNN teremos: ESTOQUEDNN txt Conteúdo do arquivo: As seguintes características de dados devem ser consideradas para a geração do arquivo de estoque. o Abrangência: Indica os produtos que devem ser enviados no arquivo, sendo: Posição de estoque para todos os produtos constantes no cadastro de produtos do agente de distribuição (ativos e inativos) referentes ao fabricante a que se refere a geração do arquivo. o Periodicidade: Indica o padrão para a seleção das datas de estoque que devem ser enviadas no arquivo, considerando: 13

14 Fases de avaliação: Devem ser enviados arquivos correspondentes à última posição de estoque do período de movimentação de vendas enviado, exemplo, se for enviada a movimentação de vedas de junho/2016 a data que deve ser enviada no arquivo de estoque é 30/06/2016 ; Fase de produção: Assim que o envio das informações entrar em produção, deve ser possível ao usuário gerar as informações em base diária (dia de faturamento já finalizado) ou de um período retroativo, para situações em que seja necessário o envio de dados anteriores ao período atual, para envio diário a posição de estoque deve ser a mesma utilizada para a geração do arquivo de vendas. o Unidades de Medida: As unidades de medida devem manter uma correspondência ao código de produto considerado, portanto quando for informado um código EAN13 (código preferencial para o envio das informações), a quantidade informada deve corresponder a esta informação, ou seja, quantidade informada em unidades ou em quilos do EAN13. Estrutura do arquivo: Registro cabeçalho do arquivo de Estoque: Cardinalidade: Deve ser a primeira linha do arquivo e só pode existir um registro deste tipo no arquivo. Campo Tipo Tamanho Inicial Formatação Conteúdo Obrigatóri Validação Esperado o Tipo do A X (1) H Registro Identificador A X (7) ESTOQ11 CNPJ A (14) CNPJ sem Fornecedor Máscara Data do D AAAAMMDD Data posição Estoque de estoque Registro Estoque: Cardinalidade: Repete-se para todos os produtos em estoque. Campo Tipo Tamanho Inicial Formatação Conteúdo Esperado Obrigatório Validação Tipo do Registro A X (1) E CNPJ Agente A (14) CNPJ ou CPF sem Distribuição máscara Código do A X (14) EAN13 ou DUN14 Produto (Código interno no caso de montagem de Kit) 14

15 Quantidade em Estoque A (15).9(4) Em unidades compatíveis com o código de produto utilizado Código Lote A X(20 Código do lote produto Validade Lote D AAAAMMDD Data de validade do lote Tipo de N (4) Unidade de medida Unidade para quantidade (vide tabela) Tabela Tipo de Unidade Tipo de Unidade Descrição 0001 Unidades de Consumo 0002 Quilo Exemplo do arquivo: Validação e testes: o Avaliação do arquivo: São verificados todos os dados dos campos indicados como obrigatórios e realizadas as seguintes validações: Registro Cabeçalho: Campo CNPJ Fabricante : Validação do CNPJ. Registro plano de visitação mensal : Campo CNPJ Distribuidor : Validação do CNPJ; Campos Código do Produto : Validação EAN13 (Quando o distribuidor estiver configurado na Danone para enviar o EAN13). o Avaliação de coerência: São verificadas as informações que representam campos chave para relacionamento com outros arquivos enviados, conforme abaixo: Campo Código do Produto : este código deve constar no arquivo de Produtos. o Confirmação/Aceite de conteúdo: A avaliação de conteúdo é de responsabilidade do agente de distribuição e deve considerar os clientes e vendedores informados no arquivo e demais informações destacadas no resumo de avaliação; 15

16 Os totais apurados devem ser equivalentes aos apurados nos relatórios gerenciais do agente de distribuição que reportem o total geral de posição de estoque para o mesmo período e para os mesmos produtos enviados no arquivo de estoque. Padrão do de Clientes Nomenclatura: o Prefixo = CLIENTES ; o A sigla do fornecedor é informada no processo de implantação; o Data no formato Dia + Mês + Ano + Hora + Minuto + Segundo + Milésimo de segundo; o Extensão do nome do arquivo = TXT ; o Exemplo: de equipamentos de exposição gerado no dia 30/05/2016 às 15:30: para um fornecedor com sigla igual a DNN teremos: CLIENTESDNN txt Conteúdo do arquivo: As seguintes características de dados devem ser consideradas para a geração do arquivo de equipamentos de exposição. o Abrangência: Indica os clientes que devem ser enviados no arquivo, sendo: Minimamente os clientes cadastrados (ativos e inativos) que tenham realizado compras nos últimos 3 meses em relação ao período da movimentação de vendas enviado, mas pode ser enviado o cadastro completo. o Periodicidade: Indica o padrão para a seleção dos clientes que devem ser enviados no arquivo, considerando: Fases de avaliação: Devem ser enviados arquivos correspondentes ao mesmo período de movimentação de vendas enviado, por exemplo, se for enviada a movimentação de vendas de junho/2016, deve ser enviado o cadastro de clientes completo ou minimamente os clientes cadastrados (ativos e inativos) que realizaram compras entre 01/04/2016 e 30/06/2016 inclusive; Fase de produção: Assim que o envio das informações entrar em produção, deve ser possível ao usuário gerar as informações em base diária (dia de faturamento já finalizado) ou de um período retroativo, para situações em que seja necessário o envio de dados anteriores ao período atual deve ser enviado o cadastro completo ou minimamente os clientes cadastrados com vendas dentro do período a ser enviado, ou seja, se for enviado um ano de dados retroativos todos os clientes que realizaram transações 16

17 que constam nos arquivos de vendas deste período (um ano) devem ser enviados. Estrutura do arquivo: Registro cabeçalho do arquivo de Clientes : Cardinalidade: Deve ser a primeira linha do arquivo e só pode existir um registro deste tipo no arquivo. Campo Tipo Tamanho Inicial Formatação Conteúdo Obrigatório Validação Esperado Tipo do A X (1) H Registro Identificador A X (7) PDV10 CNPJ N (14) CNPJ sem Fornecedor Máscara Registro de Clientes : Cardinalidade: Repete-se para todos os clientes versus Equipamento cadastrados. Campo Tip o Tamanh o Inicia l Formataçã o Conteúdo Esperado Obrigatóri o Validaçã o Tipo do Registro A X (1) D CNPJ Agente A (14) CNPJ sem Máscara Distribuição Identificação do A X (18) CNPJ ou CPF sem Cliente máscara Razão Social do A X (40) Razão social do Cliente cliente Endereço A X (40) Endereço (Logradouro) completo Bairro A X (30) Bairro do cliente CEP N (5)-9(3) CEP do cliente Cidade A X (30) Nome da cidade Estado A X (30) Unidade da federação, utilizar a sigla com dois caracteres Nome do Responsável A X (20) Nome do contato no PDV Números de A X (40) Números de Telefone telefone PDV CNPJ/CPF do A X (18) CNPJ/CPF sem cliente máscara Rota A X (10) Identificação da rota, caso não exista preencher com um valor fixo conveniente para o agente de distribuição Campo Reservado A X (10) Preencher com brancos Tipo de Loja A X (10) Código de segmento a que pertence o PDV 17

18 Representatividad e N (3).9(2) Representatividad e (percentual) em relação ao faturamento Exemplo do arquivo: Validação e testes: o Avaliação do arquivo: São verificados todos os dados dos campos indicados como obrigatórios e realizadas as seguintes validações: Registro Cabeçalho: Campo CNPJ Fornecedor : Validação do CNPJ. Registro Equipamentos de Exposição: Campo CNPJ Agente de Distribuição : Validação do CNPJ; Campo Identificação do Cliente : Validação do CNPJ/CPF; Campo CNPJ / CPF do Cliente : Validação do CNPJ/CPF; Campo CEP : Validação do formato do CEP. o Avaliação de coerência: se aplica ao arquivo de clientes. o Confirmação/Aceite de conteúdo: A avaliação de conteúdo é de responsabilidade do agente de distribuição e deve considerar o total de clientes informados no arquivo e demais informações destacadas no resumo de avaliação. Os totais apurados devem ser equivalentes aos apurados nos relatórios gerenciais do agente de distribuição que reportem o total de clientes para o mesmo período reportado no arquivo de clientes. Padrão do arquivo de Força de Vendas Nomenclatura: o Prefixo = FORCAVENDAS ; o A sigla do fornecedor é informada no processo de implantação; o Data no formato Dia + Mês + Ano + Hora + Minuto + Segundo + Milésimo de segundo; o Extensão do nome do arquivo = TXT ; o Exemplo: de equipamentos de exposição gerado no dia 30/05/2016 às 15:30: para um fornecedor com sigla igual a DNN teremos: FORCAVENDASDNN txt 18

19 Conteúdo do arquivo: As seguintes características de dados devem ser consideradas para a geração do arquivo de força de vendas : o Abrangência: Indica os registros de força de vendas que devem ser enviados no arquivo, sendo: Minimamente a força de vendas referente a todos os clientes cadastrados (ativos e inativos) que tenham realizado compras nos últimos 3 meses em reação ao período da movimentação de vendas enviado, mas pode ser enviado o cadastro completo. o Periodicidade: Indica o padrão para a seleção dos dados de objetivos por vendedor que devem ser enviados no arquivo, considerando: Fases de avaliação: Devem ser enviados arquivos correspondentes ao mesmo período de movimentação de vendas enviado, exemplo, se for enviada a movimentação de vendas de junho/2016, deve ser enviado o cadastro de força de vendas de todos os clientes cadastrados ou minimamente referente aos clientes cadastrados (ativos e inativos) que realizaram compras entre 01/06/2016 e 30/06/2016 ; Fase de produção: Assim que o envio das informações entrar em produção deve ser possível ao usuário gerar as informações em base diária (dia de faturamento já finalizado) ou de um período retroativo, para situações em que seja necessário o envio de dados anteriores ao período atual deve ser enviada a força de venda referente ao cadastro completo de clientes ou minimamente referente aos clientes cadastrados com vendas dentro do período a ser enviado, ou seja, se for enviado um ano de dados retroativos todos os clientes que realizaram transações que constam nos arquivos de vendas deste período (um ano) devem ser enviados no arquivo de força de vendas. o Unidades de medida: se aplica ao arquivo de força de vendas. Estrutura do arquivo: Registro cabeçalho do arquivo de Força de Vendas : Cardinalidade: Deve ser a primeira linha do arquivo e só pode existir um registro deste tipo no arquivo. Campo Tipo Tamanho Inicial Formatação Conteúdo Obrigatório Validação Esperado Tipo do A X (1) H Registro Identificador A X (7) FV10 CNPJ A (14) CNPJ sem Fornecedor Máscara Registro de Força de Vendas : 19

20 Cardinalidade: Repete-se para todos os relacionamentos entre clientes (PDV) e vendedores da força de vendas do agente de distribuição. Campo Tipo Tamanho Inicial Formatação Conteúdo Esperado Obrigatório Validação Tipo do A X (1) D Registro CNPJ Agente A (14) CNPJ sem máscara Distribuição Identificação Cliente A X (18) CNPJ ou CPF, sem máscara Código do A X (13) Código de Gerente identificação do gerente de vendas ligado ao vendedor Nome do Gerente A X (50) Nome do gerente de vendas Código do A X (13) Código de Supervisor identificação do supervisor de vendas ligado ao vendedor Nome do Supervisor A X (50) Nome do supervisor de vendas Código do A X (20) Código de Vendedor identificação do vendedor Nome do A X (50) Nome do vendedor Vendedor responsável pelo cliente Exemplo do arquivo: Validação e testes: o Avaliação do arquivo: São verificados todos os dados dos campos indicados como obrigatórios e realizadas as seguintes validações: Registro Cabeçalho: Campo CNPJ Fabricante : Validação do CNPJ. Registro Força de Vendas : Campo CNPJ Distribuidor : Validação de CNPJ; Campo Identificação do Cliente : Validação do CNPJ/CPF. o Avaliação de coerência: São verificadas as informações que são campos chave em outros arquivos enviados: Campo Identificação do Cliente : este código deve constar nos arquivos de clientes. o Confirmação/Aceite de conteúdo: 20

21 A avaliação de conteúdo é de responsabilidade do agente de distribuição e deve considerar o total de clientes/estrutura de vendas informados no arquivo e demais informações destacadas no resumo de avaliação; Os totais apurados devem ser equivalentes aos apurados nos relatórios do agente de distribuição que reportem o total de clientes/estrutura de vendas para o mesmo período reportado no arquivo de força de vendas. Padrão do de Produtos Nomenclatura: o Prefixo = PRODUTOS ; o A sigla do fornecedor é informada no processo de implantação; o Data no formato Dia + Mês + Ano + Hora + Minuto + Segundo + Milésimo de segundo; o Extensão do nome do arquivo = TXT ; o Exemplo: de equipamentos de exposição gerado no dia 30/05/2016 às 15:30: para um fornecedor com sigla igual a DNN teremos: PRODUTOSDNN txt Conteúdo do arquivo: As seguintes características de dados devem ser consideradas para a geração do arquivo de produtos. o Abrangência: Indica os tipos de transações que devem ser enviadas no arquivo, sendo: Todos os produtos constantes no cadastro de produtos do distribuidor (ativos e inativos) referentes ao fabricante a que se refere a geração do arquivo. o Periodicidade: Indica o padrão para a seleção das datas de vendas que devem ser enviadas no arquivo, considerando: Fases de avaliação: Devem ser enviados arquivos com todo o cadastro de produtos (ativos e inativos) do fabricante no distribuidor; Fase de produção: Assim que o envio das informações entrar em produção deve ser possível ao usuário gerar as informações em base diária (dia de faturamento já finalizado) ou de um período retroativo, para situações em que seja necessário o envio de dados anteriores ao período atual seguindo o mesmo critério, deve ser enviado o cadastro de produtos completo (ativos e inativos) referentes ao fabricante enviado. o Unidades de medida: se aplica ao arquivo de produtos. Estrutura do arquivo: 21

22 Registro cabeçalho do arquivo de Produtos : Cardinalidade: Deve ser a primeira linha do arquivo e só pode existir um registro deste tipo no arquivo. Campo Tipo Tamanho Inicial Formatação Conteúdo Obrigatório Validação Esperado Tipo do A X (1) H Registro Identificador A X (10) CADPROD Data do D AAAAMMDD Data geração do arquivo Registro identificador: Cardinalidade: Deve ser a primeira linha do arquivo e só pode existir um registro deste tipo no arquivo. Campo Tipo Tamanho Inicial Formatação Conteúdo Esperado Obrigatório Validação Tipo do Registro A X (1) I CNPJ Agente A (14) CNPJ ou CPF sem Distribuição máscara Registro de produto: Cardinalidade: Repete-se para todos os produtos cadastrados para um determinado fornecedor. Campo Tipo Tamanho Inicial Formatação Conteúdo Esperado Obrigatório Validação Tipo do A X (1) V Registro CNPJ do Fornecedor A X (18) CNPJ sem máscara Razão Social A X (30) Razão social Fornecedor fornecedor Código do A X (14) Código interno do Produto produto no agente de distribuição Tipo de Embalagem N (1) 0 para embalagem não fracionada ou 1 para embalagem fracionada Código de Barras A X (14) EAN13 ou DUN14 Tipo do Código de Barras Nome do produto Divisão do Produto Campo reservado A (1) 1 para EAN13, 2 para DUN 14 ou 3 para outros A X (100) Apresentação do produto A X (40) Divisão do produto, caso não exista preencher com a razão social do fornecedor A X (30) Preencher com brancos 22

23 Status do Produto Campo reservado A X (1) A para ativo ou I para inativo A X (27) Preencher com brancos não Exemplo do arquivo: Validação e testes: o Avaliação do arquivo: São verificados todos os dados dos campos indicados como obrigatórios e realizadas as seguintes validações: Registro Identificador: Campo CNPJ Distribuidor : Validação do CNPJ. Registro Produtos : Campo CNPJ Fabricante : Validação do CNPJ; Campo Código de Barras : Validação EAN13; Campo Tipo de Embalagem : Validação dos tipos válidos ( 0 ou 1 ); Campo Tipo de Código de Barras : Validação dos tipos válidos ( 1, 2 ou 3 ); Campo Status : Validação dos status válidos ( A, I ). o Avaliação de coerência: se aplicado ao arquivo de produtos. o Confirmação/Aceite de conteúdo: A avaliação de conteúdo é de responsabilidade do agente de distribuição e deve considerar o total de produtos informados no arquivo e demais informações destacadas no resumo de avaliação. Os totais apurados devem ser equivalentes aos apurados nos relatórios do agente de distribuição que reportem o total de produtos para o mesmo período reportado o arquivo de produtos. Informações Adicionais Exemplo de Aplicação do Detalhamento do de momento de vendas 23

24 Nesta imagem temos um arquivo que apresenta a disposição dos campos conforme o detalhamento do arquivo de vendas. Em destaque a indicação das posições iniciais de cada campo (números apresentados abaixo dos parênteses com leitura no sentido vertical) contadas sempre a partir da primeira posição de cada registro. Os parênteses ressaltam a aplicação dos tamanhos indicados no detalhamento para cada um dos campos. Em destaque, nas cores verde e vermelha respectivamente, temos os dados de CNPJ do fornecedor e CNPJ do agente de distribuição e processamento das informações envidas. Tabela de Mensagens de Erro Utilizadas no Processo de Validação Mensagem Causa Solução Campo obrigatório, Campo não foi preenchido Consulta a documentação e foi preenchido com com valores considerados identificar os valores válidos um conteúdo válidos para o tipo de dado conforme o tipo de dado e campo inválido e conteúdo esperado para o campo que apresentou o erro CNPJ/CPF inválido O CNPJ ou CPF informado Verificar se o CNPJ/CPF não existe ou está sendo informado é válido e se está informado com a sendo enviado com os tamanhos quantidade de números corretos (14 posições numéricas errada para CNPJ ou 11 posições numéricas para CPF) CEP inválido EAN13 inválido Tipo de ocorrência O CEP informado é inválido ou está fora do formato determinado O código EAN13 informado não é válido por não existir ou por estar com a quantidade de números errada Enviado um valor fora do conjunto de valores especificados como válidos na documentação Verificar a documentação e a base de dados utilizada com base nos valores informados no relatório de validação Verificar se o EAN13 informado é válido e se está sendo enviado com os tamanhos corretos, ou seja, com 13 posições numéricas Consultar a documentação e identificar dentre os valores válidos qual corresponderá ao campo que foi preenchido erroneamente 24

25 Quantidade inválida Data ocorrência inválida Valor Perda/Troca/ Abatimento inválido Vigência inválida Indicativo de visita inválido Código de equipamento para exposição inválido Código do inválido categoria produto Enviado um valor menor ou igual a zero Enviada data inválida ou superiores a data atual Enviado um valor inválido, menor que zero Enviado Ano e/ou Mês de vigência invalido Enviado um valor inválido para o indicativo de visita Enviado um valor que não consta na lista de equipamentos para exposição Enviado um valor que não consta na lista de categoria de produto Enviar valores superiores à zero Enviar uma data válida, menor ou igual a data atual Enviar um valor maior ou igual a zero Enviar uma combinação Ano e Mês válidos Devem ser enviados os valores especificados, S ou N Verificar o valor adequado a partir da lista de equipamentos para exposição constante da documentação Verificar o valor adequado a partir da lista de categoria de produto constante da documentação Exemplos do Resumo de Avalição de s Com Situações de Erros a serem Tratadas pelo Desenvolvedor/Operador Tipo do Vendas Es toque Clientes Força de Vendas Mensagem Total de Ocorrências VENDASDNN Campo obrigatório, foi txt preenchido com um conteúdo inválido ESTOQUEDNN EAN13 inválido txt CLIENTESDNN CNPJ/CPF inválido txt FVENDASDNN txt Produtos PRODUTOSDNN txt Produtos PRODUTOSSDNN txt Campo obrigatório, foi 30 preenchido com um conteúdo inválido Tipo de embalagem inválido 21 Status de produto inválido 11 25

26 Sem Situações de Erros, s Prontos para Avaliação de Conteúdo Tipo do Vendas Es toque Clientes Mensagem Total de Ocorrências VENDASDNN não contem erros txt ESTOQUEDNN não contem erros txt CLIENTESDNN não contem erros txt FVENDASDNN não contem erros txt não contem erros 0 Força de Vendas Produtos PRODUTOSDNN txt Exemplo do Detalhamento de Avaliação de s Com Situações de Erros a serem Tratadas pelo Desenvolvedor/Operador Tipo do Linha Campo Conteú do Mensage m Observação Vendas VENDASDNN txt 404 COD_BA RRAS EAN13 inválido Es toque Clientes ESTOQUEDNN txt CLIENTESDNN txt 2 COD_PR ODUTO 0 Todos os campos OK Todos os conteú dos OK Campo obrigatór io sem erros Corrigir o preenchimen to ou alinhamento da informação dentro do campo Código de proces samen to do arquivo = Data de avaliação 01/07/

27 Força de Vendas FVENDASDNN txt Produtos PRODUTOSDN N txt 0 Todos os campos OK 13 COD_BA RRAS Todos os conteú dos OK sem erros EAN13 inválido Código de proces samen to do arquivo = Data de avaliação 01/07/2016 Sem Situações de Erros, s Prontos para Avaliação de Conteúdo Tipo do Vendas Es toque Clientes Força de Vendas Linha Campo Conteú do VENDASDNN3 0 Todos os Todos campos os 5130.txt OK conteú dos OK ESTOQUEDNN txt CLIENTESDNN txt FVENDASDNN txt 0 Todos os campos OK 0 Todos os campos OK 0 Todos os campos OK Todos os conteú dos OK Todos os conteú dos OK Todos os Mensage m sem erros sem erros sem erros sem erros Observação Código de proces samen to do arquivo = Data de avaliação 01/07/2016 Código de proces samen to do arquivo = Data de avaliação 01/07/2016 Código de proces samen to do arquivo = Data de avaliação 01/07/2016 Código de proces samen to do arquivo 27

28 Produtos PRODUTOSDN N txt 0 Todos os campos OK conteú dos OK Todos os conteú dos OK sem erros = Data de avaliação 01/07/2016 Código de proces samen to do arquivo = Data de avaliação 01/07/2016 Exemplo do Detalhamento de Avaliação de Coerência Com Situações de Erros a serem Tratadas pelo Desenvolvedor/Operador Tipo do Linha Primeira Ocorrência Conteúdo Mensagem Vendas Es toque Força de Vendas VENDASDNN txt ESTOQUEDN N txt FVENDASDN N txt 50 FAB= / DIS= / PDV= sem erros de coerência 100 FAB= / DIS= / PDV= / VEM= VEND001 Esta combinação de dados não existe no arquivo de clientes Código de processamento do arquivo = Data de avaliação 01/07/2016 Esta combinação de dados não existe no arquivo de força de vendas Sem Situações de Erros, s Prontos para Avaliação de Conteúdo Tipo do Linha Primeira Ocorrência Conteúdo Mensagem 28

29 Vendas Es toque Força de Vendas VENDASDNN txt ESTOQUEDN N txt FVENDASDN N txt 50 sem erros de coerência 0 sem erros de coerência 100 sem erros de coerência Código de processamento do arquivo = Data de avaliação 01/07/2016 Código de processamento do arquivo = Data de avaliação 01/07/2016 Código de processamento do arquivo = Data de avaliação 01/07/2016 Exemplo de Avaliação de Conteúdo para Aceite Tipo do Resumo Perda/Troca/ Abatimento Equipamentos Exposição PERDASDNN txt EQUIPEXPDNN txt Período informado: (01/06/2016 a 30/06/2016) Total dias com transação de vendas: 20 dias Total de pontos de venda com transação: 345 Total de produtos com transação: 154 Total de vendas: R$ ,30 Total de Bonificação: R$ Total de Devoluções: R$ 2.450,20 Total de clientes: Objetivos Vendedor por OBJEVENDDNN txt Total de clientes: Total de vendedores distintos: