A3.Accounting ачуу

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 иштеп чыгуучуларынын катышуусуз уюмдун жөндөөлөрүндө туташат.

API документациясыМатериалдар жана нускамалар