Billz

Billz dasturi Billz hisob tizimingizdagi mahsulotlar, kategoriyalar, narxlar va qoldiqlarni do‘konga yuklaydi va ularni dolzarb holatda saqlaydi. Do‘kondagi Billz mahsulotlari bor yangi buyurtmalarni Billz’ga avtomatik uzatish mumkin — to‘langan sotuv yoki tovarni bron qiladigan kechiktirilgan buyurtma sifatida.

Bu sahifa nima uchun kerak#

• Billz hisob qaydnomasini maxfiy kalit orqali ulash.
• Billz katalogini yuklash: kategoriyalar, variantlar va rasmlari bilan mahsulotlar, IKPU kodlari.
• Do‘kondagi narx va qoldiqlarni Billz bilan mos holda saqlash.
• Narxlar olinadigan Billz do‘konini tanlash.
• Importni tanlangan Billz do‘konlari va kategoriyalari bilan cheklash.
• Do‘kon buyurtmalarini Billz’ga sotuv yoki kechiktirilgan buyurtma sifatida uzatish.

Qayerdan topish mumkin#

Yon menyu: Sozlamalar → Dastur, so‘ng katalogdagi Billz kartochkasi (yoki Ulanganlar blokidagi Sozlash).

Kim ko‘radi#

Sahifa «Управлять приложениями и интеграциями» (Dasturlar va integratsiyalarni boshqarish) huquqi bor xodimlarga ochiq.

Dastur barcha tariflarda mavjud. Billz’dan kelgan yangi mahsulotlar tarifdagi mahsulotlar limitiga kiradi.

Sahifa bilan tanishuv#

1. Sarlavha — nomi, dasturchi, sayt, tavsif va O‘rnatish tugmasi. Tugma ulangandan keyin ham qoladi: shu orqali yana bitta Billz hisob qaydnomasini ulash mumkin.
2. Ulanish kartochkasi — foydalanuvchi nomi va kategoriya, Настройки (Sozlamalar) va O‘chirish tugmalari. Har bir ulangan hisob qaydnomasi uchun alohida kartochka.
3. Sinxronlash tugmalari — Kategoriyalarni Billz dan import qilish, Tovarlarni Billz dan import qilish, Mahsulotlarni Billz dan yangilash, Barcha mahsulotlarning qoldig‘ini yangilash, Yangi mahsulotlarni Billz dan import qilish, IKPU ni Billz dan import qilish, Tokenni yangilash. Tugma ustiga kursor olib borilganda izoh chiqadi.
4. Tugmalar bo‘yicha yordam — har bir tugma tavsifi bilan ochiladigan ro‘yxat.

Qanday bajariladi#

Billz’ni ulash#

1. Billz’dan API’ga kirish uchun maxfiy kalitni oling.
2. Dasturlar katalogida Billz’ni oching va O‘rnatish tugmasini bosing.
3. Versiya maydonida 2-versiyani tanlang.
4. Kalitni Maxfiy kalit maydoniga joylang va Foydalanuvchi nomini to‘ldiring — bu ulanish nomi, sahifada hisob qaydnomalarini shu nom bo‘yicha farqlaysiz.
5. O‘rnatish tugmasini bosing va bir necha soniyadan keyin sahifani yangilang. Sinxronlash tugmalari paydo bo‘ladi.

Tugmalar paydo bo‘lmasa, kalit mos kelmagan. Ulanishni o‘chiring va to‘g‘ri kalit bilan qaytadan o‘rnating.

Narx va buyurtmalar uchun do‘konni tanlash#

1. Ulanish kartochkasida Настройки (Sozlamalar) tugmasini bosing. Billzni yangilash oynasi hisob qaydnomangizdan ma’lumotlarni yuklaydi.
2. Narxlar va buyurtmalar uchun Billz do‘koni maydonida do‘konni tanlang — mahsulot narxlari shundan olinadi va buyurtmalar ham shunda yaratiladi.
3. Yangilash tugmasini bosing.

Buyurtmalarni uzatishni sozlash#

