Integração Shop x Plug4market

O Plug4Market conecta o Shop (WShop/IShop) aos marketplaces por meio do serviço ms-market, centralizando produtos, estoque, pedidos e faturamento. Use este guia para validar o ambiente, configurar a empresa, mapear produtos e acompanhar os pedidos no fluxo correto do Shop. Para entender cada informação solicitada nas telas, consulte os quadros de Detalhamento de Campos de cada seção.

Unknown Attachment

Antes de começar

Confira os requisitos abaixo antes de iniciar a implantação ou a validação da integração:

Confirme se a versão do WShop/IShop é 6.1514 ou superior.
Verifique se o serviço ms-market ou altshopproc_Alterdata Market está instalado e ativo no servidor.
Garanta que o cadastro da empresa no Alterdata Market foi realizado pela Alterdata/DSN.
Escolha obrigatoriamente apenas uma plataforma de integração: Muven ou Tecnospeed.
Valide se o contrato do Shop está regularizado.
Separe as variações dos produtos para realizar o mapeamento De/Para, como Grade, Cor e Tamanho.
Organize as categorias para vincular produtos sempre à categoria folha, ou seja, o último nível da árvore.

Aviso: Muven e Tecnospeed não operam simultaneamente. Caso exista migração entre plataformas, alinhe o processo com a implantação para evitar duplicidade ou interrupção da integração. Para consultar canais de venda atendidos pelo Plug4Market, acesse Acesse a Central de Atendimento Plug4Market.

Erro: a inadimplência no contrato do Shop bloqueia o serviço de integração. Regularize o contrato antes de acionar novos testes ou reprocessamentos.

Detalhamento de Campos — Pré-requisitos

Campo	Onde fica no sistema	Objetivo
Versão do WShop/IShop	`Ajuda / Sobre` ou local equivalente no ambiente do cliente	Confirma se o sistema está na versão mínima exigida para a integração.
Serviço ms-market	Servidor da empresa ou ambiente validado pela implantação	Executa a ponte entre o Shop e a Tecnospeed.
Plataforma de integração	Definição comercial/implantação	Indica que a operação usará a Tecnospeed. Operação simultânea com Muven não é possível.
Variações	Cadastros e mapeamentos do Shop	Base para o De/Para entre as variações internas e os padrões aceitos pela parceira.

Liberação e Autenticação (DSN/Implantação)

O primeiro passo não é realizado pelo usuário final, mas pela equipe de DSN da Alterdata:

Cadastro da Loja: A Alterdata cadastra a empresa no Alterdata Market.
Geração de Credenciais: São gerados o ID da Loja e a Chave de Segurança. Sem esses dados, o hub da Tecnospeed não reconhece a origem dos dados vindos do seu ERP.

Ativação de Canais de Venda

Diferente de outros hubs, a primeira ativação de um canal (ex: Mercado Livre, Shopee) no Plug4Market exige uma ponte técnica:

Consulta Técnica: A implantação da Alterdata valida se o canal desejado está disponível e quais são os requisitos específicos (como atributos obrigatórios).
Configuração do Webhook: A Tecnospeed configura o Webhook que enviará as notificações de venda para o serviço ms-market da Alterdata. Isso garante que, quando um pedido cair no marketplace, ele apareça automaticamente no seu Gerenciador Alterdata Market.

Mapeamento de Regras de Negócio (No Hub)

Caso existam divergências que não podem ser resolvidas no Shop, a implantação acessa o painel da Tecnospeed para:

Sincronismo de Atributos: Validar o ciclo de atualização (que ocorre semanalmente). Se um atributo "Pai" exigido pelo marketplace não estiver subindo, a equipe técnica verifica no hub se a categoria folha está mapeada corretamente.
Gestão de Pedidos "Presos": Se um pedido foi faturado no Shop mas continua "Aberto" no marketplace, o passo a passo consiste em acessar o portal da Tecnospeed para forçar a atualização de status ou realizar a baixa manual via chave de acesso da NF-e.

Manutenção e Suporte

Inadimplência: Caso o serviço ms-market pare de responder, o primeiro passo é validar o contrato com a Alterdata. A inadimplência corta a comunicação entre o ERP e o hub da Tecnospeed.
Migração: Se você estiver migrando da Muven para a Tecnospeed, o passo a passo exige a limpeza total dos tokens antigos no hub para evitar duplicidade de pedidos.

