Интеграция QuickBooks Shopify не работает? Все исправления

Шесть классов сбоев охватывают почти каждую поломку. Найдите свою за пять минут, затем примените исправление — и узнайте, какое одно исправление никогда не работает.

---

Последний заказ в QuickBooks был во вторник. Сегодня пятница. Вы ничего не меняли, никто ничего не трогал, а ваша интеграция QuickBooks Shopify снова не работает — за три дня до того, как вам нужны чистые цифры для подачи налоговой декларации о продажах.

Если это кажется знакомым, так оно и есть. Большинство людей, попадающих на эту страницу, уже один раз переподключали интеграцию, наблюдали, как она работает несколько недель, и думали, что проблема решена. Затем она сломалась по-другому — именно поэтому последнее исправление не сработало.

Две вещи перед исправлениями. Во-первых, раскрытие информации: мы создаем конкурирующий платный инструмент синхронизации, поэтому у нас есть предвзятость. Разговоры о продукте полностью исключены из устранения неполадок — он появляется один раз, четко обозначенный, в самом конце. Во-вторых, переосмысление: ложь, которая удерживает людей на этой странице, заключается в том, что "я, должно быть, настроил это неправильно". Вы почти наверняка этого не делали. Сбой синхронизации — это не одна проблема с одним исправлением, а шесть различных классов сбоев, каждый со своими симптомами, причиной и ремонтом. Сначала диагностируйте, затем исправляйте.

Пятиминутная диагностика: авторизация, данные или конфигурация?

Каждый сбой синхронизации отвечает на один из трех вопросов. Ответьте на них по порядку, чтобы найти свой раздел.

1. Синхронизируется ли вообще что-нибудь? Найдите последнюю транзакцию, созданную коннектором в QuickBooks. Если все остановилось в определенную дату, у вас проблема с подключением — потеря авторизации (Класс 1) или изменение на стороне Shopify, которое ее нарушило (Класс 6).

2. Данные поступают, но неполные или с задержкой? Отсутствующие заказы или все появляется на день позже, чем вы ожидаете: проблема с потоком данных (Класс 2).

3. Данные поступают, но неправильные? Доход выглядит удвоенным, комиссии невидимы или доход поступает на странные счета: проблема с конфигурацией (Классы 3, 4 и 5).

Симптом	Вероятный класс
Ничего не синхронизировалось с определенной даты	1 — Истекла авторизация
Остановка сразу после изменения приложений, тем или планов	6 — Изменение приложения/темы
Некоторые заказы отсутствуют или поступают с задержкой	2 — Отсутствующие или задержанные заказы
Доход выглядит примерно удвоенным	3 — Дубликаты
Доходы совпадают с депозитами, но расходов на комиссии нигде нет	4 — Комиссии, включенные в депозиты
Продажи попадают в "Некатегоризированные доходы" или странные учетные записи	5 — Смещение сопоставления

Перейдите к своему классу. Каждый из них дает вам симптомы, фактическую причину и шаги по устранению, которые вы можете выполнить самостоятельно.

Класс 1: Соединение потеряно (истечение срока авторизации)

Симптомы: синхронизация полностью остановилась в определенную дату. Ничего не сбойнуло громко — заказы просто перестали появляться. Настройки коннектора могут показывать, что магазин отключен, или запрашивать повторную авторизацию.

Почему это происходит: интеграция работает на основе токена авторизации, предоставленного при первом подключении. Токены отзываются чаще, чем кто-либо ожидает: изменение пароля, деактивация учетной записи сотрудника, изменение разрешений, обычное событие безопасности с любой стороны. Сотрудник, который изначально подключил интеграцию и покинул вашу команду, является классическим типом «тихого убийцы» — его учетные данные исчезают, и вместе с ними исчезает и соединение.

Исправление:

