Ajuda

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.

Guia de conexão

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.

Atenção ao endereço. O erro mais comum é uma barra a mais no fim do endereço. Digite https://mystore.com, e não https://mystore.com/.
Guia de conexão

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.

O secret aparece uma única vez. Se você fechou a página sem copiá-lo, será preciso excluir a chave e criar outra. Nada grave, mas é melhor saber antes.
Primeiros passos

Suas três primeiras horas

A ordem certa para aprender o software sem se perder.

ETAPA 1

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.

ETAPA 2

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.

ETAPA 3

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.

ETAPA 4

Confira suas categorias

Coloque um produto numa subcategoria e verifique na loja se ele aparece, inclusive navegando pela categoria-pai.

ETAPA 5

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.

ETAPA 6

Faça um backup

Nas configurações, exporte o backup completo. Crie o hábito de fazer isso antes de toda operação grande.

A dica que evita surpresas desagradáveis. Durante os testes, mantenha sempre Produto ativo desmarcado. A ficha é criada na loja, mas fica invisível para os clientes. Você confere com calma e depois ativa ou exclui.
Solução de problemas

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.

Seu problema não está na lista? Escreva para support@listomax.io informando seu CMS e a versão, o que você estava tentando fazer e a mensagem exibida na tela. Um print da tela costuma poupar três trocas de e-mail.
Perguntas frequentes

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.

Perguntas frequentes

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).

Perguntas frequentes

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.