Resumo para o usuário: Você fornece os dados e a Alterdata realiza a "conversa" técnica com o hub. Seu papel é garantir que, após essa configuração inicial, os produtos estejam na categoria folha e as NF-e sejam geradas com a chave de acesso correta no Shop.

Configurar a Empresa no Shop

📸 Definição dos dados da empresa na aba Integração com parceiros:

Unknown Attachment

No Shop, acesse Cadastros de Empresas e localize a aba Integração com parceiros.
Abra a aba Alterdata Market e marque a opção Trabalho integrado com o Alterdata Market.
Preencha Máquina integradora, ID da loja no Canal de Venda e Chave de segurança.
Clique em Instalar Integrador como serviço para instalar e executar o serviço Alterdata Integrador Market.
Clique em Abrir configurador, informe Nome do Servidor, Banco de Dados e Sistema, depois selecione Testar Conexão.
Com a conexão validada, configure as abas Tabela e Detalhe Tabela para realizar o De/Para das variações usadas pelo Shop e pela Tecnospeed.
Mapeie as variações de Grade, Cor e Tamanho conforme os valores disponíveis no cadastro do cliente e na parceira homologada.
Grave o cadastro. O atalho para gravar configurações é F9.

Nota: ao testar a conexão com sucesso, o sistema libera as abas de mapeamento. Se alguma combinação de variação não for encontrada na Tecnospeed, o item pode aparecer em vermelho e exigir ajuste pela Alterdata junto à parceira homologada.

Detalhamento de Campos — Configuração da Empresa

Campo	Onde fica no sistema	Objetivo
Máquina integradora	`Cadastros de Empresas > Integração com parceiros > Alterdata Market`	Identifica a máquina responsável por executar o serviço de integração com o Alterdata Market.
ID da loja no Canal de Venda	`Alterdata Market`	Relaciona a empresa do Shop à loja habilitada no canal de venda.
Chave de segurança	`Alterdata Market`	Chave gerada quando a loja é habilitada pela Alterdata para autenticar a integração.
Nome do Servidor / Banco de Dados / Sistema	`Abrir configurador`	Dados usados para validar a conexão entre o integrador e o ambiente do Shop.
Tabela	`Alterdata Market > Tabela`	Permite relacionar as variações internas do Shop aos padrões aceitos na integração.
Detalhe Tabela	`Alterdata Market > Detalhe Tabela`	Detalha os valores de Grade, Cor e Tamanho usados no De/Para.

Mapear produtos, imagens, atributos e categorias no Shop

📸 Definição dos dados do item na aba Middleware:

Unknown Attachment

No Shop, acesse Cadastro de Produtos e localize a aba Middleware.
Use o Conversor de Imagens para adequar as URLs ao padrão aceito pelo hub. A primeira imagem incluída será usada como principal no marketplace.
Na aba Dados Principais, marque a opção Integrado com middleware.
Informe Marca, Categoria, Descrição, dados de Dimensões e Entrega e Atributos Adicionais.
Na aba Alterdata Market, preencha os Atributos Pai exigidos pelo marketplace, como ocorre em canais como Mercado Livre.
Revise o mapeamento de Tabela para garantir que as variações do produto estejam compatíveis com o De/Para definido na empresa.
Vincule o produto obrigatoriamente à categoria folha. Exemplo: em Calça > Masculina > Jeans, vincule em Jeans.

Sucesso: após o mapeamento correto de imagens, atributos, variações e categorias, o produto fica apto para ser interpretado pela Tecnospeed e distribuído aos marketplaces conforme as regras do hub.

Nota: o sincronismo de atributos é definido pela Tecnospeed e pode ocorrer em ciclos semanais. Se o atributo não aparecer imediatamente no marketplace, aguarde o ciclo de atualização antes de abrir nova análise.

Detalhamento de Campos — Cadastro e Middleware

Campo	Onde fica no sistema	Objetivo
Conversor de Imagens	`Produtos > Middleware`	Converte URLs de imagem para o formato compatível com o hub. A primeira imagem será a principal.
Integrado com middleware	`Produtos > Dados Principais`	Indica que o item participa da integração com marketplaces.
Atributos Pai	`Produtos > Alterdata Market`	Define características obrigatórias exigidas por marketplaces específicos, como voltagem ou material.
Tabela	`Produtos > Tabela`	Associa variações internas do Shop, como Cor e Tamanho, aos padrões aceitos pela Tecnospeed.
Categoria	`Produtos > Geral`	Define o destino do produto. Deve ser sempre o nível mais baixo da estrutura, a categoria folha.

