↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć Yug-Contract przez API: klucz, dozwolony IP, karty i rezerwacja

    6 min czytaniaZaktualizowano

    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

    Klucz API i dozwolony adres IP w panelu Yug-Contract

    1. 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)”.
    2. 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.

    ParametrDomyślnieCo robi
    „Pełne karty produktów”11 — opis HTML, atrybuty i wszystkie zdjęcia z Yug-Contract (więcej); 0 — tylko cennik
    „Łącz wartości parametrów”11 — 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ść”cashcash — gotówka, bank — przelew; na tej podstawie Yug-Contract wybiera umowę, jeśli nie jest ustawiona
    „Zamówienie: priorytet magazynów”00 — 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)”pustekod kontrahenta w Yug-Contract; puste — Yug-Contract ustali sam
    „Zamówienie: umowa (ID)”pustekod umowy; puste — Yug-Contract ustali sam według rodzaju płatności
    Okno ustawień dostępu do API: karta „Parametry zapytania”
    1Pełne karty produktów
    2Zamówienie: płatność
    3Zamówienie: priorytet magazynów
    1. Pełne karty produktów — 1 pobiera z Yug-Contract opis, atrybuty i zdjęcia; 0 ich nie importuje.
    2. Zamówienie: płatność — cash to gotówka, bank to przelew.
    3. 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:

    KolumnaCo w niej jestPole w Elbuz
    1, 2kategoria i podgrupa Yug-Contract„Kategoria z cennika” (dwie kolumny razem)
    5marka„Producent”
    6kod 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
    7nazwa po ukraińsku„Nazwa”
    8cena dealera, UAH„Cena”
    10RRP, UAH„Cena sugerowana (RRP)”
    13stan„Status dostępności (z cennika)” (dostępność)
    14numer katalogowy„Kod producenta”
    15kod kreskowy„Kod kreskowy EAN”
    21gwarancja„Gwarancja”
    24waga„Waga”
    27krótki opis„Krótki opis”
    28link do strony produktu w panelu Yug-Contract„Link do produktu (URL)”
    29zdjęcie„Link do zdjęcia produktu”
    30peł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.

    Tabela mapowania kolumn źródła API dostawcy: nazwy pól i adresy ich kolumn
    1Cena
    2Status dostępności (z cennika)
    3Link do zdjęcia produktu
    4Pełny opis
    1. Cena — adres 8: cena dealera w hrywnach.
    2. Status dostępności (z cennika) — adres 13: stan w przedziałach.
    3. Link do zdjęcia produktu — adres 29: zdjęcie z cennika.
    4. 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ć

    1. 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.
    2. 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.
    3. Zaimportuj cennik przyciskiem „Importuj”. Gdy program dopytuje o karty, w dzienniku pojawia się „Pełne karty Yug-Contract: zapytanie dla kategorii: ‹ile›”.
    4. Sprawdź opis, atrybuty i zdjęcia w produktach cennika.
    Dane z karty Yug-ContractGdzie w cenniku
    pełny opis (ze znacznikami HTML)„Pełny opis” — kolumna 30
    wszystkie zdjęciazdjęcia produktu w cenniku
    wszystkie atrybutyatrybuty 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:

    KodStan w Yug-Contract
    0brak
    1dostępny
    2w rezerwacji
    3oczekiwany
    4na 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:

    1. sprawdza, czy w Yug-Contract nie ma już zamówienia z tego dokumentu;
    2. wysyła pozycje według kodu Yug-Contract; takie same produkty łączą się w jeden wiersz;
    3. 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.

    Okno zamówienia do dostawcy z otwartym menu strzałki obok przycisku „Wyślij do dostawcy”
    1Wyślij do dostawcy
    2Odśwież status od dostawcy
    1. Wyślij do dostawcy — składa u dostawcy zamówienie z rezerwacją.
    2. 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

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo