Produção

Requisitos da ficha

A conferência compara a ficha com estes requisitos antes de qualquer geração. Sem conferência aprovada, nada é gerado e nada é cobrado.

A ficha (PUT/contas/{contaId}/produtos/{codigo}) é a única fonte de dados e fotos do produto. O Sellume não lê o Mercado Livre nem outro marketplace para integradores: tudo o que é preciso para produzir com qualidade vem de você. Fotos e dados enviados valem como oficiais, sob sua responsabilidade (contrato). A referência do anúncio (anuncio) é opcional e serve só como rastreio.

Em linguagem simples#

1. Toda ficha precisa de nome, pelo menos uma foto boa do produto, pelo menos uma característica e uma descrição de pelo menos 40 letras.
2. Foto boa: JPEG, PNG ou WebP, até 15 MB, com pelo menos 800 px no lado menor. A primeira foto é o produto sozinho, fora da caixa, em fundo liso, sem pessoa.
3. Kit ou mais de uma unidade: diga o que vem e quantas.
4. Galeria: o sistema diz quantas imagens o produto aguenta (3, 6 ou 10). Não dá para pedir mais.
5. Apresentação: nota 5 de 10 (foto, outros lados, características, dúvidas, avaliações, garantia) e pelo menos uma foto sem pessoa.
6. CinePremium: o mesmo, mais 3 fotos de lados diferentes. Roupa e calçado: 2 fotos da peça sem pessoa.
7. Ajuda (não obriga): avaliações, perguntas, garantia, mais fotos de fundo liso, mais características, marca.
8. Sem conferência aprovada, não gera, e nada é cobrado.

Para qualquer geração#

Galeria (3, 6 ou 10 imagens)#

• Os mínimos acima e dados suficientes para pelo menos 3 imagens (GALERIA_ABAIXO_DO_MINIMO).
• A conferência informa a quantidade máxima sustentada (quantidadeMaximaImagens) e quais das opções 3, 6 e 10 podem ser pedidas (quantidadesAprovadas). Pedir mais é recusado (GALERIA_QUANTIDADE_ACIMA_DO_SUPORTADO).
• Cada característica, dúvida de comprador, avaliação útil e garantia libera capítulos da galeria. 10 imagens costumam pedir 3 ou mais características e avaliações ou perguntas.

Vídeo Apresentação#

• Nota de vídeo de 5 ou mais, de 10 (VIDEO_NOTA_BAIXA). Pontos:

• Pelo menos 1 foto aprovada sem pessoa (FOTO_SEM_PESSOA_AUSENTE). Sem ela, a pessoa da foto poderia aparecer no vídeo no lugar do avatar.

Vídeo CinePremium#

• Tudo da Apresentação e 3 ou mais fotos aprovadas de lados diferentes (CINEPREMIUM_FOTOS_INSUFICIENTES).
• Roupa e calçado: 2 ou mais fotos da peça sem pessoa — cabide, manequim ou estendida (ROUPA_FOTOS_SEM_PESSOA_INSUFICIENTES).

Opcionais que melhoram a qualidade#

• 2 ou mais fotos de fundo liso: a foto ambientada só sai do vídeo quando sobram 2 lisas.
• 3 ou mais fotos de lados diferentes; até 40 atributos (o vídeo usa até 40).
• avaliacoes e perguntas reais, sem dados pessoais do comprador: até 20 de cada são usadas e nunca provam característica técnica.
• garantia, provaSocial (total de avaliações, nota média, vendidos), marca, modelo, categoria (ambientação e trilha) e dimensoes.
• Proporção da foto entre 0,4 e 2,5: fora disso o vídeo usa a foto com borda branca.
• video: guardado como referência; o motor atual não usa.

A edição de imagem não passa pela conferência: ela só vale para imagem entregue pelo Sellume (Edição de imagem).

Como a conferência funciona#

• POST/produtos/{produtoId}/conferencia é grátis e confere a versão atual do produto. Responde aprovado ou reprovado por tipo (galeria, Apresentação, CinePremium), com cada pendência: código, severidade (bloqueio ou fraco), campo e mensagem. Também traz cada foto com o resultado da triagem.
• Cada nova versão da ficha dispara a conferência sozinha (aviso produto.conferido).
• POST/galerias e POST/videos exigem a conferência concluída e aprovada para o tipo. Senão: 422 PRODUCT_NOT_VERIFIED (sem conferência da versão atual) ou 422 PRODUCT_REQUIREMENTS_NOT_MET (reprovado), antes de qualquer reserva ou custo.
• A conferência vale para a versão do produto e para a versão das regras (politica). Regra nova pede nova conferência.
• Limite: 10 conferências por produto por dia.

