Skip to content
On this page

Zlecenia

Moduł Zlecenia umożliwia tworzenie, podgląd, edytowanie i usuwanie zleceń z bazy danych.

Zestawienie zleceń

Zestawienie zleceń dostępne jest z menu bocznego Zlecenia

Tabelaryczne zestawienie wszystkich zapisanych zleceń przewozowych. Zawiera takie informacje jak:

  • numer przesyłki - unikalny numer identyfikacyjny zlecenia określony przez klienta
  • status - aktualny status zlecenia. Możliwe opcje to: Do przydzielenia/Przydzielone/W trasie/Dostarczone/Odbiór nie powiódł się/Dostawa nie powiodła się
  • adres odbioru - adres odbioru zlecenia
  • czas odbioru - data i okno czasowe, w jakim zlecenie powinno zostać odebrane
  • adres dostawy - adres dostawy zlecenia
  • czas dostawy - data i okno czasowe, w jakim zlecenie powinno zostać dostarczone
  • rozmiar - rozmiar paczki w jednostkach zdefiniowanych przez klienta (kg, palety, osoby, etc.)
  • priorytet - priorytet zlecenia (wysoki/średni/niski)
  • status zlecenia - aktualny status zlecenia. Możliwe opcje to: Do przydzielenia/Przydzielone/W trasie/Dostarczone/Odbiór nie powiódł się/Dostawa nie powiodła się

Zelcenia-tabela

FILTROWANIE I WYSZUKIWANIE

Użytkownik ma możliwość wyszukania/przefiltrowania zleceń przy użyciu:

  • Wyszukiwarka: filtr wyszukiwania tekstu wyszukuje pasujący tekst w numerze przesyłki, nazwach nadawcy i odbiorcy, lokalizacjach odbioru i nadania
  • Dacie dostawy/odbioru zlecenia bądź przedziale czasowym: Na ekranie domyślnie wyświetlają się zlecenia z określonego przedziału czasowego, liczonego jako +/- 7 dni od dnia dzisiejszego.
  • Status: Możliwe opcje do wyfiltrowania to: Przydzielone, Dostarczone, W trasie, Do przydzielenia, Dostawa nie powiodła się, Odbiór nie powiódł się
  • Priorytet: Możliwe opcje do wyfiltrowania to:Wysoki, Niski, Średni

Dodawanie zleceń

Moduł umożliwia dodawanie zleceń na 2 sposoby, poprzez:

  • formularz z panelu użytkownika,
  • import z pliku .csv

Przyciski do dodawania zleceń znajdują się w prawym górnym rogu, nad tabelą ze zleceniami

Dodaj zlecenia

1. Formularz dodawania zleceń z panelu użytkownika

Po kliknięciu w przycisk oznaczony (+), wyświetli się formularz tworzenia nowego zlecenia przewozowego.

Dodawanie zleceń - formularzZelcenie dodaj

Poprzez formularz użytkownik definiuje obligatoryjne parametry:

  • numer paczki - unikalny identyfikator paczki
  • rozmiar- deklarowany rozmiar w jednostkach zdefiniowanych przez klienta (kg, paleta, osób, etc.)
  • priorytet -priorytet zlecenia, możliwe opcje do wyboru: wysoki, średni niski
  • datę i okno czasowe - datę i okno czasowe (od-do) w których ma nastąpić odbiór/dostawa
  • adres - miejsce dostawy i odbioru

Użytkownik ma możliwość zdefiniowania adresu odbioru/dostawy zlecenia jako:

  • dowolny adres (używamy geokodowania Google Geocoding APi)
  • POI (point of interest) - wcześniej zadeklarowane POI, wgrane do bazy danych punkty szczególne: magazyny, sklepy itp.

Ponadto poprzez formularz, użytkownik może określić także dodatkowe, opcjonalne parametry zlecenia takie jak:

  • nazwa nadawcy/odbiorcy- zdefiniowana przez użytkownika nazwa odbiorcy/dostawcy
  • nr telefonu- numer telefonu kontaktowego do nadawcy/odbiorcy
  • dodatkowe notatki- dodatkowe informacje dot. dostawy/nadawcy/odbiorcy

2. Import z pliku

Import zleceń z pliku to mechanizm umożliwiający szybkie zapisanie dużej ilości danych z pliku.

2.1 Szablonu importu zleceń

Szablon do importu zleceń w formacie *.csv : zlecenia.csv

Postępuj zgodnie z poniższymi krokami, aby zaimportować pojazdy z pliku:

  1. Pobierz szablon importu w formacie CSV.
  2. Otwórz plik CSV w programie takim jak Microsoft Excel lub Google Sheets.
  3. Wprowadź swoje dane:
  • Dodaj nowe pozycje w kolumnach wymienionych w Tabeli 1.
  • Upewnij się, że nagłówki odpowiadają tabeli 1; w przeciwnym razie import nie powiedzie się.
  • Wypełnij wymagane pola danymi o określonym w tabeli nr 1 typie (string,int ); bez nich import nie będzie możliwy.
  • W większości pól można używać dowolnego języka.

Po dodaniu danych zapisz plik w formacie CSV, kierując się wskazówkami zawartymi w sekcjach B i C.

