API

Бүртгэлийн өгөгдлийн бүх хэрэглэгчид нэгдсэн API. A3.Finance үүнийг 1С болон бусад гадаад системтэй адил ашигладаг.

API-ийн дөрвөн дүрэм

  • Давуу суваг байхгүй

    Өгөгдлийн санд шууд хандах, API-г тойрсон дотоод дуудлага байхгүй. Өөрийн бүтээгдэхүүн гадаад бүртгэлийн системтэй ижил талбар, ижил хязгаарлалт авна.

  • Чиглэл нэг

    API бүртгэлийн баримтыг гадагш өгөх бөгөөд бичихээр юу ч хүлээн авахгүй. Хэрэглэгч өөрийн проекцоо бүтээх ч тоо хүн бүрт ижил.

  • Устгал дамжихгүй

    Сторно дамжина. Хэрэглэгч залруулгыг регистрт байгаа шигээ хардаг: сторнодох бичилт дээр нь шинэ гүйлгээ.

  • Танигч тогтвортой

    Үеийг дахин экспортлоход бичилт, дансны ижил танигч ирдэг тул хэрэглэгч давхардал үүсгэхгүй.

Хүсэлтээр экспорт

Бүх арга хуулийн этгээд, хуудаслалт хүлээн авна. Бичилтийг шатлан авч болно: зөвхөн сүүлийн синхрончлолоос хойш бүртгэгдсэнийг.

GETGetChartOfAccounts

Дансны төлөвлөгөө: төрөл, валют, эх данс, заавал аналитик, гарал үүсэл

GETGetEntriesExport

Үеийн бичилт эсвэл заасан мөчөөс хойш бүртгэгдсэн бичилт

GETGetBalancesExport

Үеийн гүйлгээ-үлдэгдлийн жагсаалт

GETGetCounterpartiesReference

Хуулийн этгээдийн харилцагчийн лавлах

GETGetPeriodsExport

Төлөв, хяналтын нийлбэртэй тайлант үе

Үеийн хяналтын нийлбэр

Хэрэглэгч авсан бичилтүүдээ нэмж, хаагдсан үеийн нийлбэртэй харьцуулна. Зөрүү нь бөөрөнхийлөлтийн алдаа биш, алга болсон хуудас эсвэл дуусаагүй экспортыг илтгэнэ.

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

Үйл явдлын захиалга

Үйл явдал өдөрт нэг багцаар биш, гүйлгээ бүртгэгдэх тусам нийтлэгдэнэ.

accounting.entry.posted

Гүйлгээ бүртгэгдсэн

accounting.entry.reversed

Гүйлгээ сторнологдсон

accounting.period.closed

Үе хаагдсан, хэрэглэгч ижил үеийг өөртөө хаана

accounting.period.reopened

Үе дахин нээгдсэн, түүний тайлан өөрчлөгдөж болзошгүй

accounting.reference.changed

Лавлах эсвэл дансны төлөвлөгөө өөрчлөгдсөн

Хандалт ба хүргэлт

  • Хэрэглэгчийн API түлхүүрийг зөвхөн хеш хэлбэрээр хадгалж, нэг удаа харуулна
  • Зургаан эрх: дансны төлөвлөгөө, бичилт, үлдэгдэл, лавлах, үе, үйл явдал
  • Түлхүүрийг нэг хуулийн этгээдээр хязгаарлаж болно
  • Үйл явдлын бие HMAC-SHA256 гарын үсэгтэй, үйл явдал бүр идемпотент түлхүүртэй
  • Хүргэгдээгүй үйл явдлыг өсөх саатлаар арав хүртэл удаа давтана
  • Бичилт бүр хүрээгээр тэмдэглэгдсэн: албан эсвэл дотоод

Баримт бичиг ба холболт

Аргын тайлбарыг кодоос бүрдүүлж, OpenAPI форматаар зургаан хэлээр нийтэлнэ. Хэрэглэгч байгууллагын тохиргоонд A3-ын хөгжүүлэгчийн оролцоогүйгээр холбогдоно.