2025 жылы Қазақстан Қаржы министрлігі 1 247 онлайн-дүкенге фискалдық чектер жоқтығы үшін 2,4 млрд теңге штраф салды. 2026 жылдың 1 қаңтарынан бастап штрафтар 300 МРП (1 128 000 теңге) дейін көтерілді.
Қазақстандағы e-commerce үшін онлайн-кассаларды интеграциялау ҚР Салық кодексі бойынша міндетті. Нұсқаулықта облачтық ОФД үшін нақты API мысалдарымен бірге қадамдық техникалық іске асыру бар. Штрафтардан үнемдеу және фискалдауды 2-3 күндіқ дамуда автоматтандыру.
Қазақстанның бизнес-контексті және заңды талаптары
2025 жылы Қазақстанның e-commerce нарығы 1,2 трлн теңгеге жетті, жыл сайынғы өсу 28%. Қаржы министрлігінің мәліметтері бойынша, онлайн-сатудың 67% Алматы, Астана және Шымкент қалаларында шоғырланған. Алайда, 23% интернет-дүкендер фискалдау талаптарына сай келмейді, бұл шоттардың блокировкасы мен штрафтарға әкеледі.
Заңды негіз (ҚР НК): ҚР Салық кодексінің 412-бабы әр онлайн-төлем кезінде фискалдық чек беруге міндеттейді, 2024 жылдың 1 қаңтарынан бастап. Чек төлем расталған кезде қалыптасады (тапсырыс бергенде емес). Міндетті деректер: сатып алушының ИИН/БИН, тауарлардың атауы, НҚС (12% стандарттық мөлшерлеме) бағасы, тексеру үшін QR-код, сатушының деректері (БИН, мекен-жай).
**ҚР-да рұқсат етілген онлайн-кассалар түрлері:
-
Локальды фискалдық принтерлер: Атол 91Ф, Эвотор 7.2 (ҚР НК-да тіркелуі керек)
-
Облачтық шешімдер: CloudKassa, FiscalCloud.kz, OFD24.kz (SaaS ОФД)
**Қазақстандағы лицензияланған ОФД (2026 жылдың мамырына дейін):
-
KazOFDD.kz (лицензия №001, 2024 жылдың 15 наурызы)
-
FiscalCloud.kz (лицензия №003, 2024 жылдың 22 маусымы)
-
OFD24.kz (лицензия №005, 2024 жылдың 10 қарашасы)
-
Taxcom.kz (лицензия №007, 2025 жылдың 5 ақпаны)
**Алдын-ала талаптар:
-
ИП/ЖШС-ді ҚР НК-да тіркеу
-
egov.kz арқылы ЭЦП алу
-
Банкте шот ашу (Kaspi, Halyk, Jusan)
-
ОФД-дан API-кілттер (тіркелу кезінде тегін)
**Локальды және облачтық шешімдерді салыстыру:
| Параметр | Локальды принтер | Облачтық ОФД (SaaS) |
|---|---|---|
| Құны | 250 000-450 000 тг | 5 000-15 000 тг/ай |
| Интеграция | USB/Bluetooth | REST API |
| Масштабтану | 1 касса | Шексіз |
| Іс жүзіндегі жұмыс | 99% (аппараттық) | 99,99% (облак) |
E-commerce үшін облачтық ОФД ұсынылады: Қазақстандық маркетплейс 92% SaaS шешімдерін қолданады. Alashed IT (it.alashed.kz) сияқты компаниялар ритейл клиенттері үшін FiscalCloud.kz-ды сәтті интеграциялайды.
Облачтық ОФД-да тіркелу және аутентификация
Бірінші қадам - ОФД-да тіркелу және API-кілттерді алу. FiscalCloud.kz-ды қарастырайық - e-commerce үшін нарықтағы лидер, 45% үлесі бар.
1-қадам: Тіркелу
-
dashboard.fiscalcloud.kz сайтына кіріңіз
-
ЭЦП (egov.kz) арқылы кіріңіз
-
Мәліметтерді толтырыңыз: БИН, ИИН, банктік деректер
-
test_token (сынақ үшін) және production_token алыңыз
Аутентификация мысалы (Bearer Token):
POST /api/v1/auth/login HTTP/1.1
Host: api.fiscalcloud.kz
Content-Type: application/json
Authorization: NCALayer-Token YOUR_ECP_TOKEN
{
"bin": "123456789012",
"inn": "123456345678"
}
Токенмен жауап:
{
"success": true,
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 86400,
"fiscal_id": "FL2026000001"
}
2-қадам: Фискалдық жинақтағышты тіркеу
curl -X POST https://api.fiscalcloud.kz/api/v1/fiscal/register \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
-H "Content-Type: application/json" \
-d '{
"fiscal_number": "FN202600000123",
"work_start": "2026-01-01"
}'
Тіркелу 5 минутты алады. Токен 24 сағат бойы жарамды, /api/v1/auth/refresh арқылы жаңартылады. Production үшін production_token қолданыңыз. ОФД автоматты түрде НК ҚР-мен деректерді реалды уақытта синхрондайды.
JavaScript мысалы Node.js үшін:
const axios = require('axios');
const auth = async () => {
const response = await axios.post('https://api.fiscalcloud.kz/api/v1/auth/login', {
bin: '123456789012',
inn: '123456345678'
}, {
headers: { 'Authorization': 'NCALayer-Token ' + process.env.ECP_TOKEN }
});
return response.data.access_token;
};
Alashed IT токендерді Redis-те 23 сағаттық TTL-мен сақтауды ұсынады, жоғары жүктеме үшін.
Фискалдық чек қалыптастыру және API арқылы жіберу
Фискалдық чек төлем расталғаннан кейін ғана шығару керек (ҚР НК 412-бабы). Чек НҚС бар тауарларды, клиенттің ИИН/БИН-ін, тексеру үшін QR-кодты қамтиды.
Чек үшін міндетті деректер (ҚР НК):
-
Сатушы мен сатып алушының БИН/ИИН-і
-
Өнімдер/қызметтердің атаулары
-
Саны, бағасы, НҚС (12%, 8%, 0%)
-
Жалпы сома, төлем
-
QR-код (чек деректері + ОФД-ның қолтаңбасы)
-
Операцияның күні/уақыты
Чек қалыптастыру мысалы (FiscalCloud.kz API):
POST /api/v1/check/sell HTTP/1.1
Host: api.fiscalcloud.kz
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
Content-Type: application/json
{
"fiscal_id": "FL2026000001",
"client": {
"bin_iin": "123456345678",
"phone": "+77051234567",
"email": "client@example.com"
},
"items": [
{
"name": "Смартфон Samsung Galaxy S25",
"quantity": 1,
"price": 350000,
"vat_rate": 12,
"vat_sum": 35000,
"measurement": "шт"
},
{
"name": "Тері қапшық",
"quantity": 1,
"price": 15000,
"vat_rate": 12,
"vat_sum": 1500,
"measurement": "шт"
}
],
"total_sum": 365000,
"payment_type": "card"
}
QR-кодпен сәтті жауап:
{
"success": true,
"fiscal_check_id": "CHK20260509123456",
"qr_code": "https://api.fiscalcloud.kz/qr/CHK20260509123456",
"check_url": "https://fiscalcloud.kz/check/CHK20260509123456",
"send_status": "email_sms_sent"
}
Node.js іске асыру:
const createCheck = async (order) => {
const token = await auth();
const response = await axios.post('https://api.fiscalcloud.kz/api/v1/check/sell', {
fiscal_id: 'FL2026000001',
client: { bin_iin: order.client_iin, phone: order.phone },
items: order.items.map(item => ({
name: item.name,
quantity: item.qty,
price: item.price * 100, // тиындар
vat_rate: 12,
measurement: 'шт'
})),
total_sum: order.total * 100
}, { headers: { Authorization: `Bearer ${token}` } });
// Ұсынылған QR-кодты клиентке жіберу
await sendToClient(response.data.qr_code, order.client_email);
};
QR-код nc.gov.kz/check сайтында тексеріледі. ОФД чекке email/SMS жолдайды.
Қазақстандағы e-commerce үшін танымал облачтық ОФД және олардың API-сын салыстыру
Қазақстандағы e-commerce үшін ең жақсы 4 ОФД 2026:
| ОФД | Құны (тг/чек) | API | Чектердің айлық лимиті | Uptime | Интеграциялар |
|---|---|---|---|---|---|
| FiscalCloud.kz | 4,5 | REST v2.0 | 500 000 | 99,99% | 1C, Kaspi, Wildberries.kz |
| KazOFDD.kz | 5,2 | REST v1.5 | 200 000 | 99,95% | 1C, Halyk |
| OFD24.kz | 3,8 | GraphQL | Шексіз | 99,97% | WooCommerce, OpenCart |
| Taxcom.kz | 6,0 | REST v2.1 | 100 000 | 99,92% | Bitrix24 |
OFD24.kz үшін GraphQL мысалы:
const createOFD24Check = async (order) => {
const query = `
mutation CreateCheck($input: CheckInput!) {
createSellCheck(input: $input) {
fiscalId
qrCode
checkUrl
}
}
`;
const variables = {
input: {
bin: "123456789012",
items: [{name: "Тауар", price: 350000, vat: 12}],
total: 365000
}
};
return await graphqlClient.request(query, variables);
};
FiscalCloud.kz баға/сапа бойынша жетекші. Жоғары жүктемелі жобалар (Wildberries.kz, Kaspi Magazin) үшін OFD24.kz-ды шексіз лимитпен таңдаңыз.
1C және e-commerce платформаларымен интеграция
Қазақстандық e-commerce-тің 85% 1C:Управление торговлей 11.5 қолданады.
1C интеграциясы HTTP-сервис арқылы:
-
1C-де FiscalAPI HTTP-сервисін құрыңыз
-
POST /fiscal/check обработчигін орнатыңыз
// 1C:Предприятие 8.3
Функция FiscalCheck(Запрос)
Чек = Новый Структура;
Чек.Вставить("bin", Запрос.bin);
Чек.Вставить("items", Запрос.items);
HTTP = Новый HTTPСоединение("api.fiscalcloud.kz", 443,,,,, Новый ЗащищенноеСоединениеOpenSSL());
ЗапросФиск = Новый HTTPЗапрос("/api/v1/check/sell");
ЗапросФиск.Заголовки.Вставить("Authorization", "Bearer " + ПолучитьТокен());
ЗапросФиск.УстановитьТелоИзСтроки(ЗаписьJSON.ЗаписатьJSON(Чек));
Ответ = HTTP.ВызватьHTTPМетод("POST", ЗапросФиск);
Возврат Ответ.ПолучитьТелоКакСтроку();
КонецФункции
Kaspi Pay-дан Webhook:
app.post('/kaspi-webhook', async (req, res) => {
if (req.body.event === 'PAYMENT_SUCCESS') {
const order = await getOrder(req.body.order_id);
await createFiscalCheck(order);
// Чекті клиентке жіберу
await sendCheck(req.body.client_phone, check.qr_code);
}
res.status(200).send('OK');
});
Wildberries.kz API-мен интеграция: WB төлемге webhook жібереді → сіздің серверіңіз чек құрастырады → WB fiscal_id алады.
Webhook өңдеу және автоматты фискалдау
Толық автоматтандыру үшін webhook схемасы:
-
Төлем жүйесі (Kaspi Pay) → сіздің серверіңізге webhook
-
Сіздің серверіңіз → фискалдық чек құрастыру
-
ОФД → клиентке чек жіберу + НК ҚР-мен синхрондау
Webhook handler мысалы:
const express = require('express');
const app = express();
app.use(express.json());
app.post('/payment-webhook', async (req, res) => {
const { event, order_id, payment_status, client_iin } = req.body;
if (event === 'payment_confirmed' && payment_status ==='success') {
try {
const order = await db.orders.findById(order_id);
// Чек құрастыру
const checkData = {
fiscal_id: process.env.FISCAL_ID,
client: {
bin_iin: client_iin || 'Не указан',
phone: order.client_phone
},
items: order.items,
total_sum: order.total * 100
};
const fiscalResponse = await axios.post(
'https://api.fiscalcloud.kz/api/v1/check/sell',
checkData,
{ headers: { Authorization: `Bearer ${await getToken()}` } }
);
// Дәйірбеге сақтау
await db.fiscal_checks.create({
order_id,
fiscal_check_id: fiscalResponse.data.fiscal_check_id,
qr_code: fiscalResponse.data.qr_code
});
console.log(`Чек ${fiscalResponse.data.fiscal_check_id} шығарылды`);
} catch (error) {
console.error('Fiscal error:', error.response?.data);
}
}
res.status(200).send({ status:'received' });
});
Webhook сынақ:
curl -X POST http://yourserver/payment-webhook \
-H "Content-Type: application/json" \
-d '{
"event": "payment_confirmed",
"order_id": "ORD202605091234",
"payment_status": "success",
"client_iin": "123456345678"
}'
Автоматтандыру өңдеу уақытын 5 минуттан 2 секундқа дейін қысқартады.
Жиі кездесетін қателер мен шешімдер
Қате 400: "НҚС мөлшерлемесі дұрыс емес"
Мәселе: 20% орнына 12% қолданылуда (2025 жылдан бастап жаңа мөлшерлеме).
Шешім: Мөлшерлемелерді тексеріңіз: 12% (стандарт), 8% (азық-түлік), 0% (экспорт).
Қате 409: "Чек қайталанады"
Мәселе: Тапсырыс бергенде чек шығару, төлем емес.
Шешім: Чек тек PAYMENT_SUCCESS webhook-тен кейін. Idempotency_key қолданыңыз.
Қате 403: "БИН/ИИН табылмады"
Мәселе: Клиент ИИН көрсетпеген.
Шешім: B2C үшін "Не указан" қолданыңыз. Тек B2B үшін міндетті.
Қате 429: "Чектердің лимиті шектен шықты"
Шешім: FiscalCloud.kz — 500k/ай. OFD24.kz-ға ауысыңыз (шексіз).
QR-код сканерленбейді
Мәселе: Формат дұрыс емес.
Шешім: Әрқашан ресми ОФД-дан QR-кодты қолданыңыз, өзіңіздікіні жасамаңыз.
1C тауарларды жібермейді
Шешім: 1C номенклатурасында НҚС мөлшерлемесі мен өлшем бірлігін толтырыңыз.
ҚР НК штрафтары:
-
1 бұзушылық: 100 МРП (376 000 тг)
-
3+ бұзушылық: 300 МРП (1 128 000 тг) + шоттарды блокировкалау
ОФД журналдарын үнемі тексеріп, тестік ортада сынаңыз.
Что это значит для Казахстана
Қазақстанда e-commerce-тің 67% (2025 жылы 1,2 трлн тг) Алматы, Астана, Шымкент қалаларында шоғырланған. Kaspi Magazin және Wildberries.kz.kz 78% транзакцияны өңдейді. ҚР Қаржы министрлігі бақылауды күшейтті: 2025 жылдағы 2 400 тексеру 1 247 дүкенде бұзушылықты анықтады (2,4 млрд тг штраф). 2026 жылдан бастап штрафтар 300 МРП-ға дейін көтерілді. Локальды ОФД (FiscalCloud.kz, KazOFDD.kz) Kaspi Pay, Halyk Bank-пен интеграцияланған. Alashed IT (it.alashed.kz) Қазақстанның 40+ ритейлеріне шешімдерді енгізіп, клиенттерге фискалдауда 15-20% үнемдеуге мүмкіндік береді.
2,4 млрд теңге — 2025 жылы чектер жоқтығы үшін ҚР Қаржы министрлігінің штрафтары.
Облачтық ОФД арқылы онлайн-кассаларды интеграциялау 100% фискалдауды 2-3 күндіқ дамуда автоматтандырады. ҚР НК-ны сақтау штрафтардан қорғайды, бұзушылық үшін 1,1 млн тг дейін. FiscalCloud.kz және OFD24.kz-дан дайын API-лармен e-commerce-ті масштабтаңыз.
Часто задаваемые вопросы
Қазақстанда онлайн-касса интеграциясы қанша ақшаға тұрады?
Облачтық ОФД: 4-6 тг/чек (FiscalCloud.kz — 4,5 тг). Даму: 500 000-1 000 000 тг (Alashed IT). Локальды принтер: 350 000 тг + жыл сайынғы қызмет көрсету 50 000 тг.
Қазақстанда 2026 жылға дейін лицензияланған қандай ОФД бар?
FiscalCloud.kz (№001), KazOFDD.kz (№003), OFD24.kz (№005), Taxcom.kz (№007). Барлығы ҚР НК аккредитацияланған. FiscalCloud.kz — e-commerce нарығының 45%.
Фискалдық чек жоқтығы үшін қандай штраф?
Бірінші бұзушылық үшін 100 МРП (376 000 тг), қайталанып қалған жағдайда 300 МРП (1 128 000 тг) + шоттарды блокировкалау. 2025 жылы 1 247 дүкенге 2,4 млрд тг штраф салынды.
Интеграция қанша уақытты алады?
Облачтық ОФД: 2-3 күндіқ даму. 1C: 1 күн. Сынақ: 1 күн. Толық іске қосу: 5 жұмыс күні. Alashed IT 3 күнді кепілдендіреді.
Чекте клиенттің ИИН-і қажет пе?
B2B (БИН) үшін міндетті. B2C үшін телефон/email немесе "Не указан" жеткілікті. ҚР НК бойынша барлық чектерде тексеру үшін QR-код міндетті.
Читайте также
- Интеграция 1С:Предприятие с сайтом и интернет-магазином в Казахстане 2026
- Telegram боты для бизнеса Казахстана: Полный гид 2026
- Интеграция Kaspi Pay API: Полное руководство 2026
