{"info":{"_postman_id":"e5f23a51-5e15-4b5b-a9e7-77aaf36f3aa8","name":"ИНТЕГРАТОРЫ_v4-2.0.3","description":"

Обзор сервиса Webkassa

Данный документ содержит описание сервиса Webkassa, который используется для фискализации кассовых операций и передачи данных об этих операциях Оператору фискальных данных (ОФД).

Сервис позволяет работать с кассовыми операциями и кассовыми документами, формируемыми ОФД и/или Webkassa.

История изменений

30.03.2026

В методе /v4/cashbox/client-info добавлено
\n
- информация по контактам ЦТО
  \n
- информация по лицензии
  \n
\n

16.03.2026

Расширено описание параметра RoundType метода API Check
\n
Обновлено описание параметра Accept-Language в заголовке метода /v4/Ticket/PrintFormat
\n

05.02.2026

Улучшена структура документации
\n
Добавлен раздел «Список кодов ошибок»
\n
Уточнены и дополнены описания параметров
\n
Добавлены признаки обязательности параметров
\n
Добавлены примеры ответов API
\n
Метод /api/check дополнен примерами возвратов для протоколов 2.0.2 и 2.0.3
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Обзор сервиса Webkassa","slug":"obzor-servisa-webkassa"}],"owner":"48749526","collectionId":"e5f23a51-5e15-4b5b-a9e7-77aaf36f3aa8","publishedId":"2sBXc8o3JF","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-05T09:49:19.000Z"},"item":[{"name":"Авторизация","item":[{"name":"/api/v4/Authorize","event":[{"listen":"test","script":{"exec":["const resp = pm.response.json();\r","const authJwt = resp.Data.Token;\r","pm.collectionVariables.set(\"AUTHToken\", authJwt);"],"type":"text/javascript","packages":{},"requests":{},"id":"a36e46ea-2132-47e5-b962-7b3b1374d5c3"}}],"id":"54995e54-666f-4e29-a219-4751af9fd1f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Login\": \"\", //укажите email пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"\" //укажите пароль пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n//Полученный токен будет занесен в переменную \"AUTHToken\", чтобы использовать актуальный токен в дальнейших запросах ","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Authorize","description":"

Назначение метода

Метод выполняет авторизацию системы в API Webkassa по API-KEY и инициализирует сессию для последующих запросов.

\n","urlObject":{"protocol":"https","path":["api","v4","Authorize"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"606cd302-b36d-432a-9b86-ce3e6df2aafb","name":"Успешная авторизация","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Login\": \"\", //укажите email пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"\" //укажите пароль пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n//Полученный токен будет занесен в переменную \"AUTHToken\", чтобы использовать актуальный токен в дальнейших запросах ","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Authorize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 10:56:20 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"Token\": \"1a4e7fd2dfd84a7eb55d961d52470a70\" // Токен авторизации для использование в последующух запросах. Занесен в переменную \"AUTHToken\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n}"},{"id":"e49d941c-4ed3-4d77-a982-102c743093fe","name":"Ошибка: неверный логин/пароль","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Login\": \"integrator@mail.ru\", //укажите email пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"Asdzxc1\" //укажите пароль пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n//Полученный токен будет занесен в переменную \"AUTHToken\", чтобы использовать актуальный токен в дальнейших запросах\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Authorize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 05:39:12 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 1,\n \"Text\": \"Неверный логин и/или пароль\"\n }\n ]\n}"}],"_postman_id":"54995e54-666f-4e29-a219-4751af9fd1f8"}],"id":"37ee76c0-8ac7-4bae-ac56-304d7f17e7f9","description":"

Авторизация системы выполняется посредством передачи API-KEY.

Описание API-KEY

Для взаимодействия с API Webkassa выдается специальный ключ API-KEY — это строка специального формата, идентифицирующая систему, обращающуюся к API.

Типы API-ключей

Для каждой системы создаются два API-KEY:

для тестирования
для использования в продуктивной среде

Каждый запрос к API Webkassa должен содержать API-KEY системы, которая обращается к API Webkassa.

Получение API-KEY

Получить API-KEY для тестовой и продуктивной среды можно через каналы связи с технической поддержкой Webkassa.

AUTHToken

Для удобства тестирования в методе /api/Authorize используется скрипт, который сохраняет авторизационный токен в переменную AUTHToken.
Данная переменная автоматически используется во всех методах коллекции.

\n","_postman_id":"37ee76c0-8ac7-4bae-ac56-304d7f17e7f9"},{"name":"Касса","item":[{"name":"Смена токена ОФД","item":[{"name":"/api/v4/Cashbox/ChangeToken","id":"53d9c4e9-cb1a-46bd-a297-e0f720920ac6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OfdToken\": \"1607556274\" // укажите новый токен кассы, полученный от ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashbox/ChangeToken","description":"

Назначение метода

Сервис смены токена ОФД записывает в кассу ранее сгенерированный токен.\nТокен ОФД — это ключ, с помощью которого касса обменивается данными с сервером ОФД.

Генерация токена

Генерация токена проводиться в системе WOFD.

\n","urlObject":{"protocol":"https","path":["api","v4","Cashbox","ChangeToken"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"e1f48d03-ee98-4531-9946-1ca1c83868f3","name":"Успешная смена токена кассы","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OfdToken\": \"1607556274\" // укажите новый токен кассы, полученный от ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashbox/ChangeToken"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""},{"id":"1f737c6e-579b-4733-900e-b56fba55f372","name":"Ошибка: Неверный токен кассы","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OfdToken\": \"727272\" // укажите новый токен кассы, полученный от ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashbox/ChangeToken"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"53d9c4e9-cb1a-46bd-a297-e0f720920ac6"}],"id":"089c1173-a211-4544-88e7-414ce7be9e7a","description":"

Токен ОФД представляет собой ключ обмена данными между кассой и сервером ОФД. Сервер ОФД проверяет токен при каждой фискальной операции. Если токен некорректный, ОФД отклоняет операцию.

При создании кассы токен автоматически добавляется к кассе.

После генерации токена его нужно вставить в кассу:

перейти в интерфейс Webkassa
выбрать нужную кассу
в режиме редактирования вставить токен

Смена токена

При возникновении ситуации, когда необходимо провести замену токена, нужно выполнить запрос смены токена ОФД.

\n","_postman_id":"089c1173-a211-4544-88e7-414ce7be9e7a"},{"name":"Получение списка смен кассы","item":[{"name":"/api/v4/Cashbox/ShiftHistory","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"d5cfebff-c6f7-484d-b224-286efd5129b2"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"b59ed97b-467d-4ccb-b750-394e53fff423"}}],"id":"934ea2e3-b232-4a6b-b5d9-69efdfc4ed75","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей смен, которые необходимо исключить из ответа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 5 // Количество записей смен, которые будут отображены в ответе. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashbox/ShiftHistory","description":"

Назначение метода

Предоставить список смен онлайн-кассы по её заводскому номеру (ЗНК).

Смены возвращаются в хронологическом порядке и могут быть получены частично с использованием параметров постраничной навигации.

Управление размером ответа

Для ограничения количества возвращаемых данных используются параметры:

skip — количество смен, (начиная от создания кассы) которые будут пропущены и не включены в ответ.
Например, при значении skip = 5 первые пять смен кассы не войдут в результат.
\n
take — количество смен, которые будут возвращены в ответе.
\n

Параметры skip и take позволяют получать список смен частями и использовать постраничную загрузку данных.

\n","urlObject":{"protocol":"https","path":["api","v4","Cashbox","ShiftHistory"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"0dba5bd6-271e-4591-a0c5-9f6aef1ab233","name":"Получены смен кассы","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей смен, которые необходимо исключить из ответа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 5 // Количество записей смен, которые будут отображены в ответе. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashbox/ShiftHistory"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 05:15:03 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"Data\": {\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Skip\": 0, // Количество пропускаемых записей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Take\": 5, // Количество получаемых записей. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Total\": 3, // Общее количество записей смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Shifts\": [ // Массив смен (если массив пустой, то по кассе еще нет ни одной смены)\n {\n \"ShiftNumber\": 1, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OpenDate\": \"15.01.2026 11:03:07\", // Дата и время открытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CloseDate\": \"15.01.2026 14:19:08\" // Дата и время закрытия смены\n },\n {\n \"ShiftNumber\": 2, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OpenDate\": \"15.01.2026 14:20:29\", // Дата и время открытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CloseDate\": \"16.01.2026 10:12:07\" // Дата и время закрытия смены\n },\n {\n \"ShiftNumber\": 3, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OpenDate\": \"16.01.2026 10:12:37\", // Дата и время открытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CloseDate\": \"16.01.2026 10:13:29\" // Дата и время закрытия смены\n }\n ]\n }\n}"},{"id":"a7b21690-f7d2-419d-95e0-85e70a36c5b1","name":"Ошибка: неверная касса","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"SWK0003979\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей смен, которые необходимо исключить из ответа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 5 // Количество записей смен, которые будут отображены в ответе. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashbox/ShiftHistory"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 05:19:38 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 6,\n \"Text\": \"Касса с заводским номером: SWK0003979 не зарегистрированна в системе\"\n }\n ]\n}"}],"_postman_id":"934ea2e3-b232-4a6b-b5d9-69efdfc4ed75"}],"id":"4e7fab69-6da8-455a-8d45-020f1865b4dd","description":"

Смена кассы

Для работы онлайн-кассы требуется активная смена кассы, в рамках которой фиксируется деятельность кассира и выполняемые им операции.

Смена кассы — это период работы кассира на кассе, в течение которого:

учитываются выполняемые кассовые операции;
фиксируется факт начала и окончания работы кассира.

Смена имеет:

дату и время начала;
дату и время закрытия.

Открытие смены

Открытие смены происходит автоматически при выполнении первой кассовой операции.
Явного запроса на открытие смены со стороны пользователя не требуется.

Закрытие смены

Закрытие смены инициируется пользователем путем выполнения Z-отчета.
После закрытия смены выполнение кассовых операций до открытия новой смены невозможно.

\n","_postman_id":"4e7fab69-6da8-455a-8d45-020f1865b4dd"},{"name":"Получение информации по кассе","item":[{"name":"api-portal/v4/cashbox/client-info","id":"4bca25f9-a589-47c5-95e6-6330f8d8fb45","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/cashbox/client-info","description":"

Назначение метода

Получить информацию о статусе кассы, о лицензии, информацию об ОФД и о ЦТО. Информация доступна если организация пользователя является доверенной для организации-владельца запрашиваемой кассы.\nБлок данных о контактах ЦТО вернется, в случае, если ЦТО его заполнил.

