Веб-сервис получения фискального чека позволяет предприятию получить сгенерированный в АПК Ассист фискальный чек. Такая возможность используется, например, в тех случаях, когда предприятие самостоятельно отправляет электронные копии чеков своим покупателям.
Для обращения к веб сервису необходимо отправить запрос методом POST/SOAP на сервер ASSIST по адресу: https://<SERVER_NAME>/fiscal/fiscalreceipt.cfm.
Входные параметры сервиса:
Параметр | Обязательный | Принимаемые значения | Значение по умолчанию | Описание |
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | |
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | |
BillNumber | Да* | 15 или 16 цифр Расширенный формат | Номер операции, в системе АПК Ассист, по которой запрашивается чек | |
Payment_ID | Нет | 255 символов | Идентификатор операции в системе предприятия | |
Fiscalreceipt_ID | Да* | Число | Идентификатор чека | |
Format | Нет | Число | 1 | Формат возвращаемого ответа (1-CSV, 2-WDDX, 3-XML, 4-SOAP, 5-JSON) |
*должен быть передан либо параметр Billnumber (тогда в ответе будет возвращен чек реальной операции), либо параметр Payment_ID (тогда в ответе будет возвращен чек внешней операции, созданный через веб-сервис фискализации внешних операций fiscalize), либо Fiscalreceipt_ID (если он известен), несколько параметров одновременно передавать нельзя.
Если фискальный чек для указанной в запросе операции существует, то в ответе передаются параметры этого фискального чека (см. табл. «Перечень возвращаемых параметров»).
Перечень возвращаемых параметров:
Название | Значение |
billnumber | Идентификатор операции в системе |
или | |
fiscalreceipt_ID | Идентификатор чека |
status | Статус чека:
|
chequeItems | Строка с позициями чека в JSON формате согласно документу «Работа с чеком». |
fiscal_receipt_number | Номер чека в смене |
hift_number | Номер смены |
receipt_datetime | Дата и время документа из ФН |
total | Итоговая сумма документа |
fn_number | Номер ФН |
ecr_registration_number | Регистрационный номер ККМ |
fiscal_document_number | Фискальный номер документа |
fiscal_document_attribute | Фискальный признак документа |