XML Import inzerátů

Jak importovat

Struktura ZIP souboru

ZIP archiv musí obsahovat soubor inzerce.xml (název je povinný, bez ohledu na velikost písmen). Fotky jsou nepovinné.

muj-import.zip
├── inzerce.xml       ← povinný soubor s inzeráty (UTF-8)
├── 0001_1.jpg        ← fotka 1 inzerátu s id="0001"
├── 0001_2.jpg        ← fotka 2 inzerátu s id="0001"
└── 0002_1.jpg        ← fotka 1 inzerátu s id="0002"

Podporované formáty fotek: .jpg, .jpeg, .png, .webp.

Struktura XML souboru

Soubor inzerce.xml musí být kódován v UTF-8. Kořenový prvek je <nejbourak>, který obsahuje jeden nebo více prvků <inzerat>.

<?xml version="1.0" encoding="UTF-8" ?>
<nejbourak>

  <inzerat>
    <!-- ── Identifikace ─────────────────────────── -->
    <id>0001</id>                          <!-- POVINNÉ, jedinečný ID v rámci souboru -->

    <!-- ── Základní údaje ──────────────────────── -->
    <znacka>Škoda</znacka>                 <!-- POVINNÉ, název značky -->
    <model>OCTAVIA</model>                 <!-- POVINNÉ, název modelu -->
    <cena>250000</cena>                    <!-- cena v Kč -->

    <!-- ── Popis ────────────────────────────────── -->
    <titul>Škoda Octavia 1.6 TDI Combi</titul>
    <popis>Pěkné vozidlo v perfektním stavu.</popis>
    <lokalita>10000</lokalita>             <!-- PSČ, 5 číslic -->

    <!-- ── Parametry vozidla ────────────────────── -->
    <rok>2018</rok>                        <!-- rok výroby (RRRR) -->
    <najeto>85000</najeto>                 <!-- nájezd v km -->
    <vin>1HGBH41JXMN109186</vin>          <!-- max 17 znaků, nepovinné -->
    <objem>1.6</objem>                     <!-- objem motoru v litrech -->
    <vykon>85</vykon>                      <!-- výkon v kW -->
    <palivo>diesel</palivo>
    <prevodovka>manual</prevodovka>
    <pohon>FWD</pohon>
    <karoserie>estate</karoserie>
    <barva>seda</barva>
    <stav>used</stav>
    <vybava>01,19,68</vybava>
    <!-- kódy výbavy oddělené čárkami — viz tabulka níže -->

    <!-- ── Fotky ─────────────────────────────────── -->
    <fotky>1,2,3</fotky>
    <!-- názvy souborů: {id}_{seq}.jpg -->
    <!-- příklad: 0001_1.jpg, 0001_2.jpg, 0001_3.jpg -->

  </inzerat>

  <!-- ... další <inzerat> ... -->

</nejbourak>

Pole a parametry

Dostupné hodnoty

Fotky vozidel

Fotky se odkazují pomocí pole fotky, které obsahuje pořadová čísla oddělená čárkami. Názvy souborů ve ZIP se sestavují podle tohoto vzoru:

{id}_{seq}.jpg

Příklad:
  id          = 0001
  fotky       = 1,2,3

  → 0001_1.jpg
  → 0001_2.jpg
  → 0001_3.jpg

Pokud soubor ve ZIP chybí, fotka se jednoduše přeskočí — inzerát se přesto importuje.

Značky a modely

V polích znacka a model použijte přesný název ze systému (bez ohledu na velikost písmen). Aktuální seznam všech dostupných značek a jejich modelů najdete v referenčním XML souboru:

Časté chyby a jejich řešení