Boshlash

MXIK — Oʻzbekistondagi mahsulotlar va xizmatlarning yagona elektron milliy katalogi. Uning 17 xonali kodlari hisobvaraq-fakturalar va boshqa elektron hisob hujjatlarida koʻrsatiladi, ularni esa tasnif.soliq.uz saytida qidirishadi.

mxik sayt foydalanadigan API bilan ishlaydi, shuning uchun kodlarni oʻz dasturingizdan qidirishingiz mumkin: nomi, shtrix-kodi, brendi yoki sertifikat raqami boʻyicha.

Bu rasmiy SDK emas

Kutubxona Oʻzbekiston Soliq qoʻmitasi va tasnif.soliq.uz bilan bogʻliq emas. U saytning ochiq APIʼsidan foydalanadi. Bu APIʼning hujjatlari yoʻq va u ogohlantirishsiz oʻzgarishi mumkin. Agar javob birdan boshqacha koʻrinsa, issue oching.

Oʻzbekistondan tashqaridagi hosting

API Oʻzbekistondan tashqaridagi serverlarga javob bermasligi mumkin. Xorijda deploy qilishdan oldin serveringiz tasnif.soliq.uzga ulana olishini tekshiring. Agar ulana olmasa, soʻrovlarni proksi orqali yuboring: buning uchun baseURL opsiyasidan foydalaning.

Oʻrnatish

npm

npm i mxik

pnpm

pnpm add mxik

yarn

yarn add mxik

bun

bun add mxik

Denoʼda npm:mxik sifatida import qiling.

Birinchi soʻrov

import { createMxik } from 'mxik'

const mxik = createMxik()

const { items, total } = await mxik.search('Maccoffee')

items — natijalarning birinchi sahifasi, standart boʻyicha 20 ta, total esa ularning umumiy soni. Har bir elementda kod, nom va uning katalog ierarxiyasidagi oʻrni bor:

items[0].mxikCode // '00901001001048023'
items[0].name // 'Молотый (порошкообразный) кофе: Maccoffee, в пакет 3в1 20г'
items[0].groupName // 'КОФЕ, ЧАЙ И СПЕЦИИ'

Kod maʼlum boʻlsa, uning toʻliq kartochkasini oling:

const details = await mxik.get('00901001001048023')

details?.subPositionNameRu // 'Молотый (порошкообразный) кофе'
details?.subPositionNameUz // 'Майдаланган (кукунсимон) кофе'

Kod mavjud boʻlmasa, get() null qaytaradi.

Qayerda ishlaydi

• Node.js 20 va undan yangi, Bun va Deno.
• Brauzerlar: API boshqa domenlardan soʻrovlarga ruxsat beradi.
• Edge muhitlari va fetch mavjud boʻlgan har qanday joy. Oʻz fetchʼingizni ham berishingiz mumkin.

Paketda tip deklaratsiyalari bilan ESM va CommonJS yigʻmalari bor:

import { createMxik } from 'mxik'
// yoki
const { createMxik } = require('mxik')

Keyingi qadamlar

• Qidiruv: barcha qidiruv usullari, sahifalar va tillar.
• Katalog: kodlar daraxti, oʻlchov birliklari va imtiyozlar.
• Mijoz sozlamalari: taymautlar, proksi, oʻz fetchʼingiz.
• Kesh: bir xil soʻrovlarni takrorlamaslik.
• Xatolar: nima notoʻgʻri ketishi mumkin va holatlarni qanday farqlash.
• CLI va MCP server: kodlarni terminaldan yoki AI yordamchidan qidirish.