Abby для WooCommerce — заказы в счета Abby

Abby FR for WooCommerce передаёт заказы WooCommerce в ваш аккаунт Abby (abby.fr), сервис счетов и учёта для французских фрилансеров и микропредпринимателей. Из одного заказа в Abby появляются клиент и черновик счёта со всеми строками, доставкой и сборами, так что веб-заказы больше не нужно перепечатывать. Модуль работает через публичный API Abby с вашим собственным ключом.

Что делает бесплатная версия

На странице заказа появляется блок Abby FR с кнопкой «Send to Abby» (то же есть в меню действий заказа). Модуль находит или создаёт клиента в Abby: частное лицо, а если в заказе есть название компании и SIRET, то бизнес-клиента. Затем создаёт черновик счёта: каждый товар, доставка и сборы отдельными строками, скидки уже учтены, у каждой строки код НДС по её ставке (2,1, 5,5, 8,5, 10 или 20 %, или без НДС). В счёт попадает примечание с номером заказа и способ оплаты. Сумму, которую посчитал Abby, модуль сверяет с суммой заказа. Кнопка «Invoice PDF» открывает PDF прямо из Abby. Повторное нажатие ничего не дублирует, а если Abby отказал, причина остаётся в блоке и в заметках заказа, и отправку можно продолжить с того же места. После возврата средств в заказе появляется заметка, что в Abby нужно оформить кредит-ноту.

Что добавляет Pro

Автоматическая отправка, когда заказ переходит в выбранный статус, с тремя попытками при сбое. Завершение счёта в Abby и отметка «оплачено» со способом оплаты заказа. Письмо покупателю с PDF счёта сразу после завершения, тот же PDF прикладывается и к письму «Детали заказа», отправленному вручную. Кредит-нота (avoir) из счёта при полном или частичном возврате. Товары добавляются в каталог Abby при первой продаже. Массовое действие в списке заказов для старых заказов и список неудачных отправок с кнопкой повтора.

Что стоит знать заранее

• API Abby входит не во все тарифы. Если Abby не принимает ключ, проверьте в кабинете, есть ли API в вашем тарифе.
• По умолчанию цены идут в счёт без НДС (HT), и НДС добавляет сам Abby. В магазине, где цены введены с НДС, из-за округления сумма может отличаться на 1 цент. Тогда счёт остаётся черновиком: модуль пишет об этом в заказе и не завершает и не отправляет его автоматически.
• Режим «С НДС (TTC)» даёт суммы цент в цент, но Abby принимает его только тогда, когда в вашем аккаунте включены цены с НДС.
• В Abby есть только французские ставки НДС. Заказ с другой ставкой (например, продажа в другую страну ЕС по её ставке) или в другой валюте не отправляется, причину видно в заказе.
• Завершённый счёт в Abby не редактируется: его исправляет только кредит-нота.
• Модуль передаёт данные из магазина в Abby. Изменения, сделанные в Abby, в магазин он не читает.

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

1. В Abby откройте Настройки → Интеграции и создайте ключ API. Скопируйте его сразу: Abby показывает ключ только один раз.
2. В WooCommerce → Abby FR вставьте ключ и сохраните. Соединение проверяется сразу.
3. Выберите язык документов, режим цен, код для строк без НДС и способ оплаты.
4. Откройте заказ и нажмите «Send to Abby». Проверьте черновик в Abby и завершите его там, либо включите автоматику Pro.

Под капотом

• Каждый шаг отправки запоминается, поэтому повтор или сбой посреди отправки не создаёт второй счёт.
• Один и тот же адрес e-mail или SIRET всегда попадает на того же клиента Abby.
• PDF не хранится на сайте: он каждый раз берётся из Abby.
• Модуль ничего не добавляет в корзину и на страницу оформления. Совместим с HPOS; языки: English, français.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → Abby FR: вставьте ключ API и сохраните.
3. Проверьте настройки счетов.
4. Попробуйте на одном заказе, прежде чем включать автоматику.

Модуля пока нет на wordpress.org: бесплатная версия и Pro — один архив с этой страницы. Без ключа он работает как бесплатная версия.