Разлики

Тук са показани разликите между избраната и текущата версия на страницата.

--- supto:interfeisi:web_site [2020/01/15 10:10] – [Проследяване изпълнението на интерфейсите] m.ayvazova
+++ supto:interfeisi:web_site [2020/08/24 08:57] (текуща) – [Справка състояние поръчки за импорт] m.ayvazova
@@ Ред 1: / Ред 1: @@
 ====== Интерфейс с уеб сайт (например Magento) ======
 ===== Общо описание =====
+{{ :supto:interfeisi:връзка_сайт.png |}}
 A-SUPTO SelMatic ERP има изградена автоматична връзка с уеб сайт.
@@ Ред 40: / Ред 41: @@
 Половината от Импортера, която се разработва от Селматик, отговаря на следните изисквания:
-. На определени интервали от време (в рамките на 48 часа или по-често), API-2-ешоп автоматично опитва да подаде към API-1-Селматик, всички данни за поръчки, клиенти и друга спомагателна информация (например коментар на клиента, телефон за контакт, адрес за доставка и др.), за които все още няма потвърждение от API-1-Селматик, че са успешно импортирани в A-SUPTO SelMatic ERP.
+. На определени интервали от време (в рамките на 48 часа или по-често), API-2-ешоп автоматично опитва да подаде
-. Ако някой от подадените записи съдържа невалидни данни, API-1-Селматик отказва импорта и връща съобщение за грешка, което може да се коригира от човек, който отговаря за поддръжката на API-2-ешоп, от страна на уеб разработчика (различен от Селматик), след което същият се активира за повторен опит за импорт. Никой такъв проблемен запис не може да бъде загубен, защото се записва в лог таблицата на API-1-Селматик. ЗАБЕЛЕЖКА: Понякога възникват сложни за разрешаване казуси, които изискват работа на разработчиците и от двете страни. Това може да отнеме няколко дни. Така  генерирането на УНП в A-SUPTO SelMatic ERP и последваща обработка на поръчката и плащанията по нея, може да се забави с няколко дни, спрямо момента на първоначално получаване на поръчка в Уеб сайта.
+     към API-1-Селматик, всички данни за поръчки, клиенти и друга спомагателна информация (например коментар на
-. Така A-SUPTO SelMatic ERP осигурява чрез API-1-Селматик, зареждане в базата данни на всички автоматично подадени от API-2-ешоп заявки от електронния магазин, в пълен обем и с непроменено съдържание.
+     клиента, телефон за контакт, адрес за доставка и др.), за които все още няма потвърждение от API-1-Селматик,
-. При успешно валидиране на данни, в момента на създаване на Поръчка в  A-SUPTO SelMatic ERP, се проверява за връзка с фискално устройство и автоматично се генерира УНП. Ако в момента фискалното устройство не комуникира, импорта спира и към API-2-ешоп се връща съобщение за грешка, за да може по-късно данните да се подадат отново.
+     че са успешно импортирани в A-SUPTO SelMatic ERP.
-. Импортера в A-SUPTO SelMatic ERP, не генерира фискален бон за подадената информация за плащания, защото към този момент, данните все още не са обработени от човек. Такъв се издава, непосредствено преди предаване на стоката на куриер или клиент, защото чак тогава, за първи път тази информация се обработва и се потвърждава изпълнението на поръчка и плащането.
+. Ако някой от подадените записи съдържа невалидни данни, API-1-Селматик отказва импорта и връща съобщение за
-. За всички импортирани поръчки се съхранява следната структурирана информация:  Дата и време на импорт в A-SUPTO SelMatic ERP;  Източник на импорта – (напр. електронен магазин, наименование на е-магазина, домейн, др.);  Уникален номер на поръчката, присвоен в електронния магазин;  Пълни данни за всяка импортирана поръчка (съгласно т. 3).
+     грешка, което може да се коригира от човек, който отговаря за поддръжката на API-2-ешоп, от страна на уеб
-. За всички импортирани поръчки Импортерът прави обвръзка между номерата им, присвоени в софтуера на електронния магазин и генерираните за тях УНП.
+     разработчика (различен от Селматик), след което същият се активира за повторен опит за импорт. Никой такъв
+     проблемен запис не може да бъде загубен, защото се записва в лог таблицата на API-1-Селматик.
+     **ЗАБЕЛЕЖКА:** Понякога възникват сложни за разрешаване казуси, които изискват работа на разработчиците и от
+     двете страни. Това може да отнеме няколко дни. Така  генерирането на УНП в A-SUPTO SelMatic ERP и последваща
+     обработка на поръчката и плащанията по нея, може да се забави с няколко дни, спрямо момента на първоначално
+     получаване на поръчка в Уеб сайта.
+. Така A-SUPTO SelMatic ERP осигурява чрез API-1-Селматик, зареждане в базата данни на всички автоматично
+     подадени от API-2-ешоп заявки от електронния магазин, в пълен обем и с непроменено съдържание.
+. При успешно валидиране на данни, в момента на създаване на Поръчка в  A-SUPTO SelMatic ERP, се проверява за
+     връзка с фискално устройство и автоматично се генерира УНП. Ако в момента фискалното устройство не комуникира,
+     импорта спира и към API-2-ешоп се връща съобщение за грешка, за да може по-късно данните да се подадат отново.
+. Импортера в A-SUPTO SelMatic ERP, не генерира фискален бон за подадената информация за плащания, защото към
+     този момент, данните все още не са обработени от човек. Такъв се издава, непосредствено преди предаване на
+     стоката на куриер или клиент, защото чак тогава, за първи път тази информация се обработва и се потвърждава
+     изпълнението на поръчка и плащането.
+. За всички импортирани поръчки се съхранява следната структурирана информация:  Дата и време на импорт в
+     A-SUPTO SelMatic ERP;  Източник на импорта – (напр. електронен магазин, наименование на е-магазина, домейн,
+     др.);  Уникален номер на поръчката, присвоен в електронния магазин;  Пълни данни за всяка импортирана поръчка.
+. За всички импортирани поръчки Импортерът прави обвръзка между номерата им, присвоени в софтуера на
+     електронния магазин и генерираните за тях УНП.
 Поведението и структурата на API-2-ешоп, задължително трябва да са съвместими с изискванията на API-1-Селматик, защото преди импорт данните се валидират структурно. Изцяло в контрола на фирмата разработчик на уеб сайта, са съдържанието на базата данни на Уеб сайта/Онлайн магазина, а също тяхното и на API-2-ешоп поведение. A-SUPTO SelMatic ERP няма (и дори теоретично не е възможно да има!) контрол върху съдържанието, записвано в базата данни на онлайн платформата или подавано през API-2-ешоп, защото те се разработват и поддържат от друга фирма. API-1-Селматик гарантира, че записва цялата подадена информация, в пълният и непроменен вид. В A-SUPTO SelMatic ERP се импортират само валидни данни, а ако бъдат подадени невалидни такива, те се записват в лог таблица (по-долу има подробно описание) и след корекция или допълване, се пускат през автоматичният импорт за нов опит.
