Docs Produtos - CSV
Como Funciona?
Neste modelo é instalado no ambiente do lojista nosso aplicativo integrador padrão chamado SMI que terá como finalidade se conectar a base de produtos da loja e enviar periodicamente as atualizações de preço, estoque, dentre outras detalhadas neste documento.
Configuração do integrador e validação dos itens
Para iniciar o desenvolvimento, é necessario que tenha realizado a etapa de cadastro inicial para receber as credenciais necessárias. Após realizado o cadastro é possivel enviar os produtos utilizando nosso integrador e valida-los na plataforma.
Template do arquivo
Abaixo temos a tabela contendo todo os campos e suas devidas especificações para que você possa integrar de forma completa (utilize-a para montar seu arquivo CSV para que o SMI tenha todas as informações necessárias para integração).
| Campo | Formato | Tamanho | Obrigatório | Exemplo |
|---|---|---|---|---|
| id_loja | ALFANUMÉRICO | 25 | Sim | 15 |
| departamento | ALFANUMÉRICO | 100 | Sim | Bebidas |
| categoria | ALFANUMÉRICO | 100 | Sim | Leite |
| subcategoria | ALFANUMÉRICO | 100 | Não | Leite Integral |
| marca | ALFANUMÉRICO | 100 | Não | Parmalat |
| unidade | ALFANUMÉRICO | 100 | Não | UN (Unidade) / KG (Quilo) / G (Grama) |
| volume | ALFANUMÉRICO | 100 | Não | 1UN |
| codigo_barra | NUMÉRICO | 15 | Sim | 7891231231231 (Modelo EAN) / 123 (Modelo Próprio) |
| nome | ALFANUMÉRICO | 150 | Sim | Leite integral 1 LT |
| dt_cadastro | DATA | Sim | 01/01/2020 | |
| dt_ultima_alteracao | DATA | Não | 14/02/2020 | |
| vlr_produto | NUMÉRICO | 12.2 | Sim | 4.99 |
| vlr_promocao | NUMÉRICO | 12.2 | Não | 3.20 |
| qtd_estoque_atual | NUMÉRICO | 12.2 | Sim | 10 |
| qtd_estoque_minimo | NUMÉRICO | 12.2 | Não | 3 |
| descricao | ALFANUMÉRICO | 150 | Não | Leite Integral Parmalat 1LT C/ Tampa Abre Facil |
| ativo | ALFANUMÉRICO | 1 | Sim | S (Ativo) / N (Inativo) |
| plu | ALFANUMÉRICO | 15 | Sim | 120 |
| vlr_compra | NUMÉRICO | 12.2 | Não | 1.70 |
| validade_proxima | ALFANUMÉRICO | 1 | Não | S (Sim) / N (Não) |
| vlr_atacado | NUMÉRICO | 12.2 | Não | 3.00 |
| qtd_atacado | NUMÉRICO | 12.2 | Não | 50 |
| image_url | ALFANUMÉRICO | 150 | Não | http://URL/1.png |
Sobre o arquivo
O Arquivo CSV deve conter todas as colunas do template acima, com os nomes exatos e na sequência indicada.
Qualquer divergência ao formato impedirá a importação dos dados referentes aos produtos.
Boas praticas nos envios dos produtos
Integração do estoque e preço
Durante as atualizações é essencial que sejam enviadas as posições de estoque 0 e/ou negativo sempre que necessário, assim evitando rupturas e cancelamentos de pedidos. Porque isto é importante:
Estoque 0 - Nas plataformas já temos funcionalidades para tratar esta posição de estoque, quando o item é enviado com estoque 0, o mesmo sai automaticamente de venda. Por este motivo é importante que esta informação seja enviada sempre.
Estoque negativo - Armazenamos as movimentações dos itens mesmo que negativamente, pois a partir dela podemos validar se o item em loja esta sendo movimentado, mesmo que seu valor não tenha sido alterado para um valor positivo ele pode estar sendo alterado negativamente como -1,-2,-3 e assim por diante.
Valor promocional - Para que seja representado no aplicativo o valor promocional "DE - POR" é necessário o envio dos dois valores nos campos "vlr_produto" e "vlr_promocao" para ser aplicado a rebaixa no preço. Lembrando que o valor de venda será representado pelo menor enviado nos campos.
Markup - Importamos do sistema na integração os valores dos produtos praticados em loja, o valor do MARKUP é configurado na plataforma iFood no ato da ativação de acordo com a negociação comercial no fechamento do contrato. O parâmetro do markup é global (o mesmo valor para todos os produtos de forma percentual).
Após avaliar a documentação, o proprietário do ERP/PDV é responsável por realizar todo o processo de integração e testes internos. Caso você tenha alguma dúvida poderá entrar em contato conosco através de nosso canal de suporte.