API: Повторная фискализация чека: различия между версиями
Merkulov (обсуждение | вклад) |
Merkulov (обсуждение | вклад) |
||
| Строка 1: | Строка 1: | ||
== Общие сведения == | == Общие сведения == | ||
'''API''' (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы к сервису '''БИФИТ Бизнес''' осуществляются при помощи авторотационного токена - '''access_token'''. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи. | '''API''' (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы к сервису '''БИФИТ Бизнес''' осуществляются при помощи авторотационного токена - '''access_token'''. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи. | ||
== Получение Access-token == | |||
Первоначально необходимо получить токен авторизации для будущего запроса " Повторная отправка чека на фискализацию". Подготовьте POST запрос следующего вида. | |||
{{ProductTable-2 | |||
|title-left='''Запрос''' | |||
|title-right='''POST''' | |||
|content-left= URL: https://fp.bifit.com/processing-api/oauth/token | |||
|content-right= | |||
<syntaxhighlight> | |||
https://fp.bifit.com/processing-api/oauth/token | |||
</syntaxhighlight> | |||
|}}<br> | |||
{{ProductTable-2 | |||
|title-left='''Request body''' | |||
|title-right= type: '''x-www-form-urllencoded''' | |||
|content-left= | |||
* token: указать токен коннектора | |||
* client_id: передать значение "processing-connector-token" | |||
* client_secret: передать значение "processing-connector-token" | |||
* grant_type: передать значение "token" | |||
|content-right= | |||
<syntaxhighlight> | |||
token: "Dd7fbes5LCFnfjLaLRM0gwBK8KwF....wepTkrw5fB3nzr" | |||
client_id: "processing-connector-token" | |||
client_secret: "processing-connector-token" | |||
grant_type: "token" | |||
</syntaxhighlight> | |||
|}}<br> | |||
Версия 18:36, 20 мая 2022
Общие сведения
API (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы к сервису БИФИТ Бизнес осуществляются при помощи авторотационного токена - access_token. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи.
Получение Access-token
Первоначально необходимо получить токен авторизации для будущего запроса " Повторная отправка чека на фискализацию". Подготовьте POST запрос следующего вида.
| Запрос | POST |
| URL: https://fp.bifit.com/processing-api/oauth/token | https://fp.bifit.com/processing-api/oauth/token |
| Request body | type: x-www-form-urllencoded |
* token: указать токен коннектора
|
token: "Dd7fbes5LCFnfjLaLRM0gwBK8KwF....wepTkrw5fB3nzr"
client_id: "processing-connector-token"
client_secret: "processing-connector-token"
grant_type: "token" |
Запрос на повторную фискализацию
Отправить чек на повторную фискализацию необходимо в том случае, когда в разделе Бифит Онлайн → Чеки в личном кабинете БИФИТ Бизнес был обнаружен чек в статусе "Ошибка". Чек приобретает статус "Ошибка" по нескольким причинам:
- Неисправность кассы
- Некорректно указанные данные в чеке (например некорректная СНО)
- Закончилась лицензия
- Достигнут предел чеков на ФН
| Запрос | POST |
| URL: fp.bifit.com/processing-api/protected/documents/reload/token | fp.bifit.com/processing-api/protected/documents/reload/token |
Важно!
В HEADERS укажите значение access_token согласно:authorization: Bearer <значение acces_token> .
Важно!
В поле Headers необходимо указать Broker-Token. Получить Broker-Token можно обратившись к менеджеру компании БИФИТ Касса.
| Request body | type: raw (JSON) |
| * id: id чека со статусом "Ошибка" | [
<id>
] |