API: Повторная фискализация чека: различия между версиями

Материал из Касса
Перейти к навигации Перейти к поиску
Метка: отменено
 
(не показано 16 промежуточных версий этого же участника)
Строка 1: Строка 1:
== Общие сведения ==
= Общие сведения =
'''API''' (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы к сервису '''БИФИТ Бизнес''' осуществляются при помощи авторотационного токена - '''access_token'''. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи.
'''API''' (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы к сервису '''БИФИТ Бизнес''' осуществляются при помощи авторотационного токена - '''access_token'''. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи.


== Получение Access-token ==
= Получение Access-token =
Первоначально необходимо получить токен авторизации для будущего запроса " Повторная отправка чека на фискализацию". Подготовьте POST запрос следующего вида.
Первоначально необходимо получить токен авторизации для будущего запроса " Повторная отправка чека на фискализацию". Подготовьте POST запрос следующего вида.


{{ProductTable-2
{{ProductTable-2
Строка 19: Строка 20:
|title-left='''Request body'''
|title-left='''Request body'''
|title-right= type: '''x-www-form-urllencoded'''
|title-right= type: '''x-www-form-urllencoded'''
|content-left=  
|content-left= 
 
* '''token''': указать токен коннектора
* token: указать токен коннектора
* '''client_id''': передать значение "processing-connector-token"
* client_id: передать значение "processing-connector-token"
* '''client_secret''': передать значение "processing-connector-token"
* client_secret: передать значение "processing-connector-token"
* '''grant_type''': передать значение "token"
* grant_type: передать значение "token"
|content-right= 
|content-right=
<syntaxhighlight lang="JSON">
<syntaxhighlight>
token: "Dd7fbes5LCFnfjLaLRM0gwBK8KwF....wepTkrw5fB3nzr"
token: "Dd7fbes5LCFnfjLaLRM0gwBK8KwF....wepTkrw5fB3nzr"
client_id: "processing-connector-token"
client_id: "processing-connector-token"
Строка 34: Строка 34:
|}}<br>
|}}<br>


 
= Запрос на повторную фискализацию =
 
== Запрос на повторную фискализацию ==
Отправить чек на повторную фискализацию необходимо в том случае, когда в разделе '''Бифит Онлайн → Чеки''' в личном кабинете БИФИТ Бизнес был обнаружен чек в статусе "Ошибка". Чек приобретает статус "Ошибка" по нескольким причинам:
Отправить чек на повторную фискализацию необходимо в том случае, когда в разделе '''Бифит Онлайн → Чеки''' в личном кабинете БИФИТ Бизнес был обнаружен чек в статусе "Ошибка". Чек приобретает статус "Ошибка" по нескольким причинам:
* Неисправность кассы
* Неисправность кассы
Строка 47: Строка 45:
|title-left='''Запрос'''
|title-left='''Запрос'''
|title-right='''POST'''
|title-right='''POST'''
|content-left= URL: fp.bifit.com/processing-api/protected/documents/reload/token
|content-left= URL: https://fp.bifit.com/processing-api/protected/documents/reload/token
|content-right=
|content-right=
<syntaxhighlight>
<syntaxhighlight>
fp.bifit.com/processing-api/protected/documents/reload/token
https://fp.bifit.com/processing-api/protected/documents/reload/token
</syntaxhighlight>
</syntaxhighlight>
|}}<br>
|}}<br>


{{Note|'''''Важно!'''''<br>
{{Note|'''''Важно!'''''<br>
В '''HEADERS''' укажите значение '''access_token''' согласно:'''authorization''': Bearer <значение '''acces_token'''> .|800}}
В '''HEADERS''' укажите значение '''access_token''' полученное из первого запроса: Bearer <значение '''acces_token'''> .|800}}


