Как да свържа магазина си в WooCommerce с inv.bg?
Тази функционалност е налична при някои от корпоративните ни планове. Ако искате да ви я добавим, ни пишете на support@inv.bg
Можете да свържете магазина си в WooCommerce с акаунта си в inv.bg и фактурите за платените поръчки ще се издават и изпращат автоматично.
Връзката става чрез ключ за достъп, който създавате в WooCommerce - Потребителски ключ (Consumer key) и Потребителски секретен ключ (Consumer secret). Не е нужно да инсталирате разширение в WordPress. Настройката отнема около 5 минути.
(Нужни са ви администраторски достъп до WordPress, WooCommerce 9.0 или по-нова версия и сайт с https. Снимките са от българския интерфейс на WordPress и WooCommerce.)
Какъв е адресът на магазина ви?
- в WordPress отворете Настройки → Общи
- адресът е в полето Адрес на сайта (URL)
В inv.bg ще го въведете без https://, например shop.example.bg или example.com/shop.
Как да проверите постоянните връзки?
inv.bg се свързва с магазина ви през адрес от вида shop.example.bg/wp-json/, който работи само ако за постоянните връзки не е избрано Обикновен.
- в WordPress отворете Настройки → Постоянни връзки
- изберете например Име на публикация
- натиснете Запазване на промените
Как да включите ДДС в WooCommerce?
Ако фирмата ви е регистрирана по ДДС, inv.bg издава фактурата автоматично само когато WooCommerce е начислил ДДС по всеки ред от поръчката (20% или 9% за поръчки в България). Ако магазинът не начислява ДДС, поръчките остават за преглед и фактурата се издава ръчно.
- отворете WooCommerce → Настройки → Основни
- сложете отметка при Включване на данъчни стойности и калкулиране
- натиснете Запазване на промените
- отворете раздел Такси и изберете Стандартни ставки
- добавете ред с код на страната BG и ставка 20
- ако продавате стоки с 9% ДДС, добавете ставката им в Reduced rate ставки
Как да създадете ключ за достъп в WooCommerce?
- отворете WooCommerce → Настройки → Разширени
- изберете REST API keys и натиснете Добавяне на ключ
Попълнете формата:
- Описание (1) - например inv.bg
- Потребител (2) - администратор на магазина
- Права (3) - Четене/Писане
- натиснете Генериране на API ключ (4)
inv.bg само чете поръчките ви и не променя нищо в тях. Правата за писане са нужни, за да създаде уведомленията, с които магазинът съобщава на inv.bg за всяка нова или променена поръчка.
- копирайте Потребителски ключ (1) и Потребителски секретен ключ (2) с бутоните Копиране
(Секретният ключ се показва само веднъж. Ако го загубите, анулирайте ключа и създайте нов. Не го изпращайте по имейл и не го споделяйте.)
Как да свържете магазина в inv.bg?
- влезте в Настройки (горе вдясно)
- от секцията Онлайн магазини изберете Свързани магазини
- натиснете Добави нов магазин
Попълнете формата:
- Вид магазин (1) - WooCommerce
- Име на магазина (2) - име, по което ще го различавате в inv.bg
- Адрес на магазина (3) - адресът от Настройки → Общи в WordPress, например shop.example.bg
- Потребителски ключ (4) - потребителският ключ от WooCommerce
- Потребителски секретен ключ (5) - потребителският секретен ключ от WooCommerce
- Език на фактурите (6) - на какъв език да се издават фактурите
- Артикули и превод (7) - какви имена на артикулите да излизат във фактурите
- сложете отметка при При автоматично издаване изпращай фактурата на имейла на клиента, ако искате фактурите да стигат до клиентите по имейл
- натиснете Запиши и тествай (8)
Можете да изберете дали фактурите да се изпращат като линк или като прикачен файл. Препоръчително е да са като линк, тъй като само така можете да проследите тяхното приемане.
Ако всичко е наред, ще видите Връзката с WooCommerce е успешна. Магазинът се появява в списъка със статус Активна и от този момент новите поръчки идват в inv.bg автоматично. Поръчките, направени преди свързването, не се импортират.
При свързването inv.bg създава в WooCommerce уведомления с име inv.bg. Виждате ги в WooCommerce → Настройки → Разширени → Webhooks. Не ги изтривайте - чрез тях поръчките идват веднага.
Всички поръчки от свързаните магазини виждате в раздел Поръчки. За платените поръчки има издадена фактура, а тези, които изискват вашето внимание, са за преглед.
На какъв език ще са фактурите и артикулите в тях?
Това избирате във формата на магазина, в секцията Език и артикули в документи.
По-късно можете да го смените от Свързани магазини → Редакция.
Език на фактурите
- Според държавата на получателя - клиентите от България и тези без посочена държава получават фактурата на български, а клиентите от други държави - на английски
- Винаги на български
- Винаги на английски
Езикът се записва към клиента в inv.bg - на него са и PDF файлът, и имейлът, с който изпращате фактурата.
Артикули и превод
- На езика на фактурата, при съвпадение на кат.номер (SKU) - ако в inv.bg имате артикул с каталожен номер, еднакъв със SKU на продукта в WooCommerce, във фактурата излиза името на артикула от inv.bg, а във фактура на английски - английското му име. Ако такъв артикул няма (или във фактура на английски артикулът няма английско име), излиза името на продукта от магазина.
- На езика от магазина - във фактурата винаги излиза името на продукта от WooCommerce.
Тези настройки важат за фактурите, които inv.bg издава автоматично.
Какво да направите, ако нещо не работи?
"Сайтът не отговаря на /wp-json/"
- изберете за постоянни връзки, различно от Обикновен
- ако използвате защитна стена (например Wordfence или Cloudflare), разрешете достъпа до адресите, които започват с /wp-json/
"Адресът на магазина в WordPress е …"
Въведете адреса точно както е в Настройки → Общи → Адрес на сайта (URL) в WordPress - например с www, ако там е с www.
"Нужен е WooCommerce 9.0 или по-нов"
Обновете WooCommerce от Разширения в WordPress и запишете магазина отново.
"Връзката с WooCommerce е неуспешна със грешка: WooCommerce rejected the API key …"
- проверете дали не сте разменили потребителския ключ и секретния ключ
- проверете дали ключът не е анулиран в WooCommerce → Настройки → Разширени → REST API keys
- ако сте създали нов ключ, въведете го в inv.bg от Свързани магазини → Редакция
"Интеграцията е записана, но абонаментът за уведомления от магазина не можа да бъде създаден"
Ключът е с права само за четене. Сменете Права на Четене/Писане в WooCommerce и запишете магазина в inv.bg отново.
Поръчка с наложен платеж не се появява като платена
WooCommerce смята поръчката с наложен платеж за платена едва когато смените статуса ѝ на Приключена. Дотогава тя чака плащане в inv.bg, а след това е за преглед и издавате фактурата ръчно.
Поръчката е "за преглед" с причина "ДДС третиране"
WooCommerce не е начислил ДДС по поръчката. Включете ДДС в WooCommerce за следващите поръчки, а за тази натиснете прегледай и издайте фактурата ръчно или свържете вече издадена.
Фактурата е издадена на името на човека, а не на фирмата
inv.bg разпознава фирмените данни (ЕИК, ДДС номер, МОЛ) от разширението Bulgarisation for WooCommerce и от разширенията за ДДС номер. Ако събирате фирмените данни с друго разширение, пишете ни на support@inv.bg.
Ако искате да прекратите връзката:
В inv.bg изтрийте магазина от Свързани магазини - уведомленията в WooCommerce се изтриват автоматично.
След това анулирайте ключа в WooCommerce → Настройки → Разширени → REST API keys.
Какви са вариантите за интеграция с inv.bg?