api.tipmoto.com » API documentation » Agendas » Dealers list » Dealer » Parts

Agenda dily

Contains parts 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/dily-{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 dily 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 Part name string 64   ✔ ✔ ✔   ✔
branddily Brand string 64 The brand can be imported as text
This information is only supplementary
The brand comes from the agenda branddily
✔   ✔   ✔
branddily@id Brand ID integer On import, the ID takes precedence over the text ✔   ✔   ✔
zarazenidily Category integer The category comes from the agenda zarazenidily ✔ ✔ ✔   ✔
zarazenidily@moto
zarazenidily@zarazeniName
zarazenidily@parent
Category parameters integer
string 64
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
✔ ✔ ✔   ✔
zarazenidily@parentId Parent category ID integer Not output in import/export, but records can be filtered and sorted by this value     ✔    
partnumber Part number string 64 ✔   ✔    
nove New select Possible values:
  • 0 No
  • 1 Yes
✔ ✔ ✔    
cena Price integer Value 0 = price negotiable (this is not allowed for new parts) ✔ ✔ ✔    
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
✔ ✔ ✔    
dostupnostdily Availability integer The availability comes from the agenda dostupnostdily ✔ ✔ ✔    
puvoddily Origin select The origin comes from the agenda puvoddily ✔ ✔ ✔    
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 Youtube video string 255   ✔        
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 ✔        
models Models   Either the models or the pneus structure must be given ✔ ✔      
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 part 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   ✔        
pneus Tyres   Either the models or the pneus structure must be given ✔ ✔      
pneu/sada Tyre position select Not given for a single tyre
Possible values:
  • přední = front
  • zadní = rear
✔ ✔      
pneu/brandpneu Tyre brand string 32 The brand comes from the agenda brandpneu ✔ ✔      
pneu/sirka Tyre width integer Value in mm (60-350) ✔ ✔      
pneu/vyska Tyre height integer Tyre profile as a percentage of the width, i.e. the ratio of the tyre height to its width in per cent (40-100) ✔ ✔      
pneu/rafek Tyre rim integer Value in inches (7-30) ✔ ✔      
pneu/vzorek Tyre tread string 32   ✔ ✔      
pneu/vzorekJednotka Tread unit select Possible values:
  • '' - empty
  • %
  • mm
✔ ✔      
pneu/dodatek Name suffix string 32   ✔        
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

TipMoto.com Contact us