1. Настройки (Sozlamalar) oynasini oching va Buyurtmalar bo‘limini toping.
2. Yangi buyurtma uchun Billz’da nima yaratilishini tanlang:
   • Sotuv (to‘langan chek) — buyurtma darhol to‘langan sotuv sifatida o‘tkaziladi. Billz kassasi (narx va buyurtmalar do‘koni kassasi) va Billz to‘lov turi (shu kassaning to‘lov turi)ni tanlang.
   • Kechiktirilgan buyurtma (tovar bron qilinadi) — Billz’da kechiktirilgan buyurtma yaratiladi: tovar bron qilinadi, sotuvni kassir Billz’da yakunlaydi. Kassa va to‘lov turi kerak emas. Kechiktirish muddati, soat maydonida bron qancha turishini kiriting: 1 dan 720 soatgacha, odatda 72.
3. Yangilash tugmasini bosing.

Katalogning faqat bir qismini import qilish#

Bir nechta Billz do‘koningiz bo‘lsa yoki do‘konga barcha bo‘limlar kerak bo‘lmasa, importni cheklang.

1. Настройки (Sozlamalar) oynasini oching va Import bo‘limini toping.
2. Import qilinadigan do‘konlar ro‘yxatida mahsulotlari do‘konda kerak bo‘lgan Billz do‘konlarini belgilang. Hech narsa belgilanmasa — barcha do‘konlar import qilinadi.
3. Import qilinadigan kategoriyalar daraxtida kerakli bo‘limlarni belgilang. Belgilangan bo‘lim o‘zining barcha ichki bo‘limlarini o‘z ichiga oladi — ular avtomatik belgilanadi. Bo‘limni daraxt ustidagi qidiruv maydoni orqali topish mumkin. Hech narsa belgilanmasa — barcha kategoriyalar import qilinadi.
4. Yangilash tugmasini bosing.
5. Tanlovni katalogga qo‘llash uchun Tovarlarni Billz dan import qilish tugmasini bosing. Avtomatik yangilash yangi tanlovni darhol hisobga oladi.

Narx va buyurtmalar do‘koni import do‘konlari orasida bo‘lishi kerak, aks holda sozlamalar saqlanmaydi va sahifada xato haqida xabar chiqadi. Do‘konlar yoki kategoriyalar ro‘yxati Billz’dan yuklanmasa, oynada ogohlantirish chiqadi — saqlangan tanlov bunda o‘zgarmaydi.

Katalogni birinchi marta yuklash#

1. Sozlamalarda Billz do‘konini va kerak bo‘lsa import do‘konlari va kategoriyalarini tanlang (yuqoriga qarang).
2. Kategoriyalarni Billz dan import qilish tugmasini bosing.
3. Tovarlarni Billz dan import qilish tugmasini bosing. Import fonda bajariladi — mahsulotlar katalogda asta-sekin paydo bo‘ladi.
4. Billz’da IKPU kodlari to‘ldirilgan bo‘lsa, IKPU ni Billz dan import qilish tugmasini bosing.

Faqat yangi mahsulotlarni yuklash#

Yangi mahsulotlarni Billz dan import qilish tugmasini bosing. Faqat do‘konda hali yo‘q mahsulotlar yaratiladi; mavjudlari o‘zgarmaydi.

Qoldiqlardagi farqni tuzatish#

Barcha mahsulotlarning qoldig‘ini yangilash tugmasini bosing — barcha mahsulotlarning narx va qoldiqlari Billz’dan qaytadan yuklanadi.

Ulanishni o‘chirish#

Ulanish kartochkasidagi O‘chirish tugmasini bosing va tasdiqlang. Mahsulotlar, kategoriyalar va buyurtmalar do‘konda qoladi, lekin yangilanmay qo‘yadi.

Bu qanday ishlaydi#

