Struktura i jej opis

Oprócz pliku full.xml obejmującego wszystkie oferowane towary format pozwala również na generowanie plików różnicowych full_changeYYYY-MM-DDThh-mm-ss.xml zawierających informacje o głównych węzłach towarów, które uległy ostatnio zmianie. Ilość takich plików w ofercie jest nieograniczona, a ich struktura XML jest bliźniaczą strukturą XML pliku full.xml.

YYYY-MM-DDThh-mm-ss odpowiada dacie i godzinie ostatniej zmiany w standardzie ISO 8601.

Różnicowanie odbywa się na poziomie głównego węzła towaru <product>, w którym nastąpiła dana zmiana. Przykładowo, jeśli zmianie ulegnie jeden z parametrów towaru (do towaru zostanie np. dodany nowy parametr) to w pliku full_changel.xml umieszczony zostanie cały węzeł <product> zawierający zarówno niezmienione atrybuty i inne węzły tego towaru jak i węzeł <parametrs>, w którym nowy parametr został dodany.

Changelog:

IOF 3.0

• rozszerzyliśmy ofertę o możliwość generowania dodatkowych opcjonalnych plików full_change.xml stanowiących stan różnicowy dla pliku full.xml zwracających informacji o towarach, które zmieniły się w ciągu ostatnich 30 minut.

Przykładowa struktura pliku XML:

<?xml version="1.0" encoding="utf-8"?>
<offer xmlns:iof="http://www.idosell.com/developers/iof.phtml" xmlns:iaiext="http://www.idosell.com/developers/iof/extensions.phtml" file_format="IOF" generated="2022-02-14 00:24:18" expires="2022-02-15 00:24:18" version="3.0" extensions="yes">
  <products xmlns:iaiext="http://www.idosell.com/developers/iof/extensions.phtml" currency="PLN" iof_translation_generated="yes" language="pol">
      <product id="33" currency="PLN" code_on_card="34567-11000" producer_code_standard="GTIN13" type="regular" vat="23.0" site="1">
          <producer id="1642669997" name="Lewis"/>
          <category id="1214553882" name="Kategoria testowa 1/Podkategoria 3"/>
          <category_idosell id="55" path="Aparaty, kamery i przyrządy optyczne > Akcesoria do aparatów, kamer i przyrządów optycznych > Zapasowe kable do aparatów, kamer i przyrządów optycznych"/>
          <unit id="3" name="opakowanie"/>
          <series id="5" name="Kolekcja wiosenna"/>
          <warranty id="2" type="producer" period="24" name="Gwarancja producenta na 2 lata"/>
          <card url="https://iof.shop.pl/pl/products/przykladowy-towar-33-33.html"/>
          <description>
            <name xml:lang="eng"><![CDATA[Sample product 33]]></name>
            <name xml:lang="pol"><![CDATA[Przykładowy towar 33]]></name>
            <version name="niebieski \ GHK 1999 \ bawełna">
              <name xml:lang="eng"><![CDATA[blue \ GHK 1999 \ cotton]]></name>
              <name xml:lang="pol"><![CDATA[niebieski \ GHK 1999 \ bawełna]]></name>
            </version>
            <iaiext:search_keywords xml:lang="eng" iaiext:site_id="1">Przykładowe meta słowa produktu 33 w języku angielskim</iaiext:search_keywords>
            <iaiext:search_keywords xml:lang="pol" iaiext:site_id="1">Przykładowe meta słowa produktu 33 w języku polskim</iaiext:search_keywords>
            <long_desc xml:lang="eng"><![CDATA[Long description of sample product 33]]></long_desc>
            <long_desc xml:lang="pol"><![CDATA[Opis długi przykładowego towaru 33]]></long_desc>
            <short_desc xml:lang="eng"><![CDATA[Short description of sample product 33]]></short_desc>
            <short_desc xml:lang="pol"><![CDATA[Opis krótki przykładowego towaru 33]]></short_desc>
          </description>
          <price gross="1563.6" net="1271.22"/>
          <srp gross="0" net="0"/>
          <sizes iaiext:group_name="Ubrania" iaiext:group_id="1" iaiext:sizeList="full">
            <size id="1" name="XXS" panel_name="xxs" code="33-1" weight="1353" iaiext:weight_net="1100" code_producer="0000034567111" iaiext:code_external="34567-11" iaiext:priority="0">
              <price gross="1575.6" net="1280.98"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
              <stock id="0" quantity="9" available_stock_quantity="9" stock_quantity="9.000"/>
              <stock id="1" quantity="-1" available_stock_quantity="-1" stock_quantity="-1" location_id="1" location_text_id="strefa A"/>
            </size>
            <size id="2" name="XS" panel_name="xs" code="33-2" weight="1353" iaiext:weight_net="1100" code_producer="0000034567227" iaiext:code_external="34567-22" iaiext:priority="1">
              <price gross="1587.6" net="1290.73"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
              <stock id="0" quantity="10" available_stock_quantity="10" stock_quantity="10.000"/>
              <stock id="1" quantity="-1" available_stock_quantity="-1" stock_quantity="-1"/>
            </size>
            <size id="3" name="S" panel_name="s" code="33-3" weight="1353" iaiext:weight_net="1100" code_producer="0000034567333" iaiext:code_external="34567-33" iaiext:priority="2">
              <price gross="1599.6" net="1300.49"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
              <stock id="0" quantity="10" available_stock_quantity="10" stock_quantity="10.000"/>
              <stock id="1" quantity="-1" available_stock_quantity="-1" stock_quantity="-1"/>
            </size>
            <size id="4" name="M" panel_name="m" code="33-4" weight="1353" iaiext:weight_net="1100" code_producer="0000034567449" iaiext:code_external="34567-44" iaiext:priority="3">
              <price gross="1611.6" net="1310.24"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
              <stock id="0" quantity="10" available_stock_quantity="10" stock_quantity="10.000"/>
              <stock id="1" quantity="-1" available_stock_quantity="-1" stock_quantity="-1"/>
            </size>
            <size id="5" name="L" panel_name="l" code="33-5" weight="1353" iaiext:weight_net="1100" code_producer="0000034567555" iaiext:code_external="34567-55" iaiext:priority="4">
              <price gross="1623.6" net="1320"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
            </size>
            <size id="6" name="XL" panel_name="xl" code="33-6" weight="1353" iaiext:weight_net="1100" code_producer="0000034567661" iaiext:code_external="34567-66" iaiext:priority="5">
              <price gross="1635.6" net="1329.76"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
              <stock id="0" quantity="10" available_stock_quantity="10" stock_quantity="10.000"/>
              <stock id="1" quantity="-1" available_stock_quantity="-1" stock_quantity="-1"/>
            </size>
            <size id="7" name="XXL" panel_name="xxl" code="33-7" weight="1353" iaiext:weight_net="1100" code_producer="0000034567777" iaiext:code_external="34567-77" iaiext:priority="6">
              <price gross="1647.6" net="1339.51"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
              <stock id="0" quantity="10" available_stock_quantity="10" stock_quantity="10.000"/>
              <stock id="1" quantity="-1" available_stock_quantity="-1" stock_quantity="-1"/>
            </size>
            <size id="9" name="XXXXL" panel_name="xxxxl" code="33-9" weight="1353" iaiext:weight_net="1100" code_producer="0000034567999" iaiext:code_external="34567-99" iaiext:priority="8">
              <price gross="1671.6" net="1359.02"/>
              <srp gross="19211.88" net="15619.41"/>
              <strikethrough_retail_price gross="14401.32" net="11708.39"/>
              <strikethrough_wholesale_price gross="14401.32" net="11708.39"/>
              <stock id="1" quantity="-1" available_stock_quantity="-1" stock_quantity="-1"/>
            </size>
          </sizes>
          <images>
            <large>
              <image iaiext:priority="1" url="https://iof.shop.pl/data/gfx/pictures/large/3/3/33_1.jpg" hash="5cc2f0c172881899a70e1a3a0086c78f" changed="2022-01-20 20:50:23" width="4000" height="2667"/>
              <image iaiext:priority="2" url="https://iof.shop.pl/data/gfx/pictures/large/3/3/33_2.jpg" hash="4c255061ccde0f7c04d21e79dc288874" changed="2022-01-20 20:50:26" width="4000" height="2667"/>
              <image iaiext:priority="3" url="https://iof.shop.pl/data/gfx/pictures/large/3/3/33_3.jpg" hash="4bc5c0537484c4d9eed4204f8f86da73" changed="2022-01-20 20:50:28" width="4000" height="2667"/>
              <image iaiext:priority="4" url="https://iof.shop.pl/data/gfx/pictures/large/3/3/33_4.jpg" hash="c00577745493bfe882fa69b6504cb6f8" changed="2022-01-20 20:50:30" width="4000" height="2667"/>
              <image iaiext:priority="5" url="https://iof.shop.pl/data/gfx/pictures/large/3/3/33_5.jpg" hash="3822b5bdf3f2271a84479153a016b787" changed="2022-01-20 20:50:33" width="4000" height="2667"/>
              <image iaiext:priority="6" url="https://iof.shop.pl/data/gfx/pictures/large/3/3/33_6.jpg" hash="f068d3d70a63e2f492b4f5302d2ba416" changed="2022-01-20 20:50:36" width="4000" height="2667"/>
            </large>
            <icons>
              <icon url="https://iof.shop.pl/data/gfx/icons/large/3/3/33.jpg" hash="f7596f21c6e285ee2f3baea7ae382a2b" changed="2022-01-20 20:55:45" width="350" height="233"/>
              <auction_icon url="https://iof.shop.pl/data/gfx/icons/auctions/3/3/33.jpg" changed="2022-01-20 20:53:38" hash="f7596f21c6e285ee2f3baea7ae382a2b" width="4000" height="2667"/>
              <group_icon url="https://iof.shop.pl/data/gfx/icons/versions/3/3/33.jpg" hash="f7596f21c6e285ee2f3baea7ae382a2b" changed="2022-01-20 20:55:45" width="200" height="134"/>
            </icons>
          </images>
          <attachments>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=5_33_pol_1c8427528679c1ce00973c3477b708ef" priority="1" attachment_file_type="image" attachment_file_extension="jpg" enable="all" download_log="y">
              <name xml:lang="pol"><![CDATA[Załącznik nr 1 / dla wszystkich]]></name>
            </file>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=8_33_pol_8bec64d5bccfeb6dbbf0997af4a8c506" priority="2" attachment_file_type="audio" attachment_file_extension="mp3" enable="only_logged" download_log="y">
              <name xml:lang="pol"><![CDATA[Załącznik nr 2 / dla zalogowanych]]></name>
            </file>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=9_33_pol_ace216ed7a726d49c388aacf7019fb1d" priority="3" attachment_file_type="video" attachment_file_extension="webm" enable="ordered" download_log="n">
              <name xml:lang="pol"><![CDATA[Załącznik nr 3 / dla nabywców]]></name>
            </file>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=10_33_pol_ad2407e1971c06449d8f2bf5d0f4211a" priority="4" attachment_file_type="doc" attachment_file_extension="pdf" enable="wholesaler" download_log="n">
              <name xml:lang="pol"><![CDATA[Załącznik nr 4 / dla hurtowników]]></name>
            </file>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=11_33_pol_956fb247126cc5f7dcf7eb8e62324836" priority="5" attachment_file_type="other" attachment_file_extension="zip" enable="wholesaler_or_orderer" download_log="y">
              <name xml:lang="pol"><![CDATA[Załącznik nr 5 / dla hurtowników lub nabywców]]></name>
            </file>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=31_33_pol_60a6bafb2d8e72890163a4e9d72308c3" priority="6" attachment_file_type="other" attachment_file_extension="png" enable="wholesaler_and_ordered" download_log="n">
              <name xml:lang="pol"><![CDATA[Załącznik nr 6 / dla hurtowników i nabywców]]></name>
            </file>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=12_33_eng_27efca6ef3d102860b3a2cfad07216dc" priority="1" attachment_file_type="image" attachment_file_extension="jpg" enable="all" download_log="y">
              <name xml:lang="eng"><![CDATA[Attachment no. 1 / for everyone]]></name>
            </file>
            <file version="full" url="https://iof.shop.pl/settings.php?getAttachmentp=13_33_eng_c3c58e52c0b2d743a82da1e4897420dc" priority="2" attachment_file_type="image" attachment_file_extension="jpg" enable="all" download_log="y">
              <name xml:lang="eng"><![CDATA[Attachment No. 2 / for wholesalers and buyers]]></name>
            </file>
          </attachments>
          <group id="35" first_product_id="35" iaiext:first_product_code_external="35-101-35-101" iaiext:first_product_code_producer="00000000351010" iaiext:first_product_code_iai="33-1">
            <group_by_parameter id="efac1b1fe38afd9a307b32a0c9f93ba1">
              <name xml:lang="pol"><![CDATA[Kolor \ Model \ Materiał]]></name>
              <product_value id="b9e49e5669dae27d358d09a1957edd9b">
                <name xml:lang="pol"><![CDATA[niebieski \ GHK 1999 \ bawełna]]></name>
              </product_value>
            </group_by_parameter>
          </group>
          <parameters>
            <parameter type="section" id="117" priority="1" distinction="n" group_distinction="n" hide="n" auction_template_hide="n" name="Sekcja parametrów 1 "/>
            <parameter type="parameter" id="425" priority="5" distinction="n" group_distinction="n" hide="n" auction_template_hide="n" name="Rozmiar">
              <value id="430" priority="0" name="XL"/>
            </parameter>
            <parameter type="parameter" id="128" priority="11" distinction="n" group_distinction="y" hide="n" auction_template_hide="n" context_id="CONTEXT_COLOR" name="Kolor">
              <value id="355" priority="0" name="niebieski"/>
            </parameter>
            <parameter type="parameter" id="152" priority="28" distinction="n" group_distinction="y" hide="y" auction_template_hide="n" context_id="CONTEXT_MODEL" name="Model">
              <value id="333" priority="0" name="GHK 1999"/>
            </parameter>
            <parameter type="section" id="228" priority="37" distinction="n" group_distinction="n" hide="n" auction_template_hide="n" name="Sekcja parametrów 2"/>
            <parameter type="parameter" id="238" priority="68" distinction="n" group_distinction="y" hide="y" auction_template_hide="n" name="Materiał">
              <value id="239" priority="0" name="bawełna"/>
            </parameter>
          </parameters>
        </product>
    </products>
