DokumentacijaKatalog proizvoda i zalihe

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, draft ili archived
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.

Da li vam je ovaj članak pomogao?