Saraf Fiscal — фискальный модуль ОФД Saraf Fiscal — OFD fiskal moduli

Что понадобитсяNima kerak bo'ladi

• Компьютер с Windows 10 или 11 (64-бит) — тот, на котором работает касса или к которому она подключена по сети.Windows 10 yoki 11 (64-bit) kompyuter — kassa ishlaydigan yoki tarmoq orqali ulangan kompyuter.
• Фискальный модуль «Янги Технологиялар» (USB-ключ) с ридером. ФМ выдаёт и регистрирует ОФД «Янги Технологиялар».«Yangi Texnologiyalar» fiskal moduli (USB-kalit) va o'quvchi qurilma. FMni «Yangi Texnologiyalar» OFD beradi va ro'yxatdan o'tkazadi.
• Служба FiscalDriveService — государственная программа для работы с ФМ (установщик — в Загрузках).FiscalDriveService xizmati — FM bilan ishlash uchun davlat dasturi (o'rnatuvchi — Yuklab olish bo'limida).
• Интернет — для отправки чеков в ОФД и продления лицензии. Без связи программа работает до 72 часов, ФМ копит чеки до 2 суток.Internet — cheklarni OFDga yuborish va litsenziyani uzaytirish uchun. Aloqasiz dastur 72 soatgacha ishlaydi, FM cheklarni 2 sutkagacha to'playdi.
• Лицензия Saraf Fiscal на этот ФМ: 99 000 сум в месяц или 990 000 сум в год — оформляется в личном кабинете.Shu FM uchun Saraf Fiscal litsenziyasi: oyiga 99 000 so'm yoki yiliga 990 000 so'm — shaxsiy kabinetda rasmiylashtiriladi.

УстановкаO'rnatish

1. Скачайте и установите FiscalDriveService (установщик 10.2.2). Установщик запускайте от имени администратора. После установки откройте Службы Windows (Win+R → services.msc), найдите службу FiscalDriveService, поставьте тип запуска «Автоматически» и запустите её.FiscalDriveServiceni yuklab oling va o'rnating (10.2.2 o'rnatuvchisi). O'rnatuvchini administrator nomidan ishga tushiring. O'rnatgandan so'ng Windows Xizmatlarini oching (Win+R → services.msc), FiscalDriveService xizmatini toping, ishga tushirish turini «Avtomatik» qiling va uni ishga tushiring.
2. Вставьте фискальный модуль в ридер и подключите ридер к компьютеру.Fiskal modulni o'quvchiga qo'ying va o'quvchini kompyuterga ulang.
3. Скачайте установщик Saraf Fiscal и запустите его. Права администратора не нужны: программа ставится для текущего пользователя, на рабочем столе и в «Пуске» появится ярлык «Saraf Fiscal».Saraf Fiscal o'rnatuvchisini yuklab oling va ishga tushiring. Administrator huquqi kerak emas: dastur joriy foydalanuvchi uchun o'rnatiladi, ish stolida va «Пуск»da «Saraf Fiscal» yorlig'i paydo bo'ladi.
4. После установки программа запустится и сядет в трей (значок «S» у часов). Закрытие окна не останавливает программу — касса продолжает работать. Полностью выйти можно из меню значка в трее → «Выход». Программа сама запускается вместе с Windows.O'rnatilgandan keyin dastur ishga tushadi va treyga tushadi (soat yonidagi «S» belgisi). Oynani yopish dasturni to'xtatmaydi — kassa ishlashda davom etadi. To'liq chiqish — treydagi belgi menyusidan → «Выход». Dastur Windows bilan birga o'zi ishga tushadi.
5. Откройте окно программы → вкладка «Статус». В карточке «Фискальный модуль» должны появиться серийный номер ФМ и состояние «Активен». Если ФМ заблокирован ОФД — нажмите «Синхронизировать состояние».Dastur oynasini oching → «Статус» bo'limi. «Фискальный модуль» kartasida FM seriya raqami va «Активен» holati paydo bo'lishi kerak. FM OFD tomonidan bloklangan bo'lsa — «Синхронизировать состояние»ni bosing.

ЛицензияLitsenziya

