1. Общие сведения

  • Протоколы построены на транспорте HTTP, в архитектурном стиле REST.

  • В теле POST запросов и в ответах с сервера данные в формате JSON.

  • Необходимо соблюдать регистр в полях и параметрах отправляемых запросов.

1.1. Ограничение на получение данных по запросам

Методы возвращают данные только в случае наличия разрешения на получение данных по указанному ИНН и/или идентификатору торговой точки и/или регистрационному номеру кассы.

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

1.1.1. Основные права доступа

  • Выручка по сменам - доступны методы из п. 3,4,5,6,7 в полном объеме.

  • Данные по чекам - доступны методы из п. 3,4,5,6,7,9. При этом ответ метода из п. 9 не содержит информации по количеству товара, наименованию товара, коду маркированного товара, отраслевому реквизита предмета расчета

  • Данные по чекам, включая номенклатуру - доступны методы из п. 3,4,5,6,7,9 в полном объеме.

1.1.2. Дополнительные права доступа

  • Передавать ИНН кассира - если право отключено, то ответ метода из п. 9 не будет содержать имя и ИНН кассира.

  • Передавать данные об НДС - если право отключено, то ответы методов из п. 7 и п. 9 не будут содержать информацию об НДС.

  • Передавать данные покупателя - если право отключено, то ответ метода из п. 9 не будет содержать сведения о покупателе.

Методы из п. 10 и п. 11 недоступны в базовом пакете API для сверки. Доступ подключается отдельно (подробнее в примечаниях к методам).

1.2. Общие коды ответов

Исход Код Описания

Успех

200

ОК

Успех

201

Создано

Успех

204

Пусто

Ошибка

400

Неверные данные

Ошибка

401

Не авторизован

Ошибка

404

Не найдено

Ошибка

409

Конфликт

Системный отказ

500

Не найдено

Системный отказ

503

Сервер перегружен

1.3. Авторизация

Для доступа ко всем методам данного API необходимо получить JWT токен используя apiKey Это касается методов с версией v2 (api/rent/v2/…​)

К методам с версией v1 (api/rent/v1/…​) сохраняется доступ и apiKey, передается в каждом запросе в http-header. Пример: X-Api-Key =AIzaSyDRypemRP8Hr52kxIOVgZ-FRSYlA5pMj20

В будущем методы с версией v1 будут удалены

Чтобы получить ключ apiKey отправьте письмо с запросом по адресу info@1-ofd.ru. В теме письма укажите "Получение доступа к API для сверки" и наименование своей организации.

1.4. Типы данных

Все типы данных задаются строго в соответствии с форматом ответа JSON (смотри спецификацию по типам JSON - https://www.w3schools.com/js/js_json_datatypes.asp).

1.5. Дата и время

Глобальное (мировое) время - количество секунд (или миллисекунд) с начала эпохи (1970-01-01), так как она наступила в Гринвиче. Альтернативно может быть выражено в ГОСТ/ИСО формате с указанием зоны.

Если 1456789012000 трактуется глобальным временем - считаем его моментом времени 29 февраля 2016 г. 23:36:52 UTC. В Москве при этом было 1 марта 2016 г. 02:36:52 и если на сервере в Москве в этот глобальный момент произошло событие, то оно нам подходит.

Локальное время - количество секунд (или миллисекунд) с начала эпохи, так как она наступила в месте наступления интересующего нас события. Альтернативно может быть выражено в ГОСТ/ИСО без указания зоны.

Если 1456789012000 трактуется локальным временем - считаем его 29 февраля 2016 г. 23:36:52. Если на каком-то чеке написан тот же локальный момент времени, то он нам подходит.

1.6. Swagger

1.7. Скачать Pdf

2. Авторизация

POST /api/auth HTTP/1.1
Content-Type: application/json
Content-Length: 28
Host: universal-api-host

{
  "apiKey" : "qwerty123"
}

Response body

{
  "token" : "Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjg1LCJleHAiOjE3MzM5MTY4ODV9.JhhPmvLPxWI_YiL-CcNpjNE2MQrZzT5NTGbP41JemWf8rekkJe-lEVhztgv8YEBR5URliRA4Yd99UVVCHtQgXg"
}

Response fields

Path Type Description

token

String

Временный токен

Curl

$ curl 'https://universal-api-host/api/auth' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "apiKey" : "qwerty123"
}'

3. Получение списка организаций

GET /api/rent/v2/organisations HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjc4LCJleHAiOjE3MzM5MTM4Nzh9.5kKMGYzXFkc_1M7QUVNC94ngxodTl2ULyBTzyWyJ_K9ZbQ-mTcff8U2a7l-UG4khoW5NBhtvhGQCFFYW5WKNag
Host: universal-api-host

Response body

[ {
  "organisationKeyKind" : "INN.KPP",
  "organisationKey" : "123456789333.770201001",
  "startContractDate" : "2014-12-11T13:34:38.601",
  "endContractDate" : "2034-12-11T13:34:38.601"
} ]

Response fields

Path Type Description

[]organisationKeyKind

String

Тип ключа организации клиента

[]organisationKey

String

Значение ключа организации клиента

[]startContractDate

String

Начала периода передачи данных

[]endContractDate

String

Конец периода передачи данных

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjc4LCJleHAiOjE3MzM5MTM4Nzh9.5kKMGYzXFkc_1M7QUVNC94ngxodTl2ULyBTzyWyJ_K9ZbQ-mTcff8U2a7l-UG4khoW5NBhtvhGQCFFYW5WKNag'

4. Получение списка торговых точек

GET /api/rent/v2/organisations/123456789333/retailPlaces HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk4LCJleHAiOjE3MzM5MTM4OTh9.BABZZhZ45p8J9jIxZRicjAUUbF8JkE_3WxHnvSk0YtOjIKN8KR9Ir03ivKVy1J92k0K7S523NLGFiQvF6QHO_A
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/retailPlaces

Parameter Description

orgInn

ИНН организации

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Если пользователь выдал Разрешение не к торговой точке, а к кассе, то в ответе метода массив "retailPlaces" будет пустым

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "retailPlaces" : [ {
    "retailPlaceId" : 1,
    "address" : "Нижний Новгород, Покровская д. 52",
    "title" : "Торговая точка"
  } ]
}

Response fields

Path Type Description

inn

String

ИНН организации арендатора

kpp

String

КПП организации арендатора

retailPlaces[].retailPlaceId

Number

Идентификатор торговой точки

retailPlaces[].address

String

Адрес торговой точки

retailPlaces[].title

String

Название торговой точки

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/retailPlaces' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk4LCJleHAiOjE3MzM5MTM4OTh9.BABZZhZ45p8J9jIxZRicjAUUbF8JkE_3WxHnvSk0YtOjIKN8KR9Ir03ivKVy1J92k0K7S523NLGFiQvF6QHO_A'

5. Получение выручки по торговой точке

GET /api/rent/v2/organisations/123456789333/revenue?retailPlaces=1&dateFrom=2024-12-10T13:34:48.058&dateTo=2024-12-11T13:34:48.058 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjg4LCJleHAiOjE3MzM5MTM4ODh9.zuwr_uEe2UTkHd3IPwy8RFrYYC0Q-KpXeuSiExHXkcM0JvXX-Ovcoy5Babx2r1MENCk6CVMVshBRzx955XKXLw
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/revenue

Parameter Description

orgInn

ИНН организации арендатора

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Request parameters

Parameter Description

retailPlaces

Идентификаторы торговых точек

dateFrom

Начало периода, за который запрашиваются данные

dateTo

Окончание периода, за который запрашиваются данные

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "receipts" : [ {
    "retailPlaceId" : 1,
    "address" : "Нижний Новгород, Покровская д. 52",
    "title" : "Торговая точка",
    "revenue" : 99.7,
    "kkmRegIds" : [ "111112222233344" ]
  } ]
}

Response fields

Path Type Description

inn

String

ИНН организации арендатора

kpp

String

КПП организации арендатора

receipts[]

Array

Данные о торговой точке и выручке

receipts[].retailPlaceId

Number

Идентификатор торговой точки

receipts[].address

String

Адрес торговой точки

receipts[].title

String

Название точки продаж

receipts[].address

String

Адрес торговой точки

receipts[].revenue

Number

Сумма выручки

receipts[].kkmRegIds[]

Array

РНМ касс, учтенных в расчетах

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/revenue?retailPlaces=1&dateFrom=2024-12-10T13:34:48.058&dateTo=2024-12-11T13:34:48.058' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjg4LCJleHAiOjE3MzM5MTM4ODh9.zuwr_uEe2UTkHd3IPwy8RFrYYC0Q-KpXeuSiExHXkcM0JvXX-Ovcoy5Babx2r1MENCk6CVMVshBRzx955XKXLw'

6. Получение списка касс

GET /api/rent/v2/organisations/123456789333/kkms?retailPlaceId=1 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjgyLCJleHAiOjE3MzM5MTM4ODJ9.3moOCe_HqKInPavfhXCi9cQkwYRtYpC1PLgZaB9X2-DisbAcwYXbgXEcxEOKCHHpKM2nXAbS6i-eDqah1RryiQ
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/kkms

Parameter Description

orgInn

ИНН организации арендатора

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Request parameters

Parameter Description

retailPlaceId

Идентификатор торговой точки

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "kkms" : [ {
    "retailPlaceId" : 1,
    "address" : "Нижний Новгород, Покровская д. 52",
    "title" : "Торговая точка",
    "kkmRegId" : "111112222233344",
    "kkmFactoryNumber" : "96728465279",
    "fsFactoryNumber" : "123",
    "fiscalDrives" : [ {
      "fsFactoryNumber" : "123",
      "activationDate" : "2024-12-11T13:34:42.412",
      "expireDate" : "2024-12-11T13:34:42.412",
      "closeArchiveDate" : "2024-12-11T13:34:42.412"
    } ],
    "kkmInternalName" : "111112222233344",
    "kkmAddress" : "Нижний Новгород, Покровская, д.52"
  } ]
}

