Документация за продуктови данни в XML, CSV, JSON формат

Този XML фийд предоставя структурирана информация за продуктите на ТЕХНОКОМЕРС. Данните са във формат RSS 2.0 с разширения на Google и са предназначени за автоматична интеграция с маркетплейси, агрегатори, продуктови каталози и рекламни системи.

1. Общ XML формат

<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Technocommerce</title>
    <link>https://www.technocommerce.bg</link>
    <description>Technocommerce Product Feed</description>

    <item>
      ... (данни за продукт)
    </item>
    ...
  </channel>
</rss>

2. Продуктов запис (<item>)

Поле	Описание	Пример
`<g:id>`	Уникален вътрешен идентификатор	123456
`<g:title>`	Име на продукта (до 150 символа)	Microwave Oven Gorenje MO4250CLB
`<g:description>`	Описание в HTML (entity-encoded)	<p>Power: 700W</p>
`<g:image_link>`	Основно изображение (пълен URL)	https://cdn.domain.com/media/product1.jpg
`<g:additional_image_link>`	Допълнителни изображения (по избор)	https://cdn.domain.com/media/img2.jpg
`<g:availability>`	Наличност: `in stock` или `out of stock`	in stock
`<g:condition>`	Състояние на продукта – винаги `new`	new
`<g:price>`	Редовна цена (без валута, с точка)	359.99
`<g:sale_price>`	Промоционална цена (само ако е активна)	299.99
`<g:original_price>`	Редовна цена, показвана при намаление	359.99
`<g:brand>`	Марка / производител	GORENJE
`<g:product_type>`	Категория или тип	Default
`<g:gtin>`	GTIN / EAN (ако е наличен)	3800123456789
`<g:catalog_number>`	Каталожен номер (SKU)	MO4250CLB

3. Изображения

Всички изображения се подават като публични URL адреси чрез CDN:

<g:image_link> – основно изображение
<g:additional_image_link> – допълнителни (по избор, без дублиране)

Пример: https://cdn.technocommerce.bg/media/catalog/product/abc.jpg

4. Цени

Цените са само числови стойности, без валутен символ
Използва се десетична точка (напр. 149.00)
sale_price и original_price се включват само ако има активна промоция

5. Примерен продукт

<item>
  <g:id>177585</g:id>
  <g:title>Microwave Oven Gorenje MO4250CLB</g:title>
  <g:description>&lt;p&gt;700W, 20L, Quartz Heater&lt;/p&gt;</g:description>
  <g:image_link>https://cdn.domain.com/product/mo4250.jpg</g:image_link>
  <g:availability>in stock</g:availability>
  <g:condition>new</g:condition>
  <g:price>359.99</g:price>
  <g:brand>GORENJE</g:brand>
  <g:product_type>Default</g:product_type>
  <g:gtin>3800123456789</g:gtin>
  <g:catalog_number>MO4250CLB</g:catalog_number>
</item>

6. Достъп до фийда

Всеки оторизиран клиент получава индивидуален URL адрес за достъп до фийда, с включен идентификатор и токен за достъп. Структурата е:

https://cdn.technocommerce.bg/feeds/{format}/technocommerce_feed_{VAT}_{TOKEN}.{format}

{format} – xml, json или csv
{VAT} – официален 9-цифрен данъчен номер на фирмата
{TOKEN} – индивидуален API ключ

Достъпът се разрешава само при:

валиден VAT и Token
валиден IP адрес или домейн (напр. вашият сайт или сървър)

Заявката се валидира и при успех се обслужва от системата.

7. Препоръки към интегратори

Декодирайте HTML ентитети при нужда (напр. </p>)
Проверявайте GTIN за допустима дължина: 8, 12, 13 или 14 цифри
Използвайте g:id или g:catalog_number като резервна стойност при липса на GTIN
Не очаквайте валута – цените са без символи
Избягвайте повтарящи се изображения

За достъп, поддръжка или нов токен, моля свържете се с екипа на Technocommerce.