Este é o manual para troca de dados, EDI, dos distribuidores para Itaueira.
Este manual é VIVO!
Estamos constantemente melhorando-o!
Precisamos de sua ajuda!
Favor nos alertar caso existam dúvidas que não estejam sendo esclarecidas nesse documento.
Explicaremos o passo-a-passo para criação e envio automatizado dos seguintes arquivos:
MOVIMENTAÇÕES
SALDOS DE ESTOQUE
Os arquivos que serão gerados devem conter as informações relacionadas APENAS às movimentações e saldos de produtos da Itaueira.
Quando citamos MOVIMENTAÇÕES nos referimos a TODAS às operações de Entradas, Saídas que normalmente são registradas nos Livros Fiscais de Entradas e Saídas da empresa, suas filiais e empresas coligadas.
EXEMPLO:
Movimentações de Entradas com produtos da Itaueira:
compras, entradas bonificações, entradas de remessas degustação, etc:
da Itaueira para sua empresa, filiais e coligadas;
de outras empresas: distribuidores, atacadistas, etc;
de coligadas do mesmo grupo.
entradas de transferências:
da matriz para filiais da empresa;
de filiais para a matriz da empresa;
de uma filial para outra filial.
Movimentações de Saídas com produtos da Itaueira:
vendas, devoluções, saídas de bonificações, outros tipos de saídas de remessas, etc:
da sua empresa, filiais e coligadas realizadas para Itaueira;
para outras empresas: distribuidores, atacadistas, etc;
para coligadas do mesmo grupo.
saídas de transferências:
da matriz para filiais da empresa;
de filiais para a matriz da empresa;
de uma filial para outra filial.
baixas de estoque por perda e deterioração ou outros tipos de baixas para ajuste de estoque:
normalmente é realizado usando o CNPJ da empresa ou da filial ou coligada onde estava o estoque que está sendo ajustado.
Abaixo apresentamos o fluxograma que explica a originam as informações que devem estar no arquivo de MOVIMENTAÇÕES:
Quando citamos SALDOS DE ESTOQUE nos referimos a TODOS os saldos em estoque que normalmente são registradas nos Livros Fiscais de Registro de Estoque da empresa, suas filiais e empresas coligadas.
ETAPAS
Se sua empresa não possuir uma conta Google Workspace (antigo GSuite), será necessário configurar uma conta @gmail.com (gratuita) corporativa e exclusiva para sincronizar a pasta do Google Drive, Pasta, que será criada e onde estarão os arquivos gerados diariamente;
Entre no google drive (https://drive.google.com) usando a conta que você criou no passo anterior. Compartilhe a Pasta com permissões de "leitura e gravação" com o email: partners.invoices@itaueira.com;
Instale o Google Drive - Backup e sincronização (https://www.google.com/drive/download/) na máquina que possui a Pasta onde estarão os arquivos que serão enviados diariamente para ITAUEIRA;
Configure o aplicativo "Google Drive - Backup e sincronização" para sincronização da Pasta onde estarão os arquivos;
IMPORTANTE: Se você fizer o que foi informado nas etapas anteriores, não será necessário qualquer intervenção humana para a transmissão dos dados. Assim, o processo de geração dos arquivos se dará de forma AUTOMÁTICA, garantindo a qualidade dos dados e o sincronismo das informações sem necessidade de intervenção de qualquer pessoa.
ATENÇÃO - QUANDO NÃO FOR POSSÍVEL GERAR UM ÚNICO ARQUIVO COM DADOS DAS EMPRESAS, FILIAIS E COLIGADAS
No caso de não ser possível gerar um único arquivo com os dados de todas as empresas, filiais e coligadas devido a alguma restrição de processamento ou também relacionada a existência de sistemas independentes na empresa que geram arquivos de filiais diferentes, mas com o mesmo nome, e para evitar que esses arquivos sejam sobrescritos, devem ser criadas diferentes pastas com cada uma abrigando o seu arquivo respectivo. Veja a ilustração abaixo:
Pasta da empresa com duas subpastas para receber o arquivo configurado
Pasta da Filial 1 com o arquivo configurado e com o mesmo nome do arquivo da Filial 2. Cada arquivo de filial fica na sua pasta.
Todos os arquivos serão gerados no formato CSV (comma separated values) - arquivos separados por vírgulas.
LEMBRETE: Os arquivos deverão conter, necessariamente, todas as movimentações e saldos que envolvam produtos da Itaueira, mesmo que não tenham sido adquiridos diretamente da Itaueira. Ou seja, todas as movimentações de entrada e saída (compras, bonificações, transferências, remessas, baixas perdas, vendas), TUDO que inclua produtos da ITAUEIRA, obrigatoriamente, deverão ter suas operações incluídas nos arquivos.
Formato CSV = Campos Separados por Vírgula
Cada arquivo deve, obrigatoriamente, em sua primeira linha o cabeçalho, com o nome de todos os campos.
Cada linha dos arquivos gerados (*.csv) deverá representar um produto e:
sua MOVIMENTAÇÃO (compra, venda, transferência, bonificação, remessa, etc) ou;
seu SALDO, no caso do arquivo de SALDOS.
TIPOS DE CAMPOS
Para o envio dos arquivos, os campos a serem configurados devem ser de dois TIPOS:
CAMPOS DO TIPO STRING: Esse é um campo de formato texto. São campos que qualificam uma determinada informação. Exemplo: Melão Rei. Esses campos se referem a O QUE está sendo informado.
ALERTA: Em alguns casos, se esse campo possuir caracteres de quebra de linha, vírgula ou aspas duplas dentro, deverá estar todo entre aspas duplas, sendo que caso exista aspas duplas no texto, as aspas duplas devem estar duplicadas.
CAMPOS DO TIPO FLOAT: Esse é um campo do tipo numérico. Ele representa uma quantidade. É um campo do tipo quantitativo. O formato numérico que deverá ser utilizado na elaboração do arquivo para a transmissão não deverá ter separador de milhar e deverá conter o “.” (ponto) como separador decimal.
EXEMPLO: O número onze mil e quinhentos deve ser expresso da seguinte forma: 11500.00 Observe que o ponto separa a casa decimal.
NOMENCLATURA DO ARQUIVO
Deverá ser utilizado o seguinte padrão: MOVIMENTACOES_yyyymmdd_yyyymmdd_yyyymmdd.csv
O formato yyyymmdd representa uma data, onde a letra “y” representa o ano (year), a letra ‘m” representa o mês (month) e a letra “d” representa o dia (day).
A primeira data na estruturação representa o dia da geração do arquivo.
A segunda data representa a data de início do período a que o arquivo se refere.
A terceira data representa a data final do período a qual se refere o arquivo.
ALERTA: Lembrar de incluir o símbolo de sublinhado “_” na formação do nome do arquivo
CARGA INICIAL
Após testada e aprovada a geração do arquivo de MOVIMENTAÇÕES pela equipe da Itaueira, será gerada a Carga Inicial.
A Carga Inicial deste arquivo deverá conter todas as movimentações que envolvam produtos da Itaueira desde o início da relação comercial com sua empresa.
ALERTA: Essa Carga Inicial é fundamental para a construção do histórico comercial entre as duas partes.
CARGA DIÁRIA
Após a geração e aprovação da Carga Inicial pela equipe da Itaueira, deverá, diariamente, ser gerada a Carga Diária, onde estarão incluídos os últimos sete dias de movimentações das operações que envolvam produtos da Itaueira.
ALERTA: Sempre a Carga Diária deverá incluir os últimos SETE dias. Essa medida é necessária para garantir a qualidade dos dados existentes nos arquivos, caso algum ajuste seja realizado nos dias anteriores.
CAMPOS A SEREM INCLUÍDOS NO ARQUIVO “MOVIMENTAÇÕES”
Para uma melhor compreensão dividimos o arquivo em 4 grupos de campos:
Identificação do LOCAL onde está sendo realizada/registrada a movimentação de entrada ou saída. É a matriz, filial ou coligada de sua empresa:
emissão
lcnpj
lcodigo
lnome
llocalidade
luf
lmatriz
Identificação da PESSOA com quem a empresa está se relacionando. É o fornecedor, cliente, filial, matriz, coligada de onde está vindo os produtos que estão entrando ou para onde está indo os produtos que estão saindo:
pcnpj
pcodigo
pnome
pclassificacao
plocalidade
puf
pmatriz
Identificação da OPERAÇÃO que está sendo realizada:
cfop
chaveacessonfe
numeronfe
Identificação do RECURSO (PRODUTO) e detalhes do que está ocorrendo:
quantidade
total
totalfinanceiro
rcodigo
MOVIMENTAÇÕES ENTRE MATRIZ, FILIAIS E COLIGADAS
Todos as transferências possuirão duas movimentações no arquivo:
movimentação de SAÍDA da matriz ou filial:
o LOCAL é de onde está saindo o produto, onde está sendo registrada a movimentação e diminuindo o estoque;
a PESSOA é a filial ou matriz para onde está indo o produto.
movimentação de ENTRADA na filial ou matriz
o LOCAL é onde está entrando o produto, onde está sendo registrada a movimentação e aumentando o estoque;
a PESSOA é a filial ou matriz de onde está vindo o produto.
Operações envolvendo coligadas também possuirão duas movimentações semelhante as transferências. A diferencia é que ocorre uma SAÍDA de VENDA e uma ENTRADA de COMPRA.
Segue o modelo do arquivo .CSV com o cabeçalho dos campos e na ordem necessária (para download clique aqui):
EMISSAO,CFOP,QUANTIDADE,TOTAL,TOTALFINANCEIRO,LCNPJ,LCODIGO,LNOME,LLOCALIDADE,LUF,LMATRIZ,PCNPJ,PCODIGO,PNOME,PCLASSIFICACAO,PLOCALIDADE,PUF,PMATRIZ,RCODIGO,CHAVEACESSONFE,NUMERONFE
2021-07-20,5102,2500,9613.07,6536.89,01001023000101,CD-001,SOL DO CEARA COM DE FRUTAS LTDA,FORTALEZA,CE,01001023000101,02002202000102,SUPERMERCADO SETE FILHOS,COM E REVENDA SETE FILHOS LTDA,ATS5-9CXA,FORTALEZA,CE,02002202000102,MLAAMRREI,23210701001023000101550010000706751220918072,000000001
2021-07-20,5102,2000,6785.70,4614.28,01001023000101,CD-001,SOL DO CEARA COM DE FRUTAS LTDA,FORTALEZA,CE,01001023000101,02002202000102,SUPERMERCADO SETE FILHOS,COM E REVENDA SETE FILHOS LTDA,ATS5-9CXA,FORTALEZA,CE,02002202000102,MLAAMRCPI,23210701001023000101550010000706751220918072,000000001
2021-07-20,5102,2860,4976.18,3383.80,01001023000101,CD-001,SOL DO CEARA COM DE FRUTAS LTDA,FORTALEZA,CE,01001023000101,02002202000102,SUPERMERCADO SETE FILHOS,COM E REVENDA SETE FILHOS LTDA,ATS5-9CXA,FORTALEZA,CE,02002202000102,MLAAMRGAI,23210701001023000101550010000706751220918072,000000001
Figura 1
Usaremos esse exemplo para ajudar a explicar como deve ser preenchido alguns dos campos do arquivo de MOVIMENTAÇÕES
SEQUENCIA 1 NOME DO CAMPO emissao TIPO string
Refere-se a data da movimentão no formato yyyy-mm-dd, onde a letra "y" representa o ano (year), a letra "m" representa o mês (month) e a letra "d" representa o dia. As datas devem ser informadas em ordem CRESCENTE.
ALERTA: apesar do nome ser "emissao" não use a data de emissão da nota. A data deve ser a DATA DA ENTRADA ou a DATA DA SAÍDA da movimentão na sua empresa. É o conceito usado para registrar as operações de entradas, nos registros de entrada da empresa, ou as saídas, nos registros de saídas da empresa.
Se for uma movimentão de ENTRADA:
não usar a Data de Emissão da nota/danfe
não usar a Data de Entrada/Saída que vem informada na nota/danf
USAR a data que a mercadoria deu entrada no seu estoque, em sua empresa, filial ou coligada. É o conceito usado pela área fiscal e contábil da sua empresa.
Se for uma movimentação de SAÍDA:
não usar a Data de Emissão da nota/danfe
USAR a data de que a mercadoria deu saída no seu estoque, de sua empresa, filial ou coligada. É normalmente a Data de Entra/Saída que é informada na nota/danfe. É o conceito usado pela área fiscal e contábil da sua empresa.
SEQUENCIA 2 NOME DO CAMPO cfop TIPO string
Deve ser informado o Código Fiscal da Operação - CFOP da movimentação que está sendo realizada.
Este campo está presente em cada produto existente na nota/danfe e informa a natureza da operação, se é: Compra, Venda, Bonificação, Transferência, Doação, Remessa, etc.
Dúvidas ver: https://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx
SEQUENCIA 3 NOME DO CAMPO quantidade TIPO float
Informar a quantidade movimentada de produtos na unidade quilograma - kg.
ALERTA: Todas as movimentações de todos os produtos deverão estar sempre no padrão quilograma kg. Se a nota/danfe estiver em outra unidade de medida que não kg, deverá ser providenciada a sua conversão para kg.
EXEMPLOS utilizando a FIGURA 1:
Melão Amarelo REI - caixa com 10kg: deve ser convertido para 250*10 = utilizar 2500.00 kg
Melão Amarelo GAIA - caixa com 13kg: deve ser convertido para 220*13 = utilizar 2860.00 kg
SEQUENCIA 4 NOME DO CAMPO total TIPO float
Muita atenção neste campo!
A informação a ser registrada representa um produto por linha do arquivo e precisamos saber o valor "total" correto de cada produto.
Eventualmente, algumas notas/danfes possuem valores "destacados" que não estão inclusos no "Valor Total dos Produtos" mas influenciam no "Valor Total da Nota". No entanto, estes valores "destacados" influenciam no valor de cada produto e, por este motivo, é necessário fazer o rateio dos valores existentes nesses campos - apropriando-os corretamente no valor de cada produto.
Usaremos a FIGURA 1 para construir nosso exemplo e explicação de como encontrar o valor correto do campo "total" para cada produto da Itaueira. Observe que a nota/dande NFe 000.001 movimentou vários produtos. Apenas alguns são da Itaueira.
Segue o passo a passo para encontrar o "total" de cada produto da Itaueira:
Pegar o "Valor Total da Nota": R$ 29.178,50, já considerando os valores destacados:
Valor do Frete = R$1.500,00
Valor do Seguro = R$78,50
Desconto = R$0,00
Outras Despesas Acessórias = R$1.800,00
Pegar o "Valor Total dos Produtos": R$25.800,00, já incluso, quando existir, o desconto individual de cada produto.
IMPORTANTE: Se houver o IPI Destacado em algum produto ele deverá ser somado ao "Valor Total do Produto" e compor o "Valor Total dos Produtos" para que o rateio seja feito corretamente.
Para cada produto:
pegar o seu "Valor Total do Produto" (as vezes chamado de valor liquido)
já deve estar incluso, quando existir, o desconto do produto.
já deve estar incluso, quando existir, o IPI Destacado do produto.
fazer uma regra de 3, dividindo o "Valor Total do Produto" pelo "Valor Total dos Produtos" e multiplicando pelo "Valor Total da Nota"
Valores do campo "total" para os produtos da Itaueira na nota/danfe NFe 000.001:
Melão Amarelo REI - caixa com 10kg total = usar 9613.07
Melão Amarelo CEPI - caixa com 10kg total = usar 6785.70
Melão Amarelo GAIA - caixa com 13kg total = usar 4976.18
SEQUENCIA 5 NOME DO CAMPO totalfinanceiro TIPO float
Muita atenção neste campo!
Na grande maioria das vezes ele será igual ao campo "total".
Se não houver Desconto Financeiro na movimentação, repita o valor do campo "total" aqui no campo "totalfinanceiro".
CASO EXISTA DESCONTO FINANCEIRO:
É comum alguns varejistas trabalharem com Desconto Financeiro. Ou seja, em algumas movimentações, no "Valor Total da Nota", existe um acréscimo de percentual que será "descontado" no ato do pagamento dos títulos. Esse informação não aparece na nota/danfe mas, normalmente está vinculada de alguma forma ao registro da movimentação permitindo que façamos a apuração real do que será pago pelo cliente.
Por esse motivo, em movimentações de vendas onde existam essa situação, precisaremos calcular o campo "totalfinanceiro" retirando do campo "total" o Desconto Financeiro proporcional.
ATENÇÃO: Não confundir os diversos tipos de desconto que existem:
Desconto Financeiro: desconto existem apenas nos títulos no ato do pagamento pelo cliente;
Desconto no total da nota: é destacado na nota/danfe, no grupo de informações "Calculo do Imposto", e influencia no Valor Total da Nota;
Desconto no produto: está diretamente ligado a movimentação de cada produto individualmente, e influencia no Valor Total do Produto.
CÁLCULO:
Valor Total dos Títulos - Desconto Financeiro:
R$10.560,00 - R$3.379,20 = R$7.180,80
Fazer um regra de 3: 484,00/10.560*7.180,80 = R$329,12
Assim, o valor a ser indicado no campo "totalfinanceiro" é R$329,12
Usaremos a FIGURA 1 para construir nosso exemplo e explicação de como encontrar o valor correto do campo "totalfinanceiro" para cada produto da Itaueira. Observe que a nota/dande NFe 000.001 movimentou vários produtos. Apenas alguns são da Itaueira.
Imaginemos que, neste caso, o varejista trabalha com Desconto Financeiro de 32%:
Segue o passo a passo para encontrar o "totalfinanceiro" de cada produto da Itaueira:
Pegar o "Valor Total da Nota": R$ 29.178,50, já considerando os valores destacados da nota;
Pegar o "Valor Total dos Títulos": R$ 29.178,50:
some todos os títulos juntos;
Pegar o "Desconto Financeiro": R$ 9.337,12:
normalmente essa informação está disponível nos títulos na forma de um valor financeiro ou percentual do desconto;
some todos os descontos existentes nos títulos.
Calcular o "Fator % do Desconto Financeiro":
se o percentual (%) não estiver disponível, calcule-o:
divida o "Desconto Financeiro" pelo "Valor Total dos Títulos" = 0,32
subtraia de 1 o valor encontrado acima = 1 - 0,32
o nosso "Fator % de Desconto Financeiro" é = 0,68
Para cada produto:
pegar o seu "total" - que foi calculado acima e multiplicar pelo "Fator % de Desconto Financeiro"
Valores do campo "totalfinanceiro" para os produtos da Itaueira na nota/danfe NFe 000.001:
Melão Amarelo REI - caixa com 10kg total = 9613.07 * 0.68 = usar 6536.89
Melão Amarelo CEPI - caixa com 10kg total = 6785.70 * 0.68 = usar 4614.28
Melão Amarelo GAIA - caixa com 13kg total = 4976.18 * 0.68 = usar 3383.80
SEQUENCIA 6 NOME DO CAMPO lcnpj TIPO string
Informar o CNPJ do LOCAL: matriz, filial ou coligada, onde a movimentação está sendo registrada. Também denominado domicílio fiscal.
SEQUENCIA 7 NOME DO CAMPO lcodigo TIPO string
Informar o nome de fantasia do LOCAL: a matriz, filial ou coligada onde a movimentação está sendo registrada.
Pode ser usado o “apelido” ou código numérico com o qual ele é tratado pela sua empresa.
EXEMPLOS: “Sacolão Litoral”, “Filial 0504” ou “0504-Litoral”
SEQUENCIA 8 NOME DO CAMPO lnome TIPO string
Informe a razão social do LOCAL: matriz, filial ou coligada onde a movimentação está sendo registrada.
Pode ser composto por caracteres alfabéticos ou caracteres alfanuméricos.
É o nome em que a sua empresa encontra-se registrada no CNPJ.
EXEMPLOS: “Litoral Distribuidora de Frutas Ltda”
SEQUENCIA 9 NOME DO CAMPO llocalidade TIPO string
Informe o nome do município do LOCAL: matriz, filial ou coligada onde a movimentação está sendo registrada.
Deve ser o mesmo existente no cadastro do CNPJ.
EXEMPLO: “São Paulo”
SEQUENCIA 10 NOME DO CAMPO luf TIPO string
Informe o estado (UF) do LOCAL: matriz, filial ou coligada onde a movimentação está sendo registrada.
Informe usando dois caracteres alfabéticos, em letras maiúsculas, representando a Unidade da Federação.
Deve ser o mesmo existente no cadastro do CNPJ.
EXEMPLO: “SP”
SEQUENCIA 11 NOME DO CAMPO lmatriz TIPO string
Informar o CNPJ do LOCAL: matriz, filial ou coligada que é considerada a "matriz" do grupo econômico da sua empresa.
Pode ser igual ao campo "lcnpj", caso não possua filiais ou coligadas.
Se sua empresa possuir mais de um CNPJ (matriz e filiais) ou empresas (coligadas) com outros CNPJ e que se relacionam, deve informar qual delas é considerada a principal.
SEQUENCIA 12 NOME DO CAMPO pcnpj TIPO string
Informe o CNPJ da PESSOA com quem sua empresa está realizando a movimentação de entrada ou saída.
Quando você realiza transferência entre matriz e filiais, deve informar aqui os dados da matriz ou filial de onde está vindo ou para onde está indo os produtos das movimentações.
SEQUENCIA 13 NOME DO CAMPO pcodigo TIPO string
Informe o nome de fantasia da PESSOA com quem sua empresa está realizando a movimentação.
Pode ser usado o “apelido” ou código numérico com o qual ele é tratado pela sua empresa.
EXEMPLO: “Mercadinho Zona da Mata”
Quando você realiza transferência entre matriz e filiais, deve informar aqui os dados da matriz ou filial de onde está vindo ou para onde está indo os produtos das movimentações.
EXEMPLOS: “Filial 01”, “Filial Sta Catarina”, "CD Cajamar", "Filial Ceagesp"
SEQUENCIA 14 NOME DO CAMPO pnome TIPO string
Informe aqui a razão social da PESSOA com quem sua empresa está realizando a movimentação.
EXEMPLO: “Zona da Mata Distribuidora de Frutas LTDA”.
Quando você realiza transferência entre matriz e filiais, deve informar aqui os dados da matriz ou filial de onde está vindo ou para onde está indo os produtos das movimentações.
SEQUENCIA 15 NOME DO CAMPO pclassificacao TIPO string
Este campo deve ser usado quando a PESSOA com quem sua empresa está realizando a movimentação for um varejista.
Crie uma tabela “DE x PARA” com o objetivo de registrar os códigos de classificação do ramo de atividade dos varejistas com os códigos de classificação dos PDVs da Itaueira:
pclassificacao Descrição
ATS50+CXA Autoserviço 50+ checkouts
ATS10+CXA Autoserviço 10+ checkouts
ATS5-9CXA Autoserviço 5 a 9 checkouts
ATS1-4CXA Autoserviço 1 a 4 checkouts
PDR Padarias
ATC Atacados
ATK Atakarejos
SEQUENCIA 16 NOME DO CAMPO plocalidade TIPO string
Informe o nome do município onde está localizada a PESSOA com quem sua empresa está realizando a movimentação.
Deve ser o mesmo existente no cadastro do CNPJ da PESSOA.
EXEMPLO: “São Paulo”
SEQUENCIA 17 NOME DO CAMPO puf TIPO string
Informe o estado (UF) onde está localizada a PESSOA com quem sua empresa está realizando a movimentação.
Informe usando dois caracteres alfabéticos, em letras maiúsculas, representando a Unidade da Federação.
Deve ser o mesmo existente no cadastro do CNPJ da PESSOA.
EXEMPLO: “SP”
SEQUENCIA 18 NOME DO CAMPO pmatriz TIPO string
Informar o CNPJ da PESSOA: matriz, filial ou coligada que é considerada a "matriz" do grupo econômico da PESSOA com quem sua empresa está realizando a movimentação.
Pode ser igual ao campo "pcnpj", caso a PESSOA não possua filiais ou coligadas.
Se a PESSOA possuir mais de um CNPJ (matriz e filiais) ou empresas (coligadas) com outros CNPJ e que se relacionam, deve informar qual delas é considerada a principal.
SEQUENCIA 19 NOME DO CAMPO rcodigo TIPO string
Crie uma tabela “DE x PARA” com o objetivo de registrar os códigos de produtos da Itaueira, usando a tabela abaixo:
ALERTA:
rcodigos destacados com a cor laranja: só devem ser usados caso você não tenha separado as informações das marcas indicadas;
rcodigo Descrição
MELREI275 Mel Rei Bisnaga 275g
MELREI500 Mel Rei Pote 500g
MLAAMRCGA Melão Amarelo CEPI + GAIA
MLAAMRCPI Melão Amarelo CEPI
MLAAMRGAI Melão Amarelo GAIA
MLAAMRREI Melão Amarelo REI
MLACNTCGA Melão Cantaloupe CEPI + GAIA
MLACNTCPI Melão Cantaloupe CEPI
MLACNTREI Melão Cantaloupe REI
MLAGLACGA Melão Gália CEPI + GAIA
MLAGLACPI Melão Gália CEPI
MLAGLAREI Melão Gália REI
MLAMTSCEP Melão Matisse CEPI
MLAMTSREI Melão Matisse REI
MLAPDSCGA Melão Pele de Sapo CEPI + GAIA
MLAPDSCPI Melão Pele de Sapo CEPI
MLAPDSGAI Melão Pele de Sapo GAIA
MLAPDSREI Melão Pele de Sapo REI
MLNCPI Mini Melancia sem Semente CEPI
MLNSMTCPI Melancia com Semente CEPI
MLNTDM Mini Melancia sem Semente Turma da Monica
MLNTMC Mini Melancia sem Semente Turma da Monica + CEPI
PMNAMRREI Pimentão Block Amarelo
PMNDUOREI Pimentão Duo
PMNLNGREI Pimentão Longo
PMNLRJREI Pimentão Block Laranja
PMNVRMREI Pimentão Block Vermelho
UVACRMCEP Uva Crimson Cepi
UVACRMREI Uva Crimson Rei
UVAVTRREI Uva Vitória Rei
UVAVTRCEP Uva Vitória Cepi
DICA !
Para ajudar na construção da tabela de "DE x PARA", disponibilizamos uma consulta (imagem ao lado) que você poderá exportar, sempre que desejar, para obter a relação entre:
códigos de produtos no ERP da Itaueira que são usados em notas fiscais e XMLs
gtin14 de produtos da Itaueira que estão nos XMLs
rcodigo que deve ser usado para construção do "DE x PARA".
Clique aqui ou na figura ao lado para ter acesso a consulta.
ATENÇÃO: clique nos três pontinhos para poder exportar para uma planilha.
SEQUENCIA 20 NOME DO CAMPO chaveacessonfe TIPO string
Informe a chave de acesso existente no documento fiscal da movimentação - nota/danfe, quando disponível.
ATENÇÃO: Essa informação é muito importante! Permitirá o acesso aos dados para conferência, quando necessário.
SEQUENCIA 21 NOME DO CAMPO numeronfe TIPO string
Informe o número do documento fiscal da movimentação - número da NFe
NOMENCLATURA DO ARQUIVO
Deverá ser utilizado o seguinte padrão: SALDOS_yyyymmdd_yyyymmdd_yyyymmdd.csv
O formato yyyymmdd representa uma data, onde a letra “y” representa o ano (year), a letra ‘m” representa o mês (month) e a letra “d” representa o dia (day).
A primeira data na estruturação representa o dia da geração do arquivo.
A segunda data representa a data de início do período a que o arquivo se refere.
A terceira data representa a data final do período a qual se refere o arquivo.
ALERTA: Lembrar de incluir o símbolo de sublinhado “_” na formação do nome do arquivo
CARGA INICIAL
Após testada e aprovada a geração do arquivo de SALDOS pela equipe da Itaueira, será gerada a Carga Inicial.
A Carga Inicial deste arquivo deverá conter o registro dos SALDOS de fechamento de estoque, dia a dia, que envolvam produtos da Itaueira desde o início da relação comercial com sua empresa: matriz, filiais e coligadas.
ALERTA: Essa Carga Inicial é fundamental para a construção do histórico comercial entre as duas partes.
CARGA DIÁRIA
Após a geração e aprovação da Carga Inicial pela equipe da Itaueira, deverá, diariamente, ser gerada a Carga Diária, onde estarão incluídos os últimos sete dias de saldos diários de ESTOQUE, sempre do final de cada dia, que envolvam produtos da Itaueira na: matriz, filiais e coligadas.
ALERTA: Sempre a Carga Diária deverá incluir os últimos SETE dias. Essa medida é necessária para garantir a qualidade dos dados existentes nos arquivos, caso algum ajuste seja realizado nos dias anteriores.
CAMPOS A SEREM INCLUÍDOS NO ARQUIVO “SALDOS”
Para uma melhor compreensão dividimos o arquivo em 2 grupos de campos:
Identificação do LOCAL onde está o estoque. É a matriz, filial ou coligada de sua empresa:
data
lcnpj
lcodigo
lnome
llocalidade
luf
lmatriz
Identificação do RECURSO (PRODUTO) e detalhes do que está ocorrendo:
quantidade
rcodigo
Segue o modelo do arquivo .CSV com o cobeçalho dos campos e na ordem necessária (para download clique aqui):
DATA,QUANTIDADE,LCNPJ,LCODIGO,LNOME,LLOCALIDADE,LUF,LMATRIZ,RCODIGO
2021-08-24,10.00,01234567890123,0101,CD-PR,CURITIBA,PR,01234567890123,MLAAMRCPI
2021-08-24,100.00,12345678901234,0102,CD-MS,TERENOS,MS,12345678901234,MLAAMRCPI
2021-08-24,2520.00,01234567890123,0101,CD-PR,CURITIBA,PR,01234567890123,MLAAMRCPI
2021-08-24,5.00,23456789012345,0104,CD-AM,MANAUS,AM,23456789012345,MLAAMRCPI
SEQUENCIA 1 NOME DO CAMPO data TIPO string
Refere-se a data do saldo do estoque, sempre no final do dia, no formato yyyymmdd, onde a letra "y" representa o ano (year), a letra "m" representa o mês (month) e a letra "d" representa o dia.
SEQUENCIA 2 NOME DO CAMPO quantidade TIPO float
Informar o saldo do produto no final do dia na unidade de medida quilograma - kg.
ALERTA: Todos os saldos, de todos os produtos, deverão estar sempre no padrão quilograma kg. Se o estoque estiver em outra unidade de medida que não kg, deverá ser providenciada a sua conversão para kg.
EXEMPLOS:
Melão Amarelo REI - caixa com 10kg: se existir 250 caixas em estoque, converter para 250*10 = utilizar 2500.00 kg
Melão Amarelo GAIA - caixa com 13kg: se existir 220 caixas em estoque, converter para 220*13 = utilizar 2860.00 kg
SEQUENCIA 3 NOME DO CAMPO lcnpj TIPO string
Informar o CNPJ do LOCAL: matriz, filial ou coligada, onde existe o saldo que está sendo registrado. Também denominado domicílio fiscal.
SEQUENCIA 4 NOME DO CAMPO lcodigo TIPO string
Informar o nome de fantasia do LOCAL: a matriz, filial ou coligada onde existe o saldo que está sendo registrado.
Pode ser usado o “apelido” ou código numérico com o qual ele é tratado pela sua empresa.
EXEMPLOS: “Sacolão Litoral”, “Filial 0504” ou “0504-Litoral”
SEQUENCIA 5 NOME DO CAMPO lnome TIPO string
Informe a razão social do LOCAL: matriz, filial ou coligada onde existe o saldo que está sendo registrado.
Pode ser composto por caracteres alfabéticos ou caracteres alfanuméricos.
É o nome em que a sua empresa encontra-se registrada no CNPJ.
EXEMPLOS: “Litoral Distribuidora de Frutas Ltda”
SEQUENCIA 6 NOME DO CAMPO llocalidade TIPO string
Informe o nome do município do LOCAL: matriz, filial ou coligada onde existe o saldo que está sendo registrado.
Deve ser o mesmo existente no cadastro do CNPJ.
EXEMPLO: “São Paulo”
SEQUENCIA 7 NOME DO CAMPO luf TIPO string
Informe o estado (UF) do LOCAL: matriz, filial ou coligada onde existe o saldo que está sendo registrado.
Informe usando dois caracteres alfabéticos, em letras maiúsculas, representando a Unidade da Federação.
Deve ser o mesmo existente no cadastro do CNPJ.
EXEMPLO: “SP”
SEQUENCIA 8 NOME DO CAMPO lmatriz TIPO string
Informar o CNPJ do LOCAL: matriz, filial ou coligada que é considerada a "matriz" do grupo econômico da sua empresa.
Pode ser igual ao campo "lcnpj", caso não possua filiais ou coligadas.
Se sua empresa possuir mais de um CNPJ (matriz e filiais) ou empresas (coligadas) com outros CNPJ e que se relacionam, deve informar qual delas é considerada a principal.
SEQUENCIA 9 NOME DO CAMPO rcodigo TIPO string
Crie uma tabela “DE x PARA” com o objetivo de registrar os códigos de produtos da Itaueira, usando a tabela já definida acima, no item:
SEQUENCIA 19 NOME DO CAMPO rcodigo TIPO string
No arquivo abaixo apresentamos um exemplo de como realizar o upload para o Google Drive utilizando ferramentas gratuitas e APIs do Google.
https://docs.google.com/document/d/1lyFUjpfdaC4hpnwQPfKT2QC-IoASoa4IoeNnXe6GdYY