QuickBooks Online для OpenCart 2.3, 3.x и 4.x — инвойсы, sales tax, платежи и остатки

Accounting Sync for QuickBooks Online для OpenCart создаёт в QuickBooks Online инвойс из заказа: клиент по e-mail или новый, строки товаров, доставка, скидки, US sales tax до цента такой, как в OpenCart. В бесплатной версии — кнопкой на странице заказа с предпросмотром. Pro делает это по статусу, добавляет платежи и возвраты, возвращает статус оплаты из QuickBooks и берёт оттуда остатки.

Версия 1.0.0 — только для компаний QuickBooks Online в США: компанию из другой страны модуль не подключит и скажет об этом.

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

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

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

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

Расширения → Модули → Accounting Sync for QuickBooks Online: вкладки Connection, Invoice, Automation и Pro. Среда (тестовая или боевая), адрес возврата, ключи, компания, товары и услуги QuickBooks для товаров и доставки, sales tax.

На странице заказа есть панель QuickBooks: документы заказа с номерами, суммами и статусами, создание инвойса после просмотра, повтор. Отдельная страница «QuickBooks invoices» показывает все документы.

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

1. На developer.intuit.com создаёте приложение, добавляете адрес возврата из настроек и копируете Client ID и secret в модуль.
2. «Save and connect to QuickBooks» — входите в Intuit и выбираете компанию.
3. Выбираете товары и услуги QuickBooks для товаров, доставки и сборов.
4. На странице заказа просматриваете инвойс и создаёте его; в Pro это происходит само по статусу.
5. Pro каждые 30 минут проверяет неоплаченные инвойсы, ставит заказу выбранный статус после оплаты, а каждый час берёт остатки из QuickBooks по SKU.

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

• Secret и токены хранятся зашифрованными.
• Перед созданием документа модуль ищет его в QuickBooks, поэтому повтор не даёт второй инвойс.
• Sales tax: строки помечаются TAX или NON, а общая сумма налога равна налогу заказа до цента.
• Скидки распределяются по товарам, доставка и сборы идут отдельными позициями.
• Остатки из QuickBooks (Pro) перезаписывают количество товара с тем же SKU (или моделью, если SKU нет); опции сохраняют свои количества.
• Язык модуля: English.

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

1. Расширения → Установщик: загрузите архив под свою версию, не меняя имя файла.
2. OpenCart 3.x и 2.3: Расширения → Модификации → «Обновить».
3. Расширения → Модули → Accounting Sync for QuickBooks Online → установить → редактировать.
4. Создайте приложение Intuit по подсказке, вставьте ключи и подключите компанию.
5. Для Pro: вставьте ключ или запустите 7 дней триала на вкладке Pro.