Este guia apresenta um passo a passo para conectar lojas WooCommerce ao GelatoConnect, permitindo que o fluxo de pedidos seja automatizado do WooCommerce diretamente para o seu fluxo de produção.
Pré-requisitos
Antes de começar a conectar uma loja WooCommerce ao GelatoConnect, certifique-se de que você já tem:
Configuração do cliente no GelatoConnect: O cliente que é proprietário da loja WooCommerce deve ser criado com o acesso ao Storefronts habilitado
Configuração WooCommerce compatível: WooCommerce versão 2.4.8 ou superior, com a API devidamente configurada
Acesso de administrador: O PSP (Provedor de Serviços de Impressão) ou o seu cliente deve ter acesso de nível de administrador à loja WooCommerce
Visão geral do processo de conexão
O processo de conexão envolve quatro etapas principais:
Preparação: Garantindo a configuração adequada no GelatoConnect e WooCommerce
Conexão da loja: Estabelecendo o vínculo entre WooCommerce e GelatoConnect
Configuração de produtos: Configurando produtos para impressão
Testando: Validando a integração com pedidos de teste
Vamos analisar cada etapa em detalhes.
Fase 1: Preparação no GelatoConnect e WooCommerce
1) Configure o seu cliente
Acesse a seção Clientes no menu de navegação à esquerda da sua conta GelatoConnect
Selecione o cliente que é proprietário da loja WooCommerce. Caso ainda não exista, adicione um novo cliente.
2) Decida se você quer dar ao seu cliente acesso à interface do Storefronts Connect
Storefronts Connect é a interface utilizada por PSPs e seus clientes para gerenciar vitrines B2C (incluindo WooCommerce), importações de CSV e lojas manuais.
Sem acesso à interface do Storefronts Connect:
Os PSPs são responsáveis por conectar novos produtos à loja WooCommerce
Seu cliente pode precisar entrar em contato com você para saber mais sobre o pedido
Você vai precisar de acesso de administrador à loja WooCommerce para autorizar a conexão
Com acesso à interface do Storefronts Connect:
Seus clientes podem adicionar novos produtos à loja WooCommerce deles quando quiserem
O seu cliente tem acesso ao histórico de pedidos e aos detalhes de rastreamento
Você não vai precisar de acesso de administrador à loja WooCommerce, mas seu cliente vai precisar autorizar a conexão
3) Acesse a interface do Storefronts Connect
Os PSPs podem acessar os Storefronts usando seus dados de login já cadastrados no GelatoConnect.
Para dar aos seus clientes acesso ao Storefronts Connect:
Acesse a seção Clientes no GelatoConnect
Selecione o cliente e, em seguida, vá até "Editar cliente" no canto superior direito
Ative a chave \"Habilitar vitrines\"
Informe o e-mail, o primeiro nome e o sobrenome do seu cliente
Ao clicar no botão "Adicionar administrador", um e-mail será enviado ao seu cliente com instruções de acesso
4) Prepare o seu catálogo de produtos
Antes de conectar a loja, garanta que você já configurou produtos no GelatoConnect
Você vai precisar criar modelos de produto e produtos do cliente usando esses modelos de produto.
Dentro de um Produto do Cliente, você pode definir qual cliente terá acesso a esse produto
5) Configure a sua loja WooCommerce
Para garantir que a sua loja WooCommerce esteja devidamente configurada para a integração com o GelatoConnect:
Verifique o acesso à WooCommerce REST API:
Verifique se o seu arquivo
.htaccesscontém:SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
Habilitar API REST Legacy:
No seu Painel de controle WooCommerce, acesse WooCommerce → Configurações → Avançado
Selecione a guia Legacy API
Marque a caixa para "Ativar a REST API Legacy"
Clique em Salvar alterações
Configure as Configurações de Links Permanentes:
Vá para Configurações → Links permanentes no seu painel de controle do WordPress
Em Configurações comuns, selecione qualquer opção, exceto Simples
Clique em Salvar alterações
Verifique a funcionalidade da API acessando
https://your-site-url-here.com/wc-api/v1/em seu navegador
Instale o plugin WooCommerce Legacy REST API (para WooCommerce 9.0+):
Acesse Plugins → Adicionar novo no seu painel de controle do WordPress
Procure por "WooCommerce Legacy REST API"
Instale e ative o plugin
Instale o plugin Gelato:
No seu painel de controle do WordPress, acesse Plugins → Adicionar novo
Pesquise por "Gelato"
Instale e ative o plugin Gelato Integration for WooCommerce
Atualize o plugin Gelato para uso na vitrine:
No seu painel de controle do WordPress, acesse Plugins → Editor de plugins
No menu suspenso no canto superior direito, selecione Gelato Integration for WooCommerce
No painel à direita, localize e abra includes → Connector → GelatoConnector.php
Encontre esta linha de código:
const GELATO_DASHBOARD_URL = 'https://dashboard.gelato.com';Substitua por:
const GELATO_DASHBOARD_URL = 'https://storefronts.gelato.com';Clique em Atualizar arquivo para salvar as suas alterações
Fase 2: Conectando uma loja WooCommerce
Para os lojistas (seu cliente)
Acesse o Storefronts
Acesse a seção Lojas:
Clique na guia "Lojas" no menu de navegação à esquerda
Clique no ícone do WooCommerce para iniciar o processo de conexão
Insira a URL da sua loja WooCommerce
Clique em "Continuar" para autorizar a conexão:
Você será redirecionado para a página de autenticação do WooCommerce
Faça login, se solicitado
Revise as permissões solicitadas pela Gelato
Clique em Autorizar para aprovar a conexão
Confirme a conexão:
Depois da autorização, você vai voltar para o painel de controle do Storefronts Connect
Verifique se a sua loja aparece na lista de lojas conectadas com o status "Conectado"
Para PSPs (Você)
Os passos para conectar uma loja WooCommerce como PSP são muito parecidos com os de conectar uma loja como seu cliente.
A principal diferença é que você também vai precisar escolher a quais instalações e a quais clientes a loja WooCommerce deve ser atribuída.
Fase 3: Configurando produtos
Depois que a loja estiver conectada, seus produtos no GelatoConnect precisam ser vinculados aos anúncios de produtos na loja WooCommerce. Existem três maneiras de conectar os produtos:
Método 1: Conectando produtos WooCommerce existentes
Se a loja já possui produtos que precisam ser produzidos pelo GelatoConnect:
Sincronizar produtos:
No painel de controle do Storefronts Connect, clique na loja WooCommerce conectada na lista de lojas
Clique no botão Sincronizar produtos no canto superior direito para buscar os produtos atuais da loja
Aguarde até que a sincronização seja concluída
Mapear produtos:
Após a sincronização, todos os produtos do WooCommerce aparecerão na guia Todos os produtos
Para cada produto que precisa ser produzido, clique no produto e depois clique no botão Conectar
Escolha o produto que você quer conectar no catálogo
Para produtos que exigem arquivos de design, você será direcionado para o Design Editor onde poderá fazer o upload de um arquivo de design
Clique em Conectar para salvar o mapeamento
Método 2: Como criar novos produtos no Storefronts Connect
Para criar novos produtos que serão publicados na loja WooCommerce:
Acesse a loja WooCommerce na lista de lojas
Clique no botão Adicionar produto no canto superior direito
Você pode adicionar um produto personalizado completamente novo ou selecionar um que já tenha sido adicionado a uma loja existente
Se estiver adicionando um novo produto individual:
Selecione um produto do Catálogo de produtos
Adicione um design usando o Design Editor
Configure os detalhes do produto (nome, descrição, preço)
Em seguida, publique o produto na loja WooCommerce
Método 3: conexão de produtos em massa
Para lojas com muitos produtos, você pode usar o recurso de operação em massa:
Exportar lista de produtos:
Acesse a página da loja no Storefronts Connect e clique em Operações em massa no canto superior direito
Selecione Conectar produtos usando arquivos
Clique em Exportar CSV e um arquivo CSV com todos os produtos da loja será baixado
Preencha o CSV:
Abra o CSV em um aplicativo de planilha
Para cada produto, adicione o seguinte nas colunas correspondentes:
UID do produto: O identificador do produto no GelatoConnect
URL do arquivo de design: URL para o arquivo imprimível de cada produto. Isso deve ser um hiperlink direto para o arquivo
Importar produtos mapeados:
Volte para Painel de controle e clique em Operações em massa
Digite o seu endereço de e-mail, clique em Fazer upload de CSV e escolha o seu arquivo CSV
Clique em Conectar produtos usando arquivos no canto superior direito
Fase 4: Testando a integração
Antes de confiar na integração para pedidos de produção, teste minuciosamente a conexão:
Faça um pedido de teste:
Acesse o site da loja WooCommerce
Compre um dos produtos mapeados. É recomendado usar um código de desconto para testes
Conclua o processo de finalização da compra
Verifique o recebimento do pedido:
Verifique se o pedido aparece no Storefronts Connect
Verifique se ele também aparece na página de gerenciamento de pedidos do seu painel de controle do GelatoConnect
Confirme se todos os detalhes do pedido estão corretos, incluindo:
Informações do cliente
Especificações do produto
Arquivos de design
Detalhes de envio
Acompanhe o pedido durante a produção:
Acompanhe o pedido de teste em todo o seu fluxo de produção
Verifique se as atualizações de status aparecem corretamente no Storefronts Connect e na área administrativa do WooCommerce
Cancelamento de pedido de teste (opcional):
Faça outro pedido de teste
Cancele pelo WooCommerce
Verifique se o cancelamento foi processado corretamente no GelatoConnect