# VCR — Virtual Cash Register (Full Reference)

> Free electronic cash register for Armenian businesses. Register sales, prepayments, and refunds with Armenia's State Revenue Committee — fully online, no hardware needed.

---

## Company

- Legal entity: Blob Solutions LLC
- TIN: 02906081
- Country: Armenia
- Contact: support@vcr.am
- Website: https://vcr.am

## Service Overview

VCR is a cloud-based fiscalization platform for Armenian businesses. It connects to Armenia's State Revenue Committee (SRC) to register trade operations and issue legally compliant electronic receipts in PDF format.

### Problem VCR Solves

Armenian businesses that sell goods or services are legally required to register each transaction with the SRC using an electronic cash register. Traditional solutions require:
- Physical cash register hardware
- Server infrastructure and maintenance
- Complex certificate management (CSR/CRT files, mTLS)
- Deep knowledge of SRC API intricacies

VCR eliminates all of these requirements by providing a managed cloud service.

### Pricing

- Free for all Armenian businesses
- No monthly fees, no setup costs, no per-transaction fees, no hidden charges

### Supported Entity Types

- Sole proprietorship (SP)
- Limited liability company (LLC)
- Branch offices
- Other entity types registered in Armenia

## Features

### Web Interface
- Sales registration with receipt generation
- Prepayment registration and tracking
- Refund processing (full and partial)
- Offer/product catalog management
- Department management
- Multi-user support with individual cashier PIN codes
- Dashboard with transaction history

### REST API
- Full CRUD for sales, prepayments, refunds
- Offer management
- Authorization via X-API-KEY header
- OpenAPI specification available at: https://vcr.am/api/v1/openapi.json (generated from Zod schemas at runtime)
- Sandbox OpenAPI specification: https://vcr.am/api/sandbox/v1/openapi.json
- Node.js SDK: @blob-solutions/vcr-am-sdk (https://npmjs.com/package/@blob-solutions/vcr-am-sdk)

### Receipts
- Automatic PDF receipt generation
- Email delivery to customers
- Each receipt contains SRC-assigned transaction ID
- Receipts are legally valid fiscal documents

### Integration Requirements
Each offer (product/service) must include:
1. A code from the commodity classifier (for goods) or economic activity classifier (for services)
2. Unit of measurement (kg, pcs, m2, hour, service, etc.)
3. Department ID
4. Cashier ID for the transaction

### API Authentication
All API requests require the X-API-KEY header:
```
X-API-KEY: your_API_key
```
API keys are generated in cash register settings. Do not expose keys publicly.

### API Error Codes
- 400 Bad Request — Invalid request
- 401 Unauthorized — Invalid or missing API key
- 403 Forbidden — Access denied
- 404 Not Found — Resource not found
- 500 Internal Server Error — Server error

## How to Get Started

1. Sign up at https://vcr.am with your email address
2. Add your business entity (SP, LLC, etc.)
3. Register a cash register through Armenia's Electronic Reporting System (file-online.taxservice.am):
   - Download a CSR file from VCR
   - Submit a cash register registration application in the ERS
   - Attach the CSR file to the application
   - Sign the application with your digital signature
   - Download the resulting CRT file
   - Upload the CRT file back to VCR
4. Start registering sales via web interface or API

Detailed setup guide: https://vcr.am/en/p/submit-cash-register

## Classifiers

VCR provides built-in classifiers for:
- Economic activities (for services): https://vcr.am/en/classifier/activity
- Goods/commodities: https://vcr.am/en/classifier/goods

These classifiers are required by the SRC for each transaction item.

## Security

- VCR does NOT process payments, provide acquiring, or handle money transfers
- VCR only registers transactions with the tax authority
- Communication with SRC uses mTLS (mutual TLS) certificates
- User authentication via magic link emails (passwordless)

## Comparison: VCR vs On-Premise Solutions

### VCR (Cloud)
- No hardware needed
- No server maintenance
- Free with pay-per-transaction model
- Pre-built web interface
- Developer-friendly API
- Automated certificate management
- Dedicated support

### On-Premise
- Server maintenance costs
- Developer fees for integration
- Manual JKS/CSR/CRT certificate setup
- Limited documentation
- Requires deep SRC API knowledge
- PDF receipt generation responsibility
- Additional hidden expenses

## Frequently Asked Questions

### Does VCR process payments?
No. VCR registers transactions with the tax authority — it does not process payments, provide acquiring, or handle money transfers. You need a separate payment provider for that.

### Is VCR really free?
Yes. VCR is free for all Armenian businesses — no monthly fees, no setup costs, no per-transaction fees, no hidden charges.

### Do I need special hardware?
No. VCR works in any web browser on any device — smartphone, tablet, or laptop. No physical cash register needed.

### Can I integrate VCR with my website?
Yes. VCR provides a REST API with clear documentation. You can automate sales registration, prepayments, and refunds directly from your system.

## All Pages

- Homepage: https://vcr.am/en
- About: https://vcr.am/en/p/about
- API Documentation: https://vcr.am/en/p/docs/v1
- Interactive API Explorer: https://vcr.am/en/p/docs/v1/reference
- Sandbox Interactive API Explorer: https://vcr.am/en/p/docs/sandbox/v1/reference
- OpenAPI Spec (JSON): https://vcr.am/api/v1/openapi.json
- Sandbox OpenAPI Spec (JSON): https://vcr.am/api/sandbox/v1/openapi.json
- Cash Register Setup Guide: https://vcr.am/en/p/submit-cash-register
- How to Check Transactions: https://vcr.am/en/p/how-to-check-transactions
- How to Deregister Cash Register: https://vcr.am/en/p/how-to-deregiser-cash-register
- Activity Classifier: https://vcr.am/en/classifier/activity
- Goods Classifier: https://vcr.am/en/classifier/goods
- Privacy Policy: https://vcr.am/en/legal/privacy
- Cookies Policy: https://vcr.am/en/legal/cookies
- Public Offer (Terms): https://vcr.am/en/legal/terms
- Security — Site: https://vcr.am/en/p/security/site

## Locales

All pages are available in three languages:
- English: /en/...
- Russian: /ru/...
- Armenian: /hy/...

Replace `/en/` with `/ru/` or `/hy/` in any URL above.