Multilevel Omnichannel Inventory é a configuração na VTEX que permite uma conta principal disponibilizar o estoque de sellers white label e contas franquia para a venda em marketplaces. Este recurso está disponível apenas para marketplaces e sellers VTEX.

O artigo a seguir inclui as seguintes informações sobre a funcionalidade:

• Arquitetura de contas
• Benefícios
• Restrições
• Como configurar

Para saber mais sobre a arquitetura dos pedidos do tipo Multilevel Omnichannel Inventory, e como fazer a configuração via API REST, confira nosso artigo do Developer Portal.

O marketplace é o ambiente onde o produto é vendido, também chamado de vitrine, e o seller é o dono do inventário e o responsável pelo envio do produto.

Quando uma loja vende seus produtos em um marketplace, temos uma relação entre seller e marketplace de dois níveis. Porém a arquitetura da VTEX permite que lojas atuem tanto como marketplaces quanto como sellers, expandindo o número de combinações possíveis.

É possível que um seller de uma conta principal atue como marketplace de sellers white label. Esse é o caso de redes de lojas configuradas como contas franquia e lojas físicas, sendo por definição sellers em outra loja VTEX.

Também é possível que esse seller principal venda seus produtos em um marketplace.

Quando isso ocorre, temos uma arquitetura de três níveis entre marketplace, seller principal, e seus sellers white label, como ilustra a imagem abaixo.

Por padrão, os produtos das lojas físicas, ou sellers white label (nível 3, na imagem), não ficam disponíveis para serem vendidos pelo marketplace do nível 1. Mas é possível torná-los disponíveis com a funcionalidade Multilevel Omnichannel Inventory.

Desta maneira, é possível que um marketplace venda os produtos dos seus sellers diretos e também das lojas físicas e sellers white label vinculados àqueles sellers.

Isso significa que, quando o seller com a conta principal configurar uma integração com um marketplace, as contas franquia estarão automaticamente integradas a ele também, não sendo preciso gerenciar cada franquia individualmente para configurar sua integração ao marketplace.

Atualmente, só é permitido um nível de recursividade. Ou seja, o marketplace pode vender produtos dos sellers white label integrados a um seller direto.

Esta funcionalidade traz vantagens competitivas para o marketplace, como:

• Maior diversidade de produtos oferecidos ao cliente final.
• Menos problemas com estoque insuficiente, ao incluir mais lojas fornecendo produtos.
• A opção de se ofertar todo o estoque de uma operação omnichannel para outros marketplaces, aumentando a oferta de pontos de retirada, por exemplo.
• A possibilidade de se trabalhar com novos modelos de negócio e conectar diferentes marcas com relações colaborativas entre marketplace e seller.
• Acesso a novos mercados e nichos de consumidores.
• Orquestrar pedidos de múltiplos canais com visibilidade sobre toda a cadeia.

Para saber mais detalhes sobre a arquitetura de pedidos aplicada em Multilevel Omnichannel Inventory, confira nosso artigo para pessoas desenvolvedoras.

Algumas das funcionalidades que fazem parte do modelo tradicional de marketplace não estão disponíveis para um cenário Multilevel Omnichannel Inventory. É importante conhecer essas restrições antes de habilitar a configuração.

Note que, no Brasil, o Banco Central (BACEN) regulamenta a atuação de marketplaces varejistas como concentradores e repassadores de dinheiro. Dado essa restrição, recomendamos a implementação do Multilevel Omnichannel Marketplace em lojas que se adequam à circular 3.815 do BACEN. Saiba mais em BACEN e a regulamentação para marketplaces no Brasil - VTEX.

Essa funcionalidade Multilevel Omnichannel Inventory está disponível apenas para marketplaces VTEX. Para usar a funcionalidade, o marketplace (nível 1) deve realizar a configuração para cada seller direto (nível 2) que desejar. Você pode fazer isso ao cadastrar novos sellers ou editando a configuração de sellers existentes na sua loja. Saiba mais em Como configurar e em nosso artigo no Developer Portal.

Não é possível distribuir recebíveis em toda a cadeia (marketplace, seller direto e sellers white label). Os pedidos de Multilevel Omnichannel Inventory estão restritos a ter o pagamento do pedido feito no marketplace. A conciliação e repasse de valores para sellers nível 3 deve ser feito por fora da VTEX, pois não há suporte nativo para essa etapa.

É possível utilizar a solução de split de pagamentos apenas para dividir recebíveis entre os níveis marketplace e _seller direto _(nível 2). Nesse caso o recomendado é utilizar split de recebíveis.

Nesses casos, o seller direto se torna um recebedor dos itens de seus sellers white label e dos seus próprios itens, retirando as comissões configuradas na relação com o marketplace.

A solução pode ser suficiente em casos em que o seller direto faz parte do mesmo grupo econômico que seus sellers white label, possibilitando concentrar todos os recebíveis em uma única conta bancária.

É importante ressaltar que quando o seller direto não é responsável pelos recebíveis dos sellers white label, a solução de split de recebíveis será limitada por não permitir a distribuição até os sellers white label.

