Listeaza produse

Despre

• Returneaza datele aferente produselor al caror nume respecta un anumit tipar. Lista este limitata cu start si limit, dar contine si un camp cu numarul total de astfel de produse.
• Indiferent de limita aleasa, vor fi afisate maxim 50 produse pe apel.

Clasa

celmarket\Products\ProductsList

Metoda

listProducts

API

• metoda: products
• actiune: readProducts

Parametri

• start = pozitia de start a listarii
• limit = numarul de produse din lista
• search = cautare in functie de nume / model
  • sirul de caractere va fi impartit in cuvinte si se vor cauta produsele care le contin in ordinea in care apar in sir
• forceCount = returneaza numarul total de randuri indiferent de celelalte conditii
• filters = array cu filtre ce vor fi aplicate produselor -> json_encode(array)
  • keyword = filtreaza produsele in functie de denumire si model - folosit pentru compatibilitate - daca parametrul "search" contine o valoare valida, atunci acest camp va fi suprascris
  • manufacturer = numele unui producator
  • status = array cu statusurile dorite -> array
    • (element din array) = status (valorile posibile sunt 0 si 1)
  • categories_id = array cu ID-urile categoriilor -> array
    • (element din array) = ID-ul unei categorii
  • products_last_modified_min = data minima de modificare a produsului
  • products_last_modified_max = data maxima de modificare a produsului
  • products_date_added_min = data minima de adaugare a produsului
  • products_date_added_max = data maxima de adaugare a produsului
  • products_model = array cu lista de modele de produse - maxim 50 -> array
    • (element din array) = modelul unui produs
  • transport_tax = daca include sau nu taxa de transport
  • orderByMostViewed = daca este adevarat, produsele vor fi sortate descrescator in functie de numarul de vizualizari

Raspuns

Un obiect cu urmatoarele atribute

• limit = numarul de produse returnate
• start = pozitia de start a listei returnate
• moreavailable = mai sunt produse neafisate
• data = produsele -> array
  • (element din array) = datele unui produs
    • pretf = pret furnizor
    • products_model = modelul produslui
    • bonus = valoarea bonusului -> array
      • (element din array) = valoarea unui bonus
    • stoc = valoarea stocului
    • cand = data adaugarii
    • pret_vechi = pretul vechi
    • id_campanie = id-ul campaniei din care face parte
    • pret_promo = pretul promotional calculat pe baza pretului in lei si a discount-ului
    • start = start
    • adaos = adaos comercial
    • pretlei = pretul in lei cu TVA
    • moneda = denumirea monedei
      • USD = Dolar SUA
      • EUR = Euro
      • RON = Leu romanesc
      • lei = Leu romanesc
    • end = sfarsit
    • procesare_in = procesare
    • status = status-ul
    • products_status = statusul pe website
    • products_name = numele produsului
    • products_url = adresa url a produslui
    • garantie = durata garantiei in luni pentru persoanele fizice
    • garantie_pj = durata garantiei in luni pentru persoanele juridice
    • url = url-ul
    • pret_promo = pret promotional pentru produs
    • products_description = descrierea produsului
      • descrierrea este encodata in base64
    • link = link-ul catre produs
      • incepe cu test.cel.ro daca se foloseste un utilizator de test
      • incepe cu www.cel.ro daca este live
    • charact = caracteristicile produsului -> array
      • (element din array) = caracteristica
        • (cheie) = denumirea caracteristicii
        • (valoare) = valorile caracteristicii -> array
          • (element din array) = o valoare a unei caracteristici
    • weight = greutatea produsului
    • main_image = imaginea principala
    • manufacturer = ID-ul producatorului
    • categs = categoriile din care produsul face parte -> array
      • (element din array) = categorie
        • (cheie) = ID-ul categoriei
        • (valoare) = denumirea categoriei
    • secondary_images = imagini secundare -> array
      • (array element) = informatii despre o imagine secundara -> array
        • url = URL-ul imaginii secundare
        • id = ID-ul imaginii secundare
    • principal = specifica daca afiliatul este principal (1) sau nu (0)
    • tva = TVA-ul aferent produsului
    • products_last_modified = data ultimei actualizari a produsului
    • products_date_added = data adaugarii produsului
    • total_views = numarul total de vizualizari din ultimele 5 zile
    • date_views = numarul de vizualizari pe fiecare data in ultimele 5 zile
      • products_views = numaruld e vizualizari pe data
      • data = data
    • promotion = promotia produsului
      • 0 = normal
      • 1 = promotie
      • 2 = lichidare
    • extprice = pret extern (optional)
• count = numarul total de produse care indeplinesc conditiile din filtru

Exemplu - PHP

https://github.com/celdotro/marketplace_examples/blob/master/Products/2.listProducts.php

Exemplu - JSON

{
  "request": {
    "start": 0,
    "limit": 0,
    "search": "X",
    "forceCount": true,
    "filters": {
      "keyword": "X",
      "manufacturer": [1],
      "status": "X",
      "categories_id": [1],
      "products_last_modified_min": "01-01-2018",
      "products_last_modified_min": "01-01-2018",
      "products_date_added_min": "01-01-2018",
      "products_date_added_max": "01-01-2018",
      "products_model": ["X"]
    }
  },
  
  "response": {
    "limit": 0,
    "start": 0,
    "moreavailable": 0,
    "data": [
      {
        "pretf": 1,
        "products_model": "X",
        "bonus": [],
        "stoc": 1,
        "cand": "2018-01-01 00:00:00",
        "pret_vechi": 1,
        "id_campanie": 1,
        "pret_promo": 1,
        "start": 1,
        "adaos": 1,
        "pretlei": 1,
        "moneda": "X",
        "end": 0,
        "procesare_in": 0,
        "status": 0,
        "products_status": 0,
        "products_name": "X",
        "products_url": "X",
        "garantie": 1,
        "garantie_pj": 1,
        "url": "X",
        "family_id": 1,
        "principal": 1,
        "categories_id": 1,
        "products_last_modified": "2018-01-01 00:00:00",
        "products_date_added": "2018-01-01 00:00:00",
        "vendor_ext_id": 0,
        "products_description": "X",
        "family_name": "X",
        "family_characts": [
          {
            "charact": "X",
            "mode": 1
          }
        ],
        "link": "X",
        "formattedCategory": {
          "1": {
            "parents_name": "X",
            "current_id": 1
          }
        },
        "tva": 1,
        "charact": [],
        "weight": 0,
        "main_image": "X",
        "manufacturer": "X",
        "categs": {
          "1": "X"
        },
        "formattedCategories": {
          "1": {
            "parents_name": "X",
            "current_id": 1
          }
        },
        "secondary_images": []
      }
    ]
  }
}