Deixar a sua app grossista do Shopify ou WooCommerce

Resposta curta. Tirar o grossista de uma torrefação de uma app do Shopify ou de um plugin do WooCommerce e levá-lo para o Order Book, ou para qualquer ferramenta de encomendas, leva cerca de três semanas, e a app fica ligada até cada café ter encomendado uma vez no sítio novo. Exporte primeiro clientes e encomendas, renomeie as colunas segundo o modelo de importação, monte os preços como catálogos, passe os cafés em três vagas e remova a app e o código que deixou no tema no fim. A única exceção é um plugin fechado por um problema de segurança, que se desativa no primeiro dia.

O Order Book é um dos sítios para onde pode mudar-se, por isso leia a última secção a saber disso. Tudo o que vem antes vale seja qual for a ferramenta que escolher.

Devo deixar a minha app grossista?

Saia porque lhe está a custar encomendas, não porque uma avaliação o irritou. As razões que os torrefatores dão são as mesmas em apps e plugins, e repetem-se há anos:

• O checkout perde o preço grossista ou recusa a encomenda, e um café liga a perguntar porquê.
• Uma atualização da app ou do plugin estraga o tema ou o carrinho, quase sempre numa semana cheia.
• Dar a um café o seu próprio preço exige um plano acima do seu.
• Um pedido ao suporte demora dias, ou é fechado antes de o problema estar resolvido.
• A licença renova-se ao preço total, e quem sai perde os grupos de preços que lá montou.

Uma destas por ano é software. Três são um padrão, e não melhora com a próxima atualização, porque vem da maneira como estas apps funcionam: juntam o grossista a uma loja ao público com etiquetas de cliente e código no tema. As apps grossistas do Shopify comparadas e os plugins do WooCommerce comparados passam-nas uma a uma.

Há semanas em que não se começa: o seu mês de mais trabalho, a semana de um aumento de preços, a semana antes de fechar para férias. Três semanas calmas valem a espera, a menos que a secção seguinte seja consigo.

Se usa o Wholesale Market

O plugin Wholesale Market foi fechado no wordpress.org a 3 de agosto de 2026. O aviso na página dele dá como motivo "Security Issue", e um plugin fechado já não se pode transferir nem recebe correções. Desative-o já, antes de tudo o resto neste guia. Não o deixe a correr até a mudança acabar.

Ao desativá-lo, os preços grossistas desaparecem da sua loja, e um café que entre vê preços ao público. Nos dias de permeio, peça aos seus cafés que encomendem por telefone, email ou mensagem, e registe você essas encomendas. Depois faça os passos abaixo em dias e não em semanas: exportar, renomear e importar cabem numa tarde, e os cafés podem passar numa só vaga.

O que tirar, e onde está

Exporte tudo antes de mudar o que quer que seja, para uma pasta com a data. Nada nesta tabela exige que a app já tenha saído, e nada deve sair antes do fim.

Quando exporta mais de 51 encomendas, ou exporta por data, o Shopify envia a exportação por email em vez de a transferir logo. O WooCommerce faz o mesmo com um relatório do Analytics com mais de uma página, e envia-o ao administrador que o pediu. Comece os dois e vá torrar.

Renomear as colunas

A importação do Order Book lê um CSV com estes cabeçalhos, iguais em todas as línguas: date, client, item, quantity, unit_price, total, email. Só date e client são obrigatórios. Maiúsculas e minúsculas não contam, e um espaço vale como sublinhado, por isso Total e Email já coincidem. Qualquer outra coluna é ignorada, por isso pode deixar o resto da exportação como está. O modelo está na app, junto à importação, em Descarregar um modelo.

A partir de uma exportação de encomendas do Shopify

O Shopify exporta os nomes das colunas em inglês, por isso aparecem aqui tal como estão no seu ficheiro.

Uma verificação antes de renomear o que quer que seja. Algumas apps aplicam o preço grossista como desconto no checkout, e não como preço da linha. Nesse caso Lineitem price tem o preço ao público e o desconto está em Lineitem discount. Compare uma encomenda de um café com a fatura dele. Se não baterem certo, tire o desconto ao preço unitário antes de importar.

A partir de uma transferência de encomendas do WooCommerce

