Agenda prislusenstvi

Obsahuje inzeráty příslušenství

Přehled podagend

Název	Strojový název	WRITE
Fotografie	`photo`	ANO
Historie cen	`ceny`	NE
Statistika	`stats`	NE

Funkce agendy

Název	Možnosti
Podporované metody	`GET`, `PUT`/`POST`, `DELETE`
Podpora úrovně detailu	✔
Podpora filtrace	✔
Podpora fulltextu	✔
Podpora stránkování	✔
Podpora řazení	✔
Podpora externích identifikátorů	✔
Podpora `schémat`	https://api.tipmoto.com/schemas/prislusenstvi-{export\|import}{-enum}.{xsd\|rng}
Podpora `?fail-on-warning`	✔
Podpora dry-run	✔
Vrací `location`	✔

Položky agendy

Str. název	Název	Typ	Informace	rw	P	S	➀	➁
`id`	ID inzerátu v agendě `prislusenstvi`	`integer`				✔	✔	✔
`idApi`	externí ID inzerátu	`string 64`		✔		✔	✔	✔
`aktivni`	aktivní	`select`	Možné hodnoty: `0` Ne `1` Ano `2` Web firmy	✔	✔	✔	✔	✔
`lastModified`	Poslední úprava	`datetime`	Formát `YYYY-MM-DD HH:MM:SS`	✔	✔	✔	✔	✔
`pobocka`	Pobočka	`string 128`	Zobrazuje se a zpracovává se pouze má-li firma více poboček	✔				✔
`pobocka@id`	ID pobočky	`integer`	Zobrazuje se a zpracovává se pouze má-li firma více poboček	✔	✔	✔		✔
`kontakt`	Kontakt	`element`	Kontakt u inzerátu – telefony, e-mail a web, které se u inzerátu ukazují místo údajů pobočky (adresa, název prodejce a otevírací doba zůstávají z pobočky). Kontakty firmy jsou v agendě `kontakt`. Zobrazuje se pouze u firem s aspoň jedním kontaktem, pak u každého inzerátu (i s `id="0"`). Atribut `ref` odkazuje na kontakt, u `id="0"` chybí.					✔
`kontakt@id`	ID kontaktu	`integer`	`0` = výchozí kontakt pobočky, jinak ID kontaktu téže firmy. Kontakt, který firma nemá (např. smazaný), se vypíše jako `0`. Zápis `<kontakt id="N"/>`: bez prvku nebo s prázdným `id` se kontakt nemění, nový inzerát dostane `0`. Nečíselné ID vrátí chybu „Neplatné ID kontaktu '…'“, neexistující kontakt nebo kontakt jiné firmy chybu „Firma '…' nemá kontakt id '…'“.	✔		✔		✔
`nazev`	Název příslušenství	`string 64`		✔	✔	✔		✔
`brandprislusenstvi`	Značka	`string 64`	Pokud je `brandprislusenstvi@id` = 1 (ostatní), pak je libovolná. Jinak je hodnota z agendy `brandprislusenstvi`	✔		✔		✔
`brandprislusenstvi@id`	ID značky	`integer`	Při importu má přednost ID před textem	✔		✔		✔
`zarazeniprislusenstvi`	Zařazení	`integer`	Zařazení je z agendy `zarazeniprislusenstvi`	✔	✔	✔		✔
`zarazeniprislusenstvi@zarazeniName`	Parametry zařazení	`string 64`	Při importu lze použít i textové určení zařazení Doporučujeme používat ID, ze zpětně kompatibilních důvodů možno zadat i textem	✔	✔	✔		✔
`stav`	Stav	`select`	Možné hodnoty: `nové` `použito` `rozbaleno` `poškozeno`	✔	✔	✔
`ean`	EAN	`string 14`		✔		✔
`katalogCislo`	Katalog. číslo výrobce	`string 32`		✔		✔
`velikost`	Velikost	`string 128`		✔		✔
`filtr`	Filtr	`string 32`	Kód výrobce dle formátu pro filtrování dle motorky Nápověda pro kódy je v detailu agendy `zarazeniprislusenstvi`.	✔		✔
`cena`	Cena	`integer`	Hodnota `0` = cena dohodou (toto není dovoleno pro nové příslušenství)	✔	✔	✔
`cena@historie`	Historie cen	`href`	Odkaz na historii cen (podagenda `ceny`)
`cenaMena`	Měna	`string 8`	Prakticky nabývá těchto hodnot: `Kč` `€`	✔	✔	✔
`dph`	Odpočet DPH	`select`	Možné hodnoty: `0` Ne `1` Ano `2` Neuvedeno	✔	✔	✔
`dostupnostprislusenstvi`	Dostupnost	`integer`	Dostupnost je z agendy `dostupnostprislusenstvi`	✔	✔	✔
`poznamkaInterni`	Interní poznámka	`string 64`		✔		✔
`akce`	V akci	`select`	Možné hodnoty: `0` Ne `1` Ano	✔	✔	✔
`url`	URL u firmy	`string 255`		✔
`youtube`	Odkaz na YouTube video. Když z odkazu nejde určit ID videa, API vrátí varování a video se u inzerátu nezobrazí.	`string 1024`		✔
`vlozeniCas`	Čas vložení	`datetime`	Formát `YYYY-MM-DD HH:MM:SS`			✔
`editaceCas`	Čas poslední editace	`datetime`	Formát `YYYY-MM-DD HH:MM:SS`, může být prázdné			✔
`urlTipmoto`	URL na TipMoto.com	`string 255`
`urlTipmotoSubdomain`	URL na subdoménu	`string 255`
`popis`	Popis	`text`	Může obsahovat HTML	✔
`paramitems`	Parametry			✔	✔
`paramitem/id`	ID parametru	`integer`	Parametr je z agendy `paramitemprislusenstvi`	✔	✔
`paramitem/id@itemName paramitem/id@idParam paramitem/id@paramName`	Atributy parametru	`string 64 integer string 64`	Data jsou pouze pro snadnější export, import dle textu není u této položky podporován.
`models`	Modely		Lze uvést i model motorky (pro vybrané kategorie)	✔
`model/id`	Model motorky	`integer`	Model je z agendy `model`	✔
`model/id@manufacturer model/id@model`	Model motorky	`string 64`	Při importu lze použít i textové určení modelu Doporučujeme používat ID, ze zpětně kompatibilních důvodů možno zadat i textem	✔
`model/madeFrom`	Výroba od	`integer 4`	Od kterého roku výroby motorky je příslušenství určeno	✔
`model/madeTo`	Výroba do	`integer 4`	Je-li určeno pro jeden ročník, pak je třeba rovněž uvést, a to stejnou hodnotu jako `madeFrom`	✔
`model/dodatek`	Dodatek modelu	`string 16`		✔
`photos@ignoreimport`	Neimportovat fotky	`logical`	Používá se pouze u importu. Možné hodnoty: `true` `false`	✔
`photos@forceupdate`	Přepsat fotky	`logical`	Používá se pouze u importu. Možné hodnoty: `true` `false` Pozor: všechny fotky se stáhnou znovu a dostanou nová ID (i nové URL). Neposílejte trvale, jen když fotky opravdu potřebujete načíst znovu.	✔
`photos@reorder`	Seřadit fotky podle importu	`logical`	Používá se pouze u importu. Možné hodnoty: `true` = galerie se seřadí podle pořadí fotek v `photos` `false` = pořadím hýbou jen `main` a `sortOrder` (výchozí) Viz Pořadí a hlavní fotka.	✔
`photo@modify`	Úprava fotografií	`select`	Používá se pouze u importu. Možné hodnoty: `trim` = má-li fotka rámeček, dojde k jeho automatickému oříznutí	✔
`photo/id`	ID fotky	`integer`	Odkazuje se na agendu photo
`photo/url`	URL fotky	`string 255`		✔
`photo/main`	Hlavní fotka	`select`	Možné hodnoty: `1` nebo `true` Ano – fotka se stane hlavní a přesune se na pozici 1 `0` nebo `false` Ne – samo o sobě pořadím nehýbe V exportu vždy `0` nebo `1`. Bez `main` se při importu hlavní fotka nemění (u inzerátu bez fotek je hlavní první fotka; výjimku při smazání hlavní fotky popisuje Pořadí a hlavní fotka). Má-li `main` = `1` více fotek, platí první z nich. Neplatná hodnota se ignoruje a v odpovědi přijde `warning`, takže s `?fail-on-warning` se inzerát nezpracuje.	✔
`photo/sortOrder`	Pořadí fotky	`integer`	Pozice fotky v galerii inzerátu, `1` = hlavní fotka. V exportu je to pozice, na které fotku ukazuje web. V importu nepovinné: absolutní pozice, na kterou se fotka postaví; ostatní fotky vyplní zbylá místa. Číslo větší než počet fotek znamená konec galerie. `sortOrder` jiné než `1` spolu s `main` = `1` (nebo `1` spolu s `main` = `0`) je chyba a inzerát se nezpracuje. Neplatná hodnota (jiná než celé číslo od 1) se ignoruje a v odpovědi přijde `warning`.	✔
`photo/width`	Šířka fotky px	`integer`
`photo/height`	Výška fotky px	`integer`
`photo/stamp`	Stamp změny fotky	`char 128`	V exportu obsahuje `datetime` poslední změny V importu lze používat libovolný text.	✔
`userValue/nazevApp`	Název už. hodnoty	`string 255`	Název uživatelské hodnoty pro aplikaci.	✔
`userValue/nazevApp@id`	ID už. hodnoty	`integer`	ID uživatelské hodnoty	✔
`userValue/hodnota`	Uživ. hodnota	`text`	Hodnota	✔
`stats`	Statistiky inzerátu	`element`	Celoživotní čítače inzerátu (očištěno o roboty apod.) – tentýž blok jako v archivu. Jen v detailu `full` a `custom:stats`, ve výpisu i v detailu záznamu. Blok nevyžaduje právo `statsperm` – stačí právo, se kterým login záznam čte.
`stats@ref`	Podrobná statistika	`href`	Odkaz na podrobnou statistiku inzerátu po dnech (podagenda `stats`). Ta vyžaduje právo `statsperm`, bez něj vrátí `402`.
`stats/zobrazeni`	Počet zobrazení inzerátu	`integer`
`stats/odpovedi`	Počet odpovědí ve formuláři u inzerátu	`integer`
`stats/urlKliknuti`	Počet kliknutí na URL produktu	`integer`

rw = lze zapisovat
P = povinná položka
S = dle položky lze filtrovat a řadit
➀ = je v detailu id
➁ = je v detailu summary