Reference for receipt parameter values
Below are the possible values for the following parameters of the
receipt
object as well as the request parameters for creating a receipt :- tax systems codes;
- VAT rates codes;
- payment subject attributes;
- payment mode;
- unit of measurement of product quantity;
- payment type;
- agent type.
Tax systems codes
Tax system code is specified in the
tax_system_code
parameter.Possible value is a number from 1 to 6.
Code | Tax system |
---|---|
1 | General tax system |
2 | Simplified (STS, income) |
3 | Simplified (STS, income with costs deducted) |
4 | Unified tax on imputed income (ENVD) |
5 | Unified agricultural tax (ESN) |
6 | Patent Based Tax System |
Items with different
tax_system_code
values should be included in different receipts.VAT rates codes
VAT rate code is specified in the
vat_code
parameter.Possible value is a number from 1 to 10.
Code | VAT rate |
---|---|
1 | VAT not included |
2 | 0% VAT rate |
3 | 10% VAT rate |
4 | 20% VAT rate |
5 | 10/110 estimate VAT rate |
6 | 20/120 estimate VAT rate |
7 | 5% VAT rate |
8 | 7% VAT rate |
9 | 5/105 estimate VAT rate |
10 | 7/107 estimate VAT rate |
Special VAT rates 5% and 7%
On January 1, 2025, new VAT rates were introduced for those who work under the simplified taxation system (STS). In addition to standard VAT rates (20%, 10%, 0%), two more new special rates have been added: 5% and 7%.
If you'd like to specify data receipt details using new VAT rates:
Step 1. Make sure your online sales register already supports these rates. List of online sales register providers that are ready to work with the new VAT rates
Step 2. If you use Evotor, configure the sales register: connect the new rates using the instruction.
Step 3. Start specifying the VAT rate code that you need in the
vat_code
parameter.Done!
If the sales register doesn't support new VAT rates yet, follow the recommendations of the Federal Tax Service. How to send requests if the online sales register doesn't support new rates
List of online sales register providers that are ready to work with the new VAT rates
Name of the online sales register | Support of 5% and 7% VAT rates |
---|---|
ATOL Online | Supports ✅ |
Business.Ru | Supports ✅ |
Kit Invest | Supports ✅ |
KOMTET Kassa | Supports ✅ |
ModulKassa | Supports ✅ |
1-OFD | Doesn't support ❌ |
Evotor | Supports ✅ You need to connect the new rates separately on the sales register's side using the instruction |
aQsi online | Supports ✅ |
digitalkassa | Supports ✅ |
LIFE PAY | Supports ✅ |
Mertrade | Supports ✅ |
Orange Data | Supports ✅ |
RocketR | Supports ✅ |
How to send the data for receipts if the online sales register doesn't support the new rates
If your online sales register doesn't support the VAT rates of 5% and 7% yet, then according to recommendations of the Federal Tax Service, you may temporarily continue to create receipts following the former rules, but you should include the VAT in the payment amount.
When you send the request with the data for the receipt:
- Specify the
items.vat_code
parameter with the1
("No VAT") value. - Specify the product price with a special VAT rate (5% or 7%) in the
items.amount
parameter. - In the total payment or refund amount (
amount
), set the amount for all products considering new VAT rates.
This is a temporary solution. Once your online sales register starts supporting new rates, you'll need to start creating receipts using new VAT rates.
Payment subject attributes
The payment subject attribute is specified in the
payment_subject
parameter.Possible values:
Value | Description |
---|---|
Available starting from FFD 1.05 | |
commodity | Product |
excise | Excisable goods |
job | Job |
service | Service |
payment | Payment |
casino | Платеж казино |
gambling_bet | Gambling bet |
gambling_prize | Gambling winnings |
lottery | Lottery ticket |
lottery_prize | Lottery winnings |
intellectual_activity | Intellectual property |
agent_commission | Agent’s commission |
property_right | Property rights |
non_operating_gain | Non-operating income |
insurance_premium | Insurance tax |
sales_tax | Sales tax |
resort_fee | Resort fee |
composite | Several subjects |
another | Another |
Available starting from FFD 1.2 | |
marked | Product which must be marked with the means of identification which has a marking code, except excisable products ("ТМ" in the receipt). Example: footwear, perfume, or light industry |
non_marked | Product which must be marked with the means of identification which doesn't have a marking code, except excisable products (ТНМ in the receipt). Example: fur products |
marked_excise | Excisable product which must be marked with the means of identification which has a marking code (АТМ in the receipt). Example: tobacco |
non_marked_excise | Excisable product which must be marked with the means of identification which doesn't have a marking code (АТНМ in the receipt). Example: alcohol products |
fine | Payout |
tax | Insurance payments |
lien | Loan |
cost | Expenses |
agent_withdrawals | Cash withdrawal |
pension_insurance_without_payouts | Mandatory pension insurance payments for sole proprietors |
pension_insurance_with_payouts | Mandatory pension insurance payments |
health_insurance_without_payouts | Mandatory health insurance payments for sole proprietors |
health_insurance_with_payouts | Mandatory health insurance payments |
health_insurance | Mandatory social insurance payments |
Payment method attributes
The payment method attribute is specified in the
payment_mode
parameter.Possible values:
Value | Description |
---|---|
full_prepayment | Full prepayment |
partial_prepayment | Partial prepayment |
advance | Advance payment |
full_payment | Full payment |
partial_payment | Partial payment and loan |
credit | Loan |
credit_payment | Loan repayment |
Unit of measurement of product quantity
Unit of measurement of product quantity is specified in the
items
array in the measure
parameter. This parameter must be specified starting from FFD 1.2.Possible values:
Value | Description |
---|---|
piece | Product item, piece, or unit |
gram | Gram |
kilogram | Kilogram |
ton | Ton |
centimeter | Centimeter |
decimeter | Decimeter |
meter | Meter |
square_centimeter | Square centimeter |
square_decimeter | Square decimeter |
square_meter | Square meter |
milliliter | Millimeter |
liter | Liter |
cubic_meter | Cubic meter |
kilowatt_hour | Kilowatt-hour |
gigacalorie | Gigacalorie |
day | Day (24 hours) |
hour | Hour |
minute | Minute |
second | Second |
kilobyte | Kilobyte |
megabyte | Megabyte |
gigabyte | Gigabyte |
terabyte | Terabyte |
another | Another |
Payment type
The payment type is specified in the
type
parameter of the settlements
massive in the request for creating a receipt .Possible values:
Value | Description |
---|---|
cashless | Cashless payment |
prepayment | Prepayment (advance payment) |
postpayment | Postpayment (loan) |
consideration | Consideration |
Agent type
Agent type is specified in the
agent_type
parameter of the items
array in the request for creating a receipt , if you send data for creating receipts using the Receipt after payment scenario. The agent_type
parameter is provided for by the format of fiscal documents (FFD) and is mandatory for version 1.1 and later. Make sure your online sales register is updated to FFD 1.1.Possible values:
Value | Description |
---|---|
banking_payment_agent | Banking payment agent |
banking_payment_subagent | Banking payment subagent |
payment_agent | Payment agent |
payment_subagent | Payment subagent |
attorney | Attorney |
commissioner | Broker |
agent | Agent |
See also