{"section":"tutorials","requestedLocale":"pt","requestedSlug":"guia-de-integracao-para-marketplaces-marketplace-nao-vtex","locale":"pt","slug":"guia-de-integracao-para-marketplaces-marketplace-nao-vtex","path":"docs/pt/tutorials/integrações/visão-geral-de-integrações/guia-de-integracao-para-marketplaces-marketplace-nao-vtex.md","branch":"main","content":"> ⚠️ Confira a versão atualizada desse [guia de integração com marketplace](https://developers.vtex.com/vtex-developer-docs/docs/external-marketplace-integration-guide) em nosso Developer Portal. \n\nEste documento auxilia na integração de um Marketplace não hospedado na plataforma VTEX com um Seller hospedado na plataforma VTEX.\n\nAs ações necessárias para montar essa integração, do lado do Marketplace, podem ser divididas em dois blocos: \n- **A)** Ações referentes à atualização de __catálogo__ (troca de catálogo, mudança de preço ou mudança no estoque de um SKU);  \n- **B)** Ações referentes ao envio e processamento de __pedidos__ (simulação de carrinho, envio de pedidos, autorização de despacho, recebimento de nota fiscal, rastreamento de transportadora e cancelamento).   \n\nNeste artigo, você confere a visão geral do processo de integração de ambos os blocos, além de ter acesso aos links com o passo a passo específico de cada ação.\n\n> **Alguns Conceitos:**<br/>    \n> **Seller** - Dono do produto, responsável pelo fullfilment, ou seja, por cumprir com a entrega do SKU.<br/>  \n> **Marketplace/Afiliado** - Dono da vitrine (onde o cliente final vê o produto), responsável por expor e fazer a venda do SKU.<br/>  \n> **SKU** - Item a ser trocado e vendido entre Marketplace e Seller.<br/>  \n> **Política Comercial** - Sortimento de produtos, preços e configurações de logística que determina as características de um canal de venda.<br/>  \n> **Endpoint** - Ponto de acesso de um serviço na internet, serviço pronto para receber uma requisição e devolver uma resposta.<br/>  \n> **MarketplaceServicesEndpoint** - Ponto de acesso onde o Seller VTEX entrega ao Marketplace informações sobre o pedido, como a nota fiscal e o código de rastreamento de pedido.   \n\n## A) Fluxo referente à atualização de Catálogo\n\n- Dentro da loja hospedada na VTEX (*Seller*), será cadastrado um *afiliado* (ou seja, o **Marketplace**), que é o interessado em receber o catálogo e as atualizações nos SKUs.  \n- O **Marketplace** deve implementar um endpoint onde receberá notificações sobre quaisquer alterações de preço, estoque ou catálogo do seller.  \n- No *Seller* VTEX, cada vez que um SKU comercializado pelo **Marketplace** sofrer uma alteração de preço, estoque ou no catálogo, o endpoint de notificação do afiliado será chamado.    \n- Quando o **Marketplace** é notificado pelo *Seller* de que um SKU sofreu essa alteração, o **Marketplace** deve checar se atualmente comercializa aquele SKU.  \n\n> Caso SIM: O **Marketplace** usa a API do Catálogo para obter no Seller os dados do SKU e guarda esses dados.  \n\n> Caso NÃO: O **Marketplace** usa a API do Catálogo para obter no Seller os dados do SKU e decidir se deseja incluí-lo na loja ou não.  \n\n### API REST - Ações Referentes à Atualização de Catálogo\n\n1) Marketpalce recebe notificação de mudança de preço, estoque ou catálogo.  \n\n2) Marketplace busca dados de SKU no Seller pela API do Catálogo.  \n\n3) Marketplace busca preço, estoque e dados de frete do SKU pela API de Fullfillment.  \n\n> ℹ️ Saiba mais na documentação para desenvolvedores [External Marketplace](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide).\n\n## B) Fluxo referente ao Envio e Processamento de Pedidos \n\nO fluxo de integrações referente ao envio e processamento de pedidos pode ser dividido em três momentos, cada um com ações específicas:\n\n### Simulação de Carrinho\n- Produto é inserido no carrinho do **Marketplace** ou ocorre a edição de produtos no carrinho.  \n- **Marketplace** precisa fazer consulta de simulação de carrinho no *Seller* para checar preço e estoque.  \n> OBS: quando o cliente fecha o pedido e vai para o pagamento, outra simulação de carrinho deve ser feita.   \n\n### Envio de Pedidos e Despacho\n- Pedido é fechado no **Marketplace**.   \n- **Marketplace** insere pedido no endpoint do *Seller*.   \n- Pagamento do pedido é concluído no **Marketplace**.  \n- **Marketplace** faz chamada no endpoint do *Seller* para autorizar despacho de pedido.  \n\n### Implementação de Marketplace Services Endpoint Actions\n\n  - *Seller* chama *Marketplace Services Endpoint* para realizar três possíveis ações finais:  \n\t- Informar nota fiscal.  \n\t- Informar código de rastreamento da transportadora.  \n\t- Enviar solicitação de cancelamento.   \n\n### API REST - Ações Referentes ao Envio e Processamento de Pedidos\n\n1) Simulação de carrinho.\n\n2) Inserir pedido no Seller.\n\n3) Autorizar despacho de pedido no Seller.\n\n4) Informar Nota Fiscal.\n\n5) Informar rastreamento da transportadora.\n\n6) Enviar solicitação de cancelamento.\n\n> ℹ️ Saiba mais na documentação para desenvolvedores [External Marketplace](https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide)."}