Produtos - Importação CSV

A importação CSV permite de forma rápida e simplificado criar um Produto.

Caso não exista previamente no sistema o produto, cor e tamanho equivalente, a própria importação realizará esse cadastro dentro do sistema antes da vinculação com o documento a ser criado.

O comportamento do sistema Valesoft ao receber os dados é de criar os novos registro ou atualizar os mesmo caso já existam, baseando-se nos campos de referências do Produto, Grade do produto, Cor, Tamanho e Local.

Modelo de arquivo CSV

O arquivo CSV deve seguir o modelo abaixo, podendo ainda ser adicionadas quaisquer campos personalizados das tabelas Produto, Grade do produto, Cor, Tamanho e Local.

Exemplo - product.csv

Definições das colunas do CSV:

• reference - OBRIGATÓRIO

  • Alfanumérico
  • Código/SKU Único do produto
  • Chave Primaria - Utilizado para criação ou alteração do registro

• type - OBRIGATÓRIO

  • Texto Predefinido - Maiúsculo
  • Tipo do produto
  • Valores aceitos:
    • RAW - Matéria-prima
    • PRODUCED - Produto acabado
    • CONTAINER - Armazenagem
    • FIXED_ASSET - Ativo Imobilizado

• description - OBRIGATÓRIO

  • Alfanumérico
  • Descrição do produto

• barcode

  • Numérico Inteiro
  • Código de barras EAN-13 ou um sequencial numérico único do produto, utilizado para a criação da etiqueta EPC no padrão GS1-SGTIN

• measureUnit

  • Texto
  • Unidade de medida do produto
    • Ex. M², Un, KG

• productGridReference

  • Alfanumérico
  • Código/SKU Único da grade do produto
  • Chave Primaria - Utilizado para criação ou alteração do registro

• size

  • Alfanumérico
  • Código do tamanho do produto
  • Chave Primaria - Utilizado para criação ou alteração do registro

• averageCost

  • Numérico
  • Custo Médio do produto

• color

  • Alfanumérico
  • Código da cor do produto
  • Chave Primaria - Utilizado para criação ou alteração do registro

• placeReference - OBRIGATÓRIO quando informado o placeName

  • Alfanumérico
  • Código do Local
  • Chave Primaria - Utilizado para criação ou alteração do registro

• placeName

  • Texto -Nome do Local

• placeType - OBRIGATÓRIO quando informado o placeName

  • Texto Predefinido - Maiúsculo
  • Tipo do local
  • Valores aceitos:
    • SITE - Planta/Empresa
    • WAREHOUSE - Depósito
    • SECTOR - Setor/Prateleira
    • CONTAINER - Armazenagem de localização

• campoCustom1 e campoCustom2

  • Quaisquer nomes de campos personalizados desde que os mesmos estejam devidamente configurados nas configurações de campos personalizados do sistema.

Observações

1. O caractere separador de colunas pode ser ponto e vírgula (;), vírgula (,) ou tabulação (\t).

2. Obrigatoriamente a primeira linha do arquivo CSV deve ser os nomes de todos os campos disponíveis. Ex:

"reference";"type";"description";"barcode";"measureUnit";"size";"color";"productGridReference";"placeReference";"placeName";"placeType"

3. Dados de campo opcionais que não são necessário, devem ser deixado em branco.

4. A codificação do arquivo CSV deve ser UTF-8 sem BOM.

5. Campo de texto podem estar entre aspas (").

6. Não deve haver linhas em branco no arquivo CSV.

7. O campo averageCost é do tipo decimal, ou seja a parte decimal é separada por virgula(,), porém ao utilizar o separador de colunas como virgula(,), é necessário substituir o separador decimal por ponto(.)

8. Quando informado o productGridReference a cor e tamanho informados serâo aplicados a grade, caso contrario serão aplicadas ao produto

9. Campos númericos como o averageCost quando não utilizados, devem ser alimentado com o valor null