Просмотр кода страницы Облачная Касса: Отправка документа на фискализацию в процессинг

{{ProductTable-2
|title-left='''Запрос регистрации чека'''
|title-right='''POST'''
|content-left= https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts
* Адрес "боевого" контура ФП '''https://fp.bifit.com/processing-api/.../'''
|content-right=
<syntaxhighlight>
https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts
</syntaxhighlight>
|}}<br>

{{ProductTable-2
|title-left= Request Headers
|title-right=
|content-left=&nbsp;
* '''authorization''': переменная для передачи access_token. Введите тип токена (в нашем случае слово "Bearer") перед значением '''access_token'''
* '''idempotency-key''': ключ идемпотентности. Уникальный идентификатор документа в рамках сервиса '''БИФИТ Онлайн'''. Ключ генерируется на стороне клиента и обеспечивает невозможность повторного выполнения запроса регистрации чека на сервере. Варианты формирования ключа:
** Используйте '''[https://ru.wikipedia.org/wiki/GUID GUID]''' для генерации ключа идемпотентности ('''Рекомендуется''')
** Используйте правило генерации ключа: '''SHA256(Локальный номер документа & PIN(4 символа) & Сумма чека(ххх.хх) & ДатаВремя(ДД.ММ.ГГГГ ЧЧ:ММ))''' для случаев, когда необходимо воспроизвести ключ по исходным данным с ИС отправителя запросов
*** '''Локальный номер документа''': Локальный инкрементируемый счетчик в ИС отправителя запросов;
*** '''PIN''': Зафиксированное значение в ИС отправителя запросов;
*** '''Сумма чека''': Сумма чека, переданная в переменную '''total''';
*** '''Время чека''': Время зафиксированное в ИС отправителя;
|content-right=&nbsp;
<syntaxhighlight lang="JSON">
authorization: "Bearer ero3UNcffhlKdn5e76i...edfr_JU"
idempotency-key: "sdftfc-KF784mkd-skdhkaasca_lf34hKxsf"
</syntaxhighlight>
|}}<br>

{{ProductTable-2
|title-left=Request Body
|title-right=JSON структура
|content-left=&nbsp;
* '''type''': тип фискального документа,  см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b>('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
* '''taxSystem''': система налогообложения,  см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
* '''machineNumber''': номер автомата(если касса используется для вендинга обязательный реквизит)
* '''cashier''': информация о кассире(если касса используется для вендинга необязательный реквизит)
** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
** '''inn''': ИНН кассира ('''не обязательный реквизит''')
* '''client''': информация о клиенте
** '''address''': электронный адрес или номер телефона ('''не обязательный реквизит''')
* '''items''': массив, содержащий номенклатурные позиции
** '''calculationMethod''': признак способа расчёта,  см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
** '''paymentSubject''': признак предмета расчёта,  см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b>('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
** '''name''': наименование товарной позиции ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
** '''price''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
** '''quantity''': количество товарных позиций ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
** '''vat''': НДС товарной позиции, по умолчанию передаётся значение "БЕЗ НДС" ('''не обязательный реквизит''')
** '''total''': сумма товарной позиции с учетом примененных скидок/надбавок
* '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
* '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''')
** '''CASH''': сумма по типу оплаты наличными ('''не обязательный реквизит''')
|content-right=&nbsp;
<syntaxhighlight lang="JSON">
{
    "type": "SALE",
    "taxSystem": "COMMON",
    "cashier": {
        "name": "Иванов И.И."
    },
    "client": {
        "address": "test@test.com"
    },
    "items": [
        {
            "calculationMethod": "FULL_PAY",
            "paymentSubject": "SERVICE",
            "name": "Услуга",
            "price": 100.00,
            "quantity": 1.500,
            "vat": "VAT_20",
            "total": 150.00
        }
    ],
    "total": 150.00,
    "payments": {
        "CASH": 150.00
    }
}
</syntaxhighlight>
|}}<br>

{{ProductTable-2
|title-left=Response
|title-right=
|content-left=&nbsp;
* Ответ сервера содержит '''ID''' зарегистрированного чека
|content-right=&nbsp;
<syntaxhighlight>
254934
</syntaxhighlight>
|}}<br>

= См. также =
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом Интеграция с Фискальным Процессингом]
* [https://kassa.bifit.com/wiki/index.php?title=API:Отправка_чека_на_повторную_фискализацию Отправка чека на повторную фискализацию]
* [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=БИФИТ_ОНЛАЙН:Запрос_информации_о_документе_по_ID Запрос информации о документе по ID]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Оффлайн_возможности_фискального_процессинга Оффлайн возможности фискального процессинга]
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Справочник_Ошибок_(ФП) Справочник Ошибок (ФП)]