\n","urlObject":{"protocol":"https","path":["api-portal","v4","cashbox","client-info"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"f64f96f6-0cc2-4d85-9ebe-12d21cc28147","name":"Получение информации о кассе","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/cashbox/client-info"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 02 Feb 2026 09:37:45 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CashboxStatus\": 1,//{ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"License\": {\n \"LicenseStatus\": 2, // Статус лицензии\n \"LicenseExpirationDate\": \"2026-10-24T00:00:00+05:00\" // Данные по лицензии {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Ofd\": {\n \"Ofd\": 4, //Код ОФД {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Expiration\": \"2027-02-27T00:00:00+05:00\" //Дата истечения лицензии ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"CurrentServiceCenterContactInfo\": [\n {\n \"CommunicationMethod\": \"+77051234567\", // Способ коммуникации, выбранный ЦТО {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"AdditionalInfo\": \"Консультация во вопросам Webkassa\" // Комментарий к способу коммуникации {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n ]\n }\n}"}],"_postman_id":"4bca25f9-a589-47c5-95e6-6330f8d8fb45"}],"id":"dcb57184-4f07-43c3-b55e-5160b916ee51","_postman_id":"dcb57184-4f07-43c3-b55e-5160b916ee51","description":""}],"id":"093ef7ac-86c1-41ee-b97d-6525718f598c","_postman_id":"093ef7ac-86c1-41ee-b97d-6525718f598c","description":""},{"name":"Чеки","item":[{"name":"Фискализация чека","item":[{"name":"/api/v4/check","id":"0e3a9eb3-fb7b-4795-8d9b-90f056d47b2d","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной.\r\n//В параметре \"CustomerXin\" укажите реальный ИИН/БИН\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OperationType\": 2, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 12, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 4000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР если TaxType = 100}\r\n \"Tax\": 6620.69, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"111\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796, // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Mark\": \"ZU604DSWYG6A\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Метка маркировки\r\n \"GTIN\": \"123\", // Глобальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"NTIN\": \"123\", // Национальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"ProductId\": \"\", // ID продукта на Виртуальном складе. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ Признак типа склада указан как Виртуальный склад (=1) И параметр GTIN/NTIN не заполнен.\r\n \"WarehouseType\": 1 // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Признак типа склада (0 или 1 - виртуальный склад)\r\n }\r\n ],\r\n \"TicketModifiers\": [ // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ. Скидка\\Наценка на весь чек\r\n {\r\n \"Sum\": 0, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Text\": \"Скидка по карте\", // Наименование скидки\\наценки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Type\": 1, // Тип модификатора (1 – скидка, 2 - наценка) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 0, // Тип налога {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 0, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Tax\": 0 // Налог (в тенге). Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n {\r\n \"Sum\": 0,\r\n \"Text\": \"Наценка за обслуживание\",\r\n \"Type\": 2,\r\n \"TaxType\": 100,\r\n \"TaxPercent\": 0,\r\n \"Tax\": 0\r\n }\r\n ],\r\n \"Payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Sum\": 48000, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaymentType\": 1 // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж). Каждый тип платежа, используемый в чеке, должен встречаться не более одного раза {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n { // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ, достаточно только одной секции в \"Payments\"\r\n \"Sum\": 0,\r\n \"PaymentType\": 0\r\n }\r\n ],\r\n \"Change\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Сдача. ПРИМЕЧАНИЕ - Если данное поле не заполняется (null), то расчет сдачи осуществляется на стороне Webkassa\r\n \"RoundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e4c84541-321b-4632-9131-c8a93795d4ec\", // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalOrderNumber\": \"9739-c8a93595d2ec\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Номер заказа - используется для продаж и возвратов\r\n \"CustomerEmail\": \"pochta@pochta.com\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77771234455\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n \"CustomerXin\": \"\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. ИИН/БИН покупателя\r\n \"ExternalLinkId\": \"8339525d-6c98-4f06-8a79-e13b4508fb92\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Может содержать только GUID. Идентификатор внешней ссылки для просмотра чека (или чеков) неавторизованными пользователями\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check","description":"

Назначение метода

Обработать операцию и передать данные сформированного фискального чека на сервер ОФД.

Настройка округления в запросе

RoundType - Тип математического округления, используемый для проверки данных чека от ПО интегратора.
По умолчанию имеет значение 0 (null, \"\"), если не передан иной код.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Код (RoundType)	Описание поведения	Пример
0	Каждая позиция округляется до 2 знаков после десятичного разделителя.	`1000,499 → 1000.50`, `1000,501 → 1000.50`
1	Параметр не используется. Передача этого значения приводит к ошибке запроса.	—
2	Каждая позиция округляется до целого числа (0 знаков после десятичного разделителя).	`1000.499 → 1000.00`, `1000.500 → 1001.00`
3	Сначала каждая позиция округляется до 2 знаков, затем общая сумма всех позиций округляется до целого числа.	Например: `1000.49 + 1000.49 = 2000.98 → 2001.00`

Операция возврата

Система позволяет выполнить возврат операции продажи или покупки. Для этого необходимо отправить запрос с параметром \"OperationType\": 3 (возврат продажи/покупки).

Особенности зависят от версии протокола кассы:

для кассы с протоколом 2.0.3 блок returnBasisDetails является обязательным;

Так же в протоколе 2.0.3 появилась возможность передавать несколько маркировок товара в одном массиве Postitions (см пример \"Продажа (протокол 2.0.3)\")

Ниже приведены примеры запроса и ответа для каждой версии протокола.

\n","urlObject":{"protocol":"https","path":["api","v4","check"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"8d82181b-3b4d-4039-b3fa-588227a48bf8","name":"Простая продажа","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной.\r\n//В параметре \"CustomerXin\" укажите реальный ИИН/БИН\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OperationType\": 2, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 12, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 4000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР если TaxType = 100}\r\n \"Tax\": 6620.69, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"111\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796, // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Mark\": \"\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Метка маркировки\r\n \"GTIN\": \"123\", // Глобальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"ProductId\": \"\", // ID продукта на Виртуальном складе. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ Признак типа склада указан как Виртуальный склад (=1) И параметр GTIN/NTIN не заполнен.\r\n \"WarehouseType\": 1 // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Признак типа склада (0 или 1 - виртуальный склад)\r\n }\r\n ],\r\n \"Payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Sum\": 48000, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaymentType\": 1 // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж). Каждый тип платежа, используемый в чеке, должен встречаться не более одного раза {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n { // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ, достаточно только одной секции в \"Payments\"\r\n \"Sum\": 0,\r\n \"PaymentType\": 0\r\n }\r\n ],\r\n \"Change\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Сдача. ПРИМЕЧАНИЕ - Если данное поле не заполняется (null), то расчет сдачи осуществляется на стороне Webkassa\r\n \"RoundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e4c892f3-82nb-4622-9131-c8a93795d4ec\", // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalOrderNumber\": \"9739-c8a93595d2ec\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Номер заказа - используется для продаж и возвратов\r\n \"CustomerEmail\": \"pochta@pochta.com\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77771234455\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n \"CustomerXin\": \"\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. ИИН/БИН покупателя\r\n \"ExternalLinkId\": \"8339525d-6e98-4f06-8a79-e13b4508fb92\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Может содержать только GUID. Идентификатор внешней ссылки для просмотра чека (или чеков) неавторизованными пользователями\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 15 Jan 2026 09:00:03 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CheckNumber\": \"1674656230288\", // Номер чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DateTime\": \"15.01.2026 14:00:02\", // Дата и время операции (чека) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DateTimeUTC\": \"15.01.2026 14:00:02 +05:00\", // Дата и время операции (чека) возвращается в формате UTC {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OfflineMode\": false, // Признак формирования чека в автономном режиме (True – если автономный режим) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxOfflineMode\": false, // Признак работы кассы в автономном режиме (True – если автономный режим) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Cashbox\": {// {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"UniqueNumber\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"RegistrationNumber\": \"852873427095\", // Регистрационный номер кассы (состоит из 12 цифр) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"IdentityNumber\": \"3413\", // Идентификационный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\", // Адрес места использования кассы (адрес учета в налоговой) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\", // Адрес места использования кассы (адрес учета в налоговой) на государственном языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Данные об ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на государственном языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на английском языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Host\": \"ctest3.wofd.kz/consumer\", // Адрес ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Code\": 4 // Код ОФД (1 – Казахтелеком, 2 – Транстелеком, 3 – Jusan Mobile, 4 – Smartcontract) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n },\n \"Organization\": {// {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerName\": \"asdasd\", // Наименование налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerIN\": \"\" // ИИН/БИН налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"CheckOrderNumber\": 8, // Порядковый номер чека в рамках смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftNumber\": 1, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"EmployeeName\": \"Известная Личность\", // Имя кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TicketUrl\": \"https://ctest3.wofd.kz/consumer?i=1674656230288&f=852873427095&s=48000.00&t=20260115T140002\", // Ссылка на чек (Ссылка ОФД на чек для формирования QR-кода на чеке.) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=1&extnum=e4c892f3-82nb-4622-9131-c8a93795d4ec\" // Ссылка на чек для печати {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n // В случае если печатная форма чека не формируется на стороне интегрирующейся системы, для печати можно использовать чек, который будет доступен по ссылке в этом параметре\n }\n}\n"},{"id":"49641100-4c4f-464d-b8c5-b942589d59b8","name":"Продажа с учетом скидок, наценок и маркировки","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной.\r\n//В параметре \"CustomerXin\" укажите реальный ИИН/БИН\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OperationType\": 2, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 12, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 4000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР если TaxType = 100}\r\n \"Tax\": 6620.69, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"111\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796, // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Mark\": \"ZU604DSWYG6A\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Метка маркировки\r\n \"GTIN\": \"123\", // Глобальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"ProductId\": \"\", // ID продукта на Виртуальном складе. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ Признак типа склада указан как Виртуальный склад (=1) И параметр GTIN/NTIN не заполнен.\r\n \"WarehouseType\": 1 // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Признак типа склада (0 или 1 - виртуальный склад)\r\n }\r\n ],\r\n \"TicketModifiers\": [ // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ. Скидка\\Наценка на весь чек\r\n {\r\n \"Sum\": 500, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Text\": \"Скидка по карте\", // Наименование скидки\\наценки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Type\": 1, // Тип модификатора (1 – скидка, 2 - наценка) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 1, // Тип налога {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Tax\": 0 // Налог (в тенге). Сумма всех налогов в чеке, с учетом налогов на скидку и наценку, должна быть положительной {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n {\r\n \"Sum\": 120,\r\n \"Text\": \"Наценка за обслуживание\",\r\n \"Type\": 2,\r\n \"TaxType\": 100,\r\n \"TaxPercent\": 20,\r\n \"Tax\": 0\r\n }\r\n ],\r\n \"Payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Sum\": 47620, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaymentType\": 1 // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж). Каждый тип платежа, используемый в чеке, должен встречаться не более одного раза {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n { // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ, достаточно только одной секции в \"Payments\"\r\n \"Sum\": 0,\r\n \"PaymentType\": 0\r\n }\r\n ],\r\n \"Change\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Сдача. ПРИМЕЧАНИЕ - Если данное поле не заполняется (null), то расчет сдачи осуществляется на стороне Webkassa\r\n \"RoundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e4c82243-82nb-4622-9131-c8a93795d4ea\", // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalOrderNumber\": \"9239-c8a93595d2ec\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Номер заказа - используется для продаж и возвратов\r\n \"CustomerEmail\": \"pochta@pochta.com\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77771234455\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n \"CustomerXin\": \"\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. ИИН/БИН покупателя\r\n \"ExternalLinkId\": \"8339325d-6c98-4f06-8a79-e13b4508fb92\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Может содержать только GUID. Идентификатор внешней ссылки для просмотра чека (или чеков) неавторизованными пользователями\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 15 Jan 2026 08:43:08 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CheckNumber\": \"1674655215983\",\n \"DateTime\": \"15.01.2026 13:43:04\",\n \"DateTimeUTC\": \"15.01.2026 13:43:04 +05:00\",\n \"OfflineMode\": false,\n \"CashboxOfflineMode\": false,\n \"Cashbox\": {\n \"UniqueNumber\": \"<Заводской номер кассы>\",\n \"RegistrationNumber\": \"852873427095\",\n \"IdentityNumber\": \"3413\",\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\",\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\",\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Host\": \"ctest3.wofd.kz/consumer\",\n \"Code\": 4\n }\n },\n \"Organization\": {\n \"TaxPayerName\": \"asdasd\",\n \"TaxPayerIN\": \"\"\n },\n \"CheckOrderNumber\": 7,\n \"ShiftNumber\": 1,\n \"EmployeeName\": \"Известная Личность\",\n \"TicketUrl\": \"https://ctest3.wofd.kz/consumer?i=1674655215983&f=852873427095&s=47620.00&t=20260115T134304\",\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=1&extnum=e4c82243-82nb-4622-9131-c8a93795d4ea\",\n \"Total\": 47620,\n \"TicketPrintFormat\": []\n }\n}"},{"id":"8af06ad4-ed8b-4e98-a3c5-fbd67d90861b","name":"Покупка","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной.\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OperationType\": 0, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 1, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 500, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": null, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР если TaxType = 100}\r\n \"Tax\": 0, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 0, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"UnitCode\": 111 // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }\r\n ],\r\n \"Payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Sum\": 500, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaymentType\": 1 // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }\r\n ],\r\n \"RoundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e2c99643-61nb-4622-1563-c0a12395d1ec\" // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Tue, 20 Jan 2026 08:53:15 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CheckNumber\": \"1675087822563\",\n \"DateTime\": \"20.01.2026 13:53:15\",\n \"DateTimeUTC\": \"20.01.2026 13:53:15 +05:00\",\n \"OfflineMode\": false,\n \"CashboxOfflineMode\": false,\n \"Cashbox\": {\n \"UniqueNumber\": \"<Заводской номер кассы>\",\n \"RegistrationNumber\": \"852873427095\",\n \"IdentityNumber\": \"3413\",\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\",\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\",\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Host\": \"ctest3.wofd.kz/consumer\",\n \"Code\": 4\n }\n },\n \"Organization\": {\n \"TaxPayerName\": \"asdasd\",\n \"TaxPayerIN\": \"\"\n },\n \"CheckOrderNumber\": 1,\n \"ShiftNumber\": 8,\n \"EmployeeName\": \"Известная Личность\",\n \"TicketUrl\": \"https://ctest3.wofd.kz/consumer?i=1675087822563&f=852873427095&s=500.00&t=20260120T135315\",\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=8&extnum=e2c99643-11nb-4622-1563-c0a12395d1ec\",\n \"Total\": 500,\n \"TicketPrintFormat\": []\n }\n}"},{"id":"70ae1861-42a9-455c-b71a-bd5ed5ab9133","name":"Продажа (протокол 2.0.3)","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной.\r\n//В параметре \"CustomerXin\" укажите реальный ИИН/БИН\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OperationType\": 2, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 12, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 4000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР если TaxType = 100}\r\n \"Tax\": 6620.69, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"111\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796, // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"GTIN\": \"123\", // Глобальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"NTIN\": \"123\", // Национальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"ProductId\": \"\", // ID продукта на Виртуальном складе. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ Признак типа склада указан как Виртуальный склад (=1) И параметр GTIN/NTIN не заполнен.\r\n \"WarehouseType\": 1, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Признак типа склада (0 или 1 - виртуальный склад)\r\n \"markList\": [ // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Массив Меток маркировки\r\n \"010761332602758821FvI3PKeymtDJd\",\r\n \"010761332602758821G6MWeCcab7BGL\",\r\n \"010761332602758821D3fNkMWAZEgho\",\r\n \"0107613326027588212YEhX92SNixOe\",\r\n \"010460398800839421SVNW87N0FD2A0\",\r\n \"010460398800839421X017Y9HVV5YWZ\",\r\n \"010761332602758821fMROe9A87AdRi\",\r\n \"010761332602758821K9pLqR5vT8MnX\",\r\n \"010460398800839421B3nKzP7qW4JtY\",\r\n \"010761332602758821H2rS8uM9vQ1Nx\"\r\n ]\r\n }\r\n ],\r\n \"TicketModifiers\": [ // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ. Скидка\\Наценка на весь чек\r\n {\r\n \"Sum\": 0, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Text\": \"Скидка по карте\", // Наименование скидки\\наценки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Type\": 1, // Тип модификатора (1 – скидка, 2 - наценка) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 0, // Тип налога {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 0, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Tax\": 0 // Налог (в тенге). Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n {\r\n \"Sum\": 0,\r\n \"Text\": \"Наценка за обслуживание\",\r\n \"Type\": 2,\r\n \"TaxType\": 100,\r\n \"TaxPercent\": 0,\r\n \"Tax\": 0\r\n }\r\n ],\r\n \"Payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Sum\": 48000, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaymentType\": 1 // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж). Каждый тип платежа, используемый в чеке, должен встречаться не более одного раза {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n { // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ, достаточно только одной секции в \"Payments\"\r\n \"Sum\": 0,\r\n \"PaymentType\": 0\r\n }\r\n ],\r\n \"Change\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Сдача. ПРИМЕЧАНИЕ - Если данное поле не заполняется (null), то расчет сдачи осуществляется на стороне Webkassa\r\n \"RoundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"f4c84541-32fb-4632-9131-c8a93795d4ec\", // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalOrderNumber\": \"9739-c8a93595d2ec\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Номер заказа - используется для продаж и возвратов\r\n \"CustomerEmail\": \"pochta@pochta.com\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77771234455\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n \"CustomerXin\": \"\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. ИИН/БИН покупателя\r\n \"ExternalLinkId\": \"8339525d-6c98-4f06-8a79-e13b4508fb92\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Может содержать только GUID. Идентификатор внешней ссылки для просмотра чека (или чеков) неавторизованными пользователями\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CheckNumber\": \"1675760809473\",\n \"DateTime\": \"28.01.2026 08:49:41\",\n \"DateTimeUTC\": \"28.01.2026 08:49:41 +05:00\",\n \"OfflineMode\": false,\n \"CashboxOfflineMode\": false,\n \"Cashbox\": {\n \"UniqueNumber\": \"<Заводской номер кассы>\",\n \"RegistrationNumber\": \"852873427095\",\n \"IdentityNumber\": \"3413\",\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\",\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\",\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Host\": \"ctest3.wofd.kz/consumer\",\n \"Code\": 4\n }\n },\n \"Organization\": {\n \"TaxPayerName\": \"asdasd\",\n \"TaxPayerIN\": \"\"\n },\n \"CheckOrderNumber\": 4,\n \"ShiftNumber\": 16,\n \"EmployeeName\": \"Известная Личность\",\n \"TicketUrl\": \"https://ctest3.wofd.kz/consumer?i=1675760809473&f=852873427095&s=48000.00&t=20260128T084941\",\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=SWK00034979&sh=16&extnum=f4c84541-32fb-4632-9131-c8a93795d4ec\",\n \"Total\": 48000,\n \"TicketPrintFormat\": []\n }\n}"},{"id":"e5113ed3-4773-46f5-9d36-5799f86e1ceb","name":"Возврат продажи/покупки (протокол 2.0.2)","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной.\r\n//В параметре \"CustomerXin\" укажите реальный ИИН/БИН\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OperationType\": 3, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 12, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 4000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР если TaxType = 100}\r\n \"Tax\": 6620.69, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"UnitCode\": 796, // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"GTIN\": \"123\" // Глобальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }\r\n ],\r\n \"Payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Sum\": 48000, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaymentType\": 1 // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }\r\n ],\r\n \"RoundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e4c84541-321b-4632-9131-c8a53795d2ec\" // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 26 Jan 2026 08:05:19 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"Data\": {\n \"CheckNumber\": \"1675612560231\",\n \"DateTime\": \"26.01.2026 15:38:52\",\n \"DateTimeUTC\": \"26.01.2026 15:38:52 +05:00\",\n \"OfflineMode\": false,\n \"CashboxOfflineMode\": false,\n \"Cashbox\": {\n \"UniqueNumber\": \"<Заводской номер кассы>\",\n \"RegistrationNumber\": \"852873427095\",\n \"IdentityNumber\": \"3413\",\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\",\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\",\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Host\": \"ctest3.wofd.kz/consumer\",\n \"Code\": 4\n }\n },\n \"Organization\": {\n \"TaxPayerName\": \"asdasd\",\n \"TaxPayerIN\": \"\"\n },\n \"CheckOrderNumber\": 14,\n \"ShiftNumber\": 14,\n \"EmployeeName\": \"Известная Личность\",\n \"TicketUrl\": \"https://ctest3.wofd.kz/consumer?i=1675612560231&f=852873427095&s=48000.00&t=20260126T153852\",\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=14&extnum=e4c84541-321b-4632-9131-c8a53795d2ec\",\n \"Total\": 48000.0,\n \"TicketPrintFormat\": []\n }\n}"},{"id":"202c678d-d0a2-4f48-8a22-9a29ece165bd","name":"Возврат продажи/покупки (протокол 2.0.3)","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"operationType\": 3, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"price\": 200, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"count\": 1, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"gtin\": \"\", // Глобальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"ntin\": \"\", // Национальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"positionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"positionName\": \"Печенье\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"sectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"unitCode\": 796, // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ProductId\": \"\", // ID продукта на Виртуальном складе. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ Признак типа склада указан как Виртуальный склад (=1) И параметр GTIN/NTIN не заполнен.\r\n \"WarehouseType\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Признак типа склада (0 или 1 - виртуальный склад)\r\n \"markList\": [] // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Массив Меток маркировки\r\n }\r\n ],\r\n \"payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"paymentType\": 0, // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж). Каждый тип платежа, используемый в чеке, должен встречаться не более одного раза {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"sum\": 200 // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }\r\n ],\r\n \"roundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"change\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Сдача. ПРИМЕЧАНИЕ - Если данное поле не заполняется (null), то расчет сдачи осуществляется на стороне Webkassa\r\n \"ticketModifiers\": [], // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ. Скидка\\Наценка на весь чек\r\n \"externalOrderNumber\": null, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Номер заказа - используется для продаж и возвратов\r\n \"customerEmail\": null, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"customerXin\": null, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. ИИН/БИН покупателя\r\n \"customerPhone\": null, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n \"externalCheckNumber\": \"11e976b4-e3a4-4630-a730-f88aa0f52215\", // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"returnBasisDetails\": { //{ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР для протокола 2.0.3 и старше}\r\n \"dateTime\": \"2025-08-13 17:40:42\", //Дата и время операции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР для протокола 2.0.3 и старше}\r\n \"total\": 20000, //Общая сумма операции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР для протокола 2.0.3 и старше}\r\n \"checkNumber\": \"1675360969843\", //Номер чека-основания {{ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР для протокола 2.0.3 и старше}\r\n \"registrationNumber\": \"852873427095\", //Регистрационный номер кассы (состоит из 12 цифр) {{ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР для протокола 2.0.3 и старше}\r\n \"isOffline\": false //Признак оффлайн режима кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР для протокола 2.0.3 и старше}\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 26 Jan 2026 09:05:47 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CheckNumber\": \"1675606974081\",\n \"DateTime\": \"26.01.2026 14:05:46\",\n \"DateTimeUTC\": \"26.01.2026 14:05:46 +05:00\",\n \"OfflineMode\": false,\n \"CashboxOfflineMode\": false,\n \"Cashbox\": {\n \"UniqueNumber\": \"<Заводской номер кассы>\",\n \"RegistrationNumber\": \"852873427095\",\n \"IdentityNumber\": \"3413\",\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\",\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\",\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Host\": \"ctest3.wofd.kz/consumer\",\n \"Code\": 4\n }\n },\n \"Organization\": {\n \"TaxPayerName\": \"asdasd\",\n \"TaxPayerIN\": \"\"\n },\n \"CheckOrderNumber\": 11,\n \"ShiftNumber\": 14,\n \"EmployeeName\": \"Известная Личность\",\n \"TicketUrl\": \"https://ctest3.wofd.kz/consumer?i=1675606974081&f=852873427095&s=200.00&t=20260126T140546\",\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=14&extnum=11e976b4-e3a4-4630-a730-f88f40f52215\",\n \"Total\": 200,\n \"TicketPrintFormat\": []\n }\n}"},{"id":"293d3885-5f73-4f86-aac4-16f47a49b40d","name":"Ошибка: чек уже существует в системе","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Сумма всех налогов в чеке, с учетом налогов на сидку и наценку, должна быть положительной.\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OperationType\": 2, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 12, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 4000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР если TaxType = 100}\r\n \"Tax\": 6620.69, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"111\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796, // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Mark\": \"ZU604DSWYG6A\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Метка маркировки\r\n \"GTIN\": \"123\", // Глобальный идентификатор товара (Штрихкод). {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ WarehouseType указан как Виртуальный склад (=1) И параметр ProductId (ID продукта на Виртуальном складе) не заполнен.\r\n \"ProductId\": \"\", // ID продукта на Виртуальном складе. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}, ЕСЛИ Признак типа склада указан как Виртуальный склад (=1) И параметр GTIN не заполнен.\r\n \"WarehouseType\": 1 // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Признак типа склада (0 или 1 - виртуальный склад)\r\n }\r\n ],\r\n \"TicketModifiers\": [ // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ. Скидка\\Наценка на весь чек\r\n {\r\n \"Sum\": 500, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Text\": \"Скидка по карте\", // Наименование скидки\\наценки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Type\": 1, // Тип модификатора (1 – скидка, 2 - наценка) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 1, // Тип налога {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Tax\": 0 // Налог (в тенге). Сумма всех налогов в чеке, с учетом налогов на скидку и наценку, должна быть положительной {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n {\r\n \"Sum\": 120,\r\n \"Text\": \"Наценка за обслуживание\",\r\n \"Type\": 2,\r\n \"TaxType\": 100,\r\n \"TaxPercent\": 20,\r\n \"Tax\": 0\r\n }\r\n ],\r\n \"Payments\": [ // Оплата {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Sum\": 47620, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaymentType\": 1 // Тип оплаты (0 - наличные, 1 - банковская карта, 4 - мобильный платеж). Каждый тип платежа, используемый в чеке, должен встречаться не более одного раза {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n },\r\n { // НЕОБЯЗАТЕЛЬНАЯ СЕКЦИЯ, достаточно только одной секции в \"Payments\"\r\n \"Sum\": 0,\r\n \"PaymentType\": 0\r\n }\r\n ],\r\n \"Change\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Сдача. ПРИМЕЧАНИЕ - Если данное поле не заполняется (null), то расчет сдачи осуществляется на стороне Webkassa\r\n \"RoundType\": 2, // Подробности указаны в описании метода /api/v4/check {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e4c82243-82nb-4622-9131-c8a93795d4ea\", // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalOrderNumber\": \"9239-c8a93595d2ec\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Номер заказа - используется для продаж и возвратов\r\n \"CustomerEmail\": \"pochta@pochta.com\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77771234455\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n \"CustomerXin\": \"987654321012\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. ИИН/БИН покупателя\r\n \"ExternalLinkId\": \"8339325d-6c98-4f06-8a79-e13b4508fb92\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Может содержать только GUID. Идентификатор внешней ссылки для просмотра чека (или чеков) неавторизованными пользователями\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 15 Jan 2026 08:08:58 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CheckNumber\": \"1674647449974\",\n \"DateTime\": \"15.01.2026 11:33:42\",\n \"DateTimeUTC\": \"15.01.2026 11:33:42 +05:00\",\n \"OfflineMode\": false,\n \"CashboxOfflineMode\": false,\n \"Cashbox\": {\n \"UniqueNumber\": \"<Заводской номер кассы>\",\n \"RegistrationNumber\": \"852873427095\",\n \"IdentityNumber\": \"3413\",\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\",\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\",\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Host\": \"ctest3.wofd.kz/consumer\",\n \"Code\": 4\n }\n },\n \"Organization\": {\n \"TaxPayerName\": \"asdasd\",\n \"TaxPayerIN\": \"\"\n },\n \"CheckOrderNumber\": 3,\n \"ShiftNumber\": 1,\n \"EmployeeName\": \"Известная Личность\",\n \"TicketUrl\": \"https://ctest3.wofd.kz/consumer?i=1674647449974&f=852873427095&s=48000.00&t=20260115T113342\",\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=1&extnum=e4c89243-82nb-4622-9131-c8a93795d1ec\",\n \"Total\": 48000,\n \"TicketPrintFormat\": []\n },\n \"Errors\": [\n {\n \"Code\": 14,\n \"Text\": \"Чек с внешним номером e4c89243-82nb-4622-9131-c8a93795d1ec уже присутствует в системе\"\n }\n ]\n}"}],"_postman_id":"0e3a9eb3-fb7b-4795-8d9b-90f056d47b2d"}],"id":"7170fd55-4ec6-4c44-9291-3b64df400c18","description":"

Фискализация — процесс регистрации операций по чеку в системе ОФД или Webkassa (в автономном режиме) с присвоением фискального признака.

Фискальный признак — уникальный код, формируемый при фискализации и подтверждающий факт регистрации чека.

В результате фискализации данные чека становятся юридически значимыми и могут быть выведены на печать или переданы в электронном виде.

Сервис поддерживает формирование чеков по следующим типам операций:

продажа;
\n
покупка;
\n
возврат продажи;
\n
возврат покупки.
\n

Чек может быть сформирован:

в онлайн-режиме — при наличии связи с сервером ОФД;
\n
в автономном режиме — при временной потере связи с ОФД.
\n

Онлайн-режим работы

При обработке запроса в онлайн-режиме:

чек формируется сервером ОФД;
\n
фискальный признак присваивается сервером ОФД;
\n
сформированный чек передаётся на печать.
\n

Автономный режим работы

При работе в автономном режиме:

фискальный признак генерируется системой Webkassa;
\n
выходной параметр OfflineMode имеет значение true;
\n
при печати чек содержит отметку о работе в автономном режиме.
\n

Результат обработки запроса

При успешной обработке запроса система возвращает:

фискальный признак, присвоенный чеку.

Запрос на обработку чека включает передачу данных по каждой позиции товара или услуги, входящей в чек.

Обязательный состав данных чека

При формировании электронной или печатной формы чека на стороне интегрирующейся системы должен быть обеспечен следующий набор данных:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Параметр	Комментарий
Наименование организации	Полное наименование организации
Идентификационный номер организации	ИИН или БИН организации
Заводской номер контрольно-кассовой машины	ЗНК, в ответе параметр `UniqueNumber`
Регистрационный номер контрольно-кассовой машины в налоговом органе	РНК, в ответе параметр `RegistrationNumber`
Порядковый номер чека	В ответе параметр `CheckOrderNumber`
Дата и время совершения операции	В ответе параметр `DateTime`
Цена товара, работы или услуги за единицу	Стоимость одной единицы товара, работы или услуги
Фискальный признак	В ответе параметр `CheckNumber`
Наименование оператора фискальных данных и реквизиты интернет-ресурса	Например: Оператор фискальных данных: ТОО \"Smartcontract\" (WOFD) Для проверки чека зайдите на сайт consumer.wofd.kz
Наименование товара, работы или услуги	Название позиции чека
Количество товара, работ или услуг и единица измерения	В запросе параметр `UnitCode`
Общая сумма продажи товара, работы или услуги	Итоговая сумма по позиции или чеку
Сумма НДС с указанием ставки	Сумма НДС по облагаемым оборотам
Адрес места использования контрольно-кассовой машины	В ответе параметр `Address`
Словосочетание «Фискальный чек»	Обязательная текстовая отметка в чеке
Закодированная информация о чеке	В ответе параметр `TicketUrl`
Отметка о формировании чека в автономном режиме	В ответе параметр `OfflineMode`

","_postman_id":"7170fd55-4ec6-4c44-9291-3b64df400c18"},{"name":"Получение чека для печати в текстовом виде","item":[{"name":"/api/v4/Ticket/PrintFormat","event":[{"listen":"test","script":{"id":"eccee2b7-4727-4e67-a890-544a82127c5e","exec":[""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"ab16472e-2fbf-47bd-957e-daa5ebfe9b22","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"972db184-74ac-4a1e-87ac-2eb76a45119a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"},{"key":"Accept-Language","value":"ru-RU","description":"

Укажите основной язык чека (kk-KZ, ru-RU или en-US)

\n","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Также для печати чека нужно указать в \"Headers\":\r\n// Accept-Language: <значение Accept-Language> - Передается язык чека, который будет вторым к казахскому языку - ru-RU или en-US.\r\n\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e2c89643-81cb-4622-9131-c8a93795d1ec\", // Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaperKind\": 3 // Размер бумаги - зависит от принтерак для печати чека (0 – 80 мм., 3 – 57(58) мм., 12 – А4 книжная, 13 – А4 альбомная) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Ticket/PrintFormat","description":"

Назначение метода

Получить печатную формы фискального чека

\n","urlObject":{"protocol":"https","path":["api","v4","Ticket","PrintFormat"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"dd2cdfcd-8b55-4e46-a415-cf4ec939b556","name":"Готовый для печати чек","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"},{"key":"Accept-Language","value":"kk-KZ","description":"Укажите основной язык чека (kk-KZ, ru-RU или en-US)","type":"text"},{"key":"Secondary-Language","value":"ru-RU","description":"Укажите дополнительный язык чека (kk-KZ, ru-RU или en-US), если он нужен","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Также для печати чека нужно указать в \"Headers\":\r\n// Accept-Language: <значение Accept-Language> - для основного языка чека\r\n// Secondary-Language: <значение Secondary-Language> - для основного языка чека\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e4c89243-82ab-4622-9131-c8a93795d4ec\", // Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaperKind\": 3 // Размер бумаги - зависит от принтерак для печати чека (0 – 80 мм., 3 – 57(58) мм., 12 – А4 книжная, 13 – А4 альбомная) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Ticket/PrintFormat"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 15 Jan 2026 09:57:02 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"Lines\": [\n {\n \"Order\": 1, // Порядок расположения в чеке строки, содержащей значение из value. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Type\": 0, // Тип контента для значения, содержащегося в value. Может содержать значения: {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n // 0 – text, \n // 1 – image (при получении этого типа, в value содержится значение в формате base64),\n // 2 – QR (при получении этого типа, необходимо значение, полученное в value отобразить на чеке в виде QR) \n \"Value\": \" asdasd \", // Значение для отображения на {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Style\": 0 // Стиль, который необходимо применить к значению в value (0 – обычный текст, 1 – жирный текст) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n\n },\n {\n \"Order\": 2,\n \"Type\": 0,\n \"Value\": \" ЖСН/ИИН \",\n \"Style\": 0\n },\n {\n \"Order\": 3,\n \"Type\": 0,\n \"Value\": \"ҚҚС Сериясы/НДС Серия 12333 №1234787\",\n \"Style\": 0\n },\n {\n \"Order\": 4,\n \"Type\": 0,\n \"Value\": \"------------------------------------\",\n \"Style\": 0\n },\n {\n \"Order\": 5,\n \"Type\": 0,\n \"Value\": \" Тестовая касса 14.01.26 11:01 \",\n \"Style\": 0\n },\n {\n \"Order\": 6,\n \"Type\": 0,\n \"Value\": \" Ауысым/Смена 2 \",\n \"Style\": 0\n },\n {\n \"Order\": 7,\n \"Type\": 0,\n \"Value\": \"Чек/Чек №1674659193716\",\n \"Style\": 0\n },\n {\n \"Order\": 8,\n \"Type\": 0,\n \"Value\": \"Кассир/Кассир Известная Личность\",\n \"Style\": 0\n },\n {\n \"Order\": 9,\n \"Type\": 0,\n \"Value\": \"САТУ/ПРОДАЖА №3\",\n \"Style\": 0\n },\n {\n \"Order\": 10,\n \"Type\": 0,\n \"Value\": \"------------------------------------\",\n \"Style\": 0\n },\n {\n \"Order\": 11,\n \"Type\": 0,\n \"Value\": \"Тапсырыс нөмірі/Номер заказа: \",\n \"Style\": 0\n },\n {\n \"Order\": 12,\n \"Type\": 0,\n \"Value\": \"9739-c8a93595d2ec\",\n \"Style\": 0\n },\n {\n \"Order\": 13,\n \"Type\": 0,\n \"Value\": \" 1. Коробка\",\n \"Style\": 0\n },\n {\n \"Order\": 14,\n \"Type\": 0,\n \"Value\": \" ZU604DSWYG6A\",\n \"Style\": 0\n },\n {\n \"Order\": 15,\n \"Type\": 0,\n \"Value\": \" NTIN:0200120931509\",\n \"Style\": 0\n },\n {\n \"Order\": 16,\n \"Type\": 0,\n \"Value\": \" 12 дана/шт x 4 000,00\",\n \"Style\": 0\n },\n {\n \"Order\": 17,\n \"Type\": 0,\n \"Value\": \" Құны/Стоимость 48 000,00\",\n \"Style\": 0\n },\n {\n \"Order\": 18,\n \"Type\": 0,\n \"Value\": \"Скидка по карте 0,00\",\n \"Style\": 0\n },\n {\n \"Order\": 19,\n \"Type\": 0,\n \"Value\": \"Наценка за обслуживание 0,00\",\n \"Style\": 0\n },\n {\n \"Order\": 20,\n \"Type\": 0,\n \"Value\": \"------------------------------------\",\n \"Style\": 0\n },\n {\n \"Order\": 21,\n \"Type\": 0,\n \"Value\": \"Банк картасы/Банковская карта: \",\n \"Style\": 0\n },\n {\n \"Order\": 22,\n \"Type\": 0,\n \"Value\": \"48 000,00\",\n \"Style\": 0\n },\n {\n \"Order\": 23,\n \"Type\": 0,\n \"Value\": \"БАРЛЫҒЫ/ИТОГО: 48 000,00\",\n \"Style\": 1\n },\n {\n \"Order\": 24,\n \"Type\": 0,\n \"Value\": \"соның ішінде ҚҚС/в т.ч. НДС 16%: \",\n \"Style\": 0\n },\n {\n \"Order\": 25,\n \"Type\": 0,\n \"Value\": \"6 620,69\",\n \"Style\": 0\n },\n {\n \"Order\": 26,\n \"Type\": 0,\n \"Value\": \"соның ішінде ҚҚС/в т.ч. НДС 0%: 0,00\",\n \"Style\": 0\n },\n {\n \"Order\": 27,\n \"Type\": 0,\n \"Value\": \"------------------------------------\",\n \"Style\": 0\n },\n {\n \"Order\": 28,\n \"Type\": 0,\n \"Value\": \"Клиенттің ЖСН/БСН/ИИН/БИН клиента: \",\n \"Style\": 0\n },\n {\n \"Order\": 29,\n \"Type\": 0,\n \"Value\": \"987654321012\",\n \"Style\": 0\n },\n {\n \"Order\": 30,\n \"Type\": 0,\n \"Value\": \"Email: pochta@pochta.com\",\n \"Style\": 0\n },\n {\n \"Order\": 31,\n \"Type\": 0,\n \"Value\": \"------------------------------------\",\n \"Style\": 0\n },\n {\n \"Order\": 32,\n \"Type\": 0,\n \"Value\": \"ФБ/ФП: 1674659193716\",\n \"Style\": 0\n },\n {\n \"Order\": 33,\n \"Type\": 0,\n \"Value\": \"Уақыты/Время: 15.01.2026 14:49:26\",\n \"Style\": 0\n },\n {\n \"Order\": 34,\n \"Type\": 0,\n \"Value\": \"Алматы қ., Алатау ауданы, \",\n \"Style\": 0\n },\n {\n \"Order\": 35,\n \"Type\": 0,\n \"Value\": \"Шанырак-2, көш. Рахымов ш.а., 172 \",\n \"Style\": 0\n },\n {\n \"Order\": 36,\n \"Type\": 0,\n \"Value\": \"үй, wk-devkkm-test\",\n \"Style\": 0\n },\n {\n \"Order\": 37,\n \"Type\": 0,\n \"Value\": \"г.Алматы, Алатауский район, мкр. \",\n \"Style\": 0\n },\n {\n \"Order\": 38,\n \"Type\": 0,\n \"Value\": \"Шанырак-2, көш. Рахымов, д. 172, \",\n \"Style\": 0\n },\n {\n \"Order\": 39,\n \"Type\": 0,\n \"Value\": \"wk-devkkm-test\",\n \"Style\": 0\n },\n {\n \"Order\": 40,\n \"Type\": 0,\n \"Value\": \"ФДО: ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"Style\": 0\n },\n {\n \"Order\": 41,\n \"Type\": 0,\n \"Value\": \"ОФД: ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Style\": 0\n },\n {\n \"Order\": 42,\n \"Type\": 0,\n \"Value\": \"Чекті тексеру үшін сайтқа \",\n \"Style\": 0\n },\n {\n \"Order\": 43,\n \"Type\": 0,\n \"Value\": \"кіріңіз/Для проверки чека зайдите \",\n \"Style\": 0\n },\n {\n \"Order\": 44,\n \"Type\": 0,\n \"Value\": \"на сайт: ctest3.wofd.kz/consumer\",\n \"Style\": 0\n },\n {\n \"Order\": 45,\n \"Type\": 0,\n \"Value\": \"------------------------------------\",\n \"Style\": 0\n },\n {\n \"Order\": 46,\n \"Type\": 0,\n \"Value\": \" ФИСКАЛДЫ ЧЕК/ФИСКАЛЬНЫЙ ЧЕК \",\n \"Style\": 1\n },\n {\n \"Order\": 47,\n \"Type\": 2,\n \"Value\": \"http://ctest3.wofd.kz/consumer?i=1674659193716&f=852873427095&s=48000.00&t=20260115T144926\",\n \"Style\": 0\n },\n {\n \"Order\": 48,\n \"Type\": 0,\n \"Value\": \" КСН/ИНК: 3413 \",\n \"Style\": 0\n },\n {\n \"Order\": 49,\n \"Type\": 0,\n \"Value\": \" МКК БКМ коды (КТН)/Код ККМ КГД \",\n \"Style\": 0\n },\n {\n \"Order\": 50,\n \"Type\": 0,\n \"Value\": \" (РНМ): 852873427095 \",\n \"Style\": 0\n },\n {\n \"Order\": 51,\n \"Type\": 0,\n \"Value\": \" КЗН/ЗНМ: <Заводской номер кассы> \",\n \"Style\": 0\n },\n {\n \"Order\": 52,\n \"Type\": 0,\n \"Value\": \" WEBKASSA.KZ \",\n \"Style\": 0\n }\n ]\n }\n}"},{"id":"6126b485-95ab-47e9-a01e-135353e79e23","name":"Ошибка: Касса указана неверно","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"},{"key":"Accept-Language","value":"kk-KZ","description":"Укажите основной язык чека (kk-KZ, ru-RU или en-US)","type":"text"},{"key":"Secondary-Language","value":"ru-RU","description":"Укажите дополнительный язык чека (kk-KZ, ru-RU или en-US), если он нужен","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// Также для печати чека нужно указать в \"Headers\":\r\n// Accept-Language: <значение Accept-Language> - для основного языка чека\r\n// Secondary-Language: <значение Secondary-Language> - для основного языка чека\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ExternalCheckNumber\": \"e4c89243-82ab-4622-9131-c8a93795d4ec\", // Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"SqK00034979\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PaperKind\": 3 // Размер бумаги - зависит от принтерак для печати чека (0 – 80 мм., 3 – 57(58) мм., 12 – А4 книжная, 13 – А4 альбомная) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Ticket/PrintFormat"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 15 Jan 2026 10:01:36 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 6,\n \"Text\": \"Касса с заводским номером: SqK00034979 не зарегистрированна в системе или не доступна пользователю\"\n }\n ]\n}"}],"_postman_id":"972db184-74ac-4a1e-87ac-2eb76a45119a"}],"id":"2d39eca6-2cf2-49c2-9090-62d1308f455b","description":"

Метод получения чека в текстовом виде

Данный метод используется для получения конкретного чека для печати в текстовом виде по операциям:

Продажа
\n
Возврат продажи
\n
Покупка
\n
Возврат покупки
\n

Заголовки запроса

В Accept-Language передается язык чека, который будет вторым к казахскому языку.
Передается ru-RU или en-US.
Если в Headers не задан язык, то по умолчанию применяются казахский и русский языки чека.

\n","_postman_id":"2d39eca6-2cf2-49c2-9090-62d1308f455b"},{"name":"Внешняя ссылка для просмотра чеков","item":[{"name":"/api-history/v4/Ticket/GetTicketGroupUrl?ExternalLinkId={ExternalLinkId}","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"5fafdb89-2e77-444b-86c7-07dc4efbfab2"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"833547fe-c1f8-4dc9-8d04-d54bc007d5ce"}}],"id":"8a53bc27-0a8c-4b75-9fb4-d0046025b5b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"// ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n// ВАЖНО!! В параметрах укажите ExternalLinkId, передаваемый в теле запроса к /api/Check (\"раздел Фискализация чека\") {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n{\r\n \r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-history/v4/Ticket/GetTicketGroupUrl?ExternalLinkId=","description":"

