Integracje z przewoźnikami

Jak połączyć Speedy z easySales: kompletny poradnik konfiguracji

Jak połączyć Speedy z easySales: kompletny poradnik konfiguracji

Połącz Speedy z easySales: dane API i Pobierz szczegóły, kontrakt i punkt odbioru, trzy kody usług, usługi dodatkowe i ubezpieczenie, etykiety za granicę oraz komunikaty błędów Speedy.

Co daje Ci połączenie ze Speedy

Po podłączeniu Speedy easySales tworzy etykiety Speedy dla Twoich zamówień — pojedynczo lub hurtowo — drukuje je, śledzi każdą paczkę i anuluje etykietę, której już nie potrzebujesz, bez otwierania aplikacji Speedy. Speedy odbiera paczki w Bułgarii, więc ta integracja jest dla paczek wysyłanych z adresu w Bułgarii — do Bułgarii lub za granicę.

O tym, czy etykieta w ogóle powstanie, decydują dwie rzeczy: pozycja wybrana w polu Kontrakt po kliknięciu Pobierz szczegóły oraz trzy kody usług. Większość tego poradnika dotyczy właśnie ich.

Zanim zaczniesz

✓

Umowa ze Speedy z dostępem do API

Dostęp do API zamawiasz w Speedy pod adresem telesales@speedy.bg; dostajesz użytkownika i hasło API, oddzielne od Twojego zwykłego loginu Speedy.

✓

Twoje kody usług

Numeryczne identyfikatory usług Speedy z Twojej umowy — jeden dla tej samej miejscowości, jeden między miejscowościami i jeden międzynarodowy. Znajdziesz je na swoim koncie Speedy albo uzyskasz od Speedy.

✓

Numer telefonu w Twoim punkcie Speedy

Każdy punkt, z którego wysyłasz, musi mieć go w Speedy, inaczej nie pojawi się na liście Kontrakt.

Krok 1 — Otwórz kartę Speedy

Przejdź do Integracje → Kurierzy, wyszukaj speedy i kliknij Połącz na karcie Speedy — albo Edytuj, jeśli karta jest już połączona.

Strona Kurierzy w easySales przefiltrowana po speedy, z połączoną kartą Speedy.
Integracje → Kurierzy, filtr `speedy`.

Krok 2 — Dane dostępowe i przycisk Pobierz szczegóły

Górna część formularza połączenia Speedy w easySales: Alias Speedy magazyn Sofia, ID konta, Hasło oraz przyciski Klonuj, Usuń i Pobierz szczegóły.
Dopóki Pobierz szczegóły się nie powiedzie, widoczne są tylko te pola.

ID konta i Hasło to dane dostępowe API, które wydaje Ci Speedy — nie login do strony Speedy. Alias to nazwa, którą zobaczysz w easySales, wybierając między połączeniami.

Krok 3 — Format etykiety, płatnik i trzy kody usług

Formularz Speedy po Pobierz szczegóły: Format AWB A6, Płatnik usług kurierskich Sender, Typ przetwarzania Gotówka, Krajowy kod serwisowy 505, Lokalny kod usług 505 i Międzynarodowy Kod Usług 202.
Trzy kody usług to identyfikatory Speedy z Twojej umowy.
Pole Co robi
Format AWB Układ, w jakim Speedy generuje etykietę: A4 (cała strona), A6 (pojedyncza etykieta do drukarki termicznej) lub A4_4xA6 (cztery etykiety na jednym arkuszu A4).
Płatnik usług kurierskich Komu Speedy wystawia rachunek za przesyłkę — Sender (nadawca), Recipient (odbiorca) lub Third Party (strona trzecia).
Typ przetwarzania Jak Speedy przekazuje Ci gotówkę pobraną przy doręczeniu: Gotówka albo Przekaz pocztowy.
Krajowy kod serwisowy Identyfikator usługi Speedy dla paczki jadącej między miejscowościami — na przykład 505.
Lokalny kod usług Identyfikator usługi Speedy dla doręczenia w tej samej miejscowości.
Międzynarodowy Kod Usług Identyfikator usługi Speedy dla paczki wyjeżdżającej z Bułgarii — podpowiedź przy polu podaje przykład 202.
Pola etykiety i ich działanie

Krok 4 — Kontrakt, usługi dodatkowe i ubezpieczenie

Formularz Speedy z wybranym Kontraktem w Sofii, polem Dodatkowe usługi, zaznaczoną Dostawą ubezpieczoną i opcją Delikatne.
Punkt z kontraktu to miejsce, z którego Speedy odbiera paczki.

Kontrakt to lista zwrócona przez Speedy dla Twojego konta. Każda pozycja to jeden z Twoich punktów Speedy, a jej wybór ustala, skąd Speedy odbiera paczki, i numer telefonu nadawcy na etykiecie — dlatego drugi punkt odbioru to drugie połączenie, a nie ustawienie.