O relatório de encomendas do WooCommerce Analytics transfere uma linha por encomenda, com todos os produtos numa só célula. Renomeie a coluna da data para date, a do cliente para client e a das vendas líquidas para total, e apague a dos produtos. Cada encomenda entra então como uma linha com o seu total. Chega para a faturação e para o ritmo de cada café, mas não para as quantidades por café. Se um plugin de exportação já lhe dá uma linha por artigo, renomeie as colunas dele para o conjunto completo acima.

As quatro coisas que correm mal no ficheiro

Linhas vazias dentro de uma encomenda

O Shopify põe a segunda linha de uma encomenda, e as seguintes, nas linhas de baixo, com a data e o cliente vazios. A importação salta uma linha sem data ou sem cliente, sem avisar, por isso preencha essas duas colunas para baixo antes de gravar. Senão, cada encomenda chega só com a primeira linha.

Ponto e vírgula em vez de vírgulas

Uma folha de cálculo em português grava muitas vezes o CSV com ponto e vírgula. A importação só lê vírgulas, e um ficheiro com ponto e vírgula chega como uma única coluna e é recusado. Grave como "CSV UTF-8 (delimitado por vírgulas)", o que também resolve o ponto seguinte.

A codificação errada

O ficheiro tem de ser UTF-8. Uma exportação antiga de Windows ou Mac transforma "Café" em rabiscos, e a importação recusa-a em vez de adivinhar.

O café escrito de duas maneiras

Os clientes reconhecem-se pelo nome, sem olhar a maiúsculas. "Café Aurora" e "Cafe Aurora Lda" são dois clientes com meio histórico cada um. Ordene a coluna do cliente e leia-a uma vez de cima a baixo antes de importar.

As datas podem começar pelo dia, como 31/01/2026, ou vir como 2026-01-31. As linhas com a mesma data e o mesmo cliente formam uma encomenda. Uma encomenda com total negativo é um reembolso e fica de fora, e a importação diz quantos. Importar o mesmo ficheiro duas vezes não faz mal: as encomendas que já lá estão são saltadas.

Importar, e o que a importação não traz

O CSV traz duas coisas: os seus clientes, criados a partir dos nomes do ficheiro, e as encomendas passadas, marcadas como Entregue. Não traz produtos nem preços. Os artigos das encomendas passadas ficam como texto, tal como estavam escritos, e a coluna unit_price regista quanto custou cada linha passada, não o que um café paga daqui em diante.

1. Tire as contas mortas. Um café que não encomenda há seis meses é um contacto, não um cliente. Durante os 30 dias de experiência não há limite de clientes, mas num plano a importação inteira é recusada se o levar acima do limite do plano.
2. Importe o ficheiro. Em Clientes, com Importar um CSV com o histórico de encomendas. Um ficheiro até 25 MB entra de uma vez, e o resumo diz quantas encomendas entraram, quantos clientes foram criados e quantos duplicados foram saltados.
3. Adicione os seus produtos em Produtos, Artigos: cada café uma vez, com os tamanhos de saco.
4. Monte os preços como catálogos em Produtos, Catálogos. Faça um catálogo por cada grupo de preços que a app tinha, atribua-o aos cafés desse grupo e dê a um café o seu preço próprio nas linhas em que é diferente. Verifique cinco cafés contra a última fatura.

Se a sua loja Shopify já tem uma app personalizada criada antes de 2026, com um token de acesso que começa por shpat_, pode ligá-la em vez de usar um CSV. Lê os seus produtos e as encomendas de uma empresa B2B do Shopify ou com etiqueta grossista, e não escreve nada no Shopify. Desde 1 de janeiro de 2026 o Shopify não deixa criar essas apps no painel, por isso a maioria das lojas usa o CSV. O que fica no Shopify e o que sai explica essa divisão, e WooCommerce grossista para torrefações faz o mesmo para o WordPress.

Avisar os cafés

No Order Book cada café entra com o email que tem dele, sem palavra-passe. Não cria acessos: envia a carta de boas-vindas a partir da página do cliente, com Enviar a carta. Vai para os contactos de encomendas do café, na língua do café, com a página de entrada e o endereço já preenchidos. A página do cliente mostra depois quando a carta saiu e, se o fornecedor de email o comunicar, quando foi aberta. Se o ficheiro tinha coluna de email, cada cliente que criou já tem esse endereço como contacto.