Назначение метода

Вернуть ссылку на чеки, полученные после операций под одним ExternalLinkId

\n","urlObject":{"protocol":"https","path":["api-history","v4","Ticket","GetTicketGroupUrl"],"host":["devkkm","webkassa","kz"],"query":[{"description":{"content":"

Укажите ExternalLinkId, передаваемый в теле запроса к /api/Check (раздел «Обработка операций по чеку»)

\n","type":"text/plain"},"key":"ExternalLinkId","value":""}],"variable":[]}},"response":[{"id":"9c3a2546-8ec7-476d-b379-4d913552eec1","name":"Ссылка получена","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"url":{"raw":"https://devkkm.webkassa.kz/api-history/v4/Ticket/GetTicketGroupUrl?ExternalLinkId={ExternalLinkId}","protocol":"https","host":["devkkm","webkassa","kz"],"path":["api-history","v4","Ticket","GetTicketGroupUrl"],"query":[{"key":"ExternalLinkId","value":"{ExternalLinkId}","description":"в поле \"Value\" укажите ExternalLinkId, передаваемый в теле запроса к /api/Check (раздел «Обработка операций по чеку»)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 15 Jan 2026 11:12:48 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"ExternalLink\": \"https://devkkm.webkassa.kz/spa-ui/ticket-group/7f8a3c214b6d4f92a38e91c5d2610b7e\" // ссылка на чек\n }\n}"}],"_postman_id":"8a53bc27-0a8c-4b75-9fb4-d0046025b5b7"}],"id":"0d3750aa-692e-458e-9e93-b71c2021df90","description":"

Сервис предоставления информации о чеках

Сервис предназначен для отображения чеков по операциям, которые были выполнены под одним общим идентификатором - ExternalLinkId.

Идентификатор представляет собой GUID, который генерируется Интегратором и передается входным параметром в методе POST /api/v4/check.

\n","_postman_id":"0d3750aa-692e-458e-9e93-b71c2021df90"},{"name":"Получение истории чеков кассы","item":[{"name":"/api/v4/Check/History","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"b5282eb6-b8ed-4553-bb82-980f4083a948"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"85869719-ec30-42d6-943b-f6bcc4d3165b"}}],"id":"79918b61-995a-4c3a-8dc0-295a6f5de920","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 1, // Количество записей чеков, которые необходимо пропустить {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 5, // Количество записей чеков, которые будут получены. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 4 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Check/History","description":"

Назначение метода

Получить список чеков по конкретной кассе за указанную смену.

