====== Importador de produtos via arquivo .CSV ======
{{:iconesmenu:importprodcsv.png?80|}}
É possível importar os produtos de um outro aplicativo usando um arquivo do tipo .CSV, este arquivo também pode ser construído manualmente através de uma planilha como Excel ou LibreOffice.  Isso facilita muito o cadastro inicial de novos produtos e deve ser o meio preferencial de cadastro de produtos.

Os processos para iniciar a operação do importador são:
  - Clique em **Gere Arquivo para digitação**, isso vai gerar um arquivo .CSV em branco na sua pasta da área de trabalho. Clique no arquivo gerado e abra com sua planilha favorita, note que o separador usado foi _ (Traço sublinhado).
  - Lance uma linha por produto, sendo que cada coluna corresponde a um tipo de informação.
  - Ao final clique no botão **Importar Arquivo** e aponte para o mesmo arquivo editado, se o arquivo .CSV estiver corretamente digitado, o importador vai gerar os cadastros de produtos com todas as grades, estruturações mercadológicas, códigos fiscais e demais parametrizações, simples e rápido.


===== Tipos de parâmetros das colunas =====
No arquivo modelo de CSV gerado, a segunda linha indicará o tipo da coluna para ser preenchida, esta linha não deve ser removida na importação.  Cada coluna tem um tipo que deve ser formatado de acordo, são os seguintes:
  * String - Vazio ou texto **(conteúdos texto porém só com números obrigatoriamente devem começar com //aspas simples//, Ex. RG, CPF, CNPJ, IE, CEP)**
  * Inteiro - Vazio ou um valor inteiro (na planilha o conteúdo tem que estar obrigatoriamente deslocado à direita)
  * Logico - S ou N, 1 ou 0
  * Decimal - Vazio ou um valor decimal (na planilha o conteúdo tem que estar obrigatoriamente deslocado à direita) 
  * Data - Formato DD/MM/AA ou DD/MM/AAAA

Observação: **(O)** significa Obrigatório e será colocado na descrição do tipo da coluna na planilha gerada.

===== Observações =====

  * Em colunas como Marca, Depto, Grupo, etc, deve ser colocado a descrição dos mesmos, pois se o importador perceber que não existe um cadastro de Marca (por exemplo), ele também vai criar um automaticamente.
  * Nas colunas ItensLinhaGrade e ItensColunasGrade **separe os itens usando o símbolo +**
  * Não se esqueça de após editar a planilha, **SALVE normalmente a planilha no formato padrão dela para ter um backup de seu trabalho**, só depois vá na opção SALVAR COMO e force salvar como um arquivo do tipo .CSV.  Sempre inicie a edição usando o arquivo com o formato padrão e não o .CSV, evitando assim perdas de informações.
  * Se um produto já existir na base de dados (coincidindo suas descrições) ele será ignorado no importador.
  * Cada linha ao ser processada gerará um aviso de que ela foi processada ou teve seu processamento ignorado por algum motivo que será dado (Ex. Produto já existente).
  * Se o código interno na planilha estiver em branco, será gerado um automaticamente no Suit.
  * Se o GTIN na planilha estiver em branco, será gerado um automaticamente no Suit.
  * O importador gravará a importação a cada 100 produtos processados. Caso ocorra algum erro na importação, os registros já importados não serão processados novamente de forma automática.
  * Caso a quantidade de dígitos do GTIN a ser importado seja de 12, o importar irá automaticamente calcular o 13o. digito verificador e anexá-lo ao código GTIN. (infoloja ajuste)
  * As seguintes colunas aceitam valores **S ou 1 e N ou 0** : Movimentar Custo, Quantidade Fracionada, Movimentar Estoque.
  * Formato preferencial ao exportar a planilha para .CSV deverá ser UTF-8.
  * Compatível com Telemetria.
  * Todas as rejeições serão registradas no log tag.
  * A coluna Custo de aquisição inicial se refere ao último custo médio calculado do produto
  * A coluna Ultimo custo de aquisição se refere ao último valor presente na entrada do produto
  * O Campo **UNID.TRIB** ou Unidade tributária deve ser preenchido corretamente,  geralmente o valor padrão é UN, mas pode mudar de cliente para cliente e produto.
  * O Campo **CONVRT.UNID.TRIB.** ou Converter para unidade tributária tem o valor padrão *1 se deixado em branco
  * O delimitador padrão pode ser trocado para qualquer um, basta setar o parâmetro 5221, o padrão é '_'. Alterando este parâmetro, altera-se para todos os importadores.
  * Ao rodar o KRATOM use o parâmetro /LC como parâmetro do executável, assim o log de registro da importação sairá mais completo para análise.
  * Quanto à unidade comercial , o importador irá incluir sempre o conteúdo UNIDADE no campo UNIDADECOMERCIAL da tabela de UNIDADE.  __Se existir unidade comercial diferente de UNIDADE, cadastre antes da importação a unidade e sua unidade comercial específica.__
  * **Dica importante:** Antes de começar, analise o arquivo bruto importado buscando se existe o delimitador padrão '_'.  Caso ele exista já no arquivo, troque este delimitador padrão por outro que não exista, Ex. '!'.


==== Dicas para LibreOffice ou outra planilha eletrônica ====
  * Para exportar o arquivo .CSV se atente para o formato a ser usado, sempre UTF8
  * [[guiaformulasimportacaolibre|Guia de fórmulas de importação para o LibreOffice]]