13 czerwca 2018

IOF 3.0 - nowa wersja formatu udostępniania oferty do integracji wspierająca pliki różnicowe oraz zestawy i kolekcje wraz z ich składowymi

Internet Offer Format Internet Offer Format (IOF) to standard wymiany informacji o towarach w formacie XML, opracowany przez IAI S.A., który stanowi autorski format opisu oferty produktów w e-handlu. Doświadczenie pozyskane od czasu IOF 2.6, który został wprowadzony we wrześniu 2016r. oraz wynikające z prac nad modułem webowego import, aktualizacja i przywracanie towarów z kopii zapasowej, Downloaderem 2, czy z partnerami tj. ABC Data pokazało nam, jak potrzebne są przyrosty, czyli dodanie logiki wyznaczania zmian w ofercie do jej generatora, któremu łatwiej sprawdzić co się zmieniło, niż skryptom ją przetwarzającym.

W wyniku czego stworzyliśmy rekomendację szóstej wersji otwartego standardu udostępniania oferty do integracji: Internet Offer Format (IOF) 3.0.


Nowości w IOF 3.0

IOF w wersji 3.0 to przede wszystkim:

<provider_description file_format="IOF" version="3.0" generated="2018-04-12 12:00:00" generated_by="IdoSell Shop">
    <meta>
        <long_name><![CDATA[My IdoSell Shop]]></long_name>
        <short_name><![CDATA[IdoSell Shop]]></short_name>
        <showcase_image url="http://iai-shop.com/gfx/iai_logo.png"/>
        <email><![CDATA[office@iai-sa.com]]></email>
        <tel><![CDATA[+442071931010]]></tel>
        <fax><![CDATA[+48914436601]]></fax>
        <www><![CDATA[hhtps://www.idosell.com]]></www>
        <address>
            <street><![CDATA[Aleja Piastów 30]]></street>
            <zipcode><![CDATA[71-064]]></zipcode>
            <city><![CDATA[Szczecin]]></city>
            <country><![CDATA[Polska]]></country>
            <province><![CDATA[Zachodniopomorskie]]></province>
        </address>
        <time>
            <offer created="2018-04-12 12:00:00"/>
            <offer expires="2018-04-19 12:00:00"/>
        </time>
    </meta>
    <full url="http://example.iai-shop.com/edi/export-offer.php?client=test&amp;language=eng&amp;token=44b59f94b5a18473a5f7a57&amp;shop=1&amp;type=full&amp;format=xml&amp;iof_3_0" hash="b8396d5dcc80a83580088e342515dc0f" changed="2018-04-12 12:00:00">
        <changes>
            <change url="http://example.iai-shop.com/edi/export-offer.php?client=test&amp;language=eng&amp;token=44b59f94b5a18473a5f7a57&amp;shop=1&amp;type=full_change2018-04-23T10-00-00&amp;format=xml&amp;iof_3_0" hash="76f66fabc375c374a2094c60792f0462" changed="2018-04-12 10:00:00" />
            <change url="http://example.iai-shop.com/edi/export-offer.php?client=test&amp;language=eng&amp;token=44b59f94b5a18473a5f7a57&amp;shop=1&amp;type=full_change2018-04-23T10-30-00&amp;format=xml&amp;iof_3_0" hash="76f66fabc375c374a2094c60792f0462" changed="2018-04-12 10:30:00" />
            <change url="http://example.iai-shop.com/edi/export-offer.php?client=test&amp;language=eng&amp;token=44b59f94b5a18473a5f7a57&amp;shop=1&amp;type=full_change2018-04-23T11-00-00&amp;format=xml&amp;iof_3_0" hash="76f66fabc375c374a2094c60792f0462" changed="2018-04-12 11:00:00" />
            <change url="http://example.iai-shop.com/edi/export-offer.php?client=test&amp;language=eng&amp;token=44b59f94b5a18473a5f7a57&amp;shop=1&amp;type=full_change2018-04-23T11-30-00&amp;format=xml&amp;iof_3_0" hash="76f66fabc375c374a2094c60792f0462" changed="2018-04-12 11:30:00" />
            <change url="http://example.iai-shop.com/edi/export-offer.php?client=test&amp;language=eng&amp;token=44b59f94b5a18473a5f7a57&amp;shop=1&amp;type=full_change2018-04-23T12-00-00&amp;format=xml&amp;iof_3_0" hash="76f66fabc375c374a2094c60792f0462" changed="2018-04-12 12:00:00" />
        </changes>
    </full>    
    <light url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=c28ed37e15f9ce0cefed793&amp;shop=1&amp;type=light&amp;format=xml&amp;iof_3_0"/>
    <categories url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=e70352d9aebb98139980f64&amp;shop=1&amp;type=categories&amp;format=xml&amp;iof_3_0" hash="0b90eec715995728ef7508a0f17525d9" changed="2018-04-12 10:00:00"/>
    <sizes url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=66d7e210df197f54bdf9e4d&amp;shop=1&amp;type=sizes&amp;format=xml&amp;iof_3_0" hash="cf13fdf0ea0697d5dfb94d390d5ca887" changed="2018-04-12 10:00:00"/>
    <producers url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=c92abb6a1ceab3195cb5c39&amp;shop=1&amp;type=producers&amp;format=xml&amp;iof_3_0" hash="2f63bbd18e8cec6e504629893946d93e" changed="2018-04-12 10:00:00"/>
    <units url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=995759017618853c77383e2&amp;shop=1&amp;type=units&amp;format=xml&amp;iof_3_0" hash="1ce286d71bb9940820bff62e48ce498b" changed="2018-04-12 10:00:00"/>
    <parameters url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=6d052042188a0c47ba2ea15&amp;shop=1&amp;type=parameters&amp;format=xml&amp;iof_3_0" hash="46808b604e8c6ac59c0e10f3b30bb863" changed="2018-04-12 10:00:00"/>
    <stocks url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=d03ed218361de24b1714f11&amp;shop=1&amp;type=stocks&amp;format=xml&amp;iof_3_0" hash="166220b84e7eeb4ec6bd18a86b2492d1" changed="2018-04-12 10:00:00"/>
    <series url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=874294aee5c450d2bbef4c2&amp;shop=1&amp;type=series&amp;format=xml&amp;iof_3_0" hash="50dd0d074dc1f063db9fb28462768e66" changed="2018-04-12 10:00:00"/>
    <warranties url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=56b4b60f4f22bc15846c6e6&amp;shop=1&amp;type=warranties&amp;format=xml&amp;iof_3_0" hash="adffba8f9c015d61d17f8c2b33dbaeca" changed="2018-04-12 10:00:00"/>
    <preset url="http://example.iai-shop.com/edi/export-offer.php?client=example&amp;language=eng&amp;token=56b4b60f4f22bc15846c6e6&amp;shop=1&amp;type=preset&amp;format=xml&amp;iof_3_0" hash="75e76977a7890ac172c024c6675e11c7" changed="2018-04-12 10:00:00"/>
</provider_description>

Ponad to wersja IOF 3.0 wprowadza:

  • obsługę przekreślonej ceny hurtowej dla towaru oraz dla jego poszczególnych rozmiarów (SWP) (product/strikethrough_wholesale_price oraz product/sizes/size/strikethrough_wholesale_price)
  • obsługę lokalizacji towarów w magazynie (product/sizes/size/stock@location_id oraz product/sizes/size/stock@location_text_id)
  • rozszerzenie parametrów o obsługę ich opcji dodatkowych distinction, group_distinction, hide, auction_template_hide (product/parameters/parameter@distinction, product/parameters/parameter@group_distinction, product/parameters/parameter@hide, product/parameters/parameter@auction_template_hide),
  • obsługę typu gwarancji i ilości przypisanych do niej miesięcy

W jaki sposób możesz wygenerować i wgrać ofertę w wersji IOF 3.0 z poziomu panelu administracyjnego IdoSell Shop (IAI-Shop.com)

Ofertę IOF w wersji 3.0 możesz wygenerować z poziomu przebudowanego modułu Udostępniania oferty do integracji, o którym więcej dowiesz się z naszego wpisu Udostępniaj oferty do integracji w standardzie IOF 3.0 i zarządzaj nimi z poziomu edycji kont swoich partnerów

Uwaga: Aktualne wersje IAI Downloader 1.X nie będą przystosowywane do pracy z tą wersją formatu, dlatego zachęcamy do śledzenia dalsze wiadomości na temat wprowadzenia IdoSell Shop Downloader 2 z obsługą IOF 3.0 którego premiera będzie miała miejsce wkrótce.

Jednocześnie zachęcamy Cię już dziś do skorzystania z alternatywnego narzędzia webowego import, aktualizacja i przywracanie towarów z kopii zapasowej którym ofertę w formacie IOF 3.0 możesz z panelem zsynchronizować.

Webowe narzędzie dedykujemy użytkownikom zaawansowanym, developerom i partnerom. Jeżeli jesteś początkującym użytkownikiem rekomendujemy skorzystanie z naszych profesjonalnych usług, dzięki którym uzyskasz gwarancje, że cały proces przebiegnie bezproblemowo a końcowy efekt spełni Twoje oczekiwania.

Najnowsza specyfikacja formatu została umieszczona na naszej stronie firmowej i znajdziesz ją w Dział dla developerów - Internet Offer Format (IOF 3.0). W chwili obecnej format IOF 3.0 generowany jest obok IOF 2.6 i IOF 2.5.

Zgodnie z polityką kompatybilności wstecznej, przez co najmniej 2 najbliższe lata gwarantujemy Ci wsparcie dotychczasowej wersji 2.6. Prosimy jednak abyś wszystkie nowe projekty i istotne aktualizacje dotychczasowych, opierał o wersję 3.0.

Jednocześnie informujemy, że to nie koniec zmian związanych z IOF 3.0. W najbliższym czasie prowadzone będą prace mające na celu stworzenia jednego wspólnego źródła danych w nowej wersji formatu dla porównywarek cen, pasaży handlowych, marketpalce'ów czy ofert udostępnianych do integracji oraz kopii zapasowych towarów. Docelowo IOF 3.0 stanie się domyślnym formatem wykorzystywanym w całym panelu administracyjnym IdoSell Shop (IAI-Shop.com)