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, references.csv, numbers.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

Pliki z danymi GC.MDM importujesz w GC.DASHBOARD, w sekcji MDM i PIM → Narzędzia → Import. Kliknij Wybierz typ importu, wybierz typ odpowiadający Twojemu plikowi i wgraj go.

articles.csv — import artykułów

Format:

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

Gdzie:

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

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

references.csv — import zamienników i akcesoriów

Łączy artykuł główny (primary) z artykułem powiązanym (secondary). Dostępne są dwa typy powiązań:

• REPLACEMENT — artykuł powiązany jest zamiennikiem artykułu głównego. Te dane możesz pokazać na przykład jako zamienniki lub cross references.
• ACCESSORY — artykuł powiązany jest akcesorium do artykułu głównego. Te dane możesz pokazać na przykład jako „Inni klienci kupili też”.

Format:

CODE_PRIMARY;NUMBER_PRIMARY;MANUFACTURER_PRIMARY;MANUFACTURER_ID_PRIMARY;CODE_SECONDARY;NUMBER_SECONDARY;MANUFACTURER_SECONDARY;MANUFACTURER_ID_SECONDARY;REF_TYPE;QUANTITY;STATUS

Gdzie:

• CODE_PRIMARY — ID artykułu głównego (opcjonalne, jeśli podano NUMBER_PRIMARY + MANUFACTURER_PRIMARY)
• NUMBER_PRIMARY — numer artykułu głównego (opcjonalne, jeśli podano CODE_PRIMARY)
• MANUFACTURER_PRIMARY — nazwa producenta artykułu głównego (opcjonalne, jeśli podano CODE_PRIMARY lub MANUFACTURER_ID_PRIMARY)
• MANUFACTURER_ID_PRIMARY — ID producenta artykułu głównego (opcjonalne, jeśli podano CODE_PRIMARY lub MANUFACTURER_PRIMARY)
• CODE_SECONDARY — ID artykułu powiązanego (opcjonalne, jeśli podano NUMBER_SECONDARY + MANUFACTURER_SECONDARY)
• NUMBER_SECONDARY — numer artykułu powiązanego (opcjonalne, jeśli podano CODE_SECONDARY)
• MANUFACTURER_SECONDARY — nazwa producenta artykułu powiązanego (opcjonalne, jeśli podano CODE_SECONDARY lub MANUFACTURER_ID_SECONDARY)
• MANUFACTURER_ID_SECONDARY — ID producenta artykułu powiązanego (opcjonalne, jeśli podano CODE_SECONDARY lub MANUFACTURER_SECONDARY)
• REF_TYPE — typ powiązania: REPLACEMENT lub ACCESSORY (wymagane)
• QUANTITY — ilość (np. 1)
• STATUS — status powiązania (np. A)

Każdy artykuł — główny i powiązany — możesz wskazać na jeden z dwóch sposobów:

• przez ID artykułu — wypełnij tylko CODE_PRIMARY / CODE_SECONDARY. Artykuł powiązany o kodzie CODE_SECONDARY zostaje połączony z artykułem głównym o kodzie CODE_PRIMARY.
• przez numer i producenta — jeśli nie posługujesz się ID artykułów, podaj numer razem z producentem: NUMBER_PRIMARY + MANUFACTURER_PRIMARY oraz NUMBER_SECONDARY + MANUFACTURER_SECONDARY.

Przykład danych — artykuły wskazane przez numer i producenta:

CODE_PRIMARY;NUMBER_PRIMARY;MANUFACTURER_PRIMARY;MANUFACTURER_ID_PRIMARY;CODE_SECONDARY;NUMBER_SECONDARY;MANUFACTURER_SECONDARY;MANUFACTURER_ID_SECONDARY;REF_TYPE;QUANTITY;STATUS
;0 12 300 12;TESTMANUFACTURER;;;AB1234;TESTMAN;;REPLACEMENT;1;A
;0 12 300 12;TESTMANUFACTURER;;;BC230P;TESTMAN;;REPLACEMENT;1;A
;0 12 300 12;TESTMANUFACTURER;;;WWOC;TESTMAN;;REPLACEMENT;1;A
;0 12 300 12;TESTMANUFACTURER;;;12442;TESTWOMAN;;ACCESSORY;1;A
;0 12 300 12;TESTMANUFACTURER;;;12443;TESTWOMAN;;ACCESSORY;1;A

Przykład danych — artykuły wskazane przez ID artykułu:

CODE_PRIMARY;NUMBER_PRIMARY;MANUFACTURER_PRIMARY;MANUFACTURER_ID_PRIMARY;CODE_SECONDARY;NUMBER_SECONDARY;MANUFACTURER_SECONDARY;MANUFACTURER_ID_SECONDARY;REF_TYPE;QUANTITY;STATUS
123456;;;;234567;;;;REPLACEMENT;1;A
123456;;;;224455;;;;ACCESSORY;1;A

Pobierz przykładowy plik references.csv

numbers.csv — import dodatkowych numerów

Łączy z artykułem dodatkowe numery (każdy z jego producentem).

Format:

CODE;NUMBER;MANUFACTURER;MANUFACTURER_ID;OTHER_NUMBER;OTHER_NUMBER_MANUFACTURER;STATUS

Gdzie:

• CODE — ID artykułu (opcjonalne, jeśli podano NUMBER + MANUFACTURER)
• NUMBER — numer artykułu (opcjonalne, jeśli podano CODE)
• MANUFACTURER — nazwa producenta (opcjonalne, jeśli podano CODE lub MANUFACTURER_ID)
• MANUFACTURER_ID — ID producenta (opcjonalne, jeśli podano CODE lub MANUFACTURER)
• OTHER_NUMBER — numer łączony z artykułem (wymagane)
• OTHER_NUMBER_MANUFACTURER — producent łączonego numeru (wymagane)
• STATUS — status numeru (np. A)

Artykuł możesz wskazać na jeden z dwóch sposobów:

• przez ID artykułu — wypełnij tylko CODE; OTHER_NUMBER + OTHER_NUMBER_MANUFACTURER zostają połączone z artykułem o tym kodzie.
• przez numer i producenta — podaj bazowy NUMBER + MANUFACTURER; OTHER_NUMBER + OTHER_NUMBER_MANUFACTURER zostają do niego dodane.

Przykład danych:

CODE;NUMBER;MANUFACTURER;MANUFACTURER_ID;OTHER_NUMBER;OTHER_NUMBER_MANUFACTURER;STATUS
;P 85 017;TESTMANUFACTURER;;9010051;AATEST;A
;P 85 017;TESTMANUFACTURER;;FDB4691QS;TESTMAN;A
123456;;;;FCD4455;TESTMAN;A

Pobierz przykładowy plik numbers.csv

files.zip — import plików powiązanych z artykułami

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.

Nazwy plików powinny być zgodne z poniższym formatem:

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

Na przykład: TRW_GDB1330_1.jpg

criteria.csv — import kryteriów artykułów

Gdy chcesz przypisać kryteria techniczne do wielu artykułów jednocześnie, przygotuj plik criteria.csv i zaimportuj go.

Format:

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

Gdzie:

• CODE — ID artykułu (opcjonalne, jeśli podano NUMBER + MANUFACTURER)
• NUMBER — numer artykułu (opcjonalne, jeśli podano CODE)
• MANUFACTURER — nazwa producenta (opcjonalne, jeśli podano MANUFACTURER_ID)
• MANUFACTURER_ID — ID producenta (opcjonalne, jeśli podano MANUFACTURER)
• GROUP_ID — ID grupy artykułów — kod GRU grupy, do której należy kryterium (wymagane)
• CRITERION_KEY — klucz kryterium — 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

Przykład danych:

Pobierz przykładowy plik criteria.csv