Skip to main content

📊 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:

2️⃣ Estrutura de Colunas — Formato v2

📋 Tabela de Colunas


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:

📝 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:

📄 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:
Para Alimentos/Suplementos:
Para Serviç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
Exemplos:

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:

💰 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:

🎨 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):
Produto com 2 variantes:
Produto com 3 variantes:

📸 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:
Exemplo real de URL S3:

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 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 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) 📊 Resultado:
  • 40 linhas8 linhas (redução de 80%)
  • Fácil de manter e atualizar preços
  • Tamanhos documentados centralmente

🔍 Quando Usar Cada Estratégia


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)

🥤 Alimentos/Suplementos (Variante principal: Sabor)

Produto: Proteína com 2 sabores e 2 apresentações Estratégia: Variantes completas (2 × 2 = 4 combinações)

📱 Tecnologia (Variante principal: Armazenamento)

Produto: iPhone 12 Pro recondicionado Estratégia: Variantes completas (2 armazenamentos × 2 cores = 4 combinações)

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

Produto: Workshop sem opções

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

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!