Para enviar um produto do Sellivo para a tua loja WooCommerce, basta guardares três dados uma única vez: o URL da loja (tem de começar por https://), uma Consumer Key e um Consumer Secret, que geras no WooCommerce em Definições → Avançado → API REST com a permissão Leitura/escrita. A partir daí envias cada produto importado com um clique, como tarefa em segundo plano — com imagens e, se existirem, como produto variável com todas as suas variações. Um novo envio atualiza o produto existente em vez de criar um segundo ao lado.
Ligar o WooCommerce, sem instalação e sem aprovação
O WooCommerce é o canal mais simples do Sellivo. Não há processo de instalação, não há revisão de aplicação e não há aprovação por que tenhas de esperar. Guardas duas credenciais uma vez e, a partir daí, cada produto segue com um clique.
O canal foi construído de propósito como canal complementar. Acrescenta-se ao envio para a Shopify, mas não cobre todos os seus detalhes. O que falta está dito sem rodeios mais abaixo, na secção sobre os limites: lê-a antes do primeiro envio, para não ficares à espera de uma sincronização de stock que no WooCommerce não existe.
Ligar passo a passo: três dados
A ligação configura-se no perfil da loja, em «Ligação ao WooCommerce». Se trabalhas com a aplicação Shopify integrada, encontras o mesmo cartão no separador Definições.
Primeiro, o URL da loja: o endereço da tua loja WooCommerce, por exemplo https://a-minha-loja.pt. Tem de começar por https://. Um endereço http:// é recusado, e por um motivo concreto: as credenciais seguem em cada pedido como Basic Auth e, numa ligação sem encriptação, viajariam em texto simples.
Segundo e terceiro, a Consumer Key (começa por ck_) e o Consumer Secret (começa por cs_). Geras ambos na tua loja em WooCommerce → Definições → Avançado → API REST. O que é decisivo aí é a permissão Leitura/escrita: com acesso apenas de leitura, o Sellivo não consegue criar produtos.
Ao guardar, o Sellivo verifica ainda se o URL da loja aponta para um endereço real e publicamente acessível; endereços internos ou locais são recusados. As credenciais ficam guardadas de forma encriptada (AES-256-GCM) e nunca são devolvidas ao navegador. Depois de ligares, só vês o URL da loja e um botão para desligar.
Se aparecer um erro ao ligar, quase sempre é por causa de um destes três pontos: http em vez de https, uma gralha no URL, ou uma chave apenas com permissão de leitura.
Enviar um produto e perceber o que aconteceu
O envio corre como tarefa em segundo plano. Na aplicação Shopify integrada encontras, depois da importação, o botão «Publicar também no WooCommerce»; a partir da aplicação web inicias o envio produto a produto.
Se o canal não estiver ligado ou a configuração estiver incompleta, não é enviado absolutamente nada. Em vez disso, o Sellivo cria um registo com o estado «blocked» e indica o motivo. Não há, portanto, envios pela metade a seguir aos quais tenhas de ir à loja verificar o que chegou de facto.
Cada tentativa — bem-sucedida ou não — fica no histórico de envios do produto, juntamente com o número de imagens e variações transferidas e a indicação de se foi uma criação ou uma atualização. Este histórico é o sítio mais fiável para perceber uma falha.
O que chega à tua loja WooCommerce
O Sellivo constrói primeiro um modelo neutro em relação ao canal a partir do teu produto e depois mapeia-o para a API REST do WooCommerce. São transferidos o título, a descrição em HTML, a descrição SEO como descrição curta, o preço e o SKU, além das imagens e das opções de variante. A correspondência exata está na tabela mais abaixo.
O produto é sempre criado com o estado publish — de momento não existe modo de rascunho para o WooCommerce. Se quiseres rever um produto antes de ele ficar online, fá-lo no Sellivo, antes de iniciares o envio.
Nas imagens há uma particularidade que convém conhecer: o WooCommerce descarrega as imagens por conta própria a partir do URL. Por isso o Sellivo só transmite endereços publicamente acessíveis. As imagens de IA, que internamente existem como objeto de dados, são disponibilizadas através de um endereço público do Sellivo no formato https://www.sellivo.app/api/media/<id>, para que a tua loja as possa ir buscar. Seguem as imagens originais e as imagens de IA aprovadas; os rascunhos de IA por confirmar ficam de fora.
Os produtos variáveis chegam com as suas variações
É aqui que o WooCommerce difere tecnicamente da Shopify, e o Sellivo tira-te o trabalho das mãos. Primeiro o sistema determina os verdadeiros eixos de variante: apenas as opções que têm efetivamente mais do que um valor. Se o teu produto tem três cores, mas todas em tamanho M, então «cor» é um eixo e «tamanho» não é. É intencional, porque de outra forma uma variação ficaria presa a uma característica igual para todas.
Havendo pelo menos um eixo, o Sellivo cria o produto como produto variável e inscreve os eixos como atributos de variação visíveis. O preço passa então para as variações em vez de ficar no produto principal — é assim que o WooCommerce o espera. Depois, as variações individuais são acrescentadas num segundo passo, cada uma com o seu preço e o seu SKU. Isso exige chamadas separadas, porque a API REST do WooCommerce não consegue criar produto e variações de uma só vez.
Não havendo nenhum eixo, nasce um produto simples com preço e SKU diretamente no produto. O SKU fica de propósito ou no produto simples ou nas variações, nunca em ambos: no WooCommerce um SKU só pode existir uma vez em toda a loja.
Dois tipos de variações são ignorados: as que têm uma combinação de características incompleta e as que repetiriam uma combinação já existente. O WooCommerce recusa os duplicados de qualquer forma. Se só parte das variações passar, o Sellivo dá o envio como bem-sucedido com uma nota do género «2 de 6 variações falharam». Se não passar uma única variação, o envio conta como falhado, mesmo com o produto já criado — para saberes que está uma ficha incompleta na loja.
Enviar de novo é atualizar, não duplicar
O Sellivo guarda o ID de produto do WooCommerce do último envio bem-sucedido. No envio seguinte esse ID vai junto e o adaptador atualiza o produto existente em vez de criar um novo. Sem essa lógica, ao fim de três envios terias o mesmo produto três vezes na loja.
Ao atualizar um produto variável, as variações existentes são primeiro removidas e depois criadas de novo. Também isso é propositado: caso contrário, o WooCommerce manteria simplesmente as variações antigas e, após uma mudança de sortido, terias na loja tamanhos ou cores que já nem existem. Se o Sellivo não conseguir apagar as variações antigas, o envio conta ainda assim como bem-sucedido, mas com a nota «produto atualizado, variações antigas não removidas».
Se uma atualização falhar, o Sellivo mantém o ID de produto conhecido no registo. A tentativa seguinte volta portanto a atualizar e não gera um segundo produto.
Se apagaste o produto na loja de destino
É o caso que muitos sistemas resolvem mal. O Sellivo procede assim: a tentativa de atualização cai no vazio, o WooCommerce responde «não encontrado» (HTTP 404). Em vez de falhar para sempre contra esse ID morto, o Sellivo cria o produto uma única vez de novo e transfere depois as variações como num primeiro envio. Voltas assim a ter um produto a funcionar na loja, com um novo ID do WooCommerce que passa a ser usado para as atualizações seguintes.
Isto vale expressamente só para «não encontrado». Outros erros — credenciais erradas, permissões expiradas, erros de servidor — são comunicados como falha e não são tapados por uma criação silenciosa.
Limites que deves conhecer de antemão
Como o WooCommerce foi construído como canal complementar, há aqui algumas coisas que existem para a Shopify e aqui não. Não há sincronização de preços nem de stock: a comparação diária com a página de origem escreve as alterações de preço apenas para a Shopify. Se o teu preço de compra mudar, ajustas o produto no Sellivo e envia-lo outra vez para o WooCommerce.
Também não há verificação de qualidade prévia. Ao contrário do envio para a Shopify, o Sellivo não verifica antes do envio para o WooCommerce se o controlo de qualidade foi passado. Executa-o tu antes, se isso for importante para ti.
Não são transferidos os stocks, a atribuição de categorias e as etiquetas — isso manténs no WooCommerce. Ficam igualmente de fora o preço comparativo e o GTIN, ou seja, preços riscados e códigos de barras, bem como os metacampos com o URL de origem e os valores de conformidade que acompanham o envio para a Shopify. Proteção do catálogo e exportação CSV não existem para este canal.
Por cada loja Sellivo podes guardar exatamente uma loja WooCommerce. Se desligares a ligação, ela passa a «desligada» e os envios seguintes ficam bloqueados. Os produtos já transferidos permanecem intactos no WooCommerce.
| Campo no Sellivo | Campo no WooCommerce | Nota |
|---|---|---|
| Título | name | É sempre transferido. |
| Descrição (HTML) | description | A formatação mantém-se. |
| Descrição SEO | short_description | Aparece no WooCommerce como descrição curta. |
| Preço | regular_price | Apenas em produtos simples; no produto variável o preço fica na variação. |
| SKU | sku | Ou no produto simples ou nas variações, nunca em ambos. |
| Imagens | images (origem e texto alternativo) | Apenas URL publicamente acessíveis; imagens de IA aprovadas via /api/media/<id>. |
| Opções de variante | attributes | Só as opções com mais do que um valor se tornam eixo de variação. |
| Stock, categorias, etiquetas | — | Não são transferidos; manténs isso no WooCommerce. |
| Preço comparativo e GTIN | — | Preços riscados e códigos de barras não seguem. |
| Metacampos (URL de origem, conformidade) | — | Só no envio para a Shopify, não no WooCommerce. |
No envio para o WooCommerce o estado do produto é sempre publish — de momento não existe modo de rascunho para este canal.
FAQ
Preciso de um plugin adicional para o WooCommerce?
Não. O Sellivo usa a API REST que já vem incluída no WooCommerce. Aí só tens de gerar uma chave em WooCommerce → Definições → Avançado → API REST e introduzir a Consumer Key e o Consumer Secret no Sellivo.
Porque é que o URL da minha loja é recusado?
O URL tem de começar por https:// — por http as credenciais seguiriam como Basic Auth em texto simples. Além disso, o Sellivo verifica se o endereço é publicamente acessível; endereços internos ou locais são recusados. O terceiro motivo frequente é uma chave apenas com permissão de leitura em vez de Leitura/escrita.
Cada envio cria um produto novo na loja?
Não. O Sellivo guarda o ID de produto do WooCommerce do último envio bem-sucedido e usa-o para atualizar o produto existente. Se o apagaste no WooCommerce, o Sellivo percebe-o pela resposta «não encontrado» e cria-o uma única vez de novo.
Os stocks e os preços são sincronizados continuamente?
Não. A comparação diária com a página de origem escreve as alterações de preço apenas para a Shopify, e o canal WooCommerce não transfere stocks de todo. Se mudares alguma coisa, ajustas o produto no Sellivo e envia-lo outra vez.
As variações de cor e tamanho chegam à loja?
Sim. Se o teu produto tiver pelo menos uma opção com vários valores, o Sellivo cria-o como produto variável e acrescenta as variações num segundo passo — cada uma com preço e SKU. As opções que têm o mesmo valor em todas as variações não se tornam eixo de variante, e isso é intencional.
Posso ligar várias lojas WooCommerce?
Por cada loja Sellivo podes guardar exatamente uma loja WooCommerce. Se desligares a ligação, os envios seguintes ficam bloqueados; os produtos já transferidos permanecem intactos no WooCommerce.
As minhas imagens de IA também são transferidas?
As imagens de IA aprovadas sim, os rascunhos por confirmar não. Como o WooCommerce descarrega as imagens por conta própria a partir do URL, o Sellivo disponibiliza as imagens de IA num endereço público no formato https://www.sellivo.app/api/media/<id>.
Do link do produto direto para a tua loja WooCommerce
Guarda uma vez o URL da loja, a Consumer Key e o Consumer Secret — depois cada produto sai com um clique, com imagens e variações.
Experimentar grátis