Elbuz sam pobiera z portalu Yug-Contract B2B (Юг-Контракт) cennik z ceną dealera, RRP, dostępnością i zdjęciami, a w razie potrzeby — pełne karty produktów.
Kiedy to się przyda:
- Ceny mają trafiać do katalogu bez przeliczania — cena dealera i RRP są już w hrywnach.
- Produkty trzeba dodawać do katalogu z opisem i zdjęciami — karty pobierane są całymi kategoriami i przechowywane między importami.
- Trzeba odróżnić „oczekiwany” i „na zapytanie” od niedostępnych — kod stanu z cennika przekłada się na Twoje statusy.
- Zamówienie u dostawcy trzeba zarezerwować w Yug-Contract — wychodzi z dokumentu, ponowne wysłanie nie tworzy duplikatu.
Od czego zacząć: wygeneruj klucz API w panelu Yug-Contract i dodaj adres IP Elbuz.
Co potrafi integracja z Yug-Contract
- Importuje cennik Yug-Contract — kod, numer katalogowy, nazwę po ukraińsku, markę, kod kreskowy, cenę dealera i RRP, gwarancję, wagę, kategorię, dostępność, zdjęcie, krótki opis i link do produktu.
- Uzupełnia pełne karty produktów — opis HTML, wszystkie atrybuty i wszystkie zdjęcia.
- Rozróżnia stany dostępności — dostępny, w rezerwacji, oczekiwany, na zapytanie.
- Wysyła zamówienie do Yug-Contract z dokumentu: Yug-Contract tworzy zamówienie i rezerwuje towar.
Klucz API i dozwolony adres IP w panelu Yug-Contract
- Klucz i sekret API. W panelu Yug-Contract otwórz ustawienia API („Налаштування API”) i kliknij „Wygeneruj” („Згенерувати”) — pojawi się nowa para kluczy. Klucz wpisz w „Login”, sekret — w „Hasło (token)”.
- Adres IP Elbuz na liście dozwolonych. Yug-Contract wpuszcza do API tylko z adresów dodanych w tym samym dziale ustawień API. Adres skopiuj z okna parametrów dostępu źródła, z wiersza „Adres IP serwera Elbuz Jumper, który należy przekazać dostawcy, aby nadał dostęp:” (gdzie dokładnie).
Bez tych dwóch kroków Yug-Contract odmawia z błędem 403 (gdy cennik nie dotarł).
Jakie parametry zapytania Yug-Contract ustawić
W kreatorze nowego źródła na kroku „Skąd” wybierz kafelek „API” i Yug-Contract. Adres https://b2b.yugcontract.ua/api/, format i kolumny program ustawia sam (co robi powiązanie). Przycisk „Pobierz dane słownikowe” pokazuje dla Yug-Contract tylko „Ta integracja nie ma danych słownikowych…”: kody kontrahentów i umów do zamówienia znajdziesz w panelu Yug-Contract, w dziale API, w opisie metody post-order.
| Parametr | Domyślnie | Co robi |
|---|---|---|
| „Pełne karty produktów” | 1 | 1 — opis HTML, atrybuty i wszystkie zdjęcia z Yug-Contract (więcej); 0 — tylko cennik |
| „Łącz wartości parametrów” | 1 | 1 — atrybuty o tej samej nazwie stają się jednym: „Gniazdo: 1156 / 2011 / AM4” zamiast trzech wierszy; 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 |
| „Zamówienie: płatność” | cash | cash — gotówka, bank — przelew; na tej podstawie Yug-Contract wybiera umowę, jeśli nie jest ustawiona |
| „Zamówienie: priorytet magazynów” | 0 | 0 — najpierw magazyn regionalny, potem Kijów; 1 — najpierw Kijów, potem region; 2 — tylko Kijów. Działa, jeśli w panelu Yug-Contract ta funkcja jest włączona |
| „Zamówienie: kontrahent (ID)” | puste | kod kontrahenta w Yug-Contract; puste — Yug-Contract ustali sam |
| „Zamówienie: umowa (ID)” | puste | kod umowy; puste — Yug-Contract ustali sam według rodzaju płatności |
1
Pełne karty produktów2
Zamówienie: płatność3
Zamówienie: priorytet magazynów- Pełne karty produktów — 1 pobiera z Yug-Contract opis, atrybuty i zdjęcia; 0 ich nie importuje.
- Zamówienie: płatność — cash to gotówka, bank to przelew.
- Zamówienie: priorytet magazynów — 0 oznacza najpierw magazyn regionalny, potem Kijów.
W źródłach podłączonych wcześniej „Pełne karty produktów” są wyłączone (0). W nowych źródłach karty są włączone od razu.
Co przychodzi z Yug-Contract: kolumny według numerów
Yug-Contract przekazuje cennik przez API, a program składa z niego plik CSV: każdy produkt to wiersz, każde pole — kolumna o numerze. Kolumny, które powiązanie mapuje samo:
| Kolumna | Co w niej jest | Pole w Elbuz |
|---|---|---|
| 1, 2 | kategoria i podgrupa Yug-Contract | „Kategoria z cennika” (dwie kolumny razem) |
| 5 | marka | „Producent” |
| 6 | kod produktu Yug-Contract | „Kod kontrahenta” i „ID produktu (ciąg UUID)” — według niego produkt trafia do zamówienia, a atrybuty i zdjęcia kart wiążą się z produktem |
| 7 | nazwa po ukraińsku | „Nazwa” |
| 8 | cena dealera, UAH | „Cena” |
| 10 | RRP, UAH | „Cena sugerowana (RRP)” |
| 13 | stan | „Status dostępności (z cennika)” (dostępność) |
| 14 | numer katalogowy | „Kod producenta” |
| 15 | kod kreskowy | „Kod kreskowy EAN” |
| 21 | gwarancja | „Gwarancja” |
| 24 | waga | „Waga” |
| 27 | krótki opis | „Krótki opis” |
| 28 | link do strony produktu w panelu Yug-Contract | „Link do produktu (URL)” |
| 29 | zdjęcie | „Link do zdjęcia produktu” |
| 30 | pełny opis z karty | „Pełny opis” (wypełnia się, gdy włączone są pełne karty) |
Pozostałe kolumny weźmiesz wolnym wierszem sekcji „Kolumny”, wpisując numer w „Adres kolumny”:
- 3 i 4 — kody podgrupy i kategorii; 12 — kod stanu dostępności;
- 9 — cena za minimalne opakowanie; 11 — kontrolna RRP; 18 — cena bez VAT; 19 i 20 — stawka VAT;
- 16 — nazwa po angielsku; 17 — stan (Новий albo ДУ); 22 — kraj; 23 — ukraiński kod celny UKT ZED;
- 25 — waga minimalnego opakowania; 26 — objętość.
Cena i RRP w hrywnach
Cena dealera (kolumna 8) i RRP (sugerowana cena detaliczna, kolumna 10) są w Yug-Contract w hrywnach, więc w wierszach „Cena” i „Cena sugerowana (RRP)” musi być UAH; nowe źródła mapują się tak same. Kursu Yug-Contract nie przekazuje, niczego przeliczać nie trzeba.
Kolumna 11 to kontrolna RRP: kwota, poniżej której Yug-Contract prosi nie sprzedawać produktu; 0 — brak kontroli. Cennik przychodzi z produktami w stanie „Новий” (nowy) i „ДУ”, produktów przecenionych w nim nie ma.
1
Cena2
Status dostępności (z cennika)3
Link do zdjęcia produktu4
Pełny opis- Cena — adres 8: cena dealera w hrywnach.
- Status dostępności (z cennika) — adres 13: stan w przedziałach.
- Link do zdjęcia produktu — adres 29: zdjęcie z cennika.
- Pełny opis — adres 30: opis do karty produktu.
Jak otrzymać pełne karty produktów Yug-Contract
W cenniku Yug-Contract daje jedno zdjęcie i krótki opis. Pełne karty przekazuje osobno, i to nie po produkcie, a całymi kategoriami. Dlatego program działa tak:
- Prosi tylko o potrzebne kategorie — te, w których jest produkt bez karty albo z kartą starszą niż 30 dni. Za pierwszym razem to prawie cały katalog, kilka minut; potem — zwykle żadna kategoria.
- Przechowuje karty oddzielnie od cennika. Przycisk „Importuj” ich nie usuwa.
- Pobiera karty tylko dla produktów dostępnych i w rezerwacji. Produkty „oczekiwane” i „na zapytanie” przychodzą bez kart.
- Zapamiętuje brak karty. O takie produkty program nie pyta ponownie przez 30 dni, a zdjęcie bierze im z cennika.
- Aktualizuje karty raz na 30 dni. Listy zmian Yug-Contract nie przekazuje, więc karta poprawiona wczoraj zaktualizuje się, gdy minie jej 30 dni.
Jak włączyć
- Włącz karty: w parametrach zapytania w wierszu „Pełne karty produktów” wpisz
1. Osobne logowanie nie jest potrzebne: karty pobierane są tym samym kluczem. - Opcjonalnie — jak pokazywać atrybuty: „Łącz wartości parametrów” i „Separator wartości parametrów”. Po zmianie zaimportuj cennik jeszcze raz, karty nie pobierają się od nowa.
- Zaimportuj cennik przyciskiem „Importuj”. Gdy program dopytuje o karty, w dzienniku pojawia się „Pełne karty Yug-Contract: zapytanie dla kategorii: ‹ile›”.
- Sprawdź opis, atrybuty i zdjęcia w produktach cennika.
| Dane z karty Yug-Contract | Gdzie w cenniku |
|---|---|
| pełny opis (ze znacznikami HTML) | „Pełny opis” — kolumna 30 |
| wszystkie zdjęcia | zdjęcia produktu w cenniku |
| wszystkie atrybuty | atrybuty produktu w cenniku |
Zdjęcia i atrybuty wiążą się według kodu Yug-Contract (kolumna 6), osobne adresy kolumn nie są potrzebne. Produkt z kartą dostaje wszystkie jej zdjęcia, pozostałe — jedno zdjęcie z kolumny 29.
Przy dodawaniu produktu z cennika do katalogu bazowego karta przychodzi wypełniona (atrybuty produktów, zdjęcia produktów). Jeśli Yug-Contract nie przekazał kart, w dzienniku jest „Nie otrzymano pełnych kart Yug-Contract (…) — cennik jest importowany z wcześniej zapisanymi kartami”; nowe zostaną dobrane następnym razem.
Jak odróżnić „oczekiwany” i „na zapytanie”
Powiązanie bierze dostępność z kolumny 13 — stanu. Dokładnych sztuk tam nie ma: Yug-Contract podaje stan stopniami (1, 2 … 10, 50, 100, 500), a większy od zera jest tylko u produktów dostępnych. Produkty „w rezerwacji”, „oczekiwane” i „na zapytanie” mają stan 0. Standardowe statusy rozpoznają to bez ustawień: od 1 — „Dostępny”, 0 — „Brak w magazynie”.
Aby rozróżniać stany, weź kod stanu z kolumny 12:
| Kod | Stan w Yug-Contract |
|---|---|
| 0 | brak |
| 1 | dostępny |
| 2 | w rezerwacji |
| 3 | oczekiwany |
| 4 | na zapytanie |
Ustaw w wierszu „Status dostępności (z cennika)” adres 12 i dodaj reguły dla potrzebnych statusów w zakładce „Dostępność” źródła (dostępność produktu w cenniku dostawcy). Bez własnych reguł kody 2, 3 i 4 — jak każda liczba od 1 — staną się „Dostępny”.
Wiersza „Ilość” powiązanie nie mapuje. Jeśli wpiszesz tam 13, ilość będzie stopniem, a nie dokładną liczbą.
Jak wysłać zamówienie do Yug-Contract z rezerwacją
Zamówienie u dostawcy utworzone w Elbuz na kontrahenta Yug-Contract wysyłasz z dokumentu; Yug-Contract tworzy prawdziwe zamówienie i rezerwuje towar. Ustawienia to wiersze „Zamówienie: …” w parametrach zapytania; program bierze je z pierwszego aktywnego źródła API kontrahenta dokumentu.
Co się dzieje po kliknięciu
Otwórz dokument „Zamówienie do dostawcy”, kliknij „Wyślij do dostawcy” i potwierdź. Program:
- sprawdza, czy w Yug-Contract nie ma już zamówienia z tego dokumentu;
- wysyła pozycje według kodu Yug-Contract; takie same produkty łączą się w jeden wiersz;
- przekazuje wewnętrzny dokumentu Elbuz (po nim Yug-Contract później znajduje to zamówienie), komentarz „Elbuz ‹numer dokumentu›”, rodzaj płatności i priorytet magazynów, a kontrahenta i umowę — tylko jeśli są ustawione.
Numer zamówienia Yug-Contract zapisuje się w dokumencie, status od dostawcy to „Rezerwacja”, a wynik widać w komunikacie i historii dokumentu.
1
Wyślij do dostawcy2
Odśwież status od dostawcy- Wyślij do dostawcy — składa u dostawcy zamówienie z rezerwacją.
- Odśwież status od dostawcy — pokazuje, ile jest w rezerwacji.
Gdy nie wszystko zostało zarezerwowane
Zamówienie tworzy się, nawet jeśli części towaru Yug-Contract nie zarezerwował. Program wymienia takie pozycje po słowie „Uwaga:”, a status od dostawcy to „Rezerwacja częściowa”:
- „‹produkt› — zarezerwowano ‹ile› z ‹ile›” — towaru w magazynach zabrakło;
- „‹produkt› — Yug-Contract nie znalazł produktu po kodzie, nie dodano do zamówienia” — dopasuj produkt do aktualnego cennika.
Domówienie i zamianę brakujących pozycji zrób w panelu Yug-Contract albo osobnym dokumentem.
Gdy nic się nie wysyła
- pozycja nie ma kodu Yug-Contract — produkt nie jest dopasowany do cennika; nazwy takich pozycji są w komunikacie (dopasowanie produktów);
- w dokumencie nie ma pozycji z ilością większą od zera;
- Yug-Contract nie wpuścił programu — błędny klucz albo sekret lub adresu IP nie ma wśród dozwolonych (komunikat z „403”).
Ponowne kliknięcie nie tworzy drugiego zamówienia. Yug-Contract rozpoznaje zamówienie po ID dokumentu Elbuz, więc kolejne kliknięcie pokazuje „Zamówienie już istnieje w Yug-Contract — nie utworzono ponownie.” i stan istniejącego zamówienia.
Stan zamówienia
Stan nie aktualizuje się sam — tylko pozycją „Odśwież status od dostawcy” w menu obok przycisku wysyłki. Pokazuje ona „Yug-Contract: zamówienie ‹numer›, zarezerwowano ‹ile› szt.”, a status od dostawcy to „Rezerwacja” albo „Bez rezerwacji”, jeśli w rezerwacji nic nie zostało.
Wysyłkę zamówienia sprawdziliśmy na symulacji serwera Yug-Contract, a nie na prawdziwym zamówieniu. Pierwsze zamówienie wyślij niewielkie i porównaj wynik w panelu.
Scenariusze
Dodawać produkty Yug-Contract do katalogu od razu z opisem i zdjęciami
Co zrobić. „Pełne karty produktów” = 1, import źródła, a potem dodawanie produktów z cennika do katalogu bazowego jak zwykle.
Efekt. Nowe produkty w katalogu dostają opis, atrybuty i zdjęcia z Yug-Contract. Kolejne importy aktualizują ceny i dostępność i dobierają karty dla nowych produktów.
Nie sprzedawać poniżej kontrolnej RRP
Co zrobić. W sekcji „Kolumny” dodaj wolny wiersz z adresem 11. Wiersz „Cena sugerowana (RRP)” zostaw z adresem 10: kontrolną RRP ma daleko nie każdy produkt.
Efekt. W cenniku pojawi się kontrolna RRP Yug-Contract; 0 oznacza, że dla produktu nie ma kontroli.
Zamówienie przelewem na konkretną umowę
Co zrobić. W parametrach API ustaw „Zamówienie: płatność” = bank, a w „Zamówienie: umowa (ID)” — kod umowy z panelu Yug-Contract.
Efekt. Zamówienia z Elbuz tworzą się na tę umowę z płatnością przelewem.
Co zrobić, gdy Yug-Contract odpowiada 403 albo cennik jest niepełny
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Błąd API dostawcy: Yugcontract auth: 403 Error: Forbidden” | Błędny klucz albo sekret, nowa para kluczy nie jest wpisana w źródło albo adresu IP Elbuz nie ma na liście dozwolonych | Sprawdzić klucz i sekret, dodać adres IP z okna parametrów dostępu w ustawieniach API panelu (klucz i IP) |
| Źródło jest podłączone dawno, a w cenniku nie ma zdjęć ani opisów | Kolumny 27–30 i klucz produktu nie były wcześniej mapowane w starych źródłach | Zaimportować cennik jeszcze raz; w razie potrzeby włączyć „Pełne karty produktów” |
| Produkty „oczekiwane” i „na zapytanie” idą jako „Brak w magazynie” | Dostępność pochodzi ze stanu, a u nich wynosi on 0 | Brać stan z kolumny 12 i dodać własne reguły (dostępność) |
| Status „Rezerwacja częściowa” | Części pozycji Yug-Contract nie zarezerwował albo nie znalazł — lista jest po „Uwaga:” | Domówić brakujące w panelu albo osobnym zamówieniem (gdy nie wszystko zostało zarezerwowane) |
| „Pozycje bez kodu Yug-Contract…” | Produkt z dokumentu nie jest dopasowany do cennika Yug-Contract | Dopasować produkt do cennika Yug-Contract (dopasowanie produktów) |
Gdy cennik nie dotarł
Yug-Contract przygotowuje cennik dłużej niż większość dostawców — do kilku minut, a pierwszy import z kartami jeszcze dłużej. W dzienniku pracę z nim widać po wierszach „Pobieramy plik przez API”, „Łączenie z serwerem API” i „Otrzymano plik: ‹rozmiar› MB”.
Przy błędnym kluczu albo braku adresu IP Elbuz w dzienniku jest „Błąd API dostawcy: Yugcontract auth: 403 Error: Forbidden”, a po nim „Nie otrzymano nowego pliku do importu, używany jest poprzedni”. Ceny i dostępność zostają wtedy wczorajsze (dlaczego tak jest).
Najczęstsze pytania
Dlaczego Yug-Contract odpowiada 403?
Yug-Contract wpuszcza do API tylko z adresów IP dodanych w ustawieniach API jego panelu i tylko z ważną parą kluczy. Dodaj adres z okna parametrów dostępu i sprawdź, czy w źródle są klucz i sekret z ostatnio wygenerowanej pary.
Czy zdjęcia przyjdą bez pełnych kart?
Tak, jedno zdjęcie na produkt — z kolumny zdjęcia w cenniku. Z pełnymi kartami produkt, który ma kartę, dostaje wszystkie jej zdjęcia.
Czy powstanie duplikat, jeśli kliknę „Wyślij do dostawcy” dwa razy?
Nie. Yug-Contract rozpoznaje zamówienie po ID dokumentu Elbuz, więc kolejne kliknięcie tylko pokaże stan istniejącego zamówienia.
Czy można potwierdzić wysyłkę albo usunąć zamówienie Yug-Contract z Elbuz?
Nie. Dostawę, potwierdzenie wysyłki i usunięcie zamówienia załatwia się w panelu Yug-Contract.
Czy można importować przecenione produkty Yug-Contract?
Nie. Cennik przez API zawiera tylko produkty w stanie „Новий” (nowy) i „ДУ”.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Przetwarzanie cenników → Lista cenników
- Nowe źródło Yug-Contract
- kreator nowego źródła, krok „Skąd” → kafelek „API” → Yug-Contract
- Dostęp i parametry zapytania
- karta źródła, sekcja „Źródło” → „Ustawienia parametrów API”
- Wysyłka zamówienia
- dokument „Zamówienie do dostawcy” → „Wyślij do dostawcy”
- Uprawnienia
- okno „Lista cenników” i „Ustawienia importu: plik z cennikiem”; do zamówienia — edycja dokumentów
- Przygotuj
- klucz i sekret z panelu Yug-Contract, adres IP Elbuz na liście dozwolonych
Powiązane tematy
- Jeśli chcesz zrozumieć, co program robi z dowolnym źródłem API i gdzie wpisać dane dostępu — Jak podłączyć dostawcę przez API.
- Jeśli stany z kolumny 12 trzeba przełożyć na własne statusy — Dostępność produktu w cenniku dostawcy.
- Jeśli chcesz wziąć dodatkową kolumnę Yug-Contract — Mapowanie kolumn cennika.
- Jeśli zamówienie u dostawcy trzeba jeszcze zebrać z zamówień klientów — Zamówienie u dostawcy.
