↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    Apaczka w Elbuz: listy przewozowe różnych przewoźników na jednej umowie

    5 min czytaniaZaktualizowano

    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

    1. Zaloguj się do panelu Apaczki i otwórz „Ustawienia” → „API”.
    2. Utwórz aplikację API i skopiuj App ID oraz App Secret.
    3. 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”.

    Formularz ustawień Apaczka.pl: App ID i App Secret, ID usługi, nadanie paczek, rachunek do pobrania i blok nadawcy
    1Użytkownik i Hasło
    2Domyślne ID usługi Apaczka
    3Nadanie paczek
    4Rachunek do pobrania
    5Nadawca
    1. Użytkownik i Hasło — App ID i App Secret z panelu Apaczki.
    2. Domyślne ID usługi Apaczka — usługa używana przy tworzeniu listu przewozowego.
    3. Nadanie paczek — jak paczka trafia do przewoźnika (tu: nadajesz ją w punkcie).
    4. Rachunek do pobrania — IBAN do wypłat pobrań; zostaw puste, aby użyć rachunku z konta.
    5. Nadawca — firma, osoba kontaktowa, adres, telefon i e-mail; telefon i e-mail są wymagane.
    PoleCo 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.

    Środowiska testowego dla Apaczki w Elbuz nie ma: każdy list przewozowy to prawdziwa paczka według cennika Apaczki. Klucze nie są sprawdzane przy zapisie; błąd pokaże pierwszy list przewozowy.

    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ć

    Formularz listu przewozowego Apaczka.pl wypełniony z zamówienia PLDOC-4
    1Adres odbiorcy
    2Punkt odbioru przewoźnika (kod)
    3Waga całkowita i wymiary
    4Opis przesyłki
    1. Adres odbiorcy — z zamówienia; kod pocztowy, miejscowość i ulica są wypełnione.
    2. Punkt odbioru przewoźnika (kod) — wypełnij tylko przy dostawie do punktu; przy dostawie kurierem puste.
    3. Waga całkowita i wymiary — waga jest wstępnie wpisana; długość, szerokość i wysokość podajesz ręcznie.
    4. Opis przesyłki — wstępnie wypełniony na podstawie produktów zamówienia.
    PoleCo jest od razuCo sprawdzić
    „Nazwisko”, „Imię”, „Telefon”, „E-mail”klient z zamówieniaimię — 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” pusteprzy dostawie na adres wymagane są kod pocztowy, miejscowość i ulica
    „Punkt odbioru przewoźnika (kod)”punkt wybrany przez klienta, jeśli jest w zamówieniukod 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ść”, cmpustepuste — trafi 30 × 20 × 10 cm
    „Opis przesyłki”kategoria produktu, a bez niej — lista produktówdo 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.

    1. W „Podglądzie listu przewozowego” sprawdź „Data odbioru”: jest jutrzejszy dzień, w piątek i w weekend — poniedziałek.
    2. „Odbiór od” i „do” zostaw puste — Elbuz weźmie pierwsze okno, które Apaczka proponuje dla kodu pocztowego nadawcy.
    3. 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.

    1. Potwierdź „Usunąć list przewozowy ‹numer› u przewoźnika?”.
    2. 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ąć.

    Po anulowaniu Apaczka nie udostępnia etykiety tej paczki. Jeśli etykieta jest potrzebna, pobierz ją przed anulowaniem.

    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 dostawyKod ApaczkiCo oznacza
    „Oczekiwanie od nadawcy”NEWzamówienie utworzone
    „W drodze”PICKUP, IN_TRANSITpaczka odebrana, jest w drodze, u kuriera w doręczeniu lub w punkcie
    „Dostarczono”DELIVERED, DELIVERED_NO_SYSTEMdoręczono; Elbuz przestaje pytać Apaczkę
    „Odrzucenie”RETURNED_TO_SHIPPERzwró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›”.

    Dopóki DELIVERED nie jest wpisany w „Dostarczono”, Elbuz pyta Apaczkę o doręczoną paczkę przez całe 60 dni.

    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

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo 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”.

    1. Utwórz App ID i App SecretPanel Apaczki → Ustawienia → API
    2. Wpisz klucze, ID usługi i adres nadawcyUsługi zewnętrzne i integracje → Apaczka.pl
    3. Wpisz kody statusówTamże, „Ustawienia powiadomień”
    4. Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”
    5. Wydrukuj etykietę„Podgląd listu przewozowego” lub „Przesyłki”
    6. W razie potrzeby anuluj list przewozowy„Podgląd listu przewozowego” lub „Przesyłki”

    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