Uzum Market API: sotuvchi uchun integratsiya qo'llanmasi

Agar siz Uzum Market'da sotsangiz va SKU soni yuzdan oshgan bo'lsa, qoldiq va narxlarni kabinetda qo'lda yangilash tez orada eng ko'p vaqt oladigan ishga aylanadi. Bu muammoni Uzum Market API hal qiladi: bu sotuvchilar uchun rasmiy interfeys bo'lib, u orqali qoldiq, narx, buyurtma va moliya ma'lumotlarini o'z tizimingiz — 1C, Smartup, ombor dasturi yoki sayt — bilan avtomatik almashish mumkin.

Qisqa javob: API mavjud SKU'larning qoldiq va narxlarini yangilash, FBS va DBS buyurtmalarni olish va boshqarish, nakladnoylar va sotuv hisobotlarini yuklab olish uchun yetarli. Mahsulot kartasini yaratish esa hozircha kabinetda qoladi. Quyida nimalar mumkinligini, integratsiya qanday quriladi va qayerda ehtiyot bo'lish kerakligini ko'rib chiqamiz.

Uzum Market API nima va u qayerda

Uzum sotuvchilar uchun seller OpenAPI taqdim etadi. Uning hujjatlari OpenAPI (Swagger) formatida chiqarilgan, server manzili api-seller.uzum.uz. Kirish token orqali: token sotuvchi kabinetidagi sozlamalarning API bo'limida yaratiladi va har bir so'rovda Authorization sarlavhasida, Bearer prefiksisiz yuboriladi.

Muhim jihat: bitta sotuvchida bir nechta do'kon bo'lishi mumkin, deyarli barcha metodlar esa do'kon identifikatorini so'raydi. Shuning uchun integratsiya odatda do'konlar ro'yxatini olishdan boshlanadi.

FBO, FBS va DBS: API uchun farqi

API imkoniyatlari qaysi ishlash sxemasidan foydalanayotganingizga bog'liq, shuning uchun avval atamalarni aniqlab olaylik.

Faqat FBO bilan ishlasangiz, integratsiya asosan hisobot va moliya haqida bo'ladi. FBS va DBS bilan esa qoldiq va buyurtmalarni real vaqtga yaqin boshqarish kerak, va aynan shu yerda API eng ko'p foyda beradi.

Integratsiya qachon kerak

• SKU soni shunchalik ko'pki, qoldiqni qo'lda yangilash har kuni soatlab vaqt oladi;
• tovar bir vaqtda bir nechta kanalda sotiladi;
• buyurtmalarni 1C yoki Smartup'ga qo'lda ko'chirish xatolarga olib kelyapti;
• har bir tovar bo'yicha marjani ko'rish uchun sotuv va xarajatlarni yig'ish kerak.

Agar tovarlar kam va faqat Uzum'da sotilsa, kabinetning o'zi yetarli bo'lishi mumkin. Integratsiyani biznes o'sganda qo'shish ham mumkin.

Uzum seller API nimalarni qila oladi

Rasmiy hujjatlardagi metodlar bir nechta guruhga bo'lingan.

Mahsulotlar va narxlar

• do'kon bo'yicha SKU ro'yxatini olish;
• SKU narxlarini o'zgartirish;
• SKU uchun shtrix-kod etiketkalarini chop etishga tayyorlash.

Qoldiqlar (FBS va DBS)

API FBS va DBS qoldiqlarini o'qish va yangilashga imkon beradi, ya'ni sizning omboringizdagi tovarlarni. FBO, ya'ni Uzum omborida turgan tovarlar uchun qoldiq ta'minot nakladnoylari orqali shakllanadi va API orqali "qo'lda" o'rnatilmaydi.

FBS va DBS buyurtmalari

• buyurtmalarni holat bo'yicha olish va sanash;
• buyurtmani tasdiqlash yoki bekor qilish;
• FBS buyurtma uchun etiketka olish;
• DBS buyurtmani yetkazishga topshirish, topshirilganini tasdiqlash va qaytarishni rasmiylashtirish.

Nakladnoylar va qaytarishlar

FBO ta'minot nakladnoylari va ularning tarkibi, FBS uchun topshirish nakladnoylari (yaratish, tarkibini o'zgartirish, qabul aktini chop etish), qaytarish nakladnoylari.

Moliya

Sotuvlar ro'yxati va Uzum tomonidan sotuvchidan ushlangan xarajatlar. Bu ma'lumotlar buxgalteriya va marjani hisoblash uchun foydali.

Uzum API bilan integratsiya qanday quriladi

Eng ishonchli arxitektura — Uzum va hisob tizimingiz o'rtasida kichik oraliq servis. U to'g'ridan-to'g'ri 1C ichiga yozilgan moduldan ko'ra barqarorroq va yangi kanal qo'shishni osonlashtiradi.

1. Asosiy tizimni belgilash. Qoldiq va narxlar qayerda yuritiladi: 1C, Smartup yoki ombor dasturida. Uzum faqat shu manbadan yangilanadi.
2. SKU'larni bog'lash. Har bir Uzum SKU'si hisob tizimidagi tovar bilan artikul yoki shtrix-kod orqali moslashtiriladi. Bu ko'pincha eng ko'p vaqt oladigan bosqich.
3. Qoldiq va narxlarni uzatish. Servis o'zgarishlarni hisob tizimidan oladi va Uzum'ga yuboradi, xatolarni jurnalga yozadi.
4. Buyurtmalarni yig'ish. Yangi FBS va DBS buyurtmalar muntazam olinadi va hisob tizimiga hujjat sifatida tushadi, tasdiqlash esa avtomatik yoki menejer orqali qilinadi.
5. Moliyani solishtirish. Sotuv va xarajat ma'lumotlari hisobotlarga yoki buxgalteriyaga yuklanadi.
6. Monitoring. Token muddati tugasa yoki so'rovlar rad etilsa, mas'ul xodimga Telegram orqali xabar boradi.

1C va Smartup bilan almashinuv usullari haqida batafsil 1C va Smartup integratsiyasi maqolasida yozganmiz.

Marketpleys va boshqa kanallar: bitta qoldiq

O'zbekistonda ko'p sotuvchilar bir vaqtda Uzum Market, o'z sayti, Telegram bot va oflayn do'konda savdo qiladi. Bitta umumiy qoldiq bo'lmasa, oxirgi tovar ikki kanalda bir vaqtda sotiladi va buyurtmani bekor qilishga to'g'ri keladi. Bekor qilishlar esa marketpleysdagi reytingga yomon ta'sir qilishi mumkin.

Yechim — barcha kanallarni bitta ombor hisobiga ulash. Ombor dasturi qanday tuzilishini ombor hisobi dasturi maqolasida, o'z do'koningizni ochish haqida esa internet-magazin ochish maqolasida o'qishingiz mumkin.

Hujjatlar va soliq tomoni

Uzum'dagi sotuvlar bo'yicha hisob-faktura va boshqa hujjatlar alohida jarayon. Agar sizda elektron hisob-fakturalar Didox orqali ketsa, ularni ham avtomatlashtirish mumkin — bu haqda Didox va ESF integratsiyasi maqolasida yozganmiz. Hisobga olish tartibi bo'yicha aniq savollarni buxgalteringiz bilan kelishib oling.

Tez-tez uchraydigan xatolar

Barcha tokenlarni bitta odamda saqlash

Token sotuvchi nomidan ishlaydi. Uni chatlarda yubormang, serverda maxfiy sozlama sifatida saqlang va xodim ketganda yangisini yarating.

Juda tez-tez so'rash

Har soniyada qoldiqlarni so'rash cheklovlarga olib keladi. O'zgargan SKU'larni yig'ib, paket bilan yuborish va buyurtmalarni oqilona oraliqda olish yetarli.

SKU moslashtirishni e'tiborsiz qoldirish

Agar bitta tovar kabinetda bir nechta SKU bo'lib kiritilgan bo'lsa yoki artikullar mos kelmasa, integratsiya noto'g'ri qoldiq yuboradi. Integratsiyadan oldin katalogni tartibga keltiring.

Hujjatlar yangilanishini kuzatmaslik

API rivojlanmoqda: ba'zi metodlar eskirgan deb belgilanadi va yangilari chiqadi. Masalan, qoldiqlarni olishning eski versiyasi hujjatlarda allaqachon eskirgan deb ko'rsatilgan. Integratsiya kodini vaqti-vaqti bilan rasmiy hujjatlar bilan solishtirib turing.

SyncLab'da Uzum Market integratsiyasi

Biz Uzum Market'ni 1C, Smartup, ombor dasturi, sayt va Telegram bot bilan bog'laymiz: qoldiq va narxlarni uzatish, FBS va DBS buyurtmalarni yig'ish, moliya ma'lumotlarini hisobotlarga olib kelish. Integratsiyalar maxsus dasturlar yo'nalishida loyiha bo'yicha baholanadi. Agar marketpleysdan tashqari o'z do'koningiz ham kerak bo'lsa, internet-magazin yaratish bo'yicha ham qisqa brifdan keyin ishlar hajmi, muddat va qat'iy narx yozilgan taklif yuboramiz. Wallner loyihasida biz ERP'ni Smartup bilan integratsiya qilganmiz, shuning uchun hisob tizimlari bilan ishlash tajribamiz bor.

Ko'p beriladigan savollar