Dane

Wprowadzenie

Terma oferuje pakiet narzędzi do integracji własnych systemów i aplikacji. Dzieki nim, mozesz:

  • automatycznie pobrać i aktualizować bazę produktową, tworzyć karty produktów i ich warianty,
  • automatycznie aktualizować stany magazynowe, wyświetlając informację, że produkt dostępny jest od ręki,
  • automatycznie aktualizować ceny na podstawie zmian w warunkach handlowych (dynamiczne ceny producenta),
  • zamawiać produkty wprost ze swojego oprogramowania,
  • automatycznie tworzyć zamówienie na produkty, po założeniu zamówienia przez Klienta
  • automatycznie tworzyć filtry wyszukiwań produktów
  • stworzyć cennik lub ofertę dla Klienta

Są to najczęstsze zastosowania, nie mniej jednak zachęcamy do kreowania własnych indywidualnych rozwiązań i aplikacji.
Jako uzupełnienie posiadamy:

Powyższe narzędzia są do prostej implementacji na własnych stronach www, aplikacjach lub systemach ERP.

Dane niestandaryzowane

Zrzuty statyczne

Przygotowane mamy uniwersalne zrzuty danych w formatach CSV, XML oraz JSON. Niektóre zrzuty dostępne są dla wszystkich (dane produktowe, stany magazynowe), a niektóre wymagają autoryzacji (ceny). Dane są ogólnodostępne dla wszystkich, można pobrać i przeglądać pod linkiem:

  1. Dla połączeń szyfrowanych https://data.terma24.pl
  2. Dla połączeń nie szyfrowanych http://data.terma24.pl

Zrzuty danych dokonywane są na bieżąco. Nie polecamy korzystania z połączeń nieszyfrowanych w przypadku danych, które wymagają autoryzacji, gdyż istnieje możliwość podglądu informacji przez osoby nieautoryzowane. Do korzystania z połączenia szyfrowanego wymagane jest posiadanie i poprawne skonfigurowanie certyfikatów SSL na hostach, z których odbywać się będzie połączenie.

Budowanie endpointów:

data.terma24.pl/{format_pliku}/{plik_danych}.{format_pliku}

format_pliku:

  1. CSV  - rozdzielony średnikiem, kodowanie UTF-8 (z BOM), zawiera nagłówki
  2. XML  - kodowanie UTF-8 (z BOM)
  3. JSON- kodowanie UTF-8 (z BOM)

plik_danych:

  1. products_configured - dane produktów, pozycji skonfigurowanych.
    Zawiera linki do renderów dokładnej konfiguracji
  2. products_metrics - dane produktów katalogowych, parametrów.
    Wymaga stworzenia i przypisania konfiguracji.
    Zawiera linki do renderów domyślnej konfiguracji
  3. products_full - dane produktów, pozycji skonfigurowanych z połączoymi danymi metryk
  4. products_stock - aktualne stany magazynowe produktów katalogowych
  5. products_prices - cennik produktów katalogowych

Przykładowe zastosowania:

W zalezności od przyjętej struktury, bazę danych można zasilić na rózne sposoby:

  • Przygotowanie listy produktów (products_configured) z powiązaniem z tabelą danych produktowych  (products_metrics). W taki sposób nie przechowujemy nadmiaru danych a aktualizacja parametrów odrazu wpływa  na wszystkie wystąpienia.
    W tym schemacie otrzymujemy klasyczną listę produktów o ściśle określonych parametrach. Jeden indeks to jedna pozycja na liście.
    Baza wówczas zawiera link do źródła renderów odpowiadającemu danej konfiguracji produktu 
  • Przygotowanie listy produktów bez relacji do parametrów (products_full), kiedy w strukturze bazy danych nie ma dedykowanego miejsca na parametry produktowe, można całość lub wybrane parametry przerzucić do jednej tabeli. 
    W tym schemacie otrzymujemy klasyczną listę produktów o ściśle określonych parametrach. Jeden indeks to jedna pozycja na liście. 
    ​Baza wówczas zawiera link do źródła renderów odpowiadającemu danej konfiguracji produktu 
  • Zbudowanie pełnej oferty produktowej na podstawie (products_metrics).
    Ponieważ Terma posiada produkty, których łączna liczba kombinacji sięga kilku milionów wylistowanie ich wszystkich w tabeli, będzie powodować wiele problemów zarówno systemowych jak i użytkowych. Rozwiązauje je ograniczenie do wybrania pozycji na którą składa się model grzejnika w wybranym rozmiarze oraz niezależnie doprecyzowanie jego konfiguracji. Wówczas kod produktu SKU należy systemowo złożyć w locie. 
  • Aktualizacja stanów magazynowych (products_stock). Jest to pomocny zrzut aby nie obciążać systemów weryfikacją pełnej tabeli danych, lub niepotrzebą aktualizacją całośći. Proponujemy wykonać synchronizacje niezależnie od reszty danych.

 
 

 

