Съдържание

Интерфейс с уеб сайт (например Magento)

Общо описание

A-SUPTO SelMatic ERP има изградена автоматична връзка с уеб сайт.

Импортера се състои от две части (API), които комуникират помежду си автоматично. API-1-Селматик, който е разработка на Селматик, и API-2-ешоп, който се създава и поддържа от Уеб разработчик, различен от Селматик. И двете части на импортера, функционират по предварително уговорен начин, автоматизирано, без участие на краен потребител.

База данни на A-SUPTO SelMatic ERP, а също поведението и структурата на API-1-Селматик не може да се променят от краен потребител, а само от производителя.

В Уеб сайта не се обработват продажби. Там само се приема информация за клиентски запитвания, поръчки и автоматични плащания (с банкова карта, Paypal, Epay и други неприсъствени плащания). След това информацията за тях, се подава през API импортера.

Половината от Импортера, която се разработва от Селматик, отговаря на следните изисквания: 

   1. На определени интервали от време (в рамките на 48 часа или по-често), API-2-ешоп автоматично опитва да подаде 
   към API-1-Селматик, всички данни за поръчки, клиенти и друга спомагателна информация (например коментар на 
   клиента, телефон за контакт, адрес за доставка и др.), за които все още няма потвърждение от API-1-Селматик,
   че са успешно импортирани в A-SUPTO SelMatic ERP. 
   2. Ако някой от подадените записи съдържа невалидни данни, API-1-Селматик отказва импорта и връща съобщение за 
   грешка, което може да се коригира от човек, който отговаря за поддръжката на API-2-ешоп, от страна на уеб
   разработчика (различен от Селматик), след което същият се активира за повторен опит за импорт. Никой такъв
   проблемен запис не може да бъде загубен, защото се записва в лог таблицата на API-1-Селматик. 
   **ЗАБЕЛЕЖКА:** Понякога възникват сложни за разрешаване казуси, които изискват работа на разработчиците и от
   двете страни. Това може да отнеме няколко дни. Така  генерирането на УНП в A-SUPTO SelMatic ERP и последваща
   обработка на поръчката и плащанията по нея, може да се забави с няколко дни, спрямо момента на първоначално
   получаване на поръчка в Уеб сайта.
   3. Така A-SUPTO SelMatic ERP осигурява чрез API-1-Селматик, зареждане в базата данни на всички автоматично
   подадени от API-2-ешоп заявки от електронния магазин, в пълен обем и с непроменено съдържание.
   4. При успешно валидиране на данни, в момента на създаване на Поръчка в  A-SUPTO SelMatic ERP, се проверява за
   връзка с фискално устройство и автоматично се генерира УНП. Ако в момента фискалното устройство не комуникира,
   импорта спира и към API-2-ешоп се връща съобщение за грешка, за да може по-късно данните да се подадат отново. 
   5. Импортера в A-SUPTO SelMatic ERP, не генерира фискален бон за подадената информация за плащания, защото към
   този момент, данните все още не са обработени от човек. Такъв се издава, непосредствено преди предаване на
   стоката на куриер или клиент, защото чак тогава, за първи път тази информация се обработва и се потвърждава
   изпълнението на поръчка и плащането. 
   6. За всички импортирани поръчки се съхранява следната структурирана информация:  Дата и време на импорт в
   A-SUPTO SelMatic ERP;  Източник на импорта – (напр. електронен магазин, наименование на е-магазина, домейн,
   др.);  Уникален номер на поръчката, присвоен в електронния магазин;  Пълни данни за всяка импортирана поръчка. 
   7. За всички импортирани поръчки Импортерът прави обвръзка между номерата им, присвоени в софтуера на
   електронния магазин и генерираните за тях УНП.

Поведението и структурата на API-2-ешоп, задължително трябва да са съвместими с изискванията на API-1-Селматик, защото преди импорт данните се валидират структурно. Изцяло в контрола на фирмата разработчик на уеб сайта, са съдържанието на базата данни на Уеб сайта/Онлайн магазина, а също тяхното и на API-2-ешоп поведение. A-SUPTO SelMatic ERP няма (и дори теоретично не е възможно да има!) контрол върху съдържанието, записвано в базата данни на онлайн платформата или подавано през API-2-ешоп, защото те се разработват и поддържат от друга фирма. API-1-Селматик гарантира, че записва цялата подадена информация, в пълният и непроменен вид. В A-SUPTO SelMatic ERP се импортират само валидни данни, а ако бъдат подадени невалидни такива, те се записват в лог таблица (по-долу има подробно описание) и след корекция или допълване, се пускат през автоматичният импорт за нов опит.

Техническо описание

За изпълнението на интерфейса (импортера) се използва REST технология с изпълнение на JSON заявки. С разработчика на софтуера използван от електронния магазин е договорен API, който се спазва при подаване на информация за всяка една поръчка, в противен случай импортера ще подаде грешка при валидацията на данните за импорт.

