Тізімдемені оқу және оның дәлелдерін тексеру

Тізімдеме операторға кезең үшін не есептелгенін және қандай негізде есептелгенін айтады. Ондағы әрбір сан сақталған жазбаларға дейін қадағаланады, ал жазбаларды платформаға сенбей-ақ тексеруге болады. Бұл нұсқаулық тізімдемені қалай оқуды және дәлелдерді офлайн қалай тексеруді көрсетеді.

Анықтамалық беттер: Дәлелдер және офлайн тексеру және Келісу конверті мен кері қайтару тізімінің пішімдері.

Тізімдемені алу

Консольде «Есептеулер» бөлімін ашып, кезеңді таңдаңыз және тізімдемені қазақ, орыс немесе ағылшын тілінде PDF түрінде жүктеңіз. Дәл сол сандар read:billing рұқсаты бар интеграция API-інде де бар:

curl -H 'Authorization: Bearer tnbk_EXAMPLE_secret' \
  'https://app.tanba-ooh.kz/api/v1/billing/periods/0b1c3a52-6f0e-4c2e-9d3a-2f5d1e7a9c10'

Тізімдеме негіздеме жолымен аяқталады, мысалы basis: 96240 plays, evidence tier: mtls, model: billing-v0. Онда есептеу қанша көрсетілімге сүйенетіні, оларды қандай дәлел деңгейі бергені және көрсетілімдерді есептік бірліктерге қандай көбейткіш моделі айналдырғаны айтылған. Дәлелдер кезеңмен бірге қатырылады: жабылған кезең әрдайым өзі жабылған сандарды көрсетеді.

Жолдарды оқу

Жауаптың әр жолы бір есептеу болып табылады:

Өріс	Мағынасы
`kind`	көрсетілімдер үшін `impression`, келісу алымдары үшін `approval_single` және `approval_prepaid`, зертхана алымы үшін `lab`
`source_ref`	Көрсетілім жолы үшін: құрылым және ол қамтитын сағаттар; қосымша есептеу жолы үшін: құрылым және ай; алым жолы үшін: келісу нөмірі
`quantity`	Есептік бірліктер. Көрсетілімдер үшін бұл көрсетілім санының модельдегі құрылым пішімінің көбейткішіне көбейтіндісі; `billing-v0` моделінде ол барлық пішім үшін 1.000, сондықтан бірліктер көрсетілімдерге тең
`amount_kzt`, `vat_kzt`	Теңгедегі сома ондық жол түрінде ҚҚС-сыз және ҚҚС
`tiers`	Жолдың көрсетілімдерін берген дәлел деңгейлері
`model`	Көбейткіштер моделі; алым жолы үшін бос

Жолдардың жанындағы екі блок көріністі бұрмалатпайды:

reported_not_billed кезеңде хабарланған, бірақ есептеуге кірмеген көрсетілімдер: есептеуді анықтайтын жиыннан тыс деңгейлер және оператор өз CMS жүйесінен импорттаған жолдар (import деңгейі, ешқашан есептелмейді). Алшақтық ол туралы ешкім шешім қабылдамай тұрып көрінеді.
shortfalls қазір сақтаулы көрсетілімдер есептелгеннен аз болатын жабылған айларды тізеді. Олар уәкілетті органға көрсетіледі және автоматты түрде қайтарылмайды.

<код> late <жжжж-аа> деп аталған көрсетілім жолы ертерек жабылған айдың, ай жабылғаннан кейін келген көрсетілімдерін сол айдың тарифімен бір рет есептейді.

Дәлел деңгейлері

Деңгей дегеніміз көрсетілімдер келген арна, ол оларға қаншалықты сенуге болатынын анықтайды.

Деңгей	Арна
`mtls`	Клиенттік сертификаты бар және пакеттеріне қол қоятын ойнатқыш (Көрсетілімдерді жіберу)
`signed`	Жазылған кілті бар ойнатқыш немесе агент
`attested`	Қол қойылған пакетпен өз ойнатқыштарына кепілдік беретін оператор CMS жүйесі
`native`	Құрылғының тұлғаны растайтын деректері бар тағы бір арна
`import`	Оператор өз CMS жүйесінен көрсетілімдерді импорттау арқылы импорттаған жолдар; бөлек сақталады және ешқашан есептелмейді

Бір құрылым, келісу және сағат үшін әр деңгейдің көрсетілімдері ешқашан қосылмайды: санды көрсетілімі ең көп деңгей береді, сондықтан ойнатқышы да, CMS жүйесі де хабарлаған экран бір рет есептеледі. Есептеуді анықтайтын деңгейлер жиынын платформа иесі белгілейді.

Дәлелдерді өзіңіз тексеріңіз

Төмендегінің бәріне тек Жүктеулер бетінен жүктеуге болатын tanba-verify және root.pem, яғни келісулер, кері қайтару тізімдері, зәкірлер мен мөрлер бағынатын платформаның түбірлік сертификаты қажет. Сынақ контурының түбірі сынақ ортасымен бірге беріледі; түбірлік сертификаттар жиыны өндірістік түбір пайда болғанда жүктеулер бетінде жарияланады.

