Agenda prislusenstvi

Contains accessories ads

Sub-agendas overview

Name	Machine name	WRITE
Photos	photo	YES
Price history	ceny	NO
Statistics	stats	NO

Agenda features

Name	Options
Supported methods	GET, PUT/POST, DELETE
Support for detail levels	✔
Support for filtering	✔
Support for full-text search	✔
Support for pagination	✔
Support for sorting	✔
Support for external identifiers	✔
Support for schemas	https://api.tipmoto.com/schemas/prislusenstvi-{export|import}{-enum}.{xsd|rng}
Support for ?fail-on-warning	✔
Support for dry-run	✔
Returns location	✔

Agenda elements

Machine name	Name	Type	Information	rw	P	S	➀	➁
id	Ad ID in the agenda prislusenstvi	integer				✔	✔	✔
idApi	external ad ID	string 64		✔		✔	✔	✔
aktivni	active	select	Possible values: 0 No 1 Yes 2 Dealer's website	✔	✔	✔	✔	✔
lastModified	Last modified	datetime	Format YYYY-MM-DD HH:MM:SS	✔	✔	✔	✔	✔
pobocka	Branch	string 128	Shown and processed only if the dealer has more than one branch	✔				✔
pobocka@id	Branch ID	integer	Shown and processed only if the dealer has more than one branch	✔	✔	✔		✔
kontakt	Contact	element	Contact of the ad – phones, e-mail and website shown with the ad instead of the branch details (the address, seller name and opening hours remain those of the branch). The dealer's contacts are in the agenda kontakt. Shown only for dealers with at least one contact, then with every ad (including id="0"). The ref attribute links to the contact; it is missing for id="0".					✔
kontakt@id	Contact ID	integer	0 = default contact of the branch, otherwise the ID of a contact of the same dealer. A contact the dealer does not have (e.g. a deleted one) is output as 0. Writing <kontakt id="N"/>: without the element or with an empty id the contact is not changed, a new ad gets 0. A non-numeric ID returns the error “Invalid contact ID '…'”, a non-existent contact or a contact of another dealer returns the error “Dealer '…' has no contact id '…'”.	✔		✔		✔
nazev	Accessory name	string 64		✔	✔	✔		✔
brandprislusenstvi	Brand	string 64	If brandprislusenstvi@id = 1 (other), the brand can be any text. Otherwise the value comes from the agenda brandprislusenstvi	✔		✔		✔
brandprislusenstvi@id	Brand ID	integer	On import, the ID takes precedence over the text	✔		✔		✔
zarazeniprislusenstvi	Category	integer	The category comes from the agenda zarazeniprislusenstvi	✔	✔	✔		✔
zarazeniprislusenstvi@zarazeniName	Category parameters	string 64	On import, the category can also be specified as text We recommend using the ID; for backward compatibility it can also be given as text	✔	✔	✔		✔
stav	Condition	select	Possible values: nové = new použito = used rozbaleno = unpacked poškozeno = damaged	✔	✔	✔
ean	EAN	string 14		✔		✔
katalogCislo	Manufacturer's catalogue no.	string 32		✔		✔
velikost	Size	string 128		✔		✔
filtr	Filter	string 32	Manufacturer code in the format used for filtering by motorcycle Help for the codes is in the detail of the agenda zarazeniprislusenstvi.	✔		✔
cena	Price	integer	Value 0 = price negotiable (this is not allowed for new accessories)	✔	✔	✔
cena@historie	Price history	href	Link to the price history (sub-agenda ceny)
cenaMena	Currency	string 8	In practice it takes these values: Kč €	✔	✔	✔
dph	VAT deductible	select	Possible values: 0 No 1 Yes 2 Not set	✔	✔	✔
dostupnostprislusenstvi	Availability	integer	The availability comes from the agenda dostupnostprislusenstvi	✔	✔	✔
poznamkaInterni	Internal note	string 64		✔		✔
akce	Special offer	select	Possible values: 0 No 1 Yes	✔	✔	✔
url	URL on the dealer's website	string 255		✔
youtube	Link to a YouTube video. If the video ID cannot be determined from the link, the API returns a warning and the video is not shown with the ad.	string 1024		✔
vlozeniCas	Insertion time	datetime	Format YYYY-MM-DD HH:MM:SS			✔
editaceCas	Time of the last update	datetime	Format YYYY-MM-DD HH:MM:SS, may be empty			✔
urlTipmoto	URL on TipMoto.com	string 255
urlTipmotoSubdomain	URL on the subdomain	string 255
popis	Description	text	May contain HTML	✔
paramitems	Parameters			✔	✔
paramitem/id	Parameter ID	integer	The parameter comes from the agenda paramitemprislusenstvi	✔	✔
paramitem/id@itemName paramitem/id@idParam paramitem/id@paramName	Parameter attributes	string 64 integer string 64	The data are only for easier export; import by text is not supported for this element.
models	Models		A motorcycle model can also be given (for selected categories)	✔
model/id	Motorcycle model	integer	The model comes from the agenda model	✔
model/id@manufacturer model/id@model	Motorcycle model	string 64	On import, the model can also be specified as text We recommend using the ID; for backward compatibility it can also be given as text	✔
model/madeFrom	Production from	integer 4	The year of manufacture of motorcycles from which the accessory is intended	✔
model/madeTo	Production to	integer 4	If intended for a single model year, it must also be given, with the same value as madeFrom	✔
model/dodatek	Model suffix	string 16		✔
photos@ignoreimport	Do not import photos	logical	Used only for import. Possible values: true false	✔
photos@forceupdate	Overwrite photos	logical	Used only for import. Possible values: true false Note: all photos are downloaded again and get new IDs (and new URLs). Do not send it permanently, only when you really need to load the photos again.	✔
photos@reorder	Sort photos by the import	logical	Used only for import. Possible values: true = the gallery is sorted by the order of the photos in photos false = only main and sortOrder change the order (default) See Order and main photo.	✔
photo@modify	Photo modification	select	Used only for import. Possible values: trim = if the photo has a border, it is cropped automatically	✔
photo/id	Photo ID	integer	Refers to the agenda photo
photo/url	Photo URL	string 255		✔
photo/main	Main photo	select	Possible values: 1 or true Yes – the photo becomes the main photo and moves to position 1 0 or false No – on its own it does not change the order On export always 0 or 1. Without main, the import does not change the main photo (for an ad without photos, the first photo is the main one; the exception when the main photo is deleted is described in Order and main photo). If several photos have main = 1, the first of them applies. An invalid value is ignored and the response contains a warning, so with ?fail-on-warning the ad is not processed.	✔
photo/sortOrder	Photo order	integer	Position of the photo in the ad gallery, 1 = main photo. On export, it is the position at which the website shows the photo. On import optional: the absolute position at which the photo is placed; the other photos fill the remaining positions. A number greater than the number of photos means the end of the gallery. sortOrder other than 1 together with main = 1 (or 1 together with main = 0) is an error and the ad is not processed. An invalid value (other than a whole number from 1) is ignored and the response contains a warning.	✔
photo/width	Photo width px	integer
photo/height	Photo height px	integer
photo/stamp	Photo change stamp	char 128	In export it contains the datetime of the last change In import any text can be used.	✔
userValue/nazevApp	User value name	string 255	Name of the user value for the application.	✔
userValue/nazevApp@id	User value ID	integer	User value ID	✔
userValue/hodnota	User value	text	Value	✔
stats	Ad statistics	element	Lifetime counters of the ad (cleaned of bots etc.) – the same block as in the archive. Only in detail levels full and custom:stats, in the record list and in the record detail. The block does not require the statsperm permission – the permission with which the login reads the record is enough.
stats@ref	Detailed statistics	href	Link to the detailed statistics of the ad by day (sub-agenda stats). They require the statsperm permission and return 402 without it.
stats/zobrazeni	Number of ad views	integer
stats/odpovedi	Number of replies via the ad's form	integer
stats/urlKliknuti	Number of clicks on the product URL	integer

rw = writable
P = required element
S = the element can be used for filtering and sorting
➀ = included in detail level id
➁ = included in detail level summary