A3.Accounting ilovasini ochish

API

Hisob maʼlumotlarining barcha isteʼmolchilari uchun yagona API. A3.Finance undan 1C va boshqa har qanday tashqi tizim bilan teng foydalanadi.

API: toʻrt qoida

  • Imtiyozli kanal yoʻq

    Bazaga toʻgʻridan-toʻgʻri kirish va API orqali oʻtmaydigan ichki chaqiruvlar mavjud emas. Oʻz mahsulotimiz tashqi hisob tizimi bilan bir xil maydonlar va cheklovlarni oladi.

  • Yoʻnalish bitta

    API hisob faktlarini tashqariga beradi va yozish uchun hech narsa qabul qilmaydi. Isteʼmolchi oʻz proyeksiyasini quradi, raqamlar esa hammada bir xil.

  • Oʻchirish uzatilmaydi

    Storno uzatiladi. Isteʼmolchi tuzatishni reyestrdagidek koʻradi: storno yozuvi va yangi operatsiya.

  • Identifikatorlar barqaror

    Davrni qayta yuklash buxgalteriya yozuvlari va hisoblarning oʻsha identifikatorlarini beradi, shuning uchun isteʼmolchi takrorlar yaratmaydi.

Soʻrov boʻyicha yuklama

Barcha metodlar yuridik shaxs va sahifalab berishni qabul qiladi. Buxgalteriya yozuvlarini inkremental olish mumkin: faqat oxirgi sinxronlashdan keyin oʻtkazilganlarini.

GETGetChartOfAccounts

Hisoblar rejasi: tur, valyuta, ota hisob, majburiy analitika, kelib chiqishi

GETGetEntriesExport

Davr uchun yoki koʻrsatilgan vaqtdan keyin oʻtkazilgan buxgalteriya yozuvlari

GETGetBalancesExport

Davr uchun aylanma-saldo qaydnomasi

GETGetCounterpartiesReference

Yuridik shaxsning kontragentlar maʼlumotnomasi

GETGetPeriodsExport

Holatlar va nazorat summalari bilan davrlar

Davrning nazorat summalari

Isteʼmolchi olingan buxgalteriya yozuvlarini qoʻshib, yopilgan davr summalari bilan solishtiradi. Farq yaxlitlash xatosini emas, yoʻqolgan sahifa yoki tugallanmagan yuklamani bildiradi.

GET /api/Contract/GetPeriodsExport?legalEntityId=…
API-KEY: a3c_9f2e…
{
  "year": 2026,
  "month": 1,
  "status": "Closed",
  "controlEntriesCount": 412,
  "controlTotalDebit": 18450320.55,
  "controlTotalCredit": 18450320.55
}

Hodisalarga obuna

Hodisalar sutkada bir marta paket bilan emas, operatsiyalar oʻtkazilishi bilan eʼlon qilinadi.

accounting.entry.posted

Operatsiya oʻtkazildi

accounting.entry.reversed

Operatsiya storno qilindi

accounting.period.closed

Davr yopildi, isteʼmolchi oʻzida ham shu davrni yopadi

accounting.period.reopened

Davr qayta ochildi, u boʻyicha hisobot oʻzgarishi mumkin

accounting.reference.changed

Maʼlumotnoma yoki hisoblar rejasi oʻzgardi

Kirish va yetkazib berish

  • Isteʼmolchining API kaliti faqat xesh koʻrinishida saqlanadi va bir marta koʻrsatiladi
  • Oltita ruxsat: hisoblar rejasi, buxgalteriya yozuvlari, qoldiqlar, maʼlumotnomalar, davrlar, hodisalar
  • Kalitni bitta yuridik shaxs bilan cheklash mumkin
  • Hodisa tanasi HMAC-SHA256 bilan imzolangan, har bir hodisada idempotentlik kaliti bor
  • Yetkazilmagan hodisa ortib boruvchi kechikish bilan oʻn martagacha takrorlanadi
  • Har bir buxgalteriya yozuvi kontur bilan belgilangan: rasmiy yoki ichki

Hujjatlar va ulanish

Metodlar tavsifi koddan yigʻiladi va OpenAPI formatida olti tilda eʼlon qilinadi. Isteʼmolchi tashkilot sozlamalarida A3 dasturchilari ishtirokisiz ulanadi.

API hujjatlariMateriallar va yoʻriqnomalar