API-1-Селматик е неразделна част от декларираната версия на A-SUPTO SelMatic ERP. В тази връзка, всяка промяна в поведението или структурата на API-1-Селматик се третира, като промяна на A-SUPTO SelMatic ERP и води до редеклариране на версия. Чисто технически, Сорс кода на интерфейса (скриптовете) се съдържа в базата данни (това не са външни файлове, а код в базата данни) и може да бъде достъпен от одиторския профил.

Пояснение: В A-SUPTO SelMatic ERP понятието “скрипт” се използва за вградените в системата, специфични за клиента доработки, които допълват ядрото на системата. За разлика от скриптовете познати от други системи, тези в A-SUPTO SelMatic ERP не могат да бъдат изпълнявани от външен файл или да бъдат добавяни или променяни свободно, от краен потребител, дори и от такъв с администраторски права! Те се създават или променят, само от производител и са неразделна част от цялата система.

Информацията се намира в Номенклатурата на справки/скриптове достъпна от Главното меню - > Служебни номенклатури - > Справки/ скриптове.

При двоен клик с левия бутон на мишката върху името на съответния източник може да се достъпи кода на скрипта. (Екранната снимка е реализирана с логнат в системата Одиторския профил и съдържа примерни данни)

Промяна в сорс кода на интерфейса може да се извърши само от Служители на Селматик ЕООД, защото Номенклатурата на справки/скриптове е защитена с паролата на Производителя.

Проследяване изпълнението на интерфейсите

За да се проследи изпълнението на интерфейсите се използват няколко таблици в базата данни, в които интерфейсите записват информация при тяхното изпълнение. Описанието на таблиците и полетата се съдържа във файла с документацията на базата данни, но го прилагаме и тук:

ВНИМАНИЕ!

В тази таблица се вписват редове и при изпълнение на интерфейси НЕ засягащи СУПТО-то и продажбения процес и затова не е възможно да се използва само и единствено тя за СУПТО логовете.

Информацията в таблиците се попълва автоматично при изпълнение на интерфейсите с електронния магазин (импортерите на поръчки).

В менюто със СУПТО справките, което е достъпно от Одиторския профил са създадени две справки, които се изпълняват върху описаните по-горе таблици и визуализират през интерфейса на програмата пълен лог за изпълнението на импортите и актуално състояние за всяка една поръчка в електронния магазин (дали е успешно импортирана в A-SUPTO SelMatic ERP или не). *Екранната снимка е направена от менюто с логнат в системата Одиторски профил

Справка Лог за изпълнението на интерфейсите

Справката може да се стартира от главното меню на системата СУПТО Справки → Справка върху лог за изпълнението на интерфейсите

Справката визуализира детайлен лог за изпълнението на интерфейса (импортера) за импорт на поръчки от електронния магазин. Редовете, за които има някакъв проблем са оцветени в червено, за по-лесно открояване и обръщане на внимание на потребителя. Ако импорта е преминал успешно всички валидации и в A-SUPTO SelMatic ERP има създаден документ за поръчката, при двоен клик с левия бутон на мишката върху съответния ред на екран ще се отвори документа от програмата. В долната част на прозореца със справката е вложена справка за детайлите на съответната поръчка (реда от основната справка, който е маркиран с левия бутон на мишката), като:

Ако поръчката е успешно импортирана и подлежи на допълнителна обработка в A-SUPTO SelMatic ERP от потребител, то нейното съдържание може да бъде променено.

Например: След комуникация с клиента - той решава да промени поръчано количество от позиция Х. В този случай, реда в справката ще се оцвети в червено, защото ще има разлика между общата сума на количеството на артикулите получено при импорта и общата сума на количеството на артикулите в ТД в A-SUPTO SelMatic ERP.

В справката ще се визуализира дадена поръчка толкова пъти колкото е правен опита за нейния импорт, т.е. ще има толкова на брой редове.

Например: Прави се опит 10 пъти да се импортира дадена поръчка и всеки път има грешка във валидацията на заглавната й част и на 11 опит вече се импортира успешно. В справката ще се визуализират 11 реда.

*Екранната снимка е направена от тестова среда с логнат в системата Одиторски профил и всички данни в нея за примерни

Филтри, приложими към справката:

Колони на таблицата, в която се визуализират данните от справката:

От бутон Допълнителни може да се стартира Справка състояние поръчки за импорт.

Справка състояние поръчки за импорт

Справката може да сестартира от главното меню на системата СУПТО Справки → Справка състояние поръчки за импорт или от бутон Допълнителни от Справка върху лог за изпълнението на интерфейсите.

Основните принципи и начин на работа са като на гореописаната Справка Лог за изпълнението на интерфейсите. Единствената разлика е, че в тази справка за всяка поръчка от електронния магазин се визуализира 1 ред с крайното й състояние.

Например: Прави се опит 10 пъти да се импортира дадена поръчка и всеки път има грешка във валидацията на заглавната й част и на 11 опит вече се импортира успешно. В справката ще се визуализират 1 ред с информацията за импортираната поръчка. *Екранната снимка е направена от тестова среда с логнат в системата Одиторски профил и всички данни в нея за примерни

Към СУПТО Съдържание