API бүх кластерыг хамарна

Интерфейсийн аливаа үйлдэл гаднаас боломжтой: лавлах, үлдэгдэл, баримт, үйлдвэрлэлийн даалгавар, төлөвлөлтийн тооцоолол, тайлан.

Гэрээний зарчим

  • Контроллероор бүлэглэсэн аргууд

    Аргын хаяг хэсэг ба үйлдлээс бүрдэнэ: StockDocuments/PostDocument. Эвдэх өөрчлөлт шинэ хувилбараар гарах ба өмнөх нь шилжилтийн бүх хугацаанд ажиллана.

  • Бичилтийн идемпотент байдал

    Бичих үйлдэл толгой хэсэгт идемпотент түлхүүр хүлээн авна. Ижил хүсэлтийг дахин илгээхэд баримт хоёр удаа батлагдахгүй.

  • Хаа сайгүй хуудаслалт

    Жагсаалтын аргууд offset, count, шүүлтүүр, эрэмбэлэлт хүлээн авна. Хариуд элементүүд ба нийт тоо ирнэ.

  • Хүсэлт бүрт нэг байгууллага

    Хүсэлт бүр байгууллага ба A3.ID сессийн хүрээнд гүйцэтгэгдэнэ. Системд байгууллагын шүүлтүүргүй хүсэлт гэж байхгүй.

Аргын үндсэн бүлгүүд

  • GETItems/GetItemsБүлэг, хэмжих нэгж, бүртгэлийн шинжтэй нэр төрөл
  • GETStock/GetBalancesХэмжүүр тус бүрийн үлдэгдэл, тодорхой өдрийн огтлолыг оролцуулан
  • GETStock/GetMovementsҮндэслэл баримт, урвуу бичилтийн холбоостой хөдөлгөөн
  • POSTStockDocuments/CreateDocumentАрван гурван төрлийн аль нэг агуулахын баримт үүсгэх
  • PUTStockDocuments/PostDocumentБаримтыг батлах, хөдөлгөөн бичих
  • POSTReservations/CreateReservationЭх сурвалж, хүчинтэй хугацаатай нөөцлөлт
  • GETProductionOrders/GetProductionOrdersТөлөв, хангалт, гаралттай үйлдвэрлэлийн даалгавар
  • POSTPlanning/RunPlanningХэрэгцээний тооцооллыг дэвсгэр ажил болгон эхлүүлэх

Хариултын жишээ

Үлдэгдэл бүртгэлийн бүх хэмжүүрээр нэг дор буцна: агуулах, үүр, багц, шинж чанар. 1-р горимд хэмжүүрүүд үйлчилгээний анхдагч утгатай ирнэ.

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
}

Вэбхук

Захиалгыг байгууллагын түвшинд тохируулах ба мессеж бүр нууц түлхүүрээр гарын үсэгтэй. Хүргэлтийг баталгаажих хүртэл давтах ба гарах үйл явдлууд гараар давтах боломжтой бүртгэлд харагдана.

  • StockDocumentPostedАгуулахын баримт батлагдлаа
  • StockBalanceChangedҮлдэгдэл өөрчлөгдлөө
  • MinimumStockReachedДоод үлдэгдэлд хүрлээ
  • ProductionOrderStatusChangedҮйлдвэрлэлийн даалгаврын төлөв өөрчлөгдлөө
  • ProductionOutputRegisteredГаралт бүртгэгдлээ
  • ProductionOrderClosedҮйлдвэрлэлийн даалгавар хаагдлаа
  • PlanningRunCompletedТөлөвлөлтийн тооцоолол дууслаа
  • MaintenanceRequestStatusChangedЗасварын хүсэлтийн төлөв өөрчлөгдлөө
  • EquipmentAvailabilityChangedТоног төхөөрөмжийн бэлэн байдал өөрчлөгдлөө

Баримт бичиг нээлттэй

Аргын тайлбар, загварын схем, хүсэлтийн жишээ API баримт бичигт нээлттэй. A3.ID эсвэл байгууллагын API түлхүүрээр нэвтрэх ба давтамжийн хязгаар байгууллагын түвшинд ажиллана.