GoDeep - Documentação
HomeB2BB2CHUBAplicativoAPIs
HomeB2BB2CHUBAplicativoAPIs
  1. Marketplaces
  • Marketplaces
    • Marketplace F1
    • Amazon
    • Mercado Livre
  • Configurações gerais
    • Erro ao criar produto no Mercado Livre – B2C
  1. Marketplaces

Marketplace F1

Conteúdo em desenvolvimento...



O Marketplace F1 é um módulo que transforma a sua loja em um marketplace, podendo fazer a integração de dados com outras loja dentro da GoDeep.
O processo de ativação e configuração do Marketplace F1 deve ser realizado
Fluxo da integração de dados entre o Marketplace F1 e as Lojas.
Este documento será divido em 2 blocos, o primeiro bloco vamos falar da criação e configuração do seller dentro do painel de MKP F1. No segundo bloco vamos falar da criação e configuração do MKP dentro do painel de Seller.

Requisitos#

Para iniciar esse processo de configuração, é necessário que que os dois ambinetes já estejam liberados. Um que será o Marketplace F1 e ou Será o
SELLER = Será o a loja base (HUB ou B2C) que irá armazenar todas os dados dos produtos (textos, imagens, estoque, preço).
MARKETPLACE F1 = Será a loja que vai recerber os produtos vindos do SELLER.

CONFIGURAR O MKP F1#

1
Passo 1
O usuário F1(time GoDeep), deve acessar o ambiente de MKP F1 do cliente www.seudominio.com.br/admin, ir à tela de módulos e habilitar o “Módulo Marketplace F1”.
image.png
Obs.: Caso o módulo “Lojas HUB” esteja habilitado, ele precisa ser desmarcado.
image.png
2
Passo 2
Qualquer usuário Admin, acessar a tela “Sistemas > Agendamentos (Crontab)”, verificar se as crons foram criadas. Deixar ativo apenas as crons “Marketplace.f1.buybox” e “marketplace.f1.pedidos.status”
image.png
3
Passo 3
Qualquer usuário Admin, acessar a tela “Configurações > Gerais > Aba Marketplace F1”, e configurar os dados conforme orientações abaixo.
image.png
1.
Produtos > Atributo de matching Colocar “EAN”
2.
Produtos > Responsavél pela edição do cadastro de produto Colocar “Seller”.
3.
Produtos > Atualizar o preçodo produto mesmo se ele estiver inativo Deixar o campo “Marcado”.
4.
Categorias > Bloquear alteração na árvore de categorias Deixar “Desmarcado”.
5.
Frete > Ativar todas as formas de entrega do Seller Deixar o campo “Marcado”.
6.
Categorias > Permitir atualização de cataegorias pelo Seller Deixar o campo “Marcado”.
7.
Cliente > Conta para Comissão Deixar em “Branco”.
8.
Cliente > Taxa de Comossão % Deixar em “Branco”.
9.
Status > Aguardando Pagagamento Marcar todos os Status criados no Admin do MKP que são considerados como pedidos ainda aguarando pagamento.
10.
Status > Aprovado Marcar todos os Status criados no Admin do MKP que são considerados como pedidos com pagamento aprovado.
11.
Status > Caneclado Marcar todos os Status criados no Admin do MKP que são considerados como pedido cancelado.
12.
Status > Faturado Selecionar o Status criado no Admin do MKP que é considerado como pedidos com nota fiscal emitida.
13.
Status > Enviado Selecionar o Status criado no Admin do MKP que é considerado como pedido expedido.
14.
Status > entregue Selecionar o Status criado no Admin do MKP que é considerado como pedido Entregue.
Depois de configurar todos os dados, clicar em “SALVAR”. Lembrando que é importante primeiro rever todos os status que serão usados no projeto, para evitar de esquecer a configuração de algum status.
4
Passo 4
As categorias não são integradas pelo seller, então primeiro é preciso criar manualmente no Admin, qual será a estrutura de categoria do MKP F1. Qualquer usuário Admin, acessar a tela “Produtos > Categorias”.
Do lado esquerdo em “Categorias”, clicar com o botão direito do Mouse e depois em criar, será aberto uma modal para ser digitado o nome da Categoria. Repetir esse processo até que todas as categorias que deseja estejam criadas (Categoria e Subcategoria), esse passo será importante porque o Seller vai precisam fazer um De > Para dessas categorias o seu painel.
image.png
5
Passo 5
Qualquer usuário Admin, acessar a tela “Sellers”, se for um projeto novo, excluir quaisquer sellers que já aparece listados na tela. Para excluir o Seller só clicar no ícone “x” e confirmar a exclusão. Agora se for um projeto já existente e precisa criar mais sellers, só seguir os próximos passos.
image.png
6
Passo 6
Ainda no menu de “Sellers”, clicar em em “CADASTRAR”.
image.png
Vai abrir uma tela com varias abas para serem preenchidos conforme orientação abaixo:
1.
Na aba “Seller”, preencher com campos (Nome, URL do Seller, Status, Utilizar Medidas).
Nome  Digitar o nome que gostaria de chamar o Seller que está cadastrando.
URL  Colocar a URL do HUB que será conectado, o padrão da URL é sem o /admin
Status  Marcar como Ativo
Utilizar medidas/peso do MKP  Serve para vc ignorar o envio das dimensões e peso dos produtos vindos do Seller e considerar só o que for colocado no MKP.
image.png
2.
Na aba Pagamento  Preencher conforme manual corresnpondente. Só aplicável a projetos com Front.
3.
Na aba Geolocalização  Preencher conforme manual correspondente. Só aplicável a projetos com Front.
4.
Na aba Gerais  Preencher com os nomes que serão exibidos no Front. Só aplicável a projetos com Front.
Razão Social:
Endereço:
CNPJ:
Número de WhatsApp:
Horário de Atendimento:
Telefone SAC:
Logo
5.
Na aba Redes Sociais  Preencher com a URL da respectiva rede social. Só aplicável a projetos com Front.
6.
Na aba Scripts  Será listado os scripts que estiverem selecionados para o respectivo Seller. Só aplicável a projetos com Front.
Depois de preencher todos os dados necessários, clicar no botão de “SALVAR”. A tela será carregada com os dados de autenticação do seller que serão necessários para consiguração no painel de HUB do seller.
Os dados que serão utilizados serão o “Seller ID” e o “Token”.
image.png