Параметры virtualKkmId и virtualKkmName возвращаются при условии, что в организации есть виртуальные кассы.

Response fields

Path Type Description

inn

String

ИНН организации арендатора

kpp

String

КПП организации арендатора

kkms[].retailPlaceId

Number

Идентификатор торговой точки

kkms[].address

String

Адрес торговой точки

kkms[].title

String

Название торговой точки

kkms[].kkmRegId

String

Регистрационный номер кассы

kkms[].kkmFactoryNumber

String

Заводской номер кассы

kkms[].fsFactoryNumber

String

Текущий заводской номер ФН

kkms[].fiscalDrives[]

Array

Список фискальных накопителей

kkms[].fiscalDrives[].fsFactoryNumber

String

Номер фискального накопителя

kkms[].fiscalDrives[].activationDate

String

Дата и время активации ФН

kkms[].fiscalDrives[].expireDate

String

Дата окончания ФН

kkms[].fiscalDrives[].closeArchiveDate

String

Дата закрытия архива ФН

kkms[].kkmInternalName

String

Название кассы

kkms[].kkmAddress

class java.lang.String

Адрес места установки кассы

kkms[].virtualKkmId

class java.lang.Integer

Ид виртуальной кассы

kkms[].virtualKkmName

class java.lang.String

Имя виртуальной кассы

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/kkms?retailPlaceId=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjgyLCJleHAiOjE3MzM5MTM4ODJ9.3moOCe_HqKInPavfhXCi9cQkwYRtYpC1PLgZaB9X2-DisbAcwYXbgXEcxEOKCHHpKM2nXAbS6i-eDqah1RryiQ'

7. Получение списка смен по кассе

GET /api/rent/v2/organisations/123456789333/shifts?regId=111112222233344&retailPlaceId=112&dateFrom=2024-12-10T13:34:56.374&dateTo=2024-12-11T13:34:56.374 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk2LCJleHAiOjE3MzM5MTM4OTZ9.lphJMHMLHiiIvRYKWmNzdAH_Tod75_Era_hkVTjW12ZLCj6S1XCmZrLYZYROeRg8M-vcohoa_pA07comP-2eUQ
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/shifts

Parameter Description

orgInn

ИНН организации арендатора

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Request parameters

Parameter Description

regId

Регистрационный номер кассы

retailPlaceId

Идентификатор торговой точки

dateFrom

Начало периода, за который запрашиваются данные

dateTo

Окончание периода, за который запрашиваются данные

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "organisationName" : "Тестовая Организация",
  "kkmShifts" : [ {
    "shiftNumber" : 1,
    "dateTimeOpen" : "2024-12-10T13:34:56.363+03:00",
    "dateTimeClose" : "2024-12-11T13:34:56.364+03:00",
    "incomeSum" : 2.5,
    "cashSum" : 0.5,
    "eCashSum" : 0.5,
    "returnOutcomeSum" : 0,
    "returnOutcomeCashSum" : 0,
    "returnOutcomeECashSum" : 0,
    "returnSum" : 0,
    "returnCashSum" : 0,
    "returnECashSum" : 0,
    "outcomeSum" : 0,
    "nds10" : 0,
    "nds20" : 0,
    "totalSumSellCorrection" : 0,
    "totalSumBuyCorrection" : 0,
    "kkmName" : "111112222233344",
    "kkmAddress" : "Нижний Новгород, Покровская, д.52",
    "kkmNumber" : "96728465279",
    "fsNumber" : "123",
    "kkmRegId" : "111112222233344",
    "kkmSalesPoint" : "Торговая точка",
    "shiftCounters" : {
      "quantity" : 12,
      "sellsCounters" : {
        "quantity" : 1,
        "cashSum" : 500.0,
        "ecashSum" : 500.0,
        "prepaymentSum" : 500.0,
        "postpaymentSum" : 500.0,
        "counterSubmissionSum" : 500.0,
        "resultSum" : 10000.0,
        "nds20" : 180.0,
        "nds10" : 100.0,
        "ndsCalculated20" : 180.0,
        "ndsCalculated10" : 100.0,
        "nds0" : 0.0,
        "ndsNo" : 456.78
      },
      "sellReturnsCounters" : {
        "quantity" : 1,
        "cashSum" : 500.0,
        "ecashSum" : 500.0,
        "prepaymentSum" : 500.0,
        "postpaymentSum" : 500.0,
        "counterSubmissionSum" : 500.0,
        "resultSum" : 10000.0,
        "nds20" : 180.0,
        "nds10" : 100.0,
        "ndsCalculated20" : 180.0,
        "ndsCalculated10" : 100.0,
        "nds0" : 0.0,
        "ndsNo" : 456.78
      },
      "buyesCounters" : {
        "quantity" : 1,
        "cashSum" : 500.0,
        "ecashSum" : 500.0,
        "prepaymentSum" : 500.0,
        "postpaymentSum" : 500.0,
        "counterSubmissionSum" : 500.0,
        "resultSum" : 10000.0,
        "nds20" : 180.0,
        "nds10" : 100.0,
        "ndsCalculated20" : 180.0,
        "ndsCalculated10" : 100.0,
        "nds0" : 0.0,
        "ndsNo" : 456.78
      },
      "buyReturnsCounters" : {
        "quantity" : 1,
        "cashSum" : 500.0,
        "ecashSum" : 500.0,
        "prepaymentSum" : 500.0,
        "postpaymentSum" : 500.0,
        "counterSubmissionSum" : 500.0,
        "resultSum" : 10000.0,
        "nds20" : 180.0,
        "nds10" : 100.0,
        "ndsCalculated20" : 180.0,
        "ndsCalculated10" : 100.0,
        "nds0" : 0.0,
        "ndsNo" : 456.78
      },
      "receiptCorrectionCounters" : {
        "quantity" : 2,
        "sellsCounters" : {
          "cashSum" : 5000.0,
          "ecashSum" : 6000.0,
          "prepaymentSum" : 1000.0,
          "postpaymentSum" : 1000.0,
          "counterSubmissionSum" : 600.0,
          "resultSum" : 1000.0,
          "quantity" : 3
        },
        "buyesCounters" : {
          "cashSum" : 5000.0,
          "ecashSum" : 6000.0,
          "prepaymentSum" : 1000.0,
          "postpaymentSum" : 1000.0,
          "counterSubmissionSum" : 600.0,
          "resultSum" : 1000.0,
          "quantity" : 3
        },
        "sellReturnsCounters" : {
          "cashSum" : 5000.0,
          "ecashSum" : 6000.0,
          "prepaymentSum" : 1000.0,
          "postpaymentSum" : 1000.0,
          "counterSubmissionSum" : 600.0,
          "resultSum" : 1000.0,
          "quantity" : 3
        },
        "buyReturnsCounters" : {
          "cashSum" : 5000.0,
          "ecashSum" : 6000.0,
          "prepaymentSum" : 1000.0,
          "postpaymentSum" : 1000.0,
          "counterSubmissionSum" : 600.0,
          "resultSum" : 1000.0,
          "quantity" : 3
        }
      }
    }
  } ]
}

Response fields

Path Type Description

inn

String

ИНН организации арендатора

kpp

String

КПП организации арендатора

organisationName

String

Полное наименование организации

kkmShifts[].shiftNumber

Number

Номер смены

kkmShifts[].dateTimeOpen

String

Время открытия смены

kkmShifts[].dateTimeClose

String

Время закрытия смены

kkmShifts[].incomeSum

Number

Итого приход за смену

kkmShifts[].cashSum

Number

Итого наличными за смену (приход)

kkmShifts[].eCashSum

Number

Итого безналичными за смену (приход)

kkmShifts[].returnCashSum

Number

Итого возвраты прихода наличными за смену

kkmShifts[].returnECashSum

Number

Итого возвраты прихода безналичными за смену

kkmShifts[].returnSum

Number

Итого возвраты прихода за смену

kkmShifts[].returnOutcomeSum

Number

Итого возвраты расходов наличными за смену

kkmShifts[].returnOutcomeCashSum

Number

Итого возвраты расходов наличными за смену (наличными + безналичными)

kkmShifts[].returnOutcomeECashSum

Number

Итого возвраты расходов наличными за смену (наличными + безналичными)

kkmShifts[].outcomeSum

Number

Итого расход за смену (наличными + безналичными)

kkmShifts[].nds10

Number

Итого НДС 10%

kkmShifts[].nds20

Number

Итого НДС 20%

kkmShifts[].totalSumSellCorrection

Number

Итого коррекция прихода

kkmShifts[].totalSumBuyCorrection

Number

Итого коррекция расхода

kkmShifts[].kkmName

String

Название кассы

kkmShifts[].kkmAddress

String

Адрес установки ККТ

kkmShifts[].kkmNumber

String

Заводской номер ККТ

kkmShifts[].fsNumber

String

Заводской номер ФН

kkmShifts[].kkmRegId

String

Регистрационный номер ККТ

kkmShifts[].kkmSalesPoint

String

Название точки продаж

kkmShifts[].shiftCounters

Object

Счетчики закрытия смены

kkmShifts[].shiftCounters.quantity

Number

количество чеков (БСО) и чеков коррекции (БСО) коррекции

kkmShifts[].shiftCounters.sellsCounters

Object

счетчики операций «приход»

kkmShifts[].shiftCounters.sellsCounters.quantity

Number

количество чеков (БСО) по признаку расчетов

kkmShifts[].shiftCounters.sellsCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.sellsCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.sellsCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.sellsCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.sellsCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.sellsCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.sellsCounters.nds20

Number

сумма НДС по ставке 20%

