Dúvidas de Produtos

Respostas para dúvidas dos endpoints de catálogo (sku, preço, estoque).

A obrigatoriedade dos atributos será baseada na categoria? Será possível consultar os valores esperados?

Sim, cada categoria terá seus atributos obrigatórios. A consulta será por meio de documentação no Portal do Desenvolvedor Magalu da Open API.

Anúncios criados e existentes no íntegracommerce serão migrados para Open API ou serão excluídos e seller terá que criar novos?

Todos os SKUs criados no Integracommerce já estão sendo migrados para a Open API, para não haver impacto nos processos da integradora ou dos sellers.

Quando os atributos se tornarem obrigatórios como o produto será tratado? Haverá alguma notificação de que aquele produto possui carência de atributos?

A intenção é implementar via documentação quais atributos ser tornarão obrigatórios e um prazo para que isso ocorra, para que o processo todo seja retrocompatível com o que temos no momento. Não há motivos para preocupação no momento da migração.

O campo fulfillment é true/false. É possível enviar o mesmo produto em um anúncio padrão e um fulfillment? Como fica a identificação do SKU nesses casos?

Não. Um produto é fulfillment ou não é. E o envio do SKU com o campo de fulfillment como true não significa que o mesmo já está habilitado para a venda, visto que o processo todo de fulfillment precisa estar completo, ou seja, com os produtos estocados no(s) CD(s) do Magalu.

Qual valor deve ser enviado no campo "origin" da API de produtos, no momento do POST para criar um novo produto?

O campo "origin" é obrigatório existir e ser preenchido com "imported" ou "nacional". Apenas parceiros internacionais precisam informar esse campo como "Imported", parceiros que possuem registro do CNPJ em território brasileiro, será sempre "nacional".

O identificador mais forte do produto (id/sku) será o mesmo da integra?

Sim.

As mensagens de erro do produto bloqueado, serão notificadas via webhook?

Sim.

Terá obrigatoriedade do seller vincular o seu produto ao catálogo elaborado pela Magalu?

Os SKUs atualmente no Magalu são os mesmos do catálogo da Open API. Não há necessidade de reenvio ou nova vinculação.

A Open API irá seguir as mesmas regras de bloqueio na edição dos produtos do catálogo, como edição de SKU e exclusão do item?

Sim. A Open API atua com as mesmas funcionalidades e regras nesse caso. Na verdade, caso as regras internas mudem, a Open API deve refletir 100% destas regras nos seus endpoints.

Como funcionará o cadastro de produtos fulfillment?

Através do campo "fulfillment": false ou true, descrito na documentação da url https://developers.magalu.com/docs/apis/products/ref/portfolios-v-1-post-skus, sendo true um produto fulfillment. O simples cadastro ainda não o torna um produto fulfillment, sendo que é preciso que o estoque do mesmo esteja disponível em um ou mais CDs do Magalu.

A API de estoque irá suportar multi CDs? Estoque de fulfillment? Suporte à dimensões de estoque como centímetros, metros, litros, etc…

Neste momento não, mas futuramente sim o estoque irá suportar multi CDs inclusive de tipos diversos como próprio ou fulfillment. Com relação às dimensões, o que se tem no momento é por SKU e não o utilizado pelo volume total dos SKUs de um determinado estoque ou volume total do estoque de um seller.

Qual a comunicação que utilizam com os integradores quando depreciaram os endpoints de produto da v0 e habilitaram novos scopes para o v1?

A comunicação será efetuada pelo time do Acelera com o Magalu, pelo time de SRE e pelo time de desenvolvimento, cada qual em uma frente para impedir a perda das informações. O time do Acelera com o Magalu e do SRE irão enviar e-mail, podendo também entrar em contato direto caso necessário. O time de desenvolvimento irá disponibilizar esse tipo de informação pelo site de Desenvolvedores Magalu da Open API.

A atualização de estoque ocorre de forma assíncrona?

Sim. Hoje já é desta forma, então não haverá mudança.

O status da publicação, por exemplo o block, virá no webhooks?

Sim, porém não detalhado. Ao saber que um produto foi bloqueado pelo webhook, é preciso usar o endpoint para captura da informação completa com a mensagem recebida da aplicação do Blocklist Magalu.

Se eu tiver um sku que está sendo comercializado tanto com Full como estoque local, como consigo atualizar/diferenciar preço e estoque?

Um mesmo SKU não pode estar sendo comercializado nestes dois modos com a mesma identificação. Nada impede que um mesmo produto, ao ser cadastrado pelo seller com SKUs / IDs diferentes, possa sim ser comercializado de formas diferentes conforme citado.

Qual a funcionalidade do group.id?

O atributo group.id serve como um código agrupador. Sua principal funcionalidade é unir todas as variações de um mesmo produto, como se fossem uma só entidade. Por exemplo, diferentes SKUs de uma mesma camiseta, que variam apenas em cor e tamanho, receberiam o mesmo valor no campo group.id. Isso faz com que, na loja, eles sejam apresentados como um único produto, onde o cliente pode selecionar as opções que deseja.

Para que este agrupamento funcione corretamente, existe uma regra fundamental e obrigatória: todos os SKUs/produtos que possuem o mesmo group.id devem ter exatamente o mesmo conjunto de attributes. Isso significa que, se um produto do grupo tem os atributos COR e TAMANHO, todos os outros produtos dentro desse mesmo grupo também devem ter, obrigatoriamente, os atributos COR e TAMANHO. Não é possível, por exemplo, agrupar um item que possui COR e TAMANHO com outro que possui apenas COR ou com um terceiro que tenha COR e VOLTAGEM.

Qual a diferença entre price e list_price?

O list_price representa o "preço de lista" ou o preço "de", que funciona como o valor de referência do item, ou seja, seu preço cheio e original. É este o preço que geralmente aparece riscado durante uma promoção. Por outro lado, o price é o "preço de venda" efetivo, o valor "por" que o cliente realmente irá pagar pelo produto no final da compra. Ambos os campos são obrigatórios e, para que a exibição de um desconto seja possível, o price deve ser sempre menor ou igual ao list_price. Se não houver desconto, basta que os dois campos tenham o mesmo valor.