Kits, mix e compartilhamento
Quatro ferramentas que ajudam a vender mais de um produto por vez ou por indicação, e quando cada uma faz sentido.
Esta seção reúne quatro ferramentas de venda que não são cadastro de produto: o mix de produtos (um pacote com preço fechado que o cliente monta), as listas sugeridas (kits prontos com quantidades prescritas), o modo catálogo (seller que só exibe produtos, sem carrinho) e o compartilhamento (links de indicação que rendem pontos).
Como escolher
| Quero... | Use |
|---|---|
| Vender um pacote em que o cliente escolhe trocas ("monte seu kit com 3 itens") e o total é fechado | Mix de produtos |
| Mostrar kits prontos, cada um com produtos e quantidades fixas, na vitrine | Listas sugeridas |
| Deixar um seller só mostrar o catálogo, sem compra direta | Modo catálogo |
| Recompensar clientes que indicam produtos por link | Compartilhamento |
Conceitos-chave
Status em letra
Mix e listas sugeridas guardam o status em uma letra: A ativo, D desativado, H oculto (no mix). Nas listas sugeridas a API aceita também a palavra (active, disabled) na entrada e devolve a letra.
Visibilidade do mix
Um mix tem uma de três visibilidades na vitrine: public (qualquer cliente vê), customer-list (só quem foi atribuído, por cliente ou por grupo de usuários) e private (só o cliente atribuído diretamente, nunca por grupo). private é o padrão quando você não informa.
Dono do registro
Um mix pode pertencer a um seller (vendor_id) ou à loja (sem vendor_id). O administrador lê e altera os de todos.
Endpoints
| Método e caminho | Para que serve | Autenticação | Página |
|---|---|---|---|
GET /api/v1/admin/mix-products | Lista mixes | administrador | Mix de produtos |
POST /api/v1/admin/mix-products | Cria mix | administrador | Mix de produtos |
GET /api/v1/admin/mix-products/{id} | Lê um mix | administrador | Mix de produtos |
PUT /api/v1/admin/mix-products/{id} | Altera mix | administrador | Mix de produtos |
DELETE /api/v1/admin/mix-products/{id} | Apaga mix | administrador | Mix de produtos |
GET /api/v1/admin/suggested-lists | Lista kits | administrador | Listas sugeridas |
POST /api/v1/admin/suggested-lists | Cria kit | administrador | Listas sugeridas |
GET /api/v1/admin/suggested-lists/{id} | Lê um kit | administrador | Listas sugeridas |
PUT /api/v1/admin/suggested-lists/{id} | Altera kit | administrador | Listas sugeridas |
DELETE /api/v1/admin/suggested-lists/{id} | Apaga kit | administrador | Listas sugeridas |
GET /api/v1/admin/catalog-store | Lista sellers e o modo catálogo | administrador | Modo catálogo |
PUT /api/v1/admin/catalog-store/vendors/{vendorId} | Liga ou desliga o modo catálogo | administrador | Modo catálogo |
GET /api/v1/admin/sharing/settings | Lê a recompensa | administrador | Compartilhamento |
PUT /api/v1/admin/sharing/settings | Altera a recompensa | administrador | Compartilhamento |
GET /api/v1/admin/sharing/report | Relatório de indicações | administrador | Compartilhamento |
Erros comuns
- Criar um mix sem componentes.
400 invalid_input: ao menos um componente é obrigatório. min_componentsmaior quemax_components.400.- Mandar a lista de
componentsem umPUTde mix achando que acrescenta. Ela substitui todos os componentes. - Esperar que o
kit_pricedesconte sozinho no carrinho. A lista só guarda e exibe o preço. - Alterar o modo catálogo com o módulo desligado.
403 CATALOG_STORE_MODULE_DISABLED. - Mandar um id que não é UUID para o mix. Dá
500, não400.