Niniejszy opis dotyczy API korporacyjnego przewoźnika DB Schenker, obowiązującego od stycznia 2025 roku.
API jest jedno dla wielu krajów i nie każda usługa, która jest dostępna w programie może być realizowana przez oddział DB Schenker Polska.
Jak uzyskać dostęp do API DB Schenker
Aby uzyskać dostęp do API należy o niego wystąpić za pomocą platformy udostępnianej przez DB Schenker. Najlepiej w tym celu poprosić o wsparcie opiekuna po stronie przewoźnika.
Ważne aby wskazać, że integracja będzie obsługiwana za pomocą programu ProstaPaczka a nie będzie zupełnie nową integracją, wtedy możliwe będzie uzyskanie dostępu od razu do środowiska produkcyjnego API DB Schenker.
W niektórych przypadkach może być wymagane przejście przez procedurę testową na środowisku testowym przewoźnika, Sposób w jaki można to przeprowadzić opisaliśmy na stronie: Jak sprawdzić integrację na środowisku testowym DB Schenker?
Co jest potrzebne do integracji?
Do integracji wymagane jest posiadanie:
- przyznanego dostępu do wersji testowej lub produkcyjnej API przewoźnika
- Posiadanie klucza dostępu do API
- Opcjonalnie (jeżeli wymagane przez DB Schenker): identyfikator użytkownika, identyfikator grupy, nazwa grupy
Włączenie integracji z DB Schenker
Jeżeli posiadasz wszystkie potrzebne dane to możesz przystąpić do uruchomienia integracji w programie ProstaPaczka. W pierwszej kolejności włącz moduł DB SCHENKER (nowy) w zakładce ADMINISTRACJA -> MODUŁY. Pojawi się nowa zakładka dedykowana integracji z API DB Schenker.
Dodanie konta dostępowego
- Przejdź do zakładki DB SCHENKER (nowe)
- Kliknij w ikonę zębatki
- Uruchom konfigurację kont klikając w przycisk KONTA
- Kliknij w przycisk dodawania nowego konta
- W danych konta wpisz dane dostępowe uzyskane z systemu DB Schenker
- Dodaj adresy, które będą wpisywane do każdego listu (np. adres nadania (Shipper) czy podjęcia (Pickup) przesyłek). Dodatkowe informacje można odnaleźć na stronie: Jak dodać adres DB Schenker?.
Konfiguracja wydruku etykiet
W zakładce DB SCHENKER (nowy) możesz skonfigurować wydruk etykiet.
- Kliknij w ikonę zębatki
- Kliknij w przycisk WYDRUKI
- Wybierz jakie dokumenty mają być pobierane z API DB Schenker czy mają być wysyłane na drukarkę oraz wybierz drukarkę z listy dostępnych
Uzupełnienie słownika opakowań
Uzgodnij z DB Schenker typy opakowań których możesz używać i uzupełnij słownik opakowań DB Schenker w ProstejPaczce.
Domyślnie słownik jest pusty i trzeba uzupełnić go predefiniowaną listą lub wpisać typy opakowań, które będą używane.
Przygotowanie pierwszego listu
Na początku zalecamy aby przygotować list ręcznie uzupełniając wszystkie potrzebne dane w oknie edycji listu. Po utworzeniu listu można sprawdzić w systemie DB Schenker czy są wszystkie niezbędne dane do realizacji usługi transportowej.
Przygotowanie listu z systemu źródłowego
Po utworzeniu pierwszego listu można przystąpić do automatycznego uzupełniania danych z systemu źródłowego. W ustawieniach metod eksportu zakładki systemu źródłowego można sprawdzić czy integracja z DB Schenker jest dostępna w danym module.