Получение стандартного чека
Веб-сервис получения фискального чека позволяет предприятию получить сгенерированный в АПК Ассист фискальный чек. Такая возможность используется, например, в тех случаях, когда предприятие самостоятельно отправляет электронные копии чеков своим покупателям.
Для обращения к веб сервису необходимо отправить запрос на сервер ASSIST по адресу: https://<SERVER_NAME>/fiscal/fiscalreceipt.cfm.
Параметры передаются методом POST в теле запроса в формате «ключ=значение», SOAP запросом, либо в формате JSON (swagger описание: https://docs.assist.kz/swagger/).
Входные параметры сервиса:
Параметр | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание |
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | |
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | |
BillNumber | Да* | 15 или 16 цифр Расширенный формат | Номер операции, в системе АПК Ассист, по которой запрашивается чек | |
Payment_ID | Нет | 255 символов | Идентификатор операции в системе предприятия | |
Fiscalreceipt_ID | Да* | Число | Идентификатор чека | |
| Full_receipt | Нет | Число | Возвращать полный набор данных чека:
| |
| Receipttype | Нет | normal - фискализация приход/расход; usage - полный расчет. | Тип чека для выдачи сервисом Если параметр отсутствует, то по запросу будут выданы все имеющиеся чеки независимо от их типа. | |
Format | Нет | 1 – CSV | 1 | Формат возвращаемого ответа. |
*должен быть передан либо параметр Billnumber (тогда в ответе будет возвращен чек реальной операции), либо параметр Payment_ID (тогда в ответе будет возвращен чек внешней операции, созданный через веб-сервис фискализации внешних операций fiscalize), либо Fiscalreceipt_ID (если он известен), несколько параметров одновременно передавать нельзя.
Если фискальный чек для указанной в запросе операции существует, то в ответе передаются параметры этого фискального чека.
Перечень возвращаемых параметров:
Название | Значение |
billnumber | Идентификатор операции в системе |
или | |
Payment_ID | Идентификатор внешней операции |
fiscalreceipt_ID | Идентификатор чека |
receipttype | Тип чека |
status | Статус чека:
|
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 | Адрес чека во внешнем хранилище. |
*дополнительные параметры для полного набора данных чека.
Если запрос на получение фискального чека не может быть обработан, в результате запроса вернутся ненулевые значения параметров firstcode, secondcode.
Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует проверить текст ошибки, полученный в поле errortext, а также убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), затем повторно направить скорректированный запрос на фискализацию с помощью используемого сервиса.
Внимание!
Если в ответе на запрос данных фискального чека в течение длительного времени (несколько часов) по-прежнему приходит статус New (особенно в том случае, когда поле errortext ответа не пустое), следует обратиться в службу технической поддержки support@assist.kz.
Примеры ошибок, которые могут быть получены в поле errortext:
| ID ошибки | Содержимое поля errortext |
|---|---|
| 19521 | Не получен статус фискального чека. |
| 19511 | Ошибка в описании позиций чека. |
| 19508 | Ошибка в сумме позиции или сумме чека. |
| 19506 | Ошибка в параметре системы налогообложения. |
| 19504 | Ошибка при работе с чеком. |
| 8006 | Ошибка связи с процессинговым центром. |
| 1850 | Некорректное значение ставки налога. |
| 868 | Сбой в системе. |
- Неверный терминал.
- Ошибка формата ввода данных или незаполненное поле.