User Products

No modelo anterior de publicações de um vendedor, era possível criar variações que agrupavam diferentes opções do mesmo produto, como uma camisa em várias cores ou tamanhos. Essas variações permitiam oferecer produtos relacionados dentro da mesma publicação. No entanto, esse modelo tinha várias limitações:

• Não era possível estabelecer diferentes preços por variação.
• Não é possível configurar diferentes formas de entrega por variantes.
• Não era possível aplicar promoções ou parcelamento específico por variação.

Nosso objetivo é adotar um novo modelo que resolva esses problemas e unifique a experiência, desacoplando as condições de venda para permitir diferenças em cada variação e assim expandir as publicações.
A partir disso, surge a ideia de criar "User Products" (Produtos de Usuário), onde as iniciativas a serem trabalhadas serão:

• Preço por variação.
• Estoque distribuído.
• Estoque multi-origem.

Esse enfoque permitirá oferecer uma maior flexibilidade na configuração das publicações, permitindo preços e gestão de estoque específicos para cada variação, o que melhorará a experiência do comprador e a eficiência nas operações de venda.

Conceitos importantes

Para compreender o modelo de User Product (UP), é fundamental considerar os seguintes conceitos:

1. Item:
2. É a representação da publicação de um produto que um comprador visualiza na plataforma.
3. Contém informações relativas às condições de venda (preço, parcelas, etc.).
4. Cada item possui um identificador único (item_id) associado.


5. User Product (UP):
6. Representa um produto físico que um vendedor possui e oferta através da plataforma.
7. Um UP descreve o produto da forma mais específica possível (nível de variação).
8. Cada UP possui um identificador único (user_product_id) atribuído automaticamente pelo sistema.
9. Pode estar associado a um ou mais ítens. Exemplo: um iPhone vermelho (o UP) pode estar no item1 em 3 parcelas e no item2 com outro preço diferente.
10. Todo UP poderá ser visualizado no Mercado Livre por meio de uma User Products Page (UPP).


11. Família:
12. É autogerada com base nas informações dos produtos.
13. Cada UP está relacionado a uma família (family_id), e cada família agrupa vários UPs.
14. Os itens da mesma família terão o mesmo family_name e serão representados como pickers diferentes na UPP. Os pickers são as opções oferecidas a um comprador para adquirir um produto, incluindo diferentes condições de venda e atributos, como a cor.
15. A modificação dos itens através do PUT ao recurso /items, que se refere às características do User Product, será replicada pelo Mercado Livre de forma assíncrona em todos os itens associados ao mesmo User Product. Os campos do item que são sincronizados são:
• title
• family_name
• attributes
• pictures
• domain_id
• catalog_product_id
• condition
• available_quantity
16. Para itens de moda, a tabela de medidas será compartilhada pela família.

A seguir, para exemplificar os conceitos mencionados anteriormente, apresentamos uma comparação entre uma publicação no modelo anterior vs o endgame com User Products.

Baseado no novo modelo, apresentamos um exemplo para uma família e sua composição tanto em User Products (UP) quanto em seus itens e condições de venda:

FAQs

Preço por variação

Como posso identificar os itens que já estão sob o novo modelo de UP?

Com o atributo family_name que se encontra ao realizar um GET /items. No caso de ser diferente de nulo.

Como posso obter todos os itens que correspondem a uma mesma família?

Realizando as seguintes requisições:

• GET a /items para obter o user_product_id
• GET a /user-products/$USER_PRODUCT_ID para obter o family_id
• GET a /sites/$SITE_ID/user-products-families/$FAMILY_ID para obter todos os User Products associados a uma família

É possível atualizar o family_name?

Sim, apenas quando o item ainda não tiver vendas. (Endpoint pendente de liberação)

Todos os vendedores serão habilitados para trabalhar com o novo modelo de UP?

Sim, os sellers serão habilitados progressivamente até alcançar 100% dos sellers.

Posso publicar com atributos tipo custom em User products?

Sim, é possível publicar adicionando o atributo, exemplo:

{
	"attributes": [
		{
			"name": "my-custom-attribute-name",
			"value_name":"my-custom-attribute-value"
		}
	]
}

O recurso /categories continuará funcionando da mesma forma para que possamos consultar os atributos e suas tags? Por exemplo, allow_variations e variation_attribute.

Sim, inclusive, você poderá tomar como referência (não regra) esses atributos para entender qual será o atributo levado para a completude do family_name da publicação.

Será possível enviar o array de variations após a ativação de um seller no novo modelo de UP?

Não, não será possível enviar o array, pois cada uma das variações será uma condição de venda (itens diferentes).

Os itens que estão no modelo anterior migrarão automaticamente para o novo modelo?

Não, os itens só poderão ser migrados mediante solicitação do seller, seja pelo front do Mercado Livre ou pelo seu integrador.

O que acontecerá com as informações de vendas das publicações antigas?

As informações de vendas permanecerão exatamente iguais, não perderão o histórico.

Ajude-nos a melhorar

Recomendamos complementar esta leitura com a documentação do nosso Devsite, inclusive as próximas documentaç˜ões. No entanto, caso tenha mais perguntas referentes a User Products, você pode enviar suas dúvidas através deste formulário, isso nos ajudará a complementar este documento.

Siguiente: Preço por variação.