{{ProductTable-2
|title-left='''Headers'''
|title-right=
|content-left=<br>
Broker-token
|content-right=
<syntaxhighlight>
"FkxvbtJgG3b2aCFF91TbNLz5Je.....50v40dszUrV0z"
</syntaxhighlight>
|}}<br>


{{Note| '''Важно!''' <br>
{{Note| '''Важно!''' <br>
В поле '''Headers''' необходимо указать '''Broker-Token'''. Получить '''Broker-Token''' можно обратившись к менеджеру компании БИФИТ Касса.|800}}
Получить '''Broker-Token''' можно обратившись к менеджеру компании БИФИТ Касса.|800}}




Строка 66: Строка 74:
|title-left='''Request body'''
|title-left='''Request body'''
|title-right= type: '''raw''' (JSON)
|title-right= type: '''raw''' (JSON)
|content-left=  
|content-left= &nbsp;
* '''id''': id чека со статусом "Ошибка"   
* '''id''': id чека со статусом "Ошибка"   
|content-right=
|content-right=&nbsp;
<syntaxhighlight>
<syntaxhighlight lang="JSON">
[  
[  
<id>
<id>
Строка 75: Строка 83:
</syntaxhighlight>
</syntaxhighlight>
|}}<br>
|}}<br>
{{Note| '''Важно!''' <br>
Данный запрос подходит организациям, у которых развернут собственный фискальный брокер.|800}}
= См. также =
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом Интеграция с Фискальным Процессингом]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Авторизация_в_OAuth2_при_помощи_токена_коннектора Авторизация в OAuth2 при помощи токена коннектора]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Авторизация_в_OAuth2_по_refresh_token Авторизация в OAuth2 по refresh token]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Отправка_документа_на_фискализацию_в_процессинг Отправка документа на фискализацию в процессинг]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Отправка_документа_на_фискализацию_в_процессинг_(маркированный_товар) Отправка документа на фискализацию в процессинг (маркированный товар)]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Отправка_документа_на_фискализацию_в_процессинг_(агентский_товар) Отправка документа на фискализацию в процессинг (агентский товар)]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Запрос_информации_о_документе_по_ID Запрос информации о документе по ID]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Оффлайн_возможности_фискального_процессинга Оффлайн возможности фискального процессинга]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Справочник_Ошибок_(ФП) Справочник Ошибок (ФП)]

Текущая версия на 10:22, 8 ноября 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: указать токен коннектора
  • client_id: передать значение "processing-connector-token"
  • client_secret: передать значение "processing-connector-token"
  • grant_type: передать значение "token"
 
token: "Dd7fbes5LCFnfjLaLRM0gwBK8KwF....wepTkrw5fB3nzr"
client_id: "processing-connector-token"
client_secret: "processing-connector-token"
grant_type: "token"


Запрос на повторную фискализацию

Отправить чек на повторную фискализацию необходимо в том случае, когда в разделе Бифит Онлайн → Чеки в личном кабинете БИФИТ Бизнес был обнаружен чек в статусе "Ошибка". Чек приобретает статус "Ошибка" по нескольким причинам:

  • Неисправность кассы
  • Некорректно указанные данные в чеке (например некорректная СНО)
  • Закончилась лицензия
  • Достигнут предел чеков на ФН


Запрос POST
URL: https://fp.bifit.com/processing-api/protected/documents/reload/token
https://fp.bifit.com/processing-api/protected/documents/reload/token


Note.svg Важно!
В HEADERS укажите значение access_token полученное из первого запроса: Bearer <значение acces_token> .


Headers

Broker-token
"FkxvbtJgG3b2aCFF91TbNLz5Je.....50v40dszUrV0z"


Note.svg  Важно!
Получить Broker-Token можно обратившись к менеджеру компании БИФИТ Касса.


Request body type: raw (JSON)
 
  • id: id чека со статусом "Ошибка"
 
[ 
<id>
]


Note.svg  Важно!
Данный запрос подходит организациям, у которых развернут собственный фискальный брокер.

См. также