Getting Started
Cara Kerja Oziktag
Oziktag adalah Digital Trust Seal berbasis QR Code yang didesain untuk UMKM. Sistem ini membantu memvalidasi kualitas produk (QC) secara transparan agar pembeli merasa aman dan percaya.
1Registrasi & Verifikasi KYC
Pengguna melakukan login menggunakan Google OAuth (Supabase). Setelah itu, mereka diwajibkan mengisi form KYC (Know Your Customer) berupa Nama Brand, NIK, dan NPWP. Data ini disimpan dengan aman di database dan digunakan untuk menjamin identitas valid toko.
2Input Data Produk & QC
Pemilik toko memasukkan detail produk (Nama, Kategori, Batch), mengisi checklist QC, dan mengunggah foto produk riil. Foto tersebut dikirim ke layanan cloud (ImageKit) dan URL-nya diteruskan ke sistem AI.
// Contoh Payload Submit QC
{
"nama_produk": "Kopi Arabika Gayo",
"kategori": "Makanan & Minuman",
"checklist": ["Segel utuh", "Expired date jelas"],
"images": [File1, File2]
}3Analisis AI (Gemini 2.5 Flash)
Data yang dikirim akan dianalisis secara real-time oleh Google Gemini AI. AI akan memberikan Insight (sudut pandang kualitas) dan Solution (cara menyimpan atau mengkonsumsi) yang nantinya ditampilkan kepada pembeli.
4Scan oleh Pembeli
Sistem menghasilkan UUID unik dan dirender menjadi QR Code. Saat pembeli melakukan pemindaian (Scan), mereka diarahkan ke halaman publik yang menampilkan:
- Status Verifikasi Toko (Centang Biru KYC)
- Detail Checklist QC yang lulus
- Review dari AI tentang produk
- Foto riil kondisi barang sebelum dikirim
Arsitektur End-to-End
| Layer | Teknologi | Fungsi Utama |
|---|---|---|
| Frontend | Vite, React, TanStack Start | UI interaktif, Routing, Form Handling |
| Backend | Python, FastAPI | API Endpoints, Rate Limiting, AI Orchestration |
| Database | Supabase (PostgreSQL), Prisma | Penyimpanan Relasional, ORM kuat dan statik |
| Storage | ImageKit | Kompresi dinamis dan CDN untuk foto produk |
Model Pricing & Skala Bisnis
Oziktag menggunakan sistem Pay-As-You-Go (Kredit). Kami menolak model langganan bulanan agar lebih ramah bagi UMKM (tidak ada biaya yang "hangus" jika sedang sepi order). 1 Kredit = 1x Generate QR Code lengkap dengan analitik AI.
Mengapa Sistem Ini Kebal Fluktuasi Dollar?
Kami mematok harga jual ke UMKM dalam Rupiah (mulai dari Rp 250 - Rp 400 per QR). Di sisi lain, biaya variabel engine AI kami (Gemini 2.5 Flash) dibayar dalam Dollar, dengan harga dasar yang sangat rendah ($0.30 per 1 Juta Token).
Dalam setiap generasi QR, biaya AI yang dikeluarkan sistem kurang dari Rp 15. Ini menghasilkan Gross Margin di atas 90%. Bahkan jika terjadi krisis ekonomi dan nilai tukar Dollar meroket tajam, Oziktag tetap berdiri kokoh tanpa perlu menaikkan harga ke UMKM secara sepihak. Skalabilitas ini memastikan infrastruktur jutaan QR Code tetap ringan dan profitable.
AI Quality Control
Sistem QC (Quality Control) di Oziktag tidak sekadar menyimpan data. Kami menggunakan Google Gemini 2.5 Flash untuk menganalisis checklist dan catatan penjual secara otomatis. AI bertugas memberikan insight kepada pembeli mengenai kondisi barang secara lebih ramah dan profesional, serta memberikan tips perawatan produk.
Sistem KYC (Know Your Customer)
Untuk mencegah penyalahgunaan label QC (pemalsuan identitas toko), setiap brand UMKM diwajibkan untuk mengisi form KYC yang berisi NIK KTP dan/atau NPWP. Data ini bersifat konfidensial dan hanya digunakan untuk validasi bahwa QR Code yang di-scan pembeli benar-benar berasal dari penjual asli, bukan pihak ketiga yang mencetak ulang QR.
API Reference
Integrasikan pembuatan QR Code QC secara otomatis dari sistem ERP, POS, atau aplikasi kasir internal Anda. Gunakan API Key yang dapat di-generate melalui dashboard Developer API.
/api/v1/qcEndpoint ini digunakan untuk men-generate label QR Code QC baru beserta analisis AI otomatis.
Headers
Request Body (JSON)
{
"nama_produk": "String (Required)",
"kategori": "String (Required)",
"batch": "String (Optional)",
"checklist": ["String", "String"] (Array of Strings, Required),
"catatan_penjual": "String (Optional)",
"image_urls": ["String"] (Array of HTTP URLs, max 5, Required)
}Success Response (201 Created)
{
"qr_url": "https://www.oziktag.my.id/scan/...",
"product_id": "uuid-string"
}Error Responses
401 Unauthorized: API Key tidak valid atau tidak disertakan.402 Payment Required: Saldo kredit API Anda habis.400 Bad Request: Format body JSON tidak sesuai.