Pular para o conteúdo principal

📊 Manual de Preenchimento — Planilha de Produtos v2

🎯 Introdução

Este manual orienta como preencher corretamente a Planilha de Produtos v2, com suporte completo a variantes (cores, tamanhos, sabores etc.) e melhor organização das informações.

📑 Índice do Manual

  • 0️⃣ Prerrequisitos — Modelos oficiais e acesso ao bot de suporte.
  • 1️⃣ Abrir y Duplicar la Plantilla — Como criar sua cópia de trabalho.
  • 2️⃣ Estructura de Columnas - Formato v2 — Tabela completa das 15 colunas.
  • 3️⃣ Reglas y Restricciones por Columna — Guia detalhado de cada campo.
  • Handle (Identificador único)
  • Nome do Produto
  • Descrição WhatsApp (Curta)
  • Descrição completa (Detalhada)
  • Categoria
  • Disponível
  • Preço base e Variante Preço
  • Opções de Variantes
  • Variante Imagem (links S3)
Nestas 2 seções há exemplos de como as tabelas ficariam preenchidas.
  • 4️⃣ Estratégias de Preenchimento — Como organizar produtos com variantes.
  • 5️⃣ Exemplos Completos — Casos reais passo a passo.

0️⃣ Pré-requisitos

✅ Acesso à planilha oficial v2: ESPANHOL: PLANTILLA_CARGA_MASIVA_V2 PORTUGUÊS: PLANTILLA_CARGA_MASIVA_PT_V2 ✅ Acesso ao bot de suporte: +51989452926

1️⃣ Abrir e Duplicar a Planilha

Passos:

  1. Abra a planilha no Google Sheets: PLANTILLA CARGA MASIVA V2
  2. Faça uma cópia no seu Drive:
    • Arquivo → Criar uma cópia
    • Nomeie: CargaMassiva_\\<Cliente\\>_\\<Data\\>
    • Ex.: CargaMassiva_MinhaLoja_2025-11-13
  3. Verifique o formato v2: A aba deve ter 15 colunas nesta ordem:
HandleNome do ProdutoDescrição WhatsAppDescrição completaCategoriaDisponívelPreço baseOpcao1 NomeOpcao1 ValorOpcao2 NomeOpcao2 ValorOpcao3 NomeOpcao3 ValorVariante ImagemVariante Preço

2️⃣ Estrutura de Colunas — Formato v2

📋 Tabela de Colunas

#ColunaO que vai aquiExemplo
1HandleIdentificador único do produto base (agrupa variantes)Polo1, Proteina1
2Nome do ProdutoNome do produto SEM variantesPolo Lacoste, Proteina WheyPure
3Descrição WhatsAppDescrição curta para WhatsApp (máx. 200 chars)Polo camisero Lacoste de exportação
4Descricao completaDescrição detalhada do produtoPolo camisero com 2 botões gravados...
5CategoriaCategorias separadas por vírgulasPolos, Ropa Hombre
6DisponívelA variante está disponível?Sim ou Não
7Preço basePreço original/base do produto30 (sem símbolo)
8Opção1 NomeNome da primeira varianteCor, Sabor, Tamanho
9Opção1 ValorValor específico da Opção1Vermelho, Chocolate, M
10Opção2 NomeNome da segunda variante (opcional)Tamanho, Apresentação
11Opção2 ValorValor específico da Opção2M, 2lb
12Opção3 NomeNome da terceira variante (opcional)Material, Modelo
13Opção3 ValorValor específico da Opção3Algodão, B
14Variante ImagemURLs de imagens separadas por vírgulas SEM espaçosurl1,url2,url3
15Variante PreçoPreço final desta variante específica30

3️⃣ Regras e Restrições por Coluna

🔑 1. Handle (Identificador único)

Propósito: Agrupar todas as variantes do mesmo produto base. Regras:
  • ✅ Usar nomes descritivos: Polo1, iPhone1, Taller1.
  • ✅ Todas as variantes do mesmo produto devem compartilhar o mesmo Handle.
  • ✅ NÃO usar espaços nem caracteres especiais.
  • ✅ Usar números sequenciais para produtos diferentes.