kkmShifts[].shiftCounters.sellsCounters.nds10

Number

сумма НДС по ставке 10%

kkmShifts[].shiftCounters.sellsCounters.ndsCalculated20

Number

сумма НДС по расч. ставке 20/120

kkmShifts[].shiftCounters.sellsCounters.ndsCalculated10

Number

сумма НДС по расч. ставке 10/110

kkmShifts[].shiftCounters.sellsCounters.nds0

Number

сумма расчетов с НДС по ставке 0%

kkmShifts[].shiftCounters.sellsCounters.ndsNo

Number

сумма расчетов без НДС

kkmShifts[].shiftCounters.sellReturnsCounters

Object

счетчики операций «возврат прихода»

kkmShifts[].shiftCounters.sellReturnsCounters.quantity

Number

количество чеков (БСО) по признаку расчетов

kkmShifts[].shiftCounters.sellReturnsCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.sellReturnsCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.sellReturnsCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.sellReturnsCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.sellReturnsCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.sellReturnsCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.sellReturnsCounters.nds20

Number

сумма НДС по ставке 20%

kkmShifts[].shiftCounters.sellReturnsCounters.nds10

Number

сумма НДС по ставке 10%

kkmShifts[].shiftCounters.sellReturnsCounters.ndsCalculated20

Number

сумма НДС по расч. ставке 20/120

kkmShifts[].shiftCounters.sellReturnsCounters.ndsCalculated10

Number

сумма НДС по расч. ставке 10/110

kkmShifts[].shiftCounters.sellReturnsCounters.nds0

Number

сумма расчетов с НДС по ставке 0%

kkmShifts[].shiftCounters.sellReturnsCounters.ndsNo

Number

сумма расчетов без НДС

kkmShifts[].shiftCounters.buyesCounters

Object

счетчики операций «расход»

kkmShifts[].shiftCounters.buyesCounters.quantity

Number

количество чеков (БСО) по признаку расчетов

kkmShifts[].shiftCounters.buyesCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.buyesCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.buyesCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.buyesCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.buyesCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.buyesCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.buyesCounters.nds20

Number

сумма НДС по ставке 20%

kkmShifts[].shiftCounters.buyesCounters.nds10

Number

сумма НДС по ставке 10%

kkmShifts[].shiftCounters.buyesCounters.ndsCalculated20

Number

сумма НДС по расч. ставке 20/120

kkmShifts[].shiftCounters.buyesCounters.ndsCalculated10

Number

сумма НДС по расч. ставке 10/110

kkmShifts[].shiftCounters.buyesCounters.nds0

Number

сумма расчетов с НДС по ставке 0%

kkmShifts[].shiftCounters.buyesCounters.ndsNo

Number

сумма расчетов без НДС

kkmShifts[].shiftCounters.buyReturnsCounters

Object

счетчики операций «возврат расхода»

kkmShifts[].shiftCounters.buyReturnsCounters.quantity

Number

количество чеков (БСО) по признаку расчетов

kkmShifts[].shiftCounters.buyReturnsCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.buyReturnsCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.buyReturnsCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.buyReturnsCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.buyReturnsCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.buyReturnsCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.buyReturnsCounters.nds20

Number

сумма НДС по ставке 20%

kkmShifts[].shiftCounters.buyReturnsCounters.nds10

Number

сумма НДС по ставке 10%

kkmShifts[].shiftCounters.buyReturnsCounters.ndsCalculated20

Number

сумма НДС по расч. ставке 20/120

kkmShifts[].shiftCounters.buyReturnsCounters.ndsCalculated10

Number

сумма НДС по расч. ставке 10/110

kkmShifts[].shiftCounters.buyReturnsCounters.nds0

Number

сумма расчетов с НДС по ставке 0%

kkmShifts[].shiftCounters.buyReturnsCounters.ndsNo

Number

сумма расчетов без НДС

kkmShifts[].shiftCounters.receiptCorrectionCounters

Object

счетчики операций по чекам коррекции

kkmShifts[].shiftCounters.receiptCorrectionCounters.quantity

Number

количество чеков коррекции (БСО коррекции) или непереданных чеков (БСО) и чеков коррекции (БСО коррекции)

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters

Object

счетчики по признаку «приход»

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellsCounters.quantity

Number

количество чеков (БСО) по признаку расчетов.

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters

Object

счетчики по признаку «расход»

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyesCounters.quantity

Number

количество чеков (БСО) по признаку расчетов.

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters

Object

счетчики по признаку «возврат прихода»

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.receiptCorrectionCounters.sellReturnsCounters.quantity

Number

количество чеков (БСО) по признаку расчетов.

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters

Object

счетчики по признаку «возврат расхода»

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters.cashSum

Number

итоговая сумма в чеках (БСО) наличными денежными средствами

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters.ecashSum

Number

итоговая сумма в чеках (БСО) безналичными

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters.prepaymentSum

Number

итоговая сумма в чеках (БСО) предоплатами (авансами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters.postpaymentSum

Number

итоговая сумма в чеках (БСО) постоплатами (кредитами)

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters.counterSubmissionSum

Number

итоговая сумма в чеках (БСО) встречными предоставлениями

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters.resultSum

Number

общая итоговая сумма в чеках (БСО)

kkmShifts[].shiftCounters.receiptCorrectionCounters.buyReturnsCounters.quantity

Number

количество чеков (БСО) по признаку расчетов.

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/shifts?regId=111112222233344&retailPlaceId=112&dateFrom=2024-12-10T13:34:56.374&dateTo=2024-12-11T13:34:56.374' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk2LCJleHAiOjE3MzM5MTM4OTZ9.lphJMHMLHiiIvRYKWmNzdAH_Tod75_Era_hkVTjW12ZLCj6S1XCmZrLYZYROeRg8M-vcohoa_pA07comP-2eUQ'

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

Метод позволяет получить по кассе список смен с итогами, которые сгруппированы по значениям дополнительного реквизита пользователя в чеках (тег 1086).

GET /api/rent/v2/organisations/123456789333/userPropertyShifts?regId=111112222233344&retailPlaceId=1&dateFrom=2024-12-10T13:34:57.037&dateTo=2024-12-11T13:34:57.037 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk3LCJleHAiOjE3MzM5MTM4OTd9.Tk9AkZgTqI9bYLH4RdivORQ2GyHyDlszT7KCuU1zhMwg7HO_wtYo3WXUuxscf-Dzr7wh4M7ODy0EA5EJXO_n3w
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/userPropertyShifts

Parameter Description

orgInn

ИНН организации арендатора

Request parameters

Parameter Description

regId

Регистрационный номер кассы

retailPlaceId

Идентификатор торговой точки

dateFrom

Начало периода, за который запрашиваются данные

dateTo

Окончание периода, за который запрашиваются данные

В одном запросе можно передать не более 30 касс.

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "organisationName" : "Тестовая Организация",
  "kkmShifts" : [ {
    "kkmRegId" : "111112222233344",
    "fsNumber" : "123",
    "kkmNumber" : "96728465279",
    "kkmName" : "111112222233344",
    "kkmAddress" : "Нижний Новгород, Покровская, д.52",
    "kkmSalesPoint" : "Торговая точка",
    "shiftNumber" : 101,
    "dateTimeOpen" : 1733826897035,
    "dateTimeClose" : 1733913297035,
    "userPropertyValue" : [ {
      "userPropertyValue" : "ДОСТАВКА",
      "totalSum" : 1000,
      "nds20" : 200,
      "nds10" : 100,
      "nds0" : 0,
      "ndsNo" : 700,
      "sellCount" : 1,
      "sellReturnCount" : 2,
      "sellReturnCashSum" : 50,
      "sellReturnEcashSum" : 100
    }, {
      "userPropertyValue" : "ДОСТАВКА ЮР.",
      "totalSum" : 1000,
      "nds20" : 200,
      "nds10" : 100,
      "nds0" : 0,
      "ndsNo" : 700,
      "sellCount" : 1,
      "sellReturnCount" : 2,
      "sellReturnCashSum" : 50,
      "sellReturnEcashSum" : 100
    } ]
  } ]
}

Response fields

Path Type Description

inn

String

ИНН организации арендатора

kpp

String

КПП организации арендатора

organisationName

String

Полное наименование организации арендатора

kkmShifts

Array

список смен

kkmShifts[].kkmRegId

String

РНМ кассы

kkmShifts[].dateTimeOpen

Number

Время открытия смены

kkmShifts[].dateTimeClose

Number

Время закрытия смены

kkmShifts[].fsNumber

String

Заводской номер ФН

kkmShifts[].kkmNumber

String

Заводской номер кассы

kkmShifts[].kkmName

String

Наименование кассы

kkmShifts[].kkmAddress

String

Адрес места установки кассы

kkmShifts[].kkmSalesPoint

String

Название точки продаж

kkmShifts[].shiftNumber

Number

Номер смены

kkmShifts[].userPropertyValue

Array

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

kkmShifts[].userPropertyValue[].userPropertyValue

String

Значение реквизита 1086

kkmShifts[].userPropertyValue[].totalSum

Number

Сумма выручки

kkmShifts[].userPropertyValue[].nds20

Number

Сумма НДС по ставке 20%

kkmShifts[].userPropertyValue[].nds10

Number

Сумма НДС по ставке 10%

kkmShifts[].userPropertyValue[].nds0

Number

Сумма расчетов с НДС по ставке 0%

kkmShifts[].userPropertyValue[].ndsNo

Number

Сумма расчетов без НДС

kkmShifts[].userPropertyValue[].sellCount

Number

Чеков Прихода

kkmShifts[].userPropertyValue[].sellReturnCount

Number

Чеков Возврат прихода

kkmShifts[].userPropertyValue[].sellReturnCashSum

Number

Сумма возврата Прихода наличными

