Веб-сервис предназначен для печати дополнительного чека полного расчета. Если при оплате уже был сформирован чек с признаком "Предоплата 100%", то при получении покупателем заранее оплаченного товара необходимо сформировать дополнительный чек на ту же сумму с признаком "Полный расчет". Выдача этого чека покупателю не обязательна.
Для обращения к веб сервису необходимо отправить запрос на сервер ASSIST по адресу: https://<SERVER_NAME>/fiscal/fullcalculation.cfm.
Параметры передаются методом POST в теле запроса в формате «ключ=значение», либо в формате JSON (swagger описание: https://docs.assist.ru/swagger/).
Входные параметры сервиса:
Параметр | Обязательный | Принимаемые значения | Значение по умолчанию | Описание |
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | |
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | |
BillNumber | Да | 15 или 16 цифр | Уникальный номер заказа в системе АПК Ассист | |
Format | Нет | 1 – CSV (поля с разделителями) | 1 | Формат выдачи результатов. Формат выдачи результата. Если запрос передан в формате SOAP или JSON, то ответ также будет в SOAP или JSON соответственно, в остальных случаях ответ выдается согласно переданному значению формата. |
UserRequisites | Нет | структура {"name": <string(64)>, "value": <string(256)>} | Пусто | Дополнительные реквизиты пользователя |
Внимание! Если для товаров в чеке необходимо передавать код маркировки, то при обращении к сервису следует также добавить дополнительный параметр позиций заказа chequeitems, как описано в разделе "Режимы передачи данных чека", с кодами маркировки, как в разделе "Работа с чеком".
Список параметров ответа:
Название | Значение |
fiscalreceipt_ID | Идентификатор созданного фискального чека |
billnumber | Уникальный номер заказа в системе АПК Ассист |
Type | Тип фискализируемой операции:
|
Receipt_status | Статус созданного фискального чека:
|
Процесс фискализации является асинхронным, поэтому для большинства чеков в ответе будет возвращен статус New (чек подготовлен к формированию). Это означает, что чек создан и поставлен в очередь на кассу для фискализации. После получения данных о создании фискального чека в статусе New рекомендуется через несколько минут дополнительно запросить данные фискального чека с помощью веб-сервиса fiscalreceipt (о веб-сервисе fiscalreceipt подробнее см. «Получение фискального чека»), чтобы убедиться в успешном завершении создания фискального чека.
Если чек находится в статусе New, то отправлять его на фискализацию повторно нельзя.
Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), также рекомендуется дополнительно запросить данные с помощью веб-сервиса fiscalreceipt. После исправления некорректных параметров можно отправить чек на фискализацию повторно.
Внимание!
Если в ответе на запрос данных фискального чека через веб-сервис fiscalreceipt в течение длительного времени (несколько часов) по-прежнему приходит статус New (особенно в том случае, когда поле errortext ответа не пустое), следует обратиться в службу технической поддержки support@assist.ru.
Если запрос на фискализацию не может быть обработан, в результате запроса вернутся ненулевые значения параметров firstcode, secondcode.
Пример ответа:
{
"fiscalize": {
"receipt_status": "New",
"payment_id": "",
"type": "sell",
"fiscalreceipt_id": 838507
}
}