Ajuda ListoMax: guias e perguntas frequentes
Como conectar suas lojas, onde encontrar suas chaves e o que fazer quando uma publicação falha. Não achou sua dúvida? Escreva para nós: respondemos pessoalmente a cada mensagem.
Como conectar uma loja PrestaShop
Funciona com PrestaShop 1.7, 8 e 9. Leva uns cinco minutos.
Abra as configurações do webservice
No painel administrativo da sua loja, acesse Parâmetros Avançados e depois Webservice. É essa interface que permite que um software externo converse com a sua loja.
Ative o webservice
No fim da página, marque Ativar o webservice do PrestaShop como Sim e salve. Sem esta etapa, nenhuma chave vai funcionar.
Crie uma chave
Clique em Adicionar nova chave de webservice. Dê a ela um nome fácil de reconhecer, como "ListoMax", e gere a chave.
Conceda as permissões
Na tabela de permissões, marque leitura e escrita pelo menos para: products, categories, images, languages, stock_availables, taxes, tax_rules, specific_prices, product_features e tags. O mais simples é marcar tudo: essa chave será usada só pelo ListoMax.
Copie a chave e salve
A chave tem 32 caracteres em maiúsculas. Copie-a e salve a página.
Cole a chave no ListoMax
No ListoMax, abra a página Conexões CMS e escolha PrestaShop. Informe o endereço da sua loja sem barra no final e cole a chave. Clique em testar: a conexão é verificada na hora e a loja aparece nos seus destinos.
Como conectar uma loja WooCommerce
Direto do painel do WordPress. Leva uns três minutos.
Abra as configurações avançadas
No WordPress, acesse WooCommerce, depois Configurações, a aba Avançado e, por fim, API REST.
Adicione uma chave
Clique em Adicionar chave. Escreva uma descrição, como "ListoMax", e escolha o usuário em nome do qual os produtos serão criados — uma conta de administrador.
Escolha as permissões
Selecione Leitura/Gravação. Com acesso somente leitura não é possível criar produtos.
Copie os dois valores
O WooCommerce exibe uma Consumer key e um Consumer secret. Copie os dois imediatamente: o secret aparece uma única vez e não pode ser visto de novo depois que você sai da página.
Informe-os no ListoMax
No ListoMax, abra a página Conexões CMS e escolha WooCommerce. Informe o endereço da sua loja, a Consumer key e o Consumer secret e teste a conexão.
Suas três primeiras horas
A ordem certa para aprender o software sem se perder.
Conecte só uma loja
Comece por uma única loja, a que você conhece melhor. Teste a conexão e confira se as categorias carregam corretamente com o botão dedicado.
Publique um produto de teste
Crie uma ficha simples, desmarque Produto ativo para que ela não apareça na loja e publique. Confira o resultado no painel administrativo. Depois, exclua-a.
Experimente uma pequena série
Duas ou três variações, produto inativo, para entender o funcionamento sem nenhum risco. É aqui que o software mostra todo o seu valor.
Confira suas categorias
Coloque um produto numa subcategoria e verifique na loja se ele aparece, inclusive navegando pela categoria-pai.
Teste uma republicação
Altere o preço ou o estoque de uma ficha já publicada, republique e confira se a loja recebeu o novo valor.
Faça um backup
Nas configurações, exporte o backup completo. Crie o hábito de fazer isso antes de toda operação grande.
Problemas comuns e soluções
A conexão com o PrestaShop falha
Verifique três coisas, nesta ordem: o webservice está ativado em Parâmetros Avançados, o endereço não termina com barra e a chave tem permissão de escrita em products.
Erro 401 no WooCommerce
Suas credenciais estão sendo recusadas. Confira se você copiou a Consumer key e o Consumer secret sem espaços no início ou no fim, e se a chave foi criada com acesso de leitura e gravação, e não somente leitura.
As imagens não sobem
Provavelmente a chave não tem permissão sobre as imagens. No PrestaShop, verifique a permissão images. Confira também se os arquivos têm menos de 8 MB e se a sua hospedagem aceita uploads desse tamanho.
O produto não aparece na loja
Na maioria das vezes, a caixa Produto ativo está desmarcada. Verifique também se o produto está numa categoria visível e, no PrestaShop multiloja, se está associado à loja certa.
A publicação é bloqueada por causa do imposto
É de propósito. A alíquota solicitada não existe na loja de destino. A mensagem lista as alíquotas disponíveis: escolha uma ou crie a que falta no painel administrativo. Preferimos bloquear uma publicação a enviar um produto com a alíquota errada.
As variações não são criadas
Verifique se a chave tem permissões sobre combinações e atributos. No WooCommerce, o produto precisa poder passar para o tipo variável, o que exige acesso total de escrita.
Está faltando uma categoria
Clique no botão de atualizar categorias: a lista é recarregada a partir da loja. Se a categoria acabou de ser criada no painel administrativo, ela aparece depois da atualização.
O software parece travado
Uma publicação em andamento pode demorar se as imagens forem pesadas ou a loja estiver lenta. A barra de progresso mostra a etapa atual. Se nada mudar depois de vários minutos, uma mensagem de erro acabará aparecendo: nada acontece em silêncio.
O software
Quais versões do PrestaShop são compatíveis?
PrestaShop 1.7, 8 e 9. A publicação é testada em condições reais no PrestaShop 8.2 e no PrestaShop 9.0 antes de cada lançamento, em lojas de verdade, com cada ficha lida de volta após o envio para confirmar que a loja recebeu exatamente o que foi solicitado.
Funciona com o meu tema ou os meus módulos?
Sim. O ListoMax usa a API oficial do seu CMS, e não a interface de usuário. Seu tema, seus módulos e suas personalizações não entram no processo e não podem atrapalhar a publicação.
Funciona com o PrestaShop multiloja?
Sim, desde que a chave de webservice tenha acesso às lojas em questão. Depois da primeira publicação, confira no painel administrativo se o produto está associado à loja certa.
O que acontece se uma publicação falhar?
A mensagem de erro aparece na tela, com o produto e a loja envolvidos. A ficha vai para a lista de erros, onde você pode corrigi-la e reenviá-la, uma por vez ou todas de uma vez. Nada falha em silêncio: esse é o princípio de todo o nosso desenvolvimento.
Posso editar um produto já publicado?
Sim. Você edita a ficha no ListoMax e republica: a loja recebe os novos valores, incluindo categorias, impostos, preço, estoque, peso, dimensões e características. Cada versão fica guardada no histórico e pode ser comparada campo a campo.
O ListoMax exclui produtos da minha loja?
Não. Excluir uma ficha no ListoMax a remove do seu catálogo local, não da sua loja on-line. A exclusão na loja continua sendo uma decisão sua, feita pelo painel administrativo.
Preciso de conexão permanente com a internet?
Só para publicar e carregar as categorias. Preencher fichas, preparar séries e importar arquivos funciona off-line.
O ListoMax funciona no Mac ou no Linux?
Ainda não. A versão para Windows vem primeiro; uma versão para macOS está prevista na sequência e, depois, Linux se houver demanda. Se for o seu caso, escreva para nós: o número de pedidos define a prioridade.
Quantos produtos posso gerenciar?
Não há limite fixo. Seu catálogo é salvo num arquivo estruturado no seu computador, com backups rotativos. Para volumes muito grandes, importar um arquivo continua sendo mais rápido do que cadastrar os produtos um a um.
Qual a diferença para a importação CSV nativa do PrestaShop?
A importação CSV nativa parte do princípio de que o arquivo já existe, limpo e completo. Ela não cria variações, não preenche as fichas por você, não cuida do SEO multilíngue e não publica em vários CMS ao mesmo tempo. O ListoMax monta as fichas, inclusive as séries, e as envia para todas as lojas. O ListoMax também oferece importação CSV, como complemento.
O gerador com IA é obrigatório?
Não, é um extra. Sem uma chave da Anthropic, o software funciona por completo: você escreve seus próprios textos, como faria em qualquer formulário. Com uma chave, você paga alguns centavos por ficha diretamente à Anthropic, nunca a nós.
Compra e licenças
Posso testar antes de comprar?
Sim, e pode até publicar. O teste gratuito inclui 5 publicações reais nas suas lojas de verdade: as fichas vão de fato para o PrestaShop ou o WooCommerce, com imagens, variações e oito idiomas. Você confere o resultado no painel administrativo antes de pagar qualquer coisa. Todos os recursos estão liberados, não é preciso cartão de crédito e não há prazo. Depois dessas 5 publicações, uma licença libera publicações ilimitadas — as fichas já preparadas ficam salvas e são enviados assim que você ativa a licença. Escreva para nós para receber o link de download.
Posso instalar a licença Solo em dois computadores?
A licença Solo cobre um computador. Se você trocar de máquina, escreva para nós e transferimos a licença sem custo. Para vários computadores usados ao mesmo tempo, a licença Agência foi feita exatamente para isso.
O que exatamente a licença Agência cobre?
O uso interno pelos membros da equipe da sua organização, em até 20 computadores. Ela não permite revender o software nem disponibilizá-lo a terceiros de fora da sua organização.
O que acontece depois dos doze meses de atualizações?
O software continua funcionando como está, para sempre, sem custo adicional. Só o acesso às novas versões é interrompido. Existe uma extensão anual, por cerca de €19 por ano, mas ela é totalmente opcional.
Como funciona o reembolso?
Escreva para nós primeiro: a maioria dos problemas se resolve numa única troca de mensagens. Se o software ainda assim não servir para você, o reembolso pode ser solicitado em até catorze dias após a compra. Todos os detalhes estão nos nossos termos de venda.
Vou receber uma fatura?
Sim. O pagamento é processado de forma segura pela Stripe e você recebe uma fatura em ordem, que pode usar na sua contabilidade (IVA não aplicável, artigo 293 B do CGI).
Dados e segurança
Minhas chaves de API são enviadas para algum lugar?
Não. Suas chaves, seu catálogo e seu histórico ficam armazenados no seu computador, no armazenamento protegido do aplicativo. Não temos nenhum servidor que receba os dados da sua loja. O software se comunica diretamente entre o seu PC e as suas lojas, sem intermediários.
Onde exatamente meus dados ficam armazenados?
Na pasta de dados do aplicativo, no seu computador: o catálogo e o histórico num arquivo estruturado com backups rotativos, as imagens numa pasta dedicada e as chaves de acesso num armazenamento protegido, lido apenas pelo processo principal do software.
E se o meu computador quebrar?
Exporte regularmente o backup completo nas configurações: um único arquivo reúne seu catálogo, seu histórico e suas preferências. Carregue-o numa máquina nova e tudo volta. Os produtos já publicados, claro, continuam no ar nas suas lojas.
O gerador com IA envia meus dados para a Anthropic?
Somente o necessário para a geração — o nome do produto e os diferenciais que você informar — e apenas se você usar esse recurso, com a sua própria chave. Sem chave, nenhum dado sai do seu computador.
Posso usar o ListoMax num computador sem direitos de administrador?
A instalação pode exigir permissões, dependendo da configuração da sua empresa. Se for o seu caso, fale com a gente e vemos o que é possível.
Não encontrou sua dúvida?
Escreva para support@listomax.io. Respondemos pessoalmente, normalmente em até 48 horas úteis.