Общее описание принципов взаимодействия

Пример взаимодействия с СКО

Обработка ошибок (v2.0.1+)

Ошибки разделяются на подтипы, на основании используемых префиксов, например:

  • $.avtpcr.* - ошибки, которые отдаются от СКО или связаны с внутренней работой с СКО, например:
    • $.avtpcr.not_authorized - Не пройдена авторизация в СКО
    • $.avtpcr.space.insufficient - Недостаточно памяти в СКО для записи данных
  • $.io.* - ошибки, связанные с передачей данных из/в СКО
  • $.transport.* - ошибки, связанные с обработкой данных от СКО
  • $.internal.* - ошибки, связанные с внутренними особенностями реализации протоколов взаимодействия с ПК. В случае возникновения ошибок такого рода стоит сообщать оператору
  • avtpcr.* - ошибки связанные с несоблюдением требований при взаимодействии с ПК. Например:
    • avtpcr.status.blocked - Касса заблокирована
    • avtpcr.bundle.unique_id.length - Превышена макс. длина уникального идентификатора для чека
  • rendering.* - ошибки, связанные с отрисовкой или печатью данных
  • sko.core.receipt.* - ошибки, связанные непосредственно с функционалом ПК, который отвечает за обработку и формирование кассовых документов
  • orders.* - ошибки работы с функционалом обслуживания за столиками

Обработка ошибок (v1.8.x)

Ошибки разделяются на подтипы, на основании используемых префиксов:

  • AVQFR_ - ошибки СКО
  • TR_ - ошибки обработки ответов СКО. Практически в 100% случаев обрабатываются на уровне Программной Кассы. Клиентская обработка не требуется. Данные ошибки могут фигурировать в лог-файлах
  • USB_ - ошибка взаимодействия по USB с устройством. При возникновении таких ошибок при работе с СКО, последнее помечается как неактивное и удаляется из списка доступных
  • CRT_ - ошибки чтения данных из сертификата в СКО. Данная ошибка не передается на текущий момент на клиентскую часть, т.к. при ошибке чтения данных СКО считается невалидным и не помещается в список доступных к использованию. Данные ошибки могут фигурировать в лог-файлах
  • AVTPCR_ - аналогично CRT_, но относится к аттрибутам устройства
  • TIN_ - ошибки валидации входных данных. Данные ошибки не должны возникать при валидной передаче данных и их обработка заключается в исправлении входных данных
  • TSRV_ - общие сервисные ошибки, должны обрабатываться в соответствии с их описанием
  • PR_ - ошибки связанные с взаимодействием с принтером. При возникновении данного типа ошибок на этапе фискализации передается поле op_data с фискальным чеком
  • TORD_ - ошибки работы с заказами в ресторанном режиме. В режиме ритейла данные ошибки отсутствуют

Более подробно об ошибках описано в описании методов и в разделе Ошибки данной документации.