Ustawienie Co robi
Dodatkowe usługi Trzy opcje, widoczne pod rumuńskimi nazwami: Livrare sambata (doręczenie w sobotę), Deschidere la livrare (klient może otworzyć paczkę przed zapłatą; odrzucona paczka wraca na Twój koszt) i Paletizat (przesyłka jedzie jako paleta). To, co wybierzesz, jest dodawane do każdej etykiety tworzonej na tym połączeniu.
Dostawa ubezpieczona Deklaruje Speedy wartość produktów z VAT. Po jej włączeniu pojawia się druga opcja — Delikatne — która dodatkowo oznacza zawartość jako delikatną.
Pobranie To nie jest pole tego formularza. easySales samo dodaje kwotę do pobrania, gdy zamówienie jest płatne przy odbiorze.
Usługi dodatkowe i ubezpieczenie

Krok 5 — Szablon notatek

Szablon notatek połączenia Speedy w easySales, z przyciskami zmiennych zamówienia i produktów nad polem zawierającym Zamówienie ${order.id}.
To, co tworzy szablon, jest drukowane na etykiecie.

To, co tworzy szablon, jedzie razem z paczką i jest drukowane na etykiecie, więc ogranicz go do tego, co musi przeczytać kierowca albo magazyn. Przyciski nad polem wstawiają wartości z zamówienia i jego produktów. Speedy przyjmuje do 97 znaków; dłuższy tekst zostaje ucięty.

Krok 6 — Ustawienia drukowania i opcje zaawansowane

Obie sekcje są zwinięte i żadna nie jest obowiązkowa.

Rozwinięte ustawienia drukowania i opcje zaawansowane połączenia Speedy: rozmiar papieru, typ skalowania, Zapasowy adres email i Generuj paczki na podstawie numeru paczek w produkcie.
Obie sekcje są domyślnie zwinięte.
Ustawienie Co robi
Pokaż ustawienia drukowania Rozmiar papieru i skalowanie, używane tylko wtedy, gdy drukujesz przez połączenie Printer w easySales, i tylko dla tego kuriera. To nie to samo co Format AWB: Speedy decyduje, jak wygląda etykieta, a te ustawienia — jak trafia na papier.
Zapasowy adres email Wysyłany jako adres e-mail odbiorcy, gdy zamówienie go nie ma.
Generuj paczki na podstawie numeru paczek w produkcie Liczy paczki na etykiecie według liczby paczek ustawionej na każdym produkcie, zamiast zawsze wysyłać jedną.
Ustawienia drukowania i opcje zaawansowane

Kliknij Zapisz. Karta Speedy pokazuje teraz Połączony.

Więcej niż jeden punkt odbioru

Otwórz menu ⋮ na karcie Speedy i wybierz Podłącz następne konto kurierskie albo otwórz istniejące połączenie i kliknij Klonuj, aby skopiować wszystkie jego ustawienia. Każde połączenie ma własny kontrakt, własne kody usług i własne usługi dodatkowe, a przy tworzeniu etykiety wybierasz między nimi po Aliasie. Usuń, w tym samym miejscu, kasuje połączenie, którego już nie używasz.

Tworzenie etykiet

Otwórz Zamówienia, zaznacz zamówienia i użyj Generuj list przewozowy albo otwórz pojedyncze zamówienie i wygeneruj etykietę tam. Kilka rzeczy dzieje się automatycznie:

  • Pobranie jest dodawane automatycznie, gdy zamówienie jest płatne przy odbiorze, na wartość zamówienia. Typ przetwarzania decyduje, jak Speedy Ci je wypłaca.
  • Oddziały i automaty Speedy. Gdy klient wybrał oddział lub automat Speedy, etykieta trafia tam zamiast na adres domowy, bez zmian w połączeniu.
  • Waga. Zamówienie bez wagi jest wysyłane jako 0,25 kg.
  • Kraje docelowe. Etykiety Speedy można tworzyć dla Bułgarii, Rumunii, Grecji, Polski, Węgier, Czech, Słowacji, Austrii, Niemiec, Włoch i Francji. Dla każdego innego kraju zamówienie pokazuje Wybrany kurier nie obsługuje wysyłek do tego kraju.

Wysyłka za granicę: wymiary paczki

Przypisz do zamówienia opakowanie — zdefiniuj swoje opakowania w Opakowania, potem zaznacz zamówienie w Zamówienia i użyj Wybór szablonów rozmiarów — i wygeneruj list przewozowy ze strony zamówienia. Każde opakowanie na zamówieniu staje się paczką, a jego długość, szerokość, wysokość i waga trafiają do Speedy razem z etykietą. Na stronie zamówienia utworzysz też etykietę z kilkoma paczkami lub kopertami.

