How Self-Employed Generate Yookassa Receipts Manually

Self-employed individuals using Yookassa can generate fiscal receipts manually through the platform’s API by sending a POST request to the /receipts endpoint with details like client info, tax system code (e.g., 1 for simplified taxation), and item breakdowns. Once created, these receipts attach to payments or refunds and get automatically forwarded to tax authorities and clients via email or phone. This workaround ensures compliance with Russian Federal Law 422-FZ without relying on discontinued automatic generation, which ended after December 29, 2025.

Contents

• What Is a Self-Employed Receipt and Why Yookassa Doesn’t Generate It Automatically
• How to Generate Self-Employed Receipts via Yookassa API
• Integrating Self-Employed Receipts with the My Tax App
• Sending Self-Employed Receipts to Clients and Tax Authorities
• Yookassa for Self-Employed: Receipts from Yookassa and Alternatives
• Common Mistakes with Self-Employed Receipts
• Creating and Verifying Receipts in the My Tax App
• Sources
• Conclusion

What Is a Self-Employed Receipt and Why Yookassa Doesn’t Generate It Automatically

Picture this: you’re a freelancer wrapping up a gig, payment hits your Yookassa account, but no tidy fiscal receipt pops out for your client or the taxman. That’s the reality for self-employed folks in Russia—known as самозанятые—under the special tax regime from Federal Law 422-FZ. A self-employed receipt, or чек самозанятого, isn’t just a polite thank-you note. It’s a legal document proving income, taxes calculated at 4-6%, and compliance. It lists the service or good, amount, your details, client’s contact, and tax system code.

Yookassa used to handle this automatically, but not anymore. As of late 2025, automatic receipt generation for self-employed users stopped cold—think December 29, 2025, as the cutoff. Why? Tax rules tightened, pushing responsibility back to you. Platforms like Yookassa now say: register income manually in the “My Tax” (Мой налог) app yourself, then issue receipts to clients and authorities on your own dime. No more free ride with an online cash register baked in. Yookassa’s basics guide spells it out: self-employed must handle this independently to avoid fines.

But here’s the good news. Yookassa didn’t leave you high and dry. Their API steps in as the hero, letting you craft receipts programmatically. It’s not as plug-and-play, but it works seamlessly for payments and refunds.

How to Generate Self-Employed Receipts via Yookassa API

Ready to roll up your sleeves? Generating a self-employed receipt on Yookassa boils down to one key API call: POST to /receipts or the newer /v3/receipts endpoint. You’ll need your shop ID, secret key (grabbed from the Yookassa dashboard), and some JSON magic.

First, authenticate with OAuth or API keys—standard stuff. Then, build your payload. Here’s a bare-bones example for a service sale:

{
 "receipt": {
 "tax_system_code": 1,
 "customer": {
 "full_name": "Иван Иванов",
 "email": "ivan@example.com",
 "phone": "+79001234567"
 },
 "items": [
 {
 "description": "Консультация по разработке",
 "quantity": 1,
 "amount": {
 "value": "5000.00",
 "currency": "RUB"
 },
 "vat_code": 2,
 "payment_mode": "full_payment",
 "payment_subject": "service"
 }
 ],
 "payment_id": "payment-uuid-here" // Or "refund_id" for returns
 }
}

Hit that endpoint, and boom—receipt ID returns. Tax_system_code 1 means simplified self-employed regime; swap to 2 if you’re on the general one. Attach it to an existing payment or refund ID, and Yookassa handles the fiscalization.

For standalone receipts without a payment link (handy for cash or other methods), use the “Receipts from Yookassa” feature via /v3/receipts. Yookassa’s self-employed API docs walk through edge cases, like multiple items or zero-tax services. Test in sandbox first—don’t mess up live taxes.

What if you’re not a coder? Tools like Postman or Zapier integrations can fire this off. Or script it in Python/Node.js for bulk. Takes minutes once set up.

Integrating Self-Employed Receipts with the My Tax App

