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.

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.