@@ Ред 59: / Ред 79: @@
 При двоен клик с левия бутон на мишката върху името на съответния източник може да се достъпи кода на скрипта.
+{{ :supto:interfeisi:код_скрипт.png |}}
 //(Екранната снимка е реализирана с логнат в системата Одиторския профил и съдържа примерни данни)//
@@ Ред 75: / Ред 95: @@
          * подробно описанието на грешката (ако е имало такава)
-**ВНИМАНИЕ!** В тази таблица се вписват редове при изпълнение на интерфейси НЕ засягащи СУПТО-то и продажбения процес и затова не е възможно да се използва само и единствено тя за СУПТО логовете.
+<box round orange|**ВНИМАНИЕ!**> В тази таблица се вписват редове и при изпълнение на интерфейси НЕ засягащи СУПТО-то и продажбения процес и затова не е възможно да се използва само и единствено тя за СУПТО логовете.</box>
   * **SUPTO$INTERFACE_LOG** - таблицата е специално разработена за целите на проследяване импорта на хедърите на поръчки от външни системи спрямо изискванията на Н-18 с полета:
@@ Ред 93: / Ред 113: @@
 В менюто със СУПТО справките, което е достъпно от Одиторския профил са създадени две справки, които се изпълняват върху описаните по-горе таблици и визуализират през интерфейса на програмата пълен лог за изпълнението на импортите и актуално състояние за всяка една поръчка в електронния магазин (дали е успешно импортирана в 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 документация

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

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

Разлики

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