Перейти к основному содержанию
Tungo платформасы Tungo-ны өз жүйеңізге қосу үшін керек: есеп бағдарламасына, CRM-ге, сайтқа немесе ботқа. Серверіңіз API-ге кілтпен жүгінеді және адам кабинетте алатын нәрсенің бәрін алады: 1С деректері бойынша ЖИ-бухгалтердің жауаптарын, дайындалған құжаттарды, не болғаны туралы оқиғаларды. Кабинетте адам жұмыс істейді: ол поштамен кіреді, чатқа жазады және батырмаларды басады. Платформада бағдарлама жұмыс істейді: ол https://api.tungo.kz мекенжайына сұраулар жібереді және өзін tg_… түріндегі кілтпен растайды. Платформа экрандары кабинеттен, мәзірдегі Платформа сілтемесі арқылы ашылады. Онда кілттер шығарылады, баланс толтырылады және шығын қаралады. Шот пен кілттерді тек ұйымның иесі мен әкімшісі көреді.

​
Кілтпен не істеуге болады

Кілт бір ұйым үшін шығарылады және оның компанияларымен жұмыс істейді: бәрімен немесе тек таңдалғандарымен. Нақты не істеуге рұқсат етілетінін кілтті шығарған кезде берілетін құқықтар белгілейді.
  • Компанияның ЖИ-бухгалтеріне сұрақ қойып, жауапты тұтас немесе оқиғалар ағынымен алу.
  • ЖИ-бухгалтер 1С үшін дайындаған құжаттар кезегін оқу, құжатты мақұлдау немесе қабылдамау.
  • Банк үзіндісі мен кіріс ЭШФ-ларды талдауға беру.
  • Компанияның автоматтандыруларын баптау: сценарийлер, кіріс хуктар, іске қосулар.
  • Вебхуктарға арналған мекенжайлар қосып, оларға оқиғалар алып тұру.
  • Платформа балансын, шығынды, модель бағаларын және өз шектеріңізді білу.
Мекенжайлардың, өрістердің және жауаптардың толық тізімі API анықтамасында бар. Ол https://api.tungo.kz/v1/openapi.json мекенжайы беретін сипаттаманың өзінен жиналады. Бұл сипаттаманы өз құралыңызға жүктеуге немесе сол бойынша клиент жасап алуға болады.

​
Кілтпен не істеуге болмайды

Кілттерді шығару, өзгерту және кері қайтару тек кабинеттегі адамның қолынан келеді. Кілтпен бұл мекенжайлар жұмыс істемейді. Балансты толтыру, платформа баптаулары, карталар, қызметкерлер және 1С қосу да солай. 1С қосылымының күйін кілт оқи алады, бірақ өзгерте алмайды. API браузерден шақырылмайды. Кілт — құпия, оны өз серверіңізде сақтау керек. Бөгде сайттағы бет кодынан келген сұраулар cors_not_supported кодымен 403 бас тартуын алады. Кілт оны шығарған адамның атынан әрекет етеді және ешқашан оның құқықтарынан аспайды. Бөлек сынақ ортасы мен сынақ кілттері жоқ: сұраулар нақты компанияға барады және нақты баланстан төленеді.

​
Бөлек баланс

ЖИ-бухгалтерге кілтпен жіберілген сұраулар мен автоматтандырулар платформа балансынан төленеді. Ол жазылымнан бөлек: платформа үшін жазылым керек емес, ал тариф лимиттері кілтпен жіберілген сұрауларға қолданылмайды. Ақша модельді әр шақырған сайын токен бағасы бойынша алынады. API-дегі сомалар тиынмен көрсетіледі, 1 ₸ = 100 тиын.

​
Неден бастау керек

API кілтін жасау

Кілтті кім шығарады, оған қандай құқықтар беру керек және кілт бөгде қолға түссе не істеу керек.

Алғашқы сұрауды жіберу

Кілтті тексеру, компанияның id-ін білу және ЖИ-бухгалтерге сұрақ қою.

Оқиғаларды алу

Серверіңіздің мекенжайын қосу, қолтаңбаны тексеру және қайталауларды түсіну.

Баланс және шығын

Баланс қалай толтырылады, шығынды қайдан көруге болады және шығысты қалай шектеуге болады.

Қателер мен шектеулер

Қате туралы жауап қалай құрылған, негізгі кодтар және сұраулар жиілігінің шектеуі.

Автоматтандырулар

ЖИ-бухгалтерді кесте бойынша немесе оқиға бойынша іске қосатын сценарийлер.

​
Әрі қарай