O futuro do comércio digital é colaborativo, e parcerias bem sucedidas são indispensáveis para o sucesso da operação do lojista. Durante a operação de uma loja, é comum surgirem dúvidas sobre papéis e responsabilidades de cada player do ecossistema.
Para otimizar a operação da sua loja e garantir a eficiência da comunicação entre o lojista e o suporte da VTEX, esse artigo apresenta as responsabilidades dos principais players envolvidos em uma operação de comércio digital. Confira as responsabilidades em cada cenário a seguir:
- Integrações back-office (ERP / PIM / WMS)
 - Integrações com provedores de pagamento
 - Agências implementadoras
 - Integrações com marketplaces
 
Integrações back-office (ERP / PIM / WMS)
Durante a configuração inicial da VTEX, caso a sua loja utilize integrações externas com ERP / PIM / WMS, é de responsabilidade desses sistemas enviar os produtos, preços e inventário da sua loja para a VTEX. Em seguida, é necessário desenvolver um middleware que será responsável por enviar e receber informações da VTEX de acordo com eventos da rotina de sua operação.
Uma vez configurada a integração inicial de produtos, preços e inventário, e desenvolvido o middleware, o fluxo de informações será conforme o diagrama a seguir.
Durante a rotina da operação, as responsabilidades são divididas da seguinte forma:
Integrações com provedores de pagamento
Para realizar o processamento de pagamentos dos pedidos em uma loja VTEX, os integrantes da infraestrutura de pagamentos dividem as responsabilidades da seguinte forma:
Ao detectar qualquer inconsistência ou erro durante a transação de pagamento de um pedido, o lojista deve:
- Entrar em contato com o(s) responsável(is) pela respectiva transação (provedores de pagamento e antifraude).
 - Caso o assunto não seja resolvido, abrir um ticket no Suporte VTEX informando os dados da ocorrência.
 
Agências implementadoras
No caso das soluções de CMS nativas, é comum que o lojista conte com a parceria de uma agência implementadora para customizar a aparência e a experiência do cliente na frente de loja.
A VTEX possui as seguintes possibilidades de CMS nativas: o Layout para lojas Portal CMS Legado, o Site Editor para lojas usando o Store Framework e o Headless CMS para lojas usando a FastStore. Além disso, também é possível integrar o seu CMS externo com as APIs da VTEX de forma headless.
Problemas relacionados a como o conteúdo está aparecendo para o usuário final devem sempre ser tratados inicialmente com o suporte da agência. Alguns exemplos desses problemas são:
- Imagens, títulos ou banners incorretos ou desatualizados.
 - Produtos indisponíveis na frente de loja.
 - Páginas em branco.
 - Menu de categorias incorreto ou desatualizado.
 - Resultados de busca ou de coleções incorretos ou incompletos.
 - Botões de chamada para ação (por exemplo, Comprar, Avise-me, Adicionar ao carrinho) com comportamento não esperado.
 - Preços de produtos ou valores de frete inconsistentes com o que está cadastrado na plataforma.
 
Se a agência verificar que o problema está em controles, apps ou componentes nativos da VTEX, acione nossos canais de comunicação, conforme a Política de atendimento do suporte da VTEX, incluindo todas as evidências da investigação já feita pela agência.
Integrações com marketplaces externos
A VTEX possui uma arquitetura multi-seller nativa que permite que lojas VTEX se tornem marketplaces ou sellers em outras lojas VTEX. Além disso, a plataforma também possui integrações nativas com marketplaces externos para ofertar seus produtos sem necessidade de desenvolvimento. Os marketplaces com integrações nativas podem ser encontrados no guia Marketplaces e Integrações.
Ainda assim, podem existir lojas parceiras estratégicas para o seu negócio que operem fora dessa rede colaborativa nativa. Para casos como esse, a VTEX permite o desenvolvimento de integrações com marketplaces externos, com conectores externos (hubs) responsáveis por fazer a comunicação entre uma loja VTEX e um marketplace externo não-nativo.
Para o suporte de uma operação nesse cenário, é importante que o lojista entenda quais as responsabilidades de cada participante dessa operação, detalhadas a seguir.
As seções a seguir consideram uma loja que já está operando integrada com um marketplace externo via conector externo. Para saber como integrar o seu Catálogo da VTEX com um conector externo pela primeira vez, acesse o guia Catalog Integration.
Atualização ou envio de novos produtos e SKUs
Veja a seguir as responsabilidades envolvidas em caso de atualização ou envio de novos produtos e SKUs para o marketplace externo:
| Player | Responsabilidades | 
|---|---|
| VTEX | Enviar uma notificação de novo produto ou SKU criado ou atualizado para o endpoint de afiliado fornecido pelo hub e cadastrado na plataforma VTEX. | 
| Conector parceiro (hub de integração) | Processar a notificação e enviar o produto ou SKU atualizado para o marketplace. Esse processamento engloba diversas etapas, incluindo verificar se esse SKU já existe no marketplace e registrar como um novo se necessário, validar se o produto está ativo e associado à política comercial do marketplace, fazer uma simulação de pedido para conferir preço e inventário do SKU atualizados, entre outras. | 
| Marketplace externo não-nativo | Fornecer os endpoints necessários para o hub enviar o SKU atualizado, registrar o SKU recebido e responder o status para o conector. | 
Atualização ou criação de novos pedidos
Confira as responsabilidades envolvidas na atualização ou criação de pedidos de acordo com o fluxo do pedido.
- 
O marketplace disponibiliza os produtos e o checkout para que o pedido seja realizado e notifica o conector sobre um novo pedido criado.
 - 
O conector é responsável por criar o pedido na VTEX.
 - 
A VTEX responde ao conector o status de criação do pedido, que pode ser sucesso ou falha. Nesta etapa, se houver falha na criação do pedido na VTEX, ou se pedido for criado com o status Cancelado, é necessário contatar o suporte do conector.
 - 
Uma vez que o pedido é criado na VTEX, a responsabilidade pela atualização do seu status no OMS depende da etapa do processo:
- Se o pedido está preparando entrega ou faturado, por exemplo, é responsabilidade do ERP notificar a VTEX.
 - Se o pedido foi cancelado no marketplace, a responsabilidade é do conector.
 
 
Para mais informações sobre quem é responsável por cada etapa do fluxo de um pedido num cenário de marketplace externo, veja Fluxo e status de pedidos - Fluxo do Seller.
Status do pedido
Para entender qual suporte deve ser acionado caso haja algum problema na atualização do status do pedido, é preciso seguir o passo a passo:
- No Admin VTEX, acesse Pedidos > Todos os Pedidos.
 - Clique no pedido desejado para acessar a página de detalhes do pedido.
 - Na seção Histórico do pedido, clique em 
Ver interações(botão ilustrado a seguir), e verifique se há alguma mensagem de erro. 

Caso a mensagem de erro não seja autossuficiente, o lojista pode acionar nossos canais de comunicação, conforme a Política de atendimento do suporte da VTEX. Recomendamos incluir a evidência da tela de interações e o ID do pedido, para que o time de especialistas ajude a identificar a origem do problema.