</offer>

Zależności między danymi:

• product.category@id jest ściśle powiązany z categories.category@id w pliku categories.xml,
• product.producer@id jest ściśle powiązany z producers.producer@id w pliku producers.xml,
• product.unit@id jest ściśle powiązany z units.unit@id w pliku units.xml,
• product.series@id jest ściśle powiązany z series.series@id w pliku series.xml,
• product.warranty@id jest ściśle powiązany z warranties.warranty@id w pliku warranties.xml,
• product.sizes.size@id jest ściśle powiązany z sizes.group.size@id w pliku sizes.xml,
• product.sizes.size.stock@id jest ściśle powiązany z stocks.stock@id w pliku stocks.xml,
• product.parameters.parameter@id jest ściśle powiązany z parameters.parameter@id w pliku parameters.xml,
• product.parameters.parameter@id z atrybutem @type = "parameter" jest ściśle powiązany z parameters.parameter@id w pliku parameters.xml,
• product.parameters.parameter.@id z atrybutem @type = "section" jest ściśle powiązany z parameters.sections.section@id w pliku parameters.xml,
• product.parameters.parameter.value@id jest ściśle powiązany z parameters.values.value@id w pliku parameters.xml.

Pliki do pobrania

• Pobierz przykład pliku XML full_change2022-02-16T10-33-11
• Pobierz walidator schematu XSD full_change