\n","urlObject":{"protocol":"https","path":["api","v4","Check","History"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"7d85d08e-250e-4bbd-9bcc-da9be0056ed7","name":"Получение 2-х записей чеков","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей чеков, которые необходимо пропустить {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 2, // Количество записей чеков, которые будут получены. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 2 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Check/History"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 23 Jan 2026 07:01:26 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"Skip\": 0, // Количество пропускаемых записей\n \"Take\": 2, // Количество получаемых записей. Max=50\n \"Total\": 9, // Общее количество записей чеков в смене\n \"Items\": [ // Массив чеков\n {\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской номер кассы\n \"CashboxRegistrationNumber\": \"852873427095\", // Регистрационный номер ККМ в налоговой\n \"CashboxIdentityNumber\": 3413, // Идентификационный номер ККМ в ОФД\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\", // Адрес места использования кассы (адрес учета в налоговой)\n \"Number\": \"1674657457282\", // Номер чека (фискальный признак)\n \"OrderNumber\": 1, // Порядковый номер чека в рамках смены\n \"RegistratedOn\": \"15.01.2026 14:20:29\", // Дата и время чека\n \"RegistratedOnUTC\": \"15.01.2026 14:20:29 +05:00\", // Дата и время чека в UTC\n \"EmployeeName\": \"Известная Личность\", // ФИО кассира\n \"EmployeeCode\": 1, // Код кассира\n \"ShiftNumber\": 2, // Номер смены\n \"DocumentNumber\": 11, // Номер документа\n \"OperationType\": 2, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи)\n \"OperationTypeText\": \"Продажа\", // Название типа операции\n \"Payments\": [ // Массив платежей\n {\n \"Sum\": 448000, // Сумма\n \"PaymentTypeName\": \"Мобильные\" // Тип оплаты\n }\n ],\n \"Total\": 448000, // Общая сумма чека\n \"Change\": 0, // Сдача\n \"Taken\": 448000, // Сумма, полученная от покупателя\n \"Discount\": 0, // Сумма скидки\n \"MarkupPercent\": 0, // Наценка в процентах\n \"Markup\": 0, // Сумма наценки\n \"TaxPercent\": 16, // Налоговая ставка\n \"Tax\": 61793.1, // Налог\n \"VATPayer\": true, // Плательщик НДС\n \"Positions\": [ // Массив позиций\n {\n \"PositionName\": \"Коробка\", // Наименование позиции\n \"PositionCode\": \"111\", // Код позиции\n \"Count\": 112, // Количество\n \"Price\": 4000, // Цена\n \"DiscountPercent\": 0, // Скидка (в %)\n \"DiscountTenge\": 0, // Скидка (в тенге)\n \"MarkupPercent\": 0, // Процент наценки\n \"Markup\": 0, // Наценка (в тенге)\n \"TaxPercent\": 16, // Налоговая ставка\n \"Tax\": 61793.1, // Налог (в тенге)\n \"IsNds\": true, // С НДС\n \"IsStorno\": false,\n \"MarkupDeleted\": false,\n \"DiscountDeleted\": false,\n \"Sum\": 448000, // Сумма\n \"UnitCode\": 796 // Код единицы измерения\n }\n ],\n \"IsOffline\": false, // Режим работы (True – автономный режим)\n \"TicketUrl\": \"http://ctest3.wofd.kz/consumer?i=1674657457282&f=852873427095&s=448000.00&t=20260115T142029\", // Ссылка на чек (QR)\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=2&extnum=9349342e-98a6-4417-bd7e-af3e982912f4\", // Ссылка для печати\n \"ExternalCheckNumber\": \"9349342e-98a6-4417-bd7e-af3e982912f4\", // Номер чека системы-источника\n \"TaxPayerName\": \"asdasd\", // Наименование налогоплательщика\n \"TaxPayerIN\": \"\" // ИИН/БИН налогоплательщика\n }\n ],\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской номер кассы\n \"CashboxRegistrationNumber\": \"852873427095\", // Регистрационный номер ККМ\n \"CashboxIdentityNumber\": 3413, // Идентификационный номер ККМ\n \"Ofd\": { // Данные об ОФД\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД\n \"Host\": \"ctest3.wofd.kz/consumer\", // Адрес ОФД\n \"Code\": 4 // Код ОФД\n }\n }\n}\n"},{"id":"f962a826-bfa8-4e13-95d8-16a638d02383","name":"Ошибка: Смена кассы не найдена","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей чеков, которые необходимо пропустить {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 5, // Количество записей чеков, которые будут получены. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 4 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Check/History"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 10:51:29 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 15,\n \"Text\": \"Смена: 4 в кассе: <Заводской номер кассы> не найдена\"\n }\n ]\n}"}],"_postman_id":"79918b61-995a-4c3a-8dc0-295a6f5de920"}],"id":"93c6aad4-133c-40a4-bb13-ac9943f9e3a7","_postman_id":"93c6aad4-133c-40a4-bb13-ac9943f9e3a7","description":""},{"name":"Получение чека по номеру","item":[{"name":"/api/v4/Check/HistoryByNumber","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"095e47d2-8834-476c-a72c-7da5224920ad"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"8e724433-2eb6-400e-9508-f742895adeb5"}}],"id":"a222e1f5-07ee-45d4-b6f5-900c53ba7dd4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Number\": 167465745782, // Номер чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 2 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Check/HistoryByNumber","description":"

Назначение

Получить чек по его фискальному номеру (автономному коду).

\n","urlObject":{"protocol":"https","path":["api","v4","Check","HistoryByNumber"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"ebb3cbf2-3259-42c3-a0c9-e17b7e1a9b65","name":"Получение чека","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Number\": 1674657457282, // Номер чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 2 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Check/HistoryByNumber"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 11:17:59 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxRegistrationNumber\": \"852873427095\", // Регистрационный номер ККМ в налоговой {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxIdentityNumber\": 3413, // Идентификационный номер ККМ в ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\", // Адрес места использования кассы (адрес учета в налоговой) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Number\": \"1674657457282\", // Номер чека (фискальный признак) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OrderNumber\": 1, // Порядковый номер чека в рамках смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"RegistratedOn\": \"15.01.2026 14:20:29\", // Дата и время чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"RegistratedOnUTC\": \"15.01.2026 14:20:29 +05:00\", // Дата и время чека возвращается в формате UTC {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"EmployeeName\": \"Известная Личность\", // ФИО кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"EmployeeCode\": 1, // Код кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftNumber\": 2, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DocumentNumber\": 11, // Номер документа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OperationType\": 2, // Тип операции (0 - покупка, 1 - возврат покупки, 2 - продажа, 3 - возврат продажи) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OperationTypeText\": \"Продажа\", // Название типа операции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Payments\": [ // Массив платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n {\n \"Sum\": 448000, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentTypeName\": \"Мобильные\" // Тип оплаты {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n ],\n \"Total\": 448000, // Общая сумма чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 448000, // Сумма, полученная от покупателя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Сумма скидки в тенге {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"MarkupPercent\": 0, // Наценка в процентах {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Сумма наценки в тенге {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Tax\": 61793.1, // Налог {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATPayer\": true, // Плательщик НДС (True, если организация плательщик НСД) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Positions\": [ // Массив позиций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n {\n \"PositionName\": \"Коробка\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PositionCode\": \"111\", // Код позиции\n \"Count\": 112, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Price\": 4000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DiscountPercent\": 0, // Скидка (в %) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DiscountTenge\": 0, // Скидка (в тенеге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"MarkupPercent\": 0, // Процент наценки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка (в тенеге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Tax\": 61793.1, // Налог (в тенге) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"IsNds\": true, // С НДС (товар, облагаемый НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"IsStorno\": false, // Признак сторно {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"MarkupDeleted\": false, // Признак удаления наценки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DiscountDeleted\": false, // Признак удаления скидки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 448000, // Сумма {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"UnitCode\": 796 // Код единицы измерения, согласно справочнику в разделе «Получение справочника «Единицы измерения» {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n ],\n \"IsOffline\": false, // Режим работы (True – Автономный режим) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TicketUrl\": \"http://ctest3.wofd.kz/consumer?i=1674657457282&f=852873427095&s=448000.00&t=20260115T142029\", // Ссылка на чек для формирования QR-кода на чеке. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TicketPrintUrl\": \"https://devkkm.webkassa.kz/spa-ui/ticket?chb=<Заводской номер кассы>&sh=2&extnum=9349342e-98a6-4417-bd7e-af3e982912f4\", // Ссылка для печати. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Ofd\": { // Данные об ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Host\": \"ctest3.wofd.kz/consumer\", // Адрес ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Code\": 4 // Код ОФД (1 – Казахтелеком, 2 – Транстелеком, 3 – Jusan Mobile, 4 – Smartcontract) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"ExternalCheckNumber\": \"9349342e-98a6-4417-bd7e-af3e982912f4\", // Номер чека системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerName\": \"asdasd\", // Наименование налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerIN\": \"\" // ИИН/БИН налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n}\n"},{"id":"061c19e3-4c9e-4712-90ef-cc5f418d8c67","name":"Ошибка: чек не найден","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Number\": 167465745782, // Номер чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 2 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Check/HistoryByNumber"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 11:18:44 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 16,\n \"Text\": \"Чек №167465745782 не зарегистрирован в рамках 2 смены в <Заводской номер кассы> кассе\"\n }\n ]\n}"}],"_postman_id":"a222e1f5-07ee-45d4-b6f5-900c53ba7dd4"}],"id":"871b9098-458a-449a-abff-de31dd9b9cd6","_postman_id":"871b9098-458a-449a-abff-de31dd9b9cd6","description":""}],"id":"08ce179f-13f3-4627-8036-f556561a369c","description":"

Чек — это фискальный документ, формируемый онлайн-кассой в рамках кассовой смены и отражающий результат конкретной кассовой операции.

Чек:

создаётся при выполнении операции (продажа, покупка, возврат и т.д.);
содержит полный набор фискальных реквизитов, обязательных по законодательству РК;
фиксирует сумму, тип операции, применённые налоги, кассира и кассу;
подлежит передаче в ОФД и регистрации в КГД.

Каждый чек:

относится к конкретной кассе и смене;
имеет уникальный фискальный номер;
является юридически значимым документом;
не может быть изменён после фискализации.

Отмена или исправление ранее сформированного чека выполняется не редактированием, а созданием нового чека (например, чека возврата).

\n","_postman_id":"08ce179f-13f3-4627-8036-f556561a369c"},{"name":"Отчеты","item":[{"name":"X - отчет","item":[{"name":"/api/v4/XReport","id":"9134e1e0-1526-4dbe-82a9-6b24c18c1070","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/XReport","description":"

Назначение метода

Сформировать промежуточный отчет по указанной кассе

\n","urlObject":{"protocol":"https","path":["api","v4","XReport"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"fcd7a1c1-cf49-40e1-bf57-5b347ab06e37","name":"X-Отчет сформирован","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/XReport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 05:30:08 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"// Выходными данными является сформированный Х-отчет.\n{\n \"Data\": {\n \"TaxPayerName\": \"asdasd\", // Наименование налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerIN\": \"\", // ИИН/БИН налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerVAT\": true, // Плательщик НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerVATSeria\": \"12333\", // Серия свидетельства НДС (содержится в ответе только, если TaxPayerVATSeria ранее был указан в профиле организации) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerVATNumber\": \"1234787\", // Номер свидетельства НДС (содержится в ответе только, если TaxPayerVATNumber ранее был указан в профиле организации) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReportNumber\": 4, // Номер документа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxSN\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxIN\": 3413, // Идентификационный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxRN\": \"852873427095\", // Регистрационный номер кассы (состоит из 12 цифр) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"StartOn\": \"19.01.2026 10:07:20\", // Дата и время начала смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReportOn\": \"19.01.2026 10:08:36\", // Дата и время отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CloseOn\": \"19.01.2026 10:08:36\", // Дата и время закрытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierCode\": 1, // Код кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierName\": \"Известная Личность\", // ФИО кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftNumber\": 6, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DocumentCount\": 4, // Количество документов, сформированных за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PutMoneySum\": 0, // Сумма внесений за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TakeMoneySum\": 0, // Сумма изъятий за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ControlSum\": 490731578, // Контрольная сумма - служит проверочной суммой для всех данных отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OfflineMode\": false, // Признак работы в автономном режиме {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxOfflineMode\": false, // Признак работы кассы в автономном режиме {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"SumInCashbox\": 137320, // Сумма наличных в кассе на момент получения отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": { // Объект обязателен, если есть операции по продаже {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentsByTypesApiModel\": [], // Сумма оплаты по типам платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Общее количество операций по одному типу за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 26, // Общее количество операций по одному типу за все смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов по одному типу операций за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Buy\": { // Объект обязателен, если есть операции по покупке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentsByTypesApiModel\": [], // Сумма оплаты по типам платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 0, // Общее количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"ReturnSell\": { // Объект обязателен, если есть операции по возврату продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentsByTypesApiModel\": [], // Сумма оплаты по типам платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 1, // Общее количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"ReturnBuy\": { // Объект обязателен, если есть операции по возврату покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentsByTypesApiModel\": [], // Сумма оплаты по типам платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 0, // Общее количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"EndNonNullable\": {\n \"Sell\": 1239193, // Продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 448000, // Возвраты продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возвраты покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"StartNonNullable\": {\n \"Sell\": 1215493, // Продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 448000, // Возвраты продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возвраты покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на государственном языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на английском языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Host\": \"ctest3.wofd.kz/consumer\", // Адрес ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Code\": 4 // Код ОФД (1 - Казахтелеком, 2 – Транстелеком, 3 – Jusan Mobile, 4 – Smartcontract) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n }\n}"},{"id":"683f69da-16b5-4d13-97e1-9c763a3aa26e","name":"Ошибка: неверно указана касса","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"SWK0003499\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/XReport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 05:32:56 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 6,\n \"Text\": \"Касса с заводским номером: SWK0003499 не зарегистрирована в системе\"\n }\n ]\n}"}],"_postman_id":"9134e1e0-1526-4dbe-82a9-6b24c18c1070"}],"id":"4285d05b-0b23-4275-9604-0c076d08522a","description":"

X-отчет — промежуточный кассовый отчет за текущую смену без ее закрытия.

X-отчет используется для оперативного контроля работы кассы в течение смены.

При формировании X-отчета:

кассовая смена остается открытой;
сменные счетчики не обнуляются;
касса продолжает работу в обычном режиме.

X-отчет может формироваться неограниченное количество раз в рамках одной смены и не имеет финального фискального эффекта.

\n","_postman_id":"4285d05b-0b23-4275-9604-0c076d08522a"},{"name":"Z - отчет (закрытие смены)","item":[{"name":"Создание Z - отчета","item":[{"name":"/api/v4/ZReport","id":"fff79c20-9081-4f87-b664-11c1e262bcf2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport","description":"

Назначение

Сформировать Z-отчет и закрыть смену кассы.

\n","urlObject":{"protocol":"https","path":["api","v4","ZReport"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"3ddcb1ed-2bf3-47a5-bad3-3ce4c1d436dd","name":"Отчет сформирован","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 05:08:36 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"// Выходной информацией при проведении операции закрытия смены является Z-отчет (Zreport), а также признак работы в автономном режиме.\n{\n \"Data\": {\n \"TaxPayerName\": \"asdasd\", // Наименование налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerIN\": \"\", // ИИН/БИН налогоплательщика {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerVAT\": true, // Плательщик НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerVATSeria\": \"12333\", // Серия свидетельства НДС (содержится в ответе только, если TaxPayerVATSeria ранее был указан в профиле организации) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxPayerVATNumber\": \"1234787\", // Номер свидетельства НДС (содержится в ответе только, если TaxPayerVATNumber ранее был указан в профиле организации) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReportNumber\": 4, // Номер документа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxSN\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxIN\": 3413, // Идентификационный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxRN\": \"852873427095\", // Регистрационный номер кассы (состоит из 12 цифр) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"StartOn\": \"19.01.2026 10:07:20\", // Дата и время начала смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReportOn\": \"19.01.2026 10:08:36\", // Дата и время отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CloseOn\": \"19.01.2026 10:08:36\", // Дата и время закрытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierCode\": 1, // Код кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierName\": \"Известная Личность\", // ФИО кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftNumber\": 6, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DocumentCount\": 4, // Количество документов, сформированных за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PutMoneySum\": 10000, // Сумма внесений за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TakeMoneySum\": 18000, // Сумма изъятий за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ControlSum\": 770037955, // Контрольная сумма - проверочная сумма данных отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OfflineMode\": false, // Признак работы в автономном режиме {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxOfflineMode\": false, // Признак работы кассы в автономном режиме {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"SumInCashbox\": 137320, // Сумма наличных в кассе на момент получения отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по продаже\n \"PaymentsByTypesApiModel\": [\n {\n \"Sum\": 17500, // Сумма оплаты {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Type\": 4 // Тип платежа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n {\n \"Sum\": 6200,\n \"Type\": 0\n }\n ],\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 23700, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 3, // Количество операций за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 26, // Общее количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 3268.96 // НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Buy\": { // Объект обязателен, если есть операции по покупке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentsByTypesApiModel\": [],\n \"Discount\": 0,\n \"Markup\": 0,\n \"Taken\": 0,\n \"Change\": 0,\n \"Count\": 0,\n \"TotalCount\": 0,\n \"VAT\": 0\n },\n \"ReturnSell\": { // Объект обязателен, если есть операции по возврату продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentsByTypesApiModel\": [],\n \"Discount\": 0,\n \"Markup\": 0,\n \"Taken\": 0,\n \"Change\": 0,\n \"Count\": 0,\n \"TotalCount\": 1,\n \"VAT\": 0\n },\n \"ReturnBuy\": { // Объект обязателен, если есть операции по возвратк покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PaymentsByTypesApiModel\": [],\n \"Discount\": 0,\n \"Markup\": 0,\n \"Taken\": 0,\n \"Change\": 0,\n \"Count\": 0,\n \"TotalCount\": 0,\n \"VAT\": 0\n },\n \"EndNonNullable\": { // Необнуляемые суммы на конец смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": 1239193, // Продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 448000, // Возвраты продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возвраты покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"StartNonNullable\": { // Необнуляемые суммы на начало смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": 1215493, // Продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 448000, // Возвраты продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возвраты покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Ofd\": { // Данные об ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на государственном языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на английском языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Host\": \"ctest3.wofd.kz/consumer\", // Адрес ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Code\": 4 // Код ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n }\n}"},{"id":"c390526c-8454-4121-af73-c8d70d986a20","name":"Ошибка: закрытие закрытой смены","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 05:06:33 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 6,\n \"Text\": \"Касса с заводским номером: SWK0003499 не зарегистрирована в системе\"\n }\n ]\n}"},{"id":"a05dc8a9-e66a-464d-be68-1df07a29ead2","name":"Ошибка: неверно указана касса","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\" // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 05:14:09 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 6,\n \"Text\": \"Касса с заводским номером: SWK000349 не зарегистрирована в системе\"\n }\n ]\n}"}],"_postman_id":"fff79c20-9081-4f87-b664-11c1e262bcf2"}],"id":"053a8a13-88a1-450c-83c5-b106d48d57d0","_postman_id":"053a8a13-88a1-450c-83c5-b106d48d57d0","description":""},{"name":"Получение истории Z-отчетов кассы","item":[{"name":"/api/v4/ZReport/History","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"edd3a90b-2afa-4748-86ff-45885562af7e"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"3bc302e6-5092-4bf4-90cc-7c93affcfc84"}}],"id":"f658a8eb-b17a-4143-b994-dc2b607d9d4c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей отчетов, которые необходимо пропустить {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 1 // Количество записей отчетов, которые будут получены. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport/History","description":"

Назначение

Выгружает Z-отчеты

\n","urlObject":{"protocol":"https","path":["api","v4","ZReport","History"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"d1912b1e-debb-47cb-84c5-348dc860514b","name":"Отчет сформирован","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей отчетов, которые необходимо пропустить {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 1 // Количество записей отчетов, которые будут получены. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport/History"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 15 Nov 2024 07:14:24 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Skip\": 0, // Количество пропускаемых записей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Take\": 3, // Количество получаемых записей. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Total\": 3, // Всего Z-отчетов по кассе {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Reports\": [\n {\n \"ReportNumber\": 1, // Номер документа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxSN\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxIN\": 3413, // Идентификационный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxRN\": \"852873427095\", // Регистрационный номер кассы (состоит из 12 цифр) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"StartOn\": \"15.01.2026 11:03:07\", // Дата и время начала смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReportOn\": \"15.01.2026 14:19:08\", // Дата и время отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CloseOn\": \"15.01.2026 14:19:08\", // Дата и время закрытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierCode\": 1, // Код кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierName\": \"Известная Личность\", // ФИО кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftNumber\": 1, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DocumentCount\": 1, // Количество документов, сформированных за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PutMoneyCount\": 6, // Количество внесений за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PutMoneySum\": 3000, // Сумма внесений за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TakeMoneyCount\": 2, // Количество изъятий за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TakeMoneySum\": 1000, // Сумма изъятий за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ControlSum\": 2120603006, // Контрольная сумма - служит проверочной суммой для всех данных отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OfflineMode\": false, // Признак работы в автономном режиме {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxOfflineMode\": false, // Признак работы кассы в автономном режиме {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"SumInCashbox\": 2000, // Сумма наличных в кассе на момент получения отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по продаже\n \"PaymentsByTypesApiModel\": [], // Сумма оплаты по типам платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Количество операций за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 0, // Общее количество операций {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Buy\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по покупке\n \"PaymentsByTypesApiModel\": [],\n \"Discount\": 0,\n \"Markup\": 0,\n \"Taken\": 0,\n \"Change\": 0,\n \"Count\": 0,\n \"TotalCount\": 0,\n \"VAT\": 0\n },\n \"ReturnSell\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по возврату продажи\n \"PaymentsByTypesApiModel\": [],\n \"Discount\": 0,\n \"Markup\": 0,\n \"Taken\": 0,\n \"Change\": 0,\n \"Count\": 0,\n \"TotalCount\": 0,\n \"VAT\": 0\n },\n \"ReturnBuy\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по возврату покупки\n \"PaymentsByTypesApiModel\": [],\n \"Discount\": 0,\n \"Markup\": 0,\n \"Taken\": 0,\n \"Change\": 0,\n \"Count\": 0,\n \"TotalCount\": 0,\n \"VAT\": 0\n },\n \"EndNonNullable\": { // Необнуляемые суммы на конец смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": 0, // Продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 0, // Возвраты продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возвраты покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"StartNonNullable\": { // Необнуляемые суммы на начало смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": 0, // Продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 0, // Возвраты продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возвраты покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Ofd\": { // Данные об ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Host\": \"ctest.wofd.kz/consumer\", // Адрес ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Code\": 4 // Код ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n }\n ]\n }\n}"},{"id":"309134e0-85fa-4d33-b2c2-9924ec4ff8e9","name":"Ошибка: касса не найдена","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Skip\": 0, // Количество записей отчетов, которые необходимо пропустить {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Take\": 1 // Количество записей отчетов, которые будут получены. Max=50 {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport/History"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 04:08:38 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 6,\n \"Text\": \"Касса с заводским номером: SWK0003497 не зарегистрированна в системе или не доступна пользователю\"\n }\n ]\n}"}],"_postman_id":"f658a8eb-b17a-4143-b994-dc2b607d9d4c"}],"id":"a003aa73-f4e3-4846-bb75-50078f62d9cc","_postman_id":"a003aa73-f4e3-4846-bb75-50078f62d9cc","description":""},{"name":"Получение Z-отчета по номеру смены","item":[{"name":"/api/v4/ZReport/ByShiftNumber","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"0ccee5dc-3ba5-458e-912e-f6c96c29cbaf"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"70842a97-c84b-46d4-a45d-7dcbf26e15b0"}}],"id":"c5fd58ab-6c37-4151-8c10-ce6e35e11232","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 6 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport/ByShiftNumber","description":"

Назначение

Сформировать Z-отчет по номеру смены

\n","urlObject":{"protocol":"https","path":["api","v4","ZReport","ByShiftNumber"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"ee7b33fa-8a87-433a-9781-1aa9cb232407","name":"Формирование Z-отчета по номеру смены","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 6 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport/ByShiftNumber"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 05:20:19 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"ReportNumber\": 2, // Номер документа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxSN\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxIN\": 748, // Идентификационный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxRN\": \"660377756642\", // Регистрационный номер кассы (состоит из 12 цифр) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"StartOn\": \"14.11.2024 11:18:27\", // Дата и время начала смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReportOn\": \"14.11.2024 11:18:34\", // Дата и время отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CloseOn\": \"14.11.2024 11:18:34\", // Дата и время закрытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierCode\": 64, // Код кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierName\": \"Пользователь интегратора\", // ФИО кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftNumber\": 3, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DocumentCount\": 2, // Количество документов, сформированных за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PutMoneyCount\": 1, // Количество внесений за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"PutMoneySum\": 500, // Сумма внесений за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TakeMoneyCount\": 0, // Количество изъятий за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TakeMoneySum\": 0, // Сумма изъятий за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ControlSum\": 1389829662, // Контрольная сумма - служит проверочной суммой для всех данных отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OfflineMode\": false, // Признак работы в автономном режиме (True – если автономный режим) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxOfflineMode\": false, // Признак работы кассы в автономном режиме (True – если автономный режим) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"SumInCashbox\": 3000, // Сумма наличных в кассе на момент получения отчета {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n\n \"Sell\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по продаже\n \"PaymentsByTypesApiModel\": [], // Общая сумма оплаты в разрезе типов платежей (наличными, банковской картой и т.д.) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Общее количество операций по одному типу за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 0, // Общее количество операций по одному типу за все смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов по одному типу операций за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n\n \"Buy\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по покупке\n \"PaymentsByTypesApiModel\": [], // Общая сумма оплаты в разрезе типов платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Общее количество операций по одному типу за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 0, // Общее количество операций по одному типу за все смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов по одному типу операций за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n\n \"ReturnSell\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по возврату продажи\n \"PaymentsByTypesApiModel\": [], // Общая сумма оплаты в разрезе типов платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Общее количество операций по одному типу за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 0, // Общее количество операций по одному типу за все смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов по одному типу операций за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n\n \"ReturnBuy\": { // Объект {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} если есть операции по возврату покупки\n \"PaymentsByTypesApiModel\": [], // Общая сумма оплаты в разрезе типов платежей {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Discount\": 0, // Скидка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Markup\": 0, // Наценка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Taken\": 0, // Получено {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Change\": 0, // Сдача {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Count\": 0, // Общее количество операций по одному типу за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TotalCount\": 0, // Общее количество операций по одному типу за все смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VAT\": 0 // Общая сумма налогов по одному типу операций за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n\n \"EndNonNullable\": { // Необнуляемые суммы на конец смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": 0, // Продажа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 0, // Возврат продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возврат покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n\n \"StartNonNullable\": { // Необнуляемые суммы на начало смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": 0, // Продажа {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Buy\": 0, // Покупка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnSell\": 0, // Возврат продажи {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ReturnBuy\": 0 // Возврат покупки {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Host\": \"ctest3.wofd.kz/consumer\", // Адрес ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Code\": 4 // Код ОФД (1 - Казахтелеком, 2 – Транстелеком, 3 – Jusan Mobile, 4 – Smartcontract) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n }\n}"},{"id":"0b16af5a-53d8-4a8a-aefd-b39bbd50a639","name":"Ошибка: смена не найдена","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"shiftNumber\": 16 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/ZReport/ByShiftNumber"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 05:18:31 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 13,\n \"Text\": \"Смена: 16 в кассе: <Заводской номер кассы> не найдена\"\n }\n ]\n}"}],"_postman_id":"c5fd58ab-6c37-4151-8c10-ce6e35e11232"}],"id":"d6c745d0-fa0f-43b7-9340-64133e6f4fb8","_postman_id":"d6c745d0-fa0f-43b7-9340-64133e6f4fb8","description":""}],"id":"5aad1939-4b38-4576-9bd9-0bbbca96ff94","description":"

Z-отчет (Zero, отчет с гашением) — итоговый кассовый отчет за смену с закрытием смены и обнулением сменных счетчиков.

После успешного формирования Z-отчета:

фиксируется финансовые итоги работы кассы.
кассовая смена считается закрытой;
все итоги по операциям смены зафиксированы и переданы в ОФД;
сменные счетчики кассы обнуляются;
выполнение кассовых операций в рамках данной смены становится невозможным.

Z-отчет формируется строго один раз для каждой смены.
Повторный вызов метода для уже закрытой смены недопустим.

В отличие от X-отчета:

X-отчет используется для промежуточного контроля и не закрывает смену;
Z-отчет завершает смену и имеет юридически значимый характер.

\n","_postman_id":"5aad1939-4b38-4576-9bd9-0bbbca96ff94"},{"name":"Отчет по секциям","item":[{"name":"/api-history/v4/Reports/ReportByShiftsAndSections","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"4f39fd61-a414-4186-a928-c7013c77382d"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"2c8fddb7-88a3-4ab0-a9c5-0171ab641db9"}}],"id":"1bf59394-42aa-438a-a287-7d8a5d38e323","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"StartDate\": \"01.01.2026 11:19:14\", // Начало периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"EndDate\": \"19.01.2024 12:20:19\" //Конец периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-history/v4/Reports/ReportByShiftsAndSections","description":"