1. Войдите в my.saraf.uz, откройте Тарифы → Saraf Fiscal, выберите месяц или год и оплатите (Click, Payme или по счёту).my.saraf.uzga kiring, Tariflar → Saraf Fiscalni oching, oy yoki yilni tanlang va to'lang (Click, Payme yoki hisob-faktura bo'yicha).
2. После оплаты в истории платежей кабинета появится код активации с подсказкой «введите код в приложении Saraf Fiscal».To'lovdan keyin kabinetning to'lovlar tarixida «введите код в приложении Saraf Fiscal» izohi bilan faollashtirish kodi paydo bo'ladi.
3. В Saraf Fiscal откройте вкладку «Лицензия», вставьте код и нажмите «Активировать». ФМ должен быть вставлен: лицензия оформляется на его серийный номер.Saraf Fiscal'da «Лицензия» bo'limini oching, kodni kiriting va «Активировать»ni bosing. FM qo'yilgan bo'lishi kerak: litsenziya uning seriya raqamiga rasmiylashtiriladi.

Программа сама продлевает лицензию через интернет каждые 30 минут; без связи она действует до 72 часов. Без действующей лицензии новые чеки и смены не регистрируются, а уже пробитые чеки по-прежнему отправляются в ОФД. Для продления оплатите новый период в кабинете и введите полученный код на вкладке «Лицензия» — срок добавится к текущему.Dastur litsenziyani internet orqali har 30 daqiqada o'zi uzaytiradi; aloqasiz u 72 soatgacha amal qiladi. Amaldagi litsenziyasiz yangi cheklar va smenalar ro'yxatdan o'tmaydi, allaqachon urilgan cheklar esa OFDga yuborilaveradi. Uzaytirish uchun kabinetda yangi davrni to'lang va olingan kodni «Лицензия» bo'limida kiriting — muddat joriy muddatga qo'shiladi.

Привязка ФМFMni bog'lash

Новый ФМ нужно один раз привязать к Saraf Fiscal ключом центра техобслуживания (ЦТО) Mirico. Без привязки ФМ не примет чек.Yangi FMni bir marta Mirico texnik xizmat ko'rsatish markazi (TXM) kaliti bilan Saraf Fiscal'ga bog'lash kerak. Bog'lanmasa FM chekni qabul qilmaydi.

1. Активируйте лицензию (см. выше). На вкладке «Лицензия» появится кнопка «Привязать ФМ к Saraf Fiscal».Litsenziyani faollashtiring (yuqoriga qarang). «Лицензия» bo'limida «Привязать ФМ к Saraf Fiscal» tugmasi paydo bo'ladi.
2. Нажмите её и подтвердите. На вкладке «Статус» привязка станет «Привязан».Uni bosing va tasdiqlang. «Статус» bo'limida bog'lanish «Привязан» bo'ladi.

Важно: привязку нельзя снять самостоятельно — отвязать ФМ может только ОФД. Если ФМ уже привязан к другой программе, обратитесь в ОФД «Янги Технологиялар» для отвязки.Muhim: bog'lanishni mustaqil olib tashlab bo'lmaydi — FMni faqat OFD ajrata oladi. FM boshqa dasturga bog'langan bo'lsa, ajratish uchun «Yangi Texnologiyalar» OFDga murojaat qiling.

Ежедневная работаKundalik ish

• Касса отправляет чеки в Saraf Fiscal сама — открывать окно программы не нужно. Смена ФМ открывается автоматически на первом чеке.Kassa cheklarni Saraf Fiscal'ga o'zi yuboradi — dastur oynasini ochish shart emas. FM smenasi birinchi chekda avtomatik ochiladi.
• Чеки уходят в ОФД автоматически: через несколько секунд после чека и каждые 5 минут. Кнопка «Отправить в ОФД» на вкладке «Статус» — отправить сразу.Cheklar OFDga avtomatik ketadi: chekdan bir necha soniya keyin va har 5 daqiqada. «Статус» bo'limidagi «Отправить в ОФД» tugmasi — darhol yuborish.
• Если чеки не уходили в ОФД больше суток, на вкладке «Статус» появится предупреждение. Через 2 суток без отправки ФМ перестанет принимать новые чеки — проверьте интернет.Cheklar bir sutkadan ortiq OFDga ketmagan bo'lsa, «Статус» bo'limida ogohlantirish chiqadi. 2 sutka yuborilmasa FM yangi cheklarni qabul qilmay qo'yadi — internetni tekshiring.
• Закрывайте смену (Z-отчёт) в конце дня — из кассовой программы или кнопкой на вкладке «Смены».Smenani (Z-hisobot) kun oxirida yoping — kassa dasturidan yoki «Смены» bo'limidagi tugma bilan.

Чеки и сменыCheklar va smenalar

