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
- List przewozowy z zamówienia — do oddziału Meest, z pobraniem i wyborem płatnika; pojedynczo lub zbiorczo.
- Słownik oddziałów — aktualizuje się co noc, z niego wybiera się oddział nadawcy i odbiorcy.
- Statusy paczek — co 10 minut; według Twojej tabeli kodów zmienia się status zamówienia, dostawy i płatności.
- Naklejka — PDF 100×100 z karty zamówienia lub z „Przesyłek”.
- Usuwanie listu przewozowego — dopóki Meest nie przyjął paczki.
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”.
- 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.
- Włącz „Aktywność”.
- Zaktualizuj słownik oddziałów, wybierz swój oddział w bloku „Nadawca”, wpisz telefon i nazwę firmy.
- 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.
1
Użytkownik i Hasło2
Oddział nadawcy3
Telefon4
Nazwa firmy5
ID umowy Meest- Użytkownik i Hasło — login i hasło konta Meest.
- Oddział — oddział Meest nadawcy (na tym koncie demo jest pusty).
- Telefon — numer telefonu nadawcy.
- Nazwa firmy — nazwa nadawcy drukowana na liście przewozowym.
- 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.
1
Liczba rekordów w słowniku oddziałów2
Aktualizuj słowniki3
Statusy dostawy- Wiersz Oddziały pokazuje, ile rekordów ma wspólny słownik i kiedy był ostatnio aktualizowany.
- Aktualizuj słowniki — przycisk ręcznej aktualizacji.
- 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 dostawy | Kody Meest | Co oznaczają |
|---|---|---|
| Oczekiwanie od nadawcy | 2, 101 | Utworzono, przygotowano do wysyłki |
| W drodze | 8081, 11, 1100, 12, 1213, 1214 | Wysłano z oddziału, sortownia, przyjęcie w oddziale odbiorcy |
| W miejscu docelowym | 1216, 1220 | Dotarła do oddziału, powiadomienie o przechowywaniu |
| Wydany kurierowi | 1315 | Wydano kurierowi |
| Dostarczono | 1622 | Doręczono |
| Odrzucenie | 1620, 1825 | Odmowa, 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ć
| Pole | Skąd pochodzi |
|---|---|
| Nazwisko, Imię, Imię ojca, Telefon, E-mail | Z 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, kg | Suma wag produktów; gdy pusta — idzie 1 kg |
| Deklarowana wartość, UAH | Kwota 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 |
1
Deklarowana wartość2
Płatnik dostawy3
Dostawa zwrotna (odbiorca): Pieniądze4
Utwórz list przewozowy- Deklarowana wartość, UAH — zadeklarowana wartość przesyłki.
- Płatnik dostawy — Odbiorca lub Nadawca.
- Dostawa zwrotna (odbiorca) ustawiona na Pieniądze, z kwotą poniżej.
- 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”
- Elbuz sprawdza w rekordzie Meest oddział, telefon i nazwę nadawcy, a w formularzu — imię i nazwisko, telefon i oddział odbiorcy oraz wagę.
- Jeśli oddział nie jest wybrany, szuka go po adresie z zamówienia.
- 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.
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.
1
Status przesyłki2
Drukuj3
Usuń list przewozowy- Status przesyłki — zielony pasek pokazuje bieżący status listu w Meest.
- Drukuj — otwiera list przewozowy do druku.
- 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
| Co widzisz | Dlaczego tak jest | Co 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”.
- Uzyskaj login i hasło APIOpiekun Meest
- Wpisz login i hasłoUsługi zewnętrzne i integracje → Meest
- Pobierz oddziały i wybierz swójTamże, „Słowniki przewoźnika”
- Uzupełnij kody statusówTamże, „Ustawienia powiadomień”
- Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”
Powiązane tematy
- Jeśli chcesz widzieć paczki wszystkich przewoźników na jednej liście — Przesyłki.
- Jeśli wysyłasz też przez Nova Poshta — Nova Poshta API w Elbuz.
- Jeśli zamówienie przyszło z Rozetki i list trzeba wystawić przez marketplace — list przewozowy przez Rozetkę.
- Jeśli listy przewozowe trzeba wystawić do dziesiątek zamówień — listy przewozowe zbiorczo.