Uma vez que a configuração é feita, somente os meios de pagamento do marketplace aparecerão como opção no checkout. Os meios de pagamento dos sellers diretos (nível 2) e sellers white label (nível 3) não são importados na arquitetura de contas. Portanto, o checkout só mostra os meios de pagamento do marketplace, mesmo que o afiliado do seller direto esteja configurado para usar os meios de pagamento dele.

O afiliado da conta franquia sempre deve estar com a configuração de usar os meios de pagamento desativada.

Caso um seller white Label (nível 3) receba um pedido e o rejeite, este pedido não será atribuído a outro seller white label. Consequentemente um novo pedido deverá ser criado pelo comprador, no storefront do marketplace. Saiba mais em Change Seller.

Uma loja VTEX não consegue alterar pedidos finalizados em um marketplace VTEX num cenário de Multilevel Omnichannel Inventory. Será necessário cancelar o pedido e criar um novo. Saiba mais em Change chain orders in external marketplaces.

O cliente não consegue alterar pedidos na seção de Meus Pedidos, do storefront do marketplace. Qualquer alteração nos pedidos deverá ser realizada por meio do Serviço de Atendimento ao Cliente ou via API.

A feature de Manual Price não se aplica ao Multilevel Omnichannel Inventory. Não é possível, portanto, alterar preços manualmente no carrinho. É necessário atualizar o preço via:

• Integração com o ERP
• Pricing API REST
• Página de preços no Admin VTEX

Quando uma compra é realizada por um novo usuário, seus dados não se registram no Profile System do seller direto, que é a loja que efetuou a venda (nível 2 no diagrama acima). Ou seja, o seller não tem visibilidade deste usuário. Os dados do perfil do usuário só serão salvos no Marketplace. É ele quem deve efetuar toda a comunicação com o usuário. Saiba mais em Informações compartilhadas entre marketplace e seller na VTEX.

Um marketplace não pode configurar exibição de preços e disponibilidade de produtos de sellers white label (nível 3) com a funcionalidade de Region.

A aplicação de cupons, gift cards (vale-compras) e benefícios vinculados a UTMs estão restritos ao marketplace nível 1. Aqueles configurados no seller direto (nível 2) e contas franquia ou seller white label (nível 3) não serão aplicados.

A loja não consegue processar pedidos que tenham sido integrados assincronamente com divergência de valores para o Multilevel Omnichannel Inventory. A funcionalidade Autorização de pedidos não suporta as regras de divergência de valores para este cenário.

Não é possível criar tabelas de preço por meio da funcionalidade Price Table. Os preços devem ser cadastrados via integração com o ERP ou por meio de planilhas.

A configuração da funcionalidade Multilevel Omnichannel Inventory deve ser feita pelo marketplace em seu Admin VTEX ou via API Rest. Essa configuração pode ser feita tanto em sellers já integrados, quanto em sellers adicionados pela primeira vez.

Note que a configuração deve ser feita para cada seller direto (nível 2) em que se deseja aplicar a funcionalidade, mas não em cada seller white label ou conta franquia (nível 3).

Para configurá-la em sellers que já foram integrados anteriormente, o marketplace deve seguir os passos abaixo:

1. Na seção Marketplace de seu Admin VTEX, acesse a aba Gerenciamento.
2. Na linha correspondente ao seller cujos sellers white label você deseja acessar, clique em .
3. Clique em Detalhes do seller.
4. Preencha o campo Fulfillment EndPoint seguindo o exemplo: https://{{sellerAccount}}.vtexcommercestable.com.br/api/checkout?affiliateid={{affiliateId}}&sc={{tradePolicyId}}
5. Substitua os campos que estão entre chaves pelos valores descritos abaixo, removendo as chaves:
   • sellerAccount: account name do seller na VTEX.
   • affiliateId: código de três dígitos correspondente ao afiliado criado pelo seller. O seller deve informar esse valor ao marketplace.
   • tradePolicyId: ID da política comercial criada pelo seller em seu próprio ambiente VTEX, para vender em seu marketplace. O seller deve informar esse valor ao marketplace.
6. Clique em Salvar.

Se o marketplace desejar adicionar um seller novo com Multilevel Omnichannel Inventory configurado desde o início, siga as instruções em Adicionar seller, e preencha o campo Fulfillment Endpoint seguindo o passo 4 e 5 do tutorial em Sellers já integrados.

Digamos que o seu marketplace já esteja integrado ao seller "Store ABC" e deseje vender os produtos de sellers white labels integrados a esse seller.

Atualmente, o valor do campo Fulfillment EndPoint do seller tem o seguinte formato e pode ser identificado acessando Marketplace > Sellers > Gerenciamento de Sellers:

https://storeabc.vtexcommercestable.com.br/api/fulfillment?affiliateId=mkp&sc=2

Para habilitar a funcionalidade Multilevel Omnichannel Inventory, o novo valor do campo deve conter o endpoint de checkout, em vez do endpoint de fulfillment:

https://storeabc.vtexcommercestable.com.br/api/checkout?affiliateid=mkp&sc=2

Note que os valores inseridos nos campos sellerAccount, affiliateId e tradePolicyId que já foram preenchidos no endpoint de fulfillment permanecem os mesmos no endpoint de checkout. O que muda é o trecho /checkout.