Интеграция на онлайн магазин с Плюс Минус

Публикувано на: 2025-12-08

Плюс Минус ERP предлага мощна API интеграция чрез своя Сървър API, която позволява на всеки онлайн магазин - независимо от платформата - да обменя данни в реално време с програмата. Това включва автоматично четене на наличности и цени от избран обект (склад) в базата на Плюс Минус, както и импорт на поръчки от магазина към складовата система.

Интеграцията е напълно независима от използваната платформа и може да се реализира чрез директни POST заявки към API сървъра или чрез експортиране на поръчки във външен JSON файл, който след това се зарежда в Плюс Минус.

Активиране на API достъп

За да ползвате интеграцията, е необходимо да закупите и активирате модул Сървър API към вашия абонамент за Плюс Минус. На сървърния компютър се инсталира Плюс Минус Сървър 7.

След инсталацията:

  • Отворете сървъра на адрес https://localhost:7000
  • Регистрирайте го със серийния номер на модул Сървър API;
  • Уверете се, че външният IP адрес е пренасочен към вътрешния IP на сървъра през порт 7000 (или друг избран порт) - това става с помощта на вашия интернет доставчик или мрежови администратор.

След успешно активиране, API сървърът е готов да приема заявки от външни системи.

От Плюс Минус ЕООД ще получите Serial Number и Token, които се поставят в папката на сървъра. Те са ключът за достъп до данните.

Какво може API интеграцията?

Чрез API сървъра вашият онлайн магазин може:

  • Да чете актуални наличности от избран склад в Плюс Минус;
  • Да чете цените от съответния склад;
  • Да бъде направен индивидуален импорт на поръчки (необходима е допълнителна доработка).

За разработчици: Пълната спецификация за POST заявките и форматите на обмен се предоставя по имейл от Плюс Минус ЕООД.

Готова интеграция с WooCommerce (WordPress)

Ако използвате WooCommerce, Плюс Минус предоставя специален плъгин, който прави цялата интеграция автоматична - без нужда от програмиране.

1. Инсталиране и активиране на плъгина

  • Влезте в администраторския панел на WordPress;
  • Отидете на Plugins → Add New → Upload;
  • Качете архива plusminus-woocommerce.zip (получен по имейл от Плюс Минус);
  • Инсталирайте и активирайте плъгина.

2. Настройки в WooCommerce

Отидете на Settings → Plus Minus и попълнете:

  • Serial Number и Token - от API сървъра (които са предоставени от фирма ПЛЮС МИНУС);
  • Company Name - наименованието на фирмата, точно както е добавено в Плюс Минус (с главни/малки букви);
  • Store Name - името на склада, от който да се четат наличности и цени. Името трябва да бъде изписано, точно както е в програмата (включително малки/главни букви).

Активирайте желаните функции:

  • Update available quantity - синхронизиране на наличности;
  • Update regular price - синхронизиране на цени;
  • Automatic update values - актуализация по график (на всеки час, 6 часа и др.).

Можете ръчно да:

  • Тествате връзката (Connection test);
  • Ръчно актуализирате наличности и цени (Manually update);
  • Импортирате нови продукти от Плюс Минус (Import all products);
  • Изтеглите поръчки като JSON файл (Download orders).

3. Експорт на поръчки

Активирайте Allow orders export. Автоматично се генерира Security key - той е нужен за импорт в Плюс Минус.

Можете да филтрирате:

  • Само поръчки с определен статус (напр. Completed);
  • Да изключите Cancelled, Draft, Failed.

4. Импорт на поръчки в Плюс Минус

В програмата Плюс Минус:

  • Отворете операция Документи (F4);
  • Добавете нов документ с:
    • Име: Импортиране на поръчки от WooCommerce
    • Тип: ИМП
    • Файл: importWooCommerce.pm

Попълнете:

  • Адрес на сайта: изписвате точният адрес на сайта, където се намира електронният
    магазин. Например: https://вашият-магазин.com;
  • Ключ за сигурност: поставя се стойността на полето Security key от настройките за
    експорт на поръчки;
  • Група партньори, АП Продажби население, АП Доставка и др.;
  • Дали да се записва като поръчка (П) или продажен документ (КБ/-ФЕ);
  • Дали да се включва доставката като отделен ред.

Стартирайте Импорт - поръчките се зареждат автоматично и се маркират като обработени, за да няма дублиране.