Campos da ficha#

Obrigatórios no envio: nome e imagens. O codigo (SKU) vem do caminho. Os demais são opcionais no formato, mas contam para os requisitos acima.

Ficha de exemplo#

Uma ficha completa, com todos os campos que contam para os requisitos. O resultado da conferência depende das fotos reais: troque os endereços pelos das suas fotos (HTTPS público).

{
  "nome": "Arandela LED de parede 12W luz quente",
  "descricao": "Arandela de parede em alumínio com difusor de vidro jateado e LED integrado de 12 W. A luz quente (3000 K) deixa corredores, varandas cobertas e halls mais aconchegantes, sem ofuscar. O corpo em alumínio pintado de preto fosco não enferruja e dissipa o calor do LED, o que aumenta a vida útil. Instalação simples com o kit de fixação que acompanha o produto. Bivolt automático: funciona em 127 V e 220 V sem ajuste.",
  "descricaoComplementar": "Acompanha kit de fixação (2 buchas e 2 parafusos) e manual de instalação.",
  "marca": "Lumina Casa",
  "modelo": "AR-12Q",
  "gtin": "7891234567895",
  "categoria": {
    "codigo": "ilum-arandelas",
    "nome": "Arandelas",
    "caminho": "Casa > Iluminação > Arandelas"
  },
  "atributos": [
    {
      "nome": "Cor",
      "valor": "Preto fosco"
    },
    {
      "nome": "Potência",
      "valor": "12 W"
    },
    {
      "nome": "Temperatura de cor",
      "valor": "3000 K (luz quente)"
    },
    {
      "nome": "Material",
      "valor": "Alumínio e vidro jateado"
    },
    {
      "nome": "Tensão",
      "valor": "Bivolt automático (127 V e 220 V)"
    },
    {
      "nome": "Fluxo luminoso",
      "valor": "960 lúmens"
    },
    {
      "nome": "Uso",
      "valor": "Interno e área externa coberta"
    }
  ],
  "imagens": [
    {
      "url": "https://seu-servidor.com.br/fotos/arandela-frente.jpg",
      "ordem": 1,
      "principal": true
    },
    {
      "url": "https://seu-servidor.com.br/fotos/arandela-lateral.jpg",
      "ordem": 2
    },
    {
      "url": "https://seu-servidor.com.br/fotos/arandela-costas.jpg",
      "ordem": 3
    },
    {
      "url": "https://seu-servidor.com.br/fotos/arandela-acesa.jpg",
      "ordem": 4
    }
  ],
  "dimensoes": {
    "largura": 12,
    "altura": 25,
    "profundidade": 8,
    "unidade": "cm",
    "pesoLiquido": 0.6,
    "pesoBruto": 0.8,
    "unidadePeso": "kg"
  },
  "composicaoOferta": [
    {
      "item": "Arandela LED",
      "quantidade": 1
    },
    {
      "item": "Kit de fixação",
      "quantidade": 1
    }
  ],
  "garantia": "12 meses contra defeitos de fabricação",
  "avaliacoes": [
    {
      "nota": 5,
      "texto": "Iluminou bem o corredor e a instalação foi simples.",
      "data": "2026-08-14"
    },
    {
      "nota": 5,
      "texto": "Acabamento preto fosco muito bonito, a luz é bem quente.",
      "data": "2026-09-02"
    },
    {
      "nota": 4,
      "texto": "Boa luminária, uso na varanda coberta há um mês sem problema.",
      "data": "2026-09-20"
    }
  ],
  "perguntas": [
    {
      "pergunta": "Serve para área externa coberta?",
      "resposta": "Sim, para área externa coberta."
    },
    {
      "pergunta": "Precisa de transformador?",
      "resposta": "Não, é bivolt automático."
    },
    {
      "pergunta": "A lâmpada pode ser trocada?",
      "resposta": "O LED é integrado e não precisa de troca."
    }
  ],
  "provaSocial": {
    "totalAvaliacoes": 214,
    "notaMedia": 4.8,
    "vendidos": 1350
  },
  "anuncio": {
    "marketplace": "mercado_livre",
    "id": "MLB4123456789"
  }
}