Облачная Касса: Отправка документа на фискализацию в процессинг (агентский товар): различия между версиями
Перейти к навигации
Перейти к поиску
Merkulov (обсуждение | вклад) |
м |
||
(не показаны 24 промежуточные версии 2 участников) | |||
Строка 1: | Строка 1: | ||
= Запрос при работе по ФФД 1.2 = | |||
{{ Note | '''''Важно!'''''<br> | |||
* При работе по ФФД 1.2 в запросе на фискализацию документа с агентским товаром в процессинг, данные агента необходимо указывать в описание товара. | |||
* [[Облачная Касса: Интеграция с Фискальным Процессингом#Нумераторы|Нумераторы]]|800}} | |||
{{ProductTable-2 | {{ProductTable-2 | ||
|title-left='''Запрос регистрации чека''' | |title-left='''Запрос регистрации чека''' | ||
|title-right='''POST''' | |title-right='''POST''' | ||
|content-left= https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts | |content-left= https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts | ||
* Адрес "боевого" контура ФП '''https://fp.bifit.com/processing-api/.../''' | |||
|content-right= | |content-right= | ||
<syntaxhighlight> | <syntaxhighlight> | ||
Строка 27: | Строка 37: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
|}}<br> | |}}<br> | ||
BODY запроса для агента типа "'''Банковский платежный агент/субагент'''". | |||
{{ProductTable-2 | {{ProductTable-2 | ||
Строка 32: | Строка 45: | ||
|title-right=JSON структура | |title-right=JSON структура | ||
|content-left= | |content-left= | ||
* '''type''': тип фискального документа, см. раздел "Нумераторы" ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | * '''type''': тип фискального документа, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
* '''taxSystem''': система налогообложения, см. раздел "Нумераторы" ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | * '''taxSystem''': система налогообложения, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
* '''cashier''': информация о кассире | * '''cashier''': информация о кассире | ||
** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
* '''client''': информация о клиенте | * '''client''': информация о клиенте | ||
** '''address''': электронный адрес или номер телефона ('''не обязательный реквизит''') | ** '''address''': электронный адрес или номер телефона ('''не обязательный реквизит''') | ||
* '''items''': массив, содержащий номенклатурные позиции | * '''items''': массив, содержащий номенклатурные позиции | ||
** '''calculationMethod''': признак способа расчёта, см. раздел "Нумераторы" ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ** '''calculationMethod''': признак способа расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
** '''paymentSubject''': признак предмета расчёта, см. раздел "Нумераторы" ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ** '''paymentSubject''': признак предмета расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
** '''name''': наименование товарной позиции ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ** '''name''': наименование товарной позиции ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
** '''price''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ** '''price''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 47: | Строка 59: | ||
** '''vat''': НДС товарной позиции, по умолчанию передаётся значение "БЕЗ НДС" ('''не обязательный реквизит''') | ** '''vat''': НДС товарной позиции, по умолчанию передаётся значение "БЕЗ НДС" ('''не обязательный реквизит''') | ||
** '''total''': сумма товарной позиции с учетом примененных скидок/надбавок | ** '''total''': сумма товарной позиции с учетом примененных скидок/надбавок | ||
* '''agent''': массив, содержащий информацию об агенте | |||
** ''' | ** '''transferPhones''': телефон оператора перевода | ||
** ''' | ** '''transferName''': Наименование оператора перевода | ||
** ''' | ** '''transferAddress''': Адрес оператора перевода | ||
** '''transferInn''': ИНН оператора перевода | |||
** ''' | ** '''receiverPhones''': Телефон оператора по приему платежей | ||
** '''operation''': Операция платежного агента | |||
** '''phones''': Телефон платежного агента | |||
* '''agentType''': Признак агента | |||
* '''shipper''': Поставщик | |||
** '''name''': ФИО поставщика | |||
** '''inn''': ИНН поставщика | |||
* '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | * '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
* '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | * '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 58: | Строка 76: | ||
|content-right= | |content-right= | ||
<syntaxhighlight lang="JSON"> | <syntaxhighlight lang="JSON"> | ||
{ | { | ||
"type": "SALE", | "type": "SALE", | ||
"taxSystem": "COMMON", | "taxSystem": "COMMON", | ||
"cashier": { | "cashier": { | ||
"name": "Иванов И.И." | "name": "Иванов И.И." | ||
}, | }, | ||
"client": { | "client": { | ||
"address": "test@test.com" | "address": "test@test.com" | ||
}, | }, | ||
"items": [ | "items": [ | ||
{ | { | ||
"calculationMethod": "FULL_PAY", | "calculationMethod": "FULL_PAY", | ||
"paymentSubject": "PRODUCT", | "paymentSubject": "PRODUCT", | ||
"name": "Тест agent запрос", | "name": "Тест agent запрос", | ||
"price": 100.00, | "price": 100.00, | ||
"quantity": 1, | "quantity": 1, | ||
"vat": "VAT_20", | "vat": "VAT_20", | ||
"total": 100.00, | "total": 100.00, | ||
"agent": { | |||
"transferPhones": [ "+79999999999"], | |||
"transferName": "string", | |||
"transferAddress": "string", | |||
" | "transferInn": "1234567890", | ||
" | "receiverPhones": [ | ||
} | "+79999999999" | ||
], | ], | ||
"total": 100.00, | "operation": "string", | ||
"payments": { | "phones": ["+79999999999"] | ||
"CASH": 100.00 | }, | ||
} | "agentType": "BANK_PAYMENT_AGENT", | ||
"shipper": { | |||
"name": "string", | |||
"inn": "1234567890"} | |||
} | |||
], | |||
"total": 100.00, | |||
"payments": { | |||
"CASH": 100.00 | |||
} | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
|}}<br> | |}}<br> | ||
BODY запроса для агента типа "'''Платежный агент/субагент'''". | |||
{{ProductTable-2 | |||
|title-left=Request Body | |||
|title-right=JSON структура | |||
|content-left= | |||
* '''type''': тип фискального документа, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''taxSystem''': система налогообложения, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''cashier''': информация о кассире | |||
** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''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''': сумма товарной позиции с учетом примененных скидок/надбавок | |||
* '''agent''': массив, содержащий информацию об агенте | |||
** '''receiverPhones''': Телефон оператора по приему платежей | |||
** '''phones''': Телефон платежного агента | |||
* '''agentType''': Признак агента (BANK_PAYMENT_AGENT, BANK_PAYMENT_SUBAGENT, PAYMENT_AGENT, PAYMENT_SUBAGENT, ATTORNEY, COMMISSIONER, AGENT) | |||
* '''shipper''': Поставщик | |||
** '''name''': ФИО поставщика | |||
** '''inn''': ИНН поставщика | |||
* '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''CASH''': сумма по типу оплаты наличными ('''не обязательный реквизит''') | |||
|content-right= | |||
<syntaxhighlight lang="JSON"> | |||
{ | |||
"type": "SALE", | |||
"taxSystem": "COMMON", | |||
"cashier": { | |||
"name": "Иванов И.И." | |||
}, | |||
"client": { | |||
"address": "test@test.com" | |||
}, | |||
"items": [ | |||
{ | |||
"calculationMethod": "FULL_PAY", | |||
"paymentSubject": "PRODUCT", | |||
"name": "Тест agent запрос", | |||
"price": 100.00, | |||
"quantity": 1, | |||
"vat": "VAT_20", | |||
"total": 100.00, | |||
"agent": { | |||
"receiverPhones": [ | |||
"+79999999999" | |||
], | |||
"phones": ["+79999999999"] | |||
}, | |||
"agentType": "PAYMENT_AGENT", | |||
"shipper": { | |||
"name": "string", | |||
"inn": "1234567890"} | |||
} | |||
], | |||
"total": 100.00, | |||
"payments": { | |||
"CASH": 100.00 | |||
} | |||
} | |||
</syntaxhighlight> | |||
|}}<br> | |||
BODY запроса для агентов типа "'''Агент, Поверенный, Комиссионер'''". | |||
{{ProductTable-2 | |||
|title-left=Request Body | |||
|title-right=JSON структура | |||
|content-left= | |||
* '''type''': тип фискального документа, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''taxSystem''': система налогообложения, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''cashier''': информация о кассире | |||
** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''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''': сумма товарной позиции с учетом примененных скидок/надбавок | |||
** '''agentType''': Признак агента (ATTORNEY, COMMISSIONER, AGENT) | |||
** '''shipper''': Поставщик ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''name''': ФИО поставщика | |||
** '''inn''': ИНН поставщика | |||
* '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''CASH''': сумма по типу оплаты наличными ('''не обязательный реквизит''') | |||
|content-right= | |||
<syntaxhighlight lang="JSON"> | |||
{ | |||
"type": "SALE", | |||
"taxSystem": "COMMON", | |||
"cashier": { | |||
"name": "Иванов И.И." | |||
}, | |||
"client": { | |||
"address": "79999999999" | |||
}, | |||
"items": [ | |||
{ | |||
"calculationMethod": "FULL_PAY", | |||
"paymentSubject": "SERVICE", | |||
"name": "Услуга", | |||
"price": 100, | |||
"quantity": 1, | |||
"vat": "VAT_20", | |||
"total": 100, | |||
"agentType":"AGENT", | |||
"shipper":{ | |||
"name":"", | |||
"inn":"1234567890"} | |||
} | |||
], | |||
"total": 100, | |||
"payments": { | |||
"CASH": 100 | |||
} | |||
} | |||
</syntaxhighlight> | |||
|}}<br> | |||
{{ProductTable-2 | {{ProductTable-2 | ||
Строка 100: | Строка 265: | ||
<syntaxhighlight> | <syntaxhighlight> | ||
257416 | 257416 | ||
</syntaxhighlight> | |||
|}}<br> | |||
= Запрос при работе по ФФД 1.05 = | |||
{{ Note | '''''Важно!'''''<br> | |||
* При работе по ФФД 1.2 в запросе на фискализацию документа с агентским товаром в процессинг, данные агента необходимо указывать в описание товара. | |||
* [[Облачная Касса: Интеграция с Фискальным Процессингом#Нумераторы|Нумераторы]]|800}} | |||
{{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= | |||
* '''authorization''': переменная для передачи access_token. Введите тип токена (в нашем случае слово "Bearer") перед значением '''access_token''' | |||
* '''idempotency-key''': ключ идемпотентности. Уникальный идентификатор документа в рамках сервиса '''БИФИТ Онлайн'''. Ключ генерируется на стороне клиента и обеспечивает невозможность повторного выполнения запроса регистрации чека на сервере. Варианты формирования ключа: | |||
** Используйте '''[https://ru.wikipedia.org/wiki/GUID GUID]''' для генерации ключа идемпотентности ('''Рекомендуется''') | |||
** Используйте правило генерации ключа: '''SHA256(Локальный номер документа & PIN(4 символа) & Сумма чека(ххх.хх) & ДатаВремя(ДД.ММ.ГГГГ ЧЧ:ММ))''' для случаев, когда необходимо воспроизвести ключ по исходным данным с ИС отправителя запросов | |||
*** '''Локальный номер документа''': Локальный инкрементируемый счетчик в ИС отправителя запросов; | |||
*** '''PIN''': Зафиксированное значение в ИС отправителя запросов; | |||
*** '''Сумма чека''': Сумма чека, переданная в переменную '''total'''; | |||
*** '''Время чека''': Время зафиксированное в ИС отправителя; | |||
|content-right= | |||
<syntaxhighlight lang="JSON"> | |||
authorization: "Bearer ero3UNcffhlKdn5e76i...edfr_JU" | |||
idempotency-key: "sdftfc-KF784mkd-skdhkaasca_lf34hKxsf" | |||
</syntaxhighlight> | |||
|}}<br> | |||
BODY запроса для агента типа "'''Банковский платежный агент/субагент'''". | |||
{{ProductTable-2 | |||
|title-left=Request Body | |||
|title-right=JSON структура | |||
|content-left= | |||
* '''type''': тип фискального документа, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''taxSystem''': система налогообложения, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''cashier''': информация о кассире | |||
** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''client''': информация о клиенте | |||
** '''address''': электронный адрес или номер телефона ('''не обязательный реквизит''') | |||
* '''agent''': массив, содержащий информацию об агенте | |||
** '''transferPhones''': телефон оператора перевода | |||
** '''transferName''': Наименование оператора перевода | |||
** '''transferAddress''': Адрес оператора перевода | |||
** '''transferInn''': ИНН оператора перевода | |||
** '''receiverPhones''': Телефон оператора по приему платежей | |||
** '''operation''': Операция платежного агента | |||
** '''phones''': Телефон платежного агента | |||
* '''agentType''': Признак агента | |||
* '''items''': массив, содержащий номенклатурные позиции | |||
** '''calculationMethod''': признак способа расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''paymentSubject''': признак предмета расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''shipper''': Поставщик | |||
*** '''name''': ФИО поставщика | |||
*** '''inn''': ИНН поставщика | |||
** '''name''': наименование товарной позиции ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''price''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''quantity''': количество товарных позиций ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''vat''': НДС товарной позиции, по умолчанию передаётся значение "БЕЗ НДС" ('''не обязательный реквизит''') | |||
** '''total''': сумма товарной позиции с учетом примененных скидок/надбавок | |||
* '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''CASH''': сумма по типу оплаты наличными ('''не обязательный реквизит''') | |||
|content-right= | |||
<syntaxhighlight lang="JSON"> | |||
{ | |||
"type": "SALE", | |||
"taxSystem": "COMMON", | |||
"cashier": { | |||
"name": "Иванов И.И." | |||
}, | |||
"client": { | |||
"address": "test@test.com" | |||
}, | |||
"agent": { | |||
"transferPhones": [ "+79999999999"], | |||
"transferName": "string", | |||
"transferAddress": "string", | |||
"transferInn": "1234567890", | |||
"receiverPhones": [ | |||
"+79999999999" | |||
], | |||
"operation": "string", | |||
"phones": ["+79999999999"] | |||
}, | |||
"agentType": "BANK_PAYMENT_AGENT", | |||
"items": [ | |||
{ | |||
"calculationMethod": "FULL_PAY", | |||
"paymentSubject": "PRODUCT", | |||
"shipper": { | |||
"name": "string", | |||
"inn": "1234567890"}, | |||
"name": "Тест agent запрос", | |||
"price": 100.00, | |||
"quantity": 1, | |||
"vat": "VAT_20", | |||
"total": 100.00 | |||
} | |||
], | |||
"total": 100.00, | |||
"payments": { | |||
"CASH": 100.00 | |||
} | |||
} | |||
</syntaxhighlight> | |||
|}}<br> | |||
BODY запроса для агента типа "'''Платежный агент/субагент'''". | |||
{{ProductTable-2 | |||
|title-left=Request Body | |||
|title-right=JSON структура | |||
|content-left= | |||
* '''type''': тип фискального документа, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''taxSystem''': система налогообложения, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''cashier''': информация о кассире | |||
** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''client''': информация о клиенте | |||
** '''address''': электронный адрес или номер телефона ('''не обязательный реквизит'''), | |||
* '''agent''': массив, содержащий информацию об агенте | |||
** '''receiverPhones''': Телефон оператора по приему платежей | |||
** '''phones''': Телефон платежного агента | |||
* '''agentType''': Признак агента (BANK_PAYMENT_AGENT, BANK_PAYMENT_SUBAGENT, PAYMENT_AGENT, PAYMENT_SUBAGENT, ATTORNEY, COMMISSIONER, AGENT) | |||
* '''items''': массив, содержащий номенклатурные позиции | |||
** '''calculationMethod''': признак способа расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''paymentSubject''': признак предмета расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''shipper''': Поставщик | |||
*** '''name''': ФИО поставщика | |||
*** '''inn''': ИНН поставщика | |||
** '''name''': наименование товарной позиции ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''price''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''quantity''': количество товарных позиций ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''vat''': НДС товарной позиции, по умолчанию передаётся значение "БЕЗ НДС" ('''не обязательный реквизит''') | |||
** '''total''': сумма товарной позиции с учетом примененных скидок/надбавок | |||
* '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''CASH''': сумма по типу оплаты наличными ('''не обязательный реквизит''') | |||
|content-right= | |||
<syntaxhighlight lang="JSON"> | |||
{ | |||
"type": "SALE", | |||
"taxSystem": "COMMON", | |||
"cashier": { | |||
"name": "Иванов И.И." | |||
}, | |||
"client": { | |||
"address": "test@test.com" | |||
}, | |||
"agent": { | |||
"receiverPhones": [ | |||
"+79999999999" | |||
], | |||
"phones": ["+79999999999"] | |||
}, | |||
"agentType": "PAYMENT_AGENT", | |||
"items": [ | |||
{ | |||
"calculationMethod": "FULL_PAY", | |||
"paymentSubject": "PRODUCT", | |||
"shipper": { | |||
"name": "string", | |||
"inn": "1234567890"}, | |||
"name": "Тест agent запрос", | |||
"price": 100.00, | |||
"quantity": 1, | |||
"vat": "VAT_20", | |||
"total": 100.00 | |||
} | |||
], | |||
"total": 100.00, | |||
"payments": { | |||
"CASH": 100.00 | |||
} | |||
} | |||
</syntaxhighlight> | |||
|}}<br> | |||
BODY запроса для агентов типа "'''Агент, Поверенный, Комиссионер'''". | |||
{{ProductTable-2 | |||
|title-left=Request Body | |||
|title-right=JSON структура | |||
|content-left= | |||
* '''type''': тип фискального документа, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''taxSystem''': система налогообложения, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''cashier''': информация о кассире | |||
** '''name''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''client''': информация о клиенте | |||
** '''address''': электронный адрес или номер телефона ('''не обязательный реквизит''') | |||
* '''agentType''': Признак агента (ATTORNEY, COMMISSIONER, AGENT) | |||
* '''items''': массив, содержащий номенклатурные позиции | |||
** '''calculationMethod''': признак способа расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''paymentSubject''': признак предмета расчёта, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''shipper''': Поставщик ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
*** '''name''': ФИО поставщика | |||
*** '''inn''': ИНН поставщика | |||
*** '''phones''': Телефон платежного агента | |||
** '''name''': наименование товарной позиции ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''price''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''quantity''': количество товарных позиций ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''vat''': НДС товарной позиции, по умолчанию передаётся значение "БЕЗ НДС" ('''не обязательный реквизит''') | |||
** '''total''': сумма товарной позиции с учетом примененных скидок/надбавок | |||
* '''total''': итоговая сумма чека. Содержит итоговую сумму всех товарных позиций в чеке ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
* '''payments''': типы оплаты. В чеке должен быть указан хотя бы один тип оплаты ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | |||
** '''CASH''': сумма по типу оплаты наличными ('''не обязательный реквизит''') | |||
|content-right= | |||
<syntaxhighlight lang="JSON"> | |||
{ | |||
"type": "SALE", | |||
"taxSystem": "COMMON", | |||
"cashier": { | |||
"name": "Иванов И.И." | |||
}, | |||
"client": { | |||
"address": "79999999999" | |||
}, | |||
"agentType":"AGENT", | |||
"items": [ | |||
{ | |||
"calculationMethod": "FULL_PAY", | |||
"paymentSubject": "SERVICE", | |||
"shipper":{ | |||
"name":"", | |||
"inn":"1234567890", | |||
}, | |||
"name": "Услуга", | |||
"price": 100, | |||
"quantity": 1, | |||
"vat": "VAT_20", | |||
"total": 100 | |||
} | |||
], | |||
"total": 100, | |||
"payments": { | |||
"CASH": 100 | |||
} | |||
} | |||
</syntaxhighlight> | |||
|}}<br> | |||
{{ProductTable-2 | |||
|title-left=Response | |||
|title-right= | |||
|content-left= | |||
* Ответ сервера содержит '''ID''' зарегистрированного чека | |||
|content-right= | |||
<syntaxhighlight> | |||
257419 | |||
</syntaxhighlight> | </syntaxhighlight> | ||
|}}<br> | |}}<br> | ||
Строка 105: | Строка 538: | ||
= См. также = | = См. также = | ||
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом Интеграция с Фискальным Процессингом] | * [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_при_помощи_токена_коннектора Авторизация в OAuth2 при помощи токена коннектора] | ||
* [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Авторизация_в_OAuth2_по_refresh_token Авторизация в OAuth2 по refresh token] | * [https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:Авторизация_в_OAuth2_по_refresh_token Авторизация в OAuth2 по refresh token] |
Текущая версия на 12:48, 21 ноября 2023
Запрос при работе по ФФД 1.2
- При работе по ФФД 1.2 в запросе на фискализацию документа с агентским товаром в процессинг, данные агента необходимо указывать в описание товара.
- Нумераторы
Запрос регистрации чека | POST |
https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts
|
https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts |
Request Headers | |
|
authorization: "Bearer ero3UNcffhlKdn5e76i...edfr_JU"
idempotency-key: "sdftfc-KF784mkd-skdhkaasca_lf34hKxsf"
|
BODY запроса для агента типа "Банковский платежный агент/субагент".
Request Body | JSON структура |
|
{
"type": "SALE",
"taxSystem": "COMMON",
"cashier": {
"name": "Иванов И.И."
},
"client": {
"address": "test@test.com"
},
"items": [
{
"calculationMethod": "FULL_PAY",
"paymentSubject": "PRODUCT",
"name": "Тест agent запрос",
"price": 100.00,
"quantity": 1,
"vat": "VAT_20",
"total": 100.00,
"agent": {
"transferPhones": [ "+79999999999"],
"transferName": "string",
"transferAddress": "string",
"transferInn": "1234567890",
"receiverPhones": [
"+79999999999"
],
"operation": "string",
"phones": ["+79999999999"]
},
"agentType": "BANK_PAYMENT_AGENT",
"shipper": {
"name": "string",
"inn": "1234567890"}
}
],
"total": 100.00,
"payments": {
"CASH": 100.00
}
}
|
BODY запроса для агента типа "Платежный агент/субагент".
Request Body | JSON структура |
|
{
"type": "SALE",
"taxSystem": "COMMON",
"cashier": {
"name": "Иванов И.И."
},
"client": {
"address": "test@test.com"
},
"items": [
{
"calculationMethod": "FULL_PAY",
"paymentSubject": "PRODUCT",
"name": "Тест agent запрос",
"price": 100.00,
"quantity": 1,
"vat": "VAT_20",
"total": 100.00,
"agent": {
"receiverPhones": [
"+79999999999"
],
"phones": ["+79999999999"]
},
"agentType": "PAYMENT_AGENT",
"shipper": {
"name": "string",
"inn": "1234567890"}
}
],
"total": 100.00,
"payments": {
"CASH": 100.00
}
}
|
BODY запроса для агентов типа "Агент, Поверенный, Комиссионер".
Request Body | JSON структура |
|
{
"type": "SALE",
"taxSystem": "COMMON",
"cashier": {
"name": "Иванов И.И."
},
"client": {
"address": "79999999999"
},
"items": [
{
"calculationMethod": "FULL_PAY",
"paymentSubject": "SERVICE",
"name": "Услуга",
"price": 100,
"quantity": 1,
"vat": "VAT_20",
"total": 100,
"agentType":"AGENT",
"shipper":{
"name":"",
"inn":"1234567890"}
}
],
"total": 100,
"payments": {
"CASH": 100
}
}
|
Response | |
|
257416 |
Запрос при работе по ФФД 1.05
- При работе по ФФД 1.2 в запросе на фискализацию документа с агентским товаром в процессинг, данные агента необходимо указывать в описание товара.
- Нумераторы
Запрос регистрации чека | POST |
https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts
|
https://fp-test.bifit.com/processing-api/protected/documents/registration/receipts |
Request Headers | |
|
authorization: "Bearer ero3UNcffhlKdn5e76i...edfr_JU"
idempotency-key: "sdftfc-KF784mkd-skdhkaasca_lf34hKxsf"
|
BODY запроса для агента типа "Банковский платежный агент/субагент".
Request Body | JSON структура |
|
{
"type": "SALE",
"taxSystem": "COMMON",
"cashier": {
"name": "Иванов И.И."
},
"client": {
"address": "test@test.com"
},
"agent": {
"transferPhones": [ "+79999999999"],
"transferName": "string",
"transferAddress": "string",
"transferInn": "1234567890",
"receiverPhones": [
"+79999999999"
],
"operation": "string",
"phones": ["+79999999999"]
},
"agentType": "BANK_PAYMENT_AGENT",
"items": [
{
"calculationMethod": "FULL_PAY",
"paymentSubject": "PRODUCT",
"shipper": {
"name": "string",
"inn": "1234567890"},
"name": "Тест agent запрос",
"price": 100.00,
"quantity": 1,
"vat": "VAT_20",
"total": 100.00
}
],
"total": 100.00,
"payments": {
"CASH": 100.00
}
}
|
BODY запроса для агента типа "Платежный агент/субагент".
Request Body | JSON структура |
|
{
"type": "SALE",
"taxSystem": "COMMON",
"cashier": {
"name": "Иванов И.И."
},
"client": {
"address": "test@test.com"
},
"agent": {
"receiverPhones": [
"+79999999999"
],
"phones": ["+79999999999"]
},
"agentType": "PAYMENT_AGENT",
"items": [
{
"calculationMethod": "FULL_PAY",
"paymentSubject": "PRODUCT",
"shipper": {
"name": "string",
"inn": "1234567890"},
"name": "Тест agent запрос",
"price": 100.00,
"quantity": 1,
"vat": "VAT_20",
"total": 100.00
}
],
"total": 100.00,
"payments": {
"CASH": 100.00
}
}
|
BODY запроса для агентов типа "Агент, Поверенный, Комиссионер".
Request Body | JSON структура |
|
{
"type": "SALE",
"taxSystem": "COMMON",
"cashier": {
"name": "Иванов И.И."
},
"client": {
"address": "79999999999"
},
"agentType":"AGENT",
"items": [
{
"calculationMethod": "FULL_PAY",
"paymentSubject": "SERVICE",
"shipper":{
"name":"",
"inn":"1234567890",
},
"name": "Услуга",
"price": 100,
"quantity": 1,
"vat": "VAT_20",
"total": 100
}
],
"total": 100,
"payments": {
"CASH": 100
}
}
|
Response | |
|
257419 |
См. также
- Интеграция с Фискальным Процессингом
- Отправка чека на повторную фискализацию
- Авторизация в OAuth2 при помощи токена коннектора
- Авторизация в OAuth2 по refresh token
- Отправка документа на фискализацию в процессинг
- Отправка документа на фискализацию в процессинг (маркированный товар)
- Запрос информации о документе по ID
- Оффлайн возможности фискального процессинга
- Справочник Ошибок (ФП)