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:

bazę renderów produktów w każdym rozmiarze https://www.terma24.pl/CDN
wizualizacje produktów 3D https://www.terma24.pl/wizualizacje-3d-api
zbudowane karty produktów z metrykami https://www.terma24.pl/karty-wbudowane

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:

Dla połączeń szyfrowanych https://data.terma24.pl
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:

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_configured - dane produktów, pozycji skonfigurowanych.
Zawiera linki do renderów dokładnej konfiguracji
products_metrics - dane produktów katalogowych, parametrów.
Wymaga stworzenia i przypisania konfiguracji.
Zawiera linki do renderów domyślnej konfiguracji
products_full - dane produktów, pozycji skonfigurowanych z połączoymi danymi metryk
products_stock - aktualne stany magazynowe produktów katalogowych
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:

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: