Elbuz importuje katalog z 1C bezpośrednio z plików wymiany CommerceML 2: produkty, grupy, ceny i stany trafiają do katalogu bazowego bez ręcznego przenoszenia.
Kiedy to się przyda:
- Katalog jest prowadzony w 1C — drzewo grup i karty produktów pojawiają się w Elbuz w jednym uruchomieniu.
- Ceny i stany w 1C zmieniają się codziennie — szablon według harmonogramu aktualizuje te same karty po
Ид. - W 1C jest kilka rodzajów cen — do katalogu trafia pierwsza cena oferty, więc potrzebny rodzaj ustaw jako pierwszy w eksporcie.
- Część kart edytujesz w Elbuz — oznaczenia w karcie nie pozwalają wymianie nadpisać ceny ani opisu.
Od czego zacząć: pierwszy raz przenieś katalog z 1C szablonem „CommerceML2 (1C)”.
Co potrafi wymiana z 1C
- Dwa pliki w jednym uruchomieniu — import.xml zawiera katalog, offers.xml — ceny i stany; można też importować tylko jeden.
- Dopasowanie po
Ид— ponowna wymiana aktualizuje te same karty, a oferty handlowe są wiązane z produktem głównym. - Przeniesienie pól — nazwa, kod produktu, producent, opis, waga, jednostka, parametry, zdjęcia, cena i stan.
- Drzewo kategorii — budowane z klasyfikatora grup 1C.
- Wymiana według harmonogramu — pliki są pobierane z linków bez ręcznego uruchamiania.
- Usuwanie zbędnych pozycji — po zaznaczeniu pola z katalogu usuwa się to, czego nie ma w pliku.
Jak zaimportować wymianę: dwa pliki
Wymiana CommerceML składa się z dwóch plików, które 1C tworzy osobno:
- import.xml — sam katalog: produkty (nazwy, kody, grupy, producent, parametry, obrazy) i klasyfikator grup.
- offers.xml — pakiet ofert: ceny i stany tych samych produktów.
W formularzu szablonu są odpowiednio dwa pola na pliki: pierwsze — na produkty (import.xml), drugie — na oferty (offers.xml). Oba pliki łączy wspólny identyfikator produktu. Zwykła wymiana to oba pliki razem, w jednym uruchomieniu.
1
Plik produktów (import.xml)2
Plik ofert (offers.xml)- Pole pliku produktów — wybierz import.xml z katalogiem.
- Pole drugiego pliku — wybierz offers.xml z cenami i stanami.
Co zaktualizuje jeden plik
Można też zaimportować jeden plik: wtedy w istniejących kartach aktualizuje się tylko to, co jest w tym pliku.
| Co zaimportowano | Co zaktualizuje się w istniejących kartach | Nowe karty |
|---|---|---|
| Tylko import.xml | nazwa, kod produktu, producent, opisy, kategoria; cena, stan i status dostępności zostają bez zmian | powstają z ceną 0 i stanem 0 |
| Tylko offers.xml (w polu „Katalog”) | cena (oprócz kart ze „Stała cena”), stan, status dostępności i parametry z oferty | nie powstają, chyba że w ofercie jest grupa, która już istnieje w katalogu |
Bez pliku w polu „Katalog” wymiana się nie uruchamia, dlatego offers.xml do aktualizacji cen wkłada się właśnie w to pole — program traktuje same oferty jako katalog. Odczytuje z niego tylko Ид, Артикул, Наименование, Группы, Количество, Цены i parametry (ЗначенияСвойств, ХарактеристикиТовара).
Co warto wiedzieć o wymianie samym plikiem offers.xml:
- Nazwa, kod produktu, producent, krótki i pełny opis, kategoria i powiązania z kategoriami zostają bez zmian. Wyjątek to karty-warianty ofert handlowych: w nich nazwa i kod produktu są brane z oferty, tak jak przy zwykłej wymianie.
- Parametry z oferty zastępują całą listę parametrów karty, w tym te, które przyszły z import.xml. Karty z „Nie aktualizuj” lub „Nie aktualizuj atrybutów” zachowują swoje.
- W kartach z oznaczeniem „Nie aktualizuj” cena, stan, nazwa i opis zostają bez zmian — tak samo przy wymianie samym plikiem import.xml.
Jak Elbuz rozpoznaje produkt z 1C
Każdy produkt w 1C ma Ид — globalny identyfikator (GUID). Elbuz zapisuje go w polu systemowym produktu „UUID” i po nim dopasowuje produkty z import.xml, ceny z offers.xml i ponowne importy. GUID w 1C jest stały, więc ponowna wymiana aktualizuje istniejące karty. To pewniejsze niż kod produktu, który w 1C można zmienić. Więcej: ponowny import bez duplikatów.
Nowa karta powstaje tylko wtedy, gdy produkt jest przypisany do grupy klasyfikatora. Produkt bez grupy (albo z grupą, której nie ma ani w pliku, ani w katalogu) wymiana pomija po cichu, bez wiersza w dzienniku. Więcej: produkt bez kategorii.
Osobny przypadek to oferty handlowe (warianty produktu): ich Ид ma postać GUID_товару#GUID_варіанту. Elbuz rozpoznaje taki zapis i wiąże wariant z produktem głównym, zamiast tworzyć osobną, niepowiązaną kartę.
Produktów, które były w katalogu już wcześniej, bez Ид z 1C, wymiana nie dopasowuje do produktów z pliku: produkt z pliku dostanie nową kartę, a stara zostanie bez aktualizacji. W CommerceML nie da się rozdzielić produktów dwóch szablonów z tym samym identyfikatorem — więcej: dwa szablony dla tego samego produktu.
Co wymiana zapisuje w karcie i jak ochronić własne dane
Z import.xml (węzeł Товар) do karty trafiają:
| Węzeł CommerceML | Pole karty w Elbuz |
|---|---|
Ид | UUID (klucz dopasowania) |
Артикул | kod produktu |
Наименование (lub atrybut Полное наименование) | nazwa produktu |
Группы → Ид | kategoria (według klasyfikatora grup) |
Изготовитель → Наименование | producent |
Описание / atrybut ОписаниеВФорматеHTML | opis produktu |
atrybut Вес | waga |
БазоваяЕдиница | jednostka miary |
ЗначенияСвойств, ХарактеристикиТовара | parametry / opcje produktu |
Картинка (kilka) | zdjęcia |
Z offers.xml (węzeł Предложение) pobierane są cena i stan — znajdują swój produkt po tym samym Ид:
| Węzeł CommerceML | Pole karty w Elbuz |
|---|---|
Цены → Цена → ЦенаЗаЕдиницу | cena produktu |
Цены → Цена → ИдТипаЦены | jest odczytywany, ale nie trafia do karty (zob. rodzaje cen) |
Цены → Цена → Валюта | jest odczytywana, ale nie trafia do karty |
Количество | stan |
Pola są zapisywane z pliku tak, jak są: jeśli węzła nie ma, odpowiednie pole karty zostanie puste. Każdy przebieg z import.xml nadpisuje w znalezionych kartach nazwę, kod produktu, producenta, kategorię, krótki i pełny opis; krótki opis z 1C nie przychodzi, więc staje się pusty. Co jeszcze nadpisze ponowny przebieg — w przeglądzie.
Która cena trafi do katalogu, jeśli rodzajów cen jest kilka
W 1C produkt może mieć kilka cen różnych rodzajów (detaliczna, hurtowa, zakupu), każda oznaczona własnym ИдТипаЦены. Elbuz bierze ЦенаЗаЕдиницу tylko z pierwszej Цена w bloku Цены, niezależnie od rodzaju; pozostałe ceny są pomijane.
Wyboru rodzaju ceny w szablonie nie ma, a waluta nie jest przeliczana — liczba trafia do pola ceny tak, jak jest. Dlatego ustaw eksport w 1C tak, żeby potrzebny rodzaj był w każdej ofercie pierwszy, albo eksportuj tylko jego. Oferta bez bloku Цены daje produktowi cenę 0 (oprócz kart ze „Stała cena”).
Parametry i warianty
CommerceML rozróżnia dwa zestawy: ЗначенияСвойств — właściwości z klasyfikatora, oraz ХарактеристикиТовара — cechy konkretnego produktu, na których w 1C opierają się warianty. Elbuz przenosi oba do atrybutów produktu; cechy, którymi różnią się oferty handlowe, stają się podstawą wariantów. Nie trzeba ich osobno włączać — przychodzą razem z resztą wymiany.
Jak ochronić kartę przed nadpisaniem
Oznaczenia w karcie produktu, grupa „Ochrona podczas importu”:
- „Nie aktualizuj” — wymiana zostawia cenę, stan, kategorię główną, powiązania z kategoriami, nazwę, opisy i parametry.
- „Stała cena” — chroni tylko cenę; kategoria, producent, kod produktu i stan aktualizują się z pliku.
- „Nie aktualizuj atrybutów” — chroni tylko parametry, pozostałe pola się aktualizują.
Więcej o oznaczeniach i zdjęciach przy ponownym przebiegu: jak utrwalić własną wartość.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jak z klasyfikatora powstają kategorie
Drzewo kategorii Elbuz buduje z klasyfikatora import.xml (węzeł Группы): każda grupa ma własny Ид i nazwę, a zagnieżdżenie wyznaczają zagnieżdżone grupy. Produkt jest przypisywany do grupy po jej Ид, więc struktura działów z 1C odtwarza się w Twoim katalogu.
Grupy z 1C to zwykłe kategorie katalogu, nie techniczne: program tworzy je z wartościami stanu i udziału w eksporcie, które baza domyślnie nadaje nowej kategorii. Są jednak powiązane z 1C po Ид i każda wymiana przywraca ich stan z 1C:
- Grupę przemianowano lub przeniesiono w drzewie Elbuz — następna wymiana przywróci nazwę (w domyślnym języku katalogu) i grupę nadrzędną z pliku.
- Grupę usunięto w Elbuz — jeśli nadal jest w import.xml, następna wymiana utworzy ją ponownie jako nową kategorię i przeniesie do niej jej produkty.
- Produkty z grupy 1C przeniesiono do własnej kategorii — następna wymiana przywróci im kategorię z pliku. Utrzymać produkt we własnej kategorii można oznaczeniem „Nie aktualizuj”.
Trwałym rozwiązaniem dla struktury jest zmiana grup w samym 1C. Wymiana nie rusza zamówień ani innych dokumentów, więc przeniesienie produktów czy usunięcie grup nie wpływa na wiersze już zaimportowanych dokumentów.
Jak regularnie aktualizować katalog z 1C
Pierwsza wymiana tworzy produkty, kolejne aktualizują istniejące po Ид. Katalog (import.xml) zwykle aktualizuje się rzadziej, a ceny i stany (offers.xml) — częściej, osobnym importem. Żeby nie uruchamiać ręcznie, ustaw wymianę według harmonogramu.
Uruchomienie idzie przez centrum operacji: pojawia się komunikat „Import uruchomiony — śledź go w „Operacjach””, a dziennik przebiegu widać właśnie tam. Kolejność wierszy dziennika:
- Odczyt plików: liczniki „Pobrano z pliku kategorii” (co 100 grup), „Pobrano z pliku produktów” i „Pobrano z pliku cen produktów” (co 1000 pozycji).
- Podsumowania odczytu: „Łącznie zaimportowano kategorii”, „Łącznie zaimportowano produktów”, „Łącznie zaimportowano cen produktów”.
- Zapis do katalogu, potem kroki końcowe — formuły, kontrola spójności, indeksowanie — i wiersz „Import danych zakończony!”.
Jeśli plik nie dotarł na serwer (jest za duży lub połączenie zostało przerwane), wymiana się nie zaczyna, a w dzienniku pojawia się „Nie udało się przesłać pliku na serwer. Możliwe, że jest za duży lub połączenie zostało przerwane”. Jak sprawdzić wynik przebiegu: dziennik i „Historia uruchomień”.
Nowe ceny i stany nie trafią same na stronę ani na marketplace’y: wymiana nie uruchamia eksportów. Najpierw wymiana z 1C, potem eksport — więcej: kiedy zaimportowane dane pójdą dalej.
Co się stanie z produktem, który zniknął z wymiany
Decyduje pole wyboru w formularzu szablonu, blok „Co importować”: „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku”. Bez niego karty, której nie ma w pliku, wymiana nie rusza: produkt wycofany w 1C zostaje w katalogu ze starą ceną i stanem.
Gdy pole jest zaznaczone, wymiana przed zapisem nowych danych usuwa z katalogu bazowego wszystkie kategorie, których nie ma w klasyfikatorze pliku, i wszystkie produkty, których nie ma w pliku — w tym utworzone ręcznie i zaimportowane z innych źródeł. Pola „Sprawdzaj unikalność rekordów…”, które zawęziłoby zakres, w formularzu CommerceML nie ma. Produkty i warianty, które są tylko w offers.xml, uznaje się za obecne w pliku.
To usuwanie, a nie wyłączanie, i nie ma przycisku cofnięcia. Razem z produktem znikają opisy, zdjęcia, parametry i powiązania; wiersze cenników dostawców tracą dopasowanie, a reguły importu dla usuniętych kategorii są usuwane. W dzienniku ten krok jest opisany jako „Usuwanie z katalogu bazowego kategorii i produktów, których nie ma w pliku”.
Przy zaznaczonym polu sam offers.xml nie usuwa kategorii — nie ma w nim klasyfikatora. Ale produkty, których nie ma wśród ofert, usuwa: offers.xml z częścią asortymentu usunie resztę. Tak samo wybiórczy import.xml usunie wszystko, co do niego nie trafiło.
Pusty plik albo plik bez klasyfikatora nie wyczyści katalogu — więcej: produkt zniknął ze źródła. Bez uprawnienia do flagi usuwania kategorii i produktów pole w formularzu jest nieaktywne.
Jeśli wymiana została przerwana lub utworzyła duplikaty
Wymiana została przerwana
To, co zostało w katalogu, zależy od etapu:
- Przerwanie podczas odczytu plików — katalog się nie zmienił: dopóki oba pliki są odczytywane, do katalogu nic nie jest zapisywane. Plik ucięty w połowie produktu lub oferty — z komputera albo z linku — kończy wymianę błędem „Nie udało się odczytać pliku:” z przyczyną, również przed zapisem.
- Przerwanie podczas zapisu — zostaje to, co zdążyło się zapisać: najpierw usuwanie (jeśli jest włączone), potem kategorie, potem produkty, parametry i zdjęcia. Zatrzymanie jest sprawdzane przed usuwaniem i po zapisie kategorii; dalej zapis produktów i parametrów idzie do końca. Jeśli zatrzymanie kliknięto wcześniej, zdjęcia nie są pobierane.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Powtórzenie tej samej wymiany jest bezpieczne: produkty i kategorie są znajdowane po Ид, producent jest wyszukiwany po nazwie, parametry są nadpisywane — duplikatów nie będzie. Co się dzieje po zatrzymaniu i dlaczego nie można uruchamiać dwóch przebiegów naraz: jeśli przebieg został przerwany.
Wymiana utworzyła duplikaty
Duplikaty pojawiają się, gdy w 1C zmieniły się Ид produktów: dla programu to nowe produkty, więc tworzy nowe karty, a stare zostają obok i nie są już aktualizowane.
Znajdziesz je w tabeli katalogu bazowego po kolumnach „Źródło: nazwa” (nazwa Twojego szablonu CommerceML) i „Data dodania” (dzień takiej wymiany). Wyświetl obok kolumnę „ID produktu (ciąg UUID)”, żeby porównać Ид z 1C.
Usuwaj stare karty, a nie nowe: wymiana nadal będzie szukać produktów po nowych Ид i usunięte nowe karty utworzy ponownie. Ze starych najpierw przenieś ręcznie dopracowane treści. Działania zbiorcze do tego: jeśli zaimportowano nie to, co trzeba.
Scenariusze
Pierwszy raz przenieść katalog z 1C
Zadanie: założyć w Elbuz katalog, który jest już prowadzony w 1C. W formularzu szablonu „CommerceML2 (1C)” na karcie „Plik lokalny” wybierz import.xml przyciskiem „Wybierz plik – Katalog” i offers.xml przyciskiem „Wybierz plik - PakietOfert”. Nie zaznaczaj pola „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” i kliknij „Importuj”.
Efekt: drzewo kategorii z klasyfikatora, karty produktów z Ид w polu UUID, ceną i stanem z offers.xml. Nowi producenci są dodawani do słownika, parametry stają się atrybutami, a jako źródło nowych kart zapisywana jest nazwa szablonu. Czego nie będzie: kart dla produktów bez grupy klasyfikatora.
Pierwszą wymianę zrób na niewielkiej próbce i sprawdź kilka kart samodzielnie.
Pobierać ceny i stany z 1C według harmonogramu
Zadanie: żeby ceny i stany z 1C aktualizowały się bez ręcznego uruchamiania. Na karcie „Link zewnętrzny” podaj adresy, pod którymi 1C publikuje pliki: „Link do pliku z produktami (Katalog)” i „Link do pliku z cenami ( PakietOfert )”. W bloku „Powiązane ustawienia” kliknij „Ustawienia harmonogramu” i ustaw uruchamianie, a w nagłówku formularza przełącz szablon na stan „Aktywny”.
1
Link do katalogu2
Link do pakietu ofert3
Ustawienia harmonogramu- Link do pliku z produktami (Katalog).
- Link do pliku z cenami (PakietOfert).
- Przycisk „Ustawienia harmonogramu”.
Efekt: według harmonogramu program sam pobiera oba pliki z linków i aktualizuje karty po Ид. Szablon w stanie „Wyłączony” jest pomijany przez harmonogram. Jeśli drugi link jest pusty, wymiana pójdzie z samym katalogiem: istniejące karty zachowają ceny i stany, nowe dostaną cenę 0 i stan 0.
Usuwać z katalogu to, co wycofano w 1C
Zadanie: 1C jest jedynym źródłem asortymentu i w Elbuz nie może zostawać nic zbędnego. Zaznacz pole „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” (potrzebne jest do niego uprawnienie) i zawsze importuj pełny import.xml razem z offers.xml.
Efekt: przed zapisem wymiana usuwa wszystkie kategorie i produkty, których nie ma w pliku, razem z ręcznie utworzonymi i zaimportowanymi z innych źródeł; nie ma cofnięcia. Jeśli ograniczysz asortyment pliku, reszta zniknie z katalogu (zob. co się stanie z produktem, który zniknął).
Prowadzić wybrane karty ręcznie, resztę brać z 1C
Zadanie: dla części produktów cenę lub opis ustawiasz w Elbuz i wymiana nie może ich nadpisywać. W karcie takiego produktu zaznacz „Stała cena” (chroni cenę) albo „Nie aktualizuj” (chroni cenę, stan, kategorie, nazwę, opisy i parametry).
Efekt: reszta katalogu aktualizuje się z 1C, a oznaczone karty pozostają Twoje. Stan karty ze „Stała cena” aktualizuje się z pliku (zob. jak ochronić kartę).
Co zrobić, gdy wymiana zaimportowała nie to, co trzeba
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Przyszedł katalog, a nowe produkty mają cenę 0 i stan 0 | Zaimportowano tylko import.xml: ceny i stany są w offers.xml | Dodaj offers.xml jako drugi plik i uruchom wymianę jeszcze raz (jeden plik) |
| W katalogu jest cena zakupu lub hurtowa zamiast detalicznej | Brana jest pierwsza cena oferty, rodzaj ceny nie ma znaczenia | Ustaw potrzebny rodzaj jako pierwszy w eksporcie 1C (rodzaje cen) |
| W katalogu jest mniej produktów niż w pliku | Produkt bez grupy klasyfikatora nie dostaje karty | Przypisz produkty do grup w 1C (jak Elbuz rozpoznaje produkt) |
| Produkty, które były w katalogu przed wymianą, się nie zaktualizowały, a obok pojawiły się nowe | Stare karty nie mają Ид z 1C albo w 1C zmieniły się Ид |
Znajdź duplikaty po „Źródło: nazwa” i „Data dodania” (duplikaty) |
| „Nie udało się przesłać pliku na serwer. Możliwe, że jest za duży lub połączenie zostało przerwane” | Plik nie dotarł na serwer, wymiana się nie zaczęła | Powtórz import albo podaj plik jako link (z linku) |
| „Nie udało się odczytać pliku:” z przyczyną | Plik jest ucięty lub uszkodzony; katalog się nie zmienił | Wyeksportuj plik z 1C od nowa (przerwanie wymiany) |
| W katalogu są nowe ceny, a na stronie stare | Wymiana nie uruchamia eksportu | Sprawdź, kiedy ostatnio wykonał się eksport (kiedy dane pójdą dalej) |
Pliki z 1C muszą mieć poprawne kodowanie — zwykle lub Windows-1251, tak jak zwraca je Twoja konfiguracja.
Najczęstsze pytania
Czy można aktualizować z 1C tylko ceny i stany?
Tak. Włóż offers.xml w pole „Katalog”: w istniejących kartach zaktualizują się cena, stan, status dostępności i parametry, a pozostałe pola zostaną bez zmian (co zaktualizuje jeden plik).
Czy Elbuz przelicza walutę ceny z 1C?
Nie. Waluta z offers.xml jest odczytywana, ale nie trafia do karty: liczba trafia do pola ceny tak, jak jest (rodzaje cen).
Dlaczego nie zaimportowały się parametry?
Parametry importują się automatycznie razem z resztą wymiany. Pochodzą z węzłów ЗначенияСвойств i ХарактеристикиТовара; jeśli nie ma ich w pliku z 1C, nie ma czego przenosić. Karty z „Nie aktualizuj” lub „Nie aktualizuj atrybutów” zachowują swoje.
Czy można zaimportować z 1C tylko część katalogu?
Tak, jeśli pole usuwania jest odznaczone: zaktualizują się tylko produkty z pliku. Przy zaznaczonym polu wszystko, czego nie ma w pliku, zostanie usunięte (produkt zniknął z wymiany).
Czy wymiana zmienia zamówienia i dokumenty?
Nie, wymiana nie rusza dokumentów. Przeniesienie produktów czy usunięcie grup nie wpływa na wiersze już zaimportowanych dokumentów.
Dlaczego po wymianie zniknął opis napisany w Elbuz?
Wymiana z import.xml nadpisuje nazwę i opisy tym, co przyszło z 1C; krótki opis staje się pusty. Opis przetrwa tylko w karcie z „Nie aktualizuj” (jak ochronić kartę).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → szablon „CommerceML2 (1C)”
- Uprawnienia
- okno „Import danych” w uprawnieniach grup
- Pole usuwania
- osobne uprawnienie do flagi usuwania z katalogu bazowego kategorii i produktów, których nie ma w importowanym pliku
- Co przygotować
- import.xml i offers.xml wyeksportowane z 1C albo linki do nich
1
Szablon CommerceML2 (1C)- Wiersz szablonu CommerceML2 (1C) na liście.
Inne sposoby importu i czym się różnią — w przeglądzie importu danych.
Powiązane tematy
- Jeśli dopiero wybierasz sposób importu katalogu — przegląd importu danych.
- Jeśli trzeba przekazać katalog i ceny z Elbuz z powrotem do 1C — eksport do CommerceML.
- Jeśli plik od dostawcy lub ze strony nie jest w CommerceML, tylko w XML — import z XML.
- Jeśli format jest niestandardowy i pola trzeba oznaczyć ręcznie — import uniwersalny.
