Облачная Касса: Отправка документа на фискализацию в процессинг (агентский товар): различия между версиями
Перейти к навигации
Перейти к поиску
Merkulov (обсуждение | вклад) |
Merkulov (обсуждение | вклад) |
||
Строка 43: | Строка 43: | ||
|content-left= | |content-left= | ||
* '''type''': тип фискального документа, см. раздел <b>[https://kassa.bifit.com/wiki/index.php?title=БИФИТ_ОНЛАЙН:_Интеграция_с_Фискальным_Процессингом#Нумераторы "Нумераторы"]</b> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | * '''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''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 49: | Строка 49: | ||
** '''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''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 125: | Строка 125: | ||
|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''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 132: | Строка 132: | ||
** '''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''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 197: | Строка 197: | ||
|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''': ФИО кассира, допускается вместе с ФИО указать должность кассира ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 204: | Строка 204: | ||
** '''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''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 304: | Строка 304: | ||
|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> ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
* '''contractorAddress''': адрес агента ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | * '''contractorAddress''': адрес агента ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
* '''contractorInn''': ИНН агента ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | * '''contractorInn''': ИНН агента ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') | ||
Строка 318: | Строка 318: | ||
** '''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''': цена товарной позиции с учетом примененной скидки/надбавки ('''ОБЯЗАТЕЛЬНЫЙ РЕКВИЗИТ''') |
Версия 11:35, 21 октября 2022
Запрос при работе по ФФД 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":"","phones":["+7"]}
}
],
"total": 100,
"payments": {
"CASH": 100
}
}
|
Response | |
|
257416 |
Запрос при работе по ФФД 1.05
Важно!
При работе по ФФД 1.05 в запросе на фискализацию документа с агентским товаром в процессинг, данные агента необходимо указывать в описание всего чека.
Запрос регистрации чека | 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"
|
Request Body | JSON структура |
|
{
"type": "SALE",
"taxSystem": "COMMON",
"contractorAddress": "г. Москва",
"contractorInn": "7719617469",
"contractorName": "АО БИФИТ",
"contractorPhone": "79999999999",
"organizationPhone": "79999999999",
"contractorActivityType": "AGENT",
"cashier": {
"name": "Иванов И.И."
},
"client": {
"address": "test@test.com"
},
"items": [
{
"calculationMethod": "FULL_PAY",
"paymentSubject": "PRODUCT",
"name": "Тест agent 1 запрос",
"price": 100.00,
"quantity": 1,
"vat": "VAT_20",
"total": 100.00
}
],
"total": 100.00,
"payments": {
"CASH": 100.00
}
}
|
Response | |
|
257419 |
См. также
- Интеграция с Фискальным Процессингом
- Отправка чека на повторную фискализацию
- Авторизация в OAuth2 при помощи токена коннектора
- Авторизация в OAuth2 по refresh token
- Отправка документа на фискализацию в процессинг
- Отправка документа на фискализацию в процессинг (маркированный товар)
- Запрос информации о документе по ID
- Оффлайн возможности фискального процессинга
- Справочник Ошибок (ФП)