One by Allegro API

Globe Pickup Points integruje się z One by Allegro (dawniej WEDO), czeskim przewoźnikiem dostarczającym do automatów paczkowych, punktów odbioru Intime i na adresy domowe przez API OneDelivery 3.0. Dzięki tej integracji możesz:

• Eksportować zamówienia do One by Allegro bezpośrednio z Shopify
• Drukować etykiety wysyłkowe w Shopify
• Wysyłać do automatu paczkowego, punktu odbioru lub na adres klienta
• Pobierać płatność za pobraniem

---

Włączanie integracji z API One by Allegro

1. W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz One by Allegro.
2. Wprowadź swoje ID tokenu i Hasło API. Oba znajdziesz w strefie klienta One by Allegro w ustawieniach API. Jeśli ich nie masz, skontaktuj się z pomocą One by Allegro (eshop-onecz@allegro.com).
3. Kliknij Testuj połączenie, aby potwierdzić, że dane uwierzytelniające są akceptowane, zanim zapiszesz ustawienia.
4. Wypełnij adres nadawcy — Nadawca — nazwa firmy, Nadawca — ulica, Nadawca — numer domu, Nadawca — miasto i Nadawca — kod pocztowy. Adres nadawcy jest drukowany na każdej etykiecie i używany do odbioru przesyłek, a także wysyłany z każdą przesyłką (One by Allegro nie korzysta z domyślnego adresu zapisanego na Twoim koncie). Integracja zawsze przekazuje Czechy jako kraj nadawcy.
5. Wypełnij pola Domyślna długość paczki w milimetrach, Domyślna szerokość paczki w milimetrach i Domyślna wysokość paczki w milimetrach. Są one obowiązkowe — One by Allegro odrzuca przesyłki bez wymiarów paczki.
6. Opcjonalnie ustaw Domyślną wagę (kg) używaną, gdy produkt nie ma wagi w Shopify.
7. Skonfiguruj opcje realizacji i tagowania według potrzeb.
8. Przypisz metody wysyłki Shopify do One by Allegro.

---

Eksportowanie i drukowanie etykiet

Możesz eksportować zamówienia do One by Allegro i drukować etykiety wysyłkowe bezpośrednio z Shopify, zarówno masowo, jak i indywidualnie. Pełny przepływ pracy opisujemy w artykule Tworzenie etykiet wysyłkowych.

Każde wyeksportowane zamówienie staje się jedną przesyłką z jedną paczką. Zwrócony numer paczki jest używany jako numer śledzenia, a link do śledzenia prowadzi na stronę śledzenia One by Allegro. Jeśli włączona jest automatyczna realizacja, zamówienie w Shopify jest realizowane z numerem śledzenia i nazwą przewoźnika One by Allegro.

API akceptuje w polach opisu paczki i referencji wyłącznie litery, cyfry, spacje, przecinki i kropki. Globe czyści te wartości automatycznie — opisem jest Order <nazwa zamówienia>, a nazwa zamówienia jest używana jako numer referencyjny 1, skrócona do 20 znaków.

---

Metody dostawy

One by Allegro ustala metodę dostawy w momencie eksportu na podstawie wybranego Typu produktu. Wartością domyślną jest AUTO i większość sprzedawców powinna ją zachować.

Typ produktu	Zachowanie
AUTO	Używa punktu odbioru One by Allegro wybranego podczas realizacji zamówienia — automat paczkowy staje się BOX, a oddział PUDO. Jeśli zamówienie nie ma punktu One by Allegro, paczka jest wysyłana na adres dostawy.
TO_DOOR	Dostawa na adres klienta. Wybrany punkt odbioru jest ignorowany.
BOX	Dostawa do automatu paczkowego One Box. Wymaga punktu One by Allegro w zamówieniu.
PUDO	Dostawa do obsługiwanego punktu odbioru (oddział Intime). Wymaga punktu One by Allegro w zamówieniu.

Jeśli wybierzesz jawnie BOX lub PUDO, a zamówienie nie zawiera punktu odbioru One by Allegro, eksport tego zamówienia zostanie odrzucony. Kody punktów pochodzą z punktu odbioru wybranego przez klienta w selektorze Globe — zobacz Dodawanie przewoźników z punktami odbioru.

