📊 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)
- 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: +519894529261️⃣ Abrir e Duplicar a Planilha
Passos:
- Abra a planilha no Google Sheets: PLANTILLA CARGA MASIVA V2
- Faça uma cópia no seu Drive:
Arquivo → Criar uma cópia- Nomeie:
CargaMassiva_\\<Cliente\\>_\\<Data\\> - Ex.:
CargaMassiva_MinhaLoja_2025-11-13
- Verifique o formato v2: A aba deve ter 15 colunas nesta ordem:
| Handle | Nome do Produto | Descrição WhatsApp | Descrição completa | Categoria | Disponível | Preço base | Opcao1 Nome | Opcao1 Valor | Opcao2 Nome | Opcao2 Valor | Opcao3 Nome | Opcao3 Valor | Variante Imagem | Variante Preço |
|---|
2️⃣ Estrutura de Colunas — Formato v2
📋 Tabela de Colunas
| # | Coluna | O que vai aqui | Exemplo |
|---|---|---|---|
| 1 | Handle | Identificador único do produto base (agrupa variantes) | Polo1, Proteina1 |
| 2 | Nome do Produto | Nome do produto SEM variantes | Polo Lacoste, Proteina WheyPure |
| 3 | Descrição WhatsApp | Descrição curta para WhatsApp (máx. 200 chars) | Polo camisero Lacoste de exportação |
| 4 | Descricao completa | Descrição detalhada do produto | Polo camisero com 2 botões gravados... |
| 5 | Categoria | Categorias separadas por vírgulas | Polos, Ropa Hombre |
| 6 | Disponível | A variante está disponível? | Sim ou Não |
| 7 | Preço base | Preço original/base do produto | 30 (sem símbolo) |
| 8 | Opção1 Nome | Nome da primeira variante | Cor, Sabor, Tamanho |
| 9 | Opção1 Valor | Valor específico da Opção1 | Vermelho, Chocolate, M |
| 10 | Opção2 Nome | Nome da segunda variante (opcional) | Tamanho, Apresentação |
| 11 | Opção2 Valor | Valor específico da Opção2 | M, 2lb |
| 12 | Opção3 Nome | Nome da terceira variante (opcional) | Material, Modelo |
| 13 | Opção3 Valor | Valor específico da Opção3 | Algodão, B |
| 14 | Variante Imagem | URLs de imagens separadas por vírgulas SEM espaços | url1,url2,url3 |
| 15 | Variante Preço | Preço final desta variante específica | 30 |
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.
📝 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 (@, $ , #).
- ✅
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
📄 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
🏷️ 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
| Produto | Categorias |
|---|---|
| Polos | Roupas Masculinas |
| Proteínas | Suplementos, Esportivos |
| iPhone Recondicionado | Tecnologia |
| Oficinas | Unhas, Beleza |
✅ 6. Disponível
Propósito: Controlar disponibilidade de cada variante. Regras:- ✅ Usar exatamente:
SimouNão(com inicial maiúscula) - ✅ Controle por variante (uma pode estar disponível e outra não)
| Handle | Nome | … | Disponível | … | Opcao1 Nome | Opcao1 Valor | … | Status |
|---|---|---|---|---|---|---|---|---|
| Polo1 | Polo Lacoste | … | Sim | … | Cor | Vermelho | … | Vermelho disponível |
| Polo1 | Polo Lacoste | … | Não | … | Cor | Azul | … | Azul 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
- ✅ 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ÃO120.000) - ❌ NÃO incluir símbolos: S/, $, R$, €
- ✅ Se não houver desconto, ambos iguais
- Peru: PEN (S/)
- México: MXN ($)
- Brasil: BRL (R$)
- EUA: USD ($)
- Colômbia: COP ($)
🎨 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
Cor,Tamanho,Sabor,Apresentação,Material,Armazenamento,Modelo,Grau,Modalidade
- ✅ 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
📸 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
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| Handle | Nome | Desc WhatsApp | Desc completa | Categoria | Disponível | Preço base | Opcao1 | Opcao1 Valor | Opcao2 | Opcao2 Valor | Opcao3 | Opcao3 Valor | Imagem | Preço |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Taller1 | TALLER MANICURA | Oficina intensiva… | Descrição… | Oficinas | Sim | 179 | url | 179 |
📊 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| Handle | Nome | Desc WhatsApp | Desc completa | Categoria | Disponível | Preço base | Opcao1 | Opcao1 Valor | Opcao2 | Opcao2 Valor | Opcao3 | Opcao3 Valor | Imagem | Preço |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Proteina1 | Proteina WheyPure | Proteína… | Descrição… | Proteínas | Sim | 120 | Sabor | Chocolate | Tamanho | 2lb | url1 | 120 | ||
| Proteina1 | Proteina WheyPure | Proteína… | Descrição… | Proteínas | Sim | 120 | Sabor | Chocolate | Tamanho | 5lb | url2 | 150 | ||
| Proteina1 | Proteina WheyPure | Proteína… | Descrição… | Proteínas | Sim | 120 | Sabor | Morango | Tamanho | 2lb | url3 | 120 | ||
| Proteina1 | Proteina WheyPure | Proteína… | Descrição… | Proteínas | Sim | 120 | Sabor | Morango | Tamanho | 5lb | url4 | 150 |
- 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
- Use Opcao1 para a variante principal
- Opcao2 e Opcao3 ficam vazias
- Formato estruturado com preços por variante
| Handle | Nome | Descrição WhatsApp | Descrição completa | Categoria | Disponível | Preço base | Opcao1 | Opcao1 Valor | Opcao2 | Opcao2 Valor | Opcao3 | Opcao3 Valor | Imagem | Preço |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| PoloLacoste | Polo Lacoste | Polo 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. | Polos | Sim | 30 | Cor | Branco | url1 | 30 | ||||
| PoloLacoste | Polo Lacoste | Polo 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. | Polos | Sim | 30 | Cor | Preto | url2 | 30 | ||||
| PoloLacoste | Polo Lacoste | Polo 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. | Polos | Sim | 30 | Cor | Vermelho | url3 | 30 | ||||
| … (mais 5 linhas, 1 por cor) | ||||||||||||||
- 40 linhas → 8 linhas (redução de 80%)
- Fácil de manter e atualizar preços
- Tamanhos documentados centralmente
🔍 Quando Usar Cada Estratégia
| Combinações | Estratégia | Exemplo |
|---|---|---|
| 1-4 | Variantes completas | Proteína: 2 sabores × 2 tamanhos |
| 5-10 | Variantes completas | Polo básico: 5 cores × 2 tamanhos |
| 11+ | Otimizada | Polo: 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)| Handle | Nome do Produto | Descrição WhatsApp | Descrição completa | Categoria | Disponível | Preço base | Opcao1 Nome | Opcao1 Valor | Opcao2 Nome | Opcao2 Valor | Opcao3 Nome | Opcao3 Valor | Variante Imagem | Variante Preço |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| PoloLacoste1 | Polo Lacoste Clássico | Polo 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 Camiseros | Sim | 30 | Cor | Branco | https://drive.google.com/file/…/blanco.jpg | 30 | ||||
| PoloLacoste1 | Polo Lacoste Clássico | Polo 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 Camiseros | Sim | 30 | Cor | Preto | https://drive.google.com/file/…/negro.jpg | 30 | ||||
| PoloLacoste1 | Polo Lacoste Clássico | Polo 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 Camiseros | Não | 30 | Cor | Azul | https://drive.google.com/file/…/azul.jpg | 30 |
🥤 Alimentos/Suplementos (Variante principal: Sabor)
Produto: Proteína com 2 sabores e 2 apresentações Estratégia: Variantes completas (2 × 2 = 4 combinações)| Handle | Nome do Produto | Descrição WhatsApp | Descrição completa | Categoria | Disponível | Preço base | Opcao1 Nome | Opcao1 Valor | Opcao2 Nome | Opcao2 Valor | Opcao3 Nome | Opcao3 Valor | Variante Imagem | Variante Preço |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Proteina1 | Proteina WheyPure | Proteína de soro de alta qualidade | Proteí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 Esportivas | Sim | 120 | Sabor | Chocolate | Tamanho | 2lb | https://drive.google.com/…/choco_2lb.jpg | 120 | ||
| Proteina1 | Proteina WheyPure | Proteína de soro de alta qualidade | Proteí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 Esportivas | Sim | 120 | Sabor | Chocolate | Tamanho | 5lb | https://drive.google.com/…/choco_5lb.jpg | 150 | ||
| Proteina1 | Proteina WheyPure | Proteína de soro de alta qualidade | Proteí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 Esportivas | Sim | 120 | Sabor | Morango | Tamanho | 2lb | https://drive.google.com/…/fresa_2lb.jpg | 120 | ||
| Proteina1 | Proteina WheyPure | Proteína de soro de alta qualidade | Proteí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 Esportivas | Sim | 120 | Sabor | Morango | Tamanho | 5lb | https://drive.google.com/…/fresa_5lb.jpg | 150 |
📱 Tecnologia (Variante principal: Armazenamento)
Produto: iPhone 12 Pro recondicionado Estratégia: Variantes completas (2 armazenamentos × 2 cores = 4 combinações)| Handle | Nome do Produto | Descrição WhatsApp | Descrição completa | Categoria | Disponível | Preço base | Opcao1 Nome | Opcao1 Valor | Opcao2 Nome | Opcao2 Valor | Opcao3 Nome | Opcao3 Valor | Variante Imagem | Variante Preço |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| iPhone12Pro1 | iPhone 12 Pro Recondicionado | iPhone 12 Pro certificado | iPhone 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 Recondicionado | Sim | 1750 | Armazenamento | 128GB | Cor | Grafite | Grau | B | https://drive.google.com/…/grafito_128.jpg | 1750 |
| iPhone12Pro1 | iPhone 12 Pro Recondicionado | iPhone 12 Pro certificado | iPhone 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 Recondicionado | Sim | 1850 | Armazenamento | 256GB | Cor | Grafite | Grau | B | https://drive.google.com/…/grafito_256.jpg | 1850 |
| iPhone12Pro1 | iPhone 12 Pro Recondicionado | iPhone 12 Pro certificado | iPhone 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 Recondicionado | Não | 1750 | Armazenamento | 128GB | Cor | Prata | Grau | B | https://drive.google.com/…/plata_128.jpg | 1750 |
🎓 Serviços/Cursos (Sem variantes ou variante simples)
Produto: Workshop sem opções| Handle | Descrição WhatsApp | Descrição completa | Categoria | Disponível | Preço base | Opcao1 Nome | Opcao1 Valor | Opcao2 Nome | Opcao2 Valor | Opcao3 Nome | Opcao3 Valor | Variante Imagem | Variante Preço |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Taller1 | WORKSHOP FULL DAY MANICURE | Workshop 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 Unhas | Sim | 179 | https://drive.google.com/…/taller_manicura.jpg | 179 |
6️⃣ Exportar para CSV
Passos:
- No Google Sheets:
Arquivo → Fazer download → Valores separados por vírgula (.csv)
- Nomeie o arquivo:
- Formato:
CargaMassiva_\\<Cliente\\>_\\<AAAA-MM-DD\\>.csv - Exemplo:
CargaMassiva_MinhaLoja_2025-11-13.csv
- Formato:
- 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: +51989452926Modelo de Mensagem
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!