Documentação: Layout de arquivo exportado Descrição O arquivo deve ser exportado automaticamente com as informações de vendas, trocas, cancelamentos e produtos diariamente, contendo informações redundantes com pelo menos dez dias retroativos. Vendas Devem estar contido nos arquivos os valores de venda de registros fiscais e não fiscais (não fiscais são vendas efetuadas sem emissão de cupom ou nota fiscal). Produtos Devem estar contido nos arquivos os dados de produtos registrados em cada venda. Trocas Caso a loja faça trocas esses valores devem constar nos arquivos para realizarmos os devidos abatimentos. Esses valores podem ser apresentados no arquivo de forma negativa (ex: R$ -1.000,00) ou acrescentar uma coluna no arquivo informando o tipo do registro (Flag) por exemplo T = Troca. Esses valores podem ser omitidos caso o valor da venda informado seja a diferença paga pelo cliente na troca. Cancelamentos Para representar um cancelamento o arquivo pode conter a mesma ID (Código) da venda cancelada com o valor R$ 0,00, nesse caso se a venda já existir no sistema alteramos o valor para R$ 0,00. Os cancelamentos podem ser omitidos se as informações de vendas forem D-1 (ontem), nesse caso a loja enviaria somente as vendas consolidadas e essas não poderiam mais ser canceladas.
Layout Esta documentação apenas apresenta modelos e sugestões do layout do arquivo, não fixamos um layout, portanto fique a vontade para sugerir algum modelo que avaliaremos cada caso individualmente. Vendas Campos (Coluna) Código da Loja/Filial (Opcional) Caso o arquivo gerado incluir mais do que uma loja ou filial é importante acrescentar o código para diferenciar o faturamento de cada unidade. O código da loja pode conter até 30 caracteres alfanuméricos(ex: 001, LOJA1, CNPJ etc) ID da venda A ID é um identificador que utilizamos para controlar as vendas já lidas, pode ser composto pela ID do banco de dados ou número do cupom ou da nota fiscal ou valor customizado. O campo pode conter até 60 caractéres alfanuméricos Exemplos (CX01-0001) ou (001-20160928) Total Valor total da venda, valor decimal separando os centavos com, (vírgula) por exemplo 1200,00 19,99 0,10 Data/Hora Data hora da venda, sugerimos no formato ISO 8601. Forma de Pagamento Formas de pagamento da venda, podem ser separadas por virgula por exemplo; Dinheiro, Cartão de Crédito
Produtos Campos (Coluna) ID do produto A ID é um identificador que utilizamos para controlar os produtos registrados em cada venda, geralmente os produtos possuem um código interno no banco de dados de cada sistema, o código do produto pode ser uma ID do banco de dados, código SKU ou o código EAN13 do produto. O campo pode conter até 30 caractéres alfanuméricos Exemplos (0001) ou (20160928) Descrição Nome do produto registrado na venda Exemplo: Água Mineral 500ML Valor Valor unitário do produto registrado na venda, valor decimal separando os centavos com. (ponto) por exemplo 120.00 19.99 0.10 Quantidade Quantidade do item vendido no cupom Código EAN (Opcional) Código de barras do produto registrado na venda Caso o ID do produto for um código interno opcionalmente o código pode ser informado nesse campo O campo pode conter até 30 caractéres alfanuméricos Nomenclatura do Arquivo O nome do arquivo é indiferente e pode ser formatado da maneira que o desenvolvedor preferir. Formatos válidos Os tipos de arquivos aceitos são; Planilhas (.XLS,.XLSX) Arquivos de texto (.TXT,.CSV,.JSON) XML
Métodos de Envio do Arquivo O arquivo exportado pode ser enviado para um FTP ou email da Napp Solutions ou disponibilizado em um FTP do lojista ou no PC da loja. No caso do arquivo ser gerado em uma pasta no PC da loja (Servidor ou PDV) instalaremos um Client (Aplicativo desenvolvido pela Napp Solutions) para consumir os arquivos e enviar os dados para um servidor. Exemplo layout Download Arquivo de exemplo no formato csv Dúvidas? Guilherme Zenatte guilherme@nappsolutions.com Leandro Vieira leandro@nappsolutions.com Caio Arthur caio@nappsolutions.com