OneTrace.pro Yordam markazi

Doʻkonlar va oflayn savdo

Doʻkonlaringizdagi xaridlarni onlayn maʼlumotlar bilan birga OneTrace.pro ga uzatish mumkin. Kassadagi chek xaridor profiliga uning saytdagi tashriflari, mahsulot koʻrishlari va xatlari yoniga tushadi. Shu yerdan ROPO hisoboti boshlanadi: mahsulotni avval onlayn oʻrgangan xaridorlar doʻkonlarda qancha savdo qilgan. Doʻkonlardagi xaridlar segmentlar va zanjirlarga ham mavjud.

Boʻlim — Maʼlumotlar → Doʻkonlar. Uni mahsulotlarni koʻrish huquqiga ega rollar koʻra oladi, qoida va roʻyxatni mahsulotlarni oʻzgartirish huquqiga ega rollar oʻzgartira oladi.

«Doʻkonlar» boʻlimi: oflayn xarid qoidasi, nuqtalar boʻyicha cheklar va roʻyxat

Doʻkondagi xaridni qanday ajratish kerak

Doʻkon cheki — saytdagi buyurtma bilan bir xil xarid hodisasi, masalan, summa va mahsulotli order_completed. OneTrace.pro uni onlayn buyurtmadan ajratishi uchun chekda alohida xususiyat boʻladi. Qoida Doʻkondagi xaridni qanday ajratish kerak blokida belgilanadi:

  • Xarid hodisasi xususiyati (sukut boʻyicha) — chek channel xususiyati va offline qiymatli xarid hodisasi bilan yuboriladi. Xususiyat va qiymatni oʻzgartirish mumkin. Xarid hodisasi prognoz sozlamalaridan olinadi.
  • Alohida hodisa — agar cheklar allaqachon oʻz hodisasi bilan kelsa, masalan, store_purchase, shuni tanlang.
  • Doʻkon ID si xususiyati (sukut boʻyicha store_id) chekni roʻyxatdagi savdo nuqtasi bilan bogʻlaydi.

Qoida darhol hamma joyda amal qiladi: ROPO hisobotida, segment shartida, zanjir triggerida va cheklar faylini yuklashda.

Cheklarni qanday uzatish kerak

Chek xaridori telefon, email yoki sodiqlik kartasi raqami boʻyicha aniqlanadi. Ular bilan profil hali boʻlmasa, yangisi yaratiladi. Xaridor saytda xuddi shu telefon yoki emailni qoldirganda, profillar birlashadi va uning onlayn tarixi doʻkondagi xaridlar bilan qoʻshiladi, qarang: Profillarni birlashtirish. Telefon, email va kartasiz chekni onlayn tarix bilan bogʻlab boʻlmaydi, shuning uchun u hisobot uchun foydasiz.

Toʻrt usul bor:

Usul Qachon mos keladi
1C uchun kengaytma 1C:Retail, 1C:Small Business Management yoki 1C:Trade Management cheklari — har 15 daqiqada avtomatik
API soʻrov yubora oladigan oʻz kassangiz yoki hisob tizimingiz
Doʻkon cheklari shablonli maʼlumot manbasi tizim har kecha fayl qilib joylaydigan cheklar eksporti, qarang: Maʼlumot manbalari
Fayl yuklash oʻtgan davr cheklarini bir martalik yuklash, masalan, kassa ulanishidan oldin hisobotni koʻrish uchun

Qaysi usulni tanlamang, bir xil chekni bir sutka ichida qayta yuborish dublikat yaratmaydi.

1C uchun kengaytma

1C:Retail 2.3 va 3.0, 1C:Small Business Management (UNF) 1.6 va 3.0 hamda 1C:Trade Management 11 uchun konfiguratsiya kengaytmasi, platforma — 1C:Enterprise 8.3.21 va undan yangi. Konfiguratsiya oʻzgarmaydi: hammasi kengaytmada.

  • Har 15 daqiqada oʻtkazilgan yangi KKM cheklarini yuboradi: sana, raqam, doʻkon, summa va mahsulotlar. Xaridor — chekdagi telefon, email va sodiqlik kartasi.
  • Sutkada bir marta doʻkonlar roʻyxatini yuboradi.
  • Xaridorsiz chek oʻtkazib yuboriladi va sababi bilan roʻyxatdan oʻtkazish jurnaliga yoziladi. Qolgan cheklar yuboriladi.
  • Agar OneTrace.pro ga ulanib boʻlmasa yoki kalit notoʻgʻri boʻlsa, cheklar yoʻqolmaydi: ular keyingi ishga tushirishda yuboriladi.

Agar Cheklar faylini yuklash blokida 1C uchun kengaytma havolasi boʻlsa, u orqali kengaytma va oʻrnatish hamda sozlash boʻyicha yoʻriqnomani topasiz. Kengaytma uchun «Mahsulotlarni yuklash va oʻchirish» ruxsatli Secret API kaliti kerak: bu ruxsat doʻkonlar roʻyxati uchun zarur. Kengaytmaning sozlash ishlov berishida OneTrace.pro manzilini va kalitni kiriting, ulanishni tekshiring va sozlamalarni saqlang.

Chekdagi mahsulot nomenklaturaning artikuli, kodi yoki noyob identifikatori bilan uzatiladi — sozlamalarda katalogdagi mahsulot ID lariga mos keladiganini tanlang. Aks holda ROPO hisoboti xaridor saytda koʻrgan mahsulotlarni topa olmaydi.

API

Chekni Secret kaliti bilan track hodisasi sifatida yuboring. Xaridor context.traits da uzatiladi, userId kerak emas:

{
  "event": "order_completed",
  "messageId": "check-ber01-000123",
  "timestamp": "2026-10-29T15:04:00+01:00",
  "properties": {
    "channel": "offline",
    "store_id": "BER-01",
    "order_id": "000123",
    "amount": 89.90,
    "products": [{ "product_id": "SKU-1", "price": 89.90, "quantity": 1 }]
  },
  "context": { "traits": { "phone": "+49 151 2345 6789", "loyalty_card": "2770 0001 5002" } }
}
  • Soʻrov — POST /api/v1/track, paketda — POST /api/v1/batch, qarang: Server orqali integratsiya.
  • Xaridorni context.traits boʻyicha faqat Secret kalitli soʻrovlar topadi. Saytning yozuv kaliti bilan bunday qilib boʻlmaydi: aks holda tashrifchi oʻzini birovning telefoni bilan tanishtirishi mumkin edi.
  • messageId — chekning doimiy ID si, masalan, doʻkon va chek raqami. Xuddi shu messageId bilan takroriy soʻrov rad etiladi.
  • Agar mijoz saytda shaxsiy kabinetga kirgan boʻlsa va kassa uning ID sini bilsa, userId ni ham uzating.

Doʻkonlar roʻyxatga POST /api/v1/stores soʻrovi bilan uzatiladi, tana — {"items": [{"id": "BER-01", "name": "Berlin Mitte", "city": "Berlin", "address": "…"}]} — bir martada 1000 tagacha nuqta, ID si xuddi shunday nuqta yangilanadi. «Mahsulotlarni yuklash va oʻchirish» ruxsati kerak.

Cheklar faylini yuklash

  1. Maʼlumotlar → Doʻkonlar boʻlimida Cheklar faylini yuklash blokidagi Faylni tanlash tugmasini bosing. 50 MB gacha CSV yoki 10 MB gacha Excel (.xlsx, .xls, birinchi varaq) mos keladi. Birinchi qatorda — ustun nomlari.
  2. Har bir ustunda nima borligini koʻrsating: chek sanasi va vaqti (majburiy), telefon, sodiqlik kartasi, email yoki xaridor ID si (kamida bitta ustun), doʻkon, chek raqami, summa, mahsulotlar. Nomlari oʻxshash ustunlar oʻzi moslashadi. Keraksiz ustunlarni oʻtkazib yuboring, qolganlarini chek xususiyatlari sifatida saqlash mumkin.
  3. Cheklarni yuklash tugmasini bosing. Yuklash jarayoni va qatorlar xatolari sahifada koʻrinadi. Oxirgi yuklashlar shakl ostida koʻrsatilgan.

Cheklar faylini yuklash: ustunlarni belgilash

  • Soat mintaqasiz vaqt, masalan, 2026-10-28 18:42 yoki 28.10.2026 18:42, loyiha vaqti hisoblanadi: kassa odatda mahalliy vaqtni yozadi.
  • Bir katakdagi mahsulotlar ;, , yoki | bilan ajratiladi.
  • Har bir qator oflayn xarid qoidasi boʻyicha chek boʻladi. Xaridorsiz qator xato bilan oʻtkazib yuboriladi.
  • Yuklash profillarni oʻzgartirish huquqiga ega rollarga mavjud. Yuklangan cheklar tarifning oylik hodisalar kvotasida hisobga olinadi.

Doʻkonlar roʻyxati

Roʻyxat savdo nuqtalariga ROPO hisobotida cheklardagi ID lar oʻrniga tushunarli nomlar beradi. Doʻkonning Doʻkon ID si (cheklardagi store_id qiymati), Nomi, Shahar va Manzil maydonlari bor. Doʻkonni Doʻkon qoʻshish tugmasi bilan, API orqali yoki 1C kengaytmasi bilan qoʻshish mumkin.

Soʻnggi 30 kundagi cheklar bloki har bir nuqtada qancha chek va xaridor boʻlganini va oxirgi chek qachon kelganini koʻrsatadi. Roʻyxatda boʻlmagan nuqta «Roʻyxatda yoʻq» deb belgilanadi — Nom berish tugmasi uni qoʻshadi. Agar doʻkonni oʻchirsangiz, uning cheklari qoladi, hisobotda esa nom oʻrniga ID koʻrsatiladi.

Segmentlar va zanjirlar

  • Doʻkondagi xarid segment sharti oxirgi N kundagi doʻkon xaridorlarini tanlaydi. «Chekdan oldingi onlayn teginishlar» maydoni: «Istalgan» — barcha xaridorlar, «Onlayn teginishdan keyin» yoki «Onlayn teginishsiz». Teginish oynasini, ularning turlarini va doʻkonni tanlash mumkin. Qarang: Segmentlar.
  • Doʻkondagi xarid zanjir triggeri doʻkondagi har bir chek uchun zanjirni ishga tushiradi. Doʻkon va minimal summani cheklash mumkin, masalan, doʻkonni baholashni soʻrash yoki xaridga mahsulotlar taklif qilish uchun. Qarang: Zanjirlar.