Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Название

Значение

billnumber

Идентификатор операции в системе

или


Payment_ID

Идентификатор внешней операции

fiscalreceipt_ID

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

receipttype

Тип чека

status

Статус чека:

  • New – чек подготовлен к формированию;
  • Successфискальный чек успешно создан, возвращаются все полученные фискальные данные вместе с позициями чека;
  • CreateError - при создании чека возникла ошибка, возвращаются только позиции чека и статус чека, остальные поля остаются пустыми.

chequeItems

Строка с позициями чека в JSON формате согласно документу «Работа «Работа с чеком»чеком».

fiscal_receipt_number

Номер чека в смене

shift_number

Номер смены

receipt_datetime

Дата и время документа из ФН

total

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

fn_number

Номер ФН

ecr_registration_number

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

fiscal_document_number

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

fiscal_document_attribute

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

errortext

Текст ошибки

taxationsystem

Код системы налогообложения

merchant_name*Название торгового предприятия
merchant_INN*ИНН торгового предприятия
calc_type*Признак расчета
payment_types*Форма расчета
tax_items*Суммы налога по ставкам
cashier*Кассир
calc_adr*Адрес места расчетов
calc_dsc*Место расчета
fris_site*Адрес сайта ФНС
sale_email*Email отправителя чека

url

Адрес чека во внешнем хранилище.

...

Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует проверить текст ошибки, полученный в поле errortext, а также убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), затем повторно направить скорректированный запрос на получение фискального чека на используемый сервисфискализацию с помощью используемого сервиса.

Warning
titleВнимание!

Если в ответе на запрос данных фискального чека в течение длительного времени (несколько часов) по-прежнему приходит статус New (особенно в том случае, когда поле errortext ответа не пустое), следует обратиться в службу технической поддержки support@assist.ru.

Примеры ошибок, которые могут быть получены в поле errortext:

ID ошибкиСодержимое поля errortext
19602

Ошибка в заполнении предмета расчета.

19521

Не получен статус фискального чека.

19519

Неправильные значения сумм по способам оплаты.

19511

Ошибка в описании позиций чека.

19508 Ошибка в сумме позиции или сумме чека.
19507

Ошибка в заполнении способа расчета.

19506

Ошибка в параметре системы налогообложения.

19504

Ошибка при работе с чеком.

19503

Ошибка регистрации ККТ.

19502

Ошибка при работе со сменами.

19501

Аппаратная ошибка ККТ или ФН.

8215

Неизвестный ответ процессинга.

8006

Ошибка связи с процессинговым центром.

1850

Некорректное значение ставки налога.

868

Сбой в системе.

862

Неверный тип данных.

615

Идентификатор (id) позиции чека не является уникальным.

456

Неверный терминал.

155

Отсутствует терминал.

151

Ошибка формата ввода данных или незаполненное поле.

Anchor
1
1

Получение нескольких чеков при пакетной фискализации

...

Название

Значение

fiscalreceipt_ID

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

fiscal_document_attribute

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

fiscal_document_number

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

created

Дата и время создания чека

chequeItems

Строка с позициями чека в JSON формате согласно документу «Работа с чеком».

Fn_number

Номер ФН

receipttype

Тип чека

status

Статус чека:

  • NEW New – чек подготовлен к формированию;
  • SUCCESSSuccess если фискальный чек успешно создан, возвращаются все полученные фискальные данные вместе с позициями чека;
  • CREATEERROR – если CreateError - при создании чека возникла ошибка возвращаются только позиции чека и статус чека, остальные поля остаются пустымиERROR – если при фискализации возникла ошибка возвращаются только позиции чека и статус чека, остальные поля остаются пустыми.

url

Адрес чека во внешнем хранилище

shift_number

Номер смены

errortext*

Текст ошибки или ID ошибки

payment_id

Идентификатор внешней операции

ecr_registration_number

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

total

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

receipt_datetime

Дата и время документа из ФН

fiscal_receipt_number

Номер чека в смене

billnumber

Идентификатор операции в системе

taxationsystem

Код системы налогообложения

operation

Название операции (sell – оплата, refund – отмена)

taxsystemname

Название системы налогообложения

*Текст ошибки возвращается в том в случае, если в запросе был передан параметр Billnumber, в противном случае возвращается ID ошибки.

ID ошибкиТекст ошибки
0Успешно завершено
8248Неизвестная ошибка
19501Аппаратная ошибка ККТ или ФН
19502Ошибки при работе со сменами
19503Ошибки регистрации
19504Ошибка при работе с чеком
19521Не получен статус фискального чека

Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует проверить текст ошибки, полученный в поле errortext, или ID полученной ошибки, а также убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), затем повторно направить скорректированный запрос на фискализацию с помощью используемого сервиса.

Если запрос на получение фискального чека не может быть обработан, в результате запроса вернутся ненулевые значения параметров firstcode, secondcode.

Пример запроса по параметрам параметрам login и password:

Code Block
languagexml
{ 
    "merchant":{
        "merchant_ID":12345677,
        "login":"user",
        "password":"password"
    }, 
    "billnumber":"123445678899012.1",
    },

...