1. Повторно авторизуйтесь в настройках коннектора. Отключите и повторно подключите магазин, одобрив все запрошенные разрешения.
2. Используйте правильную учетную запись. Повторно подключитесь как владелец магазина или администратор компании — не как учетная запись сотрудника, которая может быть деактивирована позже. Эта одна привычка предотвращает большинство повторных сбоев авторизации.
3. Проверьте фильтры электронной почты. Большинство коннекторов отправляют уведомление об отключении. Если оно попало в спам, вы потеряли дни синхронизации, не зная об этом. Добавьте отправителя в белый список.
4. Восполните пробел. Повторное подключение не всегда повторно синхронизирует отключенный период. Заметьте дату разрыва и дату повторного подключения, затем проверьте, прошли ли эти заказы — если нет, то исправления Класса 2 охватывают их восстановление.

Профилактика: выделите учетную запись администратора для интеграции и поставьте в календарь ежемесячную двухминутную проверку: совпадает ли последний заказ в QuickBooks с последним в Shopify?

Класс 2: Отсутствующие или задержанные заказы

Симптомы: итоги не совпадают с вашими отчетами Shopify. Отсутствуют конкретные заказы или все появляется через день или более после продажи.

Почему это происходит: три отдельные причины скрываются под этим одним симптомом.

• Частота синхронизации. Многие коннекторы синхронизируются по расписанию — ежедневными пакетами, а не в реальном времени. «Задержка» может быть просто работой расписания по дизайну.
• Область охвата. Коннекторы часто синхронизируют подмножество типов заказов по дизайну. Продажи POS, черновики заказов или заказы из дополнительных каналов продаж могут быть исключены.
• Границы. Синхронизация, начавшаяся в середине месяца, обычно не распространяется назад, а несоответствие часовых поясов между Shopify и вашим файлом компании QuickBooks может перенести заказы около полуночи в неверный день.

Исправление:

1. Проверьте расписание синхронизации в настройках коннектора и убедитесь, что задержка — это не просто настроенный интервал. Запустите ручную синхронизацию, если такая опция существует.
2. Найдите закономерность в отсутствующих заказах. Возьмите пять из них в Shopify. Тот же канал? Тот же диапазон дат? Тот же способ оплаты? Закономерность означает ограничение области охвата, а не неисправность.
3. Если это ограничение области действия, записывайте исключенные заказы другим способом — обычно ежемесячной журнальной проводкой для итогов этого канала — и примите, что коннектор их не перенесет.
4. Если это временной интервал (из-за отмены авторизации или начала в середине месяца), найдите в настройках коннектора опцию исторического импорта или повторной синхронизации по диапазону дат. Отсутствие опции означает, что интервал вводится вручную, один раз.
5. Согласуйте часовые пояса между настройками вашего магазина Shopify и QuickBooks, чтобы заказы, относящиеся к разным календарным дням, попадали в правильный период.

Класс 3: Дублирующиеся транзакции (банковская лента + перекрытие коннектора)

Симптомы: выручка в QuickBooks примерно вдвое превышает фактически проданные товары. Заказы или выплаты появляются дважды. Ваш отчет о прибылях и убытках выглядит фантастически и совершенно неправильно.

Почему это происходит: это самая распространенная ошибка конфигурации, и это не ошибка в чем-либо. Коннектор записывает ваши продажи Shopify в QuickBooks. Затем ваш банковский поток импортирует депозит выплаты Shopify — те же деньги — и если вы нажмете Добавить вместо Сопоставить, QuickBooks создаст вторую запись о доходе поверх первой. Каждое добавление удваивает выплату.

Исправление:

1. Сначала измените привычку: с сегодняшнего дня никогда не добавляйте выплату Shopify из банковского потока. Всегда сопоставляйте ее со сделкой, которую коннектор уже создал. Добавление создает доход; Сопоставление подтверждает уже существующий доход.
2. Исправьте существующие дубликаты. Найдите депозиты, которые были добавлены, когда коннектор уже записал продажи; отмените или исключите их, а затем правильно сопоставьте. Работайте по месяцам, начиная с недавних.
3. Проверьте наличие второго синхронизатора. Два одновременно работающих коннектора — старое приложение, которое вы никогда не удаляли, плюс новое — или дважды импортированный один и тот же диапазон дат также приведут к дублированию. Один инструмент, один источник правды.
4. Проверьте на одной выплате. Отследите одну недавнюю выплату: один набор записей о продажах, один депозит, сопоставленные вместе. Если эта цепочка чиста, ваша очистка прошла успешно.

