# Obliczanie długości okna czasowego

Podczas tworzenia transportu lub dodawania awizacji (w zależności od ustawień typu transportu) użytkownik zostaje przekierowany do Harmonogramu w celu wybrania miejsca na okno czasowe przypisane do transportu. W momencie kliknięcia w wolne miejsce w Harmonogramie obliczana jest długość okna czasowego.

## Domyślna długość okna czasowego

Domyślnie długość okna czasowego jest ustawiona dla całego magazynu. Oznacza to, że jeden typ transportu może posiadać inną długość okna w różnych magazynach.  
Ustawienie domyślnej wartości długości okna czasowego w magazynie znajduje się w panelu edycji (nazwa pola w bazie danych: `time_window_default_length_in_minutes`, tabela: `warehouse`):

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/default-window-length.png>)

Możliwe opcje do wyboru to:

- 15
- 30
- 60
- 120

## Obliczanie na podstawie algorytmu

Długość okna czasowego może być obliczana na podstawie zdefiniowanego algorytmu.  
Algorytm określony jest w ustawieniach magazynu i zawiera zakresy długości okna czasowego określone na podstawie ilości palet przypisanych do transportu.

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/alghoritm-settings.png>)

System będzie brał pod uwagę ustawienia algorytmu do obliczania długości okna czasowego w sytuacjach gdy okno czasowe będzie miało zdefiniowaną ilość palet, w systemie istnieją dwie możliwości podania ilości palet:

1. Określanie ilości palet w formularzu tworzenia nowego transportu:

- typ transportu musi mieć włączoną opcję "Obliczanie wielkości okna na podstawie algorytmu" w ustawieniach typu transportu (nazwa pola w bazie danych: `required`, tabela: `package_type_transport_type` dla typu opakowania `PALLETS`)

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/require-step-quantity.png>)

- wartość 'Ilość palet' określana jest w formularzu tworzenia nowego transportu:

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/quantity-new-transport-form.png>)

2. Domyślne określenie wartości ilości palet w typie transportu:

- typ transportu musi mieć wyłączoną opcję "Obliczanie wielkości okna na podstawie algorytmu" w ustawieniach typu transportu (nazwa pola w bazie danych: `required`, tabela: `package_type_transport_type` dla opakowania `PALLETS`) - w tym przypdaku pole to będzie niewidoczne w formularzu tworzenia nowego transportu

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/not-require-step-quantity.png>)

- typ transportu musi mieć podaną domyślną ilość palet w ustawieniach typu transportu (nazwa pola w bazie danych: `default_value`, tabela: `package_type_transport_type`, wpis dla typu opakowania `PALLETS`)

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/default_quantity_value.png>)

> W obu przypadkach:

- musi być zdefiniowany co najmniej jeden przedział długości okna czasowego zależny od ilości palet w ustawieniach algorytmu. W przeciwnym przypadku system przypisze domyślną długość okna zdefiniowaną w ustawieniach magazynu.

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/alghoritm-settings-example.png>)

> UWAGA! W przypadku przeciągnięcia okna na rampę w innej strefie magazynowej, jego rozmiar zostanie **obliczony od nowa**, nawet jeśli początkowy rozmiar okna wynikający z algorytmu na początkowej rampie został zmieniony ręcznie przez użytkownika (tzn. okno miało długość X, użytkownik rozciągnął je o pół godziny, przesuwamy okno na inną rampę -\> zupełnie ignorujemy początkową długość okna i rozciągnięcie okna przez użytkownika, liczymy wszystko od nowa dla nowej rampy).
>
> UWAGA! W przypadku gdy użytkownik zmniejszy okno czasowe w harmonogramie, a następnie zmniejszy liczbę opakowań, algorytm zadziała tylko w przypadku gdy zmiana ta nie spowoduje zwiększenia się okna czasowego. Przykład dla algorytmu, gdzie powyżej 30 palet tworzymy 2-godzinne okno czasowe: Transport został utworzony z 33 paletami i zaawizowany na 2 godziny. Logistyk zmniejsza długość okna na 1 godzinę 45 minut. Dostawca upakował jednak towar na 32 paletach. Zmiana ilości palet w transporcie na 32, nie spowoduje zwiększenia się okna z powrotem do 2 godzin.

## Stała dodawana do długości okna

W ustawieniach magazynu istnieje możliwość ustawienia stałej wartości (określonej w minutach) dodawanej do okna czasowego (nazwa pola w bazie danych: `window_constant_time`, tabela: `warehouse`):

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/constant-window-length.png>)

Możliwe wartości:

- 0
- 15
- 30
- 60

## Mnożnik długości okna w przypadku dostaw zagranicznych

W przypadku, gdy transport posiada przypisaną firmę dostawcy, której kraj różni się od kraju firmy pryncypała (dostawca jest firmą zagraniczną względem firmy pryncypała) długość okna czasowego jest mnożona przez mnożnik określony w ustawieniach głównych pryncypała (zakładka `Ustawienia`):

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/foreign-window-length-multiplier.png>)

Pole w bazie danych znajduje się w tabeli `Setting`, nazwa: `FOREIGN_DELIVERY_MULTIPLIER`.

## Okno czasowe zajmujące całą długość czasu pracy magazynu

W ustawieniach magazynu istnieje możliwość włączenia ustawienia, które powoduje, że okno czasowe zajmować będzie całą długość czasu pracy magazynu (nazwa pola w bazie danych: `time_window_must_occupy_entire_ramp`, tabela: `warehouse`):

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/time_window_must_occupy_entire_ramp.png>)

> Ustawienie to jest nadrzędne nad domyślną długością okna oraz nad ustawieniami algorytmu.

Po włączeniu każde stworzone okno czasowe w danym magazynie będzie zajmować całą długość czasu pracy magazynu:

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/time-windows/length-algorithm/time_window_on_entire_ramp.png>)
