Import produse

Despre

• Insereaza sau actualizeaza unul sau mai multe produse.
• Poate primi o forma detaliata sau una scurta
  • Forma detaliata este folosita pentru produsele care nu au fost adaugate inca sau pentru care se fac schimbari majore (altele decat cele permise de parametrii formei scurte)
  • Forma scurta este pentru produsele deja aprobate
• Daca modelul unui produs este gasit in lista de produse in curs de aprobare sau neaprobate, toate datele sale vor fi inlocuite
• Parametrul 'hasTVA' poate fi specificat la nivel general sau la nivelul fiecarei linii si reprezinta proprietatea campului 'pretf' de a include TVA. Cu toate acestea, incercati sa folositi fie la nivel general, fie la nivelul fiecarei linii fara sa le amestecati, deoarece pretul este considerat ca incluzand TVA-ul daca unul dintre ei are valoarea 1. Pentru a intelege mai bine logica acestui parametru, aveti la dispozitie:
  • sectiunea dedicata parametrilor
  • linia de cod de mai jos in care se evalueaza daca parametrul 'pretf' contine sau nu TVA

    if ((!is_null($product['hasTVA']) && $product['hasTVA']) || (!is_null($params['hasTVA']) && $params['hasTVA']))

Clasa

celmarket\Products\ProductsInsert

Metoda

importProducts

API

• metoda: import
• actiune: importer

Parametri

• (products) = lista produselor importate => pot fi 2 tipuri -> array
  1. import complet (campurile scrise cu caractere aldine sunt obligatorii iar pentru cele scrise cu caractere cursive urmeaza o regula care va fi specificata in acelasi rand) -> array

     • forceInsert = insereaza produsele, iar daca mai exista, le adauga prefix

     • overridePrice = insereaza chiar daca diferenta este mai mare de 10%

     • products_name = numele produsului

     • products_model = modelul produsului

     • manufacturers_name = numele producatorului

     • categories_id = id-ul categoriei

     • stoc = valoarea stocului

     • pretf = pret furnizor

     • products_image = imaginea produsului

     • products_description = descrierea produsului

     • moneda = denumirea monedei in care este exprimat pretul * USD = Dolar SUA * EUR = Euro * RON = Leu romanesc * lei = Leu romanesc

     • garantie = durata garantiei pentru persoanele fizice in luni

     • garantie_pj = durata garantiei pentru persoanele juridice in luni

     • products_url = adresa url a produslui

     • charact = caracteristici -> array

       • (element din array) = caracteristica -> array
         • (nume caracteristica) => valori caracteristica -> array
           • (element din array) => valoare caracteristica (noile valori sunt adaugate automat)

     • products_weight = greutatea produsului

     • status = statusul produsului

     • import_code = codul de import DEPRECATED

     • products_quantity = cantitatea produsului

     • adaos = adaos comercial

     • bonus = produsele bonus -> array

       • (element din array) = modelul unui produs folosit ca bonus

     • recomandate = valoare recomandate

     • image = array de imagini secundare -> array

       • (element din array) = imagine secundara
         • id = ID-ul imaginii
           • 0 = imagine noua
           • != 0 = ID-ul unei imagini existente
       • url = URL-ul imaginii

     • pret_vechi = pretul vechi

     • status = statusul produsului (1 daca nu e setat)

     • hasTVA = daca parametrul 'pretf' are sau nu TVA-ul inclus

       • nu exista = nu are inclus TVA
       • 0 = nu are inclus TVA
       • 1 = are inclus TVA

     • type = insert => import de tip insert

     • procesare_in = numarul de zile maxim de livrare (intre 0 si 24)

     • family_id = ID-ul familiei

       • family_name = numele familiei
       • family_type = tipul familiei -> array
         • (element din array) = familie
           • charact = numele si ID-ul caracteristicii formatat ca: "CharactName [CharactID]"
           • mode = modul caracteristicii
             • 1 = text
             • 2 = imagine

     • virtual = daca produsul este virtual

       • 0 = nu este virtual
       • 1 = este virtual

     • vendor_ext_id = ID-ul dumneavoastra pentru produs

  2. import rapid (campurile scrise cu caractere aldine sunt obligatorii) -> array
     • products_model = modelul produsului
     • pretf = pret furnizor (cel putin 1 dintre campurile "stoc" si "pretf" trebuie specificat)
     • stoc = valoarea stocului (cel putin 1 dintre campurile "stoc" si "pretf" trebuie specificat)
     • procesare_in = intervalul maxim de livrare (intre 1 si 24 zile)
     • hasTVA = daca parametrul 'pretf' are sau nu TVA-ul inclus
       • nu exista = nu are inclus TVA
       • 0 = nu are inclus TVA
       • 1 = are inclus TVA
     • type = update => import de tip update
     • status = statusul produsului
  3. hasTVA = camp optional care specifica la nivel general proprietatea de a avea TVA (folositi fie la nivelul fiecarei linii, fie la nivelul produslui, deoarece daca le amestecati, se va considera ca 'pretf' are TVA inclus daca unul dintre acesti parametri are valoarea 1, lucru care poate duce la introducerea de date eronate)
     • nu exista = nu are inclus TVA
     • 0 = nu are inclus TVA
     • 1 = are inclus TVA

Raspuns

Un obiect cu urmatoarele atribute

• message = "Total updated: X", unde X este numarul total al produselor actualizate
• failed = un obiect cu toate erorile -> obiect
  • line = linia erorii (indexul din array-ul cu produse prelucrate sau -1 daca lipsesc datele esentiale si nu poate fi prelucrat)
  • products_model = modelul produsului
  • columns = coloanele cu probleme -> array
    • msg = mesajul de eroare
    • column = numele coloanei unde a avut loc eroarea

In caz de succes, va fi afisat mesajul "Total updated: X", unde X este numarul total al produselor actualizate

Exemplu - PHP

https://github.com/celdotro/marketplace_examples/blob/master/Products/3.importProducts.php

Exemplu - JSON

{
  "request": {
      "products": {
          "0" :
              {
                "forceInsert": 1,
                "overridePrice": 1,
                "products_name": "X",
                "products_model": "X",
                "manufacturers_name": "X",
                "categories_id": 1,
                "stoc": 1,
                "pretf": 1,
                "products_image": "X",
                "products_description": "X",
                "moneda": "X",
                "garantie": 1,
                "garantie_pj": 1,
                "products_url": "X",
                "image": [
                  {
                    "id": 1,
                    "url": "X"
                  }
                ],
                "charact": {
                  "X": [
                    "X"
                  ]
                },
                "products_weight": 1,
                "status": 0,
                "import_code": 1,
                "products_quantity": 1,
                "adaos": 1,
                "bonus": [
                  "X"
                ],
                "recomandate": 1,
                "procesare_in": 1,
                "pret_vechi": 1,
                "status": 1,
                "hasTVA": 1,
                "type": "insert",
                "procesare_in": 1,
                "virtual": 0,
                "family_id": 1,
                "family_name": 1,
                "family_type": [
                  {
                  "charact": "CharactName [CharactID]",
                  "mode": 1
                  }
                ]
              }
              },
              
              "1" : {
                "products_model": "X",
                "pretf": 1,
                "stoc": 1,
                "hasTVA": 1,
                "procesare_in": 1,
                "type": "update",
                "status": 1
              },
              
              "hasTVA": 0
          }
  },
  
  "response": {
    "message": "X",
    "failed": [
      {
        "line": 1,
        "products_model": "X",
        "columns": {
          "msg": "X",
          "column": 1
        }
      }
    ]
  }
}