Elbuz sam pobiera z DC Link B2B cennik z ceną dealera w dolarach, RRP i dostępnością, a w razie potrzeby — tym samym logowaniem pełne karty produktów z opisem, parametrami i zdjęciami.
Kiedy to się przyda:
- Potrzebujesz tylko produktów dostępnych od ręki albo także tych w drodze — wybór metody cennika decyduje, ile produktów przyjdzie.
- Produkty mają trafiać do katalogu z opisem i zdjęciami — karty DC Link są pobierane partiami i przechowywane między importami.
- Zamówienie u dostawcy trzeba zarezerwować w DC Link — rezerwację zakłada się z dokumentu, numery dokumentów wydania i listów przewozowych wracają do Elbuz.
Od czego zacząć: poproś menedżera DC Link o login i hasło do API.
Co potrafi integracja z DC Link
- Importuje cennik DC Link — kod, kod producenta, nazwę, markę, kod kreskowy, cenę dealera, RRP, gwarancję, kategorię i dostępność.
- Pobiera produkty dostępne od ręki albo także w drodze i na zamówienie — zależnie od metody.
- Przelicza ceny w dolarach po kursie DC Link.
- Uzupełnia pełne karty produktów — opis, wszystkie parametry i zdjęcia, wagę i wymiary. Zdjęcia przychodzą także bez kart.
- Zakłada rezerwację w DC Link z dokumentu i pobiera stan rezerwacji oraz numer przesyłki — .
Kod i nazwa podkategorii DC Link przychodzą w każdym produkcie; dopasowuje się je do Twoich kategorii jak w każdym cenniku (dopasowanie kategorii).
Co wziąć od DC Link: jedno logowanie do cennika i kart
- Login i hasło do API. Sekcja API jest na portalu DC Link B2B (online.dclink.ua), tam też są opisane metody „API 2.0 (рекомендоване)” (zalecane). Login i hasło wydaje DC Link; jeśli ich nie masz — zapytaj swojego menedżera.
- Do pełnych kart osobne logowanie nie jest potrzebne. Serwis kart DC Link (cerebro.dclink.ua) przyjmuje ten sam login i hasło, a program bierze je sam.
- magazynu — tylko do rezerwacji z jednego magazynu. DC Link nie udostępnia danych słownikowych, ID ustal z menedżerem.
- Adresu IP nie trzeba przekazywać. Jeśli menedżer DC Link poprosi o adres, z którego będą szły zapytania, — znajdziesz go w oknie parametrów dostępu (gdzie dokładnie).
Jakie parametry zapytania DC Link ustawić
W kreatorze nowego źródła na kroku „Skąd” wybierz kafelek „API” i DC Link na liście. Adres https://api.dclink.com.ua/api/, format i kolumny program ustawia sam (co robi powiązanie). W „Login” i „Hasło (token)” wpisz login i hasło do API DC Link. Przycisk „Pobierz dane słownikowe” dla DC Link pokazuje tylko „Ta integracja nie ma danych słownikowych…”.
| Parametr | Domyślnie | Co robi |
|---|---|---|
| „Pełna nazwa produktu” | 0 | przekazywany do DC Link bez zmian; w naszych próbkach cennika zestaw tagów od niego się nie zmieniał |
| „Kolumny z ceną” | 1 | 1 — w cenniku pojawiają się dodatkowe ceny: PriceOpt, RetailPrice, PricePartner, PriceMin |
| „Importuj kursy walut” | 1 | 1 — przed importem pobierać z DC Link bezgotówkowy kurs dolara (więcej) |
| „Metoda pobierania produktów” | GetBnPrices | jaką metodą pobierać cennik: GetPrice, GetBnPrices lub GetPriceAll (więcej) |
| „Typ firmy” | east,fcu,opt,dc | przekazywany do DC Link parametrem firm bez zmian; w opisie metody GetBnPrices DC Link nazywa klucze firm east i fcu |
| „Pełne karty produktów” | 1 | 1 — opis, parametry i wszystkie zdjęcia z serwisu kart DC Link (więcej) |
| „Łącz wartości parametrów” | 1 | 1 — parametry o tej samej nazwie stają się jednym: „Socket: LGA1200 / LGA1700” zamiast dwóch wierszy „Socket”; 0 — każda wartość w osobnym wierszu |
| „Separator wartości parametrów” | / | znak między połączonymi wartościami; przy przecinku lub średniku spacja stawiana jest tylko po znaku: „INTEL, AMD” |
| „Zamówienie: magazyn DC Link (ID)” | puste | rezerwacja tylko z tego magazynu; puste — DC Link bierze produkt ze swoich magazynów po kolei (rezerwacja) |
1
Metoda pobierania produktów2
Pełne karty produktów3
Zamówienie: magazyn DC Link (ID)- Metoda pobierania produktów — GetPrice pobiera produkty dostępne od ręki.
- Pełne karty produktów — 1 pobiera opis, parametry i zdjęcia z DC Link tym samym loginem.
- Zamówienie: magazyn DC Link (ID) — puste oznacza, że DC Link rezerwuje ze swoich magazynów po kolei.
W źródłach podłączonych wcześniej karty są wyłączone (0), a magazyn rezerwacji nie jest ustawiony. W nowych źródłach karty są włączone od razu.
Ile produktów pobierać: GetPrice, GetBnPrices czy GetPriceAll
„Metoda pobierania produktów” decyduje, jaką metodą DC Link udostępnia cennik. Program rozumie trzy wartości:
| Wartość | Co przychodzi |
|---|---|
| GetPrice | produkty dostępne od ręki; na naszym koncie testowym — 3 740 pozycji, plik w kilka sekund |
| GetBnPrices | produkty dostępne od ręki i możliwe do wystawienia przy płatności bezgotówkowej; na tym samym koncie plik przyszedł pusty |
| GetPriceAll | wszystko, co jest dostępne, plus produkty w drodze i na zamówienie; na tym samym koncie — 6 295 pozycji |
Cennik przychodzi bez produktów, a innych błędów nie ma — ustaw GetPrice: GetBnPrices zależy od warunków Twojej umowy z DC Link. Każdą inną wartość program zamienia na GetPrice. Produkty w drodze i na zamówienie z GetPriceAll nie dostają pełnych kart.
Co przychodzi z DC Link: nazwy, ceny i kurs
Cennik DC Link to plik XML w kodowaniu windows-1251, w którym każdy produkt jest zapisany tagiem <Product> z zagnieżdżonymi tagami. Kolumny, które powiązanie mapuje samo:
| Tag DC Link | Pole w Elbuz | Uwagi |
|---|---|---|
Code | „Kod kontrahenta”, „ID produktu (ciąg UUID)”, a także „Kod kreskowy JAN” | kod produktu DC Link; po nim produkt trafia do rezerwacji, dobierana jest pełna karta i przypisywane są zdjęcia |
Article | „Kod producenta” | |
Name | „Nazwa” | nazwa po rosyjsku (jak wziąć ukraińską) |
Vendor | „Producent” | |
EAN | „Kod kreskowy EAN” | |
PriceUSD | „Cena” | cena dealera, zawsze w dolarach |
RRP_UAH | „Cena sugerowana (RRP)” | cena detaliczna, w hrywnach |
Availability | „Status dostępności (z cennika)” | gwiazdki od * do ***** (dostępność) |
Subcategory | „Kategoria z cennika” | nazwa podkategorii |
CategoryID | „ID kategorii (ciąg UUID)” | do dopasowania kategorii |
Warranty | „Gwarancja” | w miesiącach |
Pozostałe tagi — NameUA, DDP, UCGFEA (kod UKT ZED — ukraiński kod celny towaru), RRP, PriceType, Price, a przy „Kolumny z ceną” = 1 także PriceOpt, RetailPrice, PricePartner, PriceMin — bierze się wolnym wierszem kolumn: wpisz nazwę tagu w „Adres kolumny”.
Nazwa po ukraińsku. DC Link podaje dwie nazwy: NameUA — po ukraińsku, Name — po rosyjsku, a powiązanie wstawia do „Nazwa” Name. Potrzebujesz ukraińskiej — wpisz w wierszu „Nazwa” adres NameUA i uruchom import.
Cena, RRP i kurs DC Link
Cena dealera PriceUSD jest zawsze w dolarach, RRP RRP_UAH — w hrywnach. W sekcji „Kolumny” w wierszu „Cena” powinna być waluta USD, w wierszu „Cena sugerowana (RRP)” — UAH; nowe źródła są mapowane tak samo. Obsługa wielu walut nie jest potrzebna: PriceType z wartością UAH dotyczy tagu Price, a nie PriceUSD — sprawdziliśmy to na 746 takich produktach.
Jeśli „Importuj kursy walut” = 1, przed każdym importem program pobiera z DC Link kurs bezgotówkowy i zapisuje go w dolarowych wierszach „Cena” i „Cena sugerowana (RRP)” sekcji „Kolumny”. Osobnego wiersza w dzienniku o tym nie ma. Po wyłączeniu parametru zostanie ostatni kurs DC Link — zmieniaj go ręcznie.
1
Adres kolumny Nazwa2
Cena w USD3
RRP w UAH4
Dostępność5
Pełny opis- Nazwa — adres nazwy produktu w pliku.
- Cena — PriceUSD, zawsze w dolarach, z walutą USD.
- Cena sugerowana (RRP) — RRP_UAH, w hrywnach, z walutą UAH.
- Status dostępności (z cennika) — Availability, potrzebuje własnej reguły dostępności.
- Pełny opis — content_description, pełny opis z karty DC Link.
Jak otrzymać pełne karty produktów DC Link
Opis, parametry i zdjęcia DC Link udostępnia nie w cenniku, lecz w osobnym serwisie kart, gdzie kod produktu jest ten sam. Dlatego program łączy je bez dopasowania:
- Partiami po tysiąc produktów na zapytanie. W naszym źródle testowym opis otrzymała nieco ponad połowa produktów — dla reszty DC Link nie ma treści. Zdjęcia i parametry przychodzą dla większości.
- Niezależnie od cennika. Przycisk „Importuj” nie kasuje kart.
- Nowe produkty — za każdym razem, zapisane karty — raz na 30 dni. Serwis DC Link nie udostępnia listy zmian, więc karta poprawiona wczoraj zaktualizuje się w Elbuz, gdy minie jej 30 dni.
- Tylko dla produktów dostępnych od ręki (gwiazdki w
Availability).
Jak włączyć
- Włącz karty: w parametrach zapytania w wierszu „Pełne karty produktów” wpisz
1. - Opcjonalnie — jak pokazywać parametry: „Łącz wartości parametrów” i „Separator wartości parametrów”. Po zmianie zaimportuj cennik jeszcze raz, karty nie są pobierane od nowa.
- Zaimportuj cennik przyciskiem „Importuj”. Wiersze dziennika „Pełne karty DC Link: ‹ile› z ‹ilu›” pokazują postęp uzupełniania.
- Sprawdź opis, parametry i zdjęcia w produktach cennika.
| Dane z karty DC Link | Dokąd w cenniku | Adres kolumny |
|---|---|---|
| pełny opis (ze znacznikami HTML) | „Pełny opis” | content_description |
| waga, szerokość, wysokość, głębokość | „Waga”, „Szerokość”, „Wysokość”, „Długość” | content_weight, content_width, content_height, content_depth |
| wszystkie zdjęcia | zdjęcia produktu cennika | osobny adres nie jest potrzebny |
| wszystkie parametry | parametry produktu cennika | tag param, osobny adres nie jest potrzebny |
Kod kreskowy dla DC Link pochodzi z cennika, z tagu EAN. Adresy dla kart są zmapowane we wszystkich źródłach DC Link, własnych adresów program nie zmienia. Przełączniki „Pobieraj atrybuty” i „Pobieraj zdjęcia” (sekcja „Produkty”, blok „Jakie dane importować”) włączają się same razem z kartami.
Zdjęcia bez kart. Program pobiera z DC Link listę linków do zdjęć i przypisuje je do produktów po kodzie. Przy włączonych kartach produkt, który ma kartę, dostaje zdjęcia z niej, pozostałe — z listy.
Przy dodawaniu produktu z cennika do katalogu bazowego karta przychodzi wypełniona (parametry produktów, zdjęcia produktów). Jeśli serwis kart odmówił, w dzienniku jest „Nie otrzymano pełnych kart DC Link (…) — cennik jest importowany z wcześniej zapisanymi kartami”; nowe karty zostaną pobrane następnym razem.
Jak nie stracić dostępności: gwiazdki DC Link
Dostępność DC Link podaje w tagu Availability gwiazdkami: od * do *****. To skala, a nie sztuki, a co oznacza każda liczba gwiazdek, DC Link w dokumentacji API nie podaje. Metoda GetPrice zwraca tylko produkty dostępne od ręki, więc gwiazdki ma każdy produkt.
Bez własnej reguły dostępności produkty z dwiema–pięcioma gwiazdkami dostają „Brak w magazynie”. Standardowy status „Dostępny” szuka dokładnego dopasowania, a na jego liście jest tylko jedna gwiazdka *. Przez to produkty, których w magazynie jest więcej, trafiają jako niedostępne.
Dodaj na zakładce „Dostępność” źródła regułę dla statusu „Dostępny” z wartościami *, **, ***, ****, ***** albo z jednym znakiem * i wyszukiwaniem po fragmencie (dostępność produktu w cenniku dostawcy).
Jak założyć rezerwację w DC Link
Zamówienie u dostawcy utworzone w Elbuz na kontrahenta DC Link wysyła się do DC Link z dokumentu, a DC Link zakłada prawdziwą rezerwację. Magazyn — wiersz „Zamówienie: magazyn DC Link (ID)” w parametrach zapytania; program bierze go z pierwszego aktywnego źródła API kontrahenta z dokumentu.
Co się dzieje po kliknięciu
Otwórz dokument „Zamówienie u dostawcy”, kliknij „Wyślij do dostawcy” i potwierdź. Program jednym zapytaniem zakłada rezerwację:
- pozycje dokumentu idą po kodzie DC Link; takie same produkty łączą się w jeden wiersz;
- w opisie rezerwacji jest „Elbuz ‹numer dokumentu›” — po nim łatwo znaleźć rezerwację na portalu;
- magazyn nie jest ustawiony — DC Link bierze produkt ze swoich magazynów po kolei; jest ustawiony — tylko z tego magazynu.
DC Link tworzy dla każdego magazynu osobny dokument wydania. Numery wszystkich dokumentów zapisują się w dokumencie po przecinku, status od dostawcy — „Rezerwacja”, wynik — w komunikacie i historii dokumentu.
1
Wyślij do dostawcy2
Odśwież status od dostawcy- Wyślij do dostawcy — zakłada rezerwację w DC Link.
- Odśwież status od dostawcy — pobiera bieżący status: Rezerwacja, Wysłano z listem przewozowym albo W realizacji.
Gdy nie wszystko zostało zarezerwowane
To, czego DC Link nie zdołał zarezerwować, zwraca z przyczyną, reszta zostaje w rezerwacji. Program pokazuje „Nie zarezerwowano: ‹produkt› — ‹ilość› szt., ‹przyczyna›”, status od dostawcy — „Rezerwacja częściowa”. Przyczyny:
- „brak w magazynie” — produktu nie ma albo nie ma go w magazynie z „Zamówienie: magazyn DC Link (ID)”;
- „całość już zarezerwowana” — produkt jest, ale cały jest już zarezerwowany;
- „produktu DDP nie można dodać do rezerwacji z produktem w USD” i odwrotnie — takie pozycje wyślij osobnym zamówieniem.
Nic nie zostało zarezerwowane — komunikat „DC Link niczego nie zarezerwował: …”, numer nie zapisuje się w dokumencie.
Gdy nic nie zostaje wysłane
- pozycja nie ma kodu DC Link — produkt nie jest dopasowany do cennika DC Link; nazwy takich pozycji są w komunikacie (dopasowanie produktów);
- w dokumencie nie ma pozycji z ilością większą od zera.
Ponowne wysłanie nie zakłada drugiej rezerwacji. Jeśli numer dokumentu wydania DC Link jest już w dokumencie, ponowne kliknięcie pokazuje stan istniejącej rezerwacji z dopiskiem „Rezerwacja w DC Link już istnieje — nie utworzono ponownie.”.
Stan rezerwacji i list przewozowy
Stan nie odświeża się sam — tylko pozycją „Odśwież status od dostawcy” w menu obok przycisku wysyłki. Sprawdza ona każdy dokument wydania:
- „Rezerwacja” — dokument jest jeszcze w rezerwacji;
- „Wysłano” z numerem listu przewozowego — DC Link go wysłał; numer listu zapisuje się w dokumencie, jeśli pole numeru listu przewozowego jest puste;
- „W realizacji” — rezerwacja przyjęta do realizacji, wysyłki jeszcze nie ma.
Wysyłanie rezerwacji sprawdziliśmy na symulacji serwera DC Link, a nie na prawdziwej rezerwacji. Pierwsze zamówienie wyślij niewielkie i sprawdź wynik na portalu DC Link.
Scenariusze
Dodawać produkty DC Link do katalogu od razu z opisem i zdjęciami
Co zrobić. „Pełne karty produktów” = 1, import źródła, potem — dodanie produktów z cennika do katalogu bazowego jak zwykle.
Efekt. Nowe produkty w katalogu dostają opis, parametry i zdjęcia z DC Link. Kolejne importy aktualizują ceny i dostępność oraz pobierają karty dla nowych produktów.
Sprzedawać także produkty w drodze i na zamówienie
Co zrobić. „Metoda pobierania produktów” = GetPriceAll, reguła dostępności dla gwiazdek — jak w rozdziale o dostępności.
Efekt. W cenniku są produkty dostępne od ręki oraz te w drodze lub na zamówienie; te ostatnie — bez pełnych kart.
Rezerwować tylko z jednego magazynu
Co zrobić. Ustal z menedżerem DC Link ID swojego magazynu i wpisz je w „Zamówienie: magazyn DC Link (ID)”.
Efekt. Rezerwacja zakładana jest tylko z tego magazynu, jeden dokument wydania na zamówienie. Czego w magazynie nie ma — wraca z przyczyną „brak w magazynie”, bez szukania w innych magazynach.
Co zrobić, gdy cennik DC Link jest pusty albo nie dotarł
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Plik dotarł, a w cenniku jest zero produktów | „Metoda pobierania produktów” = GetBnPrices, a pozycji bezgotówkowych dla Twojego konta DC Link nie udostępnia | Ustaw GetPrice (metoda) |
| „Błąd API dostawcy: …Access denied. Authorization failed…” | Błędny login lub hasło do API | Sprawdź login i hasło w „Ustawienia parametrów dostępu do API” (gdy cennik nie dotarł) |
| Część dostępnych produktów trafia jako „Brak w magazynie” | Standardowy status rozpoznaje tylko jedną gwiazdkę *, a nie **…***** |
Dodaj regułę dostępności dla wszystkich gwiazdek (dostępność) |
| Nazwy produktów po rosyjsku | W „Nazwa” jest adres Name |
Ustaw NameUA (nazwa po ukraińsku) |
| Status „Rezerwacja częściowa” | Części pozycji DC Link nie zarezerwował — przyczyna jest w komunikacie | Domów brakujące u innego dostawcy albo osobnym zamówieniem (gdy nie wszystko zostało zarezerwowane) |
| „Pozycje bez kodu DC Link…” | Produkt z dokumentu nie jest dopasowany do cennika DC Link | Dopasuj produkt do cennika DC Link (dopasowanie produktów) |
Gdy cennik nie dotarł
W dzienniku importu pracę z DC Link widać po wierszach „Pobieramy plik przez API”, „Łączenie z serwerem API” i „Otrzymano plik: ‹rozmiar› MB”. Na błędny login lub hasło DC Link odpowiada „Access denied. Authorization failed. Please check credentials!” — ten tekst stoi w wierszu „Błąd API dostawcy: …”, a dalej „Nie otrzymano danych, zostanie wyświetlona poprzednia lista produktów”.
Produkty cennika zostają wtedy wczorajsze (dlaczego tak jest). Sprawdź login i hasło w oknie parametrów dostępu.
Najczęstsze pytania
Dlaczego cennik DC Link przychodzi pusty?
Najczęściej przez „Metoda pobierania produktów” = GetBnPrices: jeśli dla Twojego konta nie ma pozycji bezgotówkowych, DC Link zwraca pustą listę. Ustaw GetPrice.
DC Link poprawił opis produktu — dlaczego w Elbuz jest stary?
Zapisane karty aktualizują się raz na 30 dni: DC Link nie udostępnia listy zmian. Nowe produkty dostają karty przy każdym imporcie (pełne karty).
Czy można anulować lub przenieść rezerwację DC Link z Elbuz?
Nie. Program zakłada rezerwację i pokazuje jej stan; anulować rezerwację lub przenieść produkt między dokumentami wydania można na portalu DC Link.
Jak otrzymać nazwy DC Link po ukraińsku?
W sekcji „Kolumny” źródła DC Link w wierszu „Nazwa” zamień adres Name na NameUA i uruchom import.
Dlaczego ilość produktu DC Link nie jest dokładna?
DC Link w cenniku podaje nie sztuki, lecz gwiazdki od jednej do pięciu. Ilość jest liczona według reguł statusu dostępności (więcej).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Przetwarzanie cenników → Lista cenników
- Nowe źródło DC Link
- kreator nowego źródła, krok „Skąd” → kafelek „API” → DC Link
- Dostęp i parametry zapytania
- karta źródła, sekcja „Źródło” → „Ustawienia parametrów API”
- Wysyłanie rezerwacji
- dokument „Zamówienie u dostawcy” → „Wyślij do dostawcy”
- Uprawnienia
- okno „Lista cenników” i „Ustawienia importu: plik z cennikiem”; do rezerwacji — edycja dokumentów
- Przygotuj
- login i hasło do DC Link
Powiązane tematy
- Jeśli chcesz zrozumieć, co program robi z każdym źródłem API i gdzie wpisać dostępy, — Jak podłączyć dostawcę przez API.
- Jeśli po regule gwiazdek statusy nadal są nie te, — Dostępność produktu w cenniku dostawcy.
- Jeśli trzeba wziąć dodatkowy tag DC Link do kolumny, — Mapowanie kolumn cennika.
- Jeśli zamówienie u dostawcy trzeba jeszcze zebrać z zamówień klientów, — Zamówienie u dostawcy.