B. Plik CSV – wymagania ogólne

  • Import działa tylko z plikami w formacie CSV.
  • Użyj średnika ( ; ) jako separatora i kodowania UTF-8.
  • Nagłówki muszą odpowiadać Tabeli 1 i szablonowi wymagań - w przeciwnym razie import nie powiedzie się.
  • Każde nowe zlecenie powinien zajmować jedną linię.

C. Plik CSV - szczegółowe wymagania

W Tabeli 1 znajdują się obowiązkowe nazwy nagłówków, typy danych, wymagane pola wraz z ich opisami.

| Tabela 1. Zakres danych do importu

NagłówekTyp danychWymagane?Opis
externalIdStringTakID zlecenia zdefiniowane przez klienta
sizeUIntTakRozmiar paczki w jednostkach zdefiniowanych przez klienta (kg,pallet, person, etc.)
priorityStringTakPriorytet paczki. Dostępne wartości do wyboru: MANDATORY, HIGH, MEDIUM, LOW
pickup_address_postalCodeStringTakAdres odbioru zlecenia : kod pocztowy
pickup_address_cityStringTakAdres odbioru zlecenia : nazwa miasta/wsi
pickup_address_streetStringTakAdres odbioru zlecenia : ulica
pickup_address_streetNumberStringTakAdres odbioru zlecenia : numer ulicy
pickup_address_flatNumberStringNieAdres odbioru zlecenia : numer mieszkania
pickup_address_additionalStringNieAdres odbioru zlecenia : dodatkowe informacje
pickup_address_countryStringTakAdres odbioru zlecenia : kraj
pickup_position_latFloatTakAdres odbioru zlecenia : szerokość geograficzna punktu odbioru
pickup_position_lonFloatTakAdres odbioru zlecenia : długość geograficzna punktu odbioru
pickup_timeWindow_startStringTakOdbioru zlecenia : początek okna czasowego
pickup_timeWindow_endStringTakOdbioru zlecenia : koniec okna czasowego
pickup_nameStringNieOdbioru zlecenia : nazwa punktu odbioru zadeklarowana przez klienta
pickup_phoneStringNieOdbioru zlecenia : telefon
pickup_notesStringNieOdbioru zlecenia : dodatkowe informacje
dropoff_address_postalCodeStringTakAdres dostawy zlecenia: kod pocztowy
dropoff_address_cityStringTakAdres dostawy zlecenia : miasto
dropoff_address_streetStringTakAdres dostawy zlecenia : nazwa ulicy
dropoff_address_streetNumberStringTakAdres dostawy zlecenia : numer ulicy
dropoff_address_flatNumberStringNieAdres dostawy zlecenia : numer mieszkania
dropoff_address_additionalStringNieAdres dostawy zlecenia : dodatkowe informacje
dropoff_address_countryStringTakAdres dostawy zlecenia :kraj
dropoff_position_latFloatTakAdres dostawy zlecenia :szerokość geograficzna punktu dostawy
dropoff_position_lonFloatTakAdres dostawy zlecenia : długość geograficzna punktu dostawy
dropoff_timeWindow_startStringTakDostawa zlecenia : początek okna czasowego
dropoff_timeWindow_endStringTakDostawa zlecenia : koniec okna czasowego
dropoff_nameStringNieDostawa zlecenia : nazwa punktu obioru zadeklarowana przez klienta
dropoff_phoneStringNieDostawa zlecenia : telefon
dropoff_notesStringNieDostawa zlecenia : dodatkowe informacje

2.4. Proces importu zleceń

Po kliknięciu w poniższy przycisk, użytkownik zostanie przekierowany do strony z formularzem do importu pliku. import btn

Dodawanie zleceń - formularz importu zleceń z plikuImport zleceń

Aby zaimportować plik, wykonaj poniższe kroki:

  1. Wybierz plik .csv i potwierdź wybór przyciskiem Wczytaj.

Dodawanie zleceń - potwierdzenie załadowania plikuImport zleceń - upload

  1. Na ekranie zostanie wyświetlony podgląd zleceń, które zamierzasz wgrać
  • Jeśli zaimportowane dane są poprawne - zatwierdź import przyciskiem Utwórz

  • Jeśli po zaimportowaniu pliku, chciałbyś poprawić niektóre dane, kliknij przycisk Wstecz, zmodyfikuj odpowiednie dane w pliku (np. w programie Microsoft Excel®), a następnie zaimportuj plik ponownie.

Dodawanie zleceń - podgląd zaimportowanych zleceńImport zleceń - preview

  1. Na ekranie wyświetli się informacja o ilości poprawnie zaimportowanych zleceń

Dodawanie zleceń - poprawnie zaimportowane zlecenia . Import zleceń - success

Usuwanie zleceń

Użytkownik ma możliwość usunięcia jednego lub kilku zleceń jednocześnie.

❗ Przycisk Usuń staje się aktywny jedynie po wybraniu jednego lub kilku zleceń ❗

Zelcenie usun

Po wybraniu zleceń do usunięcia, wyświetli się komunikat potwierdzający. Po zaakceptowaniu, wybrane zlecenia zostaną permanentnie skasowane z bazy danych.

Zelcenie usun potwierdzenie