Новый метод, который получает на вход параметры для фискализации документа с последующей финансовой операции(оплата/возврат/отмена/холдирование) передает их в сервис фискализации.
Логика фискализации асинхронная, отправка данных методом и успешное получение идентификатора транзакции не является финальным завершением операции пробития чека. Для завершения операции необходимо настроить корректную обработку Callback ответов и настроить получение данных по чеку через методы О фискализации .
После завершения пробития чека на кассе (успешное или неуспешное), будет отправлен ответ методом POST на URL-адрес.
Отличие от Создание задания на фискализацию без финансовой операции в том, что фискализация запустится только после успешного завершения финансовой операции
POST |
Основные параметры:
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| Request-Id | guid | да | Идентификатор конкретного запроса. |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
ism_optional | boolean | нет | + | Параметр указывает сервису, должен ли чек регистрироваться в случае, если не удалось проверить код маркировки вследствие недоступности системы маркировки (ИСМ). Поведение сервиса в зависимости от значения параметра:
| - |
receipt | object | условно
| + | Чек | - |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
client | object | да | + | Cведения о покупателе (клиенте) См. Описание объекта receipt.client | - |
company | object | да | + | См. Описание объекта receipt.company | - |
items | array of objects | да | + | Заполняется для каждого добавленного товара. См. Описание объекта receipt.items | - |
payments | array of objects | да | + | Оплаты. Ограничение по количеству от 1 до 10. См. Описание объекта receipt.payments | - |
vats | array of objects | нет | + | Атрибуты налогов на чек. Ограничение по количеству от 1 до 10. Необходимо передать либо сумму налога на позицию, либо сумму налога на чек. Если будут переданы и сумма налога на позицию, и сумма налога на чек, сервис учтет только сумму налога на чек. См. Описание объекта receipt.vats | - |
cashier | string | нет |
+ | ФИО кассира. Максимальная длина строки – 64 символа. Если значение не будет передано, то сервис подставит значение по умолчанию для кассы. | 1021 |
cashier_inn | string | нет | + | ИНН кассира. Ровно 12 цифр | 1203 |
additional_check_props | string | нет | + | Дополнительный реквизит чека. Максимальная длина строки – 16 символов. | 1192 |
total | number | да | + | Итоговая сумма чека в рублях с заданным в CMS округлением:
Значение вычисляется, как сумма всех значений реквизита «стоимость предмета расчета с учетом скидок и наценок» (тег 1043) | 1020 |
additional_user_props | object | нет | + | Дополнительный реквизит пользователя. См. Описание объекта receipt.additional_user_props | 1084 |
agent_info |
object | нет |
- | Атрибуты агента. См. Описание объекта receipt.agent_info | - |
supplier_info |
object | нет |
- | Атрибуты поставщика. См. Описание объекта receipt.supplier_info | - |
operating_check_props | object | нет | + | Условия применения и значение реквизита «операционный реквизит чека» (тег 1270) определяются ФНС России. См. Описание объекта receipt.operating_check_props | 1270 операционный реквизит чека |
sectoral_check_props | array of objects | нет | + | Включается в состав кассового чека (БСО) в случае, если включение этого отраслевого реквизита кассового чека предусмотрено законодательством Российской Федерации. См. Описание элемента массива объектов receipt.sectoral_check_props и receipt.sectoral_item_props | 1261 отраслевой реквизит чека |
internet | boolean | нет | + | Признак применения ККТ при осуществлении расчета в безналичном порядке в сети «Интернет» Принимает значения: true/false Если данный реквизит принимает значение true, то «Телефон или электронный адрес покупателя» (тег 1008) и «Место расчетов» (тег 1187) являются обязательными. Если данный реквизит не будет передан в запросе, то сервис подставит значение по умолчанию по следующей логике:
| 1125 Признак расчета в "Интернет" |
cashless_paym ents | array of objects | нет | + | Cведения об оплате в безналичном порядке суммы расчета, указанной в кассовом чеке (БСО), способом, признак которого указан в этом реквизите См. Описание объекта receipt.cashless_payments | 1235 Сведения об оплате безналичными |
timezone | number | нет | + | Номер часовой зоны места (адреса) осуществления расчетов в соответствии с законодательством Российской Федерации Целое число от 1 до 11 Примечание: номер часовой зоны определяется по часовому поясу, указанному для группы касс в личном кабинете. Передавать данный параметр в запросе на фискализацию не нужно. | 1011 Часовая зона |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
string | В запросе обязательно должно быть заполнено хотя бы одно из полей: email или phone. Ecли заполнены оба поля, ОФД отправит электронный чек только на email. | + | Электронный адрес покупателя До 64 символов. Маска: {С}@{С} или значение “none“ | 1008 Телефон или электронный адрес покупателя | |
phone | string | нет | + | Телефон покупателя Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (пример: «+79251234567»). Максимальная длина - 19 символов. Если номер содержит префикс «+7», то значение можно передать без префикса (пример: номер «+79251234567» можно передать как «9251234567»). Максимальная длина строки в таком случае – 17 символов. Маски: +{Ц} или значение “none“ | |
name | string | нет | + | Наименование покупателя (клиента). Максимальная длина строки – 256 символов. | 1227 Наименование организации или фамилия, имя, отчество (при наличии), серия и номер паспорта покупателя (клиента) |
inn | string | нет | + | ИНН покупателя (клиента). Допустимое количество символов - 10 или 12, только цифры. | 1228 |
birthdate | string | нет | + | Дата рождения покупателя (клиента) в формате ДД.ММ.ГГГГ (ровно 10 символов) | 1243 |
citizenship | string | нет | + | Числовой код страны, гражданином которой является покупатель (клиент). Код страны указывается в соответствии с Общероссийским классификатором стран мира ОКСМ. Ровно 3 цифры | 1244 гражданство |
document_code | string | нет | + | Числовой код вида документа, удостоверяющего личность. Может принимать только значения из справочника. См. Приложение 2 – Значения реквизита «код вида документа, удостоверяющего личность» (тег 1245) Ровно 2 цифры | 1245 код вида документа, удостоверяющего личность |
document_data | string | ФФД 1.05 – нет ФФД 1.2 – нет | + | Реквизиты документа, удостоверяющего личность. Максимум 64 символа | 1246 данные документа, удостоверяющего личность |
address | string | + | Адрес покупателя (клиента), грузополучателя. Максимум 256 символов | 1254 адрес покупателя (клиента) |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
string | да | + | Электронная почта отправителя чека. При передаче ОФД кассового чека (БСО), кассового чека коррекции (БСО коррекции) покупателю (клиенту) в электронной форме указывается адрес электронной почты ОФД Максимальная длина строки – 64 символа. Маска: {С}@{С} или значение “none“ | 1117 Адрес электронной почты отправителя чека | |
sno | enum (string) | да | + | Система налогообложения. Должно принимать одно из значений:
Если значение не будет передано, то сервис подставит значение по умолчанию для кассы. | 1055 Применяемая система налогообложения |
inn | string | да | + | ИНН организации. Используется для предотвращения ошибочных регистраций чеков на ККТ зарегистрированных с другим ИНН (сравнивается со значением в ФН). Допустимое количество символов 10 или 12. | 1018 ИНН пользователя |
payment_address | string | да | + | Место расчетов. Максимальная длина строки – 256 символов. Реквизит "Место расчетов" (тег 1187) должен содержать адрес сайта в сети "Интернет", если в чеке передается реквизит «Признак расчета в "Интернет"» (1125) = true. Если к кассе привязано несколько интернет-магазинов, то в чеке можно передавать любой из них (только для кабинета интернет магазина). | 1187 Место расчетов |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
name | string | да | + | Наименование товара, работы, услуги, платежа, выплаты, иного предмета расчета. Максимальная длина строки – 128 символов. | 1030 Наименование предмета расчета |
price | number | да | + | Цена за единицу товара, работы, услуги, платежа, выплаты, иного предмета расчета с учетом скидок и наценок Цена в рублях:
При этом произведение цены и количество/веса (price*quantity) позиции должно быть не больше максимального значения цены позиции. | 1079 цена за единицу предмета расчета с учетом скидок и наценок |
quantity | enum (number) | да | + | Количество/вес:
Максимальное значение – 99 999.999 | 1023 Количество предмета расчета |
measure | enum (number) | да | + | Единицы измерения количества предмета расчета.
Может принимать одно из значений:
| 2108 Мера количества предмета расчета |
measurement_u nit | string | нет | - | Единица измерения товара, работы, услуги, платежа, выплаты, иного предмета расчета. Максимальная длина строки – 16 символов. | 1197 |
sum | number | да | + | Сумма в рублях:
Значение реквизита «стоимость предмета расчета с учетом скидок и наценок» (тег 1043) должно быть равно произведению значения реквизита «цена за единицу предмета расчета с учетом скидок и наценок» (тег 1079), умноженному на значение реквизита «количество предмета расчета» (тег 1023). | 1043 Стоимость предмета расчета с учетом скидок и наценок |
nomenclature_ code | string | нет | - | Код товара в шестнадцатеричном представлении с пробелами. Максимальная длина – 32 байта. base64 Пример: 00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00 | 1162 Код товарной номенклатуры (Код товара) |
product_code | string | нет | - | Строка, содержащая исходный кодированный массив, полученный со сканера штрих кода (без обработки). Используется, только если nomenclatureCode равен null или отсутствует. Пример: 136222000058810918QWERDFEWT5123456YGHFDSWERT56YUIJHGFD SAERTYUIOKJ8HGFVCXZSDLKJHGFDSAOIPLMNBGHJYTRDFGHJKI REWSDFGHJIOIUTDWQASDFRETYUIUYGTREDFGHUYTREWQWE | 1162 Код товарной номенклатуры (Код товара) |
payment_meth od | enum (string) | да | + | Признак способа расчёта. Возможные значения:
| 1214 Признак способа расчета |
payment_objec t | enum (string) | да | + | По ФФД 1.2: Должен принимать одно из значений:
| 1212 Признак предмета расчета |
vat | object | да | + | Атрибуты налога на позицию. См. Описание объекта receipt.items.vat | - |
user_data | string | нет | + | Дополнительный реквизит предмета расчета. Максимальная длина строки – 64 символа. | 1191 |
excise | number | нет | + | Сумма акциза в рублях
| 1229 Сумма акциза с учетом копеек, включенная в стоимость предмета расчета |
country_code | string | нет | + | Цифровой код страны происхождения товара ровно 3 цифры Если переданный код страны происхождения имеет длину меньше 3 цифр, то он дополняется справа пробелами | 1230 Цифровой код страны происхождения товара в соответствии с Общероссийским классификатором стран мира |
declaration_nu mber | string | нет | + | Номер таможенной декларации Максимум 32 символа | 1231 |
mark_quantity | object | нет | + | Дробное количество маркированного товара
Реквизит «дробное количество маркированного товара» (тег 1291) включается в состав реквизита «предмет расчета» (тег 1059) только в случае, если расчет осуществляется за маркированный товар и значение реквизита «мера количества предмета расчета» (тег 2108) принимает значение равное «0». См. Описание объекта receipt.items.mark_quantity | 1291 Дробное количество маркированного товара |
mark_processing_mode | string | нет | + | Включается в чек в случае, если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации. Должен принимать значение равное «0». | 2102 Режим обработки кода маркировки |
sectoral_item_p rops | array of objects | нет | + | Отраслевой реквизит предмета расчета
Необходимо указывать, если в составе реквизита «предмет расчета» (тег 1059) содержатся сведения о товаре, подлежащем обязательной маркировке средством идентификации и включение указанного реквизита предусмотрено НПА отраслевого регулирования для соответствующей товарной группы. См. Описание объекта receipt.items.sectoral_check_props и receipt.items.sectoral_item_props | 1260 Отраслевой реквизит предмета расчета |
mark_code | object | нет | + | Код товара Включается в чек в случае, если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации. См. Описание объекта receipt.items.mark_code | 1163 Код товара |
agent_info | object | нет | + | Атрибуты агента. См. Описание объекта receipt.items.agent_info | - |
supplier_info | object | Поле обязательно, если передан «agent_info». | + | Атрибуты поставщика. См. Описание объекта receipt.items.supplier_info | - |
planned_status | number | нет | + | Планируемое изменение статуса товара, подлежащего обязательной маркировке средством идентификации. Обязателен в чеке, если предметом расчета является товар, подлежащий обязательной маркировке средством идентификации.
Возможные значения:
Если реквизит не будет передан, то сервис подставит значение по следующему правилу:
| 2003 Планируемый статус товара |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
type | enum (string) | да | + | Ставка НДС Устанавливает номер налога в ККТ. Перечисление со значениями:
| 1199 Ставка НДС |
sum | number | нет |
+ | Сумма налога позиции в рублях:
| 1200 Сумма НДС за предмет расчета |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
numerator | integer | поле обязательно, если передан «mark_quantity» | + | Числитель дробной части предмета расчета. Значение реквизита «числитель» (тег 1293) должно быть строго меньше значения реквизита «знаменатель» (тег 1294) не может равняться «0» | 1293 числитель |
denominator | integer | поле обязательно, если передан «mark_quantity» | + | Знаменатель дробной части предмета расчета Заполняется значением, равным количеству товара в партии (упаковке), имеющей общий код маркировки товара. не может равняться «0» | 1294 знаменатель |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
unknown | string | нет | + | Код товара, формат которого не идентифицирован, как один из реквизитов. Максимум 32 символа. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1300 нераспознанный код товара |
ean8 | string | нет | + | Код товара в формате EAN-8. Ровно 8 цифр. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1301 КТ EAN-8 |
ean13 | string | нет | + | Код товара в формате EAN-13. Ровно 13 цифр. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1302 КТ EAN-13 |
itf14 | string | нет | + | Код товара в формате ITF-14. Ровно 14 цифр. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1303 КТ ITF-14 |
gs10 | string | нет | + | Код товара в формате GS1, нанесенный на товар, не подлежащий маркировке средствами идентификации. Максимум 38 символов. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1304 КТ GS1.0 |
gs1m | string | нет | + | Код товара в формате GS1, нанесенный на товар, подлежащий маркировке средствами идентификации. Максимум 200 символов. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) Примечание: Код товара необходимо передавать целиком. В связи с тем, что в коде товара могут быть непечатные символы, необходимо перед отправкой кодировать строку с кодом товара в Base64. | 1305 КТ GS1.М |
short | string | нет | + | Код товара в формате короткого кода маркировки, нанесенный на товар, подлежащий маркировке средствами идентификации. Максимум 38 символов. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1306 КТ КМК |
fur | string | нет | + | Контрольно-идентификационный знак мехового изделия. Ровно 20 символов, должно соответствовать маске СС-ЦЦЦЦЦЦ- СССССССССС Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1307 КТ МИ |
egais20 | string | нет | + | Код товара в формате ЕГАИС-2.0. Ровно 23 символа. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1308 КТ ЕГАИС- 2.0 |
egais30 | string | нет | + | Код товара в формате ЕГАИС-3.0. Ровно 14 символов. Значения реквизита должно формироваться в соответствии с правилами, указанными в Приложении № 2 к приказу ФНС России от 14.09.2020г. № ЕД-7- 20/662@ (Таблица 118) | 1309 КТ ЕГАИС- 3.0 |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
type | enum (string) | да | + | Признак агента по предмету расчёта (ограничен агентами, введенными в ККТ при фискализации). Возможные значения:
| 1222 Признак агента по предмету расчета |
paying_agent | object | нет | + | Атрибуты платежного агента. См. Описание объекта receipt.items.agent_info.paying_agent | - |
receive_payments_operator | object | нет | + | Атрибуты оператора по приему платежей. См. Описание объекта receipt.items.agent_info.receive_payments_operator | - |
money_transfer_operator | object | нет | + | Атрибуты оператора перевода. См. Описание объекта receipt.items.agent_info.money_transfer_operator | - |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
operation | string | нет | + | Наименование операции банковского платежного агента, банковского платежного субагента. Максимальная длина строки – 24 символа. | 1044 Операция банковского платежного агента |
phones | array of strings | нет | + | Номера телефонов платежного агента, платежного субагента, банковского платежного агента, банковского платежного субагента. Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (пример: «+79251234567»). Максимальная длина - 19 символов. Если номер содержит префикс «+7», то значение можно передать без префикса (пример: номер «+79251234567» можно передать как «9251234567»). Максимальная длина строки в таком случае – 17 символов. | 1073 Телефон платежного агента |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
phones | array of strings | нет | + | Номера контактных телефонов оператора по приему платежей. Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (пример: «+79251234567»). Максимальная длина - 19 символов. Если номер содержит префикс «+7», то значение можно передать без префикса (пример: номер «+79251234567» можно передать как «9251234567»). Максимальная длина строки в таком случае – 17 символов. | 1074 Телефон оператора по приему платежей |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
phones | array of strings | нет | + | Номера телефонов оператора по переводу денежных средств Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (пример: «+79251234567»). Максимальная длина - 19 символов. Если номер содержит префикс «+7», то значение можно передать без префикса (пример: номер «+79251234567» можно передать как «9251234567»). Максимальная длина строки в таком случае – 17 символов. | 1075 Телефон оператора перевода |
name | string | нет | + | Наименование оператора перевода. Максимум 64 символа | 1026 Наименование оператора перевода |
address | string | нет | + | Место нахождения оператора по переводу денежных средств Максимум 256 символов | 1005 Адрес оператора перевода |
inn | string | нет | + | ИНН оператора перевода. 10 или 12 цифр | 1016 ИНН оператора перевода |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
phones | array of strings | да, если в чеке передано значение agent_info.type (Признак агента по предмету расчёта): - bank_paying_agent; - bank_paying_subagent; - paying_agent; - paying_subagent. | + | Телефоны поставщика. Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (пример: «+79251234567»). Максимальная длина - 19 символов. Если номер содержит префикс «+7», то значение можно передать без префикса (пример: номер «+79251234567» можно передать как «9251234567»). Максимальная длина строки в таком случае – 17 символов. | 1171 Телефон поставщика |
name | string | да, если в чеке передано значение agent_info.type (Признак агента по предмету расчёта): - bank_paying_agent; - bank_paying_subagent; - paying_agent; - paying_subagent. | + | Наименование поставщика. Максимум 256 символов | 1225 Наименование поставщика |
inn | string | да | + | ИНН поставщика. 10 или 12 цифр Данный реквизит принимает значение «000000000000» в случае, если поставщику не присвоен ИНН на территории Российской Федерации | 1226 ИНН поставщика |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
type | enum (string) | да | + | Вид оплаты. Возможные значения:
| 1031 сумма по чеку (БСО) наличными (только ФФД 1.2) 1081 сумма по чеку (БСО) безналичными 1215 сумма по чеку (БСО) предоплатой (зачетом аванса и (или) предыдущих платежей) 1216 сумма по чеку (БСО) постоплатой (в кредит) 1217 сумма по чеку (БСО) встречным предоставлением |
sum | number | да | + | Сумма к оплате в рублях:
| - |
Название поля | Тип поля | Обязательность | ФФД1.2 | Ограничения | Тег ФФД |
sum | number | да, если передан «cashless_payments» | + | Сумма оплаты безналичными:
| 1082 Сумма оплаты безналичными |
method | number | да, если передан «cashless_payments» | + | Признак способа оплаты безналичными. Значение реквизита определяется в порядке, установленном ФНС России | 1236 Признак способа оплаты безналичными |
id | string | да, если передан «cashless_payments» | + | Идентификаторы безналичной оплаты Максимум 256 символов Значение реквизита определяется в порядке, установленном ФНС России | 1237 Идентификаторы безналичной оплаты |
additional_info | string | нет | + | Дополнительные сведения о безналичной оплате. Максимум 256 символов Значение реквизита определяется в порядке, установленном ФНС России | 1238 дополнительные сведения о безналичной оплате |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
type | enum (string) | да | + | Устанавливает номер налога в ККТ. Перечисление со значениями:
| 1102 Сумма НДС чека по ставке 20% 1103 Сумма НДС чека по ставке 10% 1104 Сумма расчета по чеку с НДС по ставке 0% 1105 Сумма расчета по чеку без НДС 1106 Сумма НДС чека по расч. ставке 20/120 1107 Сумма НДС чека по расч. ставке 10/110 1115 Cуммы НДС чека (1119 сумма НДС чека) |
sum | number | нет | + | Сумма налога позиции в рублях: целая часть не более 8 знаков; дробная часть не более 2 знаков. | По ФФД 1.05 - нет По ФФД 1.2: 1200 |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
name | string | да | + | Наименование дополнительного реквизита пользователя. Максимальная длина строки – 64 символа. | 1085 Наименование дополнительного реквизита пользователя |
value | string | да | + | Значение дополнительного реквизита пользователя. Максимальная длина строки – 256 символов. | 1086 Значение дополнительного реквизита пользователя |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
type | enum (string) | нет | - | Признак агента по предмету расчёта (ограничен агентами, введенными в ККТ при фискализации). Возможные значения:
| 1057 Признак агента |
paying_agent | object | нет | - | Атрибуты платежного агента. См. Описание объекта аналогично receipt.items.agent_info.paying_agent | - |
receive_paym en ts_operator | object | нет | - | Атрибуты оператора по приему платежей. См. Описание объекта аналогично receipt.items.agent_info.receive_payments_operator | - |
money_transfer _operator | object | нет | - | Атрибуты оператора перевода. См. Описание объекта аналогично receipt.items.agent_info.receive_payments_operator | - |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
phones | array of strings | нет | - | Телефоны поставщика. Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (пример: «+79251234567»). Максимальная длина - 19 символов. Если номер содержит префикс «+7», то значение можно передать без префикса (пример: номер «+79251234567» можно передать как «9251234567»). Максимальная длина строки в таком случае – 17 символов. | 1171 Телефон поставщика |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
name | string | да | + | Идентификатор операции Принимает значения «0» до определения значения реквизита ФНС России. | 1271 Идентификатор операции |
value | string | да | + | Данные операции Максимальная длина строки – 64 символа. | 1272 Данные операции |
timestamp | string | да | + | Дата и время операции в формате: «dd.mm.yyyy HH:MM:SS»
| 1273 Дата, время операции |
Название поля | Тип поля | Обязательность | ФФД 1.2 | Ограничения | Тег ФФД |
federal_id | enum (string) | да | + | Идентификатор ФОИВ. Должно принимать одно из значений справочника. См. Приложение 1 – Значения реквизита «идентификатор ФОИВ» (тег 1262) | 1262 Идентификатор ФОИВ |
date | string | да | + | Дата нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1265) Значение в формате в формате ДД.ММ.ГГГГ | 1263 Дата документа основания |
number | string | да | + | Номер нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1265) Максимум 32 символа. | 1264 Номер документа основания |
value | string | да | + | Состав значений, определенных нормативным актом федерального органа исполнительной власти Максимум 256 символов. | 1265 Значение отраслевого реквизита |
Content-Type: application/json; charset=utf-8 |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
receiptId | int64 | да | Идентификатор квитанции |
POST |
{
"receipt": {
"client": {
"email": "kkt@kkt.ru"
},
"company": {
"email": "chek@romashka.ru",
"sno": "osn",
"inn": "1234567891",
"payment_address": "http://magazin.ru/"
},
"items": [
{
"name": "колбасаКлинскийБрауншвейгскаяс/кв/с",
"price": 1000.0,
"quantity": 0.3,
"sum": 300.0,
"measurement_unit": "кг",
"payment_method": "full_payment",
"payment_object": "commodity",
"vat": {
"type": "none"
}
},
{
"name": "яйцоОкскоекуриноебелое",
"price": 100.0,
"quantity": 1.0,
"sum": 100.0,
"measurement_unit": "Упаковка10шт.",
"payment_method": "full_payment",
"payment_object": "commodity",
"vat": {
"type": "vat10"
}
},
{
"name": "яйцоОкскоекуриноебелое",
"price": 100.0,
"quantity": 1.0,
"sum": 100.0,
"measurement_unit": "Упаковка10шт.",
"payment_method": "full_payment",
"payment_object": "commodity",
"vat": {
"type": "vat107"
}
}
],
"payments": [
{
"type": 1,
"sum": 500.0
}
],
"vats": [
{
"type": "none",
"sum": 0
},
{
"type": "vat10",
"sum": 9.09
},
{
"type": "vat107",
"sum": 6.54
}
],
"total": 500.0
}
}
Content-Type: application/json; charset=utf-8 |
{
"receiptId": "21977"
}
Описание ответного сообщения в продакшн.
Коды и описание представлено в таблице:
| 00299998 | Validation error | Не пройдена валидация данных | нет | да | в modelState указывается список полей с некорректным типом данных или отсутствующими обязательными полями |
| 00299999 | An unexpected error has occurred | Непредвиденная ошибка | да | да |