Веб-сервис получения фискального чека позволяет предприятию получить сгенерированный в АПК Ассист фискальный чек. Такая возможность используется, например, в тех случаях, когда предприятие самостоятельно отправляет электронные копии чеков своим покупателям.

Для обращения к веб сервису необходимо отправить запрос методом POST/SOAP на сервер ASSIST по адресу: https://<SERVER_NAME>/fiscal/fiscalreceipt.cfm.

Входные параметры сервиса:

Параметр

Обязательный

Принимаемые значения

Значение по умолчанию

Описание

Merchant_ID

Да

Число


Идентификатор предприятия в системе АПК Ассист

Login

Да

20 символов


Логин пользователя сервиса от предприятия

Password

Да

30 символов


Пароль пользователя сервиса от предприятия

BillNumber

Да*

15 или 16 цифр

Расширенный формат


Номер операции, в системе АПК Ассист, по которой запрашивается чек

Fiscalreceipt_ID

Да*

Число


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

Format

Нет

Число

1

Формат возвращаемого ответа (1-CSV, 2-WDDX, 3-XML, 4-SOAP, 5-JSON)

*должен быть передан либо параметр Billnumber (тогда в ответе будет возвращен чек реальной операции), либо параметр Fiscalreceipt_ID (тогда в ответе будет возвращен чек внешней операции, созданный через веб-сервис фискализации внешних операций), оба параметра одновременно передавать нельзя.

Перечень возвращаемых параметров:

Название

Значение

billnumber

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

или

fiscalreceipt_ID

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

status

Статус чека:

  • IN_PROGRESS – если чек по операции еще не создан, возвращаются только позиции чека и статус чека, остальные поля остаются пустыми;
  • SUCCESS – если чек успешно создан, возвращаются все полученные фискальные данные вместе с позициями чека;
  • ERROR – если при создании чека возникла ошибка возвращаются только позиции чека и статус чека, остальные поля остаются пустыми.

chequeItems

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

fiscal_receipt_number

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

hift_number

Номер смены

receipt_datetime

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

total

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

fn_number

Номер ФН

ecr_registration_number

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

fiscal_document_number

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

fiscal_document_attribute

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