API интеграции¶

На тази страница конфигурираш интеграциите през API между Planograma и външните системи, с които работи твоята компания: e-commerce платформи и ERP системи. Една активна интеграция позволява на Planograma да приема автоматично поръчки, приемания (NIR) или разходни бележки от външната система и да изпраща обратно стокове и статуси, докато документите се обработват в склада.

Note

Конфигурирането на интеграциите е операция по администриране. Опциите са видими и могат да бъдат запазени само от потребители с ниво на разрешение администратор. Определени действия (например пълна повторна синхронизация на данните) са запазени за суперадминистратора.

Налични интеграции¶

Всяка интеграция се активира чрез превключвател (switch). Интеграциите се изключват взаимно: когато активираш една, останалите се деактивират автоматично, защото един tenant комуникира в даден момент само с една външна система.

Интеграция	Тип система	Активиране
SofTech	ERP	превключвател "Комуникация със SofTech"
WinMentor	ERP	превключвател "Комуникация с Winmentor"
SoftOne	ERP	превключвател "Комуникация със SoftOne"
Nexus	ERP	превключвател "Комуникация с Nexus"
GoMag	e-commerce платформа	превключвател "Комуникация с GoMag"
EasySales	e-commerce платформа	превключвател "Комуникация с EasySales"
MerchantPro	e-commerce платформа	превключвател "Комуникация с MerchantPro"

След като активираш дадена интеграция, под превключвателя се появяват специфичните полета за конфигуриране (данни за свързване, опции за синхронизация и съответствията на статусите).

Общи опции за синхронизация¶

Независимо от избраната система, интеграциите предоставят общ набор от опции, под формата на превключватели:

Синхронизация на поръчки — Planograma приема поръчките (изходящите) от външната система.
Синхронизация на NIR — Planograma приема документите за приемане (входящите) от външната система.
Синхронизация на разходни бележки — Planograma приема разходните бележки от външната система.
Изпращане на стокове — Planograma изпраща обратно към външната система актуализираните стокове.

Note

Не всички опции са налични при всяка интеграция. Например синхронизацията на NIR се появява само при ERP системите (Nexus, SoftOne, WinMentor), а изпращането на сток се появява при e-commerce платформите и при част от ERP системите.

Съответствие на статусите (Status ID)¶

За интеграциите с поръчки и NIR попълваш съответствията на статусите между Planograma и външната система, групирани в Настройки Status ID Изходящи и Настройки Status ID Входящи:

Status ID за допустимост на приемане на изходяща в Planograma — статусът от ERP, при който една изходяща става допустима за приемане в Planograma.
Status ID допустим за изпращане на документ в пикинг — статусът, при който документът се изпраща в пикинг.
Status ID в ERP при финализиране на пикинга на изходящата — статусът, зададен в ERP, когато пикингът на изходящата е приключил.
Status ID в ERP при финализиране на връщането — статусът, зададен в ERP при финализиране на връщане.
Status ID, съответстващ на изтрита изходяща (обикновено 0) и Status ID, съответстващ на върната изходяща.
Еквивалентите от страната на входящите: Status ID за допустимост на приемане на входяща, Status ID в ERP при финализиране на обработката на входящата, Status ID, съответстващ на изтрита входяща.

Стойностите са идентификаторите на статуси, използвани от твоята външна система; получаваш ги от конфигурацията на тази система.

Данните за свързване за всяка интеграция¶

В зависимост от активираната интеграция, попълваш следното:

SofTech — ID на Колекция, Потребителски акаунт, Източник на данни, Код на Складова единица за изходящи стокове, Код на Складова единица за входящи стокове, Име на Комисионер, Код на Разходен център, Код на Печалбен център.
WinMentor — IP, Порт и съответствията на статусите (Анулирана, Обработена, Блокирана, Затворена).
SoftOne — ID на приложението, URL на приложението, Потребител на приложението, Парола на приложението, Серия NIR и съответствията на статусите за изходящи и входящи.
Nexus — IP, Порт, API Key, плюс филтрите за четене на поръчките (виж по-долу).
GoMag — ID на приложението, URL на приложението и съответствията на статусите.
EasySales — URL на приложението, съответствията на статусите и API ключ (раздел Credentiale, виж по-долу), плюс списъка с уебсайтове.
MerchantPro — URL на приложението, съответствията на статусите и API ключ (раздел Credentiale).

Филтрите за поръчки на Nexus¶

За Nexus, под "Конфигуратор за четене на поръчки" имаш допълнителни превключватели, които ограничават кои поръчки се приемат: само напълно резервирани поръчки, включи затворени поръчки, само твърди поръчки, само одобрени поръчки, включи одобрени за доставка поръчки, включи изпълнени поръчки, включи детайли на линиите, включи компонентите на съставните продукти.

Генериране и управление на API ключ¶

За интеграциите, които използват API ключ (например EasySales и MerchantPro), в раздела Credentiale попълваш:

Api Key — ключът (идентификаторът), издаден от външната платформа.
Api Secret — секретът, асоцииран с ключа.
URL на API — адресът на API endpoint-а на платформата (идва предварително попълнен със стойност по подразбиране, която можеш да промениш).

Натисни Добави, за да запазиш. Ключът се съхранява сигурно в Planograma; до етикета се появява визуален индикатор: зелена отметка, ако ключ вече е запазен, съответно предупредителен знак, ако все още не си въвел такъв.

Warning

От съображения за сигурност, секретът не се връща в явен вид след запазване. Ако трябва да смениш ключа, въведи новите стойности и запази отново — те ще заменят предишния ключ.

Уебсайтове (токен за всеки магазин)¶

При интеграциите, които поддържат няколко магазина (например EasySales), под Уебсайтове се появява списъкът с разпознатите магазини. Всеки магазин се показва като цветен етикет: зелен, ако вече има конфигуриран токен, съответно жълт, ако токенът липсва (виж съобщението при поставяне на мишката). Натисни върху магазин, за да отвориш прозореца, в който въвеждаш или нулираш Токена на този магазин, след това запази.

Повторна синхронизация и проверка¶

В зоната на интеграциите имаш и контролни действия:

Повторна синхронизация — задейства пълна повторна синхронизация на данните за текущия tenant. Това е действие, запазено за суперадминистратора, и го използваш след реконфигуриране или за да принудиш пълно подравняване с външната система.
Дата на последната синхронизация — показва момента на последната успешна синхронизация, като отправна точка за проверка дали интеграцията работи.
Проверка на интеграцията — потвърждава дали tenant-ът има поне една активна конфигурирана интеграция.

Note

След като запазиш конфигурацията на дадена интеграция, автоматичните синхронизации се изпълняват периодично във фонов режим. Ръчната повторна синхронизация е полезна само когато искаш незабавно подравняване, извън автоматичния график.