kkmShifts[].userPropertyValue[].sellReturnEcashSum

Number

Сумма возврата Прихода безналичными

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/userPropertyShifts?regId=111112222233344&retailPlaceId=1&dateFrom=2024-12-10T13:34:57.037&dateTo=2024-12-11T13:34:57.037' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk3LCJleHAiOjE3MzM5MTM4OTd9.Tk9AkZgTqI9bYLH4RdivORQ2GyHyDlszT7KCuU1zhMwg7HO_wtYo3WXUuxscf-Dzr7wh4M7ODy0EA5EJXO_n3w'

9. Получение списка транзакций

GET /api/rent/v1/organisations/123456789333/transactions?kkmRegId=111112222233344&fsFactoryNumber=123&shiftNum=1 HTTP/1.1
Accept: application/json
X-Api-Key: qwerty123
Host: universal-api-host

Path parameters ./api/rent/v1/organisations/{orgInn}/transactions

Parameter Description

orgInn

ИНН организации арендатора

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Request parameters

Parameter Description

kkmRegId

Регистрационный номер кассы

shiftNum

Номер смены

fsFactoryNumber

Заводской номер ФН

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "title" : "Тестовая Организация",
  "address" : "Нижний Новгород, Покровская д. 52",
  "kkmAddress" : "Нижний Новгород, Покровская, д.52",
  "kkmRegId" : "111112222233344",
  "fsFactoryNumber" : "123",
  "kkmFactoryNumber" : "96728465279",
  "shiftNum" : 1,
  "transactions" : [ {
    "id" : "111112222233344_123_22",
    "transactionDate" : "2024-12-11T10:34:54",
    "transactionType" : "TICKET",
    "operationType" : 2,
    "requestNumber" : 105,
    "payments" : [ {
      "paymentType" : "CARD",
      "sum" : 0.5
    }, {
      "paymentType" : "CASH",
      "sum" : 0.5
    }, {
      "paymentType" : "PRE",
      "sum" : 0.5
    }, {
      "paymentType" : "POST",
      "sum" : 0.5
    }, {
      "paymentType" : "COUNTER_SUBMISSION",
      "sum" : 0.5
    } ],
    "totalSum" : 2.5,
    "fiscalDocumentNumber" : 22
  } ]
}

Response fields

Path Type Description

inn

String

ИНН организации арендатора

kpp

String

КПП организации арендатора

title

String

Название торговой точки

address

String

Адрес торговой точки

kkmAddress

String

Адрес места установки кассы

kkmRegId

String

Регистрационный номер кассы

fsFactoryNumber

String

Заводской номер ФН

kkmFactoryNumber

String

Заводской номер кассы

shiftNum

Number

Номер смены

transactions[].id

String

идентификатор транзакции (рнм + фн + номер документа)

transactions[].transactionDate

String

дата и время проведения транзакции (время кассы локальное)

transactions[].transactionType

String

Тип документа

transactions[].operationType

Number

Тип операции: "0" - расход, "1" - возврат расхода, "2" - приход, "3" - возврат прихода

transactions[].requestNumber

Number

№ чека за смену

transactions[].payments

Array

список платежей

transactions[].payments.[].sum

Number

сумма платежа

transactions[].payments.[].paymentType

String

типы оплаты

transactions[].totalSum

Number

общая сумма

transactions[].fiscalDocumentNumber

Number

номер фискального документа

Curl

$ curl 'https://universal-api-host/api/rent/v1/organisations/123456789333/transactions?kkmRegId=111112222233344&fsFactoryNumber=123&shiftNum=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'X-Api-Key: qwerty123'

10. Получение списка документов

GET /api/rent/v2/organisations/123456789333/documents?kkmRegId=111112222233344&fsFactoryNumber=123&shiftNum=1 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjkzLCJleHAiOjE3MzM5MTM4OTN9.hfft-SkHMsPEi2ZKJ7Pwk9KEjBxgoi9E_DiB9qsOrIgZE6d3EcE64fw-Xp_GHs6huy8hfkRNqAgLLOoL5ioYZg
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/documents

Parameter Description

orgInn

ИНН организации

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Request parameters

Parameter Description

kkmRegId

Регистрационный номер кассы

fsFactoryNumber

Номер фискального накопителя

shiftNum

Номер смены

  • Опциональные параметры запроса:

    • fromDate - Начальная дата(локальное время) формирования документа на ККТ,

    • toDate - Конечная дата(локальное время) формирования документа на ККТ,

    • fromInsDate - Начальная дата сохранения документа в ОФД,

    • toInsDate - Конечная дата сохранения документа в ОФД,

    • shiftNum - Номер смены,

    • transactionTypes - Типы транзакций.

  • Примечания:

    • Параметры fromDate, toDate, задаются строкой в формате YYYY-MM-DDThh:mm:ss[.SSS],

    • Параметры fromInsDate, toInsDate задаются строкой в формате YYYY-MM-DDThh:mm:ss.SSSZ,

    • Максимальный промежуток между fromDate и toDate ⇐ 30 дней,

    • Максимальный промежуток между fromInsDate и toInsDate ⇐ 30 дней,

    • Один из параметров: shiftNum, fromDate/toDate, fromInsDate/toInsDate обязательно должен быть в запросе. Можно одновременно указать shiftNum и (fromDate/toDate ИЛИ fromInsDate/toInsDate),

    • В transactionTypes может быть передано несколько типов документов в одном запросе. Если transactionTypes не задан - в ответе возвращаются все типы документов, если введен - то применяется фильтр.

  • Возможные значения параметра transactionTypes:

    • TICKET - Кассовый чек,

    • CLOSE_SHIFT - Отчет о закрытии смены,

    • OPEN_SHIFT - Отчёт об открытии смены,

    • RECEIPT_CORRECTION - Кассовый чек коррекции,

    • BSO - Бланк строгой отчетности,

    • BSO_CORRECTION - Бланк строгой отчетности коррекции,

    • FISCAL_REPORT_CORRECTION - Отчет об изменениях параметров регистрации,

    • CLOSE_ARCHIVE - Закрытие архива.

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "title" : "Тестовая Организация",
  "address" : "Нижний Новгород, Покровская д. 52",
  "kkmAddress" : "Нижний Новгород, Покровская, д.52",
  "kkmRegId" : "111112222233344",
  "fsFactoryNumber" : "123",
  "kkmFactoryNumber" : "96728465279",
  "documents" : [ {
    "transactionDate" : "2024-12-11T10:34:53",
    "fiscalSign" : "859059510",
    "insertedAt" : "1970-01-01T00:00:00Z",
    "transactionType" : "Кассовый чек",
    "kkmRegId" : "111112222233344",
    "fiscalDriveNumber" : "123",
    "fiscalDocumentNumber" : 22,
    "shiftNum" : 1,
    "ticket" : {
      "requestNumber" : 105,
      "operator" : { },
      "operationType" : 1,
      "taxationType" : "ОСН",
      "totalSum" : 2.5,
      "cashTotalSum" : 0.5,
      "ecashTotalSum" : 0.5,
      "prepaymentSum" : 0.5,
      "postpaymentSum" : 0.5,
      "counterSubmissionSum" : 0.5,
      "taxes" : {
        "nds20" : 0,
        "nds10" : 0,
        "nds0" : 0,
        "ndsNo" : 0,
        "ndsCalculated20" : 0,
        "ndsCalculated10" : 0
      },
      "userProperty" : {
        "value" : "value",
        "key" : "key"
      },
      "retailPlace" : "Магазин",
      "buyerPhoneOrAddress" : "test@addressClient.com",
      "items" : [ {
        "quantity" : 1.0,
        "name" : "Ford Focus 2013 г.в.",
        "sum" : 605.0,
        "price" : 605.0,
        "ndsRate" : 6,
        "ndsSum" : 500.5,
        "calculationTypeSign" : 1,
        "calculationSubjectSign" : 1,
        "productCodeNew" : {
          "undefined" : "ktN",
          "ean8" : "ktEAN8",
          "ean13" : "ktEAN13",
          "itf14" : "ktITF14",
          "gs1" : "ktGS10",
          "gs1m" : "ktGS1M",
          "kmk" : "ktKMK",
          "mi" : "ktMI",
          "egais2" : "ktEGAIS20",
          "egais3" : "ktEGAIS30",
          "f1" : "ktF1",
          "f2" : "ktF2",
          "f3" : "ktF3",
          "f4" : "ktF4",
          "f5" : "ktF5",
          "f6" : "ktF6"
        },
        "labelCodeProcessMode" : 1,
        "checkingProdInformationResult" : 1,
        "controlCode" : "1",
        "labeledProdFractionalQuantity" : {
          "fractionalPart" : "2343",
          "numerator" : 10,
          "denominator" : 5
        },
        "paymentAgentByProductType" : 1,
        "providerInn" : "7564557689",
        "providerData" : {
          "providerPhone" : [ "+89675645364" ],
          "providerName" : "Самый лучший провайдер"
        },
        "paymentAgentData" : {
          "transferOperatorName" : "Лучший оператор",
          "transferOperatorAddress" : "г. Москва, ул. Добролюбова, д. 11, корп.3",
          "transferOperatorInn" : "1278965432",
          "paymentAgentOperation" : "Оплата",
          "paymentAgentPhone" : [ "+34576543" ],
          "paymentOperatorPhone" : [ "+89675645342" ],
          "transferOperatorPhone" : [ "+89045767585" ]
        },
        "industryReceiptRequisite" : [ {
          "foivId" : "foivId1",
          "documentDate" : "documentDate1",
          "documentNumber" : "documentNumber1",
          "value" : "value1"
        } ]
      } ],
      "property" : "Дополнительный",
      "itemsCount" : 1
    }
  } ]
}

Response fields

Path Type Description

inn

String

ИНН организации

