e-Mark API ինտեգրում․ ուղեցույց ՏՏ թիմերի համար
2026-07-28
Դրոշմավորման յուրաքանչյուր ներդրման ընթացքում ուշ թե շուտ տեխնիկական կողմից հնչում է նույն հարցը՝ մենք ունենք հասանելիության տվյալներ, ինչու՞ ինտեգրումը պարզապես REST հարցում չէ։ Ազնիվ պատասխանն այն է, որ e-Mark API-ն ունիվերսալ տվյալների հոսք չէ, այլ կարգավորվող, վիճակ-կախյալ համակարգ, և մի քանի ճարտարապետական որոշում սկզբում է որոշում, թե արդյոք ինտեգրումը կմնա հուսալի արտադրական ծավալի պայմաններում, թե՞ կխափանվի աննկատ բեռի տակ։ Ինչ է իրականում տրամադրում API-ն e-Mark API-ն ընդգրկում է մի քանի տարբեր գործողություններ, ոչ թե մեկը՝ DataMatrix կոդերի պահանջում և ստացում, շրջանառության իրադարձությունների ուղարկում (կոդը մտնում կամ դուրս է գալիս շրջանառությունից), կոդի կամ խմբաքանակի կարգավիճակի ստուգում, ապրանքի և GTIN գրանցում։ Յուրաքանչյուրն ունի իր հարցումների սահմանաչափերը, խափանման սցենարները և կրկնման կանոնները։ Դրանք բոլորը մեկ «API կանչելու» խնդիր համարելը ամենատարածված սխալն է ինտեգրումների մեծ մասում։ Հասանելիության տվյալները սկիզբն են, ոչ թե ավարտը e-Mark-ից API օգտանուն և գաղտնաբառ ստանալը նախապայման է, ոչ թե արդյունք։ Հենց համակարգն ունենում է հասանելիություն, սկսվում է իրական աշխատանքը՝ ով է տնօրինում տվյալները (սպասարկման հաշիվ, ոչ թե անձնական մուտք), ինչպես են դրանք պահվում, և ինչպես է կատարվում փոփոխությունը, եթե ծրագրավորողը կամ գործընկերը կորցնում է հասանելիությունը։ Ընկերությունները, որոնք հետաձգում են այս հարցը, հաճախ ի վերջո պահում են գաղտնաբառերը այնտեղ, որտեղ չպետք է։ Կոդերի սպառումը և հերթականությունը DataMatrix կոդերը տրվում են սահմանափակ խմբաքանակներով։ Ինտեգրում, որը կոդեր է պահանջում մեկ առ մեկ տպագրության պահին, փոխանակ նախապես բուֆեր ձևավորելու, ուշ թե շուտ կանգնեցնում է արտադրական գիծը՝ սպասելով API-ի պատասխանին։ Լուծումը ճարտարապետական է՝ կոդերը պահանջել պահանջարկից առաջ, տեղում հետևել մնացորդին և պատվիրել լրացուցիչ խմբաքանակ մինչև բուֆերի դատարկվելը, ոչ թե տպիչի պարապուրդից հետո։ Կրկնումները՝ առանց ուշացման ռազմավարության, ավելի մեծ վնաս են հասցնում, քան հենց խափանումը Ցանցային խափանումը չպետք է վերածվի կրկնվող շրջանառության իրադարձությունների։ Պարզունակ կրկնման տրամաբանությունը՝ ցանկացած սխալի դեպքում կրկին կանչել, կարող է նույն իրադարձությունը ուղարկել երկու անգամ, և հետագայում կրկնված շրջանառության գրառումը շտկելը շատ ավելի թանկ է, քան սկզբից idempotent կրկնումներ կառուցելը։ e-Mark-ում գրառման յուրաքանչյուր գործողություն պետք է կրի idempotency բանալի կամ համարժեք պաշտպանություն։ Որտեղ է տեղավորվում DataSync-ը DataSync-ը հանդես է գալիս որպես կապող շերտ ձեր ERP-ի, պահեստային համակարգերի, տպիչների և հենց e-Mark API-ի միջև՝ ստանձնելով կոդերի բուֆերացումը, կրկնման տրամաբանությունը, շրջանառության իրադարձությունների հերթականությունը և կարգավիճակների համեմատումը, որպեսզի ձեր ներքին համակարգերը աշխատեն մեկ կայուն ինտերֆեյսի հետ, փոխանակ ուղղակիորեն կառավարելու e-Mark-ի գործառնական մանրամասները։ Եթե ձեր թիմը պլանավորում է ինտեգրում, մենք կարող ենք վերանայել ընթացիկ ճարտարապետությունը մինչև մշակումը սկսելը։ Հաճախակի տրվող հարցեր Պե՞տք է արդյոք e-Mark API հասանելիության տվյալներ ունենալ մինչև ինտեգրման աշխատանքները սկսելը։ Այո՝ պահանջեք դրանք վաղ, քանի որ դիմումի և հաստատման գործընթացը ժամանակ է պահանջում և չպետք է դառնա մշակման ժամկետները հետաձգող գործոն։ DataSync-ը կարո՞ղ է ամբողջությամբ ստանձնել ինտեգրումը, թե՞ մեր թիմն է պետք դա անի։ Երկու մոդելներն էլ աշխատում են։ DataSync-ը կարող է ամբողջությամբ վարել ինտեգրումը որպես կառավարվող շերտ, կամ աշխատել ձեր ծրագրավորողների հետ կոնկրետ մասերի վրա՝ կոդերի բուֆերացումն ու շրջանառության հերթականությունը այն մասերն են, որոնք թիմերի մեծ մասը նախընտրում է ոչ զրոյից կառուցել։ Ի՞նչ է կատարվում, եթե կոդերի բուֆերը սպառվում է արտադրության ընթացքում։ Առանց նախապես ապահովման՝ գիծը սպասում է API-ի իրական ժամանակի պատասխանին, ինչը իրական արտադրական ռիսկ է։ Ավտոմատ լրացման շեմով բուֆերը լիովին վերացնում է այս խնդիրը։ e-Mark API-ն նույնն է՞ բոլոր ապրանքային կատեգորիաների համար։ Գործողությունները նույնն են, բայց պարտադիր դաշտերն ու կատեգորիա-հատուկ տվյալները կարող են տարբերվել։ Հաստատեք ձեր ապրանքային կատեգորիաների ճշգրիտ սխեման մինչև դաշտերի քարտեզագրման ավարտը։
Հարակից էջեր

ERP և e-Mark ինտեգրում. ինչ պլանավորել մինչև մշակումը
Դրոշմավորման տվյալները մի համակարգում, հաշվառումը՝ մյուսում․ այդ ճեղքն ամեն օր արժե։ Ինչ է իրականում ERP–e-Mark ինտեգրումը և որտեղից սկսել։

e-Mark պատրաստվածության ամբողջական ստուգաթերթ
Ինը քայլ՝ շրջանակի ստուգումից մինչև առաջին խմբաքանակը. ընկերության տվյալներ, ապրանքային քարտեր, ԱՏԳ ԱԱ կոդեր, փաթեթավորման մակարդակներ, API և սարքավորում։

Ինչպես օգտագործել ԱՏԳ ԱԱ կոդերը e-Mark-ից առաջ
Կառուցել ենք անվճար ԱՏԳԱԱ կոդերի որոնում հայաստանյան բիզնեսի համար․ գտեք ձեր ապրանքի դասակարգչի կոդը վայրկյանների ընթացքում։