API butun klasterni qamrab oladi

Interfeysdagi har qanday operatsiya tashqaridan mavjud: maʼlumotnomalar, qoldiqlar, hujjatlar, ishlab chiqarish topshiriqlari, rejalashtirish hisoblari va hisobotlar.

Kontrakt tamoyillari

  • Kontrollerlar boʻyicha usullar

    Usul manzili boʻlim va amaldan iborat: StockDocuments/PostDocument. Buzuvchi oʻzgarish yangi versiya bilan chiqadi, oldingisi butun oʻtish davri davomida ishlaydi.

  • Yozuvning idempotentligi

    Yozuv operatsiyalari sarlavhada idempotentlik kalitini qabul qiladi. Xuddi shu soʻrovni qayta yuborish hujjatni ikki marta oʻtkazmaydi.

  • Hamma joyda sahifalash

    Roʻyxat usullari offset, count, filtrlar va saralashni qabul qiladi. Javobda elementlar va umumiy soni boʻladi.

  • Bitta soʻrovga bitta tashkilot

    Har bir soʻrov tashkilot va A3.ID sessiyasi kontekstida bajariladi. Tizimda tashkilot boʻyicha filtrsiz soʻrov mavjud emas.

Asosiy usullar guruhlari

  • GETItems/GetItemsGuruhlari, oʻlchov birliklari va hisob belgilari bor nomenklatura
  • GETStock/GetBalancesOʻlchamlar boʻyicha qoldiqlar, sanadagi kesim bilan birga
  • GETStock/GetMovementsAsos hujjati va stornoga havolasi bor harakatlar
  • POSTStockDocuments/CreateDocumentOʻn uch turdan istalgan ombor hujjatini yaratish
  • PUTStockDocuments/PostDocumentHujjatni oʻtkazish va harakatlarni yozish
  • POSTReservations/CreateReservationManbai va amal qilish muddati bor zaxira
  • GETProductionOrders/GetProductionOrdersHolati, taʼminlanishi va chiqarilishi bor ishlab chiqarish topshiriqlari
  • POSTPlanning/RunPlanningEhtiyoj hisobini fon vazifasi sifatida ishga tushirish

Javob namunasi

Qoldiq hisobning barcha oʻlchamlari boʻyicha birdaniga qaytariladi: ombor, yacheyka, partiya va xususiyat. 1-rejimda oʻlchamlar xizmat standart qiymatlari bilan keladi.

GET Stock/GetBalances?itemId=7f31a0

{
  "items": [
    {
      "warehouseId": "main",
      "cellId": "A-04-12",
      "batchId": "2026-07-14",
      "quantity": 1840.5,
      "reserved": 320,
      "available": 1520.5,
      "averageCost": 412.37,
      "currency": "KZT"
    }
  ],
  "totalCount": 1
}

Vebxuklar

Obuna tashkilot darajasida sozlanadi, har bir xabar maxfiy kalit bilan imzolanadi. Yetkazish tasdiqlanguncha takrorlanadi, chiquvchi hodisalar jurnalda qoʻlda takrorlash imkoni bilan koʻrinadi.

  • StockDocumentPostedOmbor hujjati oʻtkazildi
  • StockBalanceChangedQoldiq oʻzgardi
  • MinimumStockReachedMinimal qoldiqqa yetildi
  • ProductionOrderStatusChangedIshlab chiqarish topshirigʻi holati oʻzgardi
  • ProductionOutputRegisteredChiqarish qayd etildi
  • ProductionOrderClosedIshlab chiqarish topshirigʻi yopildi
  • PlanningRunCompletedRejalashtirish hisobi yakunlandi
  • MaintenanceRequestStatusChangedTaʼmirlash arizasi holati oʻzgardi
  • EquipmentAvailabilityChangedUskuna mavjudligi oʻzgardi

Hujjatlar ochiq

Usullar tavsifi, model sxemalari va soʻrov namunalari API hujjatlarida ochiq. Kirish A3.ID yoki tashkilotning API kaliti orqali, chastota cheklovi tashkilot darajasida ishlaydi.