• Mahsulotlar qanday bog‘langan. Do‘kondagi har bir mahsulot va variant Billz mahsuloti identifikatorini eslab qoladi. Umumiy ota mahsulotga ega Billz mahsulotlari variantli bitta mahsulotga birlashtiriladi; variant parametrlari Billz atributlaridan olinadi.
• To‘liq import nimani yuklaydi. Nomi, tavsifi, brend (ishlab chiqaruvchi maydonida), artikul, shtrix-kod, rasmlar, kategoriyalar, narx, chizilgan narx va qoldiq. Kategoriyalar Billz’dagi «Bo‘lim > Kichik bo‘lim» yo‘li bo‘yicha quriladi va do‘konda hali bo‘lmasa yaratiladi. Rasmlar nusxalanmaydi, Billz havolalari orqali ko‘rsatiladi.
• Narxlar. Narx Narxlar va buyurtmalar uchun Billz do‘koni maydonida tanlangan do‘kon narxlaridan olinadi; do‘kon tanlanmagan bo‘lsa — mahsulotning birinchi narxidan. Billz’da aksiya narxi amal qilsa, u sotuv narxiga, oddiy narx esa chizilgan narxga aylanadi.
• Qoldiqlar — mahsulotning import do‘konlaridagi, ular tanlanmagan bo‘lsa — barcha Billz do‘konlaridagi qoldiqlari yig‘indisi. Manfiy qoldiqlar nol deb hisoblanadi.
• Do‘konga qaysi mahsulotlar tushadi. Import do‘konlari tanlangan bo‘lsa, shu do‘konlardan birida narxi yoki qoldig‘i bor mahsulotlar import qilinadi. Kategoriyalar tanlangan bo‘lsa — belgilangan bo‘limlar va ularning ichki bo‘limlaridagi, jumladan Billz’da keyin yaratilganlaridagi mahsulotlar. Ikkala shart birga amal qiladi. Kategoriyalar importi faqat tanlangan bo‘limlardagi kategoriyalarni yaratadi.
• Avtomatik yangilash. Taxminan har 10–15 daqiqada do‘kon Billz’dan so‘nggi daqiqalarda o‘zgargan mahsulotlarni so‘raydi va ularning narx va qoldiqlarini yangilaydi. Bunda yangi mahsulotlar yaratilmaydi. Har kuni Toshkent vaqti bilan 06:00 da barcha mahsulotlarning narx va qoldiqlari to‘liq qayta hisoblanadi.
• «Mahsulotlarni Billz dan yangilash» tugmasi xuddi shu yangilashni qo‘lda ishga tushiradi. Uni qayta faqat 15 daqiqadan keyin bosish mumkin.
• Kirish tokeni amal qilish muddati tugashiga yaqin avtomatik yangilanadi. Tokenni yangilash tugmasi buni darhol bajaradi. Sozlamalarda maxfiy kalitni almashtirgan bo‘lsangiz, Tokenni yangilash tugmasini bosing.
• Billz’dagi buyurtmalar. Do‘konda Billz mahsulotlari bor yangi buyurtma rasmiylashtirilganda, narx va buyurtmalar uchun Billz do‘konida shu mahsulotlar bilan buyurtma yaratiladi. Sotuv rejimida tanlangan to‘lov turi bilan darhol to‘lov o‘tkaziladi. Kechiktirilgan buyurtma rejimida buyurtma ko‘rsatilgan muddat va «Order #raqam» izohi bilan kechiktirilgan buyurtmaga aylanadi: tovar bron qilinadi va mavjud qoldiqdan chiqadi, sotuvni esa kassir Billz’da yakunlaydi. Billz’ga tegishli bo‘lmagan mahsulotlar va yetkazib berish uzatilmaydi. Buyurtmaning bekor qilinishi va o‘zgarishi Billz’ga uzatilmaydi.
• IKPU Billz mahsulotining «Код ГНИ» va «КОД» qo‘shimcha maydonlaridan yuklanadi.
• Qoldiqlar tarixi. Sinxronlash kiritgan narx va qoldiq o‘zgarishlari mahsulotning tuzatishlar tarixida «Billz» manbasi bilan ko‘rinadi.

Cheklovlar va muhim jihatlar#

• Billz’da rasmi yo‘q mahsulotlar import qilinmaydi. Variantli mahsulot uchun bitta variantda rasm bo‘lishi kifoya.
• To‘liq import Billz mahsulotlarining nomi, tavsifi, rasmlari, teglari, narxlari va kategoriyalarini qayta yozadi — do‘konda qo‘lda kiritilgan tahrirlar yo‘qoladi. Qo‘lda qo‘shilgan kategoriyalar uziladi.
• Billz’dan kelgan yangi mahsulotlar darhol nashr qilinadi. Siz qo‘lda nashrdan olgan mahsulot to‘liq importdan keyin yana nashr qilinadi.
• Billz’da endi yo‘q mahsulotlar faqat to‘liq importda (Tovarlarni Billz dan import qilish) nashrdan olinadi. Avtomatik yangilash ularga tegmaydi.
• Tanlangan do‘konlar yoki kategoriyalardan tashqarida qolgan mahsulotlar ham shunday: ular o‘chirilmaydi, keyingi to‘liq importda nashrdan olinadi. Ungacha ularning narx va qoldiqlari yangilanmay qo‘yadi. Tanlovga Billz’dagi birorta mahsulot mos kelmasa, to‘liq import hech narsani nashrdan olmaydi.
• Do‘kondagi kategoriyalar bo‘lim import uchun tanlanmay qolsa ham o‘chirilmaydi va yashirilmaydi.
• Yangi mahsulotlar faqat qo‘lda importdan keyin paydo bo‘ladi — avtomatik yangilash ularni yaratmaydi.
• Qoldiqlarning qo‘lda o‘zgartirilishi keyingi sinxronlashda qayta yoziladi.
• Buyurtmalar faqat birinchi Billz ulanishi orqali uzatiladi. Narx va buyurtmalar do‘koni tanlanmagan bo‘lsa, buyurtmalar uzatilmaydi; Sotuv rejimida buning uchun kassa va to‘lov turi ham kerak. Admin panelda bu haqda xabar chiqmaydi.
• Do‘kon kechiktirilgan buyurtmani faqat yaratadi. Do‘kondagi buyurtma bekor qilinganda, yetkazilganda yoki to‘langanda Billz’dagi kechiktirilgan buyurtma bekor qilinmaydi va to‘lanmaydi — uni Billz’da o‘zingiz yakunlang yoki o‘chiring. Aks holda bron muddat tugaganda olinadi.
• Billz’dagi kechiktirish muddati belgilanganidan bir necha soatga farq qilsa yoki kassasiz kechiktirilgan buyurtmalar yaratilmasa, qo‘llab-quvvatlash xizmatiga yozing. Javobgacha sozlamalarda kassani tanlang — u kechiktirilgan buyurtma rejimida ham uzatiladi.
• Sinxronlash xatolari admin panelda ko‘rsatilmaydi. Tugmalar faqat vazifa ishga tushganini yoki allaqachon bajarilayotganini bildiradi.
• Tarifdagi mahsulotlar limitiga yetilganda yangi mahsulotlar qo‘shilmaydi, mavjudlari yangilanishda davom etadi.

Ko‘p beriladigan savollar#

Nega Billz’dagi mahsulot do‘konda paydo bo‘lmadi? Billz’da uning rasmi yo‘q, yoki tarifdagi mahsulotlar limitiga yetilgan, yoki import hali ishga tushirilmagan. Yangi mahsulotlarni Yangi mahsulotlarni Billz dan import qilish tugmasi qo‘shadi.

Do‘kondagi qoldiq mening Billz do‘konimdagidan ko‘p. Qoldiq barcha import do‘konlari bo‘yicha, ular tanlanmagan bo‘lsa — barcha Billz do‘konlari bo‘yicha birga hisoblanadi. Qoldiqni faqat bitta do‘kon bo‘yicha hisoblash uchun Import qilinadigan do‘konlarda faqat uni belgilang. Narx va buyurtmalar do‘koni qoldiqqa ta’sir qilmaydi.

Bo‘limni importdan olib tashladim, lekin uning mahsulotlari hali do‘konda. Tanlovdan tashqaridagi mahsulotlar keyingi to‘liq importda nashrdan olinadi. Tovarlarni Billz dan import qilish tugmasini bosing.

Mahsulot tavsifini o‘zgartirdim, lekin u yo‘qolib qoldi. To‘liq import tavsifni Billz ma’lumotlari bilan qayta yozadi. Tavsifni Billz’da o‘zgartiring yoki bunday mahsulotlar uchun to‘liq importni ishga tushirmang.

Qaysi birini tanlash kerak: 1-versiya yoki 2-versiya? 2-versiya — sinxronlash Billz API’ning ikkinchi versiyasi orqali ishlaydi.

Bog‘liq maqolalar#

• Dasturlar katalogi
• Mahsulotlar
• Kategoriyalar
• Inventarizatsiya
• IKPU
• Barcha buyurtmalar: ro‘yxat va kanban