Almapro.hu termék feed API dokumentáció

Ez az API egy termékeket tartalmazó XML fájlt vár a partner webáruházától. A feedet naponta egyszer szinkronizáljuk, hajnal 3 és 6 óra közötti időszakban. A feed struktúrája és használata az alábbiakban kerül bemutatásra.

Együttműködés lépései

1. hozzon létre egy kereskedői fiókot az almapro.hu oldalon
2. készítsen el egy alábbi dokumentációnak és példának megfelelő XML fájlt a szinkronizálandó termékeiről
3. biztosítsa, hogy ha új terméket szeretne hirdetni, vagy meglévőt deaktiválni (például eladásra került), akkor a változás jelentkezzen az XML-ben
4. az XML elérését biztosítsa egy URL-en keresztül, például a honlap tárhelyére feltöltve (például: https://domain.hu/rrs/almapro-feed.xml)
5. vegye fel velünk a kapcsolatot, feltüntetve a kereskedői fiók azonosítóit, illetve az XML fájl elérésének URL-jét
6. a feed ellenőrzése után aktiváljuk a folyamatos szinkronizációt, Önnek nincs további teendője

XML Struktúra

Az alábbiakban bemutatjuk a termékek XML struktúráját:

Változók leírása

Mező	Típus	Maximális hossz	Leírás
id	Egész szám		A termék egyedi azonosítója a partner rendszerében
user_id	Egész szám		Az eladó felhasználói azonosítója
title	Szöveg		A termék teljes neve és jellemzői
category	Szöveg		A termék kategóriája (pl. Android, Apple)
type_1	Szöveg		Szülőkategória (például iPhone; iPad; Watch)
type_2	Szöveg		Alkategória (például iPhone 11; SE series; Air; Galaxy)
type_3	Szöveg		Al-alkategória (például SE 2020; S10)
brand	Szöveg		A termék márkája (pl. Samsung, Apple)
price_huf	Egész szám		A termék ára forintban
images	Szöveg (URL)		A termékhez tartozó képek linkjei
attrs	Objektum		A termék további attribútumai (pl. tárhely, szín, állapot)

XML példa

<?xml version="1.0" encoding="UTF-8"?>
<products>
    <product>
        <id>7933</id>
        <user_id>1</user_id>
        <title>Samsung Galaxy S10 128 GB Prism Green - 3 HÓ GARANCIA</title>
        <category>Android</category>
        <brand>Samsung</brand>
        <device_type></device_type>
        <type_1>Samsung</type_1>
        <type_2>Galaxy</type_2>
        <type_3>S10</type_3>
        <product_name>Samsung Galaxy S10</product_name>
        <description><![CDATA[Készülék leírása...]]></description>
        <price_huf>60000</price_huf>
        <images>
            <image_link>https://domain.hu/...</image_link>
            ...
        </images>
        <attrs>
            <hattertar>128 GB</hattertar>
            <szin>Prism Green</szin>
            ...
        </attrs>
    </product>
    ...
</products>