# Delivery

Jako dostawę (`Delivery`) rozumiemy przemieszczenie partii towaru od Dostawcy do Odbiorcy. Przemieszczenie to odbywa się w wyznaczone miejsce o wyznaczonym czasie. (Musi więc zawsze posiadać datę oraz step załadunkowy i step rozładunkowy) `Delivery` w Apollo możemy łączyć w transporty, które mogą zawierać dowolną ilość Delivery. Trasa (`Stepy`) w transporcie jest wypadkową etapów wszystkich składowych Delivery posortowanych po datach.

# Delivery Workflow

Aby móc konfigurować osobne od transportu taski i generować z nich statusy (`DeliveryCheckpoint`), dodany został nowy typ `Workflow`, który musi posiadać flagę `deliveryWorkflow`. Po utworzeniu takiego Workflow możemy powiązać z nim nowo utworzone Taski, Taski te nie będa widziane w Transporcie, ale w analogiczny do tasków transportowych sposób będa generować stautsy (`Checkpoint`) dla każdego Delivery. W momencie pisania dokumentacji obsługa i tworzenie tego typu workflow oraz tasków jest możliwa tylko od strony bazy danych.

# Ustawienia w Task dla Delivery

W procesie Delivery do obiektu Task zostały dodane następujące flagi:

- `shouldConfirmRelatedCheckpoint` i `shouldBeConfirmedByRelatedCheckpoint`:

![shouldConfirmRelatedCheckpointAndshouldBeConfirmedByRelatedCheckpoint](<https://docs.logintegra.com/apollo-backend/static/Delivery/task-related-checkpoint-flags.png>)

Jeśli potwierdzany `DeliveryCheckpoint` posiada tę flagę, to potwierdzamy wszystkie `Checkpointy`, które są powiązane `Stepem` oraz mają flagę `shouldBeConfirmedByRelatedCheckpoint`.

Jeśli potwierdzany `Checkpoint` posiada tę flagę, to potwierdzamy wszystie `DeliveryCheckpointy`, które są powiązane `Stepem` oraz mają flagę `shouldBeConfirmedByRelatedCheckpoint`.

> Powiązane ze sobą stepy transportu i delivery zapisywane są w tabeli step\_delivery\_step

- `shouldSendLpToSapMessages`:

![MessageFlag](<https://docs.logintegra.com/apollo-backend/static/Delivery/task-message-flag.png>)

Jeśli potwierdzany `Checkpoint` posiada tę flagę, to po zatwierdzeniu przejdziemy do procesu opisanego w pochodnej klasy `MessageProcess` (czyli najpewniej wyślemy wiadomość do mikroserwisu)

Taski muszą mieć alias, który odpowiada przychodzącemu z MSP w polu `SapToLpFileDTO#state`

```
{
  (...)
  "state": "Closed",
  (...)
}
```

# Delivery Checkpoint

Dla reprezentacji statusu w Delivery powstał nowy obiekt `DeliveryCheckpoint` bardzo zbliżony do obecnego w systemie `Checkpoint`. Utworzone są na podstawie `Tasków` powiązanych z `Delivery Workflow`. Są niezależne od statusów w transporcie, ale mogą się wzajemnie zamykać, jeśli skonfigurujemy odpowiednio flagi w Taskach opisane wyżej.

# Delivery Custom Field

Dla reprezentacji pól dodatkowych w Delivery powstał nowy obiekt `DeliveryCustomFieldValue`, bardzo zbliżony do obecnego w systmie `CustomFieldValue`. Aby zapisywać pola dodatkowe w Delivery, musimy utworzyć CustomFieldDefinition w typie transportu, w którym mamy skonfigurowane Delivery: Custom Fieldy muszą posiadać alias wprowadzony w polu `deliveryAlias`. Tego typu Custom Fieldy nie będą wyświetlane w transporcie a w sekcji Delivery. Alias wprowadzony w powyższym polu musi odpowiadać aliasowi custom fielda przysłanego z MSP np.:

```
{
  (...),
  "customFields": [
    {
      "alias": "TRANSPORT_CODE",
      "value": "ILS"
    }
  ],
  (...)
}
```

![DeliveryCustomField](<https://docs.logintegra.com/apollo-backend/static/Delivery/delivery-custom-field.png>)

# Delivery Transport Type

Typ transportu, który chcemy powiązać z Delivery (np. do tworzenia/edycji transportów) musi posiadać flagę `usedForDeliveries`:

![DeliveryTransportType](<https://docs.logintegra.com/apollo-backend/static/Delivery/deilvery-transport-type.png>)

Bez tej flagi Delivery jest zupełnie niezależne od Transportu i nie będzie działać żadna z funkcjonalności, która wpływa na Transport.

# Wyświetlanie sekcji Delivery

Jeśli transport posiada Delivery, będa one wyświetlane w osobnych sekcjach w formularzu Transportu

![DeliverySections](<https://docs.logintegra.com/apollo-backend/static/Delivery/delivery-sections.png>)

![DeliverySection](<https://docs.logintegra.com/apollo-backend/static/Delivery/delivery-section.png>)
