---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
alternate:
  - https://pay.yandex.ru/docs/en/custom/fns.md
  - https://pay.yandex.ru/docs/ru/custom/fns.md
  - href: en/custom/fns.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/en/llms.txt

# Sending receipts to the Federal Tax Service (54-FZ)

To make sure that receipts are automatically added to the [order/render](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-render.md) response for items in the cart (`cart.items`) and delivery options (`shipping.availableCourierOptions`), and to the [pickup-option-details](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/pickup-option-details.md) response for pickup options, fill out the `receipt` object in the following format:

```text
{
    "title": string,                    # Optional. 1030: Taxable object name
                                        # If omitted, it's populated by the parent title
    "tax": int,                         # 1199: VAT rate (values in Table 1)
    "measure": int,                     # 2108: Measurement unit code (see values in Table 2)
    "paymentMethodType": int            # Optional. 1214: Payment method (see values in Table 3)
    "paymentSubjectType": int           # Optional. 1212: Taxable object (see values in Table 4)
    "excise": decimal("100.0")          # Optional. 1229: Excise
    "productCode": string               # Optional. 1162: Product code (a base64-encoded array of 1 to 32 bytes)
    "markQuantity": {                   # Optional. 1291: Decimal quantity of marked product
        "numerator": int,               # 1293: Numerator
        "denominator": int,             # 1294: Denominator
    },
    "supplier": {                       # Optional. 1224: Supplier data
        "name": string,                 # 1225: Supplier name
        "inn": string,                  # 1226: Supplier INN (TIN)
        "phones": array<string>,        # 1171: supplier phone numbers in the format +79995554444
    },
    "agent": {                          # Optional. 1223: Agent details
        "agentType": int,               # 1222: Agent type by taxable object (see values in Table 5)
        "operation": string             # 1044: Payment agent operation
        "phones": array<string>,        # 1073: Payment agent phone numbers in the format +79995554444
        "transferOperator": {
            "name": string,             # 1026: Payment transfer operator
            "address": string,          # 1005: Payment transfer operator address
            "inn": string,              # 1016: Payment operator INN (TIN)
            "phones: array<string>,     # 1075: Payment transfer operator phone numbers in the format +79995554444
        },
        "paymentsOperator": {
            "phones: array<string>,     # 1074: Payment operator phone numbers in the format +79995554444
        }
    }
}
```

## Table 1. Values of `tax`: VAT rate (tag 1199) {#tax}

| Value | Description |
|----------|--------------------------------|
| 1 | VAT 20% |
| 2 | VAT 10% |
| 3 | VAT at 20/120 rate |
| 4 | VAT at 10/110 rate |
| 5 | VAT at 0% rate |
| 6 | Without VAT |

## Table 2. Values of `quantity.measure` - "measure of quantity of taxable object" (tag 2108) {#measure-code}

| Value | Description |
|----------|--------------------------------------------------|
| 0 | Pieces or units |
| 10 | Gram |
| 11 | Kilogram |
| 12 | Ton |
| 20 | Centimeter |
| 21 | Decimeter |
| 22 | Meter |
| 30 | Square centimeter |
| 31 | Square decimeter |
| 32 | Square meter |
| 40 | Milliliter |
| 41 | Liter |
| 42 | Cubic meter |
| 50 | Kilowatt hour |
| 51 | Gigacalorie |
| 70 | Day (24 hours) |
| 71 | Hour |
| 72 | Minute |
| 73 | Second |
| 80 | Kilobyte |
| 81 | Megabyte |
| 82 | Gigabyte |
| 83 | Terabyte |
| 255 | Reserved for other measurement units |

## Table 3. Values of `paymentMethodType`: "payment method ID" (tag 2108) {#payment-method-type}

| Value | Description |
|----------|-----------------------------------------------------------------------------------------------|
| 1 | Full prepayment before taxation object handover |
| 2 | Partial prepayment before taxation object handover |
| 3 | Advance payment |
| 4 | Full payment at taxation object handover |
| 5 | Partial payment of the taxation object at handover with the remainder paid on credit |
| 6 | Handover of the taxation object without a payment, with subsequent payment on credit |
| 7 | Payment of the taxation object after its handover on credit |

## Table 4. Values of `paymentSubjectType`: "taxable object type" (tag 1212) {#payment-subject-type}

| Value | Description |
|----------|--------------------------------------------------------------------------------------------------------------------------------|
| 1 | product |
| 2 | excisable product |
| 3 | work |
| 4 | service |
| 5 | gambling bet |
| 6 | gambling winning |
| 7 | lottery ticket |
| 8 | lottery winning |
| 9 | provision of intellectual output |
| 10 | payment |
| 11 | agency fee |
| 12 | composite taxable object |
| 13 | other taxable object |
| 14 | property right |
| 15 | non-sales revenue |
| 16 | social security contributions: regarding amounts of expenses that reduce the tax payable (advance payments) in accordance with clause 3.1 of article 346.21 of the Tax Code of the Russian Federation |
| 17 | sales tax |
| 18 | tourist tax |
| 19 | security deposit |
| 20 | expense: regarding the amounts of expenses incurred in accordance with Article 346.16 of the Tax Code of the Russian Federation that reduce income |
| 21 | mandatory pension insurance contributions for individual entrepreneurs |
| 22 | mandatory pension insurance contributions |
| 23 | mandatory medical insurance contributions for individual entrepreneurs |
| 24 | mandatory medical insurance contributions |
| 25 | mandatory social insurance contributions |
| 26 | casino payout |

## Table 5. Values of `agent.agentType` "agent type by taxable object" (tag 1222) {#agent-type}

| Value | Description |
|----------|-------------------------------|
| 1 | bank payment agent |
| 2 | bank payment subagent |
| 3 | payment agent |
| 4 |  subject |
| 5 | attorney |
| 6 | commission agent |
| 7 | other agent |