kpp

String

КПП организации

title

String

Название торговой точки

address

String

Адрес торговой точки

kkmAddress

String

Адрес места установки кассы

kkmRegId

String

Регистрационный номер кассы

fsFactoryNumber

String

Заводской номер фискального накопителя

kkmFactoryNumber

String

Заводской номер кассы

documents[].fiscalDriveNumber

String

Заводской номер фискального накопителя

documents[].transactionDate

String

дата и время проведения транзакции (время кассы локальное)

documents[].transactionType

String

Тип документа

documents[].fiscalSign

String

Фискальный признак документа

documents[].insertedAt

String

Дата и время приема документа ОФД (UTC)

documents[].kkmRegId

String

Регистрационный номер кассы

documents[].fiscalDocumentNumber

Number

Номер документа

documents[].shiftNum

Number

Номер смены

documents[].ticket

Object

Кассовый чек

documents[].ticket.operator

Object

Объект содержит имя кассира и ИНН кассира

documents[].ticket.operator.operatorName

String

Имя кассира

documents[].ticket.operator.operatorInn

String

ИНН кассира

documents[].ticket.buyerPhoneOrAddress

String

Телефон или почтовый адрес покупателя

documents[].ticket.buyerInformation

Object

сведения о покупателе (клиенте)

documents[].ticket.requestNumber

Number

№ чека за смену

documents[].ticket.taxationType

String

Система налогообложения

documents[].ticket.property

String

Значение дополнительного реквизита с учетом особенностей сферы деятельности, в которой осуществляются расчеты

documents[].ticket.taxes

Object

Содержит налоги на весь чек

documents[].ticket.taxes.nds20

Number

Сумма НДС чека по ставке 20%

documents[].ticket.taxes.nds10

Number

Сумма НДС чека по ставке 10%

documents[].ticket.taxes.nds0

Number

Сумма расчетов по чеку с НДС по ставке 0%

documents[].ticket.taxes.ndsNo

Number

Сумма расчета по чеку без НДС

documents[].ticket.taxes.ndsCalculated20

Number

Сумма НДС чека по расч. ставке 20/120

documents[].ticket.taxes.ndsCalculated10

Number

Cумма НДС чека по расч. ставке 10/110

documents[].ticket.operationType

Number

Тип операции: "1" - приход, "2" - возврат прихода, "3" - расход, "4" - возврат расхода

documents[].ticket.totalSum

Number

Итоговая сумма чека

documents[].ticket.cashTotalSum

Number

Сумма чека наличными

documents[].ticket.ecashTotalSum

Number

Сумма чек безналичными

documents[].ticket.prepaymentSum

Number

Сумма чека предоплатой

documents[].ticket.postpaymentSum

Number

Сумма чека постоплатой

documents[].ticket.counterSubmissionSum

Number

Сумма чека встречным представлением

documents[].ticket.userProperty

Object

Дополнительный реквизит пользователя

documents[].ticket.userProperty.key

String

Наименование дополнительного реквизита пользователя

documents[].ticket.userProperty.value

String

Значение дополнительного реквизита пользователя

documents[].ticket.retailPlace

String

Место расчетов

documents[].ticket.items[]

Array

Список товаров или услуг

documents[].ticket.items[].quantity

Number

Количество товара/услуг

documents[].ticket.items[].name

String

Наименование товара/услуги

documents[].ticket.items[].sum

Number

Стоимость товара/услуги

documents[].ticket.items[].price

Number

Стоимость за единицу товара/услуги

documents[].ticket.items[].ndsRate

Number

Ставка НДС

documents[].ticket.items[].ndsSum

Number

Сумма НДС товара/услуги

documents[].ticket.items[].calculationTypeSign

Number

Признак способа расчета

documents[].ticket.items[].calculationSubjectSign

Number

Признак предмета расчета. Расшифровку кодов см. в ФФД, утвержденных ФНС

documents[].ticket.items[].industryReceiptRequisite[]

Array

Отраслевой реквизит предмета расчета (тег 1260)

documents[].ticket.items[].industryReceiptRequisite[].foivId

String

Идентификатор ФОИВ (тег 1262)

documents[].ticket.items[].industryReceiptRequisite[].documentDate

String

Дата документа основания (тег 1263)

documents[].ticket.items[].industryReceiptRequisite[].documentNumber

String

Номер документа основания (тег 1264)

documents[].ticket.items[].industryReceiptRequisite[].value

String

Значение отраслевого реквизита (тег 1265)

documents[].ticket.items[].paymentAgentByProductType

Number

Признак агента по предмету расчета (тег 1222)

documents[].ticket.items[].providerInn

String

ИНН поставщика (тег 1226)

documents[].ticket.items[].providerData

Object

Данные поставщика (тег 1224)

documents[].ticket.items[].providerData.providerPhone

Array

Телефон поставщика (тег 1171)

documents[].ticket.items[].providerData.providerName

String

Наименование поставщика (тег 1225)

documents[].ticket.items[].paymentAgentData

Object

Значения реквизита данные агента (тег 1223)

documents[].ticket.items[].paymentAgentData.transferOperatorName

String

Наименование оператора перевода (тег 1026)

documents[].ticket.items[].paymentAgentData.transferOperatorAddress

String

Адрес оператора перевода (тег 1005)

documents[].ticket.items[].paymentAgentData.transferOperatorInn

String

ИНН оператора перевода (тег 1016)

documents[].ticket.items[].paymentAgentData.paymentAgentOperation

String

Операция платежного агента (тег 1044)

documents[].ticket.items[].paymentAgentData.paymentAgentPhone

Array

Телефон платежного агента (тег 1073)

documents[].ticket.items[].paymentAgentData.paymentOperatorPhone

Array

Телефон оператора по приему платежей (тег 1074)

documents[].ticket.items[].paymentAgentData.transferOperatorPhone

Array

Телефон оператора перевода (тег 1075)

documents[].ticket.items[].productCodeNew

Object

Код товара

documents[].ticket.items[].productCodeNew.undefined

String

Код товара, формат которого не идентифицирован

documents[].ticket.items[].productCodeNew.ean8

String

Код товара в формате EAN-8

documents[].ticket.items[].productCodeNew.ean13

String

Код товара в формате EAN-13

documents[].ticket.items[].productCodeNew.itf14

String

Код товара в формате ITF-14

documents[].ticket.items[].productCodeNew.gs1

String

Код товара в формате GS1, нанесенный на товар, не подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.gs1m

String

Код товара в формате GS1, нанесенный на товар, подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.kmk

String

Код товара в формате короткого кода маркировки, нанесенный на товар, подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.mi

String

Контрольноидентификационный знак мехового изделия

documents[].ticket.items[].productCodeNew.egais2

String

Код товара в формате ЕГАИС-2.0

documents[].ticket.items[].productCodeNew.egais3

String

Код товара в формате ЕГАИС-3.0

documents[].ticket.items[].productCodeNew.f1

String

Код товара в формате Ф.1

documents[].ticket.items[].productCodeNew.f2

String

Код товара в формате Ф.2

documents[].ticket.items[].productCodeNew.f3

String

Код товара в формате Ф.3

documents[].ticket.items[].productCodeNew.f4

String

Код товара в формате Ф.4

documents[].ticket.items[].productCodeNew.f5

String

Код товара в формате Ф.5

documents[].ticket.items[].productCodeNew.f6

String

Код товара в формате Ф.6

documents[].ticket.items[].labeledProdFractionalQuantity

Object

Дробное количество маркированного товара

documents[].ticket.items[].labeledProdFractionalQuantity.fractionalPart

String

Дробная часть предмета расчета

documents[].ticket.items[].labeledProdFractionalQuantity.numerator

Number

Числитель дробной части предмета расчета

documents[].ticket.items[].labeledProdFractionalQuantity.denominator

Number

Знаменатель дробной части предмета расчета

documents[].ticket.items[].labelCodeProcessMode

Number

Режим обработки кода маркировки

documents[].ticket.items[].checkingProdInformationResult

Number

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

documents[].ticket.items[].controlCode

String

Контрольный код КМ

documents[].ticket.itemsCount

Object

Количество товарных позиций

documents[].bso

Object

Бланк строгой отчетности

documents[].receiptCorrection

Object

Кассовый чек коррекции

documents[].bsoCorrection

Object

Бланк строгой отчетности коррекции

documents[].openShift

Object

Отчёт об открытии смены

documents[].closeShift

Object

Отчет о закрытии смены

documents[].fiscalReport

Object

Отчет о регистрации

documents[].fiscalReportCorrection

Object

Отчет об изменениях параметров регистрации

documents[].closeArchive

Object

Закрытие архива

  • Возможные значения возвращаемого поля calculationTypeSign(Признак способа расчета):

    • "1" - предоплата 100%,

    • "2" - предоплата,

    • "3" - аванс,

    • "4" - полный расчет,

    • "5" - частичный расчет и кредит,

    • "6" - передача в кредит,

    • "7" - оплата кредита.

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/virtual/documents?virtualKkmId=43&fsFactoryNumber=123&shiftNum=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk0LCJleHAiOjE3MzM5MTM4OTR9.6PkA3Fsf6OtN7bgTsJ0T8Dvnvb0Q0S2F6M1qTxp6PfB-bRSULLeqk1nox0EtcE4H_DWYoe7MaWu4xtXYAZ3Skw'

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

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

GET /api/rent/v2/organisations/123456789333/virtual/documents?virtualKkmId=43&fsFactoryNumber=123&shiftNum=1 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk0LCJleHAiOjE3MzM5MTM4OTR9.6PkA3Fsf6OtN7bgTsJ0T8Dvnvb0Q0S2F6M1qTxp6PfB-bRSULLeqk1nox0EtcE4H_DWYoe7MaWu4xtXYAZ3Skw
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/virtual/documents

