API
Бүртгэлийн өгөгдлийн бүх хэрэглэгчид нэгдсэн API. A3.Finance үүнийг 1С болон бусад гадаад системтэй адил ашигладаг.
API-ийн дөрвөн дүрэм
Давуу суваг байхгүй
Өгөгдлийн санд шууд хандах, API-г тойрсон дотоод дуудлага байхгүй. Өөрийн бүтээгдэхүүн гадаад бүртгэлийн системтэй ижил талбар, ижил хязгаарлалт авна.
Чиглэл нэг
API бүртгэлийн баримтыг гадагш өгөх бөгөөд бичихээр юу ч хүлээн авахгүй. Хэрэглэгч өөрийн проекцоо бүтээх ч тоо хүн бүрт ижил.
Устгал дамжихгүй
Сторно дамжина. Хэрэглэгч залруулгыг регистрт байгаа шигээ хардаг: сторнодох бичилт дээр нь шинэ гүйлгээ.
Танигч тогтвортой
Үеийг дахин экспортлоход бичилт, дансны ижил танигч ирдэг тул хэрэглэгч давхардал үүсгэхгүй.
Хүсэлтээр экспорт
Бүх арга хуулийн этгээд, хуудаслалт хүлээн авна. Бичилтийг шатлан авч болно: зөвхөн сүүлийн синхрончлолоос хойш бүртгэгдсэнийг.
GetChartOfAccountsДансны төлөвлөгөө: төрөл, валют, эх данс, заавал аналитик, гарал үүсэл
GetEntriesExportҮеийн бичилт эсвэл заасан мөчөөс хойш бүртгэгдсэн бичилт
GetBalancesExportҮеийн гүйлгээ-үлдэгдлийн жагсаалт
GetCounterpartiesReferenceХуулийн этгээдийн харилцагчийн лавлах
GetPeriodsExportТөлөв, хяналтын нийлбэртэй тайлант үе
Үеийн хяналтын нийлбэр
Хэрэглэгч авсан бичилтүүдээ нэмж, хаагдсан үеийн нийлбэртэй харьцуулна. Зөрүү нь бөөрөнхийлөлтийн алдаа биш, алга болсон хуудас эсвэл дуусаагүй экспортыг илтгэнэ.
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-ын хөгжүүлэгчийн оролцоогүйгээр холбогдоно.