Katalog proizvoda i zalihe
5 minPoslednja izmena: 2026-03-31
Kreiranje kataloga
Katalog proizvoda je kontejner za sve vaše proizvode. Svaki katalog ima naziv, opcioni opis i valutu. Kreirajte ga na kontrolnoj tabli ili preko API-ja:
POST /api/v1/commerce/catalogs
{
"name": "PetCenter Serbia",
"description": "Pet food and accessories",
"currency": "RSD"
}
Katalog pripada jednoj grupi. Kod postavki za više zemalja koristi se po jedan katalog za svaku zemlju, u lokalnoj valuti.
Dodavanje proizvoda
Svaki proizvod sadrži:
- name: naziv proizvoda
- sku: jedinstvena šifra artikla (SKU)
- price: osnovna cena u valuti kataloga
- variants: JSON niz opcija (veličina, boja, ukus itd.)
- images: niz URL-ova slika
- description: opis proizvoda (koristi ga AI asistent za kupovinu)
- status:
active,draftiliarchived
POST /api/v1/commerce/catalogs/:catalogId/products
{
"name": "Premium Dog Food",
"sku": "PDF-001",
"price": 2450,
"variants": [
{ "name": "size", "options": ["2kg", "5kg", "10kg"] }
],
"images": ["https://..."],
"description": "High-protein dry food for adult dogs"
}
Upravljanje zalihama
Zalihe koriste atomske operacije (SELECT...FOR UPDATE) da bi se sprečila prodaja preko stanja:
- Postavljanje zaliha: zadaje apsolutnu količinu na stanju za proizvod
- Korekcija zaliha: povećava ili smanjuje stanje (pozitivna/negativna razlika)
- Provera zaliha: vraća trenutno stanje
- Prenos: premešta robu između lokacija/magacina
POST /api/v1/commerce/inventory/adjust
{
"product_id": 123,
"delta": -5,
"reason": "Manual adjustment"
}
Upozorenja o niskim zalihama i CSV uvoz
Podesite prag niskih zaliha za svaki proizvod. Kada stanje padne ispod praga, okida se workflow trigger low_stock. Proizvode možete i masovno uvesti preko CSV-a sa kolonama: name, sku, price, description, quantity.