Parameter Description

orgInn

ИНН организации

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Request parameters

Parameter Description

virtualKkmId

Ид виртуальной кассы

fsFactoryNumber

Номер фискального накопителя

shiftNum

Номер смены

  • Опциональные параметры запроса:

    • fromDate - Начальная дата(локальное время) формирования документа на ККТ,

    • toDate - Конечная дата(локальное время) формирования документа на ККТ,

    • fromInsDate - Начальная дата сохранения документа в ОФД,

    • toInsDate - Конечная дата сохранения документа в ОФД,

    • shiftNum - Номер смены,

    • transactionTypes - Типы транзакций.

  • Примечания:

    • Метод доступен, если подключена услуга виртуальных касс. Для получения подробной информации и подключения данной услуги отправьте письмо с запросом по адресу info@1-ofd.ru. В теме письма укажите "Подключение услуги виртуальных касс" и наименование своей организации.

    • Параметры fromDate, toDate, задаются строкой в формате YYYY-MM-DDThh:mm:ss[.SSS],

    • Параметры fromInsDate, toInsDate задаются строкой в формате YYYY-MM-DDThh:mm:ss.SSSZ,

    • Максимальный промежуток между fromDate и toDate ⇐ 30 дней,

    • Максимальный промежуток между fromInsDate и toInsDate ⇐ 30 дней,

    • Один из параметров: shiftNum, fromDate/toDate, fromInsDate/toInsDate обязательно должен быть в запросе. Можно одновременно указать shiftNum и (fromDate/toDate ИЛИ fromInsDate/toInsDate),

    • В transactionTypes может быть передано несколько типов документов в одном запросе. Если transactionTypes не задан - в ответе возвращаются все типы документов, если введен - то применяется фильтр.

  • Возможные значения параметра transactionTypes:

    • TICKET - Кассовый чек,

    • CLOSE_SHIFT - Отчет о закрытии смены,

    • OPEN_SHIFT - Отчёт об открытии смены,

    • RECEIPT_CORRECTION - Кассовый чек коррекции,

    • BSO - Бланк строгой отчетности,

    • BSO_CORRECTION - Бланк строгой отчетности коррекции,

    • FISCAL_REPORT_CORRECTION - Отчет об изменениях параметров регистрации,

    • CLOSE_ARCHIVE - Закрытие архива.

Response body

{
  "inn" : "123456789333",
  "kpp" : "770201001",
  "title" : "Тестовая Организация",
  "address" : "Нижний Новгород, Покровская д. 52",
  "kkmAddress" : "Нет адреса",
  "kkmRegId" : "111112222233344",
  "fsFactoryNumber" : "123",
  "kkmFactoryNumber" : "96728465279",
  "documents" : [ {
    "transactionDate" : "2024-12-11T10:34:54",
    "fiscalSign" : "859059510",
    "insertedAt" : "1970-01-01T00:00:00Z",
    "transactionType" : "Кассовый чек",
    "kkmRegId" : "111112222233344",
    "fiscalDriveNumber" : "123",
    "fiscalDocumentNumber" : 22,
    "shiftNum" : 1,
    "ticket" : {
      "requestNumber" : 105,
      "operator" : { },
      "operationType" : 1,
      "taxationType" : "ОСН",
      "totalSum" : 2.5,
      "cashTotalSum" : 0.5,
      "ecashTotalSum" : 0.5,
      "prepaymentSum" : 0.5,
      "postpaymentSum" : 0.5,
      "counterSubmissionSum" : 0.5,
      "taxes" : {
        "nds20" : 0,
        "nds10" : 0,
        "nds0" : 0,
        "ndsNo" : 0,
        "ndsCalculated20" : 0,
        "ndsCalculated10" : 0
      },
      "userProperty" : {
        "value" : "value",
        "key" : "key"
      },
      "retailPlace" : "Магазин",
      "buyerPhoneOrAddress" : "test@addressClient.com",
      "items" : [ {
        "quantity" : 1.0,
        "name" : "Ford Focus 2013 г.в.",
        "sum" : 605.0,
        "price" : 605.0,
        "ndsRate" : 6,
        "ndsSum" : 500.5,
        "calculationTypeSign" : 1,
        "calculationSubjectSign" : 1,
        "productCodeNew" : {
          "undefined" : "ktN",
          "ean8" : "ktEAN8",
          "ean13" : "ktEAN13",
          "itf14" : "ktITF14",
          "gs1" : "ktGS10",
          "gs1m" : "ktGS1M",
          "kmk" : "ktKMK",
          "mi" : "ktMI",
          "egais2" : "ktEGAIS20",
          "egais3" : "ktEGAIS30",
          "f1" : "ktF1",
          "f2" : "ktF2",
          "f3" : "ktF3",
          "f4" : "ktF4",
          "f5" : "ktF5",
          "f6" : "ktF6"
        },
        "labelCodeProcessMode" : 1,
        "checkingProdInformationResult" : 1,
        "controlCode" : "1",
        "labeledProdFractionalQuantity" : {
          "fractionalPart" : "2343",
          "numerator" : 10,
          "denominator" : 5
        },
        "paymentAgentByProductType" : 1,
        "providerInn" : "7564557689",
        "providerData" : {
          "providerPhone" : [ "+89675645364" ],
          "providerName" : "Самый лучший провайдер"
        },
        "paymentAgentData" : {
          "transferOperatorName" : "Лучший оператор",
          "transferOperatorAddress" : "г. Москва, ул. Добролюбова, д. 11, корп.3",
          "transferOperatorInn" : "1278965432",
          "paymentAgentOperation" : "Оплата",
          "paymentAgentPhone" : [ "+34576543" ],
          "paymentOperatorPhone" : [ "+89675645342" ],
          "transferOperatorPhone" : [ "+89045767585" ]
        },
        "industryReceiptRequisite" : [ {
          "foivId" : "foivId1",
          "documentDate" : "documentDate1",
          "documentNumber" : "documentNumber1",
          "value" : "value1"
        } ]
      } ],
      "property" : "Дополнительный",
      "itemsCount" : 1
    }
  } ]
}

Response fields

Path Type Description

inn

String

ИНН организации

kpp

String

КПП организации

title

String

Название торговой точки

address

String

Адрес торговой точки

kkmAddress

String

Адрес места установки кассы

kkmRegId

String

Регистрационный номер кассы

fsFactoryNumber

String

Заводской номер фискального накопителя

kkmFactoryNumber

String

Заводской номер кассы

documents[].fiscalDriveNumber

String

Заводской номер фискального накопителя

documents[].transactionDate

String

дата и время проведения транзакции (время кассы локальное)

documents[].transactionType

String

Тип документа

documents[].fiscalSign

String

Фискальный признак документа

documents[].insertedAt

String

Дата и время приема документа ОФД (UTC)

documents[].kkmRegId

String

Регистрационный номер кассы

documents[].fiscalDocumentNumber

Number

Номер документа

documents[].shiftNum

Number

Номер смены

documents[].ticket

Object

Кассовый чек

documents[].ticket.operator

Object

Объект содержит имя кассира и ИНН кассира

documents[].ticket.operator.operatorName

String

Имя кассира

documents[].ticket.operator.operatorInn

String

ИНН кассира

documents[].ticket.buyerPhoneOrAddress

String

Телефон или почтовый адрес покупателя

documents[].ticket.buyerInformation

Object

сведения о покупателе (клиенте)

documents[].ticket.requestNumber

Number

№ чека за смену

documents[].ticket.taxationType

String

Система налогообложения

documents[].ticket.property

String

Значение дополнительного реквизита с учетом особенностей сферы деятельности, в которой осуществляются расчеты

documents[].ticket.taxes

Object

Содержит налоги на весь чек

documents[].ticket.taxes.nds20

Number

Сумма НДС чека по ставке 20%

documents[].ticket.taxes.nds10

Number

Сумма НДС чека по ставке 10%

documents[].ticket.taxes.nds0

Number

Сумма расчетов по чеку с НДС по ставке 0%

documents[].ticket.taxes.ndsNo

Number

Сумма расчета по чеку без НДС

documents[].ticket.taxes.ndsCalculated20

Number

Сумма НДС чека по расч. ставке 20/120

documents[].ticket.taxes.ndsCalculated10

Number

Cумма НДС чека по расч. ставке 10/110

documents[].ticket.operationType

Number

Тип операции: "1" - приход, "2" - возврат прихода, "3" - расход, "4" - возврат расхода

documents[].ticket.totalSum

Number

Итоговая сумма чека

documents[].ticket.cashTotalSum

Number

Сумма чека наличными

documents[].ticket.ecashTotalSum

Number

Сумма чек безналичными

documents[].ticket.prepaymentSum

Number

Сумма чека предоплатой

documents[].ticket.postpaymentSum

Number

Сумма чека постоплатой

documents[].ticket.counterSubmissionSum

Number

Сумма чека встречным представлением

documents[].ticket.userProperty

Object

Дополнительный реквизит пользователя

documents[].ticket.userProperty.key

String

Наименование дополнительного реквизита пользователя

documents[].ticket.userProperty.value

String

Значение дополнительного реквизита пользователя

documents[].ticket.retailPlace

String

Место расчетов

documents[].ticket.items[]

Array

Список товаров или услуг

documents[].ticket.items[].quantity

Number

Количество товара/услуг

documents[].ticket.items[].name

String

Наименование товара/услуги

documents[].ticket.items[].sum

Number

Стоимость товара/услуги

documents[].ticket.items[].price

Number

Стоимость за единицу товара/услуги

documents[].ticket.items[].ndsRate

Number

Ставка НДС

documents[].ticket.items[].ndsSum

Number

Сумма НДС товара/услуги

documents[].ticket.items[].calculationTypeSign

Number

Признак способа расчета

documents[].ticket.items[].calculationSubjectSign