Envie uma mensagem curta sua no dia útil antes da carta, pelo canal que cada café já usa, para que a carta não pareça phishing. Diga o que muda e em que data o antigo acesso grossista deixa de funcionar.

As suas três ou quatro maiores contas recebem um telefonema em vez de uma mensagem. Dois minutos: vai chegar um email, mais nada muda, ligue-me se o incomodar.

Um plano de três semanas que não põe em risco a semana de encomendas

A regra por trás de cada linha: a app fica ligada até ser entregue a última encomenda que recebeu. Até lá, um café que ainda não passou encomenda exatamente como antes, e nenhuma entrega de quarta-feira depende da mudança.

Uma pessoa é dona da mudança do princípio ao fim. Decide os nomes dos clientes e quando sai cada vaga, e é a ela que chega um café confuso. Se, além da app, mantém uma folha de cálculo sua, sair da folha de cálculo trata dessa metade, com o mesmo princípio.

Remover o que a app deixa para trás

Desinstalar remove a app, mas nem sempre o que ela acrescentou à sua loja. A própria ajuda do Shopify diz que algumas apps acrescentam ao tema código que não é removido automaticamente quando a app é desinstalada. No WordPress, desativar um plugin não apaga definições nem tabelas, e eliminá-lo só as apaga se o plugin estiver feito para isso. Reserve por isso uma hora para esta parte, depois da última entrega.

No Shopify

1. Pergunte primeiro. A página da app ou o programador podem dizer-lhe se há passos extra ao desinstalar. No painel chega lá em Definições, Apps, pelo link de suporte da app.
2. Duplique o tema publicado (Loja online, os três pontos, Duplicar) e limpe na cópia.
3. Verifique as incorporações de apps no editor de temas. Uma app feita com extensões de tema não edita o código do tema, e a incorporação dela sai com ela.
4. Veja o código da cópia: ficheiros em snippets/ com o nome da app, e etiquetas render ou include que os chamam em layout/theme.liquid e nos modelos do carrinho e do produto. Retire a etiqueta e o snippet ao mesmo tempo, e veja a pré-visualização.
5. Verifique os seus outros temas. Um tema antigo guardado como cópia de segurança tem o mesmo código, e se um dia o publicar o problema volta.
6. Remova as páginas grossistas que a app criou: uma página bloqueada, um formulário de encomenda grossista, uma página de registo. Em Navegação, Redirecionamentos de URL, mande o antigo endereço grossista para uma página curta com a ligação ao novo acesso dos seus cafés.
7. Mantenha os clientes. Podem continuar a comprar ao público. Retire a etiqueta grossista se mais nada a usar.
8. Verifique a próxima fatura do Shopify por um débito da app, e reclame-o junto do Shopify se lá estiver.

No WooCommerce

1. Faça uma cópia de segurança completa dos ficheiros e da base de dados.
2. Desative e depois elimine o plugin em Plugins. Elimine-o em vez de o deixar desativado: um plugin inativo continua no servidor e continua a precisar de atualizações.
3. Devolva o papel de utilizador dos cafés. Muitos plugins grossistas acrescentam um papel como "cliente grossista". Em Utilizadores, passe essas contas de novo para Cliente, para que ninguém fique com um papel que já não faz nada, e remova o papel se ainda lá estiver.
4. Limpe todas as caches: o plugin de cache, a cache do alojamento e a CDN. Até lá a loja pode continuar a mostrar preços grossistas, ou uma página grossista que já não existe.
5. Verifique os restos que a desinstalação do plugin não apagou, as definições e tabelas dele, só com a cópia de segurança à mão ou com as instruções do fornecedor.
6. Desligue a renovação da licença na sua conta no site do fornecedor, se não o fez na primeira semana.
7. Teste como desconhecido e como café: preços ao público sem sessão, preços ao público com sessão, e o antigo endereço grossista a redirecionar.

O que costuma correr mal

