Kategorie produktów

Kategorie tworzą drzewo: każda kategoria wskazuje swoją kategorię nadrzędną. Produkt może należeć do wielu kategorii – przypisania pobierasz osobno.

Kategorie

GET https://{amper_ws}/external/v1/categories/
GET https://{amper_ws}/external/v1/categories/{id}/

Lista zawiera wszystkie kategorie instalacji – także te, w których klient nie ma żadnego produktu. Puste kategorie możesz pominąć po pobraniu przypisań.

[
  { "id": 3, "parent_id": null, "name": "Motoryzacja", "description": "", "category_external_id": "KAT-003" },
  { "id": 12, "parent_id": 3, "name": "Zapachy samochodowe", "description": "", "category_external_id": "KAT-012" }
]

Pole	Opis
id	ID kategorii w AMPER
parent_id	ID kategorii nadrzędnej; null dla kategorii głównej
name	nazwa kategorii
description	opis kategorii
category_external_id	ID kategorii w systemie ERP; null, gdy kategoria nie pochodzi z ERP

Drzewo budujesz po polu parent_id. Jest potrzebne także przy promocjach: warunek promocji na kategorię obejmuje produkty tej kategorii i wszystkich kategorii pod nią – patrz Promocje – logika i wyliczanie cen.

Przypisania produktów do kategorii

GET https://{amper_ws}/external/v1/product-categories/

Jeden wiersz to jedno przypisanie produktu do kategorii. Lista zawiera tylko produkty dostępne dla klienta.

[
  { "product_id": 1037, "category_id": 12 },
  { "product_id": 1037, "category_id": 48 }
]

Pole	Opis
product_id	ID produktu w AMPER
category_id	ID kategorii w AMPER

Lista nie ma filtrów – pobierz ją w całości (stronami) i zbuduj w swoim systemie mapę produkt → kategorie. Produkty jednej kategorii pobierzesz też bezpośrednio: /external/v1/products/?category_id=12 (tylko ta kategoria) albo ?category_ids=12 (z podkategoriami) – patrz Produkty i zdjęcia.