Acompanhar Pedidos e Faturamento no Gerenciador 4Middleware

📸 Gerenciamento dos pedidos no módulo 4Middleware:

Unknown Attachment

No Shop, acesse a aba Vendas / 4Middleware.
Monitore a chegada de novos pedidos na aba Middleware ou no Gerenciador Alterdata Market.
Considere que o retorno de pedidos ocorre por Webhooks: a Tecnospeed notifica o ms-market, e o pedido é criado no ambiente do Shop para acompanhamento e faturamento.
Gere obrigatoriamente a NF-e para o pedido antes de concluir o faturamento.
Confirme se a NF-e possui chave de acesso. Essa é uma regra técnica da Plug4Market/Tecnospeed para validar o faturamento.
Preencha Transportadora, Código de Rastreio e URL de Rastreamento para alterar o status para Despachado.
Ao marcar o pedido como Entregue, o sistema notifica automaticamente o comprador conforme os recursos disponibilizados pela Tecnospeed.

Erro: pedidos não podem ser faturados sem a geração da NF-e e sem a respectiva chave de acesso. A ausência dessa informação impede a validação do faturamento na plataforma.

Detalhamento de Campos — Pedidos e Faturamento

Campo	Onde fica no sistema	Objetivo
Webhook	Configuração técnica da integração	Permite o retorno de pedidos da Tecnospeed para o ms-market e, em seguida, para o Shop.
Chave de Acesso	`Gerenciador Alterdata Market > Faturamento`	Identificador da NF-e necessário para validar a venda junto ao marketplace.
Transportadora	`Gerenciador Alterdata Market > Logística`	Registra a empresa responsável pela entrega do pedido.
Código de Rastreio	`Gerenciador Alterdata Market > Logística`	Informação obrigatória para que o cliente acompanhe a entrega e o status avance para Despachado.
URL de Rastreamento	`Gerenciador Alterdata Market > Logística`	Link direto da transportadora para consulta do status da entrega.

Atalhos

Use os atalhos abaixo para agilizar a operação nas telas da integração:

Atalho	Ação	Quando usar
F9	Gravar	Ao finalizar configurações, mapeamentos ou alterações de cadastro nas telas do Shop.

Diagnóstico e resolução de problemas

Use a tabela abaixo para identificar a causa provável de divergências e aplicar a correção recomendada.

🎯 O que pode ser e como resolver?

Divergência	Causa provável	Ação corretiva
Pedido não fatura no Shop	Ausência da chave de acesso da NF-e.	Gere a nota fiscal eletrônica antes de concluir o faturamento do pedido.
Produto não integra	Vínculo em categoria intermediária.	Corrija o vínculo para a categoria folha, no último nível da árvore.
Atributos não atualizam no marketplace	Intervalo de sincronismo definido pela Tecnospeed.	Aguarde o ciclo semanal de sincronização ou revise o mapeamento na aba Alterdata Market.
Integração interrompida ou erro de login	Inadimplência no contrato do Shop.	Regularize a situação financeira para restabelecer o serviço ms-market.
Imagem não aparece no site	URL da imagem em formato incompatível.	Utilize o Conversor de Imagens na aba Middleware do cadastro de produtos.
Pedido faturado no Shop aparece aberto na plataforma	Falha na comunicação do Webhook ou status não atualizado.	Acesse o portal de gerenciamento da Tecnospeed para forçar a atualização, baixar ou cancelar o pedido, quando necessário.

Plataforma da Tecnospeed para integrar com o Shop

O cliente Alterdata não realiza a configuração de integração por conta própria dentro do painel da Tecnospeed. A ativação da conexão e dos canais de venda ocorre em conjunto com a Alterdata/DSN e a equipe de implantação.

Liberação inicial: o cadastro da empresa no Alterdata Market deve ser realizado pela própria Alterdata/DSN. Na Tecnospeed, a primeira ativação de canais de venda no Plug4Market pode exigir consulta prévia à consultoria técnica, enquanto as demais etapas seguem o fluxo definido pela Software House.
Configuração da integração: ocorre pelas telas do Shop, conforme o fluxo descrito neste documento.

O foco operacional do cliente é nas telas do Shop. Questões de contas, canais e regras diretamente no hub da Tecnospeed devem ser tratadas em conjunto com a implantação da Alterdata.

Aviso de ecossistema: a integração Plug4Market faz parte do ecossistema Alterdata e depende do serviço ms-market para conectar a operação de e-commerce à gestão de estoque, pedidos e faturamento do Shop.