API комплекса ЧекАн (анализ содержания QR в чеках)

API предназначено для получения данных из ФНС посредством комплексного продукта "ЧекАн".
Продукт включает в себя 4 компонента:

Сканер QR-кодов
Модуль взаимодействия с ФНС
Модуль аналитики данных
Модуль антифрода

Каждый из элементов может быть подключен или отключен по желанию Заказчика.

Общее описание обрабатываемых данных из чека

Комплекс предназначен для получения данных о содержании чека.
Информация получается либо через внесение параметров чека в форму ввода, либо по QR-изображению на самом чеке.

Пример чека из открытых источников с QR:
Чек
QR содержит информацию по маске строки:
t=20230320T0956&s=724.19&fn=9960440302172651&i=108108&fp=3168347193&n=1

Методы взаимодействия с системой

Лавка Технологий предоставляет Заказчику токен для взаимодействия и домен/поддомен.
Без токена взаимодействие с системой невозможно.

Методы: POST / GET по выбору Заказчика
Endpoint: https://domen.ru/API_FNS/API_get?time=t&sum=s&fn=fn&fd=i&fp=fp&ot=n&ph=X&tokenLavTech=token

Параметры запроса:

time --> дата и время из чека в формате 20231231T2359 (YYYYMMDDTHHMM)
sum --> общая сумма чека
fn --> фискальный номер
fd --> номер фискального документа
fp --> фискальный признак
ot --> тип операции
ph --> номер телефона, можно оставлять пустым
tokenLavTech --> токен, который выдан представителем ЛавТех

Тип параметров: String, Text

Валидация параметров

В случае ошибки будет выдано сообщение формата:
Errors: t=Error; fp=Error;…
, где будет указана ошибка в зависимости от того, в каких полях допущена ошибка передачи.

Если валидация Лавки Технологий пройдена, то далее будет выдан ответ уже со стороны ФНС.
Либо с содержанием чека в JSON формате, либо с номером ошибки от ФНС.

Правила обработки параметров:

time --> строгий формат YYYYMMDDTHHMM
sum --> целое положительное число или дробное положительное число формата 10.20
fn --> целое положительное число, 16 знаков
fd --> целое положительное число
fp --> целое положительное число
ot --> целое положительное число от 1 до 4
ph --> не валидируется
tokenLavTech --> регистрозависимый набор символов состоящий из латиницы и цифр

Частота запросов и лимиты

Частота запросов (рекомендуемая): <5 запросов в секунду.
Частота запросов (допустимая): 10 запросов в секунду.

Скорость поступления данных: из торгового объекта в ФНС от 20 секунд до 25 дней, в зависимости от настроек кассы.
Скорость поступления данных (средняя по РФ): <5 минут.

Пример положительного JSON ответа в чеке (200 ответ)