Назначение

Сформировать отчет по секции и смене кассы. Секции присутствуют в ответе метода.

\n","urlObject":{"protocol":"https","path":["api-history","v4","Reports","ReportByShiftsAndSections"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"3e04dd65-6b10-4021-a659-9cab100ab477","name":"Отчет сформирован","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"StartDate\": \"18.01.2026 11:10:19\", // Начало периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"EndDate\": \"19.01.2026 12:00:19\" //Конец периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-history/v4/Reports/ReportByShiftsAndSections"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 06:59:44 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"Data\": {\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftsInformation\": [ // Информация по сменам {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n {\n \"ShiftNumber\": 4, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierCode\": 1, // Код кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashierName\": \"Известная Личность\", // ФИО кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"StartOn\": \"19.01.2026 08:47:17\", // Дата и время открытия смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ClosedOn\": \"19.01.2026 08:47:26\", // Дата и время закрытия смены, отображается если смена была закрыта\n \"Sections\": [ // Список секций с операциями {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n {\n \"Section\": \"NoName\", // Наименование секции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": { // Продажи по секции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Quantity\": 2, // Количество продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 56000.00000 // Сумма продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Buy\": { // Покупки по секции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Quantity\": 0, // Количество покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 0.0 // Сумма покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"ReturnSell\": { // Возвраты продаж по секции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Quantity\": 0, // Количество возвратов продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 0.0 // Сумма возвратов продаж {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"ReturnBuy\": { // Возвраты покупок по секции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Quantity\": 0, // Количество возвратов покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 0.0 // Сумма возвратов покупок {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Revenue\": { // Итоговая выручка по секции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 56000.00000 // Сумма выручки (продажи минус возвраты) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n }\n ],\n \"SectionsTotal\": { // Итоги по всем секциям за смену {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sell\": {\n \"Quantity\": 2, // Общее количество продаж по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 56000.00000 // Общая сумма продаж по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Buy\": {\n \"Quantity\": 0, // Общее количество покупок по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 0.0 // Общая сумма покупок по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"ReturnSell\": {\n \"Quantity\": 0, // Общее количество возвратов продаж по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 0.0 // Общая сумма возвратов продаж по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"ReturnBuy\": {\n \"Quantity\": 0, // Общее количество возвратов покупок по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 0.0 // Общая сумма возвратов покупок по всем секциям {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n \"Revenue\": {\n \"Sum\": 56000.00000 // Общая выручка по всем секциям (продажи минус возвраты) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n }\n },\n {\n \"ShiftNumber\": 5,\n \"CashierCode\": 1,\n \"CashierName\": \"Известная Личность\",\n \"StartOn\": \"19.01.2026 09:51:27\",\n \"ClosedOn\": \"19.01.2026 10:02:09\",\n \"Sections\": [\n {\n \"Section\": \"NoName\",\n \"Sell\": {\n \"Quantity\": 2,\n \"Sum\": 57600.00000\n },\n \"Buy\": {\n \"Quantity\": 0,\n \"Sum\": 0.0\n },\n \"ReturnSell\": {\n \"Quantity\": 0,\n \"Sum\": 0.0\n },\n \"ReturnBuy\": {\n \"Quantity\": 0,\n \"Sum\": 0.\n"},{"id":"f749e3bb-239f-486c-86f2-c1238ed5d4cd","name":"Ошибка: неверная дата","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"<Заводской номер кассы>\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"StartDate\": \"01.01.2026 11:19:14\", // Начало периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"EndDate\": \"19.01.2024 12:20:19\" //Конец периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-history/v4/Reports/ReportByShiftsAndSections"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 06:44:26 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"Дата окончания отчета не может быть раньше чем начало\"\n }\n ]\n}"},{"id":"242cf112-94a9-4c5d-a147-019e837489be","name":"Ошибка: Неверно указана касса","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"CashboxUniqueNumber\": \"SWK000349755\", // Заводской/серийный номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"StartDate\": \"18.01.2026 11:10:19\", // Начало периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"EndDate\": \"19.01.2026 12:00:19\" //Конец периода даты открытия смен {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-history/v4/Reports/ReportByShiftsAndSections"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 07:08:19 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 6,\n \"Text\": \"Касса не найдена\"\n }\n ]\n}"}],"_postman_id":"1bf59394-42aa-438a-a287-7d8a5d38e323"}],"id":"88e8066f-a7ea-44e0-ac82-03be9c36cc29","description":"

Секции — это категория товаров внутри кассы, используемая для структурирования продаж и корректного применения налогов. Каждая секция может иметь собственную ставку НДС, что упрощает определение налога для товаров определённой группы.

Основные принципы работы с секциями:

Пользователь может создавать, редактировать и удалять секции для структурирования товаров (UI Webkassa).
Каждой секции можно назначить отдельную налоговую ставку.
При оформлении продажи или возврата пользователь выбирает нужную секцию из выпадающего списка.

\n","_postman_id":"88e8066f-a7ea-44e0-ac82-03be9c36cc29"},{"name":"Контрольная лента за смену","item":[{"name":"/api/v4/Reports/ControlTape","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"6fa6d8e0-11c2-427f-9f25-3f9e2847ba95"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"bd05ed76-057a-4afc-80e5-97d5b891b6b4"}}],"id":"f9627ba1-4662-466f-a4ba-e03566c8f9c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ShiftNumber\": 6 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Reports/ControlTape","description":"

Назначение метода

Сформировать отчет, содержащий информацию о всех кассовых операциях за конкретную смену.

\n","urlObject":{"protocol":"https","path":["api","v4","Reports","ControlTape"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"d2bd115a-1729-4598-b7ab-43e9ae70801a","name":"Получить данные за смену","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ShiftNumber\": 6 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Reports/ControlTape"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 08:38:23 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": [\n {\n \"OperationTypeText\": \"Продажа\", // Тип операции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 17500, // Сумма операции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Date\": \"19.01.2026 10:07:20\", // Дата выполнения операции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"EmployeeCode\": 1, // Код сотрудника, выполнившего операцию {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Number\": \"1674987867507\", // Номер чека (только для операций, формирующих фискальный чек)\n \"IsOffline\": false // Признак автономного режима (true — операция выполнена офлайн) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n {\n \"OperationTypeText\": \"Продажа\",\n \"Sum\": 800,\n \"Date\": \"19.01.2026 10:07:36\",\n \"EmployeeCode\": 1,\n \"Number\": \"1674987884198\",\n \"IsOffline\": false\n },\n {\n \"OperationTypeText\": \"Продажа\",\n \"Sum\": 5400,\n \"Date\": \"19.01.2026 10:08:03\",\n \"EmployeeCode\": 1,\n \"Number\": \"1674987911148\",\n \"IsOffline\": false\n },\n {\n \"OperationTypeText\": \"Внесение\",\n \"Sum\": 10000,\n \"Date\": \"19.01.2026 10:08:13\",\n \"EmployeeCode\": 1,\n \"IsOffline\": false\n },\n {\n \"OperationTypeText\": \"Изъятие\",\n \"Sum\": 18000,\n \"Date\": \"19.01.2026 10:08:22\",\n \"EmployeeCode\": 1,\n \"IsOffline\": false\n }\n ]\n}"},{"id":"93993bc0-caf4-488f-adb2-0a3bb09c246d","name":"Ошибка: касса не найдена","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"SWK0003499\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ShiftNumber\": 6 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Reports/ControlTape"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 08:39:31 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 5,\n \"Text\": \"Касса не найдена\"\n }\n ]\n}"},{"id":"dfd718c4-5105-4501-8416-3066ff27dc6d","name":"Ошибка: смена не найдена","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"ShiftNumber\": 61 // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Reports/ControlTape"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 19 Jan 2026 08:40:24 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 15,\n \"Text\": \"Смена не найдена\"\n }\n ]\n}"}],"_postman_id":"f9627ba1-4662-466f-a4ba-e03566c8f9c0"}],"id":"5312e7c3-45f2-40ea-9a86-700c60a40901","description":"

Это отчёт, содержащий последовательную хронологическую запись всех кассовых операций, выполненных на ККМ за определённый смену.

\n","_postman_id":"5312e7c3-45f2-40ea-9a86-700c60a40901"}],"id":"343870ee-3c33-4f7e-84a9-589eb5f89e43","_postman_id":"343870ee-3c33-4f7e-84a9-589eb5f89e43","description":""},{"name":"Внесение и изъятие наличных из кассы","item":[{"name":"/api/v4/MoneyOperation","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"c6bbac0e-5ae8-4532-9fa1-8cac25c30c4c"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"88abebad-299d-4cd5-a76d-0bbaf4ad1074"}}],"id":"08e02b52-1115-477e-9f39-34b7f6461fe3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"operationType\": 1, // тип операции, 0 - внесение, 1 - изъятие {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"sum\": 180000, // сумма внесения/изъятия наличных из кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"externalCheckNumber\": \"33333121213\" // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/MoneyOperation","description":"

Назначение метода

Проводит операции пополнения или изъятия наличных из переданной кассы