Dane indywidualne

Jesteśmy otwarci na indywidualne rozwiązania i potrzeby. Jeśli potrzebujesz danych o dedykowanej strukturze lub formacie, wyślij zgłoszenie, przygotujemy specjalnie dla Ciebie.

 



Przedtem będziesz potrzebować konto na platformie B2B https://www.terma24.pl/user/ z wygenerowanym Kontem Odbiorcy.


Endpoint:  data.terma24.pl/{format_pliku}/{id_odbiorcy}/{plik_danych}.{format_pliku}

format_pliku:

  • CSV  - rozdzielony średnikiem, kodowanie UTF-8 (z BOM), zawiera nagłówki
  • XML  - kodowanie UTF-8 (z BOM)
  • JSON- kodowanie UTF-8 (z BOM)

plik_danych:

  • products_individual - dane produktów, pozycji skonfigurowanych.Wariant produktu, który ma przypisaną cenę.

id_odbiorcy:
Identyfikator systemu ERP, nadawany jest po zawarciu współpracy i utworzenia konta w ERP oraz rejestracji na platformie B2B
(Identyfikator składa się z C{liczba} np. C1234)
 

Lista zrzucanych danych:

Typ produktu, który warunkuje zestaw parametry Szerokość produktu

sku Uniklany kod producenta, na który składa się kod pozycji oraz kod wariantu produktu.
Więcej znajdziesz w naszym poradniku.
id Unikalny kod numeryczny
qty Aktualny stan magazynowy TERMA CZAPLE
type Rodzaj produktu warunkujący parametry
model Nazwa modelu produktu
height Wysokość produktu (wyłącznie grzejniki i grzałki)
width Szerokość produktu (wyłącznie grzejniki i grzałki)
color Paleta kolorów z oferty, zawiera pozycje RAL jak i pozycje specjalne
connection Rodzaj podłaczenia grzejnika
image Adres do pobrania renderu lub zdjęcia
description Opis przypisany modelowi produktu
title Pełna nazwa produktu
power55 Moc grzejnika dla parametrów instalacji 55/45/20
power75 Moc grzejnika dla parametrów instalacji 75/65/20
weight Waga produktu
maxpower Maksymalna moc grzejnika
coating Powłoka grzejnika
size_{x} Poszczególne wymiary grzejnika, w zależności od podłączenia grzejnika
price Cena netto, produktu dla Partnera Handlowego
price_total Cena brutto, produktu dla Partnera Handlowego
price_base Cena bazowa (katalogowa z cenami Outlet) netto
price_base_total Cena bazowa (katalogowa) brutto, domyślna dla Konsumenta
price_margin Cena Partnera Handlowego netto, przemnożona przez wartość marży
price_margin_total Cena Partnera Handlowego brutto, przemnożona przez wartość marży
price_rrp Cena katalogowa netto, domyślna dla Konsumenta

Dane standaryzowane

EDI - ECOD

Standard który wykorzystywany jest do bezpośredniej integracji z naszym system ERP MS Dynamics AX. Wszystkie dokumenty są przekazywane w standardzie ECOD w zakresie tworzenia zamówień oraz wystawiania faktur. Dokumentacja wykorzystywanych struktur XML:

  1. Faktura XML (invoice)
  2. Zamówienie XML (order)
  3. Dowód przyjęcia dostawy  (RECADV)

Operatorem jest Comarch

RESTful API

Standard RESTful API jest w przygotowaniu. Dajemy możliwość integracji platform webowych na zasadzie CRUD

  • utworzenie lub dodanie nowych informacji (create)
  • odczytanie lub wyświetlenie istniejących informacji (read)
  • modyfikowanie lub edycję istniejących informacji (update)
  • usuwanie istniejących informacji (delete)

Dokumentacja do pobrania jest  pod adresem beta-api.terma24.pl

Jeśli jesteś zainteresowany integracją poprzez RESTful API prosimy o kontakt oraz informacje na temat tworzonej aplikacji i potrzebnych operacji:
piotr.klimczak@termagroup.pl

Inne narzędzia

Dopełnieniem danych, są materiały źródłowe. Dostępne są narzędzia które pomogą Tobie zautomatyzować procesy tworzenia ofert produktowych, aktualizacji danych i tworzyć bardziej konkurencyjne prezentacje produktowe.

Szukaj dokumentacji na stronach:

  1. Wizualizacje 3D
  2. Serwer CDN
  3. Karty wbudowane