Nesse artigo você vai aprender
Como conectar o Pontta à sua loja na Shopify, como os produtos do Pontta viram produtos e variantes na loja (o de-para), como enviar os preços de uma tabela de preço e como o saldo de estoque é atualizado na Shopify. No fim, há um resumo de como os pedidos da loja chegam ao Pontta.
Descrição
Na integração com a Shopify, o Pontta é a origem do catálogo. Ele cria os produtos na loja a partir de uma tabela de preço, envia o preço de venda de cada item e mantém o estoque disponível atualizado. Os pedidos feitos na loja voltam para o Pontta como pedidos de venda.
Antes de começar, vale saber três coisas que mudam a forma de trabalhar:
- O Pontta não vincula produtos que já existem na loja: o Pontta sempre cria o produto e as variantes na Shopify. Não existe tela para ligar um item do Pontta a um produto que já está cadastrado na loja.
- Preço só vai para a loja quando você manda: alterar um preço no Pontta não muda nada na loja até alguém clicar em enviar.
- O estoque é automático: toda entrada, saída, recontagem ou reserva atualiza a loja sozinha, sem botão.
Sumário
Utilize os links abaixo para ir diretamente à seção desejada:
- Pré-requisitos
- 1. Conectar a loja
- 2. Configurar o de-para de variáveis e características
- 3. Ligar uma tabela de preço à Shopify
- 4. Enviar os produtos e os preços
- 5. Ligar o estoque à Shopify
- 6. Configurar o recebimento de pedidos
- Acompanhar logs e falhas
- Dúvidas frequentes
Pré-requisitos
- Módulo Marketplace no plano e o canal Shopify liberado na assinatura. A liberação é feita pela Pontta; peça ao seu consultor ou ao suporte.
- Permissão Integração com marketplace (em Administração > Vendas) no papel de quem vai configurar.
- Permissões Ajustar marketplace da tabela de preço e Integração com marketplace (Estoque) para quem vai cuidar da tabela de preço e do estoque.
- Um app criado na sua loja Shopify, com o Admin API access token copiado.
- Uma tabela de preço com os itens que você quer vender na loja, cada um com código preenchido.
Consulte também: Editar permissões do papel de colaborador
1. Conectar a loja
Acesse Administração > Marketplace > Integração com o marketplace. A tela mostra uma aba para cada provedor liberado na assinatura. Abra a aba Shopify.
A configuração vale para a unidade de negócio em que você está logado. Se você vende em mais de uma unidade, configure cada uma.
1 - Na seção Autenticação, preencha a URL da sua loja no Shopify, no formato https://sualoja.myshopify.com, sem barra no final.
2 - Em Access token, cole o token do app. O ícone de ajuda da seção mostra o caminho na Shopify: Settings > Apps and Sales Channels > Develop apps for your store > Create an App > API credentials.
3 - Em Versão API, escolha 2023-01 (é a única opção).
4 - Clique em Salvar. Aparece Configuração atualizada.
5 - Clique em Testar integração. O selo ao lado muda de Aguardando teste para Integrado com sucesso ou Configuração incorreta.
Nota: o botão Testar integração só aparece depois de salvar. Se o selo mostrar Configuração incorreta, confira primeiro a URL: com barra no final ou sem https:// o Pontta não encontra a loja.
Nota: ao salvar, o Pontta apaga e recria na Shopify os avisos (webhooks) que avisam o Pontta de pedidos novos. Por isso, salve a configuração de novo sempre que trocar o token.
2. Configurar o de-para de variáveis e características
Na Shopify, um produto tem até três opções (por exemplo Cor, Tamanho e Acabamento) e cada combinação é uma variante. No Pontta, essas opções vêm das variáveis e das características dos produtos e customizáveis. O de-para diz qual variável ou característica do Pontta vira qual opção na loja.
Ainda na aba Shopify:
1 - Em Criar variáveis para marketplace, clique em Adicionar variável para marketplace e crie os nomes das opções como devem aparecer na loja (Cor, Tamanho...). Esses nomes são padronizados para todos os produtos.
2 - Em Configuração de variáveis (de/para) marketplace, ligue cada variável do Pontta (coluna de: variavel) a uma opção da loja (coluna para: marketplace).
3 - Em Configuração de características (de/para) marketplace, faça o mesmo com as características (coluna de: característica).
Esse de-para vale para todos os produtos. Se um produto ou customizável precisar de um de-para diferente, abra o cadastro dele e use o menu Integração com marketplace. Lá também ficam a Descrição do produto no marketplace, o Fornecedor e o Tipo do produto que vão para a loja.
Nota: a Shopify aceita no máximo três opções por produto, e o Pontta não confere esse limite. Mapeie no máximo três variáveis e características para o mesmo produto.
Nota: toda variável mapeada precisa ter valor no item. Se um item da tabela não tiver valor para uma variável do de-para, o envio falha com a mensagem "O negociável ... tem a variável ... que esta configurada para envio no marketplace. porém não foi definido valor a ela."
Como cada coisa aparece na loja
- Produto: cada produto ou customizável do Pontta vira um produto na Shopify, com o nome do cadastro.
- Variante: cada item da tabela de preço vira uma variante desse produto.
- SKU: o código do item na tabela de preço. É por ele que o Pontta reconhece a variante depois, inclusive no estoque.
- Imagens: as imagens que você marcar no item (veja a etapa 4).
3. Ligar uma tabela de preço à Shopify
Acesse Administração > Vendas > Tabelas de preço e abra a tabela que vai abastecer a loja.
1 - No menu da tabela, clique em Integração com marketplace.
2 - Na janela Integrar lista de preço com marketplaces, escolha Shopify em Marketplaces e salve.
3 - A tabela passa a mostrar o chip Shopify em Marketplaces integrados, e os itens ganham a coluna Marketplace com a situação de cada um.
A coluna Marketplace pode mostrar:
- A Sincronizar: o item ainda não foi enviado.
- Sincronizado: o item já existe na loja.
- Sem Configuração: o item está marcado como Somente uso interno e não pode ir para a loja.
Nota: Sincronizado quer dizer que o produto já foi criado na loja, não que o preço está em dia. Depois de mudar um preço, o item continua como Sincronizado até você enviar de novo.
Só entram na loja itens de produto e de customizável. Itens de móvel solto ficam de fora sem nenhum aviso.
4. Enviar os produtos e os preços
O envio é sempre manual. Há dois caminhos:
A tabela inteira
1 - Com a tabela aberta, clique no botão flutuante Enviar alterações para o marketplace.
2 - Confirme em Deseja realmente sincronizar com o Marketplace?
3 - Aparece Lista de preço integrada com marketplace com sucesso.
Nota: essa mensagem aparece mesmo que alguns itens falhem. Depois de enviar, confira o contador de falhas na própria tabela ou a tela Falhas de integração marketplace.
Um item só
1 - No menu do item, clique em Configurar marketplace e marque as Imagens para marketplace. Se aparecer Não existem imagens cadastradas no produto, cadastre as imagens no produto antes.
2 - No mesmo menu, clique em Integrar com marketplace. Aparece Integração concluída.
Qual preço vai para a loja
Vai o preço de venda do item nessa tabela, do jeito que o Pontta calcula. Não há fator, arredondamento nem preço "de/por" (compare at price) próprios da integração. Se você quer um preço diferente na loja, use uma tabela só para ela.
Retirar um item da tabela
Retirar o item da tabela apaga só a ligação dentro do Pontta. O produto continua na Shopify, e você precisa excluí-lo lá se não quiser mais vendê-lo. A confirmação avisa: a remoção é irreversível. Se o item voltar para a tabela depois, o Pontta cria a variante de novo na loja.
5. Ligar o estoque à Shopify
Acesse Administração > Estoque > Estoque.
1 - No menu do estoque que vai abastecer a loja, clique em Configurar marketplace.
2 - Na janela Integrar com marketplaces, escolha Shopify em Marketplaces e salve. O estoque ganha o ícone Estoque configurado para marketplace.
3 - Para enviar o saldo atual de uma vez, use no mesmo menu a opção Integrar com marketplaces. Aparece Estoque integrado com marketplace com sucesso.
A partir daí, a loja é atualizada sozinha a cada entrada, saída, recontagem, devolução ou reserva de estoque.
Qual quantidade vai para a loja
- Quantidade: saldo atual menos o reservado. Nunca vai número negativo.
- Casas decimais: a Shopify recebe só números inteiros; 2,7 vira 2.
- Local na Shopify: o saldo vai para o primeiro local (Location) cadastrado na loja.
- Ligação com o produto: o item do estoque é encontrado pelo código, que precisa ser igual ao SKU (código do item na tabela de preço).
Nota: o estoque só é enviado para itens que já foram criados na loja pela tabela de preço. Se o código do item de estoque não bater com o SKU, aparece a falha "Não foi possível preparar o estocável ... pois não existe nenhum produto previamente integrado que tenha o mesmo code(SKU)".
Nota: ligue só um estoque à Shopify. Com dois estoques ligados, os dois escrevem no mesmo local da loja e vale o último saldo enviado, não a soma.
6. Configurar o recebimento de pedidos
Os pedidos da loja chegam ao Pontta sozinhos assim que são criados na Shopify. Para isso, o Pontta precisa saber com que dados montar o pedido de venda. Na aba Shopify:
1 - Clique em Configurações do pedido de venda. Enquanto não houver configuração, a tela mostra Configurações do pedido de venda não cadastradas.
2 - Preencha Usuários para notificação, Responsável, Política de negociação, Condição de pagamento, Prazo de entrega (dias) e Forma de pagamento padrão. O Fluxo de trabalho é opcional.
3 - Em Mapeamento das formas de pagamento, escreva em Forma de pagamento no Marketplace o nome do meio de pagamento da Shopify e escolha a Forma de pagamento no Pontta correspondente.
4 - Salve. Aparece Configurações do pedido de venda salvas com sucesso.
Cada pedido da loja vira um Pedido de venda (não um orçamento) com:
- Identificação: o número do pedido na Shopify (#1001) como nome do cliente final, as tags e a observação.
- Cliente: procurado pelo e-mail. Se não existir, o Pontta cadastra o cliente.
- Itens: o preço praticado na loja, não o da tabela. Item que a loja vende mas não veio do Pontta entra com o nome, o SKU e o preço da Shopify, na unidade UN.
- Valores e prazo: frete e desconto da Shopify; data de entrega = data do pedido + Prazo de entrega (dias).
Se algum pedido não chegou, use o botão Atualizar pedidos de venda na lista de pedidos de venda. Ele busca os pedidos em aberto na Shopify e não duplica os que já existem.
Nota: se a criação do pedido falhar, os Usuários para notificação recebem um aviso e um e-mail com o assunto "Falha ao tentar receber o pedido de venda do marketplace". O motivo fica na tela de falhas.
Acompanhar logs e falhas
Em Administração > Marketplace há duas telas além da configuração:
- Logs de integração marketplace: mostra tudo o que foi enviado e recebido.
- Falhas de integração marketplace: mostra o que deu errado, separado por tipo: Pedido de venda, Item de tabela, Imagem do item de tabela, Webhook e Item de estoque. Dá para filtrar por Código do item no Pontta ou ID de integração do Marketplace.
Depois de corrigir a causa, reenvie o item ou o estoque e clique em Marcar como resolvido. Para pedidos, existe também Atualizar integração do pedido de venda.
Dúvidas frequentes
O menu Marketplace não aparece em Administração.
Falta o módulo Marketplace no plano ou a permissão Integração com marketplace no papel do colaborador. A aba Shopify só aparece se o canal Shopify estiver liberado na assinatura.
Já tenho os produtos cadastrados na Shopify. Como ligo ao Pontta?
Não dá para ligar. O Pontta sempre cria o produto na loja ao enviar a tabela. Se você enviar uma tabela com itens que já existem na Shopify, eles ficam duplicados. Combine com o suporte antes de integrar uma loja que já tem catálogo.
Mudei o preço no Pontta e a loja continua com o preço antigo.
O preço não é enviado sozinho. Abra a tabela de preço e clique em Enviar alterações para o marketplace.
O estoque da loja está diferente do saldo no Pontta.
A loja recebe o disponível, ou seja, o saldo menos o que está reservado para pedidos e ordens. Confira as reservas do item. Se a diferença for outra, use Integrar com marketplaces no menu do estoque para reenviar o saldo de todos os itens.
O item não aparece na loja depois de enviar a tabela.
Confira na coluna Marketplace se o item está como Sem Configuração (uso interno) e na tela de falhas se o envio deu erro. Itens de móvel solto não são enviados.
Aparece "Integração com Shopify não configurada".
A unidade de negócio em que você está não tem a autenticação salva. Cada unidade tem a sua configuração.
Aparece Mercado Livre ou Madeira Madeira na lista de marketplaces.
Esses canais existem no cadastro, mas a integração com eles ainda não está disponível. Hoje só a Shopify envia e recebe dados.