QuickBooks Online для WooCommerce — инвойсы, клиенты, sales tax и платежи из заказов

Accounting Sync with QuickBooks for WooCommerce отправляет заказы магазина в QuickBooks Online как инвойсы: с клиентом, адресами, строками товаров, доставки и сборов и с тем sales tax, который посчитал WooCommerce. Без дублей и с повторами, если QuickBooks недоступен. Pro добавляет платежи, возвраты, товары QuickBooks по SKU и остатки из QuickBooks.

Версия 1.0.0 — для компаний QuickBooks Online в США.

Важно до установки: каждый магазин подключается через собственное приложение Intuit, созданное в кабинете разработчика developer.intuit.com. Пошаговая инструкция и адрес возврата есть в настройках плагина. Тестовые ключи приложения работают только с тестовой компанией Intuit, для магазина нужны боевые.

Что видит покупатель

Покупатель ничего нового не видит: оформление заказа не меняется. Инвойс в QuickBooks появляется, когда заказ переходит в выбранный статус, а сумма инвойса равна сумме заказа.

Что получает админ

WooCommerce → Accounting Sync: вкладки Connection, Mapping, Queue, Log и License. На Connection — ключи вашего приложения Intuit (тестовые или боевые), «Connect to QuickBooks», статусы, от которых идёт инвойс, префикс и срок оплаты.

На Mapping выбираете товары и услуги QuickBooks для товаров, доставки и сборов, код sales tax, а в Pro — счёт для платежей, способ оплаты для каждого способа оплаты магазина и сопоставление по SKU. Queue показывает каждый документ, номер в QuickBooks и причину остановки.

Как это работает, шаг за шагом

1. На developer.intuit.com создаёте приложение с доступом Accounting, добавляете адрес возврата из настроек и копируете Client ID и secret в плагин.
2. «Connect to QuickBooks» открывает вход Intuit, вы выбираете компанию.
3. На Mapping выбираете товары и услуги, код sales tax и, в Pro, счета для платежей.
4. Заказ в выбранном статусе встаёт в очередь, и инвойс уходит в QuickBooks; перед созданием модуль ищет, нет ли такого уже.
5. В Pro за инвойсом идёт платёж, возврат становится Refund Receipt или Credit Memo, а остатки каждый час берутся из QuickBooks по SKU.

Что под капотом

• Secret и токены хранятся зашифрованными; обновление токена — под блокировкой базы.
• У каждого документа есть метка заказа в memo, и перед созданием модуль ищет его; запрос идёт с requestid, поэтому повтор не создаёт второй инвойс.
• Очередь повторяет до двух суток, 429 ставит её на паузу, 401 обновляет токен и пробует ещё раз.
• Строки, на которые WooCommerce начислил налог, помечаются как облагаемые, остальные — нет, а сумма налога берётся из WooCommerce, чтобы QuickBooks не считал её второй раз.
• Остатки из QuickBooks (Pro) перезаписывают остаток WooCommerce только для товаров с тем же SKU и только если вы это включили.
• Весь sales tax заказа идёт на один выбранный код налога: если собираете налог в нескольких штатах, код стоит выбрать с бухгалтером.
• Совместимо с HPOS, блочным и классическим оформлением; язык плагина: English.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → Accounting Sync → Connection: создайте приложение Intuit по подсказке.
3. Вставьте Client ID и secret, нажмите «Connect to QuickBooks» и выберите компанию.
4. Заполните Mapping и проведите тестовый заказ на тестовой компании Intuit.
5. Для Pro: вставьте ключ или запустите 7 дней триала на вкладке License.

Кнопка «Скачать бесплатно» даёт бесплатную версию; такая же уйдёт на wordpress.org. Pro — полный архив, он появляется в кабинете после покупки или триала.