CONFIGURAR O SELLER#

1
Passo 1
O usuário F1, deve acessar o ambiente do Seller do cliente www.seudominio.com.br/admin, ir à tela de módulos e habilitar o “Módulo Marketplace F1 Seller”.
image.png
2
Passo 2
Qualquer usuário Admin, acessar a tela “Sistema > Agendamentos (Crontab)”, e verificar se as crons “Marketplace F1 Seller” foram criadas. Deixar todas ativas.
image.png
3
Passo 3
Qualquer usuário Admin, acessar a tela “Marketlaces > Marketplace F1 > Gerenciar Marketplace”. Ao abrir essa tela pela primeira vez, caso tenha listado algum Marketplace criado, precisa remover para não gerar conflitos.
Clicar em “CADASTRAR” e prencher os campos que estão nas Abas a esquerda conforme orientação.
1.
Aba Marketplace > Seller ID Colocar ID que foi gerado no passo 6, nesse exemplo foi o 2.
2.
Aba Marketplace > Nome Colocar o nome do MKP da sua escolha, nesse exempo coloquei.
3.
Aba Marketplace > Token Colocar o token que foi gerado no passo 6, nesse exemplo foi o 585f9339f6fa7e5cbf8c41cefb89e0c9
4.
Aba Marketplace > URL Marketplace Colocar a url padrão do Markeplace sem o “Admin”.
5.
Aba Marketplace > Status Deixar como “Ativo”
6.
Aba Marketplace > Lista de Produtos Aqui serpa selecionado o Seletor mix, com os produtos que serão enviados para o MKP F1. Neste momento é importante deixar sem nenhum seletor vinculado, porque ainda tem um passo importante a ser feito, que será descrito no passo 10. Depois de configurado, voltar aqui e escolher o seletor mix.
7.
Aba Configuração > Responsável por atualizar produtos Será preenchido automaticamente, baseado na configuração que foi feita no passo 3.b).
8.
Aba Configuração > Prioridade dos campos para integração com o Marketplace Colocar nessa ordem “EAN, COD_BARRAS”
9.
Aba Configuração > Campo de descrição no marketplace Colocar “DESC”.
10.
Aba Configuração > Campo de nome no marketplace Colocar “{NOME}”.
11.
Aba Configuração > Quantidade máxima de estoque Deixar em “Branco”.
12.
Aba Configuração > Estoque de segurança Deixar em “Branco”.
13.
Aba Configuração > Quantidade de produtos que permitem venda sem estoque Deixar em “Branco”.
14.
Aba Configuração > Enviar produtos separadamente Deixar em “Desmarcado”.
15.
Aba Configuração > Enviar produtos com estoque zero Deixar “Marcado”.
16.
Aba Fretes > Configuração de frete Não tem o que fazer apenas lista se tiver alguma integração com terceiros.
17.
Aba Status Pedidos > Configuração de Status de Pedidos  Fazer o De > Para entre os Status do Pedidos do MKP F1 e os que estão cadastrado no Seller.
Depois de preencher os campos conforme orientado, clicar no botão de “SALVAR”. Sera carrega a tela e está criando a conexão entre o o Seller e o MKP F1.
image.png
4
Passo 4
Qualquer usuário Admin, acessar a tela “Produtos > Categorias”. Neste momento será preciso fazer o De > Para entre as categorias do Seller, com as categorias do MKP que foram criadas no passo 4.
O De > Para poderá ser feito em qualquer nível, basta clicar na categoria com o botão direito, depois em “Editar”, será aberto do lado direito as configurações da categoria. Ir até o campo “Relacionar categoria com o Marketplace F1”, clicar no campo e serão carregadas todas as categorias que foram criadas no MKP, escolher a que melhor se adequar e clicar em “SALVAR”.
Repetir esse processo até que todas as categorias ou subcategorias do Seller estejam mapeadas. Sem isso feito as integrações não vão funcionar.
image.png
5
Passo 5
Depois que finalizar a configuração do De > Para das categorias, voltar no menu “Marketplaces > Marketplace F1 > Gerenciar Marketplace”. Clicar em Editar, na Aba Marketplace, agora sim deve ser selecionado o seetor mix.
Com o seletor escolhido, quando a cron executar, começará a mandar os produtos para o MKP F1.
Os produtos que sestão sendo enviados podem ser consultados na tela Marketplaces > Marketplace F1 > Produtos.
6
Passo 6
Quando os produtos estiverem sendo enviados para o MKP. Será necessário aprova-los, e paraisso atualmente existem duas possibilidades.
1.
Unitário Acessar o MKP F1 na tela “Produtos > Moderação”, nessa tela serão listados todos os produtos enviados pelo seller. Só clicar na Lupa, o produto será aberto.
image.png
No final da página, serão exibidas as opções:
Moderar Depois Não faz nada e deixa o produtona fila.
Rejeitar O produto não será aprovado e não ficara disponivel no MKP, também é possivel digitar uma mensagem com o motivo da reprovação. Essa mensagem será exibido para o seller.
Aprovar O produto será aprovado e ficará disponível para ser vendido no MKP F1.
image.png
2.
Lote Acessar o MKP F1 na tela “Sellers”, nessa tela clicar no ícone “Check”, desta forma todos os produtos serão aprovados sem fazer nenhuma validação
image.png
Modificado em 2025-07-02 19:52:12
Próxima página
Amazon
Built with