ListoMax 帮助中心：使用指南与常见问题
如何连接您的商店、在哪里找到密钥、发布失败时该怎么办。没找到您的问题？请给我们写信：每一条消息都由我们亲自回复。
如何连接 PrestaShop 商店
适用于 PrestaShop 1.7、8 和 9。大约需要五分钟。
打开 Webservice 设置
在商店后台进入 Advanced Parameters（高级参数），然后进入 Webservice。外部软件正是通过这个接口与您的商店通信。
启用 Webservice
在页面底部，将 Enable PrestaShop's webservice（启用 PrestaShop 的 Webservice）设为“是”，然后保存。跳过这一步，任何密钥都无法使用。
创建密钥
点击 Add new webservice key（添加新的 Webservice 密钥）。为它起一个容易辨认的名称，例如“ListoMax”，然后生成密钥。
授予权限
在权限表中，至少为以下资源勾选读写权限：products、categories、images、languages、stock_availables、taxes、tax_rules、specific_prices、product_features 和 tags。最简单的做法是全部勾选：这个密钥只供 ListoMax 使用。
复制密钥并保存
密钥由 32 个大写字符组成。复制后保存页面。
在 ListoMax 中填写
在 ListoMax 中打开 CMS 连接页面，选择 PrestaShop。输入商店地址（末尾不要加斜杠）并粘贴密钥。点击测试：连接会立即得到验证，商店随即出现在您的发布目标中。
如何连接 WooCommerce 商店
在 WordPress 仪表盘中操作。大约需要三分钟。
打开高级设置
在 WordPress 中进入 WooCommerce，然后依次点击 设置、高级选项卡、REST API。
添加密钥
点击 添加密钥。填写描述，例如“ListoMax”，并选择用于创建商品的用户——一个管理员账户。
选择权限
选择 读/写。只读权限无法创建商品。
复制两个值
WooCommerce 会显示 Consumer key 和 Consumer secret。请立即复制两者：secret 只显示一次，离开页面后就无法再查看。
在 ListoMax 中填写
在 ListoMax 中打开 CMS 连接页面，选择 WooCommerce。输入商店地址、Consumer key 和 Consumer secret，然后测试连接。
您的头三个小时
按这个顺序熟悉软件，就不会迷路。
只连接一个商店
先从一个商店开始，选您最熟悉的那个。测试连接，并用专用按钮确认分类能正常加载。
发布一个测试商品
创建一个简单的产品页，取消勾选 启用商品，让它不在商店中显示，然后发布。到后台查看它，之后再删除。
试一个小系列
两三个款式，商品设为未启用，零风险地了解其工作方式。这正是软件真正展现价值的地方。
检查分类
把一个商品放入子分类，然后在商店中确认它能显示出来，包括从上级分类浏览时。
测试重新发布
修改一个已发布产品页的价格或库存，重新发布，然后确认商店已更新为新的值。
做一次备份
在设置中导出完整备份。养成习惯，每次大规模操作前都备份一次。
常见问题与解决方法
PrestaShop 连接失败
按顺序检查三件事：Advanced Parameters（高级参数）中已启用 Webservice，地址末尾没有斜杠，密钥具有商品的写入权限。
WooCommerce 出现 401 错误
您的凭据被拒绝。请确认复制 Consumer key 和 Consumer secret 时前后没有多余空格，并且密钥是以读/写权限创建的，而不是只读。
图片无法上传
密钥很可能缺少图片权限。在 PrestaShop 中，请检查 images 权限。同时确认文件小于 8 MB，且您的主机允许上传这么大的文件。
商品没有出现在商店中
最常见的原因是 启用商品 未勾选。还请检查商品是否分配到了可见的分类；在 PrestaShop 多店铺模式下，检查它是否关联到了正确的商店。
因增值税问题无法发布
这是有意为之。目标商店中不存在所需的税率。提示信息会列出可用税率：选择其中一个，或在后台创建缺少的税率。我们宁可阻止发布，也不愿以错误的税率推送商品。
变体没有创建
检查密钥是否具有组合和属性的权限。在 WooCommerce 中，商品必须能切换为可变商品类型，这需要完整的写入权限。
缺少某个分类
点击分类刷新按钮：列表会从商店重新加载。如果该分类刚在后台创建，刷新后就会出现。
软件似乎卡住了
如果图片较大或商店响应较慢，正在进行的发布可能需要一些时间。进度条会显示当前步骤。如果几分钟后仍无进展，最终会出现错误提示：绝不会悄无声息地失败。
关于软件
支持哪些 PrestaShop 版本？
PrestaShop 1.7、8 和 9。每次发布新版本前，都会在 PrestaShop 8.2 和 PrestaShop 9.0 的真实商店上进行实测，每个产品页发送后都会回读，确认商店收到的内容与请求完全一致。
和我的主题或模块兼容吗？
兼容。ListoMax 通过您 CMS 的官方 API 工作，而不是通过其用户界面。您的主题、模块和自定义内容都不会参与其中，也不会干扰发布。
支持 PrestaShop 多店铺吗？
支持，只要 Webservice 密钥有权访问相关商店即可。首次发布后，请在后台确认商品已关联到正确的商店。
发布失败会怎样？
错误信息会显示在屏幕上，并注明相关的商品和商店。该产品页会进入错误列表，您可以在那里修正后重新发送，逐个或一次全部发送。没有任何失败是悄无声息的：这是我们所有开发工作的原则。
已经发布的商品还能修改吗？
可以。您在 ListoMax 中编辑产品页并重新发布：商店会收到新的值，包括分类、增值税、价格、库存、重量、尺寸和特性。每个版本都会保存在历史记录中，可以逐字段对比。
ListoMax 会删除我商店里的商品吗？
不会。在 ListoMax 中删除产品页，只会将其从本地目录中移除，而不会从您的在线商店中删除。是否从商店删除，仍由您在商店后台自行决定。
需要一直联网吗？
只有发布和加载分类时需要。填写产品页、准备系列和导入文件都可以离线完成。
ListoMax 支持 Mac 或 Linux 吗？
暂不支持。我们优先推出 Windows 版本，接下来计划推出 macOS 版本，如有需求再推出 Linux 版本。如果您有此需求，请给我们写信：请求的数量决定开发的优先级。
可以管理多少个商品？
没有固定上限。您的商品目录保存在电脑上的一个结构化文件中，并有轮换备份。对于超大批量的商品，文件导入仍然比逐个录入更快。
它与 PrestaShop 自带的 CSV 导入有什么区别？
自带的 CSV 导入要求文件已经存在，且干净完整。它不会创建变体，不会帮您填写产品页，不处理多语言 SEO，也不能同时发布到多个 CMS。ListoMax 负责生成产品页（包括系列），并发送到每个商店。ListoMax 也提供 CSV 导入，作为补充。
必须使用 AI 生成器吗？
不必，它只是一个附加功能。没有 Anthropic 密钥，软件同样可以完整使用：您可以像填写任何表单一样自己撰写文案。如果使用密钥，您需按每个产品页几美分的费用直接支付给 Anthropic，而不是支付给我们。
购买与许可证
购买前可以试用吗？
可以，甚至可以真实发布。免费试用包含向您实际商店进行的 5 次真实发布：产品页会真正在 PrestaShop 或 WooCommerce 上线，包含图片、变体和八种语言。您可以先在后台检查效果，再决定是否付费。所有功能均已解锁，无需信用卡，也没有时间限制。用完这 5 次发布后，购买许可证即可无限发布——您已准备好的产品页会保存下来，激活后即可发出。请给我们写信获取下载链接。
Solo 许可证可以安装在两台电脑上吗？
Solo 许可证适用于一台电脑。如果您更换电脑，请给我们写信，我们会免费为您转移许可证。如需多台电脑同时使用，Agency 许可证正是为此设计的。
Agency 许可证具体涵盖哪些内容？
供您所在组织的团队成员内部使用，最多 20 台电脑。不允许转售本软件，也不允许将其提供给组织以外的第三方使用。
十二个月的更新期结束后会怎样？
软件会按现有版本永久继续使用，无需额外付费。只是不再获得新版本。可选择每年续费延长更新，约 €19/年，但完全是可选的。
如何退款？
请先联系我们：大多数问题一次沟通就能解决。如果软件仍不适合您，可在购买后十四天内申请退款。完整说明请参阅我们的销售条款。
会开具发票吗？
会。付款由 Stripe 安全处理，您将收到一张可用于记账的正规发票（不适用增值税，article 293 B du CGI）。
数据与安全
我的 API 密钥会被发送到别处吗？
不会。您的密钥、商品目录和历史记录都保存在您的电脑上，位于应用程序的受保护存储中。我们没有任何接收您商店数据的服务器。软件直接在您的电脑和商店之间通信，没有任何中间环节。
我的数据具体存储在哪里？
存储在您电脑上的应用程序数据文件夹中：商品目录和历史记录保存在带轮换备份的结构化文件中，图片保存在专用文件夹中，访问密钥则保存在只有软件主进程才能读取的受保护存储中。
如果我的电脑坏了怎么办？
请定期在设置中导出完整备份：一个文件就包含了您的商品目录、历史记录和偏好设置。在新电脑上载入它，一切都会恢复。已经发布的商品当然会继续在您的商店中在线。
AI 生成器会把我的数据发送给 Anthropic 吗？
只会发送生成所需的内容——商品名称和您提供的卖点——并且仅在您使用此功能且使用您自己的密钥时才会发送。没有密钥，任何数据都不会离开您的电脑。
可以在没有管理员权限的电脑上使用 ListoMax 吗？
根据您公司的配置，安装可能需要相应权限。如果您遇到这种情况，请联系我们，我们会看看有哪些可行方案。