Tento zdroj slouží k importu základních entit jako poboček, kategorie nebo plánovaných náhrad v Quantu. Vstupním i výstupním formátem je JSON.

Pro vytvoření a nastavení importu použijte sekci Automatické úlohy. Po vytvoření bude v seznamu úloh ID, které předáte v URL požadavku.

Automatická úloha

• Nastavení

Před použitím API je nutno upravit tyto atributy v záložce Nastavení:

• Zaškrtněte atribut Zapnuto pro povolení úlohy.
• V atributu Uživatelé s povoleným přístupem pro API zvolte jednoho nebo více uživatelů s rolí Robot, kteří budou mít oprávnění úlohu spouštět.
• V atributu Základní entita pro import vyberte jakou entitu požadujete importovat.
• V atributu Párovací atribut vyberte atribut podle, kterého se mají propojit stávající hodnoty s novými.
• V atributu Mapování atributů zvolte atributy pro import a volitelně upravte jejich JSON klíče.
• Dále doporučujeme vyplnit Emaily k notifikacím, kde zadáte jednu či více e-mailových adres, na které budou zasílány e-maily s chybovými stavy.
• Atributy 

Nastavení

• Požadavek

/v1/import/basic-entities/{id_ulohy}

Parametr	Hodnota
URL	?debug přidaný do URL zobrazí v odpovědi i varování. Bez toho se vypisují pouze chyby.
Hlavička	Accept: application/json
Hlavička	Content-type: application/json
Hlavička	Authorization: Bearer  <TOKEN> TOKEN se získává pomocí /authenticate (viz. Přihlášení).
Metoda	POST

Obsahem požadavku je pole JSON objektů obsahující klíče definované v nastavení Mapování atributů. 

Je důležité, aby požadavek odpovídal standardům pro JSON formát. Kompletní definici těchto standardů najdete zde. Hodnoty číselných atributů prosím posílejte bez uvozovek viz příklad.

• Odpověď

Klíč	Hodnota
Status	Řetězec popisující výsledný stav importu. SUCCESS = bezchybný průběh importu PARTIAL_SUCCESS = import proběhl, ale vygeneroval jedno nebo více varování FAILURE = při importu nastala jedna nebo více chyb
Warnings	Je volitelný, tzn. je zahrnut pouze, pokud je v URL parametr ?debug a import vygeneroval alespoň jedno varování. Seznam řetězců s varováními.
Errors	Volitelný - je zahrnut pouze, pokud import vygeneroval alespoň jednu chybu. Seznam řetězců s chybami.
Total Lines	Volitelný - je zahrnut pouze, pokud import neskončil se stavem "FAILURE" Počet záznamů na vstupu.
Duplicated	Volitelný - je zahrnut pouze, pokud import neskončil se stavem "FAILURE" Počet záznamů, které byly přeskočeny, protože tento produkt již byl importován ve stejném požadavku.
Empty IDs	Volitelný - je zahrnut pouze, pokud import neskončil se stavem "FAILURE" Počet záznamů, které byly přeskočeny, protože k nim nebylo nalezeno párovací ID požadavku.
Ignored	Standardně, když import nenajde živou položku k danému ID, tak hledá mezi smazanými položkami. Pokud najde smazanou položku, tak ho oživí. Zapnutím této volby se smazané položky místo oživení ignorují.

 

• Stavové kódy

Stav	Význam
200 OK	Import proběhl úspěšně s výsledným stavem "SUCCESS" nebo "PARTIAL_SUCCESS". Odpověď může obsahovat varování nebo nezávažné chyby.
400 Bad Request	Chybné nastavení úlohy nebo chybný požadavek.
401 Unauthorized	Autorizační token je neplatný, nebo uživatel, který je tokenem přihlášen, nemá oprávnění spouštět tuto úlohu.
404 Not Found	Nebyla nalezena úloha s ID daným v URL.
500 Internal Server Error	Během importu nastala kritická chyba na straně serveru.
503 Service Unavailable	Import již běží. Zkuste to spustit znova za počet sekund udávaných v hlavičce Retry-After.

• Nejnovější logy

V Quantu vedle nastavení úlohy lze prohlížet i nejnovější logy jednotlivých importů, včetně statistik, chyb a varování.

Vybereme-li konkrétní záznam, můžeme zobrazit jeho detaily tlačítkem Stáhnout soubory.

Detaily záznamu 

• Požadavek

 curl -X POST --location "https://[YOUR_COMPANY].iquant.eu/v1/import/basic-entities/959977?debug" \

    -H "Authorization: Bearer ywJqq25pXO6oaCPqgEAiTioBVwM8Ih2kOwzzd3eWK3R2oDSA5n" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Cache-Control: no-cache" \
-d "[ {"id":"CAT001","name":"Number 1","prodAt":  ["External ID attribute 1","External ID attribute 2"]},
 {"id":"CAT002","name":"Number 2","prodAt":  "External ID attribute 1"},
{"id":"CAT003","name":"Number 3","prodAt": ["External ID attribute 1","External ID attribute 4","External ID attribute 5"]
"}]"

• Odpověď

{
  "Status": "SUCCESS", 
  "Total Lines": 4,
  "Duplicated": 0,
  "Empty Ids": 1,
  "Ignored": 0
}