↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    Meest API w Elbuz: list przewozowy z zamówienia, naklejka i statusy paczek

    5 min czytaniaZaktualizowano

    Elbuz łączy się z Meest API i wystawia list przewozowy z karty zamówienia do oddziału odbiorcy, drukuje naklejkę i co 10 minut pobiera status paczki — bez panelu Meest.

    Kiedy to się przyda:

    • Wysyłasz przez Meest na umowie — odbiorca, oddział i kwota trafiają do listu z zamówienia.
    • Klient wybrał oddział Meest na Twojej stronie — oddział jest już w zamówieniu, a miasto Elbuz znajdzie po nim sam.
    • Klient płaci przy odbiorze — pobranie na kwotę zamówienia ustawia się samo.

    Od czego zacząć: uzyskaj login i hasło API od opiekuna Meest → wpisz je w rekordzie Meest w Elbuz.

    Co potrafi Meest w Elbuz

    Rejestry, przekierowanie, zwroty i zamawianie kuriera z Elbuz spośród ukraińskich przewoźników ma tylko Nova Poshta. W Meest te działania wykonuje się w panelu Meest.

    Jak podłączyć Meest: login, hasło, oddział nadawcy

    Skąd wziąć login i hasło API Meest

    Login i hasło do API wydaje Twój opiekun Meest. Druga droga — panel klienta 24.meest.com: „Налаштування” (Ustawienia) → „API інтеграції” (Integracje API) → „Укласти договір” (Zawrzyj umowę), a panel wyda token. Umowę z Meest podpisuje się w panelu klienta lub z przedstawicielem firmy — według Meest w jeden dzień. Poproś opiekuna także o ID umowy (contractID). Dokumentacja API dla programistów jest na wiki.meest-group.com.

    Gdzie wpisać login i hasło w Elbuz

    Gdzie: Usługi zewnętrzne i integracje → grupa „Dostawa” → rekord „Meest”.

    1. Login wpisz w pole „Użytkownik”, hasło — w „Hasło”. Jeśli masz token z panelu Meest, wklej go w pole „Token”, a „Użytkownik” i „Hasło” zostaw puste.
    2. Włącz „Aktywność”.
    3. Zaktualizuj słownik oddziałów, wybierz swój oddział w bloku „Nadawca”, wpisz telefon i nazwę firmy.
    4. Wpisz „ID umowy Meest”, jeśli opiekun je podał.

    Na podstawie loginu i hasła Elbuz sam uzyskuje token dostępu i trzyma go 24 godziny, potem pobiera nowy. Jeśli „Nazwa firmy” jest pusta, do listu trafi nazwa Twojej firmy z zamówienia.

    Formularz podłączenia Meest: pola konta i blok Nadawca
    1Użytkownik i Hasło
    2Oddział nadawcy
    3Telefon
    4Nazwa firmy
    5ID umowy Meest
    1. Użytkownik i Hasło — login i hasło konta Meest.
    2. Oddział — oddział Meest nadawcy (na tym koncie demo jest pusty).
    3. Telefon — numer telefonu nadawcy.
    4. Nazwa firmy — nazwa nadawcy drukowana na liście przewozowym.
    5. ID umowy Meest — opcjonalny identyfikator umowy od opiekuna Meest.

    Słownik oddziałów

    Oddziały w bloku „Nadawca” i w formularzu listu przewozowego Elbuz bierze z własnego słownika oddziałów Meest. Aktualizuje się on co noc sam; po pierwszym podłączeniu kliknij „Aktualizuj słowniki” w bloku „Słowniki przewoźnika” — trwa to do kilku minut.

    Przyciski ustawień powiadomień i tabela Słowniki przewoźnika
    1Liczba rekordów w słowniku oddziałów
    2Aktualizuj słowniki
    3Statusy dostawy
    1. Wiersz Oddziały pokazuje, ile rekordów ma wspólny słownik i kiedy był ostatnio aktualizowany.
    2. Aktualizuj słowniki — przycisk ręcznej aktualizacji.
    3. Statusy dostawy — ustawienia powiadomień o zmianie statusu dostawy.

    Przycisk działa dopiero po zapisaniu loginu i hasła. Jeśli Meest nie odpowie, zostaje poprzednia wersja słownika.

    Kody statusów Meest

    Status zamówienia zmienia się tylko w wybranych statusach zamówień i według trzech tabel „Ustawień powiadomień” — tak jak w Ukrposhcie. Kody Meest w „Statusach dostawy” są już wpisane; możesz je zmienić, po przecinku. Stan paczki w „Przesyłkach” Elbuz ustala sam na podstawie kodu Meest.

    Twój status dostawyKody MeestCo oznaczają
    Oczekiwanie od nadawcy2, 101Utworzono, przygotowano do wysyłki
    W drodze8081, 11, 1100, 12, 1213, 1214Wysłano z oddziału, sortownia, przyjęcie w oddziale odbiorcy
    W miejscu docelowym1216, 1220Dotarła do oddziału, powiadomienie o przechowywaniu
    Wydany kurierowi1315Wydano kurierowi
    Dostarczono1622Doręczono
    Odrzucenie1620, 1825Odmowa, zwrócono nadawcy

    Kody pochodzą z dokumentacji API Meest, metoda śledzenia. Po kodach „Dostarczono”, „Odrzucenie”, zagubienia (1629) i utylizacji (1630) Elbuz przestaje odpytywać paczkę.

    Jak utworzyć list przewozowy Meest z zamówienia

    Gdzie: karta zamówienia → sekcja „Dostawa” → „Utwórz list przewozowy”. Link jest widoczny, jeśli sposób dostawy zamówienia to Meest; po pierwszym otwarciu formularza nazywa się „Edytuj list przewozowy”.

    Co formularz wypełni sam, a co sprawdzić

    PoleSkąd pochodzi
    Nazwisko, Imię, Imię ojca, Telefon, E-mailZ zamówienia
    OddziałOddział z zamówienia (strona Elbuz CMS przekazuje go sama)
    MiejscowośćWedług nazwy miasta z zamówienia w słowniku Meest
    Waga całkowita, kgSuma wag produktów; gdy pusta — idzie 1 kg
    Deklarowana wartość, UAHKwota zamówienia
    Płatnik dostawy„Odbiorca”; można wybrać „Nadawca”
    Dostawa zwrotna (odbiorca)„Pieniądze” na kwotę zamówienia, jeśli nie jest opłacone, a płatność następuje przy odbiorze
    Formularz listu przewozowego Meest: adres, parametry przesyłki i dostawa zwrotna
    1Deklarowana wartość
    2Płatnik dostawy
    3Dostawa zwrotna (odbiorca): Pieniądze
    4Utwórz list przewozowy
    1. Deklarowana wartość, UAH — zadeklarowana wartość przesyłki.
    2. Płatnik dostawy — Odbiorca lub Nadawca.
    3. Dostawa zwrotna (odbiorca) ustawiona na Pieniądze, z kwotą poniżej.
    4. Utwórz list przewozowy — wysyła list do Meest.

    List przewozowy Meest z Elbuz — tylko do oddziału, dostawy na adres w formularzu nie ma. Formularz zapisuje się w zamówieniu przy każdej zmianie pola.

    Co się dzieje po kliknięciu „Utwórz list przewozowy”

    1. Elbuz sprawdza w rekordzie Meest oddział, telefon i nazwę nadawcy, a w formularzu — imię i nazwisko, telefon i oddział odbiorcy oraz wagę.
    2. Jeśli oddział nie jest wybrany, szuka go po adresie z zamówienia.
    3. Tworzy paczkę w Meest i zapisuje jej numer (kod kreskowy) w zamówieniu.

    Drugiego listu do tego samego zamówienia Elbuz nie utworzy: „List przewozowy już utworzony: … — pominięto.” Opis przesyłki jest przycinany do 100 znaków.

    Paczka pojawia się w Meest od razu. Dopóki Meest nie przyjął jej w oddziale, list przewozowy można usunąć z Elbuz.

    Zbiorczo: lista zamówień → zaznacz → „Utwórz list przewozowy (dostawa)” (listy przewozowe zbiorczo).

    Statusy paczek i druk naklejki

    Co 10 minut Elbuz pyta Meest o każdy list przewozowy osobno — do 100 na przebieg. Śledzone są zamówienia z ostatnich 60 dni lub w wybranych statusach, dopóki paczka nie zostanie doręczona lub zwrócona. Nowo utworzona paczka ma status „Відправлення створено, але не передано на доставку” (przesyłka utworzona, ale nieprzekazana do doręczenia, kod 2). Wszystkie paczki są w „Przesyłkach”, kody — w tabeli.

    Naklejka 100×100: karta zamówienia → „Podgląd listu przewozowego” → „Drukuj” albo „Przesyłki” → wiersz → „Drukuj list przewozowy”. Elbuz sam pobiera PDF z Meest i otwiera go w oknie; hasło nie trafia do przeglądarki.

    Jak usunąć list przewozowy Meest

    Gdzie: karta zamówienia → „Podgląd listu przewozowego” → „Usuń list przewozowy” albo „Przesyłki” → wiersz → „Usuń list przewozowy”. Przycisk jest dostępny, dopóki Meest nie przyjął paczki w oddziale. Elbuz usuwa paczkę w Meest, czyści numer w zamówieniu i zapisuje to w historii zamówienia — list można wystawić ponownie.

    Okno podglądu listu przewozowego Meest z paskiem statusu i numerem listu
    1Status przesyłki
    2Drukuj
    3Usuń list przewozowy
    1. Status przesyłki — zielony pasek pokazuje bieżący status listu w Meest.
    2. Drukuj — otwiera list przewozowy do druku.
    3. Usuń list przewozowy — usuwa list u przewoźnika i z zamówienia.

    Scenariusze

    Pierwsze podłączenie

    Co zrobić. Uzyskaj login i hasło od opiekuna, wpisz je w „Użytkownik” i „Hasło”, kliknij „Aktualizuj słowniki”, wybierz swój oddział, sprawdź kody w „Statusach dostawy”.

    Efekt. W formularzu listu przewozowego są listy miast i oddziałów Meest, statusy paczek przychodzą same.

    Zamówienia z Twojej strony

    Co zrobić. Nic: klient na stronie Elbuz CMS wybiera oddział Meest.

    Efekt. Oddział jest już w formularzu; jeśli miasto jest puste, Elbuz znajdzie je po oddziale podczas tworzenia listu.

    Dostawę opłaca sklep

    Co zrobić. W formularzu listu przewozowego wybierz „Płatnik dostawy” → „Nadawca”.

    Efekt. Odbiorca w oddziale płaci tylko pobranie, jeśli jest.

    Co zrobić, gdy coś pójdzie nie tak

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy…” zamiast formularza W rekordzie Meest nie ma hasła albo „Aktywność” jest wyłączona Wpisz „Użytkownik” i „Hasło”, włącz „Aktywność” (podłączenie)
    „Error: Meest: login/password is not configured” lub błąd logowania od Meest Pole „Użytkownik” jest puste albo login lub hasło są nieważne Sprawdź je u opiekuna Meest i wpisz ponownie
    Puste listy „Obwód”, „Miasto”, „Oddział” Słownik oddziałów nie został jeszcze pobrany „Aktualizuj słowniki” po zapisaniu loginu i hasła (słownik)
    „Error: sender branch_id is required (API settings)” Nie wybrano oddziału nadawcy Wybierz go w bloku „Nadawca” rekordu Meest
    „Error: sender name is required (API settings)” lub „sender phone is required (API settings)” W rekordzie Meest puste są „Nazwa firmy” lub „Telefon”, a w zamówieniu nie podano Twojej firmy Wpisz je w bloku „Nadawca” rekordu Meest
    „Error: branch_id is required for recipient” Oddziału odbiorcy nie znaleziono w słowniku Wybierz miasto i oddział w formularzu ręcznie
    „Error:” z nazwą pola, na przykład „receiver.phone: …” Meest nie przyjął wartości tego pola Popraw pole w formularzu listu lub w rekordzie Meest i utwórz list ponownie
    List przewozowy nie został usunięty: „Cancellation is only available until parcel arrives at the sender office” Paczka została już przyjęta w oddziale Meest Usunięcie już nie zadziała — zwrot lub przekierowanie zleć w panelu Meest

    Najczęstsze pytania

    Ile kosztuje integracja z Meest?

    Elbuz nie pobiera opłat za listy przewozowe, naklejki ani statusy. Za dostawę płacisz Meest zgodnie z umową.

    Czy można wysłać paczkę do paczkomatu Meest?

    Na liście „Oddział” są te punkty, które Meest udostępnia w słowniku oddziałów. Dostawy na adres w formularzu nie ma.

    Co wpisać: login i hasło czy token?

    Jedno z dwóch. Z loginem i hasłem Elbuz sam uzyskuje token i odnawia go co dobę. Token z panelu 24.meest.com wkleja się w pole „Token”, wtedy login i hasło nie są potrzebne.

    Ile maksymalnie może ważyć paczka?

    Meest dla sklepów internetowych podaje paczki do 30 kg do oddziałów i paczkomatów.

    Kto płaci za dostawę Meest?

    Domyślnie odbiorca w oddziale. W formularzu listu przewozowego można wybrać „Nadawca” — wtedy płacisz Ty, zgodnie z umową.

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa
    Inne wejścia
    Słowniki → Dokumenty → Przesyłki → „Przewoźnicy”; karta zamówienia → sekcja „Dostawa”
    Uprawnienia
    podłączenie — „API i tokeny dostępu”; list przewozowy — okno „Tworzenie listu przewozowego”; paczki — „Przesyłki”
    Przygotuj
    umowę z Meest, login i hasło API, oddział, z którego wysyłasz

    List przewozowy można wystawić tylko do zamówienia, które użytkownik widzi zgodnie z ustawieniem „Czyje dane”.

    1. Uzyskaj login i hasło APIOpiekun Meest
    2. Wpisz login i hasłoUsługi zewnętrzne i integracje → Meest
    3. Pobierz oddziały i wybierz swójTamże, „Słowniki przewoźnika”
    4. Uzupełnij kody statusówTamże, „Ustawienia powiadomień”
    5. Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”

    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