六种故障类别几乎涵盖了所有问题。五分钟内找到您的问题，然后进行修复 — 并了解哪种修复方法无法持久。
QuickBooks 中的最后一笔订单是周二的。今天是周五。您没有更改任何内容，没有人触碰任何内容，但您的 QuickBooks Shopify 集成又一次无法正常工作 — 在您需要清晰的数字进行销售税申报前三天。
如果这感觉很熟悉，那很可能是。大多数访问此页面的人之前已经重新连接过集成一次，看着它工作了几周，并认为问题已解决。然后它以不同的方式中断 — 这正是上次修复无效的原因。
修复前的两点说明。首先，免责声明：我们制作了一个付费的竞争性同步工具，因此我们的偏见是存在的。产品介绍完全不包含在故障排除中 — 它只出现一次，并有清晰的标签，在最后。其次，重新定义：让人们卡在这个页面上的谎言是“我一定设置错了。” 您几乎肯定没有。同步中断不是一个问题，只有一个修复方法 — 而是六种不同的故障类别，每种都有其自身的症状、原因和修复方法。先诊断，再修复。
五分钟诊断：授权、数据还是配置？
每次同步失败都回答了三个问题中的一个。按顺序回答以找到您的部分。
1. 有任何内容在同步吗？ 在 QuickBooks 中找到连接器创建的最新交易。如果所有内容都在特定日期停止，则您遇到了连接问题 — 授权丢失（类别 1），或 Shopify 端更改导致其中断（类别 6）。
2. 数据是否已到达，但不完整或延迟？ 订单丢失，或所有内容比您预期的晚一天到达：数据流问题（类别 2）。
3. 数据是否已到达，但错误？ 收入看起来翻倍，费用不可见，或收入进入奇怪的账户：配置问题（类别 3、4 和 5）。
| 症状 | 可能类别 |
|---|---|
| 自特定日期以来没有任何内容同步 | 1 — 授权已过期 |
| 在您更改应用、主题或套餐后立即停止 | 6 — 应用/主题更改 |
| 部分订单丢失或延迟到达 | 2 — 订单丢失或延迟 |
| 收入看起来大致翻倍 | 3 — 重复项 |
| 收入与存款匹配，但费用支出无处可寻 | 4 — 费用混入存款 |
| 销售额进入“未分类收入”或奇怪的账户 | 5 — 映射漂移 |
跳转到你的类别。每个类别都提供症状、实际原因以及你可以自行修复的步骤。
类别 1：连接中断（授权过期）
症状：同步在特定日期完全停止。没有任何明显失败——订单只是停止出现。连接器的设置可能显示商店已断开连接或要求你重新授权。
发生原因：集成依赖于你在首次连接时授予的授权令牌。令牌被吊销的频率比任何人预期的都要高：密码更改、员工账户停用、权限更改、双方的例行安全事件。最初连接集成的人员离开你的团队是经典的“无声杀手”——他们的凭据消失，连接也随之消失。
修复方法：
- 在连接器的设置中重新授权。断开并重新连接商店，批准所有请求的权限。
- 使用正确的账户。以商店所有者或公司管理员的身份重新连接——而不是可能稍后被停用的员工登录。这个习惯可以防止大多数重复的身份验证失败。
- 检查你的电子邮件过滤器。大多数连接器会发送断开连接通知。如果它被发送到垃圾邮件，你会在不知情的情况下损失数天的同步。将发件人列入白名单。
- 回填缺口。重新连接并不总是能重新同步断开的窗口。记下断开日期和重新连接日期，然后检查这些订单是否已通过——如果没有，则类别 2 的修复方法涵盖了恢复它们。
预防：为集成分配一个管理员账户，并在日历上设置每月两分钟的检查：QuickBooks 中的最新订单是否与 Shopify 中的最新订单匹配？
类别 2：订单丢失或延迟
症状：总数与你的 Shopify 报告不符。特定订单缺失，或所有订单在销售一天或更长时间后才显示。
发生原因：三个独立的原因隐藏在这个症状之下。
- 同步频率。许多连接器按计划同步——每日批处理而不是实时。所谓的“延迟”可能只是计划按设计工作。
- 范围。连接器通常按设计同步订单类型的子集。POS 销售、草稿订单或来自其他销售渠道的订单可能被排除在外。
- 边界。月中开始的同步通常不会向后追溯，并且 Shopify 和你的 QuickBooks 公司文件之间的时区不匹配会将午夜附近的订单推到错误的一天。
修复方法：
- 检查连接器设置中的同步计划并确认延迟不仅仅是配置的节奏。如果存在手动同步选项，请触发它。
- 找出缺失订单的模式。在 Shopify 中调出其中五个。相同的渠道？相同的日期范围？相同的付款方式？模式意味着范围限制，而不是故障。
- 如果这是范围限制，请以其他方式记录排除的订单（通常是该渠道总额的月度日记账分录），并接受连接器不会传输它们。
- 如果是时间窗口（来自授权掉线或月中开始），请在连接器的设置中查找历史导入或日期范围重新同步选项。没有选项意味着该时间窗口需要手动输入一次。
- 同步时区，使您的 Shopify 商店设置和 QuickBooks 之间的时区一致，以便跨天界限的订单能够落在正确的期间内。
类别 3：重复交易（银行流水 + 连接器重叠）
症状： QuickBooks 中的收入大约是您实际销售额的两倍。订单或付款显示两次。您的损益表看起来很棒，但完全错误。
发生原因：这是最常见的配置失败，并非任何软件的错误。连接器会在 QuickBooks 中记录您的 Shopify 销售额。然后，您的银行流水会导入 Shopify 付款存款——相同的钱——如果您点击添加而不是匹配，QuickBooks 会在第一个收入条目的基础上创建第二个收入条目。每次添加都会使付款翻倍。
修复方法：
- 先改变习惯：从今天起，切勿从银行流水中添加 Shopify 付款。始终将其与连接器已创建的交易进行匹配。添加会产生收入；匹配会确认已存在的收入。
- 清理现有的重复项。查找被添加的存款（连接器已记录销售额），撤销或排除它们，然后正确匹配。按月工作，从最近的开始。
- 检查是否有第二个同步器。同时运行两个连接器——一个您从未卸载过的旧应用加上一个新的——或者两次导入相同的日期范围也会导致重复。一个工具，一个真相来源。
- 通过一次付款进行验证。跟踪一次最近的付款：一组销售条目，一次存款，匹配在一起。如果这条链是干净的，那么您的清理工作就成功了。
类别 4：费用合并到存款中
症状： QuickBooks 中的收入几乎与您的银行存款完全匹配——这听起来不错，直到您注意到它低于 Shopify 显示的销售额，并且您的损益表中不存在任何 Shopify 费用支出。
发生原因： Shopify 向您支付的是净额——销售额减去退款减去处理费，作为一笔总存款。如果集成将这笔总额记录为收入，费用就会消失其中：净存款被记为总收入，这会错误地陈述收入和费用，并可能扭曲您税务申报所依据的销售额数字。该差距的完整分析可在QuickBooks 中的 Shopify 费用中找到。
修复方法：
- 在连接器的设置中查找费用处理选项。如果连接器可以将付款分解为销售额、退款和费用，请启用该选项，并将费用行映射到“商家处理费”费用账户。
- 如果不行，请手动进行汇总。每月一次，拉取 Shopify 的收款报告，汇总费用，然后过账日记账分录：增加销售额等于费用金额，将相同金额计入费用支出。净收入不变 — 但收入和支出都将真实反映。
- 修正重要的历史记录。至少，以相同的方式更正当前纳税年度，每月一项分录。
诚实的标志：如果第一步结果为空，那不是配置错误 — 而是上限。请在修正步骤之后再考虑这一点。
类别 5：错误的账户和映射漂移
症状：销售额出现在“未分类收入”中。新付款方式的收入落入某个奇怪的地方。设置时准确但之后逐渐错误的账簿。
发生原因：映射 — 即 Shopify 的哪笔款项对应哪个 QuickBooks 账户 — 在安装时根据您当时的店铺配置一次。店铺会发生变化：新的支付网关、礼品卡、新的销售渠道、图表中账户的重命名。映射无法识别的任何内容都会落入连接器的默认账户，而默认账户是准确性悄然消失的地方。
修复方法：
- 打开连接器设置中的映射部分，逐行检查：每个 Shopify 的款项类别 — 销售额、退款、费用、税款、网关 — 对照其过账的 QuickBooks 账户。
- 查找汇总项。任何被路由到通用默认账户或“未分类”账户的款项都是未映射的漂移项。为其分配一个真实账户。
- 重新分类杂项。修复映射后，查找错误账户中的历史交易并移动它们 — QuickBooks 的重新分类工具或您的簿记员可以批量处理此操作。
- 每季度审查一次映射表，并添加一个上线清单步骤：新的网关、渠道或产品类型意味着当周需要检查映射表。
类别 6：应用或主题更改后同步停止
症状：中断与更改相关 — 您安装或卸载了 Shopify 应用、更换了主题、更改了 Shopify 套餐，或添加了结账或订单编辑应用。
发生原因：Shopify 应用可以共享权限、修改订单数据或更改订单创建方式。卸载一个应用可能会撤销另一个应用所依赖的访问权限。订单编辑和追加销售应用可能会产生连接器未预期的订单格式，并导致其静默失败。
修复方法：
- 构建时间线。将同步停止的日期与您的更改日志进行匹配 — Shopify 保留店铺活动记录，您的应用安装历史记录在管理员中。
- 首先重新连接。权限干扰看起来与第一类完全相同，而第一类的修复 — 使用管理员账户完全重新授权 — 可以解决其中大部分问题。
- 用一个订单进行测试。如果某个特定应用处理的订单失败而其他订单同步正常，则说明您已将其隔离。
- 提供具体信息进行升级。联系连接器支持和应用的支持，提供中断日期、示例订单号和时间线。具体的证据可以将一个为期两周的工单缩短到两天。
当您的 QuickBooks Shopify 集成按预期无法正常工作时
现在是诚实的部分。看看你刚刚修复的类，然后问：这是你自己的问题还是工具的问题？
你自己的问题只需修复一次即可保持不变。 添加与匹配的习惯。无人安排的映射审查。通过前员工的登录信息连接的集成。断开的电子邮件发送到垃圾邮件。如果你采取了预防措施，这些都不会再次发生——任何工具，无论价格如何，都无法为你解决这些问题。
无论你做什么，工具的局限性都会卷土重来。 无法从每次付款的押金中拆分出来的费用。连接器永远不支持的订单类型或渠道。无法更改的同步节奏。没有办法在不手动输入的情况下填补空白。如果你的“修复”变成了每月例行公事——例行的日记条目、例行的清理、例行的手动导入——那么你并没有修复集成。你成为了它的一部分。
这两种判断都不是侮辱。一个免费或入门级的连接器，在你的交易量下，正好完成了它的设计功能，这是一个非常好的答案——许多商店应该纠正习惯，保留工具，然后在这里停止阅读。区分很重要，因为这两种判断有相反的后续步骤：一种是日历提醒，另一种是迁移。
如果您是第三次访问此页面
如果你已将此帖子加入书签，那么书签就是线索。一次性故障排除同步是维护。每月故障排除一次就是每周日晚上支付的订阅费。
如果你在那里，请按顺序阅读三遍：
- QuickBooks Shopify 连接器审查 — 免费连接器做得好的地方以及它的局限性，这样你就可以命名你的局限性而不是猜测。
- 淘汰免费 QuickBooks 连接器 — 如何迁移到更强大的同步工具，而无需重新处理你的历史记录。
- 最佳 Shopify 会计软件 — 你将迁移到的完整领域，包括在特定任务上优于我们的工具。
以及顶部的披露，已兑现：我们制作 LedgerPort，一个付费的 Shopify 和 WooCommerce → QuickBooks 同步工具，围绕本文中的局限性构建——按存款拆分费用的付款日记条目、你控制的映射，以及你可以看到和修复的同步间隙，而不是在报税时才发现。免费套餐每月涵盖 30 个订单——足以运行一次实际付款并检查 Class 4 是否从你的生活中消失。如果没有，你只损失了五分钟，而且你今天已经比这更快地进行了分类。