{
  "address": "129337,Россия,город федерального значения Москва,муниципальный округ Ярославский вн.тер.г.,,,,Ярославское ш,,д. 54,,,", // адрес объекта, если доступен, string
  "appliedTaxationType": 1, // техническое поле
  "buyerPhoneOrAddress": "s@ya.ru", // техническое поле
  "cashTotalSum": 0, // техническое поле
  "checkingLabeledProdResult": 1, // техническое поле
  "code": 3, // техническое поле
  "creditSum": 0, // техническое поле
  "dateTime": "2025-03-11T16:28:00", // дата и время выдачи чека, string
  "ecashTotalSum": 342211, // техническое поле
  "fiscalDocumentFormatVer": 4, // техническое поле
  "fiscalDocumentNumber": 22745, // Номер фискального документа, number
  "fiscalDriveNumber": "7380420801198237", // Номер фискального накопителя, number
  "fiscalSign": 3070222854, // Номер фискального признака, number
  "fnsUrl": "www.nalog.gov.ru", // техническое поле
  "items": // содержание покупок, array
                [
                { // Пример немаркированной штучной продукции
                  "itemsQuantityMeasure": 0, // техническое поле
                  "name": "Пакет ЛЕНТА 12кг", // Наименование товара, string
                  "nds": 1, // техническое поле
                  "ndsSum": 433, // техническое поле
                  "payMethod": 4, // Тег 1214: признак способа расчета. 1 - предоплата 100%, 2 - предоплата, 3 - аванс, 4 - полный расчет, 5 -частичный расчет и кредит, 6 - передача в кредит, 7 - оплата кредита.
                  "enum": 1, //[ 1, 2, 3, 4, 5, 6, 7 ], number
                  "paymentType": 4, // техническое поле
                  "price": 1299, // Цена за единицу в копейках, number
                  "productType": 1, // техническое поле
                  "quantity": 2, // количество единиц товара, number
                  "sum": 2598 // итоговая стоимость в копейках по позиции, number
                },
                { // Пример немаркированной весовой продукции
                  "itemsQuantityMeasure": 11, // техническое поле
                  "name": "Карась непотр охл вес 1кг", // Наименование товара, string
                  "nds": 2, // техническое поле
                  "ndsSum": 6952, // техническое поле
                  "payMethod": 4, // Тег 1214: признак способа расчета. 1 - предоплата 100%, 2 - предоплата, 3 - аванс, 4 - полный расчет, 5 -частичный расчет и кредит, 6 - передача в кредит, 7 - оплата кредита.
                  "enum": 1, //[ 1, 2, 3, 4, 5, 6, 7 ], number
                  "paymentType": 4, // техническое поле
                  "price": 21999, // Цена за единицу в копейках, number
                  "productType": 1, // техническое поле
                   "quantity": 3.476, // вес товара
                  "sum": 76469 // итоговая стоимость в копейках по позиции, number
                },
                { // Пример маркированной продукции
                  "checkingProdInformationResult": 15, // техническое поле
                  "itemsIndustryDetails":
                                                           [
                                                           {
                                                           "foundationDocDateTime": "21.11.2023", // техническое поле
                                                           "foundationDocNumber": "1944", // техническое поле
                                                           "idFoiv": "030", // техническое поле
                                                           "industryPropValue": "UUID=2dbf676b-e699-4851-a0ed-5950d3bef73b&Time=1742650010370" // техническое поле
                                                           }
                                                           ],
                  "itemsQuantityMeasure": 0, // техническое поле
                  "labelCodeProcesMode": 0, // техническое поле
                  "name": "Мороженое ЛЕНТА Пломбир 400г", // Наименование товара, string
                  "nds": 2, // техническое поле
                  "ndsSum": 2173, // техническое поле
                   "payMethod": 4, // Тег 1214: признак способа расчета. 1 - предоплата 100%, 2 - предоплата, 3 - аванс, 4 - полный расчет, 5 -частичный расчет и кредит, 6 - передача в кредит, 7 - оплата кредита.
                  "enum": 1, //[ 1, 2, 3, 4, 5, 6, 7 ], number
                  "paymentType": 4, // техническое поле
                  "price": 23899, // Цена за единицу в копейках, number
                  "productCodeNew":
                                                    {
                                                    "gs1m":
                                                    {
                  "gtin": "04606068022457", // GTIN товара, string
                  "productIdType": 6, // техническое поле
                  "rawProductCode": "0104606068022457215MxM0'", // Серийный номер товара, string
                  "sernum": "5MxM0'" // Серийный номер товара, string
                }
                },
                  "productType": 33, // техническое поле
                  "quantity": 1, // количество единиц или вес товара
                  "sum": 23899 // итоговая стоимость в копейках по позиции, number
                }
                ]
  "kktRegId" : "0000375733042284 ", // техническое поле
  "messageFiscalSign" : 9297366742949368753, // техническое поле
  "nds10" : 27829, // Сумма НДС по ставке 10%, number
  "nds18" : 6516, // Сумма НДС по ставке 20% с 1 января 2019 или по ставке 18% до 1 января 2019, number
  "numberKkt" : "0128019262", // техническое поле
  "ofdId" : "ofd5", // ID Оператора Фискальных Данных, string
  "ofdInn" : "7704211201", // ИНН Оператора Фискальных Данных, string
  "operationType" : 1, // "Признак расчета: 1 - приход, 2 - возврат прихода, 3 - расход, 4 - возврат расхода", number
  "operator" : "- Иванова", // кассир-оператор, если доступен, string
  "prepaidSum" : 0, // техническое поле
  "properties" : // информация о кассовом узле
                         {
                           "propertyName" : "касса №123", // наименование кассового узла, если доступен, string
                           "propertyValue" : "13" // кассовый узел, если доступен
                         },
  "provisionSum" : 0, // техническое поле
  "redefine_mask" : 0, // техническое поле
  "region" : "77", // регион активности, если доступен, если доступен
  "requestNumber" : 170, // номер чека, number
  "retailPlace" : "ТК Лента-304", // флаг объекта, если доступен, string
  "retailPlaceAddress" : "Россия, 129337, г. Москва, Ярославское ш., д. 54", // адрес объекта, если доступен, string
  "sellerAddress" : "check@taxcom.ru", // техническое поле
  "shiftNumber" : 101, // номер смены, number
  "totalSum" : 345211, // итоговая сумма чека, number
  "user" : "ООО \"Лента\"", // Наименование организации, выдавшей чек, string
  "userInn" : "7814148471" // ИНН организации, выдавшей чек, если доступен, string
}