Przez Apaczkę Elbuz nadaje z karty zamówienia paczkę InPost, DPD, DHL, GLS lub innego przewoźnika w cenach Apaczki. Program drukuje etykietę i co 10 minut pobiera status paczki.
Kiedy to się przyda:
- Nie masz umowy z przewoźnikiem — paczki idą na umowie i w cenach Apaczki.
- Klient odbiera paczkę w punkcie — kod punktu przewoźnika trafia do listu przewozowego.
- Klient płaci przy odbiorze — pobranie ustawia się samo, pieniądze przychodzą na konto od Apaczki.
Od czego zacząć: utwórz App ID i App Secret w panelu Apaczki → wpisz je we wpis Apaczki w Elbuz.
Co potrafi Apaczka w Elbuz
- List przewozowy z zamówienia — usługą wybraną w podłączeniu, na adres lub do punktu przewoźnika, z pobraniem.
- Etykieta — PDF z karty zamówienia lub z „Przesyłek”.
- Zamówienie kuriera — razem z listem przewozowym, jeśli w podłączeniu jest „Odbiór przez kuriera”; później — dla usług DPD, jeśli Apaczka włączyła Ci odbiór przez API.
- Anulowanie listu przewozowego — dopóki przewoźnik nie odebrał paczki.
- Statusy paczek — co 10 minut; według tabeli kodów zmienia się stan paczki i status zamówienia.
Jak podłączyć Apaczka API
Skąd wziąć App ID, App Secret i ID usługi
- Zaloguj się do panelu Apaczki i otwórz „Ustawienia” → „API”.
- Utwórz aplikację API i skopiuj App ID oraz App Secret.
- Ustal ID usługi, którą będziesz wysyłać: każda usługa to przewoźnik i sposób dostawy, np. paczka DPD na adres.
Lista usług jest inna dla każdego konta, Apaczka udostępnia ją przez API (service_structure). Jeśli nie znasz ID usługi, zapytaj wsparcie Apaczki. Kolejność tworzenia kluczy — w dokumentacji Apaczka API.
Za paczki Apaczka pobiera opłatę z przedpłaconego salda („Moje konto” → „Doładuj konto”) albo wystawia fakturę, jeśli korzystasz z płatności odroczonej (Apaczka PRO).
Gdzie wpisać klucze w Elbuz
Gdzie: „Usługi zewnętrzne i integracje”, grupa „Dostawa” → wpis „Apaczka.pl”.
1
Użytkownik i Hasło2
Domyślne ID usługi Apaczka3
Nadanie paczek4
Rachunek do pobrania5
Nadawca- Użytkownik i Hasło — App ID i App Secret z panelu Apaczki.
- Domyślne ID usługi Apaczka — usługa używana przy tworzeniu listu przewozowego.
- Nadanie paczek — jak paczka trafia do przewoźnika (tu: nadajesz ją w punkcie).
- Rachunek do pobrania — IBAN do wypłat pobrań; zostaw puste, aby użyć rachunku z konta.
- Nadawca — firma, osoba kontaktowa, adres, telefon i e-mail; telefon i e-mail są wymagane.
| Pole | Co wpisać |
|---|---|
| „Użytkownik” | App ID |
| „Hasło” | App Secret |
| „Domyślne ID usługi Apaczka” | ID usługi; bez niego list przewozowy się nie utworzy |
| „Nadanie paczek” | „Nadaję w punkcie” (domyślnie) lub „Odbiór przez kuriera”. Przy „Odbiór przez kuriera” kurier jest zamawiany razem z listem przewozowym: Elbuz bierze najbliższy dzień i okno odbioru, które Apaczka proponuje dla kodu pocztowego nadawcy |
| „Rachunek do pobrania (IBAN, puste — z konta)” | rachunek, na który Apaczka przelewa pobranie; puste — rachunek z ustawień konta Apaczki |
| Blok „Nadawca” | nazwa, osoba kontaktowa, kod pocztowy, miejscowość, ulica, nr domu, telefon, e-mail; wszystkie poza osobą kontaktową i nr. domu są wymagane |
| „Aktywność” | włącz |
„Token”, „Link do serwera API” i „API ver” dla Apaczki zostaw puste. Przycisku „Zapisz” nie ma: każda zmiana pola zapisuje się od razu. App Secret po zapisaniu wyświetla się jako kropki; puste pole go nie kasuje.
Jak wystawić list przewozowy Apaczki z zamówienia
Sposób dostawy w zamówieniu musi być „Apaczka.pl”.
Gdzie: karta zamówienia → „Dostawa” → „Utwórz list przewozowy”. Jeśli formularz był już otwierany, link nazywa się „Edytuj list przewozowy”.
Co formularz wypełni sam i co sprawdzić
1
Adres odbiorcy2
Punkt odbioru przewoźnika (kod)3
Waga całkowita i wymiary4
Opis przesyłki- Adres odbiorcy — z zamówienia; kod pocztowy, miejscowość i ulica są wypełnione.
- Punkt odbioru przewoźnika (kod) — wypełnij tylko przy dostawie do punktu; przy dostawie kurierem puste.
- Waga całkowita i wymiary — waga jest wstępnie wpisana; długość, szerokość i wysokość podajesz ręcznie.
- Opis przesyłki — wstępnie wypełniony na podstawie produktów zamówienia.
| Pole | Co jest od razu | Co sprawdzić |
|---|---|---|
| „Nazwisko”, „Imię”, „Telefon”, „E-mail” | klient z zamówienia | imię — do 50 znaków; bez telefonu list przewozowy się nie utworzy |
| „Kod pocztowy”, „Miejscowość”, „Ulica”, „Nr domu”, „Nr mieszkania” | adres dostawy z zamówienia, „Nr domu” i „Nr mieszkania” puste | przy dostawie na adres wymagane są kod pocztowy, miejscowość i ulica |
| „Punkt odbioru przewoźnika (kod)” | punkt wybrany przez klienta, jeśli jest w zamówieniu | kod punktu tego przewoźnika, którego usługa jest w podłączeniu; z kodem adres nie jest wymagany |
| „Waga całkowita, kg” | waga produktów × ilość | puste — do listu trafi 1 kg |
| „Długość”, „Szerokość”, „Wysokość”, cm | puste | puste — trafi 30 × 20 × 10 cm |
| „Opis przesyłki” | kategoria produktu, a bez niej — lista produktów | do Apaczki trafi 50 znaków; puste — „Towar” |
| „Dostawa zwrotna (odbiorca)” | „Pieniądze” na kwotę zamówienia, jeśli nie jest opłacone, a płatność to pobranie; w przeciwnym razie „Niepotrzebna” | klient zapłacił kartą, a płatność nie jest odnotowana — ustaw „Niepotrzebna” |
Usługę i nadawcę formularz bierze z podłączenia; innego przewoźnika dla pojedynczej paczki wybrać nie można. Numer zamówienia trafia do komentarza paczki, odbiorca jest zawsze w Polsce.
Kwoty w formularzu są w złotych. Jeśli zamówienie jest w innej walucie, popraw kwotę pobrania ręcznie. Pobranie Apaczka przelewa na Twój rachunek w ciągu 1–10 dni roboczych (warunki Apaczki).
Co się dzieje po kliknięciu „Utwórz list przewozowy”
- Apaczka tworzy zamówienie na paczkę.
- W pole „Numer listu przewozowego” trafia numer paczki przewoźnika, pojawia się „Utworzono list przewozowy nr ‹numer›”. Jeśli przewoźnik nie nadał jeszcze numeru, w polu będzie numer zamówienia Apaczki; etykieta i zamówienie kuriera działają także z nim.
- Drugi list przewozowy dla tego samego zamówienia się nie utworzy: „List przewozowy już utworzony: ‹numer› — pominięto.”
- Jeśli Apaczka odmówiła, pojawi się „Error: Apaczka:” z przyczyną; wartości formularza zostają zapisane w zamówieniu.
- Jeśli w podłączeniu jest „Odbiór przez kuriera”, a Apaczka nie proponuje okna odbioru dla kodu pocztowego nadawcy, pojawi się „Error: Apaczka: no courier pickup window…”, a list przewozowy nie powstanie. Ustaw „Nadaję w punkcie” albo sprawdź kod pocztowy nadawcy.
Listy przewozowe dla dziesiątek zamówień naraz — „Utwórz list przewozowy (dostawa)” na liście zamówień, szczegóły: listy przewozowe hurtem.
Etykieta i zamówienie kuriera
Gdzie: karta zamówienia → „Podgląd listu przewozowego” → przycisk drukowania; albo „Przesyłki” → wiersz → „Drukuj list przewozowy”. Etykieta otwiera się jako PDF w nowej karcie, App Secret nie trafia do przeglądarki.
Elbuz drukuje etykiety tylko dla listów przewozowych utworzonych z Elbuz. Dla numeru wpisanego do zamówienia ręcznie w karcie pojawi się „print error: Apaczka: order id is unknown…”.
Zamówienie kuriera przez Apaczkę
Jeśli w podłączeniu jest „Odbiór przez kuriera”, kuriera nie trzeba zamawiać osobno: zlecenie idzie razem z listem przewozowym. Przycisk „Zamów kuriera” jest dla paczek utworzonych z „Nadaję w punkcie”.
Odbiór przez API Apaczka przyjmuje tylko dla usług DPD i tylko wtedy, gdy wsparcie Apaczki włączy go na Twoim koncie (dokumentacja Apaczki). U innych przewoźników kuriera zamawiaj w panelu Apaczki.
- W „Podglądzie listu przewozowego” sprawdź „Data odbioru”: jest jutrzejszy dzień, w piątek i w weekend — poniedziałek.
- „Odbiór od” i „do” zostaw puste — Elbuz weźmie pierwsze okno, które Apaczka proponuje dla kodu pocztowego nadawcy.
- Kliknij „Zamów kuriera” → „Kurier zamówiony” i numer zlecenia, jeśli Apaczka go zwróciła.
Anulowanie listu przewozowego
Gdzie: karta zamówienia → „Podgląd listu przewozowego” → „Usuń list przewozowy”; albo „Przesyłki” → wiersz → „Usuń list przewozowy”. Potrzebne jest uprawnienie do tworzenia listów przewozowych.
- Potwierdź „Usunąć list przewozowy ‹numer› u przewoźnika?”.
- Apaczka anuluje zamówienie, z karty znikają numer i link śledzenia → „List przewozowy usunięty. Zamówienie można wysłać ponownie.”
Anulować można, dopóki przewoźnik nie odebrał paczki. Później Apaczka odmawia, a Elbuz pokazuje „Przewoźnik nie usunął listu przewozowego:” z przyczyną; numer zostaje w zamówieniu. Paczki, którą śledzenie widzi już w drodze, w punkcie lub jako doręczoną, Elbuz nie proponuje usunąć.
Statusy paczek Apaczki
Elbuz pyta Apaczkę o każdą paczkę raz na 10 minut, do 100 paczek na przebieg. Śledzone są zamówienia z ostatnich 60 dni i zamówienia w oznaczonych statusach. Wszystkie paczki widać w „Przesyłkach”; tekst statusu jest taki, jak podał przewoźnik.
Kody statusów Apaczki
Apaczka sprowadza statusy wszystkich przewoźników do jednej listy i ten status Elbuz bierze jako kod. Kody z tabeli poniżej Elbuz wpisuje w „Statusy dostawy” sam.
Gdzie: podłączenie Apaczki → „Ustawienia powiadomień” → „Statusy dostawy”, kolumna „Kod (nazwa) na stronie (API)”. Kilka kodów — po przecinku.
| Twój status dostawy | Kod Apaczki | Co oznacza |
|---|---|---|
| „Oczekiwanie od nadawcy” | NEW | zamówienie utworzone |
| „W drodze” | PICKUP, IN_TRANSIT | paczka odebrana, jest w drodze, u kuriera w doręczeniu lub w punkcie |
| „Dostarczono” | DELIVERED, DELIVERED_NO_SYSTEM | doręczono; Elbuz przestaje pytać Apaczkę |
| „Odrzucenie” | RETURNED_TO_SHIPPER | zwrócono do nadawcy |
EXCEPTION, CANCELLED, CORRECTION i UNKNOWN nie wpisuj: takie paczki będą w stanie „Nieznany” w filtrze „Problemy”. Lista statusów — w dokumentacji Apaczki.
Żeby sam zmieniał się status zamówienia lub płatności, tak samo wypełnij „Statusy zamówienia” i „Statusy płatności”. Oznacz statusy zamówień w bloku „Statusy zamówień, dla których sprawdzać status przesyłki w firmie kurierskiej”. Zmiana zapisuje się w historii zamówienia: „Zmienił się status dostawy: ‹kod› ‹tekst› #‹numer›”.
Co zostaje w panelu Apaczki
- Doładowanie salda, faktury, rachunek do pobrań — w ustawieniach konta Apaczki.
- Kurier u przewoźników innych niż DPD i paczki za granicę — w panelu Apaczki.
Przycisk „Śledź na stronie przewoźnika” w „Przesyłkach” dla Apaczki odpowiada „Ten przewoźnik nie ma publicznej strony śledzenia.”
Scenariusze
Pierwsze podłączenie
Sytuacja. Sklep startuje, umów z przewoźnikami nie ma.
Co zrobić. Zarejestruj się w Apaczce, doładuj saldo, utwórz klucze API i ustal ID usługi. Wpisz wszystko w podłączenie razem z adresem, telefonem i e-mailem nadawcy.
Efekt. Już pierwszy list przewozowy z Elbuz to prawdziwa paczka w cenach Apaczki.
Paczka do punktu odbioru
Sytuacja. W podłączeniu jest usługa dostawy do punktu, klient wybrał punkt w sklepie internetowym.
Co zrobić. W formularzu sprawdź „Punkt odbioru przewoźnika (kod)”. Kod musi należeć do przewoźnika usługi.
Efekt. Paczka pojedzie do punktu; adresu odbiorcy można nie wypełniać.
Pobranie na własny rachunek
Sytuacja. Pieniądze z pobrań mają wpływać na osobny rachunek sklepu.
Co zrobić. Wpisz IBAN w „Rachunek do pobrania (IBAN, puste — z konta)”.
Efekt. Każdy list przewozowy z pobraniem z Elbuz pójdzie z tym rachunkiem.
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…” w oknie listu przewozowego | Nie wpisano App Secret albo „Aktywność” jest wyłączona | Wpisz App ID i App Secret, włącz „Aktywność” (gdzie wpisać) |
| „Error: Apaczka service ID is required (API settings)” | Nie wpisano ID usługi | Wypełnij „Domyślne ID usługi Apaczka” (ID usługi) |
| „Error: sender address, phone and email are required (API settings)” | W bloku „Nadawca” brakuje nazwy, kodu pocztowego, miejscowości, ulicy, telefonu lub e-maila | Wypełnij dane nadawcy w podłączeniu |
| „Error: address or pickup point is required for recipient” | Nie ma ani adresu odbiorcy, ani kodu punktu | Wpisz adres albo „Punkt odbioru przewoźnika (kod)” |
| „Error: Apaczka:” z odmową | Apaczka nie przyjęła zamówienia: błędne klucze, usługa spoza Twojego konta albo kod punktu innego przewoźnika | Sprawdź klucze, ID usługi i saldo w panelu Apaczki |
| „print error: Apaczka: order id is unknown…” | Numer wpisano do zamówienia ręcznie, a nie utworzono z Elbuz | Wydrukuj etykietę w panelu Apaczki |
| Odmowa przy „Zamów kuriera” | Usługa nie jest usługą DPD albo odbiór przez API nie jest włączony na koncie | Zamów kuriera w panelu Apaczki lub poproś wsparcie o włączenie odbioru przez API (zamówienie kuriera) |
| Paczki Apaczki w „Przesyłkach” w stanie „Nieznany” | Kod Apaczki nie jest wpisany w „Statusy dostawy” | Wpisz kody (kody statusów) |
Najczęstsze pytania
Ile kosztuje integracja z Apaczką?
Elbuz nic nie pobiera za listy przewozowe i statusy. Za paczki płacisz Apaczce według jej cen — z salda lub na fakturę.
Czy mogę wybrać przewoźnika dla pojedynczej paczki?
Nie: wszystkie listy przewozowe z Elbuz idą usługą z podłączenia. Inny przewoźnik — w panelu Apaczki albo przez bezpośrednie podłączenie przewoźnika, np. DPD Polska.
Czy mogę sprawdzić integrację bez prawdziwych paczek?
Nie: Elbuz działa tylko z produkcyjną Apaczką. Pierwszy list przewozowy wystaw dla testowego zamówienia i anuluj go przyciskiem „Usuń list przewozowy”, zanim paczka zostanie odebrana.
Czy mogę anulować list przewozowy z Elbuz?
Tak, dopóki przewoźnik nie odebrał paczki: „Podgląd listu przewozowego” → „Usuń list przewozowy” (anulowanie).
Dlaczego status w Elbuz spóźnia się względem Apaczki?
Elbuz pyta Apaczkę raz na 10 minut i bierze do 100 paczek na przebieg. Bieżący status pokazuje „Podgląd listu przewozowego”.
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 i kurier — okno „Tworzenie listu przewozowego”; paczki — „Przesyłki”
- Przygotować
- konto Apaczki z doładowanym saldem, App ID i App Secret, ID usługi
List przewozowy można wystawić tylko dla zamówienia, które użytkownik widzi zgodnie z ustawieniem „Czyje dane”.
- Utwórz App ID i App SecretPanel Apaczki → Ustawienia → API
- Wpisz klucze, ID usługi i adres nadawcyUsługi zewnętrzne i integracje → Apaczka.pl
- Wpisz kody statusówTamże, „Ustawienia powiadomień”
- Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”
- Wydrukuj etykietę„Podgląd listu przewozowego” lub „Przesyłki”
- W razie potrzeby anuluj list przewozowy„Podgląd listu przewozowego” lub „Przesyłki”
Powiązane tematy
- Jeśli chcesz widzieć paczki wszystkich przewoźników na jednej liście — Przesyłki.
- Jeśli trzeba wystawić listy przewozowe dla dziesiątek zamówień — listy przewozowe hurtem.
- Jeśli masz własną umowę z przewoźnikiem — DPD Polska, DHL Parcel Polska, GLS Poland.
- Jeśli wysyłasz innym przewoźnikiem — jak wystawić list przewozowy z zamówienia.