• Desinstalar primeiro. Os preços grossistas saem com a app, e os cafés que ainda não passaram veem preços ao público nessa semana.
• Perder a segunda linha de cada encomenda por causa das linhas vazias da exportação do Shopify.
• Um ficheiro com ponto e vírgula, recusado por lhe faltarem uma coluna de data e uma de cliente que estiveram sempre lá.
• O acesso antigo continua no ar. Um café com o marcador guardado encomenda a preço de loja, ou não consegue encomendar, e só dá por isso no dia da entrega.
• A renovação que foi cobrada na segunda semana porque ninguém a desligou.

Como é estar "terminado"

• Cada café ativo existe uma vez, com um nome, e com o endereço com que entra.
• Cada grupo de preços da app é um catálogo, e cinco cafés batem certo com a última fatura.
• Cada café recebeu a carta de boas-vindas, e a página do cliente mostra-o.
• A última encomenda que a app recebeu foi entregue.
• A app está desinstalada ou o plugin eliminado, o tema ou a cache estão limpos, e a renovação está desligada.
• O antigo endereço grossista redireciona para o novo acesso.

Perguntas que os torrefatores fazem

Quanto tempo leva deixar uma app grossista do Shopify ou do WooCommerce?

Três semanas, numa torrefação com 15 a 40 contas: uma semana para exportar, renomear e verificar, uma semana com cinco cafés de confiança a encomendar no sítio novo, e uma terceira semana para os restantes. A app sai no fim da terceira semana, depois de entregue a última encomenda que recebeu. A exceção é um plugin fechado por um problema de segurança, que se desativa no primeiro dia.

Posso trazer os meus preços grossistas no CSV?

Não como preços. O CSV com o histórico de encomendas traz para o Order Book os clientes e as encomendas passadas, e a coluna unit_price só regista quanto custou cada linha passada. Os preços definem-se na app como catálogos, um por tipo de cliente, com um preço próprio do cliente nas linhas em que é diferente. Os grupos de preços da app copiam-se à mão; para a maioria das torrefações é menos de uma hora.

O Order Book importa do WooCommerce?

Não há ligação ao WooCommerce. A importação por CSV lê qualquer ficheiro com uma coluna de data e uma coluna de cliente, por isso uma exportação do WooCommerce funciona assim que esses dois cabeçalhos forem renomeados. A transferência de encomendas do WooCommerce Analytics tem uma linha por encomenda, por isso traz totais e não linhas.

Os meus cafés precisam de uma palavra-passe nova?

Não. Cada café entra no Order Book com o email que já tem dele, e não há palavra-passe para criar nem para esquecer. Envia a cada café uma carta de boas-vindas a partir da app quando quiser que comece.

Posso manter o Shopify ou o WooCommerce para a loja ao público?

Sim, e é o que a maioria dos torrefatores faz. A loja continua a vender sacos ao público. Só o grossista muda de sítio, e depois disso a app grossista é a única coisa que remove.

E se o meu plugin foi fechado no wordpress.org?

Desative-o já, não no fim da mudança. Um plugin fechado por um problema de segurança deixa de receber correções, e mantê-lo ativo é o risco maior. Nos dias de permeio, receba as encomendas grossistas por telefone ou mensagem e registe-as você.

Onde entra o Order Book

O Order Book não instala nada na sua loja: nem código no tema, nem nada no checkout, nem nada para desinstalar se um dia sair. Cada café tem a sua própria conta, por isso vê os seus próprios preços, sem etiquetas de cliente. Todos os planos têm todas as funcionalidades, incluindo o preço por café, com preço pelo número de clientes: 49 €, 149 € ou 249 € por mês, sem limite de encomendas e sem comissão por encomenda. Um administrador pode descarregar a qualquer momento tudo o que a torrefação guarda num só ficheiro, e as encomendas exportam-se também em CSV.

O que não faz, para que possa contar com isso: não cobra pagamentos, não emite faturas, não imprime etiquetas de transportadora e não cria encomendas sozinho. Continua a faturar no seu próprio programa e anexa o PDF à encomenda.

Experimente grátis durante 30 dias, sem cartão, ou veja quanto custa.

Os dados sobre Shopify, WooCommerce, WordPress e plugins vêm das páginas públicas de ajuda deles e do diretório de plugins do wordpress.org, a 8 de outubro de 2026, e podem ter mudado. Se algo aqui estiver desatualizado, escreva para [email protected] e será corrigido.