Exemplos:
Polo1  → Todas as variantes do Polo Lacoste
Polo2  → Todas as variantes do Polo Tommy

📝 2. Nome do Produto

Propósito: Nome comercial do produto sem incluir variantes. Regras:
  • ✅ Nome base do produto.
  • ❌ NÃO incluir variantes aqui (Cor, Tamanho etc.).
  • ❌ NÃO usar duplos espaços.
  • ⚠️ Preferir caracteres simples: A-Z, a-z, 0-9, espaços.
  • ⚠️ Evitar: ñ, acentos (á, é, í), símbolos (@, $ , #).
Exemplos:
  • Polo Lacoste (NÃO “Polo Lacoste Vermelho Tamanho M”).
  • Proteina WheyPure (NÃO “Proteina WheyPure Chocolate 2lb”).
  • Polo Camisero Niño → ✅ Polo Camisero Nino.
  • Café Orgánico → ✅ Cafe Organico.

💬 3. Descrição WhatsApp (Curta)

Propósito: Descrição curta para mensagens no WhatsApp. Regras:
  • ✅ Máximo recomendado de 500 caracteres
  • ✅ Apenas o essencial e chamativo
  • ✅ Pode incluir emojis
  • ❌ NÃO incluir informação técnica extensa
Exemplo:
Polo camisero Lacoste de exportação de alta qualidade

📄 4. Descrição completa (Detalhada)

Propósito: Descrição técnica e comercial completa do produto. Regras:
  • ✅ Máximo recomendado de 1000 caracteres
  • ✅ Incluir benefícios, características, materiais
  • ✅ Pode incluir emojis e caracteres especiais
  • ✅ Separar informações com pontos (.)
  • ❌ NÃO usar duplos espaços
🚨 IMPORTANTE — Se usar Estratégia Otimizada (ver seção 5): Quando um produto tem múltiplas variantes secundárias (Ex.: 5 tamanhos), inclua nesta descrição: Para Roupas:
Polo camisero com 2 botões gravados. Tecido algodão piqué reativo.
MEDIDAS: S 66x50cm M 68x52cm L 72x56cm XL 74x58cm XXL 78x62cm.
PREÇOS: S/M/L Unidade S/30 (3+ S/25). XL Unidade S/33. XXL Unidade S/40.
Para Alimentos/Suplementos:
Proteína de soro do leite de alta qualidade. Ideal para recuperação muscular.
APRESENTAÇÕES: 2lb S/120 (Sachês). 5lb S/150 (Pote). 10lb S/280 (Balde).
Para Serviços:
Oficina intensiva de manicure.
DURAÇÃO: 8 horas (9h-18h).
INCLUI: Materiais, certificado, coffee break.

🏷️ 5. Categoria

Propósito: Classificação para buscas e filtros. Regras:
  • ✅ Separar múltiplas categorias por vírgulas
  • ✅ Usar nomes consistentes
  • ✅ Do geral para o específico
Exemplos:
ProdutoCategorias
PolosRoupas Masculinas
ProteínasSuplementos, Esportivos
iPhone RecondicionadoTecnologia
OficinasUnhas, Beleza

6. Disponível

Propósito: Controlar disponibilidade de cada variante. Regras:
  • ✅ Usar exatamente: Sim ou Não (com inicial maiúscula)
  • ✅ Controle por variante (uma pode estar disponível e outra não)
Exemplo:
HandleNomeDisponívelOpcao1 NomeOpcao1 ValorStatus
Polo1Polo LacosteSimCorVermelhoVermelho disponível
Polo1Polo LacosteNãoCorAzulAzul esgotado

💰 7. Preço base e Variável Preço

Propósito:
  • Preço base: Preço original/referência
  • Variante Preço: Preço final desta variante
Regras:
  • ✅ Formato numérico SEM símbolos: 179, 30, 120000
  • ✅ Usar ponto como decimal: 1999.90 (se aplicável)
  • ✅ NÃO usar vírgula para milhares: 120000 (NÃO 120.000)
  • ❌ NÃO incluir símbolos: S/, $, R$, €
  • ✅ Se não houver desconto, ambos iguais
Moeda (Referência — NÃO vai no CSV):
  • Peru: PEN (S/)
  • México: MXN ($)
  • Brasil: BRL (R$)
  • EUA: USD ($)
  • Colômbia: COP ($)
Exemplos:
Preço base: 30   →  Variante Preço: 30  (sem desconto)
Preço base: 150  →  Variante Preço: 120 (com desconto)

🎨 8–13. Opções de Variantes Propósito: Definir até 3 dimensões de variantes. Estrutura:
  • Opcao1 Nome / Opcao1 Valor
  • Opcao2 Nome / Opcao2 Valor
  • Opcao3 Nome / Opcao3 Valor
Nomes comuns:
  • Cor, Tamanho, Sabor, Apresentação, Material, Armazenamento, Modelo, Grau, Modalidade
Regras:
  • ✅ Até 3 opções no máximo
  • ✅ Valores específicos: Vermelho, M, Chocolate, 2lb
  • ✅ Deixar vazio se não usar a opção
  • ✅ Ser consistente nos nomes em todo o catálogo
Exemplos: Produto simples (1 variante):
Opcao1 Nome: Cor        Opcao1 Valor: Vermelho
Opcao2 Nome: (vazio)    Opcao2 Valor: (vazio)
Opcao3 Nome: (vazio)    Opcao3 Valor: (vazio)
Produto com 2 variantes:
Opcao1 Nome: Sabor      Opcao1 Valor: Chocolate
Opcao2 Nome: Tamanho    Opcao2 Valor: 2lb
Opcao3 Nome: (vazio)    Opcao3 Valor: (vazio)
Produto com 3 variantes:
Opcao1 Nome: Cor            Opcao1 Valor: Grafite
Opcao2 Nome: Armazenamento  Opcao2 Valor: 128GB
Opcao3 Nome: Grau           Opcao3 Valor: B

📸 14. Variante Imagem

Propósito: URLs de imagens de cada variante enviadas via nossa plataforma. Regras:
  • ✅ URLs completas hospedadas no Amazon S3
  • ✅ As imagens devem ser enviadas somente pela plataforma YaVendio
  • ✅ Formatos permitidos: JPG ou PNG
  • ✅ Tamanho máximo: 5MB por imagem
  • ✅ Múltiplas URLs separadas por vírgulas SEM espaços
  • ✅ Deixar vazio se não houver imagem (opcional)
  • ⚠️ Usar apenas links gerados na plataforma ao subir imagens
Formato correto:
✅ url1,url2,url3
❌ url1, url2, url3  (espaços NÃO permitidos)
❌ url1 , url2 , url3
Exemplo real de URL S3:
<https://yavendio-products.s3.amazonaws.com/images/producto1-color1.jpg,https://yavendio-products.s3.amazonaws.com/images/producto1-color2.jpg>

4️⃣ Como Tratar Produtos com Variantes?

🎯 Conceito-chave: Handle Compartilhado

Todas as variantes do mesmo produto base compartilham o mesmo Handle.

📊 Caso 1: Produto SEM Variantes (Simples)

Exemplo: Oficina sem opções
HandleNomeDesc WhatsAppDesc completaCategoriaDisponívelPreço baseOpcao1Opcao1 ValorOpcao2Opcao2 ValorOpcao3Opcao3 ValorImagemPreço
Taller1TALLER MANICURAOficina intensiva…Descrição…OficinasSim179url179
Resultado: 1 linha = 1 produto

📊 Caso 2: Produto com Poucas Variantes (≤10 combinações)

Exemplo: Proteína com 2 sabores × 2 tamanhos = 4 combinações Estratégia: Criar 1 linha por combinação
HandleNomeDesc WhatsAppDesc completaCategoriaDisponívelPreço baseOpcao1Opcao1 ValorOpcao2Opcao2 ValorOpcao3Opcao3 ValorImagemPreço
Proteina1Proteina WheyPureProteína…Descrição…ProteínasSim120SaborChocolateTamanho2lburl1120
Proteina1Proteina WheyPureProteína…Descrição…ProteínasSim120SaborChocolateTamanho5lburl2150
Proteina1Proteina WheyPureProteína…Descrição…ProteínasSim120SaborMorangoTamanho2lburl3120
Proteina1Proteina WheyPureProteína…Descrição…ProteínasSim120SaborMorangoTamanho5lburl4150
Resultado: 4 linhas para 1 produto Vantagens:
  • Fácil filtrar por sabor E tamanho
  • Controle de disponibilidade por combinação
  • Preço específico por variante

📊 Caso 3: Produto com MUITAS Variantes (>10 combinações) — ESTRATÉGIA OTIMIZADA

Problema: Uma polo com 8 cores × 5 tamanhos = 40 combinações = 40 linhas 😱 Solução: Estratégia Otimizada

🎯 Regra de Ouro:

Se um produto tiver mais de 10 combinações (Variante1 × Variante2 > 10), use a estratégia otimizada.

📝 Como Aplicar:

Passo 1: Identifique a variante MAIS IMPORTANTE (visual/comercial)
  • Para roupas: Cor
  • Para alimentos: Sabor
  • Para tecnologia: Armazenamento ou Modelo
Passo 2: Apenas essa variante vai nas colunas de opções
  • Use Opcao1 para a variante principal
  • Opcao2 e Opcao3 ficam vazias
Passo 3: Outras variantes (tamanhos, apresentações) vão na Descrição completa
  • Formato estruturado com preços por variante
Exemplo Real — Polo com 8 Cores × 5 Tamanhos: ❌ SEM OTIMIZAR: 40 linhas (1 por Cor×Tamanho) ✅ OTIMIZADO: 8 linhas (1 por Cor)
HandleNomeDescrição WhatsAppDescrição completaCategoriaDisponívelPreço baseOpcao1Opcao1 ValorOpcao2Opcao2 ValorOpcao3Opcao3 ValorImagemPreço
PoloLacostePolo LacostePolo camisero…Polo com 2 botões. MEDIDAS: S 66x50cm M 68x52cm L 72x56cm XL 74x58cm XXL 78x62cm. PREÇOS: S/M/L 30 (3+ 25). XL 33. XXL 40.PolosSim30CorBrancourl130
PoloLacostePolo LacostePolo camisero…Polo com 2 botões. MEDIDAS: S 66x50cm M 68x52cm L 72x56cm XL 74x58cm XXL 78x62cm. PREÇOS: S/M/L 30 (3+ 25). XL 33. XXL 40.PolosSim30CorPretourl230
PoloLacostePolo LacostePolo camisero…Polo com 2 botões. MEDIDAS: S 66x50cm M 68x52cm L 72x56cm XL 74x58cm XXL 78x62cm. PREÇOS: S/M/L 30 (3+ 25). XL 33. XXL 40.PolosSim30CorVermelhourl330
… (mais 5 linhas, 1 por cor)
📊 Resultado:
  • 40 linhas8 linhas (redução de 80%)
  • Fácil de manter e atualizar preços
  • Tamanhos documentados centralmente

🔍 Quando Usar Cada Estratégia

CombinaçõesEstratégiaExemplo
1-4Variantes completasProteína: 2 sabores × 2 tamanhos
5-10Variantes completasPolo básico: 5 cores × 2 tamanhos
11+OtimizadaPolo: 8 cores × 5 tamanhos
20+Otimizada (obrigatória)Roupas: 10 cores × 6 tamanhos

5️⃣ Exemplos Completos por Indústria

🧥 Roupas/Moda (Variante principal: Cor)

Produto: Polo Lacoste com 5 cores e 3 tamanhos Estratégia: Otimizada (5 cores × 3 tamanhos = 15 combinações)
HandleNome do ProdutoDescrição WhatsAppDescrição completaCategoriaDisponívelPreço baseOpcao1 NomeOpcao1 ValorOpcao2 NomeOpcao2 ValorOpcao3 NomeOpcao3 ValorVariante ImagemVariante Preço
PoloLacoste1Polo Lacoste ClássicoPolo camisero Lacoste de exportação.Polo camisero com gola. Tecido piqué 100% algodão. TAMANHOS: S M L XL. MEDIDAS: S 66x50cm M 68x52cm L 72x56cm XL 74x58cm. PREÇOS: Tamanhos S/M/L 30. XL 33.Polos CamiserosSim30CorBrancohttps://drive.google.com/file/…/blanco.jpg30
PoloLacoste1Polo Lacoste ClássicoPolo camisero Lacoste de exportação.Polo camisero com gola. Tecido piqué 100% algodão. TAMANHOS: S M L XL. MEDIDAS: S 66x50cm M 68x52cm L 72x56cm XL 74x58cm. PREÇOS: Tamanhos S/M/L 30. XL 33.Polos CamiserosSim30CorPretohttps://drive.google.com/file/…/negro.jpg30
PoloLacoste1Polo Lacoste ClássicoPolo camisero Lacoste de exportação.Polo camisero com gola. Tecido piqué 100% algodão. TAMANHOS: S M L XL. MEDIDAS: S 66x50cm M 68x52cm L 72x56cm XL 74x58cm. PREÇOS: Tamanhos S/M/L 30. XL 33.Polos CamiserosNão30CorAzulhttps://drive.google.com/file/…/azul.jpg30

🥤 Alimentos/Suplementos (Variante principal: Sabor)

Produto: Proteína com 2 sabores e 2 apresentações Estratégia: Variantes completas (2 × 2 = 4 combinações)
HandleNome do ProdutoDescrição WhatsAppDescrição completaCategoriaDisponívelPreço baseOpcao1 NomeOpcao1 ValorOpcao2 NomeOpcao2 ValorOpcao3 NomeOpcao3 ValorVariante ImagemVariante Preço
Proteina1Proteina WheyPureProteína de soro de alta qualidadeProteína do soro do leite. 24g de proteína por porção. Ideal para recuperação muscular pós-treino. Sem glúten.Proteínas EsportivasSim120SaborChocolateTamanho2lbhttps://drive.google.com/…/choco_2lb.jpg120
Proteina1Proteina WheyPureProteína de soro de alta qualidadeProteína do soro do leite. 24g de proteína por porção. Ideal para recuperação muscular pós-treino. Sem glúten.Proteínas EsportivasSim120SaborChocolateTamanho5lbhttps://drive.google.com/…/choco_5lb.jpg150
Proteina1Proteina WheyPureProteína de soro de alta qualidadeProteína do soro do leite. 24g de proteína por porção. Ideal para recuperação muscular pós-treino. Sem glúten.Proteínas EsportivasSim120SaborMorangoTamanho2lbhttps://drive.google.com/…/fresa_2lb.jpg120
Proteina1Proteina WheyPureProteína de soro de alta qualidadeProteína do soro do leite. 24g de proteína por porção. Ideal para recuperação muscular pós-treino. Sem glúten.Proteínas EsportivasSim120SaborMorangoTamanho5lbhttps://drive.google.com/…/fresa_5lb.jpg150

📱 Tecnologia (Variante principal: Armazenamento)

Produto: iPhone 12 Pro recondicionado Estratégia: Variantes completas (2 armazenamentos × 2 cores = 4 combinações)
HandleNome do ProdutoDescrição WhatsAppDescrição completaCategoriaDisponívelPreço baseOpcao1 NomeOpcao1 ValorOpcao2 NomeOpcao2 ValorOpcao3 NomeOpcao3 ValorVariante ImagemVariante Preço
iPhone12Pro1iPhone 12 Pro RecondicionadoiPhone 12 Pro certificadoiPhone 12 Pro recondicionado Grau B. 12 meses de garantia. Envio grátis. Registro MTC. 15 dias de teste. Tela Super Retina XDR 6.1 polegadas. Câmera tripla.iPhone RecondicionadoSim1750Armazenamento128GBCorGrafiteGrauBhttps://drive.google.com/…/grafito_128.jpg1750
iPhone12Pro1iPhone 12 Pro RecondicionadoiPhone 12 Pro certificadoiPhone 12 Pro recondicionado Grau B. 12 meses de garantia. Envio grátis. Registro MTC. 15 dias de teste. Tela Super Retina XDR 6.1 polegadas. Câmera tripla.iPhone RecondicionadoSim1850Armazenamento256GBCorGrafiteGrauBhttps://drive.google.com/…/grafito_256.jpg1850
iPhone12Pro1iPhone 12 Pro RecondicionadoiPhone 12 Pro certificadoiPhone 12 Pro recondicionado Grau B. 12 meses de garantia. Envio grátis. Registro MTC. 15 dias de teste. Tela Super Retina XDR 6.1 polegadas. Câmera tripla.iPhone RecondicionadoNão1750Armazenamento128GBCorPrataGrauBhttps://drive.google.com/…/plata_128.jpg1750

🎓 Serviços/Cursos (Sem variantes ou variante simples)

Produto: Workshop sem opções
HandleDescrição WhatsAppDescrição completaCategoriaDisponívelPreço baseOpcao1 NomeOpcao1 ValorOpcao2 NomeOpcao2 ValorOpcao3 NomeOpcao3 ValorVariante ImagemVariante Preço
Taller1WORKSHOP FULL DAY MANICUREWorkshop intensivo de manicure 4 em 1.Unhas russas e preparação da unha. Uso correto do drill. Esmaltado em gel. Nivelamento rubber. Duração: 1 aula de 8 horas (9h-18h com 1h de intervalo). Inclui materiais e certificado. Modalidade presencial. Sede Av. Condores 460 La Molina.Workshops UnhasSim179https://drive.google.com/…/taller_manicura.jpg179

6️⃣ Exportar para CSV

Passos:

  1. No Google Sheets:
    • Arquivo → Fazer download → Valores separados por vírgula (.csv)
  2. Nomeie o arquivo:
    • Formato: CargaMassiva_\\<Cliente\\>_\\<AAAA-MM-DD\\>.csv
    • Exemplo: CargaMassiva_MinhaLoja_2025-11-13.csv
  3. Verificação:
    • ✅ O CSV deve ter exatamente 15 colunas
    • ✅ Cabeçalho: Handle,Nome do Produto,Descrição WhatsApp,...
    • ✅ NÃO abrir no Excel (pode alterar o formato decimal)

7️⃣ Enviar Solicitação de Carga

Contato: Bot de Suporte

📱 WhatsApp: +51989452926

Modelo de Mensagem

Assunto: Carga massiva de produtos v2 — <Cliente>

Olá, equipe YaVendeu,

Anexo o arquivo CSV ou compartilho o link do Google Drive para a carga massiva de produtos.

- Cliente: <Nome do cliente>
- Nº de produtos: <n>

Obrigada(o).

Tempo de Processamento

⏱️ 1-2 dias (conforme quantidade de produtos e correção dos dados).

🔟 Perguntas Frequentes (FAQ)

Posso ter produtos sem variantes e com variantes no mesmo CSV?

Sim. Produtos sem variantes terão 1 linha. Produtos com variantes terão múltiplas linhas compartilhando o mesmo Handle.

O que faço se meu produto tiver 4 ou mais tipos de variantes?

O sistema suporta no máximo 3 opções. Considere agrupar algumas variantes ou documentá-las na descrição completa.

Posso deixar o preço em 0?

Não é recomendável. Se o preço variar, use o preço mais comum como base e detalhe variações em “Descrição completa”.

O que faço se eu não tiver imagens para alguns produtos?

Deixe o campo “Variante Imagem” vazio. É opcional.

Como sei se devo usar a Estratégia Otimizada?

Calcule: Variante1 × Variante2 × Variante3
  • ≤10: Use variantes completas (1 linha por combinação)
  • >10: Use estratégia otimizada (1 linha por variante principal)

Posso editar o CSV no Excel?

NÃO recomendado. O Excel pode mudar formato de preços e encoding. Use Google Sheets e exporte diretamente para CSV.

A moeda vai em algum campo?

Não. A moeda é implícita conforme o país do cliente. Insira apenas números.
Continue acompanhando a YaResolve e impulsione seu negócio com nossas dicas! Um abraço,
Equipe YaVendeu Brasil!