A venda em marketplaces é um modelo de comércio colaborativo que oferece vantagens mútuas a sellers e marketplaces. A arquitetura das lojas VTEX permite que elas atuem tanto como seller, quanto como marketplace. Saiba mais em Estratégias de marketplace na VTEX.

Um marketplace hospedado na plataforma VTEX e um seller, seja um seller VTEX ou externo, precisam compartilhar informações entre si para colaborarem. Este artigo apresenta quais são os principais dados compartilhados e está dividido em:

• Conectar marketplace e seller
• Marketplace e seller conectados
• Compartilhamento de emails de clientes

Se quiser começar a vender seus produtos em outros marketplaces, utilize o Marketplaces e integrações. Essa funcionalidade facilita a identificação e o contato entre marketplaces e sellers que operam no ecossistema VTEX.

Para um marketplace VTEX se conectar a um seller, seja um seller VTEX ou externo, as seguintes informações precisam ser acordadas entre as duas partes:

• Trocas e Devoluções: qual será a política de trocas e devoluções a ser adotada na venda dos produtos do seller no marketplace.
• Política de Entrega: qual será a política de entrega da venda dos produtos do seller no marketplace.
• Política de Privacidade de Segurança: qual será a política de segurança aplicável na venda dos produtos do seller no marketplace.
• Comissionamentos: quais serão os valores percentuais das vendas no marketplace que o seller deverá repassar ao marketplace. Existem duas comissões diferentes, a Comissão sobre os Produtos e a Comissão sobre o Frete.

Além disso, para adicionar o seller às suas operações, o marketplace precisa de outras informações, que vão depender do tipo de seller com o qual ele vai se conectar:

• Conectar marketplace VTEX a seller VTEX
• Conectar marketplace VTEX a seller externo

É possível integrar o marketplace VTEX a seller VTEX, ou seller externo, tanto pelo Admin VTEX quanto por API. Nos dois casos, os dados compartilhados entre marketplace e seller serão os mesmos.

Para mais informações sobre como conectar marketplace VTEX a seller VTEX, ou seller externo, pelo Admin VTEX, veja o artigo Adicionar seller. Para integração por API, utilize a chamada Configure Seller Account. Em caso de seller externo, confira o guia de integração com seller externo.

Para que o marketplace VTEX possa se conectar ao seller VTEX, é necessário acesso às seguinte informações:

• ID do Seller (Account Name): account name é o código de identificação do seller na VTEX.
• Email do administrador: endereço eletrônico do administrador responsável pelo seller.
• Meu ID de afiliado no seller: código com três consoantes que identifica o afiliado, criado pelo seller no seu próprio Admin VTEX.
• Descrição: texto em tom comercial que caracteriza o seller. O texto pode aparecer na vitrine do marketplace ao customizar o CMS.
• Política comercial: código identificador da política comercial que o seller deseja utilizar na venda no marketplace.
• Fulfillment SellerId: código identificador do seller responsável pelo fulfillment do pedido. Este é um dado opcional, necessário quando o seller vende SKUs de outro seller, e não deve ser preenchido quando o seller vende seus próprios SKUs.
• Catalog EndPoint: URL do endpoint do catálogo do seller.
• TaxCode: número do Cadastro Nacional da Pessoa Jurídica (CNPJ) do seller ou o código correspondente em outros países.

Quando o seller é do tipo externo, não hospedado no ambiente VTEX, ele precisa informar ao marketplace VTEX:

• Descrição: texto em tom comercial que caracteriza o seller. O texto pode aparecer na vitrine do marketplace ao customizar o CMS.
• Email do administrador: endereço eletrônico do administrador responsável pela operação do seller.
• Fulfillment EndPoint: URL do endpoint para fulfillment de pedidos do seller, por meio do qual o marketplace vai se comunicar com o seller.
• TaxCode: número do Cadastro Nacional da Pessoa Jurídica (CNPJ) ou o código correspondente em outros países.
• User: username de quando se utiliza um hub para integrar com o seller externo.
• Password: senha de quando se utiliza um hub para integrar com o seller externo.

Uma vez que o marketplace VTEX e o seller VTEX, ou externo, estejam conectados, o marketplace pode acessar essas informações sobre o seller pelo Admin VTEX, em MARKETPLACE > Gerenciamento.

Também é possível consultar as informações fornecidas pelo seller por API, tanto para seller VTEX quanto externo, pela chamada Get Seller data by ID.

O marketplace pode conceder ao seller acesso parcial aos emails da sua base de clientes, de forma que esses emails sejam utilizados nas requisições de consulta às condições comerciais de itens e na criação de pedidos. Esta não é uma configuração padrão e o gerenciamento dessas informações é feito por API, por meio do campo TrustPolicy, utilizando as seguintes chamadas:

• Configure Seller Account: permite configurar a conta do seller, seja ele seller VTEX ou externo.
• Update Seller by Seller ID: permite atualizar os dados do seller, seja ele seller VTEX ou externo.

Em pedidos realizados no marketplace, o email do cliente não é exibido para o seller. A relação do cliente é estabelecida com o marketplace e seria necessário o consentimento do cliente para o compartilhamento de seus dados.

• Estratégias de marketplace na VTEX
• Ações para a operação de marketplaces VTEX
• Adicionar seller