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 (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:
- obsługa plików różnicowych full_changeYYYY-MM-DDThh-mm-ss.xml dla głównego źródła informacji o towarach - pliku full.xml, zawierających informację o głównych węzłach towarów, które uległy zmianie w ciągu ostatnich 30 minut,
<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&language=eng&token=44b59f94b5a18473a5f7a57&shop=1&type=full&format=xml&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&language=eng&token=44b59f94b5a18473a5f7a57&shop=1&type=full_change2018-04-23T10-00-00&format=xml&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&language=eng&token=44b59f94b5a18473a5f7a57&shop=1&type=full_change2018-04-23T10-30-00&format=xml&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&language=eng&token=44b59f94b5a18473a5f7a57&shop=1&type=full_change2018-04-23T11-00-00&format=xml&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&language=eng&token=44b59f94b5a18473a5f7a57&shop=1&type=full_change2018-04-23T11-30-00&format=xml&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&language=eng&token=44b59f94b5a18473a5f7a57&shop=1&type=full_change2018-04-23T12-00-00&format=xml&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&language=eng&token=c28ed37e15f9ce0cefed793&shop=1&type=light&format=xml&iof_3_0"/>
<categories url="http://example.iai-shop.com/edi/export-offer.php?client=example&language=eng&token=e70352d9aebb98139980f64&shop=1&type=categories&format=xml&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&language=eng&token=66d7e210df197f54bdf9e4d&shop=1&type=sizes&format=xml&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&language=eng&token=c92abb6a1ceab3195cb5c39&shop=1&type=producers&format=xml&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&language=eng&token=995759017618853c77383e2&shop=1&type=units&format=xml&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&language=eng&token=6d052042188a0c47ba2ea15&shop=1&type=parameters&format=xml&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&language=eng&token=d03ed218361de24b1714f11&shop=1&type=stocks&format=xml&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&language=eng&token=874294aee5c450d2bbef4c2&shop=1&type=series&format=xml&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&language=eng&token=56b4b60f4f22bc15846c6e6&shop=1&type=warranties&format=xml&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&language=eng&token=56b4b60f4f22bc15846c6e6&shop=1&type=preset&format=xml&iof_3_0" hash="75e76977a7890ac172c024c6675e11c7" changed="2018-04-12 10:00:00"/>
</provider_description>
- obsługa zestawów i kolekcji wraz z ich składowymi (product/bundled oraz product/bundled/product),
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)