{"section":"tutorials","requestedLocale":"pt","requestedSlug":"multilevel-omnichannel-inventory","locale":"pt","slug":"multilevel-omnichannel-inventory","path":"docs/pt/tutorials/configurações-da-loja/multilevel-omnichannel-inventory.md","branch":"main","content":"__Multilevel Omnichannel Inventory__ é a configuração na VTEX que permite uma conta principal disponibilizar o estoque de [sellers white label](/pt/docs/tutorials/seller-white-label) e [contas franquia](/pt/docs/tutorials/seller-white-label) para a venda em marketplaces. Este recurso está disponível apenas para marketplaces e sellers VTEX.\n\nO artigo a seguir inclui as seguintes informações sobre a funcionalidade:\n\n* [Arquitetura de contas](#arquitetura-de-contas)\n* [Benefícios](#beneficios)\n* [Restrições](#restricoes)\n* [Como configurar](#como-configurar)\n\n> ℹ️ 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](https://developers.vtex.com/vtex-rest-api/docs/multilevel-omnichannel-inventory).\n\n## Arquitetura de contas\n\nO [marketplace](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex) é o ambiente onde o produto é vendido, também chamado de vitrine, e o [seller](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#sendo-seller-vtex) é o dono do inventário e o responsável pelo envio do produto. \n\nQuando 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. \n\nÉ possível que um seller de uma conta principal atue como marketplace de [sellers white label](/pt/docs/tutorials/seller-white-label). Esse é o caso de redes de lojas configuradas como [contas franquia](/pt/tutorial/what-are-franchise-account-and-seller-white-label--5orlGHyDHGAYciQ64oEgKa?&utm_source=help) e lojas físicas, sendo por definição sellers em outra loja VTEX. \n\nTambém é possível que esse seller principal venda seus produtos em um marketplace.\n\nQuando isso ocorre, temos uma arquitetura de três níveis entre marketplace, seller principal,  e seus sellers white label, como ilustra a imagem abaixo.\n\n![Arquitetura Multilevel omichannel inventory](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/configurações-da-loja/multilevel-omnichannel-inventory_1.png)\n\nPor 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.**\n\nDesta 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. \n\nIsso 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.\n\n> ℹ️ Atualmente, só é permitido um nível de recursividade. Ou seja, o marketplace pode vender produtos dos sellers white label integrados a um seller direto.\n\n## Benefícios\n\nEsta funcionalidade traz vantagens competitivas para o marketplace, como:\n\n* Maior diversidade de produtos oferecidos ao cliente final.\n* Menos problemas com estoque insuficiente, ao incluir mais lojas fornecendo produtos.\n* 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.\n* A possibilidade de se trabalhar com novos modelos de negócio e conectar diferentes marcas com relações colaborativas entre marketplace e seller.\n* Acesso a novos mercados e nichos de consumidores.\n* Orquestrar pedidos de múltiplos canais com visibilidade sobre toda a cadeia.\n\nPara saber mais detalhes sobre a arquitetura de pedidos aplicada em Multilevel Omnichannel Inventory, confira nosso [artigo para pessoas desenvolvedoras](https://developers.vtex.com/vtex-rest-api/docs/multilevel-omnichannel-inventory).\n\n## Restrições\n\nAlgumas 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.\n\n> ⚠️ 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](https://vtex.com/pt-br/blog/estrategia/bacen-e-a-regulamentacao-para-marketplaces-no-brasil/).\n\n### Disponibilidade\n\nEssa funcionalidade _Multilevel Omnichannel Inventory_ está disponível apenas para [marketplaces VTEX](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#ser-um-marketplace-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](#como-configurar) e em nosso [artigo no Developer Portal](https://developers.vtex.com/vtex-rest-api/docs/multilevel-omnichannel-inventory).\n\n### Distribuição de recebíveis\n\nNã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.\n\nÉ possível utilizar a solução de [split de pagamentos](/pt/docs/tutorials/split-de-pagamento) 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](/pt/tutorial/split-payment#split-de-recebiveis). \n\nNesses 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.\n\nA 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.\n\nÉ 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.\n\n### Meios de pagamento\n\nUma 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.\n\n> ⚠️ O [afiliado](/pt/docs/tutorials/como-configurar-afiliado) da conta franquia sempre deve estar com a configuração de usar os meios de pagamento desativada.\n\n### Alteração de seller\n\nCaso 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](/pt/docs/tutorials/change-seller#limitacoes).\n\n### Alteração de pedidos finalizados pela loja\n\nUma 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](https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces).\n\n### Alteração de pedidos finalizados pelo cliente\n\nO 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.\n\n### Manual Price\n\nA 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:  \n\n- [Integração com o ERP](https://developers.vtex.com/vtex-rest-api/docs/erp-integration-guide)  \n- [Pricing API REST](https://developers.vtex.com/vtex-rest-api/reference/createupdatepriceorfixedprice)  \n- [Página de preços no Admin VTEX](/pt/docs/tracks/modulo-de-precos-visao-geral)  \n\n### Informação de usuário\n\nQuando 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](/pt/docs/tutorials/informacoes-compartilhadas-entre-marketplace-e-seller-na-vtex).\n\n### Regionalização\n\nUm 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.](/pt/tutorial/configurar-preco-e-disponibilidade-de-skus-por-region--12ne58BmvYsYuGsimmugoc#)\n\n### UTMs, cupons e gift cards\n\nA aplicação de [cupons](/pt/docs/tutorials/cupons-beta), [gift cards (vale-compras)](/pt/docs/tutorials/gift-card) e benefícios vinculados a [UTMs](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium) 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.\n\n### Pedidos integrados assincronamente com divergência de valores\n\nA 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](/pt/tutorial/como-funciona-a-autorizacao-de-pedidos--3MBK6CmKHAuUjMBieDU0pn#) não suporta as [regras de divergência de valores](/pt/tutorial/regra-de-divergencia-de-valores--6RlFLhD1rIRRshl83KnCjW#) para este cenário.\n\n### Price Table\n\nNão é possível criar tabelas de preço por meio da funcionalidade [Price Table](/pt/docs/tutorials/criar-tabelas-de-precos). Os preços devem ser cadastrados via integração com o ERP ou por meio de planilhas.\n\n## Como configurar\n\nA configuração da funcionalidade **Multilevel Omnichannel Inventory** deve ser feita pelo marketplace em seu Admin VTEX ou via [API Rest](https://developers.vtex.com/vtex-rest-api/docs/multilevel-omnichannel-inventory). Essa configuração pode ser feita tanto em sellers já integrados, quanto em sellers adicionados pela primeira vez. \n\n> ℹ️ 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).\n\n### Sellers já integrados\n\nPara configurá-la em sellers que já foram integrados anteriormente, o marketplace deve seguir os passos abaixo:  \n\n1. Na seção Marketplace de seu Admin VTEX, acesse a aba **Gerenciamento.**\n2. Na linha correspondente ao seller cujos sellers white label você deseja acessar, clique em <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i>.\n3. Clique em  **Detalhes do seller.**\n4. Preencha o campo **Fulfillment EndPoint** seguindo o exemplo:  https://\\{\\{sellerAccount\\}\\}.vtexcommercestable.com.br/api/checkout?affiliateid=\\{\\{affiliateId\\}\\}&sc=\\{\\{tradePolicyId\\}\\}\n5. Substitua os campos que estão entre chaves pelos valores descritos abaixo, removendo as chaves:  \n    - **sellerAccount**: [account name](/pt/docs/tutorials/o-que-e-account-name) do seller na VTEX.   \n    - **affiliateId**: código de três dígitos correspondente ao [afiliado](/pt/docs/tutorials/o-que-e-afiliado) criado pelo seller. O seller deve informar esse valor ao marketplace.   \n    - **tradePolicyId**: ID da [política comercial](/pt/docs/tutorials/como-funciona-uma-politica-comercial) criada pelo seller em seu próprio ambiente VTEX, para vender em seu marketplace. O seller deve informar esse valor ao marketplace.  \n  6. Clique em **Salvar.**   \n\n### Sellers integrados pela primeira vez\n\nSe o marketplace desejar adicionar um seller novo com _Multilevel Omnichannel Inventory_ configurado desde o início, siga as instruções em [Adicionar seller](/pt/docs/tutorials/adicionar-seller), e preencha o campo `Fulfillment Endpoint` seguindo o passo 4 e 5 do tutorial em [Sellers já integrados](#sellers-ja-integrados).\n\n### Exemplo\n\nDigamos que o seu marketplace já esteja integrado ao seller \"_Store ABC\"_ e deseje vender os produtos de sellers white labels integrados a esse seller.\n\nAtualmente, o valor do campo _Fulfillment EndPoint_ do seller tem o seguinte formato e pode ser identificado acessando **Marketplace > Sellers > Gerenciamento de Sellers**:\n\n`https://storeabc.vtexcommercestable.com.br/api/fulfillment?affiliateId=mkp&sc=2`\n\nPara habilitar a funcionalidade Multilevel Omnichannel Inventory, o novo valor do campo deve conter o endpoint de **checkout,** em vez do endpoint de fulfillment:\n\n`https://storeabc.vtexcommercestable.com.br/api/checkout?affiliateid=mkp&sc=2`\n\nNote 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`."}