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.
∟agent_info	No	1222	Agent attribute. See «Agent scheme».
∟supplier_info	Yes, if agent_info is passed	1224	Supplier details. See «Agent scheme».

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.
award	Payout. About a contribution toward payment of a penalty, fine, remuneration, bonus or other similar item.
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.
deposit	Pledge. About a pledge.
expense	Expense. About amounts of expenses incurred in accordance with Article 346.16 of the Tax Code of the Russian Federation that reduce income.
pension_insurance_ip	Mandatory pension insurance contributions of an individual entrepreneur. Paid by individual entrepreneurs who make no payments or other remuneration to individuals.
pension_insurance	Mandatory pension insurance contributions. Paid by organizations and individual entrepreneurs who make payments or other remuneration to individuals.
medical_insurance_ip	Mandatory medical insurance contributions of an individual entrepreneur. Paid by individual entrepreneurs who make no payments or other remuneration to individuals.
medical_insurance	Mandatory medical insurance contributions. Paid by organizations and individual entrepreneurs who make payments or other remuneration to individuals.
social_insurance	Mandatory social insurance contributions. Contributions for temporary disability and maternity insurance and for insurance against industrial accidents and occupational diseases.
casino_payment	Casino payment. About accepting and paying out funds in casino activities using casino exchange tokens, in a slot machine hall.
resort_fee	Tourist tax. About the tourist tax.

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

Agent scheme

If you operate under an agent scheme, each receipt item must carry the agent attribute (tag 1222) and the supplier details. This lets, for example, Romashka LLC issue a receipt naming Tulpan LLC as the supplier.

Both parameters are optional and are set per item, inside an items element. If agent_info is passed, supplier_info is required.

Limitation

The agent scheme is supported only by the ATOL Online provider. Other providers ignore the agent_info and supplier_info parameters.

fiscal_data example

{
  "items": [
    {
      "name": "Product name",
      "price": 10025,
      "quantity": 2,
      "sum": 20050,
      "payment_method": "full_payment",
      "payment_object": "commodity",
      "vat_type": "vat20",
      "agent_info": {
        "type": "commission_agent"
      },
      "supplier_info": {
        "name": "Tulpan LLC",
        "inn": "7712345678",
        "phones": ["+79001234567"]
      }
    }
  ],
  "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
agent_info	No	1222	Agent attributes.
∟type	Yes, if agent_info is passed	1222	Agent attribute. See possible values below.
∟paying_agent	No		Paying agent attributes.
∟∟operation	No	1044	Operation name. Maximum string length — 24 characters.
∟∟phones	No	1073	Paying agent's phone numbers. Array of strings.
∟receive_payments_operator	No		Payment reception operator attributes.
∟∟phones	No	1074	Payment reception operator's phone numbers. Array of strings.
∟money_transfer_operator	No		Money transfer operator attributes.
∟∟phones	No	1075	Money transfer operator's phone numbers. Array of strings.
∟∟name	No	1026	Money transfer operator's name. Maximum string length — 64 characters.
∟∟address	No	1005	Money transfer operator's address. Maximum string length — 256 characters.
∟∟inn	No	1016	Money transfer operator's INN. 10 or 12 digits.
supplier_info	Yes, if agent_info is passed	1224	Supplier attributes.
∟inn	Yes, if supplier_info is passed	1226	Supplier's INN. 10 or 12 digits. Pass it as a string, otherwise leading zeros are lost.
∟name	No. See the FFD 1.2 note	1225	Supplier's name. Maximum string length — 256 characters.
∟phones	No. See the FFD 1.2 note	1171	Supplier's phone numbers. Array of strings.

Pass a phone number together with its country code, without spaces or any characters other than «+». Maximum length — 19 characters.

FFD 1.2

If the agent attribute is bank_paying_agent, bank_paying_subagent, paying_agent or paying_subagent, then under FFD 1.2 the supplier_info.name and supplier_info.phones fields become required.

Agent data is passed to the fiscal service as is. If it does not meet the requirements above, the receipt is not registered, and the reason for the rejection is returned in the callback and is available in the receipt details.

Agent attribute

Value	Description
bank_paying_agent	Bank paying agent. Providing services to the customer (client) by a user acting as a bank paying agent.
bank_paying_subagent	Bank paying subagent. Providing services to the customer (client) by a user acting as a bank paying subagent.
paying_agent	Paying agent. Providing services to the customer (client) by a user acting as a paying agent.
paying_subagent	Paying subagent. Providing services to the customer (client) by a user acting as a paying subagent.
attorney	Attorney. Settling with the customer (client) by a user acting as an attorney.
commission_agent	Commission agent. Settling with the customer (client) by a user acting as a commission agent.
another	Another agent type. The user acts as an agent but is not a bank paying agent (subagent), paying agent (subagent), attorney or commission agent.