Partner Tele.com · centrum integracji

Pliki integracyjne

Aktualna oferta produktowa Partner Tele.com może być udostępniana zarejestrowanym klientom jako cyklicznie generowany plik XML lub CSV.

Sprawdź dostępne formaty

02

Szybki wybór

Który format wybrać?

Najważniejsze jest to, czy integracja już działa oraz jak szerokiego zakresu danych potrzebuje.

Istniejąca integracja

Legacy XML / CSV

Zachowaj dotychczasowe identyfikatory i strukturę danych.

Częste aktualizacje

XML / CSV Light

Pobieraj cenę i dostępność w krótszych interwałach.

Nowa pełna integracja

XML Fat

Otrzymaj pełne dane katalogowe wraz z kompatybilnością.

Uwaga na identyfikatory produktów

Formaty Light i Fat używają innych ID niż pliki Legacy. Nie należy podmieniać formatu w działającej integracji bez odpowiedniego mapowania produktów.

03

Zestawienie

Porównanie formatów

Zakres danych i rytm aktualizacji w jednym miejscu.

FormatZakresIdentyfikatoryAktualizacjaNajlepsze zastosowanie
Legacy XMLPełne dane katalogoweDotychczasowe ID1 lub 2 razy dziennieDziałające integracje XML wdrożone do 2024 r., m.in. Baselinker, RedCart i Sky-Shop
Legacy CSVPełne dane katalogoweDotychczasowe ID1 lub 2 razy dziennieIndywidualne integracje CSV wdrożone do 2024 r.
XML LightCena, dostępność, EANNowe IDCzęściej, po uzgodnieniuCzęsta aktualizacja ceny i stanu w integracji XML
XML FatPełne dane + kompatybilnośćNowe ID1 lub 2 razy dziennieNowe, samodzielnie wdrażane integracje wymagające pełnego katalogu
CSV LightCena, dostępność, EANNowe IDCzęściej, po uzgodnieniuCzęsta aktualizacja ceny i stanu w prostym pliku CSV

Pliki Legacy i Fat są aktualizowane raz lub dwa razy na dobę (co 1440 lub 720 minut). Dla plików Light możliwe są krótsze interwały, ustalane indywidualnie z opiekunem handlowym.

Zakres danych

Co może zawierać plik?

Dostępność poszczególnych pól zależy od wybranego formatu. Prezentowany stan magazynowy ma limit informacyjny 200 sztuk.

04

Dokumentacja techniczna

Struktury plików

Rozwiń wybrany format, aby zobaczyć opis i przykładową strukturę.

Legacy XMLPełne dane katalogowePokaż

Zachowuje dotychczasową strukturę i identyfikatory produktów, dlatego pozwala utrzymać zgodność istniejących wdrożeń.

<produkty>
  <produkt id="35402">
    <nazwy>
      <nazwa jezyk="it"><![CDATA[Futerał CHARMING 2]]></nazwa>
    </nazwy>
    <kategoria_tree>KALAID-CHARII</kategoria_tree>
    <zdjecia>...</zdjecia>
    <cena>
      <cena_netto waluta="EUR" wartosc="2.96" />
    </cena>
    <dostepnosc>1</dostepnosc>
    <producent><![CDATA[OEM]]></producent>
    <producent_gpsr>...</producent_gpsr>
    <podmiot_odpowiedzialny_gpsr>...</podmiot_odpowiedzialny_gpsr>
  </produkt>
</produkty>
Legacy CSVPełne dane katalogowePokaż

Format zgodnościowy dla klientów korzystających z wcześniej wdrożonych rozwiązań opartych na CSV. Separatorem pól jest znak ^.

product_id^product name^product description^multilevel category^category_code^image code^net_price^accessibility^ean^producer^nett srp price^producer gpsr^responsible entity gpsr
XML LightCena, dostępność, EANPokaż

Lekki plik przeznaczony do częstego pobierania. Zawiera tylko podstawowe dane potrzebne do aktualizacji oferty.

<produkty>
  <produkt id="235810">
    <ean><![CDATA[5903396077494]]></ean>
    <cena>
      <cena_netto waluta="PLN" wartosc="23.36" />
    </cena>
    <dostepnosc>30</dostepnosc>
  </produkt>
</produkty>
XML FatPełne dane + kompatybilnośćPokaż

Najbardziej rozbudowany format. Zawiera dane katalogowe oraz relacje marka–model. Nie jest zamiennikiem Legacy w działającej integracji.

<produkty>
  <produkt id="270434">
    <nazwy>...</nazwy>
    <opisy>...</opisy>
    <zdjecia>...</zdjecia>
    <cena>...</cena>
    <ean><![CDATA[5901737919854]]></ean>
    <dostepnosc>200</dostepnosc>
    <marka_model>
      <model marka="Apple" model="iPhone SE 2022" />
      <model marka="Apple" model="iPhone 8" />
    </marka_model>
    <producent_gpsr>...</producent_gpsr>
  </produkt>
</produkty>
CSV LightCena, dostępność, EANPokaż

Minimalny plik do szybkich aktualizacji. Separatorem pól jest znak ^.

product_id^ean^net_price^accessibility

GPSR

Dane producentów i podmiotów odpowiedzialnych

Pobierz aktualną tabelę z informacjami wymaganymi przez rozporządzenie GPSR.

Pobierz tabelę GPSR (.xlsx)