• «Чеки» — все чеки, пробитые через Saraf Fiscal на этом компьютере: поиск по номеру чека, фискальному признаку, номеру чека кассы или товару, фильтр по датам и типу операции, итоги продаж и возвратов. Нажмите на чек — откроется карточка с позициями, оплатами и НДС. Из карточки можно напечатать копию чека (лента 80 или 58 мм, с QR-кодом проверки) и проверить чек на сайте ОФД.«Чеки» — shu kompyuterda Saraf Fiscal orqali urilgan barcha cheklar: chek raqami, fiskal belgi, kassa chek raqami yoki tovar bo'yicha qidiruv, sanalar va operatsiya turi bo'yicha filtr, savdo va qaytarishlar yakunlari. Chekni bosing — pozitsiyalar, to'lovlar va QQS bilan karta ochiladi. Kartadan chek nusxasini chop etish (80 yoki 58 mm lenta, tekshirish QR-kodi bilan) va chekni OFD saytida tekshirish mumkin.
• «Смены» — смены ФМ: время открытия и закрытия, диапазон номеров чеков, продажи и возвраты, наличные, безнал и НДС. Кнопка «Закрыть смену (Z-отчёт)» закрывает текущую смену; Z-отчёт уходит в ОФД автоматически. Пустую смену ФМ не закрывает.«Смены» — FM smenalari: ochilish va yopilish vaqti, chek raqamlari oralig'i, savdo va qaytarishlar, naqd, naqdsiz va QQS. «Закрыть смену (Z-отчёт)» tugmasi joriy smenani yopadi; Z-hisobot OFDga avtomatik ketadi. Bo'sh smenani FM yopmaydi.
• «Журнал запросов» — последние 200 запросов касс с результатом: удобно, чтобы понять, доходят ли чеки от кассы.«Журнал запросов» — natijasi bilan kassalarning oxirgi 200 ta so'rovi: kassadan cheklar yetib kelayotganini tushunish uchun qulay.

Подключение Saraf POSSaraf POS'ni ulash

1. Установите Saraf Fiscal на компьютер кассы Saraf POS (см. Установка), активируйте лицензию и привяжите ФМ.Saraf Fiscal'ni Saraf POS kassasi kompyuteriga o'rnating (qarang: O'rnatish), litsenziyani faollashtiring va FMni bog'lang.
2. В бэк-офисе Saraf POS откройте Настройки → Фискализация → «Добавить оператора», выберите адаптер «Saraf Fiscal». Адрес подставится сам: http://127.0.0.1:8350/api/v1/receipt. Укажите ИНН и название организации для чека. Токен заполняйте, только если он задан в настройках Saraf Fiscal.Saraf POS bek-ofisida Sozlamalar → Fiskalizatsiya → «Operator qo'shish»ni oching, «Saraf Fiscal» adapterini tanlang. Manzil o'zi qo'yiladi: http://127.0.0.1:8350/api/v1/receipt. Chek uchun tashkilot STIR va nomini ko'rsating. Tokenni faqat Saraf Fiscal sozlamalarida berilgan bo'lsa to'ldiring.
3. Откройте Настройки → Терминалы, выберите кассу и в разделе оборудования укажите этого оператора кассы. Сохраните.Sozlamalar → Terminallarni oching, kassani tanlang va jihozlar bo'limida shu kassa operatorini ko'rsating. Saqlang.
4. Пробейте тестовую продажу: в чеке появятся фискальный признак и QR-код, а в Saraf Fiscal — запись на вкладке «Чеки».Sinov savdosini uring: chekda fiskal belgi va QR-kod, Saraf Fiscal'da esa «Чеки» bo'limida yozuv paydo bo'ladi.

Оплаты с списанием через QR покупателя, динамический UzQR и пин-пад с оператором Saraf Fiscal пока недоступны — касса предупредит об этом до оплаты.Saraf Fiscal operatori bilan xaridor QR'i, dinamik UzQR va pin-pad orqali yechib olinadigan to'lovlar hozircha mavjud emas — kassa bu haqda to'lovdan oldin ogohlantiradi.

API для кассовых программKassa dasturlari uchun API

Любая кассовая программа на том же компьютере (или браузерная касса) отправляет запросы на локальный адрес Saraf Fiscal:Shu kompyuterdagi istalgan kassa dasturi (yoki brauzer kassasi) so'rovlarni Saraf Fiscal'ning lokal manziliga yuboradi:

POST http://127.0.0.1:8350/api/v1/receipt
Content-Type: application/json

Тело — JSON с полем method; если в настройках задан токен — ещё поле token. Ответ всегда HTTP 200 с JSON {"error": false, "message": …} или {"error": true, "message": "текст ошибки"}. Суммы — в тийинах (1 сум = 100 тийин), количество — в тысячных долях (1 шт = 1000, 0,25 кг = 250).Tana — method maydonli JSON; sozlamalarda token berilgan bo'lsa — yana token maydoni. Javob har doim HTTP 200 va JSON {"error": false, "message": …} yoki {"error": true, "message": "xato matni"}. Summalar — tiyinda (1 so'm = 100 tiyin), miqdor — mingdan bir ulushda (1 dona = 1000, 0,25 kg = 250).