Yookassa’s receipts don’t magically sync to your “My Tax” app—that’s on you. But integration is straightforward. After API generation, the receipt data (amount, date, client) feeds directly into income registration.

Step 1: Log into Мой налог (iOS/Android/web). Step 2: Hit “Add income” and input details matching your Yookassa receipt. Or snap a photo of the receipt PDF—app OCRs it sometimes. Tax calculates automatically (4% individuals, 6% companies).

Yookassa sends the fiscalized version to authorities automatically upon API success, so double-check: your personal cabinet shows sent status via GET /receipts/{id}. No mismatches? You’re golden. This dual setup ensures clients get their copy, taxes get filed, and you dodge audits.

Pro tip: Export Yookassa reports monthly, cross-reference with app entries. Tools like 1C or custom bots automate this for high-volume self-employed hustlers.

Sending Self-Employed Receipts to Clients and Tax Authorities

Sending? Easiest part. Clients get it auto-delivered if you included email/phone in the API payload—Yookassa emails a PDF link or SMS with fiscal data. Download via GET /{receipt_id} for manual shares (WhatsApp, email).

Tax authorities? Handled server-side. Yookassa’s OFD (fiscal data operator) punches it through to FNS instantly. Verify status in dashboard or My Tax—receipt number (fiscal sign) appears for checks.

Timeline matters: Issue within 9 months for retroactive, but real-time is best. Clients request? Regenerate or duplicate via API. Scenario extensions in Yookassa docs cover deletes too (DELETE /{id} if errors).

Clients love the professionalism—links to verifiable fiscal.ya.ru checks. Authorities? Compliant, no fines.

Yookassa for Self-Employed: Receipts from Yookassa and Alternatives

“Receipts from Yookassa” (Чеки от ЮKassa) is your no-hassle sidekick. Activate in dashboard, pay a small fee per receipt (cheaper than full online cash registers). Generates on-demand without payments tied—perfect for offline gigs.

Still need more? Skip hardware cash registers entirely. Alternatives: Tinkoff, Sber, or Atol Online for self-employed bundles. But Yookassa shines for API lovers—integrates with sites, Telegram bots, you name it.

Since 2026, with auto-gen gone, this setup’s essential. Fees? Pennies compared to 54-FZ fines (up to 10k RUB first offense).

Common Mistakes with Self-Employed Receipts

Ever tried issuing a self-employed receipt retroactively? Tempting for forgotten gigs, but risky. Allowed within 9 months, yet tax audits flag patterns. Mismatch dates/payment IDs? Receipt fails fiscalization.

Other pitfalls: Wrong tax_system_code (boom, rejected). No client details? Can’t send. VAT code errors for services (use 2 for none). Fines stack: 3k RUB for no receipt, 20% tax underpay.

Annul via DELETE API if busted early. Always log—dashboard audits trail saves butts.

Create and Verify Receipts in the My Tax App

Fallback: Pure app method. In Мой налог, “Issue receipt” → client details → amount/service → generate QR/link. Share instantly. Verify? Scan fiscal QR or search by number on check.fns.ru.

Cross-check Yookassa: Matches? Done. App-only works for low volume; API scales.

Sources

1. Yookassa Self-Employed Receipts Basics — Guide to manual API generation for self-employed fiscal receipts: https://yookassa.ru/developers/payment-acceptance/receipts/self-employed/basics
2. Yookassa Receipts Basics — Overview of receipt handling and self-employed responsibilities: https://yookassa.ru/developers/payment-acceptance/receipts/basics
3. Yookassa Scenario Extensions for Self-Employed Receipts — Details on v3 API, standalone receipts, and sending: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/receipts/self-employed/basics

Conclusion

Mastering self-employed receipts on Yookassa means leaning on the API—POST your JSON, let it fly to clients and FNS. Pair with My Tax for bulletproof records, sidestep fines, and keep hustling legally. It’s a shift from auto-magic, but empowering: control your fiscal flow, scale effortlessly. Dive into the docs, test small, and watch compliance become second nature.