\n","urlObject":{"protocol":"https","path":["api","v4","MoneyOperation"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"b17f204f-8fc2-44fe-83ed-017f302ab46c","name":"Пополнение кассы","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"operationType\": 0, // тип операции, 0 - внесение, 1 - изъятие {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"sum\": 65020, // сумма внесения/изъятия наличных из кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"externalCheckNumber\": \"33333121212\" // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/MoneyOperation"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 04:21:47 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"OfflineMode\": false, // Признак выполнения операции в автономном режиме (true - автономный режим включен) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CashboxOfflineMode\": false, // Признак работы кассы в автономном режиме (true - автономный режим включен) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"ShiftNumber\": 2, // Номер смены {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DateTime\": \"16.01.2026 09:21:47\", // Дата и время операции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"DateTimeUTC\": \"16.01.2026 09:21:47 +05:00\", // Дата и время операции с часовым поясом {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Sum\": 117520, // Текущая сумма в кассе с учетом проведенной операции внесения/изъятия {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Cashbox\": { // Информация о кассе {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"UniqueNumber\": \"<Заводской номер кассы>\", // Заводской/серийный номер ККМ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"RegistrationNumber\": \"852873427095\", // Регистрационный номер ККМ в налоговой {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"IdentityNumber\": \"3413\", // Идентификационный номер ККМ в ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\", // Адрес места использования кассы (адрес учета в налоговой) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\", // Адрес места использования кассы (адрес учета в налоговой) на государственном языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Ofd\": { // Данные об ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на государственном языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\", // Наименование ОФД на английском языке\n \"Host\": \"ctest3.wofd.kz/consumer\", // Адрес ОФД {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Code\": 4 // Код ОФД (1 - Казахтелеком, 2 – Транстелеком, 3 – Jusan Mobile, 4 – Smartcontract) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n }\n }\n}"},{"id":"4c688483-9c88-4a38-bd10-52f84abed669","name":"Изъятие из кассы","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"operationType\": 1, // тип операции, 0 - внесение, 1 - изъятие {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"sum\": 18000, // сумма внесения/изъятия наличных из кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"externalCheckNumber\": \"33333121211\" // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/MoneyOperation"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 04:26:33 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"OfflineMode\": false,\n \"CashboxOfflineMode\": false,\n \"ShiftNumber\": 2,\n \"DateTime\": \"16.01.2026 09:26:33\",\n \"DateTimeUTC\": \"16.01.2026 09:26:33 +05:00\",\n \"Sum\": 99520,\n \"Cashbox\": {\n \"UniqueNumber\": \"<Заводской номер кассы>\",\n \"RegistrationNumber\": \"852873427095\",\n \"IdentityNumber\": \"3413\",\n \"Address\": \"г.Алматы, Алатауский район, мкр. Шанырак-2, көш. Рахымов, д. 172, wk-devkkm-test\",\n \"AddressKz\": \"Алматы қ., Алатау ауданы, Шанырак-2, көш. Рахымов ш.а., 172 үй, wk-devkkm-test\",\n \"Ofd\": {\n \"Name\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"NameKz\": \"ЖШС \\\"Smartcontract\\\" (WOFD)\",\n \"NameEn\": \"ТОО \\\"Smartcontract\\\" (WOFD)\",\n \"Host\": \"ctest3.wofd.kz/consumer\",\n \"Code\": 4\n }\n }\n }\n}"},{"id":"2b6a31bc-3fca-43b6-809b-36b5d6cd26b2","name":"Ошибка: Недостаточно средств","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"cashboxUniqueNumber\": \"<Заводской номер кассы>\", // укажите ЗНК (заводской номер кассы) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"operationType\": 1, // тип операции, 0 - внесение, 1 - изъятие\r\n \"sum\": 180000, // сумма внесения/изъятия наличных из кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"externalCheckNumber\": \"33333121213\" // ВАЖНОЕ ПОЛЕ, т.к. позволяет обеспечивать идемпотентность при сбоях в связи. Номер операции системы-источника {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/MoneyOperation"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 04:27:44 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 8,\n \"Text\": \"В кассе недостаточно наличности для проведения операции (В кассе: 99,520.000)\"\n }\n ]\n}"}],"_postman_id":"08e02b52-1115-477e-9f39-34b7f6461fe3"}],"id":"f0ec1168-357e-4bad-9829-3f8435cc02d4","description":"

Данная операция используется для фиксации внесения или изъятия наличных денежных средств в кассу.

Результат выполнения операции

При успешной обработке запроса сервис возвращает:

текущую сумму наличных в кассе с учётом выполненной операции;
отметку о режиме, в котором была проведена операция: онлайн или автономный.

\n","_postman_id":"f0ec1168-357e-4bad-9829-3f8435cc02d4"},{"name":"Организация","item":[{"name":"Получение данных организации","item":[{"name":"/api-portal/v4/organization/main-info","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"144a8e30-281c-4d2c-8a47-80eb00d3d69f"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"fa5958ad-8716-4818-a559-175c0a56f3d5"}}],"id":"fe486a6f-9f5e-4e2b-85f8-9ee06bd26417","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n//В параметре \"Xin\" укажите реальный ИИН/БИН\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Xin\": \"\" // ИИН/БИН организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/organization/main-info","description":"

Назначение метода

Получить информацию по организации, в которой зарегистрирован пользователь.

\n","urlObject":{"protocol":"https","path":["api-portal","v4","organization","main-info"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"28700546-955e-406f-b95d-7b5bb4c32617","name":"Получение данных организации","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n//В параметре \"Xin\" укажите реальный ИИН/БИН\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Xin\": \"\" // ИИН/БИН организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/organization/main-info"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 09:38:53 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"Xin\": \"\", // ИИН/БИН организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"FullName\": \"ТОО DevKKM\", // Наименование организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"LegalAddress\": \"г.Астана, район Есиль, пр.Ркспублики, д.1, кв.28\", // Юридический адрес организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"TaxationType\": 100, // Вид налогообложения (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"EconomicActivityCode\": \"6201\", // Код ОКЭД организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATInfo\": { // Данные об НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATPayer\": true, // Плательщик НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATSeries\": \"11111\", // Серия свидетельства НДС (содержится в ответе только, если VATPayer=true и VATSeries ранее был указан в профиле организации) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATNumber\": \"1111111\", // Номер свидетельства НДС (содержится в ответе только, если VATPayer=true и VATNumber ранее был указан в профиле организации) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATRates\": [ // Массив из применяемых в организации ставок НДС. Содержится в ответе только, если VATPayer=true {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n 0,\n 12\n ]\n }\n }\n}"},{"id":"24d06676-a9b8-4a58-a3d6-187b52af6e3d","name":"Ошибка: Неверно указан XIN","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n//В параметре \"Xin\" укажите реальный ИИН/БИН\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Xin\": \"\" // ИИН/БИН организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/organization/main-info"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"ИИН/БИН организации отсутствует либо текущий пользователь не зарегистрирован в данной организации\"\n }\n ]\n}"}],"_postman_id":"fe486a6f-9f5e-4e2b-85f8-9ee06bd26417"}],"id":"6b8e0283-135d-4380-90cd-d1fb923bf234","description":"

Метод возвращает информацию по организации

\n","_postman_id":"6b8e0283-135d-4380-90cd-d1fb923bf234"},{"name":"Получение списка кассиров","item":[{"name":"/api/v4/Employee/List","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"26fad763-c83c-48a7-bb5c-686c4583cb6a"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"a36952a3-3cb8-4dc5-976a-f3ced3989fff"}}],"id":"c97a3b6e-1585-4444-a79e-bd045c537b6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Employee/List","description":"

Назначение метода

Предоставить список кассиров организации и список доступных им касс

\n","urlObject":{"protocol":"https","path":["api","v4","Employee","List"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"5b6a0e49-aa89-4985-a7e7-d58585b9a7c9","name":"Список кассиров организации","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Employee/List"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 06:11:29 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"-1"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":" {\n \"Data\": [\n {\n \"FullName\": \"Иванов Егор Николаевич\", // имя кассира {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Email\": \"pochta@gmail.com\", // e-mail, логин (идентификатор пользователя в организации) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Cashboxes\": [] // Массив касс. Включает в себя перечень заводских номеров касс только версии 1С:Webkassa, к кассовым операциям которых кассир имеет доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n {\n \"FullName\": \"Тест Тест Тест\",\n \"Email\": \"test2@webkassa.kz\",\n \"Cashboxes\": [\n \"SWK00031035\", // касса с признаком 1С\n \"SWK00031459\" // касса с признаком 1С\n ]\n }\n ]\n}"}],"_postman_id":"c97a3b6e-1585-4444-a79e-bd045c537b6d"}],"id":"51b8187a-66bb-407a-841c-b57da8893332","description":"

Метод возвращает список кассиров организации и онлайн-касс, к которым у них настроен доступ.

В ответе для каждого кассира указывается перечень касс с учётом прав доступа, заданных на уровне кассы.

\n","_postman_id":"51b8187a-66bb-407a-841c-b57da8893332"},{"name":"Получение списка прав, доступных организации","item":[{"name":"/api-portal/v4/permission/by-organization","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"e674fa28-3521-428c-a4b7-9fa9004524eb"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"1e3b124d-bb3a-43e2-a5ff-1972673d356d"}}],"id":"5409736f-acb3-48b9-b2fa-ac4b32b96a49","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

Назначение метода

Предоставить весь список прав организации.

\n","urlObject":{"protocol":"https","path":["api-portal","v4","permission","by-organization"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"f9d60f71-e9a0-444e-9a1f-2603c08eecca","name":"Успешное получение прав организации","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/permission/by-organization"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 06:49:33 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"Data\": [\n {\n \"Code\": 0, // Код пользовательского права {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameRu\": \"Доступ к продажам\", // Наименование пользовательского права на Русском языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameKz\": \"Сатуға рұқсат\", // Наименование пользовательского права на Казахском языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameEn\": \"Access to sales\" // Наименование пользовательского права на Английском языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n {\n \"Code\": 1,\n \"NameRu\": \"Доступ к покупкам\",\n \"NameKz\": \"Сатып алуға рұқсат\",\n \"NameEn\": \"Access to purchases\"\n },\n {\n \"Code\": 2,\n \"NameRu\": \"Доступ к возвратам Продажи\",\n \"NameKz\": \"Сатуды қайтаруға рұқсат\",\n \"NameEn\": \"Access to sales returns\"\n },\n {\n \"Code\": 3,\n \"NameRu\": \"Доступ к внесению наличности\",\n \"NameKz\": \"Қолма-қол ақшаны енгізуге рұқсат\",\n \"NameEn\": \"Access to cash inflows\"\n },\n {\n \"Code\": 4,\n \"NameRu\": \"Доступ к изъятию наличности\",\n \"NameKz\": \"Қолма-қол ақшаны алуға рұқсат\",\n \"NameEn\": \"Access to cash withdrawal\"\n },\n {\n \"Code\": 5,\n \"NameRu\": \"Доступ к закрытию смены (Z-отчеты)\",\n \"NameKz\": \"Ауысымды жабуға рұқсат (Z-есептер)\",\n \"NameEn\": \"Access to shift closing (Z-reports)\"\n },\n {\n \"Code\": 6,\n \"NameRu\": \"Доступ к формированию X-отчетов\",\n \"NameKz\": \"X-есептерді қалыптастыруға рұқсат\",\n \"NameEn\": \"Access to the formation of X-reports\"\n },\n {\n \"Code\": 7,\n \"NameRu\": \"Доступ к просмотру X,Z-отчетов\",\n \"NameKz\": \"X, Z есептерін қарауға рұқсат\",\n \"NameEn\": \"Access to viewing X,Z-reports\"\n },\n {\n \"Code\": 8,\n \"NameRu\": \"Доступ к режиму программирования\",\n \"NameKz\": \"Бағдарламалау режиміне рұқсат\",\n \"NameEn\": \"Access to the programming mode\"\n },\n {\n \"Code\": 9,\n \"NameRu\": \"Доступ к редактированию сотрудников\",\n \"NameKz\": \"Қызметкерлерді өңдеуге рұқсат\",\n \"NameEn\": \"Access to editing staff\"\n },\n {\n \"Code\": 13,\n \"NameRu\": \"Просмотр истории чеков\",\n \"NameKz\": \"Чектердің тарихын қарау\",\n \"NameEn\": \"View the history of receipt\"\n },\n {\n \"Code\": 28,\n \"NameRu\": \"Просмотр организаций\",\n \"NameKz\": \"Ұйымдарды қарау\",\n \"NameEn\": \"View of organizations\"\n },\n {\n \"Code\": 29,\n \"NameRu\": \"Управление доверенными организациями\",\n \"NameKz\": \"Сенімді ұйымдарды басқару\",\n \"NameEn\": \"Managing of trusted organizations\"\n },\n {\n \"Code\": 59,\n \"NameRu\": \"Акцизы. Просмотр истории проверок\",\n \"NameKz\": \"Акциздер. Тексерулер тарихын қарау\",\n \"NameEn\": \"Excise. View of excise check history\"\n },\n {\n \"Code\": 62,\n \"NameRu\": \"Доступ к возвратам Покупки\",\n \"NameKz\": \"Сатып алуды қайтаруға рұқсат\",\n \"NameEn\": \"Access to Purchase Refunds\"\n },\n {\n \"Code\": 86,\n \"NameRu\": \"Акцизы. Настройки\",\n \"NameKz\": \"Акциздер. Баптаулар\",\n \"NameEn\": \"Excise. Settings\"\n },\n {\n \"Code\": 51,\n \"NameRu\": \"Модуль Аналитика. Мониторинг касс\",\n \"NameKz\": \"Аналитика Модулі. Кассалар мониторингі\",\n \"NameEn\": \"The Analytics module. Cashboxes monitoring\"\n },\n {\n \"Code\": 106,\n \"NameRu\": \"Кабинет Интегратора\",\n \"NameKz\": \"Интегратор кабинеті\",\n \"NameEn\": \"Integrator's cabinet\"\n }\n ]\n}"}],"_postman_id":"5409736f-acb3-48b9-b2fa-ac4b32b96a49"}],"id":"f54b1ebf-e799-4d3c-88f9-2ea01c320a18","description":"

Права организаций

В системе Webkassa каждая организация может иметь набор прав, определяющих, какие действия и функции ей доступны.

Разделение прав необходимо для:

разграничения доступа к кассовым операциям и административным функциям;
обеспечения безопасности и контроля за выполнением операций;
точной настройки ролей и ответственности сотрудников организации.

Права действуют на уровне организации и отдельных касс, позволяя гибко управлять доступом и ограничивать возможности в зависимости от роли или задач пользователя.

\n","_postman_id":"f54b1ebf-e799-4d3c-88f9-2ea01c320a18"}],"id":"2e7321ea-710c-4b47-a64a-eb0a739a496a","description":"

Организация — это юридическое лицо или ИП клиента в системе Webkassa. Она создаётся при регистрации и содержит основные юридические данные (БИН, наименование, адрес и т.д.).

\n","_postman_id":"2e7321ea-710c-4b47-a64a-eb0a739a496a"},{"name":"Пользователи","item":[{"name":"Регистрация пользователя","item":[{"name":"/api-portal/v4/employee/create","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"ac6be87e-95d2-4d6f-addb-1ab469f25251"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"676cf5c1-7fab-4822-b7f0-3dfa9ab830a9"}}],"id":"329329b5-be89-4b82-adb8-bbdc3fec4b1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // Токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Сидоров М.Н.\", // Полное имя пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77022443322\", // Номер телефона в формате +77XXXXXXXXX {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"tes001@webkassa.kz\", // Используется в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"Asdzxc1ru\", // Пароль. Требования описаны в разделе \"Регистрация пользователя\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100000, // Максимальная сумма чека, доступная пользователю {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": false, // Признак контактного лица организации (допускается только одно контактное лицо) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // Признак установки всех прав, доступных организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 5\r\n ], // Список кодов прав пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Cashboxes\": [\r\n // Список заводских (серийных) номеров касс, к которым предоставляется доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/create","description":"

Назначение метода

Зарегистрировать нового пользователя в организации

\n","urlObject":{"protocol":"https","path":["api-portal","v4","employee","create"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"4ea336b0-4e37-4fc8-9f78-5ea7d5553bd8","name":"Успешная регистрация","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // Токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Сидоров М.Н.\", // Полное имя пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77022443322\", // Номер телефона в формате +77XXXXXXXXX {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"tes001@webkassa.kz\", // Используется в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"Asdzxc1ru\", // Пароль. Требования описаны в разделе \"Регистрация пользователя\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100000, // Максимальная сумма чека, доступная пользователю {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": false, // Признак контактного лица организации (допускается только одно контактное лицо) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // Признак установки всех прав, доступных организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 5\r\n ], // Список кодов прав пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Cashboxes\": [\r\n // Список заводских (серийных) номеров касс, к которым предоставляется доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 11:45:31 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"13"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": true\n}"},{"id":"f70addf8-4405-4586-bd81-1a1122adc0be","name":"Пароль не соответствует требованиям","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // Токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Сидоров М.Н.\", // Полное имя пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77022443322\", // Номер телефона в формате +77XXXXXXXXX {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"tes001@webkassa.kz\", // Используется в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"Asdzxcru\", // Пароль. Требования описаны в разделе \"Регистрация пользователя\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100000, // Максимальная сумма чека, доступная пользователю {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": false, // Признак контактного лица организации (допускается только одно контактное лицо) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // Признак установки всех прав, доступных организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 5\r\n ], // Список кодов прав пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Cashboxes\": [\r\n // Список заводских (серийных) номеров касс, к которым предоставляется доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 11:44:25 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"Пароль не соответствует требованиям информационной безопасности.\"\n }\n ]\n}"},{"id":"75041b6d-d9c6-440f-960a-1a027553f022","name":"Ошибка: дублирование email сотрудника","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // Токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Сидоров М.Н.\", // Полное имя пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77022443322\", // Номер телефона в формате +77XXXXXXXXX {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"tes001@webkassa.kz\", // Используется в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"Asdzxc1ru\", // Пароль. Требования описаны в разделе \"Регистрация пользователя\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100000, // Максимальная сумма чека, доступная пользователю {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": false, // Признак контактного лица организации (допускается только одно контактное лицо) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // Признак установки всех прав, доступных организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 5\r\n ], // Список кодов прав пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Cashboxes\": [\r\n // Список заводских (серийных) номеров касс, к которым предоставляется доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 11:49:19 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"В системе уже зарегистрирован сотрудник с данным Email\"\n }\n ]\n}"},{"id":"87c7eec2-a943-42bc-bbad-7b12621cad83","name":"Ошибка: недоступные права органзации","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // Токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Сидоров М.Н.\", // Полное имя пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77022443322\", // Номер телефона в формате +77XXXXXXXXX {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"tes001@webkassa.kz\", // Используется в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Password\": \"Asdzxc1ru\", // Пароль. Требования описаны в разделе \"Регистрация пользователя\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100000, // Максимальная сумма чека, доступная пользователю {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": false, // Признак контактного лица организации (допускается только одно контактное лицо) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // Признак установки всех прав, доступных организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3,\r\n 4,\r\n 774\r\n ], // Список кодов прав пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Cashboxes\": [\r\n // Список заводских (серийных) номеров касс, к которым предоставляется доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 11:57:36 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"Права с кодом 774 не доступны\"\n }\n ]\n}"}],"_postman_id":"329329b5-be89-4b82-adb8-bbdc3fec4b1f"}],"id":"fc463f04-f0aa-4fca-b8c2-891c7fc53c25","description":"

Регистрация пользователя позволяет организации создавать новых пользователей для работы в системе Webkassa.

Пользователи выполняют роль кассиров. Кассир — это роль пользователя, которая используется для управления доступом к кассам.

Управление доступом кассиров к кассе доступен в UI Webkassa.

Требования к паролю

минимальная длина: 8 символов
используются латинские буквы (A–Z, a–z)
пароль должен содержать минимум:
- 1 заглавную букву
- 1 строчную букву
- 1 цифру
- 1 специальный символ
\n

Назначения прав пользователю

Права пользователя задаются комбинированием двух параметров - SetAllPermissions и Permissions

SetAllPermissions - Признак установки всех прав, доступных организации. Принимает значение true или false. При попытке передать права, отсутствующие у организации - вернется ошбика.
Permissions - перечень прав пользователя в виде кодов от 0 до 5. Список прав можно посмотреть в разделе \"Получение списка прав, доступных организации\"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

SetAllPermissions	Permissions	Результат
true	null	Пользователь создаётся со всеми правами, доступными организации
false	null	Пользователь создаётся без прав
true	не null	Возвращается ошибка
false	не null	Пользователь создаётся с указанными правами

Например:\nSetAllPermissions=true \"Permissions\": [ 0, 1, 2]

\n","_postman_id":"fc463f04-f0aa-4fca-b8c2-891c7fc53c25"},{"name":"Получение информации о пользователе","item":[{"name":"/api/v4/Employee/Information","id":"111a69d3-9a9e-4363-8d5d-64d427e179e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n//В параметре \"Xin\" укажите реальный ИИН/БИН\r\n\r\n{\r\n \"Token\": \"\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Employee/Information","description":"

Назначение метода

Получить информацию о зарегистрированном пользователе

