VulCode

Integracja Apaczka przez Web API

Wycena przesyłki u kilku kurierów, wybór punktu, etykieta i zbiorczy dokument nadania z Twojego panelu. Apaczka podpisuje każde zapytanie, więc integracja jest prosta, ale wymaga precyzji.

Kurierzy i wysyłka
Krok dostawy w koszyku sklepu: ceny kilku kurierów przeliczone dla paczki z koszyka, wybrany kurier i podsumowanie zamówienia

Od wyceny do śledzenia

Kolejność wywołań Web API v2 w typowej wysyłce. Każdy krok to osobny endpoint.

  1. Struktura usług

    service_structure/

    Jakie usługi, opcje i typy punktów masz na koncie.

    W sklepielista kurierów do koszyka

  2. Wycena

    order_valuation/

    Koszt przesyłki dla wybranych usług.

    W sklepiecena dostawy w koszyku

  3. Zamówienie

    order_send/

    Przesyłka z danymi paczki i punktem.

    W sklepienumer zamówienia Apaczki

  4. Etykieta

    waybill/:order_id/

    List przewozowy do druku.

    W sklepieetykieta do paczki

  5. Nadanie i śledzenie

    turn_in/tracking/:waybill_number/

    Zbiorczy dokument nadania i statusy przesyłki.

    W sklepiestatus w zamówieniu

Podpis każdego zapytania

Apaczka nie używa tokenów sesji. Każde zapytanie niesie podpis HMAC i datę wygaśnięcia, a podpis liczy się z tych samych danych, które idą w treści.

Dziennik zapytań do Apaczki w panelu sklepu: lista zapytań Web API v2 i szczegóły podpisu jednego z nich
Podpis zapytania order_valuation/ z bliska: app_id, route, data i expires, podpis HMAC-SHA256 i czas ważności

  • Cztery części, jeden ciąg

    Identyfikator aplikacji, nazwa endpointu, dane JSON i data wygaśnięcia, w tej kolejności. JSON składamy raz, bo ponowne złożenie po podpisaniu zmienia znaki.

  • HMAC-SHA256 z App Secret

    Podpis liczymy kluczem App Secret, który zostaje w ustawieniach serwera i nie trafia do przeglądarki.

  • Najwyżej 30 minut

    Data wygaśnięcia musi być w przyszłości i najwyżej 30 minut od teraz. Liczy się od czasu serwera, więc zegar trzymamy zsynchronizowany z siecią.

Wtyczka czy integracja przez API

Na popularnych platformach zwykle wystarczy gotowe połączenie. Kod piszemy dla sklepów i systemów na zamówienie.

Krok
Lista usług
Cena dostawy w koszyku
Zamówienie przesyłki
Etykieta i dokument nadania
Status przesyłki
Gotowe połączenie platformy
WooCommerce, Shoper, Shopify i inne platformy z listy Apaczki
Lista usług

Usługi włączasz w konfiguracji integracji platformy.

Cena dostawy w koszyku

Cenę pokazuje to, co daje gotowa integracja platformy.

Gdy cena ma się liczyć na żywo dla każdej paczki, potrzebna jest integracja przez API.

Zamówienie przesyłki

Przesyłkę zamawiasz w panelu Apaczki.

Etykieta i dokument nadania

Etykietę i dokument nadania pobierasz w panelu Apaczki.

Dokumenty są w panelu Apaczki, a nie przy zamówieniu w Twoim panelu.

Status przesyłki

Statusy sprawdzasz w panelu Apaczki.

Integracja przez Web API
Moduł w Twoim kodzie, z podpisami i obsługą błędów
www.apaczka.pl/api/v2/
Lista usługPOST service_structure/

Usługi, opcje i to, czy trzeba zamówić kuriera, prosto z konta.

Cena dostawy w koszykuPOST order_valuation/

Cena dla paczki złożonej w koszyku.

Cena liczy się na żywo z wagi i wymiarów produktów w koszyku.

Zamówienie przesyłkiPOST order_send/

Przesyłka z danymi paczki i punktem, z Twojego panelu.

Etykieta i dokument nadaniaPOST waybill/:order_id/

List przewozowy przy pakowaniu, a turn_in/ na koniec dnia.

Etykiety i dokument nadania są przy zamówieniu w Twoim panelu.

Status przesyłkiPOST tracking/:waybill_number/

Śledzenie trafia do zamówienia i do panelu klienta.

Gotowe połączenie platformyIntegracja przez Web API
KiedyGotowe połączenie platformy: Sklep działa na WooCommerce, Shoperze albo Shopify. Wysyłkę obsługujesz w panelu Apaczki.Integracja przez Web API: Sklep albo magazyn jest napisany na zamówienie. Cena dostawy ma się liczyć w koszyku na żywo. Etykiety i dokumenty mają być w Twoim panelu.
Co robimyGotowe połączenie platformy: Konfiguracja integracji platformy. Kod nie jest potrzebny.Integracja przez Web API: Moduł Web API v2 w Twoim kodzie, z podpisami i obsługą błędów.

Co płynie między sklepem a Apaczką

Sklep wysyła dane przesyłki, Apaczka zwraca ceny, dokumenty i statusy.

Twój sklep
Endpoint Web API v2
Apaczka
  1. Twój sklepCena dostawy w koszyku
    ←order_valuation/
    ApaczkaWycena usług dla tej paczki
  2. Twój sklepPunkt wybrany przez klienta
    ←points/:type
    ApaczkaPunkty nadania i odbioru danego typu
  3. Twój sklepSpakowane zamówienie
    →order_send/
    ApaczkaZamówienie przesyłki
  4. Twój sklepEtykieta przy pakowaniu
    ←waybill/:order_id/
    ApaczkaList przewozowy do druku
  5. Twój sklepDokument nadania na koniec dnia
    ←turn_in/
    ApaczkaZbiorcze potwierdzenie nadania jako PDF
  6. Twój sklepStatus w zamówieniu
    ←tracking/:waybill_number/
    ApaczkaStatusy przesyłki, sprawdzane okresowo
Endpointy według dokumentacji Web API v2 Apaczki, sprawdzonej 6 października 2026 r.

Usługi i godziny odbioru

Listę usług, opcji i typów punktów bierzemy z konta w Apaczce, a godziny odbioru z osobnego endpointu, więc koszyk i ekran nadania zawsze pokazują to, co masz naprawdę.

Usługi Apaczki w koszyku w panelu sklepu: lista usług z konta, sposób nadania, godziny odbioru paczek i dostęp do Web API

  1. Usługi z konta, nie z kodu

    service_structure/

    Identyfikatory usług i opcji bierzemy z tego endpointu przy każdej synchronizacji, a nie wpisujemy na sztywno.

  2. Kurier możliwy albo wymagany

    service_structure/

    Struktura usług mówi, czy odbiór kurierem jest możliwy albo konieczny. Od tego zależy ekran nadania w panelu.

  3. Godziny odbioru

    pickup_hours/

    Godziny, w których kurier może odebrać paczki, przychodzą z Apaczki, a magazyn widzi je przy nadaniu.

Najczęstsze pytania o Apaczkę

Odpowiedzi o cenie dostawy, etykietach, wyborze agregatora i wycenie.

Czytaj dalej

Przewoźnicy i platformy, z którymi łączymy Apaczkę.

Jak dziś liczysz koszt dostawy?

Napisz, na czym działa sklep i z jakich kurierów korzystasz. Odpowiemy w godzinę z pytaniami i wyceną.