VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa

Selos, kits, mixes e caixas

Selos, kits, mixes e caixas do seller: o que cada um faz, o que depende de módulo e o mapa das rotas.

Quatro ferramentas ajudam o seller a vender mais por produto: selos (etiquetas como "Novo" ou "Promoção" sobre o produto), kits (vários produtos vendidos juntos com desconto), mixes (kits montados pelo cliente, ou destinados a clientes específicos) e caixas (embalagens fechadas de várias unidades, comuns no atacado de calçados). Cada ferramenta é de uso próprio: o seller só enxerga e altera o que criou.

Pontos principais
  • Tudo é preso ao seller do token. Um item da loja (do administrador) ou de outro seller responde 404.
  • Kits, mixes e caixas do seller aparecem na página do próprio seller; os da loja ficam na vitrine geral e os do seller não vazam para lá.
  • Dinheiro em centavos; no kit, o desconto percentual é em pontos-base (1000 = 10%).
  • Mixes e caixas dependem de um módulo ligado na loja; sem ele, 403.
  • Status são letras: A ativo, D desativado e, em alguns recursos, H oculto.

Como funciona

FerramentaO que éQuem montaMódulo
SeloEtiqueta visual sobre o produto (cor, texto ou imagem) colocada manualmente em produtos.O seller.Nenhum.
Kit (bundle)Produtos do seller vendidos juntos, com preço fixo ou desconto.O seller.Nenhum.
MixKit com regras: componentes obrigatórios ou trocáveis, visível para clientes ou grupos escolhidos.O seller; o cliente escolhe as trocas.mix-products
CaixaEmbalagem fechada com várias unidades e tamanhos (tipo C fechada ou G grade).O seller.product-boxes

Conceitos importantes

Quem pode chamar

Selos, kits e caixas pedem um privilégio de configurações do seller (vendor_settings ou um dos seus irmãos). Mixes pedem privilégio de catálogo. Seller com cadastro ainda em análise recebe 403 vendor_pending_review.

Kit contra mix

Use kit quando o conjunto é fixo: "camiseta + calça por R$ 129". Use mix quando o cliente pode trocar itens de um mesmo grupo, ou quando o conjunto vale só para certos clientes (preço combinado do atacado).

Endpoints

MétodoCaminhoPara que serve
GET/api/v1/vendor/stickersLista os selos do seller.
POST/api/v1/vendor/stickersCria um selo.
GET/api/v1/vendor/stickers/{id}Lê um selo.
PUT/api/v1/vendor/stickers/{id}Altera um selo.
DELETE/api/v1/vendor/stickers/{id}Exclui um selo.
GET/api/v1/vendor/stickers/{id}/productsLista produtos com o selo.
POST/api/v1/vendor/stickers/{id}/productsColoca o selo em um produto.
DELETE/api/v1/vendor/stickers/{id}/products/{productId}Tira o selo de um produto.
GET/api/v1/vendor/bundlesLista os kits.
POST/api/v1/vendor/bundlesCria um kit.
GET/api/v1/vendor/bundles/{id}Lê um kit.
PUT/api/v1/vendor/bundles/{id}Altera um kit.
DELETE/api/v1/vendor/bundles/{id}Exclui um kit.
GET/api/v1/vendor/mix-productsLista os mixes.
POST/api/v1/vendor/mix-productsCria um mix.
GET/api/v1/vendor/mix-products/{id}Lê um mix.
PUT/api/v1/vendor/mix-products/{id}Altera um mix.
DELETE/api/v1/vendor/mix-products/{id}Exclui um mix.
GET/api/v1/vendor/product-boxesLista as caixas.
POST/api/v1/vendor/product-boxesCria uma caixa.
GET/api/v1/vendor/product-boxes/{id}Lê uma caixa.
PUT/api/v1/vendor/product-boxes/{id}Altera uma caixa.
DELETE/api/v1/vendor/product-boxes/{id}Exclui uma caixa.

Erros comuns

  1. Criar kit sem status. O padrão interno é "draft", que o banco não aceita; a criação falha. Envie sempre status: "A" ou "D".
  2. Colocar produto de outro seller num kit. Voltam 400 com product ... does not belong to this vendor.
  3. Esperar que o selo apareça sozinho. Um selo só aparece nos produtos aos quais foi anexado em Selos nos produtos.
  4. Chamar mix ou caixa em loja sem o módulo. Volta 403 module_disabled.
  5. Esquecer que o preço do kit é o final. Em price_bps vai o preço final em centavos (apesar do nome), e discount_bps é percentual em pontos-base.
  6. Montar mix com componentes vazios. O mix exige ao menos um componente.

Próximos passos

Selos
Crie o visual do selo.
Kits
Produtos juntos com desconto.
Mixes
Kits com trocas e públicos.
Caixas
Atacado em caixa fechada.
Anterior
Personalização
Próxima
Selos
Nesta página
  • Como funciona
  • Conceitos importantes
  • Quem pode chamar
  • Kit contra mix
  • Endpoints
  • Erros comuns
  • Próximos passos