Fiscalization

Used to generate a fiscal receipt. When requesting a payment or payout, you need to build the fiscal_data parameter.

fiscal_data example

{
  "group": "Main",
  "items": [
    {
      "name": "Product name",
      "price": 10025,
      "quantity": 2,
      "sum": 20050,
      "measurement_unit": "kg",
      "payment_method": "full_payment",
      "payment_object": "commodity",
      "vat_type": "vat20"
    }
  ],
  "client": {
    "email": "client_email@mail.ru",
    "phone": "+71231234567"
  },
  "company": {
    "email": "company_email@mail.ru",
    "sno": "osn",
    "payment_address": "https://kvell.com",
    "inn": "1234567890"
  }
}

Parameter description

Parameter name	Required	FFD tag	Description
client	At least one of the fields — email or phone — must be filled in.		Customer data
∟email		1008	Customer's email address. Maximum string length — 64 characters.
∟phone		1008	Customer's phone number
company	Yes		Company data
∟email	Yes	1117	Receipt sender's email address. Maximum string length — 64 characters.
∟sno	Yes	1055	Tax system. See possible values below.
∟inn	Yes	1018	Company's INN (taxpayer ID)
∟payment_address	No	1187	Place of settlement. Maximum string length — 256 characters.
group	No		Group of devices used to print the receipt. Defaults to Main.
items	Yes		List of order items.
∟name	Yes	1030	Name of the item being settled.
∟price	Yes	1079	Price per unit of the item, including discounts and markups.
∟quantity	Yes	1023	Quantity/weight.
∟sum	No	1043	Amount in kopecks (price * quantity)
∟measurement_unit	No	1197	Unit of measurement for the goods, work, service, payment, payout, or other item being settled. Maximum string length — 16 characters.
∟payment_method	Yes	1214	Payment method attribute. See possible values below.
∟payment_object	Yes	1212	Payment subject attribute. See possible values below.
∟vat_type	Yes	1199	VAT rate. See possible values below.

Tax system

Value	Description
osn	General taxation system
usn_income	Simplified taxation system (income)
usn_income_outcome	Simplified taxation system (income minus expenses)
envd	Single tax on imputed income
esn	Unified agricultural tax
patent	Patent taxation system

Payment method attribute

Value	Description
full_prepayment	100% prepayment. Full advance payment made before the item is transferred.
prepayment	Prepayment. Partial advance payment made before the item is transferred.
advance	Advance
full_payment	Full settlement. Full payment, including any advance (prepayment), made at the moment the item is transferred.
partial_payment	Partial settlement and credit. Partial payment for the item at the moment of transfer, with the remainder paid on credit.
credit	Transfer on credit. Transfer of the item without payment at the moment of transfer, with subsequent payment on credit.
credit_payment	Credit payment. Payment for the item after its transfer, where it was transferred on credit (paying off the credit)

Payment subject attribute

Value	Description
commodity	Goods. About the goods being sold, excluding excisable goods (name and other details describing the goods).
excise	Excisable goods. About the excisable goods being sold (name and other details describing the goods).
job	Work. About the work being performed (name and other details describing the work).
service	Service. About the service being provided (name and other details describing the service).
gambling_bet	Gambling bet. About accepting bets in the course of gambling activities.
gambling_prize	Gambling winnings. About the payout of funds as winnings in the course of gambling activities.
lottery	Lottery ticket. About accepting funds for the sale of lottery tickets, electronic lottery tickets, or accepting lottery bets in the course of lottery activities.
lottery_prize	Lottery winnings. About the payout of funds as winnings in the course of lottery activities.
intellectual_activity	Provision of results of intellectual activity. About granting rights to use the results of intellectual activity or means of individualization.
payment	Payment. About an advance, deposit, prepayment, credit, contribution toward payment, penalty, fine, remuneration, bonus, or other similar item being settled.
agent_commission	Agent commission. About the remuneration of a user acting as a payment agent (subagent), bank payment agent (subagent), commission agent, attorney, or other agent.
composite	Composite item. About an item consisting of parts, each of which may be assigned one of the attribute values listed above.
another	Other item. About an item that does not fall under the items listed above.
property_right	Property right. About the transfer of property rights.
non_operating_gain	Non-operating income. About non-operating income.
insurance_premium	Insurance contributions. About amounts of expenses that reduce the tax (advance payment) amount in accordance with clause 3.1 of Article 346.21 of the Tax Code of the Russian Federation.
sales_tax	Trade levy (торговый сбор). Amounts paid as the Russian trade levy.
resort_fee	Resort fee. About the resort fee.

VAT rate

Value	Description
none	no VAT
vat0	VAT at a rate of 0%
vat10	VAT at a rate of 10%
vat18	VAT at a rate of 18%
vat110	VAT at the calculated rate of 10/110
vat118	VAT at the calculated rate of 18/118
vat20	VAT at a rate of 20%
vat22	VAT at a rate of 22%
vat120	VAT at the calculated rate of 20/120
vat122	VAT at the calculated rate of 22/122
vat5	VAT at a rate of 5%
vat7	VAT at a rate of 7%
vat105	VAT at the calculated rate of 5/105
vat107	VAT at the calculated rate of 7/107