Класс 4: Комиссии, сгруппированные в депозиты

Симптомы: доход в QuickBooks почти точно соответствует вашим банковским депозитам — что звучит неплохо, пока вы не заметите, что он ниже, чем то, что Shopify говорит о ваших продажах, и в вашем отчете о прибылях и убытках нет никаких расходов на комиссии Shopify.

Почему это происходит: Shopify платит вам чистыми — продажи минус возвраты минус комиссии за обработку, одной общей суммой депозита. Если интеграция записывает эту общую сумму как доход, комиссии исчезают в ней: чистые депозиты учитываются как валовая выручка, что искажает как доходы, так и расходы и может исказить сумму продаж, на основе которой строятся ваши налоговые декларации. Полная анатомия этого пробела находится в Комиссии Shopify в QuickBooks.

Исправление:

1. Ищите опции обработки комиссий в настройках коннектора. Если коннектор может разбивать выплаты на продажи, возвраты и комиссии, включите эту опцию и сопоставьте строку комиссий с учетной записью расходов "Комиссии за обработку платежей".
2. Если это невозможно, увеличьте вручную. Раз в месяц выгружайте отчет Shopify о выплатах, суммируйте комиссии и создайте бухгалтерскую запись: увеличьте продажи на сумму комиссии, отнесите ту же сумму на расходы по комиссии. Чистая прибыль не меняется — но выручка и расходы становятся реальными.
3. Исправьте историю, которая имеет значение. Как минимум, исправьте текущий налоговый год таким же образом, одной записью в месяц.

Честный сигнал: если шаг 1 оказался пустым, это не ошибка конфигурации — это предел. Держите эту мысль для раздела после исправлений.

Класс 5: Неправильные счета и расхождение в сопоставлении

Симптомы: продажи появляются в разделе "Некатегоризированный доход". Доход от нового способа оплаты попадает куда-то не туда. Учет, который был точным при настройке и с тех пор медленно становился все более неточным.

Почему это происходит: сопоставление — какие деньги Shopify идут на какой счет QuickBooks — настраивается один раз, при установке, в соответствии с магазином, который у вас был тогда. Магазины меняются: новый платежный шлюз, подарочные карты, новый канал продаж, переименованный счет в вашем плане счетов. Все, что сопоставление не распознает, попадает на счет по умолчанию в коннекторе, а в настройках по умолчанию точность тихо умирает.

Исправление:

1. Откройте раздел сопоставления в настройках коннектора и пройдитесь по каждой строке: каждая категория денег Shopify — продажи, возвраты, комиссии, налоги, шлюзы — против счета QuickBooks, на который она отправляется.
2. Ищите общие категории. Все, что направляется на общий счет по умолчанию или "Некатегоризированный" счет, является неуказанным изменением. Назначьте ему реальный счет.
3. Переклассифицируйте посторонние. После исправления карты найдите исторические транзакции на неправильных счетах и переместите их — инструменты переклассификации QuickBooks или ваш бухгалтер могут сделать это пакетом.
4. Проверяйте карту ежеквартально и добавьте шаг в контрольный список запуска: новый шлюз, канал или тип продукта означает проверку карты на этой неделе.

Класс 6: Синхронизация остановлена после изменения приложения или темы

Симптомы: сбой коррелирует с изменением — вы установили или удалили приложение Shopify, сменили тему, изменили тарифный план Shopify или добавили приложение для оформления заказа или редактирования заказов.

