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