SelMatic ERP документация

Страницата е само за четене. Може да разглеждате кода, но не и да го променяте. Обърнете се съм администратора, ако смятате, че това не е редно.
====== Интерфейс с уеб сайт (например Magento) ======
===== Общо описание =====
{{ :supto:interfeisi:връзка_сайт.png |}}
A-SUPTO SelMatic ERP има изградена автоматична връзка с уеб сайт. 
 
  * Към сайта се подават различни номенклатури:
         * Артикули (уникален идентификатор, име и др. характеристики)
         * Цени
         * Наличност
         * Клиенти и адреси
         * и др.
  * Към сайта се изпращат УНП на успешно създадените в A-SUPTO SelMatic ERP документи.
  * От сайта, към A-SUPTO SelMatic ERP се импортират:
         * Запитвания от клиенти - с данни за:
               * Клиент
               * Информация за документа в ешоп - уникален номер, дата и час на създаване
               * Артикули
               * Количество за отделните артикули
               * Ед. цена без ДДС, ТО%, ед. цена с ДДС, ДДС%, ст-т без ДДС, ст-т  ДДС, ст-т с ДДС за всеки отделен ред
               * Очакван начин на плащане
               * Желае ли фактура клиента
               * Данни за фактура (ако такава е поискана)
               * Условия свързани с доставката (Пример: Дали ще е с куриер?, До адрес ли ще се достави или ще се вземе от офис?, Ще се вземе от обект на ЮЛ собственик на ешопа? и т.н.)
         * Информация за плащания, регистрирани през автоматизираната платежна система на сайта
               * Дата и час на плащането
               * Начин на плащане (Примерно: С карта, PayPal, ePay и т.н.)
               * Сума на плащането
               * Валута
         * Данни за Клиенти:
               * Име на клиента
               * E-mail на клиента
               * Адреси за доставка 
               * и др. данни

Импортера се състои от две части (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 не могат да бъдат изпълнявани от външен файл или да бъдат добавяни или променяни свободно, от краен потребител, дори и от такъв с администраторски права! Те се създават или променят, само от производител и са неразделна част от цялата система.  

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

При двоен клик с левия бутон на мишката върху името на съответния източник може да се достъпи кода на скрипта.
{{ :supto:interfeisi:код_скрипт.png |}}
//(Екранната снимка е реализирана с логнат в системата Одиторския профил и съдържа примерни данни)//

Промяна в сорс кода на интерфейса може да се извърши само от Служители на Селматик ЕООД, защото Номенклатурата на справки/скриптове е защитена с паролата на Производителя.
===== Проследяване изпълнението на интерфейсите =====
За да се проследи изпълнението на интерфейсите се използват няколко таблици в базата данни, в които интерфейсите записват информация при тяхното изпълнение. 
Описанието на таблиците и полетата се съдържа във файла с документацията на базата данни, но го прилагаме и тук:
  * **SYS$INTERFACE_LOG** - в тази таблица се записва ред при изпълнението на интерфейса за импорт на поръчки (на хедър и на детайлна част от поръчката) с полета:
         * дата и час на събитието в лога (на изпълнението на интерфейса)
         * Външна система, от която се импортира
         * вид на събитието
               * S - успешно (на кратко от Success)
               * E - неуспешно (на кратко от Error)
         * кратко съобщение
         * подробно описанието на грешката (ако е имало такава)

<box round orange|**ВНИМАНИЕ!**> В тази таблица се вписват редове и при изпълнение на интерфейси НЕ засягащи СУПТО-то и продажбения процес и затова не е възможно да се използва само и единствено тя за СУПТО логовете.</box>

  * **SUPTO$INTERFACE_LOG** - таблицата е специално разработена за целите на проследяване импорта на хедърите на поръчки от външни системи спрямо изискванията на Н-18 с полета:
         * Номер на поръчката във външната система
         * Дата и час на поръчката във външната система
         * Номер на документа в A-SUPTO SelMatic ERP ако има създаден такъв
         * Връзка към таблица SYS$INTERFACE_LOG
         * Служебна информация за потребител създал и последно променил данните за реда в таблицата и дата на създаване и последна промяна
  * **SUPTO$INTERFACE_LOG_DE** - таблицата е специално разработена за целите на проследяване импорта на детайлите на поръчки от външни системни спрямо изискванията на Н-18 с полета:
         * Връзка към таблица SUPTO$INTERFACE_LOG
         * ID на артикула
         * Количество на реда
         * Стойност с ДДС на реда
         * Служебна информация за потребител създал и последно променил данните за реда в таблицата и дата на създаване и последна промяна

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

В менюто със СУПТО справките, което е достъпно от Одиторския профил са създадени две справки, които се изпълняват върху описаните по-горе таблици и визуализират през интерфейса на програмата пълен лог за изпълнението на импортите и актуално състояние за всяка една поръчка в електронния магазин (дали е успешно импортирана в A-SUPTO SelMatic ERP или не).
{{ :supto:interfeisi:справка_лог.png?400 |}}
//*Екранната снимка е направена от менюто с логнат в системата **Одиторски профил**//
==== Справка Лог за изпълнението на интерфейсите ====
 Справката може да се стартира от главното меню на системата //СУПТО Справки -> Справка върху лог за изпълнението на интерфейсите//

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

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

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

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

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

{{ :supto:interfeisi:справка_лог_интерф.png |}}
*Екранната снимка е направена от тестова среда с логнат в системата Одиторски профил и всички данни в нея за примерни

**Филтри, приложими към справката:**
  * Външна система 
  * Дата на поръчката ОТ-ДО в електронния магазин

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

  * Уникално ИД на събитието от таблица SYS$INTERFACE_LOG
  * Дата и час на събитието в таблица SYS$INTERFACE_LOG
  * Източник на импорта
  * Вид на съобщението
  * Кратко съобщение
  * Подробно описание
  * Уникално ИД реда в таблица SUPTO$INTERFACE_LOG 
  * Номер на поръчката от електронния магазин
  * Дата на поръчката от електронния магазин
  * Брой редове получени при импорта
  * Обща сума на количеството на артикулите получено при импорта
  * Обща ст-т с ДДС на артикулите получено при импорта
  * Уникален номер на документа създаден в A-SUPTO SelMatic ERP ако импорта е бил успешен
  * УНП (Ако трябва да се генерира такова)
  * Брой редове в ТД създаден при успешен импорт на поръчката от електронния магазин
  * Обща сума на количеството на артикулите в ТД създаден при успешен импорт на поръчката от електронния магазин
  * Обща ст-т с ДДС на артикулите в ТД създаден при успешен импорт на поръчката от електронния магазин
  * Сравнение - текстово описание на проблема (ако има такъв)

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

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

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

Към [[supto:sadarzanie|СУПТО Съдържание]]
SelMatic ERP документация

Инструменти за потребители

Инструменти за сайта

Инструменти за страници