\n","urlObject":{"protocol":"https","path":["api","v4","Employee","Information"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"3d1fe28c-71e7-4d1b-88a8-87080f151c05","name":"Информация получена","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n//В параметре \"Xin\" укажите реальный ИИН/БИН\r\n\r\n{\r\n \"Token\": \"\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Employee/Information"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Mon, 02 Feb 2026 06:15:28 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"-1"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"Data\": {\n \"FullName\": \"Известная Личность\",// Полное наименование клиента {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OrganizationXin\": \"\",// ИИН/БИН организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OrganizationFullName\": \"asdasd\", //Полное наименование организации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"OrganizationAddressText\": \"Акмолинская область, г.Кокшетау, ул. Абылай хана, д. 11\",//Адрес регистрации клиента {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATPayer\": true,//Признак плательщика НДС {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATSeries\": \"12333\", // Серия свидетельства НДС (содержится в ответе только, если VATPayer=true и VATSeries ранее был указан в профиле организации) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"VATNumber\": \"1234787\" // Номер свидетельства НДС (содержится в ответе только, если VATPayer=true и VATNumber ранее был указан в профиле организации ) {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n}"}],"_postman_id":"111a69d3-9a9e-4363-8d5d-64d427e179e6"}],"id":"ca7dfb18-d537-425d-b681-aec5113a46eb","_postman_id":"ca7dfb18-d537-425d-b681-aec5113a46eb","description":""},{"name":"Обновление данных пользователя","item":[{"name":"/api-portal/v4/employee/edit","id":"7d2b77be-efa6-4b67-ab7a-fb61cd642816","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"2@webkassa.kz\", // укажите в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Абрикосов А. А.\", // укажите ФИО пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100500, // укажите максимальную сумму чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77077543322\", // укажите номер телефона {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": true, // укажите, если является контактным лицом {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // укажите, чтобы установить все права организации, для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [ // укажите, права достпуные для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n 0,\r\n 1,\r\n 2,\r\n 3\r\n ],\r\n \"Cashboxes\": [ // укажите ЗНК (заводской номер кассы), к которым пользователь имеет доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} \r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/edit","description":"

Назначение метода

Обновить данные пользователя

\n","urlObject":{"protocol":"https","path":["api-portal","v4","employee","edit"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"ea292f34-d9df-47ce-b5c5-5adc86422c7d","name":"Пользователь изменен успешно","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"2@webkassa.kz\", // укажите в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Абрикосов А. А.\", // укажите ФИО пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100500, // укажите максимальную сумму чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77077543322\", // укажите номер телефона {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": true, // укажите, если является контактным лицом {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // укажите, чтобы установить все права организации, для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [ // укажите, права достпуные для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n 3\r\n ],\r\n \"Cashboxes\": [ // укажите ЗНК (заводской номер кассы), к которым пользователь имеет доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} \r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/edit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 22 Jan 2026 12:47:31 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"13"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": true // Данные пользователя обновлены успешно\n}"},{"id":"18fb58bb-491b-4e43-aee1-a91ec03cc5df","name":"Ошибка: неверный код права","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"2@webkassa.kz\", // укажите в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Абрикосов А. А.\", // укажите ФИО пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100500, // укажите максимальную сумму чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77077543322\", // укажите номер телефона {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": true, // укажите, если является контактным лицом {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": false, // укажите, чтобы установить все права организации, для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [ // укажите, права достпуные для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n 333\r\n ],\r\n \"Cashboxes\": [ // укажите ЗНК (заводской номер кассы), к которым пользователь имеет доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} \r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/edit"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 22 Jan 2026 12:49:19 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"Права с кодом 333 не доступны\"\n }\n ]\n}"},{"id":"b97ef502-9f0a-4b3b-a714-4c7dc6a0491f","name":"Ошибка: неверные права пользователя","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"2@webkassa.kz\", // укажите в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"FullName\": \"Абрикосов А. А.\", // укажите ФИО пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"MaxCheckAmount\": 100500, // укажите максимальную сумму чека {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PhoneNumber\": \"+77077543322\", // укажите номер телефона {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"IsContactPerson\": true, // укажите, если является контактным лицом {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"SetAllPermissions\": true, // укажите, чтобы установить все права организации, для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Permissions\": [ // укажите, права достпуные для пользователя {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n 0,\r\n 1,\r\n 2,\r\n 3\r\n ],\r\n \"Cashboxes\": [ // укажите ЗНК (заводской номер кассы), к которым пользователь имеет доступ {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР} \r\n \"<Заводской номер кассы>\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/v4/employee/edit"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Thu, 22 Jan 2026 12:50:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"Невозможно указать права\"\n }\n ]\n}"}],"_postman_id":"7d2b77be-efa6-4b67-ab7a-fb61cd642816"}],"id":"48931c5c-b846-46d3-b5dc-eb374d38d80a","_postman_id":"48931c5c-b846-46d3-b5dc-eb374d38d80a","description":""},{"name":"Удаление пользователя","item":[{"name":"/api-portal/v4/employee/remove","id":"77fdfde8-2825-4cb8-8ad1-57f342b76821","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"email@email.kz\" // укажите в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/employee/remove","description":"

Назначение метода

Удалить пользователя организации

\n","urlObject":{"protocol":"https","path":["api-portal","employee","remove"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"80a831d6-f084-4712-a2d6-d67322ddbb88","name":"Пользователь успешно удален","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"email@email.kz\" // укажите в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/employee/remove"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 23 Jan 2026 03:03:43 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"13"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": true //Пользователь удален успешно\n}"},{"id":"298a51a7-2320-4b69-bf54-c656d8155684","name":"Ошибка: некорректный email","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Email\": \"@email@email.kz\" // укажите в качестве логина {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api-portal/employee/remove"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 23 Jan 2026 03:06:29 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"Поле не является корректным email адресом\"\n }\n ]\n}"}],"_postman_id":"77fdfde8-2825-4cb8-8ad1-57f342b76821"}],"id":"b96d2986-2d1d-4b28-a4bd-6d218308edb6","_postman_id":"b96d2986-2d1d-4b28-a4bd-6d218308edb6","description":""},{"name":"Получение списка касс пользователя","item":[{"name":"/api/v4/Cashboxes","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"0b873cb0-b782-4539-8383-217cbb1063ed"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"e87b494a-899d-465c-a10e-ae2451e6622d"}}],"id":"2a13aaae-6a7a-400e-8173-9415e37d0ba7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashboxes","description":"

Назначение метода

Предоставить сторонней системе список касс, доступных пользователю.

\n","urlObject":{"protocol":"https","path":["api","v4","Cashboxes"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"e14646b3-15ec-4b14-b17e-434f3127bd3b","name":"Получения списка касс","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"c473991fa60d41749492704309d3c8d4\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashboxes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 09:14:28 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"-1"},{"key":"Set-Cookie","value":"webcash-lang=ru-RU; expires=Thu, 14-Jan-2027 09:14:16 GMT; path=/; secure"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": {\n \"List\": [\n {\n \"UniqueNumber\": \"SWK00033629\", // Заводской номер кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"RegistrationNumber\": \"233915283751\", // Регистрационный номер из органов гос.доходов {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"IdentificationNumber\": \"353748\", // Идентификационный номер ОФД\n \"Name\": \"kassa\", // Наименование кассы {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"Description\": \"\", // Внутреннее описание кассы\n \"IsOffline\": false, // Признак автономного режима (True – если касса находится в автономном режиме) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"CurrentStatus\": 1, // Текущий статус кассы (0 - создана, 1 - активна, 2 - заблокирована ОФД, 4 - нарушена целостность данных, 5 - снята с учета)\n \"Shift\": 14 // Текущая/последняя смена в кассе {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n }\n ]\n }\n}"},{"id":"7e2eb967-fe84-465c-b529-86aa51ad6bcc","name":"Ошибка токена","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"c473991fa60d41749492704309d3c8d\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}\r\n\r\n\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/Cashboxes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 14 Jan 2026 09:16:49 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"-1"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 2,\n \"Text\": \"Срок действия сессии истек\"\n }\n ]\n}"}],"_postman_id":"2a13aaae-6a7a-400e-8173-9415e37d0ba7"}],"id":"1ec9b402-a225-4f97-938a-39cd6a0499a2","_postman_id":"1ec9b402-a225-4f97-938a-39cd6a0499a2","description":""}],"id":"2a26547b-2391-46a2-92c9-83bc18b861f6","description":"

Пользователь — это учётная запись для входа в систему Webkassa.

Пользователь создаётся внутри организации и используется для работы с кассами, настройками и отчётами в рамках прав доступа.

\n","_postman_id":"2a26547b-2391-46a2-92c9-83bc18b861f6"},{"name":"Справочники","item":[{"name":"Справочник \"Единицы измерения\"","item":[{"name":"/api/v4/references/RefUnits","id":"c6a0af96-e739-47e1-b0df-44b74ddd796b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

Назначение метода

Предоставить перечень всех единиц измерения из базы данных

\n","urlObject":{"protocol":"https","path":["api","v4","references","RefUnits"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"d5393bfc-2e11-44a1-8b3a-c54da6b39a93","name":"Данные успешно получены","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\" // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/v4/references/RefUnits"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Fri, 16 Jan 2026 06:41:41 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"-1"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": [\n {\n \"Code\": 796, // Код {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameRu\": \"шт\", // Наименование на русском {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameEn\": \"PC\", // Наименование на английском {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n \"NameKz\": \"дана\" // Наименование на государственном языке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\n },\n {\n \"Code\": 166,\n \"NameRu\": \"кг\",\n \"NameEn\": \"kg\",\n \"NameKz\": \"кг\"\n },\n {\n \"Code\": 112,\n \"NameRu\": \"литр\",\n \"NameEn\": \"liter\",\n \"NameKz\": \"литр\"\n },\n {\n \"Code\": 6,\n \"NameRu\": \"м\",\n \"NameEn\": \"m\",\n \"NameKz\": \"м\"\n },\n {\n \"Code\": 55,\n \"NameRu\": \"м2\",\n \"NameEn\": \"m2\",\n \"NameKz\": \"м2\"\n },\n {\n \"Code\": 113,\n \"NameRu\": \"м3\",\n \"NameEn\": \"m3\",\n \"NameKz\": \"м3\"\n },\n {\n \"Code\": 18,\n \"NameRu\": \"м.пог.\",\n \"NameEn\": \"m.lin\",\n \"NameKz\": \"м.пог.\"\n },\n {\n \"Code\": 168,\n \"NameRu\": \"тонн.\",\n \"NameEn\": \"tons.\",\n \"NameKz\": \"тонн.\"\n },\n {\n \"Code\": 778,\n \"NameRu\": \"упак.\",\n \"NameEn\": \"pack\",\n \"NameKz\": \"орама\"\n },\n {\n \"Code\": 5114,\n \"NameRu\": \"одн.усл.\",\n \"NameEn\": \"one\",\n \"NameKz\": \"бір қызмет\"\n },\n {\n \"Code\": 356,\n \"NameRu\": \"час\",\n \"NameEn\": \"hour\",\n \"NameKz\": \"сағат\"\n },\n {\n \"Code\": 792,\n \"NameRu\": \"чел.\",\n \"NameEn\": \"people\",\n \"NameKz\": \"адам\"\n },\n {\n \"Code\": 5111,\n \"NameRu\": \"одн.пач\",\n \"NameEn\": \"one pack\",\n \"NameKz\": \"бір бума\"\n },\n {\n \"Code\": 111,\n \"NameRu\": \"Миллилитр ( куб.см.)\",\n \"NameEn\": \"Миллилитр ( куб.см.)\",\n \"NameKz\": \"Миллилитр ( куб.см.)\"\n },\n {\n \"Code\": 736,\n \"NameRu\": \"рулон\",\n \"NameEn\": \"roll\",\n \"NameKz\": \"орам\"\n },\n {\n \"Code\": 625,\n \"NameRu\": \"лист\",\n \"NameEn\": \"sheet\",\n \"NameKz\": \"парақ\"\n },\n {\n \"Code\": 839,\n \"NameRu\": \"комплект\",\n \"NameEn\": \"kit\",\n \"NameKz\": \"жиынтық\"\n },\n {\n \"Code\": 8,\n \"NameRu\": \"км.\",\n \"NameEn\": \"km\",\n \"NameKz\": \"км.\"\n },\n {\n \"Code\": 163,\n \"NameRu\": \"г.\",\n \"NameEn\": \"g.\",\n \"NameKz\": \"г.\"\n },\n {\n \"Code\": 51,\n \"NameRu\": \"см2\",\n \"NameEn\": \"sm2\",\n \"NameKz\": \"см2\"\n },\n {\n \"Code\": 359,\n \"NameRu\": \"Сутки\",\n \"NameEn\": \"Day\",\n \"NameKz\": \"Тәулік\"\n },\n {\n \"Code\": 362,\n \"NameRu\": \"Месяц\",\n \"NameEn\": \"Month\",\n \"NameKz\": \"Ай\"\n },\n {\n \"Code\": 868,\n \"NameRu\": \"Бутылка\",\n \"NameEn\": \"Bottle\",\n \"NameKz\": \"Бөтелке\"\n },\n {\n \"Code\": 872,\n \"NameRu\": \"Флакон\",\n \"NameEn\": \"Флакон\",\n \"NameKz\": \"Шиша\"\n },\n {\n \"Code\": 2,\n \"NameRu\": \"Микрометр\",\n \"NameEn\": \"Микрометр\",\n \"NameKz\": \"Микрометр\"\n },\n {\n \"Code\": 881,\n \"NameRu\": \"Банка условная\",\n \"NameEn\": \"Банка условная\",\n \"NameKz\": \"Шартты банка\"\n },\n {\n \"Code\": 123,\n \"NameRu\": \"Метр кубический условный\",\n \"NameEn\": \"Метр кубический условный\",\n \"NameKz\": \"Шартты кубтық метр\"\n },\n {\n \"Code\": 383,\n \"NameRu\": \"рубль российский\",\n \"NameEn\": \"рубль российский\",\n \"NameKz\": \"ресей рублі\"\n },\n {\n \"Code\": 4,\n \"NameRu\": \"сантиметр\",\n \"NameEn\": \"сантиметр\",\n \"NameKz\": \"сантиметр\"\n },\n {\n \"Code\": 841,\n \"NameRu\": \"килограмм пероксида водорода\",\n \"NameEn\": \"килограмм пероксида водорода\",\n \"NameKz\": \"сутегі тотығының килограмы\"\n },\n {\n \"Code\": 812,\n \"NameRu\": \"ящик\",\n \"NameEn\": \"ящик\",\n \"NameKz\": \"жәшік\"\n },\n {\n \"Code\": 643,\n \"NameRu\": \"тысяча единиц\",\n \"NameEn\": \"тысяча единиц\",\n \"NameKz\": \"мың бірлік\"\n },\n {\n \"Code\": 110,\n \"NameRu\": \"миллиметр кубический\",\n \"NameEn\": \"миллиметр кубический\",\n \"NameKz\": \"кубтық миллиметр\"\n },\n {\n \"Code\": 245,\n \"NameRu\": \"Киловатт-час\",\n \"NameEn\": \"Киловатт-час\",\n \"NameKz\": \"Киловатт-сағат\"\n },\n {\n \"Code\": 206,\n \"NameRu\": \"Центнер\",\n \"NameEn\": \"Центнер\",\n \"NameKz\": \"Центнер\"\n },\n {\n \"Code\": 5110,\n \"NameRu\": \"Одно исследование\",\n \"NameEn\": \"Одно исследование\",\n \"NameKz\": \"Бір зерттеу\"\n },\n {\n \"Code\": 5113,\n \"NameRu\": \"Одна процедура\",\n \"NameEn\": \"Одна процедура\",\n \"NameKz\": \"Бір рәсім\"\n },\n {\n \"Code\": 5,\n \"NameRu\": \"Дециметр квадратный\",\n \"NameEn\": \"Дециметр квадратный\",\n \"NameKz\": \"Дециметр квадратный\"\n },\n {\n \"Code\": 53,\n \"NameRu\": \"Дециметр\",\n \"NameEn\": \"Дециметр\",\n \"NameKz\": \"Дециметр\"\n },\n {\n \"Code\": 715,\n \"NameRu\": \"пара\",\n \"NameEn\": \"couple\",\n \"NameKz\": \"жұп\"\n },\n {\n \"Code\": 797,\n \"NameRu\": \"100 шт\",\n \"NameEn\": \"hundred\",\n \"NameKz\": \"100 дана\"\n },\n {\n \"Code\": 122,\n \"NameRu\": \"Гектолитр\",\n \"NameEn\": \"Hectoliter\",\n \"NameKz\": \"Гектолитр\"\n },\n {\n \"Code\": 59,\n \"NameRu\": \"Гектар\",\n \"NameEn\": \"Гектар\",\n \"NameKz\": \"Гектар\"\n },\n {\n \"Code\": 469,\n \"NameRu\": \"Тенге казахский\",\n \"NameEn\": \"Тенге казахский\",\n \"NameKz\": \"Қазақ теңгесі\"\n },\n {\n \"Code\": 870,\n \"NameRu\": \"Ампула\",\n \"NameEn\": \"Ампула\",\n \"NameKz\": \"Ампула\"\n },\n {\n \"Code\": 8751,\n \"NameRu\": \"Қорап\",\n \"NameEn\": \"Коробка\",\n \"NameKz\": \"Коробка\"\n },\n {\n \"Code\": 876,\n \"NameRu\": \"Единица условная\",\n \"NameEn\": \"Единица условная\",\n \"NameKz\": \"Шартты бірлік\"\n },\n {\n \"Code\": 879,\n \"NameRu\": \"Штука условная\",\n \"NameEn\": \"Штука условная\",\n \"NameKz\": \"Шартты дана\"\n },\n {\n \"Code\": 704,\n \"NameRu\": \"Набор\",\n \"NameEn\": \"Набор\",\n \"NameKz\": \"Жиынтық\"\n },\n {\n \"Code\": 920,\n \"NameRu\": \"Лист печатный\",\n \"NameEn\": \"Printed sheet\",\n \"NameKz\": \"Баспа парағы\"\n },\n {\n \"Code\": 355,\n \"NameRu\": \"Минута\",\n \"NameEn\": \"Minute\",\n \"NameKz\": \"Минут\"\n },\n {\n \"Code\": 5208,\n \"NameRu\": \"Один день\",\n \"NameEn\": \"one day\",\n \"NameKz\": \"бір күн\"\n }\n ]\n}"}],"_postman_id":"c6a0af96-e739-47e1-b0df-44b74ddd796b"}],"id":"8ee544ac-29ab-404e-870f-9622a8e91141","description":"

Справочник «Единицы измерения»

Единицы измерения используются для указания единиц, в которых продается товар, выполняются работы или оказываются услуг в кассовых операциях. Для каждой кассы можно указать релевантные для нее единицы измерения

Назначение единиц измерения:

корректное формирование чека;
контроль и согласованность данных между кассой и системой;

\n","_postman_id":"8ee544ac-29ab-404e-870f-9622a8e91141"}],"id":"92abf7a8-6541-429d-beeb-365b6104264e","_postman_id":"92abf7a8-6541-429d-beeb-365b6104264e","description":""},{"name":"Курьеры","item":[{"name":"Формирование (загрузка) заказа для курьера","item":[{"name":"/api/v4/Courier/UploadExternalOrder","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"05f70a89-3056-4143-a538-b7fb0c097b01"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"375fa042-d7c6-4dfb-bf97-4e3942670497"}}],"id":"0c0c8ed4-68fb-4405-ad3a-3f87d8b16204","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"

Укажите ваш API KEY