ПродажаSotuv

{
  "method": "sale",
  "token": "",
  "companyName": "OOO \"Market\"",
  "companyINN": "123456789",
  "staffName": "Kassir",
  "orderNumber": "1042",
  "params": {
    "items": [
      {
        "name": "Молоко 1 л",
        "barcode": "4780011678660",
        "classCode": "02001001001000000",
        "packageCode": "1209885",
        "label": "",
        "amount": 2000,
        "price": 2400000,
        "discount": 0,
        "vatPercent": 12,
        "vat": 257143
      }
    ],
    "receivedCash": 2400000,
    "receivedCard": 0
  }
}

• price — сумма строки до скидки (цена × количество), discount — скидка на строку, vat — НДС от суммы после скидки. Для товаров без НДС — vatPercent: 0, vat: 0.price — chegirmagacha qator summasi (narx × miqdor), discount — qatorga chegirma, vat — chegirmadan keyingi summadan QQS. QQSsiz tovarlar uchun — vatPercent: 0, vat: 0.
• classCode — ИКПУ, packageCode — код упаковки из нацкаталога, label — код маркировки (для маркированных товаров).classCode — MXIK, packageCode — milliy katalogdagi qadoq kodi, label — markirovka kodi (markirovkalangan tovarlar uchun).
• Сумма оплат receivedCash + receivedCard должна равняться сумме строк за вычетом скидок.To'lovlar summasi receivedCash + receivedCard chegirmalar ayirilgan qatorlar summasiga teng bo'lishi kerak.

Ответ:Javob:

{
  "error": false,
  "message": {
    "terminalId": "UZ210317185582",
    "receiptSeq": "15",
    "dateTime": "20261027164109",
    "fiscalSign": "751226676752",
    "qrCodeURL": "https://ofd.soliq.uz/check?t=UZ210317185582&r=15&c=20261027164109&s=751226676752",
    "amount": 2400000,
    "cash": 2400000,
    "card": 0,
    "chequeNumber": "1042"
  }
}

Напечатайте на чеке фискальный признак, номер чека ФМ, дату и QR-код из qrCodeURL.Chekda fiskal belgi, FM chek raqami, sana va qrCodeURLdan QR-kodni chop eting.

ВозвратQaytarish

Те же поля, "method": "refund" и ссылка на исходный чек:Xuddi shu maydonlar, "method": "refund" va asl chekka havola:

"refundInfo": {
  "terminalId": "UZ210317185582",
  "receiptSeq": "15",
  "dateTime": "20261027164109",
  "fiscalSign": "751226676752"
}

МетодыMetodlar

Дополнительно в чеке можно передать extraInfo: tin или pinfl покупателя, phoneNumber, carNumber.Chekda qo'shimcha extraInfo uzatish mumkin: xaridorning tin yoki pinfl, phoneNumber, carNumber.

ОшибкиXatolar

Текст ошибки содержит машинный код и описание, например EN: LICENSE_REQUIRED Ru: Лицензия не активирована. Основные коды:Xato matnida mashina kodi va tavsif bor, masalan EN: LICENSE_REQUIRED Ru: Лицензия не активирована. Asosiy kodlar:

• LICENSE_REQUIRED — лицензия не активирована или истекла;LICENSE_REQUIRED — litsenziya faollashtirilmagan yoki muddati tugagan;
• INVALID_TOKEN — неверный токен; BAD_JSON / BAD_REQUEST — тело запроса не JSON или нет method; EMPTY_ITEMS — чек без позиций;INVALID_TOKEN — noto'g'ri token; BAD_JSON / BAD_REQUEST — so'rov tanasi JSON emas yoki method yo'q; EMPTY_ITEMS — pozitsiyasiz chek;
• ERROR_ZREPORT_IS_ALREADY_OPEN — смена уже открыта; ERROR_CURRENT_ZREPORT_IS_EMPTY — пустую смену закрыть нельзя;ERROR_ZREPORT_IS_ALREADY_OPEN — smena allaqachon ochiq; ERROR_CURRENT_ZREPORT_IS_EMPTY — bo'sh smenani yopib bo'lmaydi;
• METHOD_NOT_SUPPORTED — метод пока не поддерживается;METHOD_NOT_SUPPORTED — metod hozircha qo'llab-quvvatlanmaydi;
• ошибки фискального модуля — с текстом от ФМ (например, ФМ не найден, время в прошлом, чеки не отправлены больше 2 суток).fiskal modul xatolari — FM matni bilan (masalan, FM topilmadi, vaqt o'tmishda, cheklar 2 sutkadan ortiq yuborilmagan).

Браузерные кассы: адрес отвечает на CORS-запросы, поэтому чек можно отправлять прямо со страницы кассы.Brauzer kassalari: manzil CORS so'rovlariga javob beradi, shuning uchun chekni to'g'ridan-to'g'ri kassa sahifasidan yuborish mumkin.

НастройкиSozlamalar

• Адрес FiscalDriveService — по умолчанию http://127.0.0.1:3449, менять не нужно.«Адрес FiscalDriveService» — sukut bo'yicha http://127.0.0.1:3449, o'zgartirish shart emas.
• Порт локального API — по умолчанию 8350. Меняйте, только если порт занят другой программой; тогда поменяйте адрес и в кассе.«Порт локального API» — sukut bo'yicha 8350. Faqat port boshqa dastur bilan band bo'lsa o'zgartiring; u holda manzilni kassada ham o'zgartiring.
• Заводской номер ФМ — заполните, если к компьютеру подключено несколько ФМ.«Заводской номер ФМ» — kompyuterga bir nechta FM ulangan bo'lsa to'ldiring.
• Токен доступа для касс — если задан, каждый запрос кассы обязан передавать его в поле token.«Токен доступа для касс» — berilgan bo'lsa, kassaning har bir so'rovi uni token maydonida uzatishi shart.
• Запускать вместе с Windows — включено по умолчанию.«Запускать вместе с Windows» — sukut bo'yicha yoqilgan.

Частые вопросыKo'p so'raladigan savollar

«Служба ОФД: Недоступна» на вкладке «Статус».«Статус» bo'limida «Служба ОФД: Недоступна».
Не запущена служба FiscalDriveService. Откройте services.msc, запустите её и поставьте тип запуска «Автоматически».FiscalDriveService xizmati ishga tushirilmagan. services.mscni oching, uni ishga tushiring va ishga tushirish turini «Avtomatik» qiling.

«Фискальный модуль не найден».«Фискальный модуль не найден».
Проверьте, что ФМ вставлен в ридер, а ридер подключён к компьютеру. Переподключите ридер и нажмите «Обновить».FM o'quvchiga qo'yilganini va o'quvchi kompyuterga ulanganini tekshiring. O'quvchini qayta ulang va «Обновить»ni bosing.

ФМ «Заблокирован».FM «Заблокирован».
Модуль заблокирован ОФД. После разблокировки на стороне ОФД нажмите «Синхронизировать состояние».Modul OFD tomonidan bloklangan. OFD tomonida blokdan chiqarilgandan keyin «Синхронизировать состояние»ni bosing.

«Порт 8350 занят другой программой».«Порт 8350 занят другой программой».
Укажите другой порт в «Настройках» и такой же адрес в настройках кассы.«Настройки»da boshqa port va kassa sozlamalarida xuddi shu manzilni ko'rsating.

Касса пишет «Лицензия не активирована».Kassa «Лицензия не активирована» deb yozmoqda.
Лицензия не активирована, истекла или программа больше 72 часов не выходила в интернет. Проверьте вкладку «Лицензия» и нажмите «Обновить лицензию».Litsenziya faollashtirilmagan, muddati tugagan yoki dastur 72 soatdan ortiq internetga chiqmagan. «Лицензия» bo'limini tekshiring va «Обновить лицензию»ni bosing.

Переустановили Windows или меняете компьютер.Windows qayta o'rnatildi yoki kompyuter almashtirilmoqda.
Установите FiscalDriveService и Saraf Fiscal заново и введите тот же код активации — привязка ФМ сохраняется, повторно привязывать не нужно. Если код не принимается, напишите в поддержку.FiscalDriveService va Saraf Fiscal'ni qaytadan o'rnating va o'sha faollashtirish kodini kiriting — FM bog'lanishi saqlanadi, qayta bog'lash kerak emas. Kod qabul qilinmasa, qo'llab-quvvatlash xizmatiga yozing.