Integração ERP -> estoque.ai

Padrão do arquivo CSV

Requisitos do arquivo:​

• A extensão do arquivo deve ser .csv (separado por ponto e vírgula ;)

• A primeira linha deve conter um cabeçalho com os nomes dos campos.

• As colunas devem respeitar a ordem dos campos definidos no padrão.

• Cada linha de dado representa um e apenas um produto (SKU).

• O arquivo deve ser salvo com codificação UTF-8 e sem BOM(Byte Order Mark).

• O arquivo só pode ser gerado após o fechamento do movimento da loja.

• Preferencialmente o arquivo deve conter apenas os produtos que tiveram venda no dia, tiveram seus preços alterados, mesmo que sem venda ou sofreram alteração no quantitativo de estoque, mesmo que sem venda.

  Todavia, para simplificar a geração do arquivo, pode incluir sempre todos os produtos, mesmo aqueles não foram vendidos e nem sofreram alteração de preço ou estoque.

• Tamanho máximo do arquivo: 5MB

Atenção

Alguns produtos possuem mais de 1 gtin associados ao mesmo codigoProduto. Informe no campo gtin o gtin principal do produto e, se houver mais gtins do mesmo codProduto, informe no campo todosGtins.

Formatos dos campos do arquivo .CSV

Campo	Obrigatório	Formatação	Exemplo
cnpj	Sim	Somente números | Mín e Máx 14 caracteres	99999999000101
dtMovimento	Sim	Formatação: 'YYYY-MM-DD'	2024-01-01
codigoProduto	Sim	Sem formatação	000001
gtin	Sim	Somente números | Mín 8 e Máx 13 caracteres	7894900027013
nomeProduto	Sim	Máx 40 caracteres (Sugestão: utilizar nome gôndola)	COCA COLA ORIGINAL 2L
qtdVendida	Sim	Numérico com 2 casas decimais separados por .	10.00
precoCusto	Não	Numérico com 2 casas decimais separados por .	8.00
precoVenda	Não	Numérico com 2 casas decimais separados por .	0.00
precoPromocao	Não	Numérico com 2 casas decimais separados por .	null
qtdEstoque	Sim	Numérico com 2 casas decimais separados por .	100.00
acertoEstoque	Sim	Numérico com 2 casas decimais separados por .	0.00
reposicaoEstoque	Sim	Numérico com 2 casas decimais separados por .	0.00
classificador1	Não	Máx 40 caracteres	Bebidas
classificador2	Não	Máx 40 caracteres	Refrigerante
classificador3	Não	Máx 40 caracteres	Cola
todosGtins	Não	Campo char sem limite de caracteres	7894900027013/ 78933873/ 7894900011593

Arquivo exemplo: 99999999000101-2024-01-01.csv

cnpj;dtMovimento;codigoProduto;gtin;nomeProduto;qtdVendida;precoCusto;precoVenda;precoPromocao;qtdEstoque;reposicaoEstoque;acertoEstoque;classificador1;classificador2;classificador3;todosGtins
99999999000101;2024-01-01;000001;7894900027013;COCA COLA ORIGINAL 2L;10.00;8.00;0.00;;100.00;0.00;0.00;Bebida;Refrigerante;Cola;7894900027013/78933873/7894900011593

Observação: Qualquer informação opcional cujo valor seja null (nulo) deve ser omitida na linha de dados. Por exemplo, no caso do campo precoPromocao, se o valor for null, ele deve ser representado apenas como ;; (ou seja, vazio entre os pontos e vírgulas), conforme demonstrado no exemplo acima.

Dicionário

Campo	Descrição
cnpj	Número do CNPJ da loja (14 dígitos, sem formatação)
dtMovimento	Data da venda ou ajuste de estoque/preço (YYYY-MM-DD)
codigoProduto	Identificador único do produto
gtin	Código GTIN (EAN) lido pelo PDV (8 ou 13 dígitos)
nomeProduto	Nome do produto como exposto na gôndola (Máx: 40 caracteres)
qtdVendida	Qtd total vendida do produto naquele GTIN nessa data
precoCusto	Preço de custo do produto
precoVenda	Preço de venda
precoPromocao	Preço promocional (se houver)
qtdEstoque	Quantidade em estoque no fechamento do dia
acertoEstoque	Esse campo deve conter além dos acertos de estoque, outros lançamentos, tais como: Avarias, roubo, consumo interno, devoluções, transferências de mercadoria, etc. Esse campo deve ser positivo ou negativo para representar um acerto de entrada ou saída respectivamente.
reposicaoEstoque	Reposição, entrada de compra de produtos registrados no dia
classificador1, 2 e 3	Hierarquias de categorização do produto
todosGtins	Todos os gtins comerciais existentes (8 ou 13 digitos) ligados à variavel codigoProduto separados por /. Exemplo: gtin1/gtin2/.../getinN