\n","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OrderNumber\": \"123df\", // Номер заказа - должен быть уникальным в рамках организации. Если есть идентичный номер - возвращается ошибка. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 1, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 1000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Печенье\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796 // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }, \r\n {\r\n \"Count\": 10, \r\n \"Price\": 2000,\r\n \"TaxPercent\": 16, \r\n \"TaxType\": 100, \r\n \"PositionName\": \"Конфеты\", \r\n \"PositionCode\": \"2\", \r\n \"Discount\": 1000, \r\n \"Markup\": 0, \r\n \"SectionCode\": \"1\",\r\n \"UnitCode\": 796\r\n }\r\n ],\r\n \"CustomerEmail\": \"sdf@FD.wr\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77055806053\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/Courier/UploadExternalOrder","urlObject":{"protocol":"https","path":["api","Courier","UploadExternalOrder"],"host":["devkkm","webkassa","kz"],"query":[],"variable":[]}},"response":[{"id":"f3093fd1-fa8b-41d0-9607-c368b9103a37","name":"Формирование заказа","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OrderNumber\": \"123df\", // Номер заказа - должен быть уникальным в рамках организации. Если есть идентичный номер - возвращается ошибка. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 1, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 1000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Печенье\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796 // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }, \r\n {\r\n \"Count\": 10, \r\n \"Price\": 2000,\r\n \"TaxPercent\": 16, \r\n \"TaxType\": 100, \r\n \"PositionName\": \"Конфеты\", \r\n \"PositionCode\": \"2\", \r\n \"Discount\": 1000, \r\n \"Markup\": 0, \r\n \"SectionCode\": \"1\",\r\n \"UnitCode\": 796\r\n }\r\n ],\r\n \"CustomerEmail\": \"sdf@FD.wr\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77055806053\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/Courier/UploadExternalOrder"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 21 Jan 2026 09:49:59 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"13"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"Data\": true// Запрос выполнене успешно\n}"},{"id":"11422858-8343-4856-84de-93ab317f488f","name":"Ошибка: заказ уже существует","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","description":"Укажите ваш API KEY","type":"text"}],"body":{"mode":"raw","raw":"//ВАЖНО!! В \"Headers\" необходимо указать ваш API KEY\r\n\r\n{\r\n \"Token\": \"\", // укажите токен авторизации {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"OrderNumber\": \"123df\", // Номер заказа - должен быть уникальным в рамках организации. Если есть идентичный номер - возвращается ошибка. {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Positions\": [ // Позиция товара/услуги в чеке {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n {\r\n \"Count\": 1, // Количество {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"Price\": 1000, // Цена {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxPercent\": 16, // Налоговая ставка {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"TaxType\": 100, // Тип налога (0 - без налога, 100 - НДС) {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionName\": \"Печенье\", // Наименование позиции {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n \"PositionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код позиции \r\n \"Discount\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Скидка (в тенге)\r\n \"Markup\": 0, // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Наценка (в тенге)\r\n \"SectionCode\": \"1\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Код секции\r\n \"UnitCode\": 796 // Единица измерения. Можно посмотреть в запросе Справочник \"Единицы измерения\" {ОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}\r\n }, \r\n {\r\n \"Count\": 10, \r\n \"Price\": 2000,\r\n \"TaxPercent\": 16, \r\n \"TaxType\": 100, \r\n \"PositionName\": \"Конфеты\", \r\n \"PositionCode\": \"2\", \r\n \"Discount\": 1000, \r\n \"Markup\": 0, \r\n \"SectionCode\": \"1\",\r\n \"UnitCode\": 796\r\n }\r\n ],\r\n \"CustomerEmail\": \"sdf@FD.wr\", // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Email покупателя - при наличии электронного адреса покупателя Webkassa автоматически отправляет электронный чек покупателю\r\n \"CustomerPhone\": \"+77055806053\" // {НЕОБЯЗАТЕЛЬНЫЙ ПАРАМЕТР}. Телефон покупателя\r\n}","options":{"raw":{"language":"json"}}},"url":"https://devkkm.webkassa.kz/api/Courier/UploadExternalOrder"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Wed, 21 Jan 2026 09:51:56 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Errors\": [\n {\n \"Code\": 9,\n \"Text\": \"Номер заказа должен быть уникальным\"\n }\n ]\n}"}],"_postman_id":"0c0c8ed4-68fb-4405-ad3a-3f87d8b16204"}],"id":"58228bfb-2e47-44e8-a089-85a7d076d62f","description":"

Загрузка предоформленного заказа.

Данный метод позволяет загрузить в систему Webkassa предварительный заказ,
предназначенный для последующей фискализации через режим «Курьер»
в мобильном приложении.

\n","_postman_id":"58228bfb-2e47-44e8-a089-85a7d076d62f"},{"name":"Получение уведомления о фискализации","item":[],"id":"2ac4b93b-91a3-492b-8750-d9963251aa77","description":"

⚠️ Важно
Данный механизм не входит в Postman-коллекцию, так как реализуется\nна стороне интегратора.
Webkassa в этом сценарии выступает как отправитель уведомлений\n(callback / webhook).

Общая логика процесса получения уведомлений

Курьер фискализирует чек в мобильном приложении Webkassa.
\n
Webkassa формирует уведомление о фискализации.
\n
Уведомление отправляется на URL, указанный интегратором.
\n
Внешняя система принимает и обрабатывает данные.
\n
Возвращается результат обработки.
\n

Данные, передаваемые Webkassa

Данные, передаваемые Webkassa

Webkassa отправляет HTTP-запрос на указанный интегратором URL\nсо следующей структурой:

{\n    \"OrderNumber\": \"123456789-123\",\n    \"LoadDate\": \"25.02.2021 15:03\",\n    \"TicketNumber\": \"600277053957\",\n    \"TicketDateTime\": \"25.02.2021 18:29\",\n    \"CashboxUniqueNumber\": \"SWK00012397\",\n    \"Sum\": 19500,\n    \"ShiftNumber\": 3,\n    \"EmployeeName\": \"Иванов И.И.\"\n}\n\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Параметр	Комментарий
OrderNumber	Номер предоформленного заказа
LoadDate	Дата загрузки заказа в Webkassa
TicketNumber	Номер фискального чека
TicketDateTime	Дата и время фискализации
CashboxUniqueNumber	Заводской номер кассы (ЗНК)
Sum	Сумма чека
ShiftNumber	Номер кассовой смены
EmployeeName	ФИО курьера (кассира)

Успешная обработка

В случае успешного получения и обработки уведомления
внешняя система должна вернуть ответ:0

Ошибка обработки

Если:

возвращён любой ответ, отличный от 0, или
уведомление не было доставлено,\nWebkassa выполняет повторную отправку уведомления:
интервал между попытками: 12 часов
общее количество попыток (включая первую): 3\nПосле исчерпания количества попыток повторная отправка не выполняется.

\n","_postman_id":"2ac4b93b-91a3-492b-8750-d9963251aa77"}],"id":"7c7ae331-f49e-4b53-ba4a-c1175acb1a66","description":"

В Webkassa реализован сценарий курьерской доставки с фискализацией чека\nнепосредственно курьером через мобильное приложение Webkassa.

Процесс разделён на два этапа:

Оформление заказа
\n
- заказ формируется менеджером или во внешней системе;
- указывается состав товаров, суммы и параметры будущего чека;
- заказ передаётся в Webkassa как предварительный (без фискализации).
\n
Исполнение заказа курьером
\n
- курьер работает в мобильном приложении Webkassa;
- вводит номер заказа;
- получает предоформленные данные заказа;
- принимает оплату от клиента;
- фискализирует чек.
\n

\n","_postman_id":"7c7ae331-f49e-4b53-ba4a-c1175acb1a66"},{"name":"Список кодов ошибок","item":[{"name":"Code -1: Неизвестная ошибка","id":"c40923bf-30a6-4cc7-8d0f-c3b2552358b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Рекомендация
Для устранения данной ошибки необходимо исходить из текста описания, который возвращается в ответ на запрос и при необходимости обратиться в службу технической поддержки.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"c40923bf-30a6-4cc7-8d0f-c3b2552358b7"},{"name":"Code 1: Неверный логин и/или пароль","id":"4f68f320-7066-48a2-b664-1913dfdb09ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае запроса авторизации с некорректными учетными данными.

Рекомендация
Для устранения ошибки необходимо отправить запрос авторизации с корректными учетными данными.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"4f68f320-7066-48a2-b664-1913dfdb09ba"},{"name":"Code 2: Срок действия сессии истек","id":"ba9aaa47-e79b-4eb1-ae25-9627c631731f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае истечения срока действия авторизации пользователя кассы в Webkassa.

Рекомендация
Для устранения ошибки необходимо вызвать метод авторизации пользователя, тем самым обновив токен сессии Webkassa (авторизационный токен).

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"ba9aaa47-e79b-4eb1-ae25-9627c631731f"},{"name":"Code 3: Пользователь не авторизован","id":"95b670a7-1504-4972-b3b7-ab89baf6c6ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

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

Рекомендация
Для устранения данной ошибки необходимо вызвать запрос на авторизацию пользователя, затем повторно отправить запрос, на который получена ошибка с кодом 3, используя токен, полученный при авторизации.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"95b670a7-1504-4972-b3b7-ab89baf6c6ca"},{"name":"Code 4: Нет доступа к операции","id":"7eb369ec-98f3-4de5-91cc-5f4a1a0be916","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае отсутствия прав на выполнение данной операции в кассе в системе Webkassa.

Рекомендация
Для устранения данной ошибки необходимо проверить наличие прав доступа у пользователя к операции, по которой отправляется запрос. Для повторного выполнения запроса необходимо выполнение одного из сценариев:

либо предоставить пользователю право к выполнению операции в Webkassa и повторить запрос;
либо использовать в запросе действительный токен сессии Webkassa другого пользователя, который имеет доступ к выполняемой операции.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"7eb369ec-98f3-4de5-91cc-5f4a1a0be916"},{"name":"Code 5: Нет доступа к кассе","id":"52a8692f-148c-4fc8-85ca-ad6a6df54624","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае отправки операции по кассе, к которой у пользователя нет доступа в системе Webkassa.

Рекомендация
Для устранения данной ошибки необходимо проверить доступ пользователя к кассе, по которой отправляется запрос.\nДля повторного выполнения запроса необходимо выполнение одного из сценариев:

либо предоставить пользователю доступ к кассе в Webkassa и повторить запрос;
либо использовать в запросе действительный токен сессии Webkassa другого пользователя, который имеет доступ к кассе.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"52a8692f-148c-4fc8-85ca-ad6a6df54624"},{"name":"Code 6: Касса не найдена","id":"e9c546f3-223f-4d98-b914-0f80b8798eb8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае, если был отправлен заводской номер кассы, незарегистрированной в Webkassa

Рекомендация
Для устранения данной ошибки необходимо в запросе использовать корректный заводской номер кассы.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"e9c546f3-223f-4d98-b914-0f80b8798eb8"},{"name":"Code 7: Касса заблокирована","id":"8afed2fe-3b9b-40ac-8e81-866fec11ee76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае получения от ОФД информации о блокировке

Рекомендация
Исправление ошибки не может быть проведено средствами API Webkassa.\nДля исправления ошибки необходимо проверить статус кассы в Webkassa и принять соответствующие действия:

Касса еще не подготовлена для работы (в Webkassa имеет статус «Создана»). Для исправления ошибки необходимо завершить процедуру по подготовке кассы к работе (ввод данных, полученных от органа государственных доходов).
Касса снята с учета в Webkassa. В данном случае использование данной кассы больше невозможно. Необходимо использовать другую кассу с другим заводским номером.
Касса заблокирована в Webkassa. Может возникать:
при снятии кассы с учета на сайте ОФД. В данном случае дальнейшее использование кассы невозможно. Необходимо использовать другую кассу с другим заводским номером.
при блокировке кассы по требованию органов государственных доходов на сайте ОФД. В данном случае использование кассы невозможно до момента разблокировки кассы органами налоговой службы.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"8afed2fe-3b9b-40ac-8e81-866fec11ee76"},{"name":"Code 8: Недостаточно средств для изъятия","id":"d6cd63a8-19b8-44f4-8cc9-b141bb612221","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при попытке изъятия большей суммы

Рекомендация
Для исправления ошибки необходимо:

либо изменить сумму в запросе до суммы, меньшей, чем сумма наличных в кассе на текущий момент. Отправить повторный запрос.
либо перед запросом изъятия провести операции, которые увеличивает наличные в кассе до необходимой суммы (операция внесения, операция продажи с наличным типом оплаты).

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"d6cd63a8-19b8-44f4-8cc9-b141bb612221"},{"name":"Code 9: Ошибка валидации данных","id":"206ea7ee-b4de-4fed-96fa-325fd7acd9a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае некорректных входных данных

Рекомендация
Для устранения данной ошибки необходимо ориентироваться на текстовое описание ошибки, которое возвращается в ответе на запрос. Ошибка может быть получена при неверном формате или неверных расчетах, передаваемых в теле запроса.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"206ea7ee-b4de-4fed-96fa-325fd7acd9a8"},{"name":"Code 10: Касса не активирована","id":"a887bbad-298f-4e9d-9713-35991f573f8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в случае отсутствия активационного пакета (лицензии) кассы

Рекомендация
Для устранения данной ошибки необходимо обратиться в Центр технического обслуживания (ЦТО), обслуживающее кассу. Устранение ошибки не может быть проведено средствами API Webkassa.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"a887bbad-298f-4e9d-9713-35991f573f8f"},{"name":"Code 11: Продолжительность смены превышает 24 часа","id":"8c4e31c8-f5e7-481f-9002-933f0c4c38b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при отправке операции после превышения допустимой длительности смены

Рекомендация
Для устранения данной ошибки необходимо отправить запрос на закрытие смены и получить положительный ответ. После этого можно повторить запрос, на который вернулась ошибка с данным кодом.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"8c4e31c8-f5e7-481f-9002-933f0c4c38b7"},{"name":"Code 12: Смена уже закрыта","id":"e331ba49-7cf7-4547-a4f1-314c0e254daa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Возвращается при попытке провести операцию, требующую открытой смены, в случае если последняя смена уже закрыта

Рекомендация
Данная ошибка возвращается, если повторно отправляется запрос на закрытие смены, которая уже закрыта.\nДля исправления ошибки повторно данный запрос не отправляется. По кассе могут выполняться другие операции.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"e331ba49-7cf7-4547-a4f1-314c0e254daa"},{"name":"Code 13: Не найдена открытая смена","id":"b90ca9be-2a41-47ad-b972-8f20f9d054e5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при попытке провести операцию, требующую открытой смены в случае отсутствия открытых смен

Рекомендация
Для исправления ошибки повторно данный запрос не отправляется.\nПо кассе могут выполняться другие операции.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"b90ca9be-2a41-47ad-b972-8f20f9d054e5"},{"name":"Code 14: Дублирующийся код системы-источника","id":"08509fb5-6a87-400d-b7b9-b8a8755dbd23","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается в качестве предупреждения, о том, что данный чек/информация уже был передан в систему Webkassa.

Рекомендация
Если в Webkassa в теле запроса передается новый чек, он может содержать уникальный код системы источника, где чек был сформирован.\nДля исправления ошибки необходимо:\n− если в теле запроса содержится новый чек, но получена данная ошибки, необходимо использовать другое значение, в поле ExternalCheckNumber в теле запроса.\n− если в теле запроса содержится чек, который уже был передан в Webkassa ранее, то при получении данной ошибки повторное выполнение запроса не требуется.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"08509fb5-6a87-400d-b7b9-b8a8755dbd23"},{"name":"Code 15: Смена не найдена","id":"ea4a269f-38d1-4c3d-9f93-622680b8c157","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при попытке запросить контрольную ленту по несуществующей смене в кассе.

Рекомендация
Для устранения данной ошибки необходимо в теле запроса использовать другое значение номера смены. Номер смены не должен быть больше, чем номер последней смены в кассе.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"ea4a269f-38d1-4c3d-9f93-622680b8c157"},{"name":"Code 16: Чек № NNN не зарегистрирован в рамках NN смены","id":"f135d616-a839-4a59-92f6-a5330c865117","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при попытке получить чек по его фискальному номеру (автономному коду), который не зарегистрирован в рамках определенной смены в кассе.

Рекомендация
Для устранения данной ошибки необходимо в теле запроса использовать другое значение номера чека.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"f135d616-a839-4a59-92f6-a5330c865117"},{"name":"Code 18: Продолжительность работы в автономном режиме превышена","id":"88d5c74d-5321-46a3-b0df-1c3a58e26055","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при попытке провести кассовую операцию при истечении максимального срока работы кассы в автономном режиме (72 часа без соединения с ОФД).

Рекомендация
Для устранения ошибки необходимо остановить отправку запросов по кассе. В случае получения данный ошибки необходимо проверить оплату в ОФД и наличие связи на точке использования кассы. Возобновление отправки запросов необходимо осуществить после того как будут оплачены услуги ОФД и налажено интернет-соединение.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"88d5c74d-5321-46a3-b0df-1c3a58e26055"},{"name":"Code 505: По данному доменному имени сервис временно недоступен","id":"fdb4582e-11b5-4f30-903e-61082d1f184d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при недоступности сервиса

Рекомендация
Для устранения данной ошибки необходимо получить от Webkassa альтернативное доменное имя и отправить повторный запрос на полученное альтернативное доменное имя, доступное в данный момент.

Получение альтернативного доменного имени

Альтернативное доменное имя можно получить по ключу AlternativeDomainNames, содержащемуся в Http Headers ответа на запрос, по которому возникла ошибка 505
Значения альтернативных имен хостов сервера Webkassa, доступных в данный момент, представлены строкой через запятую
Далее необходимо повторить запрос, изменив в URL запроса значение хоста на одно из полученных альтернативных имен, например:
- Основной хост, к которому идет запрос:
  https://mainhost.kz/api/SomeApiMethod
- В Response.HttpHeaders['AlternativeDomainNames'] содержится значение:
  \"alternativehost1.kz, alternativehost2.kz, alternativehostN.kz\"
- Повторный запрос необходимо отправить на URL:
  https://alternativehost1.kz/api/SomeApiMethod
- Если ответ не получен, отправляется повтор запроса на URL:
  https://alternativehost2.kz/api/SomeApiMethod
- Если ответ не получен, отправляется повтор запроса на URL:
  https://alternativehostN.kz/api/SomeApiMethod
\n

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"fdb4582e-11b5-4f30-903e-61082d1f184d"},{"name":"Code 1014: Данная смена открыта. Z-отчет отсутствует","id":"853bd9d2-5346-4bb1-8dc2-55858b1c0e46","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"INFO","header":[],"url":"","description":"

Комментарий
Ошибка возвращается при попытке получить Z-отчет по номеру смены, в случае, если смена еще открыта.

Рекомендация
Для устранения данной ошибки необходимо перепроверить и изменить даты, заданные в теле запроса. Дата начала запрашиваемого периода не может превышать дату окончания периода.

\n","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"853bd9d2-5346-4bb1-8dc2-55858b1c0e46"}],"id":"3930e1e5-78f7-40dc-aeea-f90be64d05e9","description":"

Code -1: Неизвестная ошибка
Code 1: Неверный логин и/или пароль
Code 2: Срок действия сессии истек
Code 3: Пользователь не авторизован
Code 4: Нет доступа к операции
Code 5: Нет доступа к кассе
Code 6: Касса не найдена
Code 7: Касса заблокирована
Code 8: Недостаточно средств для изъятия
Code 9: Ошибка валидации данных
Code 10: Касса не активирована
Code 11: Продолжительность смены превышает 24 часа
Code 12: Смена уже закрыта
Code 13: Не найдена открытая смена
Code 14: Дублирующийся код системы-источника
Code 15: Смена не найдена
Code 16: Чек № NNN не зарегистрирован в рамках NN смены
Code 18: Продолжительность работы в автономном режиме превышена
Code 505: По данному доменному имени сервис временно недоступен
Code 1014: Данная смена открыта. Z-отчет отсутствует

\n","_postman_id":"3930e1e5-78f7-40dc-aeea-f90be64d05e9"}],"variable":[{"key":"AUTHToken","value":""}]}