@bytebrand/export-cars 1.26.46 → 1.26.48

package/src/transformers/ooyyo.transformer.ts

@@ -1,109 +1,378 @@
-import { Translator } from '@bytebrand/schema-tools';
-import { de } from '@bytebrand/i18n-dictionaries';
-import { get, toString, isEmpty, trim, join } from 'lodash';
-import * as moment from 'moment';
-import { DataSchemes } from '@bytebrand/car-schema';
-import { OoyyoXmlItem } from '../interfaces';
-import { ImboImageResponseInterface } from '@bytebrand/chunkable';
-import { ConfigService, ImagesService } from '../services';
-import { Injectable } from '@nestjs/common';
-
-@Injectable()
-export class OoyyoTransformer {
-  private translator: Translator;
-
-  constructor(private configService: ConfigService, private imageService: ImagesService) {
-    this.translator = new Translator(de);
-  }
-
-  async transform(car: DataSchemes.Car, imboImages: ImboImageResponseInterface[]): Promise<OoyyoXmlItem> {
-    const carId = toString(get(car, '_id', ''));
-    const creationDate = get(car, 'metaData.creationDate') as number;
-    const constructionYear = get(car, 'mainData.constructionYear') as number;
-    const firstRegistration = get(car, 'mainData.firstRegistration') as number;
-    const isNew = get(car, 'mainData.condition') === 'selector_condition_new';
-    let year = firstRegistration ? moment(firstRegistration * 1000).format('YYYY') : constructionYear;
-
-    if (!year && isNew) {
-      year = moment().subtract(2, 'months').format('YYYY');
-    }
-
-    return {
-      url: `https://www.${this.configService.config.domain}/search/vehicle/${carId}?source=classifieds&medium=listing&campaign=ooyyo`,
-      title: this.getTitle(car),
-      content: trim(toString(get(car, 'offer.offerDescription', ''))),
-      price: toString(get(car, 'price.currentSalesPrice', '')),
-      make: toString(get(car, 'mainData.make', '')),
-      model: toString(get(car, 'mainData.model', '')),
-      engine_size: toString(get(car, 'engineData.cubicCapacity', '')),
-      trim: toString(get(car, 'mainData.subModel', '')),
-      body_type: this.translateSelector(get(car, 'mainData.category', '')),
-      color: this.translateSelector(get(car, 'exterior.exteriorColor', '')).replace('Außenfarbe ', ''),
-      year: toString(year),
-      mileage: toString(get(car, 'mainData.mileage', '')),
-      fuel_type: this.translateSelector(get(car, 'consumption.fuel', '')),
-      transmission: this.translateSelector(get(car, 'driveSuspension.gearbox', '')),
-      euronorm: this.getEmissionClass(car),
-      power: toString(get(car, 'engineData.powerKW', '')),
-      doors: toString(get(car, 'mainData.doors', '')),
-      seats: toString(get(car, 'mainData.seats', '')),
-      gears: toString(get(car, 'driveSuspension.gears', '')),
-      pictures: await this.imageService.getImages(car, imboImages, this.configService.config.imageType, false),
-      location: {
-        city: toString(get(car, 'location.city', '')),
-        postcode: toString(get(car, 'location.zipCode', '')),
-        region: toString(get(car, 'location.countryCode', '')),
-      },
-      vin: toString(get(car, 'metaData.vin', '')),
-      is_new: this.getCondition(car),
-      date: this.formatTimestamp(creationDate),
-      time: this.formatTimestamp(creationDate, true),
-    };
-  }
-
-  private getTitle(car: DataSchemes.Car): string {
-    const year = toString(get(car, 'mainData.constructionYear', ''));
-    const make = toString(get(car, 'mainData.make', ''));
-    const model = toString(get(car, 'mainData.model', ''));
-    const subModel = toString(get(car, 'mainData.subModel', ''));
-    return trim(join([year, make, model, subModel], ' '));
-  }
-
-  private getCondition(car: DataSchemes.Car): string {
-    const conditionSelector = get(car, 'mainData.condition', '');
-    return conditionSelector === 'selector_condition_new' ? '1' : '0';
-  }
-
-  private translateSelector(selector: string): string {
-    if (isEmpty(selector) || selector === 'selector_unknown') {
-      return '';
-    }
-    return this.translator.translateVal(selector);
-  }
-
-  private getEmissionClass(car: DataSchemes.Car): string {
-    const available = {
-      selector_emissionClass_euro1: '1',
-      selector_emissionClass_euro2: '2',
-      selector_emissionClass_euro3: '3',
-      selector_emissionClass_euro4: '4',
-      selector_emissionClass_euro5: '5',
-      selector_emissionClass_euro6: '6',
-      selector_emissionClass_euro6b: '6b',
-      selector_emissionClass_euro6c: '6c',
-      selector_emissionClass_euro6d: '6d',
-      selector_emissionClass_euro6d_temp: '6d-TEMP',
-      selector_unknown: 'default',
-    };
-    const emissionClass = get(car, 'environmentEmissions.emissionClass', 'selector_unknown');
-    return get(available, emissionClass);
-  }
-
-  private formatTimestamp(timestamp: number, onlyTime = false): string {
-    if (!timestamp) {
-      return '';
-    }
-    const format = onlyTime ? 'hh:mm:ss' : 'DD/MM/YYYY';
-    return moment(timestamp * 1000).format(format);
-  }
-}
+import { Translator } from '@bytebrand/schema-tools';
+import { de } from '@bytebrand/i18n-dictionaries';
+import { get, toNumber, toString } from 'lodash';
+import { DataSchemes } from '@bytebrand/car-schema';
+import { DePostalCodesService } from '@bytebrand/car-basic-data-scope';
+import { Injectable } from '@nestjs/common';
+
+import { OoyyoXmlItem } from '../interfaces';
+import { OpenAiImageSelection } from './openai-image-fields';
+import { toUnixSeconds } from './meinstadt.transformer';
+
+/**
+ * OOYYO vehicle XML (ADV-331), against the official OoyyoFormat.xsd / OoyyoFormat.xml
+ * (test/fixtures/ooyyo, the same files OOYYO attached on 16.10.2026) and the importer rules
+ * Aleksandar Ciric confirmed on 19.10.2026:
+ * - price needs unit="EUR" exactly (the old sample's unit="euro" is rejected), integer amount;
+ * - a listing without photo, year or price, or with a make / model OOYYO cannot recognise, is rejected;
+ * - vehicle URL and every picture URL <= 1,500 characters, pictures reachable over HTTPS.
+ * The XSD itself is permissive (every element optional, units free strings), so these rules live
+ * here (validateOoyyoItem) and are applied to every item before it is written and again to the
+ * finished file before it is published. Pure functions, no I/O.
+ */
+
+// Clickout parameters (ADV-333, same scheme as AutoUncle ADV-324 / meinestadt ADV-327 / markt.de
+// ADV-330): the partner in `source`, so the reporting views, the CRM source and GA4 (utm_*) all see
+// "ooyyo". Legacy and utm pairs carry identical values (no parameterConflict). OOYYO links directly
+// to this URL without a redirect and keeps the parameters unchanged (partner, 19.10.2026). No OOYYO
+// click id exists; none is invented.
+export const OOYYO_LINK_PARAMS =
+  'source=ooyyo&medium=listing&campaign=listing&utm_source=ooyyo&utm_medium=listing&utm_campaign=listing';
+
+export const OOYYO_MAX_URL_LENGTH = 1500;
+export const OOYYO_PRICE_UNIT = 'EUR';
+export const OOYYO_TIME_ZONE = 'Europe/Berlin';
+
+export const getOoyyoListingUrl = (domain: string, carId: string): string =>
+  `https://www.${domain}/search/vehicle/${encodeURIComponent(carId)}?${OOYYO_LINK_PARAMS}`;
+
+export enum OoyyoExclusion {
+  duplicateId = 'duplicate_id',
+  filtered = 'filtered',
+  noId = 'no_id',
+  notAvailable = 'reserved_or_sold',
+  noPrice = 'no_valid_price',
+  noMake = 'no_make',
+  noModel = 'no_recognisable_model',
+  noYear = 'no_valid_year',
+  noImage = 'no_valid_image',
+  urlTooLong = 'url_too_long',
+}
+
+// Online cars flagged like this are not sellable stock; the partner gets the file without them.
+const NOT_AVAILABLE = ['selector_offerAvailability_reserved', 'selector_offerAvailability_sold'];
+
+// Placeholder make / model values OOYYO cannot match to a vehicle ("SONSTIGE" is the CBD fallback
+// model when the dealer's model could not be mapped).
+const UNRECOGNISABLE = new Set(['', 'sonstige', 'sonstiges', 'andere', 'other', 'others', 'unknown', 'unbekannt', 'selector_unknown', '-']);
+
+const text = (value: unknown): string => (typeof value === 'string' || typeof value === 'number' ? String(value).trim() : '');
+
+const isRecognisable = (value: string): boolean => !UNRECOGNISABLE.has(value.toLowerCase());
+
+const positiveNumber = (value: unknown): number | null => {
+  if (value === null || value === undefined || value === '' || typeof value === 'boolean') {
+    return null;
+  }
+  const n = toNumber(value);
+  return Number.isFinite(n) && n > 0 ? n : null;
+};
+
+/**
+ * Whole-euro consumer purchase price from price.currentSalesPrice only — never a monthly leasing /
+ * financing rate, never price.purchasePrice (dealer cost). The partner sample asks for an integer;
+ * a fractional amount is rounded to the nearest euro (DEV/PROD prices are integers). null = no price.
+ */
+export const getOoyyoPrice = (value: unknown): string | null => {
+  const amount = positiveNumber(value);
+  if (amount === null) {
+    return null;
+  }
+  const rounded = Math.round(amount);
+  return rounded > 0 ? String(rounded) : null;
+};
+
+/**
+ * Year of the car: year of the first registration, else the stored construction year (new cars
+ * often have no registration yet). Both must be real values in 1900..next year. Nothing is
+ * defaulted: the legacy exporter invented "now - 2 months" for new cars without a year — such a
+ * car is now excluded (no_valid_year), as OOYYO rejects listings without a year anyway.
+ */
+export const getOoyyoYear = (car: DataSchemes.Car, now: Date = new Date()): string => {
+  const max = now.getFullYear() + 1;
+  const seconds = toUnixSeconds(get(car, 'mainData.firstRegistration', null));
+  if (seconds !== null) {
+    const year = new Date(seconds * 1000).getUTCFullYear();
+    if (year >= 1900 && year <= max) {
+      return String(year);
+    }
+  }
+  const construction = Math.trunc(toNumber(get(car, 'mainData.constructionYear', null)));
+  return Number.isFinite(construction) && construction >= 1900 && construction <= max ? String(construction) : '';
+};
+
+/**
+ * Postcode as a STRING. CBD stores location.zipCode as a number, so German postcodes with a leading
+ * zero lose it (04103 Leipzig -> 4103; 415 of 3,094 DEV cars). For a German location a 4-digit value
+ * gets its leading zero back; anything that is still not a valid German postcode (01001..99998) is
+ * left out. Other countries: the stored value as it is.
+ */
+export const getOoyyoPostcode = (zip: unknown, countryCode: unknown): string => {
+  const raw = text(zip);
+  if (!raw) {
+    return '';
+  }
+  const country = text(countryCode).toUpperCase();
+  if (country && country !== 'DE') {
+    return raw;
+  }
+  const padded = /^\d{4}$/.test(raw) ? `0${raw}` : raw;
+  return /^\d{5}$/.test(padded) && Number(padded) >= 1001 ? padded : '';
+};
+
+const EURONORM: Record<string, string> = {
+  selector_emissionClass_euro1: '1',
+  selector_emissionClass_euro2: '2',
+  selector_emissionClass_euro3: '3',
+  selector_emissionClass_euro4: '4',
+  selector_emissionClass_euro5: '5',
+  selector_emissionClass_euro6: '6',
+  selector_emissionClass_euro6b: '6b',
+  selector_emissionClass_euro6c: '6c',
+  selector_emissionClass_euro6d: '6d',
+  selector_emissionClass_euro6d_temp: '6d-TEMP',
+};
+
+// Legacy values kept; an unknown class is left out (the legacy exporter wrote the word "default").
+export const getOoyyoEuronorm = (selector: unknown): string => EURONORM[text(selector)] ?? '';
+
+const berlinParts = (seconds: number): Record<string, string> => {
+  const parts = new Intl.DateTimeFormat('en-GB', {
+    timeZone: OOYYO_TIME_ZONE,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hourCycle: 'h23',
+  }).formatToParts(new Date(seconds * 1000));
+  return Object.fromEntries(parts.map(p => [p.type, p.value]));
+};
+
+/**
+ * Ad date / time as the partner sample asks: DD/MM/YYYY and HH:MM (24 h), German local time of the
+ * listing's creation. The legacy exporter wrote hh:mm:ss (12-hour clock, host time zone).
+ */
+export const getOoyyoDateTime = (creationDate: unknown): { date: string; time: string } => {
+  const seconds = toUnixSeconds(creationDate);
+  if (seconds === null) {
+    return { date: '', time: '' };
+  }
+  const p = berlinParts(seconds);
+  return { date: `${p.day}/${p.month}/${p.year}`, time: `${p.hour}:${p.minute}` };
+};
+
+/**
+ * German consumer description from offer.offerDescription (the dealer's listing text, the same text
+ * the vehicle page shows) as plain text: the mobile.de markup is resolved (`\\` = line break,
+ * `**bold**` markers dropped) — OOYYO shows plain text. Nothing is added or invented; an empty
+ * description stays empty (the element is then left out).
+ */
+export const getOoyyoContent = (description: unknown): string => {
+  const raw = typeof description === 'string' ? description : '';
+  if (!raw.trim()) {
+    return '';
+  }
+  return raw
+    .replace(/\\\\/g, '\n')
+    .replace(/\*\*/g, '')
+    .split('\n')
+    .map(line => line.replace(/[ \t]+$/g, ''))
+    .join('\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+};
+
+// make, model, subModel joined; missing parts are left out (same as the meinestadt title).
+export const getOoyyoTitle = (car: DataSchemes.Car): string =>
+  ['mainData.make', 'mainData.model', 'mainData.subModel']
+    .map(path => text(get(car, path, null)))
+    .filter(Boolean)
+    .join(' ');
+
+// ISO 3779: 17 characters, digits and capital letters without I, O, Q.
+const VIN_PATTERN = /^[A-HJ-NPR-Z0-9]{17}$/;
+
+// The car's own VIN when it is a well-formed 17-character VIN, otherwise empty (never invented).
+export const getOoyyoVin = (car: DataSchemes.Car): string => {
+  const vin = text(get(car, 'metaData.vin', '')).toUpperCase();
+  return VIN_PATTERN.test(vin) ? vin : '';
+};
+
+// Positive whole number as text, else '' (0 / missing doors, seats, gears, kW, ccm are left out).
+const positiveInt = (value: unknown): string => {
+  const n = positiveNumber(value);
+  return n === null ? '' : String(Math.round(n));
+};
+
+/**
+ * The OOYYO picture list from the shared validated clean selection (ADV-336, same rules as the
+ * OpenAI / meinestadt / AutoUncle / markt.de feeds): valid 3/4 hero first, then every other valid
+ * image. Real photos only — no marketing / rate overlays, no "noimage" placeholders (the legacy
+ * exporter sent 5,001 of them on DEV, which OOYYO's sample explicitly forbids). No valid hero => []
+ * (car is skipped). No partner maximum: 20 is OOYYO's ranking recommendation, all are accepted.
+ */
+export const toOoyyoImages = (selection: OpenAiImageSelection, maxImages = 0): string[] => {
+  if (!selection?.fields) {
+    return [];
+  }
+  const urls = [selection.fields.image_url, ...selection.fields.additional_image_urls];
+  return maxImages > 0 ? urls.slice(0, maxImages) : urls;
+};
+
+/** Semantic acceptance rules of the OOYYO importer (19.10.2026) for one item. null = acceptable. */
+export const validateOoyyoItem = (item: Partial<OoyyoXmlItem>): OoyyoExclusion | null => {
+  if (!item.url || !/^https:\/\//.test(item.url)) {
+    return OoyyoExclusion.noId;
+  }
+  if (item.url.length > OOYYO_MAX_URL_LENGTH) {
+    return OoyyoExclusion.urlTooLong;
+  }
+  if (!item.price || !/^[1-9]\d*$/.test(item.price) || item.priceUnit !== OOYYO_PRICE_UNIT) {
+    return OoyyoExclusion.noPrice;
+  }
+  if (!item.make || !isRecognisable(item.make)) {
+    return OoyyoExclusion.noMake;
+  }
+  if (!item.model || !isRecognisable(item.model)) {
+    return OoyyoExclusion.noModel;
+  }
+  if (!item.year || !/^(19|20)\d{2}$/.test(item.year)) {
+    return OoyyoExclusion.noYear;
+  }
+  const pictures = item.pictures ?? [];
+  if (!pictures.length || pictures.some(p => !/^https:\/\//.test(p))) {
+    return OoyyoExclusion.noImage;
+  }
+  if (pictures.some(p => p.length > OOYYO_MAX_URL_LENGTH)) {
+    return OoyyoExclusion.urlTooLong;
+  }
+  return null;
+};
+
+// Car-level checks before any image probe or postcode lookup. null = go on.
+export const getOoyyoExclusion = (car: DataSchemes.Car, now: Date = new Date()): OoyyoExclusion | null => {
+  if (!text(get(car, '_id', ''))) {
+    return OoyyoExclusion.noId;
+  }
+  if (NOT_AVAILABLE.includes(text(get(car, 'offer.offerAvailability', '')))) {
+    return OoyyoExclusion.notAvailable;
+  }
+  if (!getOoyyoPrice(get(car, 'price.currentSalesPrice', null))) {
+    return OoyyoExclusion.noPrice;
+  }
+  if (!isRecognisable(text(get(car, 'mainData.make', '')))) {
+    return OoyyoExclusion.noMake;
+  }
+  if (!isRecognisable(text(get(car, 'mainData.model', '')))) {
+    return OoyyoExclusion.noModel;
+  }
+  if (!getOoyyoYear(car, now)) {
+    return OoyyoExclusion.noYear;
+  }
+  return null;
+};
+
+export interface OoyyoMappingContext {
+  domain: string;
+  // final, validated image URLs, hero first
+  images: string[];
+  // German label of a selector; '' for unknown
+  translate: (selector: string) => string;
+  // Bundesland of a German postcode, '' when unknown
+  region: string;
+  now?: Date;
+}
+
+export type OoyyoMapResult = { ok: true; item: OoyyoXmlItem } | { ok: false; reason: OoyyoExclusion };
+
+const getMileage = (car: DataSchemes.Car): string => {
+  const raw = get(car, 'mainData.mileage', null);
+  if (raw === null || raw === undefined || raw === '') {
+    return '';
+  }
+  const km = toNumber(raw);
+  // 0 km is a real value for a new car; negative / unparsable is left out
+  return Number.isFinite(km) && km >= 0 ? String(Math.round(km)) : '';
+};
+
+const getIsNew = (car: DataSchemes.Car): string => {
+  const condition = text(get(car, 'mainData.condition', ''));
+  if (condition === 'selector_condition_new') {
+    return '1';
+  }
+  return condition === 'selector_condition_used' ? '0' : '';
+};
+
+/** One `<ad>`. Empty optional fields are left out of the XML by the builder. */
+export const mapOoyyoItem = (car: DataSchemes.Car, ctx: OoyyoMappingContext): OoyyoMapResult => {
+  const excluded = getOoyyoExclusion(car, ctx.now);
+  if (excluded) {
+    return { ok: false, reason: excluded };
+  }
+  const { date, time } = getOoyyoDateTime(get(car, 'metaData.creationDate', null));
+  const item: OoyyoXmlItem = {
+    url: getOoyyoListingUrl(ctx.domain, text(get(car, '_id', ''))),
+    title: getOoyyoTitle(car),
+    content: getOoyyoContent(get(car, 'offer.offerDescription', '')),
+    price: getOoyyoPrice(get(car, 'price.currentSalesPrice', null)),
+    priceUnit: OOYYO_PRICE_UNIT,
+    make: text(get(car, 'mainData.make', '')),
+    model: text(get(car, 'mainData.model', '')),
+    engine_size: positiveInt(get(car, 'engineData.cubicCapacity', null)),
+    trim: text(get(car, 'mainData.subModel', '')),
+    body_type: ctx.translate(text(get(car, 'mainData.category', ''))),
+    color: ctx.translate(text(get(car, 'exterior.exteriorColor', ''))).replace(/^Außenfarbe\s+/, ''),
+    year: getOoyyoYear(car, ctx.now),
+    mileage: getMileage(car),
+    fuel_type: ctx.translate(text(get(car, 'consumption.fuel', ''))),
+    transmission: ctx.translate(text(get(car, 'driveSuspension.gearbox', ''))),
+    euronorm: getOoyyoEuronorm(get(car, 'environmentEmissions.emissionClass', '')),
+    power: positiveInt(get(car, 'engineData.powerKW', null)),
+    doors: positiveInt(get(car, 'mainData.doors', null)),
+    seats: positiveInt(get(car, 'mainData.seats', null)),
+    gears: positiveInt(get(car, 'driveSuspension.gears', null)),
+    location: {
+      city: text(get(car, 'location.city', '')),
+      postcode: getOoyyoPostcode(get(car, 'location.zipCode', null), get(car, 'location.countryCode', null)),
+      region: ctx.region,
+    },
+    pictures: ctx.images,
+    vin: getOoyyoVin(car),
+    is_new: getIsNew(car),
+    date,
+    time,
+  };
+  const invalid = validateOoyyoItem(item);
+  return invalid ? { ok: false, reason: invalid } : { ok: true, item };
+};
+
+@Injectable()
+export class OoyyoTransformer {
+  private translator = new Translator(de);
+  private postalCodes = DePostalCodesService.getInstance();
+  private regions = new Map<string, Promise<string>>();
+
+  translate(selector: string): string {
+    if (!selector || selector === 'selector_unknown') {
+      return '';
+    }
+    const label = toString(this.translator.translateVal(selector) ?? '').trim();
+    // an unknown selector must not leak as "selector_…" into German consumer copy
+    return label.startsWith('selector_') ? '' : label;
+  }
+
+  /** Bundesland of a valid German postcode from the shared postal code table; '' when unknown. */
+  region(postcode: string, countryCode: unknown): Promise<string> {
+    const country = text(countryCode).toUpperCase();
+    if (!/^\d{5}$/.test(postcode) || (country && country !== 'DE')) {
+      return Promise.resolve('');
+    }
+    if (!this.regions.has(postcode)) {
+      this.regions.set(postcode, Promise.resolve(this.postalCodes.getLocationByPostalCode(Number(postcode)))
+        .then(entry => text(entry?.State))
+        .catch(() => ''));
+    }
+    return this.regions.get(postcode);
+  }
+}

package/test/fixtures/ooyyo/OoyyoFormat.xml

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ooyyo xsi:noNamespaceSchemaLocation="OoyyoFormat.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+    <ad>
+        <!-- URL of the ad on your website -->
+        <url><![CDATA[]]></url>
+        <!-- title of the ad -->
+        <title><![CDATA[]]></title>
+        <!-- description of the car -->
+        <content><![CDATA[]]></content>
+        <!-- price of the car (integer value) / set the "unit" to currency of your country -->
+        <price unit="euro"><![CDATA[]]></price>
+        <!-- make of the car -->
+        <make><![CDATA[]]></make>
+        <!-- model of the car -->
+        <model><![CDATA[]]></model>
+        <!-- engine size of the car / set the "unit" to cc (cubic centimeter) or l (litre) -->
+        <engine_size unit="l"><![CDATA[]]></engine_size>
+        <!-- trim of the car -->
+        <trim><![CDATA[]]></trim>
+        <!-- body type of the vehicle / estate, hatchback, 4x4, etc  -->
+        <body_type><![CDATA[]]></body_type>
+        <!-- colour of the car -->
+        <color><![CDATA[]]></color>
+        <!-- year of the car -->
+        <year><![CDATA[]]></year>
+        <!-- mileage / set "unit" to km (kilometers) or mi (miles) -->
+        <mileage unit="km"><![CDATA[]]></mileage>
+        <!-- fuel type (i.e. petrol, diesel, etc) -->
+        <fuel_type><![CDATA[]]></fuel_type>
+        <!-- transmission of the car (manual/automatic) -->
+        <transmission><![CDATA[]]></transmission>
+        <!-- euronorm -->
+        <euronorm><![CDATA[]]></euronorm>
+        <!-- power of the car / set the "unit" to kw (kilowatt) or hp (horsepower) -->
+        <power unit="kw"><![CDATA[]]></power>
+        <!-- number of doors -->
+        <doors><![CDATA[]]></doors>
+        <!-- number of seats in the car -->
+        <seats><![CDATA[]]></seats>
+        <!-- number of gears -->
+        <gears><![CDATA[]]></gears>
+        <!-- location of the car -->
+        <location>
+            <!-- city name -->
+            <city><![CDATA[]]></city>
+            <!-- postcode -->
+            <postcode><![CDATA[]]></postcode>
+            <!-- county/state name -->
+            <region><![CDATA[]]></region>
+        </location>
+        <!-- URLs of the pictures for this ad / please do not include corporate images with information such as "No image available" -->
+        <pictures>
+            <picture><![CDATA[]]></picture>
+            <picture><![CDATA[]]></picture>
+        </pictures>
+        <!-- vehicle identification number -->
+        <vin><![CDATA[]]></vin>
+        <!-- 0 if it is a used car, 1 if it is a new car -->
+        <is_new><![CDATA[]]></is_new>
+        <!-- date of the ad in the following format DD/MM/YYYY -->
+        <date><![CDATA[]]></date>
+        <!-- time of the ad in the following format HH:MM -->
+        <time><![CDATA[]]></time>
+    </ad>
+    <ad>
+        <!-- URL of the ad on your website -->
+        <url><![CDATA[]]></url>
+        <!-- title of the ad -->
+        <title><![CDATA[]]></title>
+        <!-- description of the car -->
+        <content><![CDATA[]]></content>
+        <!-- price of the car (integer value) / set the "unit" to currency of your country -->
+        <price unit="euro"><![CDATA[]]></price>
+        <!-- make of the car -->
+        <make><![CDATA[]]></make>
+        <!-- model of the car -->
+        <model><![CDATA[]]></model>
+        <!-- engine size of the car / set the "unit" to cc (cubic centimeter) or l (litre) -->
+        <engine_size unit="l"><![CDATA[]]></engine_size>
+        <!-- trim of the car -->
+        <trim><![CDATA[]]></trim>
+        <!-- body type of the vehicle / estate, hatchback, 4x4, etc  -->
+        <body_type><![CDATA[]]></body_type>
+        <!-- colour of the car -->
+        <color><![CDATA[]]></color>
+        <!-- year of the car -->
+        <year><![CDATA[]]></year>
+        <!-- mileage / set "unit" to km (kilometers) or mi (miles) -->
+        <mileage unit="km"><![CDATA[]]></mileage>
+        <!-- fuel type (i.e. petrol, diesel, etc) -->
+        <fuel_type><![CDATA[]]></fuel_type>
+        <!-- transmission of the car (manual/automatic) -->
+        <transmission><![CDATA[]]></transmission>
+        <!-- power of the car / set the "unit" to kw (kilowatt) or hp (horsepower) -->
+        <power unit="kw"><![CDATA[]]></power>
+        <!-- number of doors -->
+        <doors><![CDATA[]]></doors>
+        <!-- number of seats in the car -->
+        <seats><![CDATA[]]></seats>
+        <!-- number of gears -->
+        <gears><![CDATA[]]></gears>
+        <!-- location of the car -->
+        <location>
+            <!-- city name -->
+            <city><![CDATA[]]></city>
+            <!-- postcode -->
+            <postcode><![CDATA[]]></postcode>
+            <!-- county/state name -->
+            <region><![CDATA[]]></region>
+        </location>
+        <!-- URLs of the pictures for this ad / please do not include corporate images with information such as "No image available" -->
+        <pictures>
+            <picture><![CDATA[]]></picture>
+            <picture><![CDATA[]]></picture>
+        </pictures>
+        <!-- vehicle identification number -->
+        <vin><![CDATA[]]></vin>
+        <!-- 0 if it is a used car, 1 if it is a new car -->
+        <is_new><![CDATA[]]></is_new>
+        <!-- date of the ad in the following format DD/MM/YYYY -->
+        <date><![CDATA[]]></date>
+        <!-- time of the ad in the following format HH:MM -->
+        <time><![CDATA[]]></time>
+    </ad>
+</ooyyo>