1. Қабылданған статистиканың күнделікті мөрі

Алматы бойынша күн сайын, түн ортасынан кейін көп ұзамай, платформа алдыңғы күні қабылдаған статистика пакеттерін мөрлейді: пакеттер бойынша бір Меркл түбірі, ол мәртебе кілтімен қол қойылған, алдыңғы күннің мөріне байланған және жария тізілімге жазылған. Тек есептеулер мен түбір ашық.

curl -o seal.json https://verify.tanba-ooh.kz/v1/stats-seals/2026-10-13
tanba-verify seal seal.json --ca root.pem

OK қолтаңбаның мәртебе кілтіне тиесілі екенін және түбірге бағынатынын, дененің қол қойылғанның өзі екенін және тізілім дәлелі мөрден оның тізілім күнінің түбіріне жеткізетінін білдіреді. Шығу коды 0 жақсы, 2 бір нәрсе дұрыс емес, ал 6 мөр жарамды, бірақ оны әлі ешбір тізілім күні қамтымағанын білдіреді: кейінірек қайта сұратыңыз. Мөрдің пакеттері арасындағы бір пакетті --batch-proof арқылы тексеруге болады, оған сол пакеттің Меркл жолы бар файл беріледі; мұндай файлды беретін жария шақыру әзірше жоқ.

2. Тізілім күні және Биткоин

Мөр өзі жасалған тізілім күнінің жапырағы болып табылады. Сол күннің дайджесті Биткоинде уақыт белгісімен расталған. Дайджестті кіріс деректерінен қайта есептеп, дәлелді тексеріңіз:

curl -o ledger-2026-10-14.json https://verify.tanba-ooh.kz/v1/ledger-days/2026-10-14
curl -o ledger-2026-10-14.ots https://verify.tanba-ooh.kz/v1/ledger-days/2026-10-14/proof.ots
tanba-verify ledger --day 2026-10-14 --ots ledger-2026-10-14.ots --inputs ledger-2026-10-14.json \
  --btc-header-url https://blockstream.info/api

0 коды дәлелде Биткоин блогы бар екенін білдіреді. 2 коды кіріс деректерінің қайшы екенін, 3 дәлелдің басқа дайджестке жататынын, 6 дәлелдің әлі күтіп тұрғанын, ал 8 жария блок шолғышы келіспейтінін білдіреді. --btc-header-url болмаса, блок тақырыбы мұнда тексерілмейді; ресми ots verify -d DIGEST FILE.ots оны өз түйініңіз бойынша тексереді.

3. Тізілімдегі бір келісу

curl -o ledger-proof.json https://verify.tanba-ooh.kz/v1/approval/TNB-2026-000123/ledger-proof
tanba-verify inclusion --proof ledger-proof.json --approval TNB-2026-000123

Дәлел келісудің жапырағы оның күні ағашына кіретінін айтады. Ол күн жабылып, жазылғаннан кейін қолжетімді болады.

4. Келісу, кері қайтару тізімі және зәкір

tanba-verify spot.mp4 spot.mp4.p7s --roots root.pem
tanba-verify revocations list.p7s --ca root.pem
tanba-verify anchor anchor-2026-10-05.p7s --ca root.pem

Бірінші команда медиафайлды оның келісу конверті бойынша тексереді. Шығу кодтары: 0 OK, 2 BAD_SIGNATURE, 3 HASH_MISMATCH, 4 EXPIRED_APPROVAL, 5 NOT_YET_VALID және қате команда немесе оқылмайтын файл үшін 64; 6 OUTER_NOT_VERIFIED және 7 OUTER_INVALID мемлекеттік қолтаңбаға қатысты. Екінші команда қол қойылған кері қайтару тізімін басып шығарады, үшіншісі күнделікті аудит зәкірін тексереді, екеуі де 0 немесе 2 кодымен аяқталады. Пішімдер Келісу конверті мен кері қайтару тізімінің пішімдері нұсқаулығында сипатталған.

5. Сақталған пакет

Әрбір қабылданған көрсетілім пакеті алынған байттармен, қолтаңбамен және дене SHA-256 мәнімен бірге сақталады. Пакетті алып, хэшін есептеңіз, қолтаңбасын құрылғының немесе CMS орнатылымының ашық кілтімен тексеріңіз және prev_sha256 мен seq бойынша жүріңіз. Бұл қалай жұмыс істейтіні Көрсетілімдерді жіберу нұсқаулығында.

Дәлелдер нені дәлелдемейді

Тізілім жазбаның белгілі бір күні болғанын және одан кейін өзгермегенін көрсетеді. Ол жазбаның артындағы шешімнің дұрыс болғанын көрсетпейді. Мөр платформа қабылдағанды қамтиды; хабарланбаған көрсетілім онда жоқ, ал өткізіліп кеткен кезең ойнатқыштың жазба нөмірлеріндегі олқылық ретінде көрінеді.