Почему это происходит: приложения Shopify могут совместно использовать разрешения, изменять данные заказов или изменять способ создания заказов. Удаление одного приложения может отозвать доступ, от которого зависело другое. Приложения для редактирования заказов и допродаж могут создавать формы заказов, которые коннектор не ожидает и на которых молчаливо терпит неудачу.

Исправление:

1. Постройте временную шкалу. Сопоставьте дату остановки синхронизации с вашим журналом изменений — Shopify ведет запись активности магазина, а история установки ваших приложений находится в административной панели.
2. Сначала переподключитесь. Нарушение разрешений выглядит точно так же, как Класс 1, и исправление для Класса 1 — полная повторная авторизация с учетной записью администратора — решает большинство из них.
3. Протестируйте на одном заказе. Если заказы, затронутые одним конкретным приложением, не проходят, а другие синхронизируются, вы его изолировали.
4. Эскалируйте с конкретикой. Свяжитесь со службой поддержки коннектора и со службой поддержки приложения с датой сбоя, примерами номеров заказов и временной шкалой. Конкретные доказательства превратят двухнедельный тикет в двухдневный.

Когда ваша интеграция QuickBooks Shopify не работает по замыслу

Теперь честная часть. Посмотрите на класс, который вы только что исправили, и спросите: это была ваша проблема или проблема инструмента?

Ваши проблемы решаются один раз и остаются решенными. Привычка добавлять вместо сопоставления. Обзор сопоставления, который никто не запланировал. Интеграция, подключенная под учетной записью бывшего сотрудника. Электронные письма об отключении попадают в спам. Ни одна из этих проблем не повторится, если вы примете меры предосторожности — и ни один инструмент, какой бы цены он ни был, не решит их за вас.

Потолки инструментов возвращаются, что бы вы ни делали. Плата, которую нельзя разбить по депозитам за выплату. Типы заказов или каналы, которые коннектор никогда не поддерживает. Частота синхронизации, которую вы не можете изменить. Нет способа заполнить пробел без ручного ввода. Если ваше «исправление» превратилось в ежемесячный ритуал — повторяющуюся запись в журнале, повторяющуюся очистку, повторяющийся ручной импорт — вы не исправили интеграцию. Вы стали ее частью.

Ни один из вердиктов не является оскорблением. Бесплатный или начальный коннектор, выполняющий именно то, для чего он был создан, при вашем объеме, — это совершенно правильный ответ. Многим магазинам следует исправить привычку, сохранить инструмент и прекратить чтение здесь. Различие имеет значение, потому что два вердикта имеют противоположные следующие шаги: один — это напоминание в календаре, другой — миграция.

Если вы зашли на эту страницу в третий раз

Если вы добавили эту запись в закладки, то закладка — это показатель. Устранение неполадок синхронизации один раз — это обслуживание. Устранение неполадок каждый месяц — это подписка, оплачиваемая воскресными вечерами.

Если вы там, три прочтения, по порядку:

• Обзор коннектора QuickBooks Shopify — что делает бесплатный коннектор хорошо и где именно он останавливается, чтобы вы могли назвать свой потолок, а не угадывать.
• Перерастание бесплатного коннектора QuickBooks — как перейти на более мощный инструмент синхронизации, не переделывая свою историю.
• Лучшее программное обеспечение для бухгалтерского учета Shopify — полное поле того, куда вы будете мигрировать, включая инструменты, которые превосходят наши для конкретных задач.

И раскрытие информации сверху, выполненное: мы делаем LedgerPort, платный синхронизатор Shopify и WooCommerce → QuickBooks, построенный вокруг потолков, описанных в этом посте — журналы выплат с разбивкой платы по депозитам, сопоставление, которое вы контролируете, и пробелы в синхронизации, которые вы можете видеть и исправлять, а не обнаруживать во время налогового периода. Бесплатный план охватывает 30 заказов в месяц — достаточно, чтобы провести одну реальную выплату и проверить, исчезнет ли Класс 4 из вашей жизни. Если нет, вы потеряли пять минут, и вы уже провели триаж быстрее, чем это сегодня.