Wszystkie przesyłki są eksportowane z usługą Standard. Czeskie i słowackie numery telefonów odbiorców są automatycznie konwertowane do formatu międzynarodowego (+420 / +421), aby przewoźnik mógł wysyłać powiadomienia SMS.

---

Waga i wymiary paczki

One by Allegro odrzuca przesyłki bez wymiarów paczki, więc wartości domyślne w ustawieniach przewoźnika są wymagane, a nie opcjonalne.

• Waga — pobierana z zamówienia Shopify. Jeśli zamówienie nie ma wagi, używana jest Domyślna waga (kg) z ustawień przewoźnika. Jeśli żadna z nich nie jest dostępna, eksport tego zamówienia się nie powiedzie.
• Wymiary — zawsze pobierane z pól Domyślna długość / szerokość / wysokość paczki w milimetrach. Jeśli którekolwiek z nich jest puste lub zerowe, eksport kończy się komunikatem z prośbą o ich uzupełnienie.

---

Płatność za pobraniem (COD)

One by Allegro obsługuje COD. Gdy zamówienie korzysta z metody płatności za pobraniem, kwota pobrania jest pobierana z zamówienia i wysyłana w walucie zamówienia razem z przesyłką. W ustawieniach przewoźnika nie ma osobnego pola na konto bankowe — wypłaty są realizowane na podstawie Twojej umowy z One by Allegro.

---

Status dostawy

Synchronizacja statusów dostawy nie jest dostępna. One by Allegro nie jest objęte synchronizacją statusów dostawy w Globe, więc statusy paczek nie są zapisywane z powrotem w Shopify. Numer śledzenia i link do śledzenia są nadal dołączane do realizacji, dzięki czemu klienci mogą śledzić paczkę na stronie śledzenia przewoźnika.

---

Drukowanie etykiet

Etykiety są zwracane przez One by Allegro jako jeden plik PDF obejmujący całą drukowaną partię, w jednym z dwóch formatów:

Format	Opis
PDF_A6	Jedna etykieta na stronę (domyślnie)
PDF_A4	Jedna etykieta na stronę A4

API OneDelivery nie obsługuje drukowania od wybranej pozycji na arkuszu, więc częściowo zużytych arkuszy etykiet nie da się ponownie wykorzystać u tego przewoźnika.

---

Zwroty i anulowanie

• Etykiety zwrotne nie są obsługiwane przez tę integrację.
• Przesyłek nie można anulować. API OneDelivery nie ma endpointu anulowania ani usuwania. Po wyeksportowaniu zamówienia przesyłka pozostaje na Twoim koncie One by Allegro — po prostu nie przekazuj paczki lub rozwiąż sprawę w portalu One by Allegro.

---

Rozwiązywanie problemów

Problem	Rozwiązanie
Failed to authenticate with One by Allegro	Sprawdź ID tokenu i hasło API w ustawieniach przewoźnika i użyj przycisku Testuj połączenie. Odpowiedź 401 oznacza nieprawidłowe dane uwierzytelniające.
Order requires a One by Allegro pickup point for BOX/PUDO delivery	Typ produktu jest ustawiony na BOX lub PUDO, ale zamówienie nie ma punktu odbioru One by Allegro. Użyj AUTO lub TO_DOOR albo sprawdź, czy klient wybrał punkt One by Allegro podczas realizacji zamówienia.
Order … has no weight	Ustaw wagę produktu w Shopify, wprowadź wagę ręcznie podczas eksportu lub uzupełnij Domyślną wagę (kg).
default package dimensions are not set	Uzupełnij domyślną długość, szerokość i wysokość (w milimetrach) w ustawieniach One by Allegro — API wymaga ich przy każdej przesyłce.
Odbiorca nie otrzymuje powiadomień od przewoźnika	Automatyczny prefiks kraju otrzymują tylko numery czeskie i słowackie. W przypadku innych krajów zapisz w zamówieniu numer telefonu w pełnym formacie międzynarodowym.
One by Allegro did not return a PDF label	API zwróciło coś innego niż plik PDF. Ponów wydruk; jeśli błąd się powtarza, skontaktuj się z pomocą One by Allegro, podając numer przesyłki.
Zamówienie wyeksportowane przez pomyłkę	Przesyłek nie da się usunąć przez API. Nie przekazuj paczki i rozwiąż sprawę przesyłki w portalu One by Allegro.