Formaty danych w GC.Platform

Dane o cenach i dostępności produktów można integrować z plików CSV. Takie pliki możesz przygotować samodzielnie — na przykład Twój system ERP można zwykle skonfigurować tak, aby je generował — lub przygotować je ręcznie w aplikacjach takich jak Excel.

Pliki, które można importować:

GC.CART — erp_products.csv, prices.csv, availability.csv, profiles_prices.csv, profiles_customers.csv

GC.MDM — articles.csv, articles_cross.csv, files.zip, criteria.csv

GC.CART — formaty plików CSV do wymiany danych z ERP

erp_products.csv / erp_products_sync.csv

Łączy artykuły TECDOC z produktami klienta. Bardzo ważne jest zachowanie dokładnej struktury pliku: właściwe rozmieszczenie średników oraz pozostawienie pierwszej linii (nagłówka) bez zmian. Upewnij się też, że plik nazywa się dokładnie erp_products.csv.

Format:

ARTICLE_ERP_ID;ERP_NUMBER;NUMBER;MANUFACTURER;NAME;CORE_ERP_ID

• ERP_NUMBER — numer produktu klienta; jest odpowiednikiem NUMBER w TECDOC.
• MANUFACTURER — nazwa producenta w TECDOC.

Przykład danych:

ARTICLE_ERP_ID;ERP_NUMBER;NUMBER;MANUFACTURER;NAME;CORE_ERP_ID
BOS0123325012;0 123 325 012;0 123 325 012;BOSCH;Oil filter
BOS0204318582;0 204 318 582;0 204 318 582;BOSCH;Brake pads
TRWGDB1330;GDB1330;GDB1330;TRW;Brake pads
DTX1026R;DTX1026R;DTX1026R;DAXTONE;Common rail injector;COREDTX1026R

Pobierz przykładowy plik erp_products.csv

prices.csv / prices_sync.csv — ceny i dopasowanie kluczy ERP

Format:

ARTICLE_ERP_ID;PRICE_TYPE;PRICE;VAT;CURRENCY

Pusty typ ceny (Price type) oznacza cenę bazową artykułu.

Przykład danych:

ARTICLE_ERP_ID;PRICE_TYPE;PRICE;VAT;CURRENCY
242054;;178.23;20;EUR
242054;;44.50;20;EUR
A6845F;;200.00;20;EUR
A6845F;;50.00;20;EUR

Pobierz przykładowy plik prices.csv

availability.csv / availability_sync.csv — dostępność produktów

Format:

ARTICLE_ERP_ID;BRANCH;QUANTITY;BRANCH_TYPE

Pole BRANCH zawiera ID oddziału. Opis, który widzi użytkownik GC.CATALOG, można dodatkowo ustawić w GC.CART.

Przykład danych:

ARTICLE_ERP_ID;BRANCH;QUANTITY;BRANCH_TYPE
242054;S01;5;
A6845F;S01;17;
242054;S02;1;
A6845F;S02;3;

Dla klientów spoza GC.CATALOG od Inter Cars S.A. pole BRANCH może też zawierać trzy specjalne stałe: GREEN, YELLOW, ORANGE. Służą one do pokazywania kolorów w GC.CATALOG przy wyświetlaniu dostępności produktów na głównej liście. Z biznesowego punktu widzenia kolory te mogą przekazywać użytkownikowi informacje — np. GREEN = dostępne dziś, YELLOW = dostępne jutro — a nie tylko liczbę towarów na stanie.

Przykład danych:

ARTICLE_ERP_ID;BRANCH;QUANTITY;BRANCH_TYPE
242054;S01;5;
A6845F;S01;17;
242054;S02;1;
A6845F;S02;3;
242054;S03;4;
A6845F;S03;20;
242054;S04;99;
A6845F;S05;15;

Pobierz przykładowy plik availability.csv

profiles_prices.csv / profiles_prices_sync.csv

Pozwala zdefiniować wszystkie ceny finalne artykułów dla różnych profili cenowych.

Format:

PROFILE_NAME;ARTICLE_ERP_ID;PRICE;CURRENCY;VAT

Przykład danych:

PROFILE_NAME;ARTICLE_ERP_ID;PRICE;CURRENCY;VAT
PROFILE_01;242054;45.50;EUR;20
PROFILE_02;A6845F;180.50;EUR;20
PROFILE_03;242054;50;EUR;20
PROFILE_04;A6845F;200;EUR;20
PROFILE_05;242054;63.25;EUR;20
PROFILE_06;A6845F;250;EUR;20

Pobierz przykładowy plik profiles_prices.csv

profiles_customers.csv / profiles_customers_sync.csv

Dopasowuje konkretnych użytkowników do konkretnych profili cenowych.

Format:

PROFILE_NAME;CUSTOMER_ID

CUSTOMER_ID to to samo pole co „Number in ERP" w GC.CART.

Przykład danych:

PROFILE_NAME;CUSTOMER_ID
PROFILE_01;208687
PROFILE_02;121213
PROFILE_03;PL-5481111
PROFILE_04;993234

Import nowych profili cenowych nie wymaga wysyłania pliku profiles_customers.csv. Jeśli chcesz zastąpić wszystkie powiązania między użytkownikami a profilami cenowymi, wgraj nowy plik profiles_customers_sync.csv — usunie to wszystkie wcześniejsze powiązania, a pozostaną tylko te z nowego pliku.

Pobierz przykładowy plik profiles_customers.csv

GC.MDM — formaty plików do importu danych

ARTICLES.CSV — import artykułów do GC.MDM

Format:

CODE;NUMBER;MANUFACTURER_ID;MANUFACTURER;NAME;DESCRIPTION;GROUP_ID;GROUP;USAGE_ID;USAGE;IMAGES;STATUS

Gdzie:

• CODE — ID artykułu w GC.MDM (opcjonalne)
• NUMBER — numer artykułu w GC.MDM
• MANUFACTURER_ID — ID producenta w GC.MDM (opcjonalne, jeśli podano MANUFACTURER)
• MANUFACTURER — nazwa producenta w GC.MDM (opcjonalne, jeśli podano MANUFACTURER_ID)
• NAME — własna nazwa produktu w GC.MDM (opcjonalne)
• DESCRIPTION — własny krótki opis w GC.MDM (opcjonalne)
• GROUP_ID — ID grupy w GC.MDM (opcjonalne)
• GROUP_NAME — nazwa grupy w GC.MDM (opcjonalne)
• USAGE_ID — ID zastosowania w GC.MDM (opcjonalne)
• USAGE — nazwa zastosowania w GC.MDM (opcjonalne)
• IMAGES — lista ścieżek do obrazów w GC.MDM (opcjonalne)
• STATUS — status produktu w GC.MDM

Przykład danych:

;04.331ALU;;MARIX;;TŁUMIK MARIX 04.331ALU KOŃCOWY CITROEN C8, PEUGEOT 807 02-06;;;;;;A
;17.638ALU;;MARIX;;TŁUMIK MARIX 17.638ALU KOŃCOWY OPEL ZAFIRA B;;;;;;A
;17.386ALU;;MARIX;;TŁUMIK MARIX 17.386ALU ŚRODKOWY OPEL CORSA C;;;;;;A

Pobierz przykładowy plik ARTICLES.CSV

ARTICLES_CROSSED.CSV — import zamienników i innych powiązanych artykułów do GC.MDM

Format:

TYPE;CODE;CODE_2;NUMBER;NUMBER_2;MANUFACTURER;MANUFACTURER_2;QUANTITY;STATUS

Gdzie:

• TYPE — typ zamiennika (cross-reference)
• CODE — ID artykułu w GC.MDM (opcjonalne, jeśli podano parę NUMBER + MANUFACTURER)
• CODE_2 — ID artykułu-zamiennika (opcjonalne, jeśli podano parę NUMBER_2 + MANUFACTURER_2)
• NUMBER — numer artykułu w GC.MDM
• NUMBER_2 — numer artykułu-zamiennika w GC.MDM
• MANUFACTURER — nazwa producenta w GC.MDM
• MANUFACTURER_2 — nazwa producenta zamiennika w GC.MDM
• QUANTITY — pozostaw puste
• STATUS — pozostaw puste

files.zip — import plików powiązanych z produktami

Możesz importować również pliki powiązane z danym artykułem, na przykład zdjęcia. W takim wypadku wszystkie pliki muszą być spakowane w jeden plik files.zip.

Struktura plików powinna być zgodna z poniższym formatem:

<NAZWA_PRODUCENTA>_<NUMER>_<SORTNR>.<ROZSZERZENIE>

Na przykład: TRW_GDB1330_1.jpg

Importowanie kryteriów artykułów do GC.MDM z użyciem GC.DASHBOARD

Gdy chcesz przypisać kryteria techniczne do wielu artykułów jednocześnie, możesz przygotować plik CRITERIA.CSV i zaimportować go przez GC.DASHBOARD.

Format pliku CRITERIA.CSV

CODE;NUMBER;MANUFACTURER;MANUFACTURER_ID;GROUP_ID;CRITERION_KEY;CRITERION_VALUE;CRITERION_VALUE_LANG;STATUS

Gdzie:

• CODE — ID artykułu w GC.MDM (opcjonalne, jeśli podano NUMBER + MANUFACTURER)
• NUMBER — numer artykułu w GC.MDM (opcjonalne, jeśli podano CODE)
• MANUFACTURER — nazwa producenta w GC.MDM (opcjonalne, jeśli podano MANUFACTURER_ID)
• MANUFACTURER_ID — ID producenta w GC.MDM (opcjonalne, jeśli podano MANUFACTURER)
• GROUP_ID — ID grupy artykułów w GC.MDM — kod GRU grupy, do której należy kryterium (wymagane)
• CRITERION_KEY — klucz kryterium w GC.MDM — kod KRY kryterium (wymagane)
• CRITERION_VALUE — wartość kryterium dla danego artykułu (wymagane)
• CRITERION_VALUE_LANG — kod języka wartości kryterium (wymagane tylko wtedy, gdy kryterium jest tłumaczone)
• STATUS — status kryterium w GC.MDM

Przykład danych

Pobierz przykładowy plik CRITERIA.csv