TAŇBA-OOH Разработчикам

Где в консоли найти ведомость и ее доказательства

Оператор видит в консоли, что начислено за каждый месяц, формирует из этого ведомость и скачивает доказательства, которые стоят за строкой или за всей ведомостью. Руководство проводит по этим экранам. Как читать строки ведомости и проверять реестр, печати и согласования офлайн, описано в руководстве Как читать ведомость и проверять ее доказательства.

Страницы справочника: Доказательства и офлайн-проверка и Загрузки, где находится tanba-verify.

Прежде чем начать

Откройте период

Откройте «Начисления». В списке одна строка на месяц: сумма, НДС и состояние, «Открыт» или «Закрыт». Закрытый период уже не меняется. Выберите месяц, чтобы открыть его страницу.

На странице видны итог и затем строки начислений. У каждой строки есть вид, основание, количество, сумма и НДС.

ВидЧто это
Показы (за 1000)Показы одной конструкции и согласования; часы, которые они охватывают, указаны в основании
Согласование, разовое / предоплата / приоритетноеСбор за согласование
Данные и подтверждение доставкиСбор за данные
Лабораторное испытаниеСбор лаборатории

Если показы были переданы, но в счет не входят, заметка над строками говорит, сколько их и по какому каналу они пришли: данные CMS оператора, сертификат устройства, подпись устройства, подписанная CMS оператора или отчет плеера. Показы, которые вы импортировали из своей CMS, попадают в эту заметку и никогда не начисляются.

Сформируйте ведомость

Нажмите «Сформировать ведомость (PDF)» в карточке «Ведомости» периода. Появится строка с номером, датой, суммой и состоянием. Состояние: «Оценка», «Выставлена» или «Аннулирована»; созданная вами ведомость это «Оценка». «Скачать PDF» сохраняет ведомость. Она создается на том языке, на который настроена консоль в момент создания.

Скачайте доказательства

Есть две загрузки, обе это zip-файл с подписанными пакетами телеметрии, на которых стоят цифры:

В пакете лежат подписанный манифест (manifest.json и manifest.p7s), пакеты ровно в том виде, в каком их отправили устройства, ключи подписи, согласования, суточные печати с доказательствами и README.txt на казахском, русском и английском языках. Каждая загрузка записывается в журнал аудита.

Проверьте пакет

Нужны пакет и root.pem, корневой сертификат платформы. Zip не распаковывайте:

tanba-verify evidence pack.zip --ca root.pem

OK означает, что подпись манифеста, подпись и хэш каждого пакета, пути Меркла до суточных печатей и почасовой пересчет показов сошлись. Любой другой ответ это код и пакет, в котором найдена ошибка; код возврата сообщает скрипту, какой это случай.

Код возвратаКодЧто означает
0OKВсе сошлось
2BAD_SIGNATUREПодпись манифеста, пакета или печати не проверяется
3HASH_MISMATCHФайл не тот, что указан в манифесте
4ROOT_MISMATCHПакеты не ведут к корню манифеста или печати, например потому что одного нет
5UNKNOWN_CREDENTIALПакет подписан ключом, которого нет в архиве, или сертификат не ведет к корню
6PENDING_LEDGERПечати еще нет в дне реестра; проверьте позже
7RECOUNT_MISMATCHПересчет показов расходится с цифрами
8BAD_LEDGER_PROOFДоказательство от печати до реестра не проверяется
9PARTIALЧасть пакетов не удалось пересчитать полностью; вклад этих пакетов принят как заявленный
10UNKNOWN_FORMATПакет в более новом формате; используйте текущий tanba-verify
11BAD_MANIFESTФайл не является пакетом или манифест поврежден
64Неверная команда или не указан корень

Если вы не согласны с цифрой

Рядом с каждой строкой консоль предлагает «Оспорить», а когда есть ведомость, еще и «Оспорить период». Кнопка открывает спор по этой строке или по всему периоду.

Чего доказательства не показывают

Пакет доказывает, что платформа получила и что после этого не менялось. Показ, о котором не сообщили, в нем не отражен.