Gdy Speedy odrzuca etykietę

Speedy odpowiada po bułgarsku, a jego komunikat pojawia się na zamówieniu w takiej postaci, w jakiej przychodzi. Te warto rozpoznawać.

Komunikat Co oznacza
Пакети: Изискват се описани размери на пакета Wymagane są wymiary paczki. Typowe przy usługach międzynarodowych — przypisz do zamówienia opakowanie i wygeneruj etykietę ze strony zamówienia.
Услуга: Услугата не е позволена Usługa jest niedozwolona: wysłany kod nie należy do tych, z których Twoja umowa może korzystać dla tego miejsca docelowego. Sprawdź trzy kody usług ze Speedy.
Получател Адрес: Попълнете номер на улица/блок … Adres dostawy nie ma numeru ulicy ani bloku. Uzupełnij adres na zamówieniu i wygeneruj etykietę ponownie.
Получател Телефон 1: Невалидна стойност Brakuje numeru telefonu odbiorcy albo Speedy go nie akceptuje.
Получател Лице за контакт: … Zamówienie jest na firmę, a osoba kontaktowa musi być imieniem i nazwiskiem osoby, innym niż nazwa firmy. Popraw nazwę w adresie dostawy.
Обявена стойност: … е по-голяма от максималната … Przy włączonej Dostawie ubezpieczonej zadeklarowana wartość przekracza limit usługi. Limit ustala Speedy, osobno dla każdej usługi.
Пакети: Броят пакети е извън допустимия интервал … Liczba paczek wykracza poza zakres akceptowany przez usługę.
Получател Адрес 2: Максималната позволена дължина е 35 Druga linia adresu ma więcej niż 35 znaków. Skróć ją na zamówieniu.
Co oznaczają odmowy Speedy

Często zadawane pytania

To dane dostępowe API, które Speedy wydaje do Twojej umowy, a nie login i hasło do strony Speedy. Dostęp do API zamawiasz w Speedy pod adresem telesales@speedy.bg.

Najpierw kliknij Pobierz szczegóły. Loguje się do Speedy i odczytuje punkty z Twojej umowy, a reszta formularza — łącznie z Zapisz — pojawia się dopiero wtedy, gdy to się uda. Jeśli zwraca błąd, dane są błędne albo dostęp do API nie został jeszcze włączony.

easySales pokazuje tylko punkty, które mają numer telefonu w Speedy, bo Speedy drukuje telefon nadawcy na każdej etykiecie. Poproś Speedy o dodanie numeru telefonu do tego punktu, a potem ponownie kliknij Pobierz szczegóły.

To numeryczne identyfikatory usług Speedy z Twojej umowy: Lokalny kod usług dla doręczenia w tej samej miejscowości, Krajowy kod serwisowy między miejscowościami i Międzynarodowy Kod Usług dla paczek wyjeżdżających z Bułgarii. Dla adresu w Bułgarii, Rumunii lub Polsce easySales pyta Speedy, które usługi tam docierają, i wysyła pierwszą potwierdzoną, w tej kolejności.

Speedy informuje, że wysłana usługa nie należy do tych, z których Twoja umowa może korzystać dla tego miejsca docelowego. Zapytaj Speedy, jakie identyfikatory usług obejmuje Twoja umowa, i popraw kody na połączeniu.

Usługi międzynarodowe Speedy wymagają wymiarów paczki. Przypisz do zamówienia opakowanie (Zamówienia → Wybór szablonów rozmiarów) i wygeneruj list przewozowy ze strony zamówienia — długość, szerokość i wysokość opakowania zostaną wysłane razem z etykietą.

Nie. Gdy zamówienie jest płatne przy odbiorze, easySales samo dodaje kwotę do pobrania. Typ przetwarzania na połączeniu decyduje tylko o tym, jak Speedy Ci ją wypłaca — gotówką czy przekazem pocztowym.

Tak. Gdy klient wybrał oddział lub automat Speedy, etykieta jest automatycznie zaadresowana właśnie tam i nie trzeba niczego zmieniać w połączeniu.

Otwórz menu ⋮ na karcie Speedy i wybierz Podłącz następne konto kurierskie albo otwórz istniejące połączenie i kliknij Klonuj. Adres odbioru wynika z punktu wybranego w polu Kontrakt, więc drugi punkt odbioru to drugie połączenie.

Format AWB jest wysyłany do Speedy i decyduje o układzie etykiety, którą tworzy Speedy — cała strona A4, pojedyncza etykieta A6 albo cztery etykiety A6 na jednym arkuszu A4. Rozmiar papieru w ustawieniach drukowania działa tylko wtedy, gdy drukujesz przez połączenie Printer w easySales, i nadpisuje domyślne ustawienie drukarki wyłącznie dla tego kuriera.

Czy ten przewodnik był pomocny?