Integracja z ERC w Elbuz sama pobiera cennik z cenami dealera, RRP i stanami każdego magazynu — bez plików i e-maili.
Kiedy to się przyda:
- Towar jest Ci wysyłany tylko z jednego magazynu ERC — dostępność i ilość pochodzą z tego magazynu, pozostałe produkty są odrzucane.
- Część produktów ERC sprzedaje się za hrywny, część za dolary — walutę każdego produktu program ustala sam, ceny w hrywnach nie są mnożone przez kurs.
- Ceny trzeba przeliczać po kursie ERC — kurs fakturowania ERC jest wstawiany przed każdym importem.
- Zamówienie u dostawcy trzeba przekazać do ERC — idzie jednym przyciskiem z dokumentu, status i list przewozowy wracają do Elbuz.
Od czego zacząć: poproś menedżera ERC o dostęp do API.
Co potrafi integracja z ERC
- Importuje katalog ERC — nazwy, kody, ceny dealera i RRP, kody kreskowe, gwarancję, wagę i wymiary, zdjęcia. Kolumny są zmapowane z góry.
- Pobiera dostępność i ilość — łączne dla magazynów ERC bez konfiguracji albo tylko dla Twojego magazynu.
- Trzyma ceny w hrywnach i dolarach w jednym cenniku — walutę każdego produktu określa znacznik ERC.
- Przelicza ceny w dolarach po kursie ERC z dnia importu.
- Pobiera parametry i dodatkowe zdjęcia z osobnego serwisu ERC za tokenem.
- Wysyła zamówienie u dostawcy do ERC i pobiera z powrotem status wysyłki oraz numer przesyłki — .
Kategoria i podkategoria ERC przychodzą w każdym produkcie, a dopasowuje się je do Twoich kategorii tak samo jak w każdym cenniku (dopasowanie kategorii).
O co poprosić menedżera ERC
Dostęp do API ERC wydaje nie Elbuz, lecz samo ERC. Według dokumentacji ERC („ERC API. Загальна інструкція” — ogólna instrukcja, wersja 1.40) kolejność jest taka.
- Poproś o dostęp do API swojego opiekuna — dealer-menedżera ERC. Osobnego loginu do API nie ma: logowanie odbywa się tym samym e-mailem i hasłem co do portalu B2B ERC.
- Przekaż menedżerowi stały adres IP, z którego będą szły zapytania: zapytań z innego adresu ERC nie obsługuje. Adres skopiuj z okna parametrów dostępu (gdzie jest podany): różne konta mają różne serwery.
- Jeśli dostępność jest potrzebna z jednego magazynu — ustal jego numer. Numery z dokumentacji są w tabeli poniżej, ale który magazyn działa w ramach Twojej umowy, wie tylko menedżer.
- Opcjonalnie — token serwisu parametrów i zdjęć. W ogólnej instrukcji API ERC tego serwisu nie ma, więc o token też prosi się menedżera (po co).
- Jeśli zamierzasz wysyłać zamówienia — dostęp do tworzenia zamówień przez API. To osobne uprawnienie w ERC: bez niego katalog przychodzi, ale zamówienia ERC odrzuca (błędy 105 i 110).
Które parametry zapytania ERC zmienić
W kreatorze nowego źródła na kroku „Skąd” wybierz kafelek „API” i ERC na liście. Adres serwisu https://connect.erc.ua/connectservice/api/specprice/DoExport, format i kolumny program ustawia sam (co robi powiązanie). W oknie dostępu w „Login” wpisz e-mail portalu B2B, w „Hasło (token)” — hasło do niego.
Na karcie „Parametry zapytania” trzy wiersze dotyczą cennika. Osiem wierszy zaczynających się od „Zamówienie:” jest potrzebnych tylko do wysyłania zamówień.
| Parametr | Domyślnie | Co robi |
|---|---|---|
| „Kod języka” | ua | język nazw i kategorii katalogu; ERC przyjmuje ru, ua, ru-ru, uk-ua |
| „Link do API do importu atrybutów i zdjęć” | puste | adres serwisu parametrów z Twoim tokenem; puste — parametry i zdjęcia nie są pobierane (więcej) |
| „Importuj kursy walut” | 1 | 1 — przed każdym importem pobierać kurs ERC dla cen w dolarach; inna wartość — nie ruszać kursu (więcej) |
1
Link do API do importu atrybutów i zdjęć2
Importuj kursy walut3
Zamówienie: tryb- Link do API do importu atrybutów i zdjęć — wklej tu link ERC ze swoim tokenem, aby pobierać parametry i zdjęcia.
- Importuj kursy walut — włącza stosowanie kursu ERC do cen podanych w dolarach.
- Zamówienie: tryb — ten wiersz i kolejne określają, jak zamówienie jest wysyłane do ERC.
Co przychodzi z ERC i jak liczona jest dostępność
Jedno zapytanie — cały katalog dostępny dla Twojego konta, w XML. Filtrowania po marce, kategorii czy magazynie w zapytaniu nie ma, dlatego filtruje się już przyjęte dane. Na odpowiedź program czeka do 300 sekund.
Kolumny, które powiązanie mapuje samo. W źródłach podłączonych wcześniej zestaw może być krótszy: kolumny ustawiane są raz, w chwili powiązania.
| Tag ERC | Pole w Elbuz | Uwagi |
|---|---|---|
code | „Kod producenta” i identyfikator produktu w cenniku | ERC |
gname | „Nazwa” | |
sprice | „Cena” | cena dealera; waluta — według tagu ddp |
ddp | „Waluta” | 0 — dolar, 1 — hrywna (więcej) |
RRP_UAH | „Cena sugerowana (RRP)” | w hrywnach |
category, { / }, subcategory | „Kategoria z cennika” | kategoria i podkategoria rozdzielone „ / ” |
stock | „Status dostępności (z cennika)” | true lub false: jest stan w którymkolwiek magazynie ERC, niekoniecznie w Twoim |
stock_qty | „Ilość” | suma stanów pełnowartościowego towaru w magazynach; ten tag dopisuje program |
vendor, pic, ean, warr | „Producent”, „Link do zdjęcia produktu”, „Kod kreskowy EAN”, „Gwarancja” | producent w odpowiedzi ERC stoi nad produktami, program przenosi go do każdego produktu |
weight, width, height, depth | waga i wymiary produktu | głębokość ERC trafia do pola długości |
Dostępność domyślnie oznacza „jest gdzieś w ERC”, w tym w magazynie, z którego towar nie zostanie Ci wysłany:
- Status pochodzi z tagu
stock: true staje się „Dostępny”, false — „Brak w magazynie”, bez konfiguracji. Jeśli ERC nie przysłał tagu, program ustawia go sam według sumy magazynów. - Ilość — tag
stock_qty: suma stanów wszystkich magazynów oprócz 44, 55, 100_44 i 100_55 (towar z uszkodzeniami i z uszkodzonym opakowaniem). Przedział>50program liczy jako 50. - Produkt tylko w magazynie przecenionego towaru będzie „Dostępny” z ilością 0:
stockuwzględnia magazyny przecen, astock_qty— nie. Jeśli to przeszkadza, wpisz w wierszu „Status dostępności (z cennika)” adresstock_qty.
Stany poszczególnych magazynów są obok, w bloku whs:
<whs><wh id="1" q="7" /><wh id="44" q="0" /><wh id="100" q=">50" />…</whs>
W id jest numer magazynu, w q — stan minus rezerwacja minus towar w kompletacji. Do 50 włącznie — dokładna liczba, dalej przedział jako tekst: >50 (51–100), >100 (101–300), >300 (301–500), >500 (od 501).
Numery magazynów ERC
Magazyny z dokumentacji API ERC w wersji 1.40. Danych słownikowych z magazynami ERC przez API nie udostępnia, więc z którego magazynu wysyłany jest towar właśnie Tobie, podpowie menedżer; w odpowiedzi może być też inny numer.
Numer w id | Co to jest według dokumentacji ERC | Adres kolumny |
|---|---|---|
| 1 | magazyn 1 | //wh[@id='1']/@q |
| 5 | magazyn oprogramowania | //wh[@id='5']/@q |
| 44 | towar z uszkodzeniami: rysy, niewielkie wgniecenia | //wh[@id='44']/@q |
| 55 | towar z uszkodzonym opakowaniem | //wh[@id='55']/@q |
| 100 | magazyn 100, towar pełnowartościowy | //wh[@id='100']/@q |
| 100_44 | magazyn 100, towar o ograniczonej przydatności | //wh[@id='100_44']/@q |
| 100_55 | magazyn 100, towar z uszkodzonym opakowaniem | //wh[@id='100_55']/@q |
Producent
Nazwa producenta w katalogu ERC stoi raz nad grupą jego produktów, a program przenosi ją do każdego produktu tagiem vendor. Jeśli kolumna „Producent” w produktach cennika jest pusta, wpisz w wierszu „Producent” sekcji „Kolumny” adres vendor i uruchom import.
Jak brać dostępność tylko z jednego magazynu ERC
Potrzebne, gdy towar jest Ci wysyłany tylko z jednego magazynu. W przykładach — magazyn 100; dla swojego zamień liczbę.
Dostępność z jednego magazynu ERC
Krok 1. Adres magazynu w kolumnach
W sekcji „Kolumny” karty źródła w wierszach „Status dostępności (z cennika)” i „Ilość” wpisz w „Adres kolumny” //wh[@id='100']/@q. Jeśli wiersza „Ilość” nie ma, dodaj go przyciskiem „Dodaj pole”.
Program szuka adresu w każdym produkcie osobno, więc każdy produkt dostanie swój stan. Numer zawsze bierz w pojedyncze cudzysłowy: magazyny w rodzaju 100_44 bez nich się nie znajdą. Z przedziałów >50, >100 program zostawia cyfry, więc ilość powyżej 50 to dolna granica: >100 da 100.
1
Adres statusu dostępności2
Adres ilości3
Wiersz Cena z kodem waluty- Adres w wierszu statusu dostępności wskazuje numer magazynu w pojedynczych cudzysłowach.
- Ten sam adres w wierszu Ilość: ilość pochodzi z tego samego magazynu.
- Wiersz Cena ma kod waluty USD, więc stosuje się do niego kurs ERC.
Sam adres wystarczy, by statusy stały się poprawne: liczba od 1 staje się „Dostępny”, zero — „Brak w magazynie”. Ale produkty z zerem zostają w cenniku, a błąd w numerze magazynu przejdzie niezauważony — do tego służy krok 2.
Krok 2. Reguły na zakładce „Dostępność”
Na zakładce „Dostępność” karty źródła dodaj dwie reguły przyciskiem „Dodaj”.
| Reguła | Status | „Wartości dostępności z cennika” | „od” / „do” | Przełączniki | „Kolejność stosowania reguły” |
|---|---|---|---|---|---|
| 1 | „Dostępny” | puste | 1 / 999999 | „Importuj tylko produkty z tym statusem” — włączony | 1 |
| 2 | „Brak w magazynie” | {EMPTY} | puste | „Importuj tylko produkty z tym statusem” i „Ustaw ten status dla wszystkich produktów” — wyłączone | 2 |
1
Importuj tylko produkty z tym statusem2
Wartość {EMPTY}- Pole wyboru w regule Dostępny oznacza, że produkty z zerowym stanem wypadają z cennika.
- Wartość {EMPTY} w regule Brak w magazynie to zabezpieczenie przed błędnym numerem magazynu.
Przed porównaniem program usuwa z q spacje i znaki >, <, =, dlatego >50 trafia do zakresu jako 50. Górną granicę wypełnij obowiązkowo: zakres „od 1 do 0” nie zadziała nigdy. Zakres zamiast listy „1, 2, …, 9”: lista jest porównywana dokładnie i pominie stan 12 czy >50.
Druga reguła to zabezpieczenie przed błędnym numerem magazynu. Jeśli takiego magazynu nie ma w odpowiedzi ERC, adres we wszystkich produktach daje pustą wartość i bez reguły {EMPTY} program ustawia całemu cennikowi „Dostępny” z ilością 0. Z regułą ten sam przebieg daje pusty cennik, a w dzienniku „Gwałtowny spadek liczby produktów (100%)”: błąd widać od razu.
Jeśli potrzebny jest cały katalog ERC, a dostępność tylko z jednego magazynu — nie włączaj w pierwszej regule „Importuj tylko produkty z tym statusem”: produkty z zerem zostaną ze statusem „Brak w magazynie”. Jak przełącznik działa na katalog bazowy — w artykule o statusach dostępności.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Krok 3. Sprawdzenie
Po zmianie adresu uruchom import źródła: wartości dostępności zostają ze starego adresu, dopóki ERC nie odda katalogu na nowo. Przycisk „Określ dostępność produktów” na zakładce „Dostępność” sprawdza reguły na już zaimportowanych wierszach, ale nie zmianę magazynu.
Nad tabelą reguł podpowiedź „Wartości dostępności pobrane z cennika:” pokazuje zapis z ostatniego importu. Dla jednego magazynu są to liczby do 50 i przedziały >50, >100, >300, >500; true i false oznaczają, że adres z kroku 1 się nie zapisał. Na stronę sklepu stany trafią po aktualizacji katalogu bazowego.
Jak nie pomylić się z walutą cen ERC
ERC sprzedaje część produktów za dolary, część — za hrywny, a cena dealera sprice przychodzi w walucie produktu. Którą, mówi tag ddp: 1 — hrywna, 0 — dolar. Tak oficjalnie wyjaśniło ERC; w API zamówień ERC to samo pole nazywa się IsDDP.
Bez konfiguracji ddp program uznaje wszystkie ceny za dolarowe i produkt za 780 UAH trafia do cennika mniej więcej 41 razy droższy. Sprawdź sekcję „Kolumny”: powinien być wiersz „Waluta” z adresem ddp, a wiersz „Cena” — z regułą wielowalutowości dla UAH. Jeśli ich nie ma, skonfiguruj raz:
- Przyciskiem „Dodaj pole” dodaj wiersz „Waluta” i wpisz w „Adres kolumny”
ddp. - W wierszu „Cena” w kolumnie „Waluta” powinno być USD — waluta produktów z
ddp0. Nie EUR: wtedy produkty w dolarach zostaną policzone jak w euro. - W tym samym wierszu kliknij ikonę dolara w kolumnie „Wielowalutowość” — otworzy się „Ustawienia rozpoznawania waluty w cenniku”.
- Przyciskiem „Dodaj walutę” wybierz UAH, w „Tekst do wyszukania” wpisz
1. „Adres kolumny” zostaw pusty, „Kurs waluty” — zero: kurs hrywny program weźmie ze słownika walut. - Uruchom import źródła.
1
Dodaj walutę2
Tekst do wyszukania: 13
Kod waluty UAH- Dodaj walutę: walutę wybiera się z listy, tutaj UAH.
- Tekst do wyszukania 1 — tak ERC oznacza w tagu ddp produkty wyceniane w hrywnach.
- Komórka kodu waluty pokazuje UAH.
Reguła „0 → USD” nie jest obowiązkowa: wszystko, co nie jest 1, idzie w walucie wiersza „Cena”. „Cena sugerowana (RRP)” nie jest tym objęta: RRP_UAH jest zawsze w hrywnach.
Kurs ERC dla cen w dolarach
Gdy „Importuj kursy walut” równa się 1, po otrzymaniu katalogu program osobnym zapytaniem pobiera z ERC kurs fakturowania na dziś (kurs w Kijowie i kurs przyjęcia nie są używane). Kurs zapisuje się w „Kurs waluty” wierszy „Cena” i „Cena sugerowana (RRP)” z walutą USD — widać go w sekcji „Kolumny”.
- ERC nie podało kursu albo kurs na dziś nie jest jeszcze ustalony — zostaje poprzedni.
- ERC odpowiedziało błędem — w dzienniku wiersz „Błąd API dostawcy: …”.
- W słowniku walut nie ma USD — kurs nie zostaje zapisany, w dzienniku „Nie zapisano kursu dostawcy: w słowniku walut brak USD. Kurs: ‹liczba›”.
- Potrzebujesz własnego kursu — ustaw w parametrze 0 i podaj kurs w kolumnach.
Jak otrzymać parametry i zdjęcia ERC
Podstawowy cennik ERC daje nazwę, ceny, dostępność i jedno zdjęcie. Parametry, opis i dodatkowe zdjęcia ERC udostępnia osobnym serwisem za osobnym tokenem — nie tym z pola „Hasło (token)”.
- Poproś menedżera ERC o token — dostęp do serwisu parametrów i zdjęć produktów (
wares.xml). Samodzielnie w panelu go nie znajdziesz. - Złóż link:
https://api.erc.ua/api/erc/wares.xml?token=TWÓJ_TOKEN, token bez spacji. - Wklej link w parametr „Link do API do importu atrybutów i zdjęć” (parametry zapytania).
- Zaimportuj cennik i sprawdź parametry oraz zdjęcia w produktach cennika.
Z linkiem każdy import wysyła drugie zapytanie: grupy parametrów, producent, opis i zdjęcia są przypisywane do produktów cennika po kodzie ERC (code). Pusty parametr niczego nie psuje — katalog, ceny i stany przychodzą pierwszym zapytaniem.
Błędny lub wygasły token też nie zatrzymuje importu: cennik przychodzi, a parametry i zdjęcia są pomijane. W dzienniku jest wtedy wiersz „Błąd API dostawcy: atrybuty i zdjęcia nie zostały zaimportowane (sprawdź token w «Link do API do importu atrybutów i zdjęć»)” z odpowiedzią ERC po dwukropku. Poproś o nowy token i wklej link z nim.
Jak wysłać zamówienie do ERC
Zamówienie u dostawcy utworzone w Elbuz na kontrahenta ERC wysyła się do ERC z samego dokumentu. ERC dostaje prawdziwe zamówienie, dlatego program prosi o potwierdzenie. Wysłać można też niezatwierdzony dokument.
Ustawienia zamówienia
Wiersze „Zamówienie:” na karcie „Parametry zapytania” źródła ERC. Program bierze je z pierwszego aktywnego źródła API kontrahenta, na którego wystawiono dokument. NIP (UA), płatnika i ID umowy pokazuje przycisk „Pobierz dane słownikowe” w tym samym oknie — niczego w ERC nie tworzy.
| Parametr | Domyślnie | Co robi |
|---|---|---|
| „Zamówienie: tryb” | 0 | 0 — odbiór osobisty z magazynu ERC, 1 — dropshipping: ERC wysyła towar Twojemu klientowi z listem przewozowym z dokumentu |
| „Zamówienie: magazyn ERC” | 1 | magazyn, z którego ERC kompletuje zamówienie: 1 lub 5 |
| „Zamówienie: autorezerwacja” | 0 | 1 — ERC od razu rezerwuje towar w granicach wolnego stanu |
| „Zamówienie: dokumenty księgowe” | 0 | 1 — ERC wystawia dokumenty księgowe; potrzebne są rozszerzony dostęp ERC i płatnik |
| „Zamówienie: płatnik (ID)” | puste | ID płatnika z danych słownikowych |
| „Zamówienie: kod EDRPOU płatnika” | puste | zamiast ID płatnika można podać jego kod EDRPOU (ukraiński numer identyfikacyjny firmy) |
| „Zamówienie: NIP (UA) odbiorcy” | puste | obowiązkowy przy odbiorze osobistym; pochodzi z danych słownikowych |
| „Zamówienie: umowa (ID)” | puste | opcjonalny; ID umowy z danych słownikowych |
Wysyłanie
Otwórz dokument „Zamówienie u dostawcy”, kliknij „Wyślij do dostawcy” i potwierdź. Wynik pojawia się w komunikacie i zapisuje się w historii dokumentu.
1
Wyślij do dostawcy2
Odśwież status od dostawcy3
Niezatwierdzony- Wyślij do dostawcy — po potwierdzeniu wysyła zamówienie do ERC.
- Odśwież status od dostawcy — pobiera z ERC status i numer przesyłki.
- Niezatwierdzony — zamówienie można wysłać jeszcze przed zatwierdzeniem.
Program niczego nie wysyła, jeśli:
- pozycja nie ma kodu ERC — produkt nie jest dopasowany do cennika ERC; nazwy takich pozycji są w komunikacie;
- w trybie dropshippingu numer listu przewozowego w dokumencie jest pusty;
- w trybie odbioru osobistego nie wypełniono „Zamówienie: NIP (UA) odbiorcy”;
- włączono dokumenty księgowe, a płatnika nie podano ani przez ID, ani przez kod EDRPOU;
- w dokumencie nie ma pozycji z ilością większą od zera.
- Pozycje z takim samym kodem ERC łączą się w jeden wiersz zamówienia.
- Dropshipping. List przewozowy tworzysz sam, jak dla każdej wysyłki z dokumentu; do ERC idzie tylko jego numer.
- Ponowne wysłanie nie tworzy duplikatu. Jeśli w ERC jest już zamówienie z numerem tego dokumentu, nowe nie powstaje, a przychodzi „Zamówienie o tym numerze już istnieje w ERC — nie utworzono ponownie.”. Dlatego dwa dokumenty z tym samym numerem ERC uzna za jedno zamówienie.
- „Do akceptacji” to nie błąd. Zamówienie zostało utworzone, komunikat jest żółty — „Zamówienie w ERC czeka na akceptację: …”, status dokumentu od dostawcy — „Do akceptacji”. Dalej akceptacja odbywa się po stronie ERC.
Status i list przewozowy od ERC
Status nie odświeża się sam — tylko pozycją „Odśwież status od dostawcy” w menu obok przycisku wysyłki. W komunikacie jest numer zamówienia w ERC i ile wysłano z zamówionego. Po wysyłce status od dostawcy zmienia się na „Wysłano częściowo” lub „Wysłano”. Numer listu przewozowego od ERC zapisuje się w dokumencie, jeśli jest tam pusty.
Gdy ERC odrzuca zamówienie
Odmowę ERC widać w komunikacie: kod i tekst błędu. Najczęstsze według dokumentacji ERC:
| Kod | Tekst ERC | Co zrobić |
|---|---|---|
| 105 | Заборонено доступ до режиму автоматичного формування замовлень (brak dostępu do trybu automatycznego tworzenia zamówień) | poproś menedżera ERC o uprawnienie do zamówień przez API |
| 106 | Неправильний IP, операція заборонена (nieprawidłowy , operacja zabroniona) | przekaż menedżerowi ERC adres IP z okna parametrów dostępu |
| 110 | Створення замовлення заблоковано (tworzenie zamówienia zablokowane) | ustal z menedżerem ERC przyczynę blokady |
| 125 | Не вказано ІПН вантажоодержувача або декларацію (nie podano NIP odbiorcy ani listu przewozowego) | wypełnij NIP (UA) przy odbiorze osobistym albo list przewozowy przy dropshippingu |
Scenariusze
Magazyn, z którego brano towar, przestał wysyłać
Co zrobić. Ustal z menedżerem ERC numer nowego magazynu. W wierszach „Status dostępności (z cennika)” i „Ilość” ustaw //wh[@id='‹numer›']/@q, na zakładce „Dostępność” — dwie reguły z kroku 2. Uruchom import.
Efekt. W cenniku zostaną tylko produkty, których w nowym magazynie jest więcej niż zero, z ilością z tego magazynu. Reszta zniknie z cennika przy tym samym imporcie.
Potrzebny jest cały asortyment ERC, a dostępność — z jednego magazynu
Co zrobić. To samo co wyżej, ale w pierwszej regule nie włączaj „Importuj tylko produkty z tym statusem”.
Efekt. Wszystkie produkty katalogu ERC są w cenniku: ze stanem w Twoim magazynie — „Dostępny”, bez niego — „Brak w magazynie”. Stany innych magazynów nie są doliczane do Twojego.
Ceny w hrywnach po kursie ERC
Co zrobić. Zostaw „Importuj kursy walut” = 1, w sekcji „Kolumny” — dolar w wierszu „Cena” i walutę według ddp, jak w rozdziale o walucie.
Efekt. Przed każdym importem ceny w dolarach są przeliczane po kursie fakturowania ERC z bieżącego dnia, ceny w hrywnach zostają bez zmian.
Co zrobić, gdy cennik ERC nie dotarł albo dostępność jest błędna
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Dostępne są produkty, których w Twoim magazynie nie ma | Dostępność pochodzi z tagu stock: „jest w którymkolwiek magazynie” |
Wpisz adres swojego magazynu (krok 1) |
| Po zmianie magazynu wszystkie produkty są „Dostępny” z ilością 0 | Magazynu o takim numerze nie ma w odpowiedzi, żaden wiersz nie został rozpoznany | Sprawdź numer i cudzysłowy w adresie, dodaj regułę {EMPTY} (krok 2) |
| Cennik się opróżnił, w dzienniku „Gwałtowny spadek liczby produktów (100%)” | Błędny numer magazynu przy regule {EMPTY} i przełączniku „tylko produkty z tym statusem” |
Ustal numer magazynu z menedżerem ERC i sprawdź cudzysłowy w adresie (numery magazynów) |
| Zniknęły produkty z dużym stanem, zostały te z małym | W regule jest lista „1, …, 9” z dokładnym porównaniem | Zamień listę na zakres od 1 do 999999 (krok 2) |
| Reguła z zakresem niczego nie rozpoznaje | Wypełnione jest tylko „od”, w „do” jest zero | Ustaw „do” na 999999 |
| Ilość w cenniku jest równo o 100 większa niż stan (7 stało się 107) | W źródle nie ma wiersza „Ilość” i do liczby doliczana jest „Domyślna ilość” statusu (więcej) | Dodaj wiersz „Ilość” z adresem stock_qty albo adresem swojego magazynu |
| W dawno podłączonym źródle ilość to true lub false | W wierszu „Ilość” jest adres stock |
Zamień adres na stock_qty |
| „Błąd API dostawcy: 106 Неправильний IP, операція заборонена…” | ERC nie zna adresu IP, z którego idzie zapytanie | Przekaż menedżerowi ERC adres IP z okna parametrów dostępu (o co poprosić ERC) |
Gdy katalog nie dotarł: kody błędów ERC
Jeśli serwer ERC jest niedostępny, w dzienniku importu pojawi się „Błąd API dostawcy: cURL Error #:…” z przyczyną po stronie sieci. Jeśli ERC odmówiło, wiersz jest ten sam, a po dwukropku — kod i tekst ERC:
| Kod | Tekst ERC | Co zrobić |
|---|---|---|
| 103 | Не вказано email або пароль (pass) (nie podano e-maila lub hasła) | wypełnij „Login” i „Hasło (token)” w oknie parametrów dostępu |
| 104 | Користувача не знайдено (nie znaleziono użytkownika) | sprawdź e-mail i hasło portalu B2B |
| 106 | Неправильний IP, операція заборонена (nieprawidłowy IP, operacja zabroniona) | przekaż menedżerowi ERC adres IP z okna parametrów dostępu |
| 107 | У вас немає доступу для цієї операції (brak dostępu do tej operacji) | poproś menedżera ERC o dostęp do API |
W obu przypadkach przebieg idzie na poprzednim pliku: ceny i dostępność nie są świeże (dlaczego tak jest).
Najczęstsze pytania
Czy można wybrać magazyn ERC w parametrach API?
Nie. W API ERC nie ma parametru magazynu, katalog przychodzi ze wszystkimi magazynami. Magazyn wybiera się adresem kolumny — jak brać dostępność z jednego magazynu.
Dlaczego ilość produktu to 50 albo 100, choć w magazynie ERC jest więcej?
Powyżej 50 sztuk ERC podaje nie liczbę, lecz przedział: „>50”, „>100”, „>300”, „>500”. Program zostawia cyfry, więc ilość to dolna granica: „>100” oznacza od 101 do 300 sztuk, a w cenniku będzie 100.
Czy można zsumować stany dwóch wybranych magazynów?
Nie. Ilość to albo suma wszystkich magazynów pełnowartościowego towaru (stock_qty), albo jeden magazyn wskazany adresem kolumny.
Czy można importować z ERC tylko wybrane marki lub kategorie?
Po stronie ERC — nie, katalog przychodzi w całości. Zbędne odrzuca się już w Elbuz regułami ignorowania.
Po zmianie magazynu dostępność w cenniku jest stara. Dlaczego?
Wartości dostępności są pobierane z pliku podczas importu. Uruchom import źródła ponownie; przycisk „Określ dostępność produktów” przelicza tylko już zaimportowane wartości (sprawdzenie).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Przetwarzanie cenników → Lista cenników
- Nowe źródło ERC
- kreator nowego źródła, krok „Skąd” → kafelek „API” → ERC
- Dostęp i parametry zapytania
- karta źródła, sekcja „Źródło” → „Ustawienia parametrów API”
- Dostępność i ilość
- karta źródła: sekcja „Kolumny” i zakładka „Dostępność”
- Wysyłanie zamówienia
- dokument „Zamówienie u dostawcy” → „Wyślij do dostawcy”
- Uprawnienia
- okno „Lista cenników” i „Ustawienia importu: plik z cennikiem”
- Przygotuj
- dostęp do od menedżera ERC, e-mail i hasło portalu B2B ERC
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 statusy dostępności są rozpoznawane nie tak, jak trzeba, — Dostępność produktu w cenniku dostawcy.
- Jeśli trzeba zmienić adres kolumny albo dodać pole — Mapowanie kolumn cennika.
- Jeśli cennik ERC się zaimportował, a ceny w sklepie są stare, — Jak uruchomić import cennika i przenieść ceny do katalogu.