Number

Признак предмета расчета. Расшифровку кодов см. в ФФД, утвержденных ФНС

documents[].ticket.items[].industryReceiptRequisite[]

Array

Отраслевой реквизит предмета расчета (тег 1260)

documents[].ticket.items[].industryReceiptRequisite[].foivId

String

Идентификатор ФОИВ (тег 1262)

documents[].ticket.items[].industryReceiptRequisite[].documentDate

String

Дата документа основания (тег 1263)

documents[].ticket.items[].industryReceiptRequisite[].documentNumber

String

Номер документа основания (тег 1264)

documents[].ticket.items[].industryReceiptRequisite[].value

String

Значение отраслевого реквизита (тег 1265)

documents[].ticket.items[].paymentAgentByProductType

Number

Признак агента по предмету расчета (тег 1222)

documents[].ticket.items[].providerInn

String

ИНН поставщика (тег 1226)

documents[].ticket.items[].providerData

Object

Данные поставщика (тег 1224)

documents[].ticket.items[].providerData.providerPhone

Array

Телефон поставщика (тег 1171)

documents[].ticket.items[].providerData.providerName

String

Наименование поставщика (тег 1225)

documents[].ticket.items[].paymentAgentData

Object

Значения реквизита данные агента (тег 1223)

documents[].ticket.items[].paymentAgentData.transferOperatorName

String

Наименование оператора перевода (тег 1026)

documents[].ticket.items[].paymentAgentData.transferOperatorAddress

String

Адрес оператора перевода (тег 1005)

documents[].ticket.items[].paymentAgentData.transferOperatorInn

String

ИНН оператора перевода (тег 1016)

documents[].ticket.items[].paymentAgentData.paymentAgentOperation

String

Операция платежного агента (тег 1044)

documents[].ticket.items[].paymentAgentData.paymentAgentPhone

Array

Телефон платежного агента (тег 1073)

documents[].ticket.items[].paymentAgentData.paymentOperatorPhone

Array

Телефон оператора по приему платежей (тег 1074)

documents[].ticket.items[].paymentAgentData.transferOperatorPhone

Array

Телефон оператора перевода (тег 1075)

documents[].ticket.items[].productCodeNew

Object

Код товара

documents[].ticket.items[].productCodeNew.undefined

String

Код товара, формат которого не идентифицирован

documents[].ticket.items[].productCodeNew.ean8

String

Код товара в формате EAN-8

documents[].ticket.items[].productCodeNew.ean13

String

Код товара в формате EAN-13

documents[].ticket.items[].productCodeNew.itf14

String

Код товара в формате ITF-14

documents[].ticket.items[].productCodeNew.gs1

String

Код товара в формате GS1, нанесенный на товар, не подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.gs1m

String

Код товара в формате GS1, нанесенный на товар, подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.kmk

String

Код товара в формате короткого кода маркировки, нанесенный на товар, подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.mi

String

Контрольноидентификационный знак мехового изделия

documents[].ticket.items[].productCodeNew.egais2

String

Код товара в формате ЕГАИС-2.0

documents[].ticket.items[].productCodeNew.egais3

String

Код товара в формате ЕГАИС-3.0

documents[].ticket.items[].productCodeNew.f1

String

Код товара в формате Ф.1

documents[].ticket.items[].productCodeNew.f2

String

Код товара в формате Ф.2

documents[].ticket.items[].productCodeNew.f3

String

Код товара в формате Ф.3

documents[].ticket.items[].productCodeNew.f4

String

Код товара в формате Ф.4

documents[].ticket.items[].productCodeNew.f5

String

Код товара в формате Ф.5

documents[].ticket.items[].productCodeNew.f6

String

Код товара в формате Ф.6

documents[].ticket.items[].labeledProdFractionalQuantity

Object

Дробное количество маркированного товара

documents[].ticket.items[].labeledProdFractionalQuantity.fractionalPart

String

Дробная часть предмета расчета

documents[].ticket.items[].labeledProdFractionalQuantity.numerator

Number

Числитель дробной части предмета расчета

documents[].ticket.items[].labeledProdFractionalQuantity.denominator

Number

Знаменатель дробной части предмета расчета

documents[].ticket.items[].labelCodeProcessMode

Number

Режим обработки кода маркировки

documents[].ticket.items[].checkingProdInformationResult

Number

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

documents[].ticket.items[].controlCode

String

Контрольный код КМ

documents[].ticket.itemsCount

Object

Количество товарных позиций

documents[].bso

Object

Бланк строгой отчетности

documents[].receiptCorrection

Object

Кассовый чек коррекции

documents[].bsoCorrection

Object

Бланк строгой отчетности коррекции

documents[].openShift

Object

Отчёт об открытии смены

documents[].closeShift

Object

Отчет о закрытии смены

documents[].fiscalReport

Object

Отчет о регистрации

documents[].fiscalReportCorrection

Object

Отчет об изменениях параметров регистрации

documents[].closeArchive

Object

Закрытие архива

  • Возможные значения возвращаемого поля calculationTypeSign(Признак способа расчета):

    • "1" - предоплата 100%,

    • "2" - предоплата,

    • "3" - аванс,

    • "4" - полный расчет,

    • "5" - частичный расчет и кредит,

    • "6" - передача в кредит,

    • "7" - оплата кредита.

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/virtual/documents?virtualKkmId=43&fsFactoryNumber=123&shiftNum=1' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjk0LCJleHAiOjE3MzM5MTM4OTR9.6PkA3Fsf6OtN7bgTsJ0T8Dvnvb0Q0S2F6M1qTxp6PfB-bRSULLeqk1nox0EtcE4H_DWYoe7MaWu4xtXYAZ3Skw'

12. Получение документов по дополнительным реквизитам

Метод позволяет получить список транзакций по соответствующим значениям дополнительных реквизитов 1085 и 1086

GET /api/rent/v2/organisations/123456789333/documents/property?fromDate=2024-12-10T13:34:50.988&toDate=2024-12-11T13:34:50.988&userPropertyKey=MVLM&userPropertyValue=MVIO HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjkxLCJleHAiOjE3MzM5MTM4OTF9.waUzBP9KsNSKcoBc6Bv9hQBVFUTNQI1khI0WqeswLb_o1o0wcDoXyuAr0-iHAeU8Dmdv-zAmy9zCAXWHaI-Lig
Host: universal-api-host

Path parameters ./api/rent/v2/organisations/{orgInn}/documents/property

Parameter Description

orgInn

ИНН организации

Если у организации существует kpp, его необходимо указать через точку inn.kpp (Например "1234567890.111111111")

Request parameters

Parameter Description

userPropertyKey

Имя доп. реквизита

userPropertyValue

Значение доп. реквизита

fromDate

дата начала запроса

toDate

дата конца запроса

  • Примечания:

    • Параметры fromDate, toDate, задаются строкой в формате YYYY-MM-DDThh:mm:ss[.SSS],

    • Параметры fromInsDate, toInsDate задаются строкой в формате YYYY-MM-DDThh:mm:ss.SSSZ,

    • Максимальный промежуток между fromDate и toDate ⇐ 30 дней,

    • Максимальный промежуток между fromInsDate и toInsDate ⇐ 30 дней,

    • Метод доступен, если подключена услуга по индексации входящих чеков по указанным выше значениям. Для получения подробной информации и подключения данной услуги отправьте письмо с запросом по адресу info@1-ofd.ru. В теме письма укажите "Подключение услуги по индексации входящих чеков по 1085 и 1086" и наименование своей организации.

Response body

{
  "documents" : [ {
    "transactionDate" : "2024-12-11T10:34:49",
    "fiscalSign" : "859059510",
    "insertedAt" : "1970-01-01T00:00:00Z",
    "transactionType" : "Кассовый чек",
    "kkmRegId" : "111112222233344",
    "fiscalDriveNumber" : "123",
    "fiscalDocumentNumber" : 22,
    "shiftNum" : 1,
    "ticket" : {
      "requestNumber" : 105,
      "operator" : { },
      "operationType" : 1,
      "taxationType" : "ОСН",
      "totalSum" : 2.5,
      "cashTotalSum" : 0.5,
      "ecashTotalSum" : 0.5,
      "prepaymentSum" : 0.5,
      "postpaymentSum" : 0.5,
      "counterSubmissionSum" : 0.5,
      "taxes" : {
        "nds20" : 0,
        "nds10" : 0,
        "nds0" : 0,
        "ndsNo" : 0,
        "ndsCalculated20" : 0,
        "ndsCalculated10" : 0
      },
      "userProperty" : {
        "value" : "value",
        "key" : "key"
      },
      "retailPlace" : "Магазин",
      "buyerPhoneOrAddress" : "test@addressClient.com",
      "items" : [ {
        "quantity" : 1.0,
        "name" : "Ford Focus 2013 г.в.",
        "sum" : 605.0,
        "price" : 605.0,
        "ndsRate" : 6,
        "ndsSum" : 500.5,
        "calculationTypeSign" : 1,
        "calculationSubjectSign" : 1,
        "productCodeNew" : {
          "undefined" : "ktN",
          "ean8" : "ktEAN8",
          "ean13" : "ktEAN13",
          "itf14" : "ktITF14",
          "gs1" : "ktGS10",
          "gs1m" : "ktGS1M",
          "kmk" : "ktKMK",
          "mi" : "ktMI",
          "egais2" : "ktEGAIS20",
          "egais3" : "ktEGAIS30",
          "f1" : "ktF1",
          "f2" : "ktF2",
          "f3" : "ktF3",
          "f4" : "ktF4",
          "f5" : "ktF5",
          "f6" : "ktF6"
        },
        "labelCodeProcessMode" : 1,
        "checkingProdInformationResult" : 1,
        "controlCode" : "1",
        "labeledProdFractionalQuantity" : {
          "fractionalPart" : "2343",
          "numerator" : 10,
          "denominator" : 5
        },
        "paymentAgentByProductType" : 1,
        "providerInn" : "7564557689",
        "providerData" : {
          "providerPhone" : [ "+89675645364" ],
          "providerName" : "Самый лучший провайдер"
        },
        "paymentAgentData" : {
          "transferOperatorName" : "Лучший оператор",
          "transferOperatorAddress" : "г. Москва, ул. Добролюбова, д. 11, корп.3",
          "transferOperatorInn" : "1278965432",
          "paymentAgentOperation" : "Оплата",
          "paymentAgentPhone" : [ "+34576543" ],
          "paymentOperatorPhone" : [ "+89675645342" ],
          "transferOperatorPhone" : [ "+89045767585" ]
        },
        "industryReceiptRequisite" : [ {
          "foivId" : "foivId1",
          "documentDate" : "documentDate1",
          "documentNumber" : "documentNumber1",
          "value" : "value1"
        } ]
      } ],
      "property" : "Дополнительный",
      "itemsCount" : 1
    }
  } ]
}

Response fields

Path Type Description

documents[].fiscalDriveNumber

String

Заводской номер фискального накопителя

documents[].transactionDate

String

дата и время проведения транзакции (время кассы локальное)

documents[].transactionType

String

Тип документа

documents[].fiscalSign

String

Фискальный признак документа

documents[].insertedAt

String

Дата и время приема документа ОФД (UTC)

documents[].kkmRegId

String

Регистрационный номер кассы

documents[].fiscalDocumentNumber

Number

Номер документа

documents[].shiftNum

Number

Номер смены

documents[].ticket

Object

Кассовый чек

documents[].ticket.operator

Object

Объект содержит имя кассира и ИНН кассира

documents[].ticket.operator.operatorName

String

Имя кассира

documents[].ticket.operator.operatorInn

String

ИНН кассира

documents[].ticket.buyerPhoneOrAddress

String

Телефон или почтовый адрес покупателя

documents[].ticket.buyerInformation

Object

сведения о покупателе (клиенте)

documents[].ticket.requestNumber

Number

№ чека за смену

documents[].ticket.taxationType

String

Система налогообложения

documents[].ticket.property

String

Значение дополнительного реквизита с учетом особенностей сферы деятельности, в которой осуществляются расчеты

documents[].ticket.taxes

Object

Содержит налоги на весь чек

documents[].ticket.taxes.nds20

Number

Сумма НДС чека по ставке 20%

documents[].ticket.taxes.nds10

Number

Сумма НДС чека по ставке 10%

documents[].ticket.taxes.nds0

Number

Сумма расчетов по чеку с НДС по ставке 0%

documents[].ticket.taxes.ndsNo

Number

Сумма расчета по чеку без НДС

documents[].ticket.taxes.ndsCalculated20

Number

Сумма НДС чека по расч. ставке 20/120

documents[].ticket.taxes.ndsCalculated10

Number

Cумма НДС чека по расч. ставке 10/110

documents[].ticket.operationType

Number

Тип операции: "1" - приход, "2" - возврат прихода, "3" - расход, "4" - возврат расхода

documents[].ticket.totalSum

Number

Итоговая сумма чека

documents[].ticket.cashTotalSum

Number

Сумма чека наличными

documents[].ticket.ecashTotalSum

Number

Сумма чек безналичными

documents[].ticket.prepaymentSum

Number

Сумма чека предоплатой

documents[].ticket.postpaymentSum

Number

Сумма чека постоплатой

documents[].ticket.counterSubmissionSum

Number

Сумма чека встречным представлением

documents[].ticket.userProperty

Object

Дополнительный реквизит пользователя

documents[].ticket.userProperty.key

String

Наименование дополнительного реквизита пользователя

documents[].ticket.userProperty.value

String

Значение дополнительного реквизита пользователя

documents[].ticket.retailPlace

String

Место расчетов

documents[].ticket.items[]

Array

Список товаров или услуг

documents[].ticket.items[].quantity

Number

Количество товара/услуг

documents[].ticket.items[].name

String

Наименование товара/услуги

documents[].ticket.items[].sum

Number

Стоимость товара/услуги

documents[].ticket.items[].price

Number

Стоимость за единицу товара/услуги

documents[].ticket.items[].ndsRate

Number

Ставка НДС

documents[].ticket.items[].ndsSum

Number

Сумма НДС товара/услуги

documents[].ticket.items[].calculationTypeSign

Number

Признак способа расчета

documents[].ticket.items[].calculationSubjectSign

Number

Признак предмета расчета. Расшифровку кодов см. в ФФД, утвержденных ФНС

documents[].ticket.items[].industryReceiptRequisite[]

Array

Отраслевой реквизит предмета расчета (тег 1260)

documents[].ticket.items[].industryReceiptRequisite[].foivId

String

Идентификатор ФОИВ (тег 1262)

documents[].ticket.items[].industryReceiptRequisite[].documentDate

String

Дата документа основания (тег 1263)

documents[].ticket.items[].industryReceiptRequisite[].documentNumber

String

Номер документа основания (тег 1264)

documents[].ticket.items[].industryReceiptRequisite[].value

String

Значение отраслевого реквизита (тег 1265)

documents[].ticket.items[].paymentAgentByProductType

Number

Признак агента по предмету расчета (тег 1222)

documents[].ticket.items[].providerInn

String

ИНН поставщика (тег 1226)

documents[].ticket.items[].providerData

Object

Данные поставщика (тег 1224)

documents[].ticket.items[].providerData.providerPhone

Array

Телефон поставщика (тег 1171)

documents[].ticket.items[].providerData.providerName

String

Наименование поставщика (тег 1225)

documents[].ticket.items[].paymentAgentData

Object

Значения реквизита данные агента (тег 1223)

documents[].ticket.items[].paymentAgentData.transferOperatorName

String

Наименование оператора перевода (тег 1026)

documents[].ticket.items[].paymentAgentData.transferOperatorAddress

String

Адрес оператора перевода (тег 1005)

documents[].ticket.items[].paymentAgentData.transferOperatorInn

String

ИНН оператора перевода (тег 1016)

documents[].ticket.items[].paymentAgentData.paymentAgentOperation

String

Операция платежного агента (тег 1044)

documents[].ticket.items[].paymentAgentData.paymentAgentPhone

Array

Телефон платежного агента (тег 1073)

documents[].ticket.items[].paymentAgentData.paymentOperatorPhone

Array

Телефон оператора по приему платежей (тег 1074)

documents[].ticket.items[].paymentAgentData.transferOperatorPhone

Array

Телефон оператора перевода (тег 1075)

documents[].ticket.items[].productCodeNew

Object

Код товара

documents[].ticket.items[].productCodeNew.undefined

String

Код товара, формат которого не идентифицирован

documents[].ticket.items[].productCodeNew.ean8

String

Код товара в формате EAN-8

documents[].ticket.items[].productCodeNew.ean13

String

Код товара в формате EAN-13

documents[].ticket.items[].productCodeNew.itf14

String

Код товара в формате ITF-14

documents[].ticket.items[].productCodeNew.gs1

String

Код товара в формате GS1, нанесенный на товар, не подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.gs1m

String

Код товара в формате GS1, нанесенный на товар, подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.kmk

String

Код товара в формате короткого кода маркировки, нанесенный на товар, подлежащий маркировке средствами идентификации

documents[].ticket.items[].productCodeNew.mi

String

Контрольноидентификационный знак мехового изделия

documents[].ticket.items[].productCodeNew.egais2

String

Код товара в формате ЕГАИС-2.0

documents[].ticket.items[].productCodeNew.egais3

String

Код товара в формате ЕГАИС-3.0

documents[].ticket.items[].productCodeNew.f1

String

Код товара в формате Ф.1

documents[].ticket.items[].productCodeNew.f2

String

Код товара в формате Ф.2

documents[].ticket.items[].productCodeNew.f3

String

Код товара в формате Ф.3

documents[].ticket.items[].productCodeNew.f4

String

Код товара в формате Ф.4

documents[].ticket.items[].productCodeNew.f5

String

Код товара в формате Ф.5

documents[].ticket.items[].productCodeNew.f6

String

Код товара в формате Ф.6

documents[].ticket.items[].labeledProdFractionalQuantity

Object

Дробное количество маркированного товара

documents[].ticket.items[].labeledProdFractionalQuantity.fractionalPart

String

Дробная часть предмета расчета

documents[].ticket.items[].labeledProdFractionalQuantity.numerator

Number

Числитель дробной части предмета расчета

documents[].ticket.items[].labeledProdFractionalQuantity.denominator

Number

Знаменатель дробной части предмета расчета

documents[].ticket.items[].labelCodeProcessMode

Number

Режим обработки кода маркировки

documents[].ticket.items[].checkingProdInformationResult

Number

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

documents[].ticket.items[].controlCode

String

Контрольный код КМ

documents[].ticket.itemsCount

Object

Количество товарных позиций

documents[].bso

Object

Бланк строгой отчетности

documents[].receiptCorrection

Object

Кассовый чек коррекции

documents[].bsoCorrection

Object

Бланк строгой отчетности коррекции

Curl

$ curl 'https://universal-api-host/api/rent/v2/organisations/123456789333/documents/property?fromDate=2024-12-10T13:34:50.988&toDate=2024-12-11T13:34:50.988&userPropertyKey=MVLM&userPropertyValue=MVIO' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpZCI6IjQyIiwiaWF0IjoxNzMzOTEzMjkxLCJleHAiOjE3MzM5MTM4OTF9.waUzBP9KsNSKcoBc6Bv9hQBVFUTNQI1khI0WqeswLb_o1o0wcDoXyuAr0-iHAeU8Dmdv-zAmy9zCAXWHaI-Lig'