BBT: IZKM - LEGACY-API tavsifi

"Buyurtmani boshqarish tizimi" (OMS) maxsus dasturiy ta'minotining maqsadi ishlab chiqaruvchilar va importchilar uchun markirovkali mahsulotlarni ishlab chiqarishda asosiy operatsiyalarni bajarishdir:

• buyurtmalarni shakllantirish va markirovka kodlarini emissiya qilish;

• buyurtma qilingan markirovka kodlarini qabul qilish (yuklash);

• markirovka kodlarini qo'llash hisobotini shakllantirish;

• markirovkalangan mahsulotlarni guruh va (yoki) transport qadoqlariga agregatsiyalash bo'yicha hisobotlarni shakllantirish;

• markirovkalangan mahsulotlarni chiqarib tashlash (hisobdan chiqarish) hisobotlarini shakllantirish.

BBT (IZKM) quyidagi mahsulot guruhlarini markirovkalashda ishlatiladi:

* ko'rsatilgan sanagacha BBT (Облако 3.1) ishlatiladi.

Hujjatlar buyurtmalarni boshqarish stantsiyasining o'zaro ta'sir dasturi interfeysi (API) tavsifini beradi - CMS (IZKM), bunda o'zaro ta'sir HTTP protokoli orqali JSON formati yordamida amalga oshiriladi.

Markirovka kodlari uchun yangi buyurtma yaratishda BBT (IZKM) usullarini chaqirishning asosiy ketma-ketligi:

1. BBT (IZKM) xizmatlarining mavjudligini tekshirish.

2. MKni chiqarishga buyurtma yaratish.

3. Buyurtma buferidan MKni qabul qilish.

4. Belgilangan GTIN yordamida buyurtmani/sub-buyurtmani yopish.

5. MKni qo'llash to'g'risida hisobot yaratish.

6. MKni agregatsiyalash hisobotini yaratish.

7. КМ MKni hisobdan chiqarish (rad etish) to'g'risida hisobot yaratish.

API shuningdek, yordamchi usullarni taqdim etadi:

1. Hisobot identifikatori bo'yicha hisobot / hisobotni qayta ishlash statusini olish.

2. MAI buyurtmalari ro'yxatini olish/buyurtmalar statusini olish.

3. MK qadog'i identifikatorlari ro'yxatini olish.

4. Buyurtmadan MKni takroran qabul qilish.

BBS (IZKM) va BBS (Bulut 3.1) o‘rtasidagi asosiy farqlar:

1. "Markirovka kodlarini kiritish (foydalanish) to‘g‘risida hisobotlar" (api/v2/{extension}/utilisation) ni taqdim etish imkoniyati amalga oshirildi:

• markirovka kodlarini qo'llash (foydalanish) to‘g‘risidagi hisobot aylanma ishtirokchilari tomonidan mustaqil ravishda (ishlab chiqarish siklini hisobga olgan holda) shakllantiriladi

• hisobotda ishlab chiqarish sanasi ("productionDate"), ishlab chiqarish seriyasi raqami ("seriesNumber") va markirovkalangan mahsulotning yaroqlilik muddati ("expirationDate") tugashi sanasi ko‘rsatilishi mumkin

2. "MK emissiyasiga buyurtma yaratish" usuli (api/v2/{extension}/orders):

• sonli (integer) bo‘lgan alohida parametrlar ("quantity," "templateId") uchun satr (string) uzatilishiga yo‘l qo‘yilgan xatolik tuzatildi;

• so‘rovda majburiy bo‘lgan ayrim parametrlar ("templateId") mavjud emasligiga yo‘l qo‘yilgan xato tuzatildi;

• markirovka kodlarini buyurtma qilish uchun zarur bo‘lgan "Tarif" ("rateType") majburiy bo‘lmagan maydoni qo‘shildi, ular bo‘yicha xizmat Operator tomonidan to‘lov undirmasdan taqdim etiladi.

3.  "MKni kichik buyurtmadan olish" usuli (api/v2/{extension}/codes):

• "lastBlockId" parametriga noto‘g‘ri ishlov berishdagi xatolik tuzatildi - agar buyurtmadan faqat buyurtma qilingan kodlarning bir qismi yuklab olinayotgan bo‘lsa, o‘sha buyurtmadan qolgan markirovka kodlarini yuklab olish so‘rovida "lastBlockId" parametrining qiymati oldingi so‘rovda olingan kodlar paketi identifikatoriga ("BlockId") teng bo‘lishi kerak, aks holda birinchi olingan kodlar paketi yuklab olinadi.

4. "Buyurtmadan MK massivi maqomini olish" usuli (api/v2/{extension}/ buffer/status):

• javobda "poolInfos" parametrini tavsiflashdagi xato tuzatildi - "poolInfos" parametri majburiy emas va faqat birinchi markirovka kodlari paketi ("BlockId") yuklab olingandan so‘ng to‘ldiriladi, rad etilgan buyurtmalar va markirovka kodlari yuklab olinmagan buyurtmalar bo‘yicha "poolInfos" parametri to‘ldirilmaydi.

5. "Buyurtmalar ro‘yxatini olish" usuli (api/v2/{extension}/orders) :

• buyurtma maqomi ("status") va yaratilgan sanasini ("dateFrom" dan "dateTo" gacha) hisobga olgan holda buyurtmalar ro‘yxatini shakllantirish imkoniyati amalga oshirildi

6. "MK agregatsiyasi to‘g‘risida hisobot tuzish" usuli (api/v2/{extension}/aggregation):

• so‘rovda sonli ("integer") bo‘lgan alohida parametrlar ("aggregatedItemsCount," "aggregationUnitCapacity") uchun satr ("string") dan foydalanishga yo‘l qo‘yilgan xatolik bartaraf etildi.

7. Quyidagi usullarni qo‘llab-quvvatlash to‘xtatildi:

• "BBS va API versiyalarini olish" usuli (api/v2/{extension}/version)

• "Xavfsizlik markerini foydalanuvchi nomi va paroli bilan olish" usuli (api/v2/{extension}/token)

• "Agregatsiya haqida ma’lumot olish" usuli (api/v2/{extension}/aggregation/info)

Buyurtmalar va hisobotlarni yaratishda cheklovlar:

Markirovka kodlari emissiyasiga buyurtma:

• buyurtmadagi har bir tovar uchun 150 mingdan ortiq bo‘lmagan kodlar (GTIN)

• bitta buyurtmada 10 tadan ortiq bo‘lmagan tovarlar (GTIN)

• 100 dan ortiq bo‘lmagan faol buyurtmalar (buyurtma bajarilganidan va markirovka kodlari olinganidan keyin buyurtma yopilishi kerak, bu bilan buyurtma bajarilganligini va markirovka kodlari olinganligini tasdiqlaydi)

Markirovka kodlarini kiritish to‘g‘risida hisobot:

• bitta hisobotda ko‘pi bilan 30 ming kod

Markirovka kodlari agregatsiyasi to‘g‘risida hisobot:

• bitta hisobotda ko'pi bilan 11 ming ta kod (agregatsiyalanadigan kodlar va shakllantiriladigan agregatlarning umumiy soni hisobga olinadi)

Markirovka kodlarini hisobdan chiqarish to‘g‘risida hisobot:

• bitta hisobotda ko‘pi bilan 30 ming kod

Biriktirilgan fayllar: