# Integracja z platformą Semmelrock

## Proces

Proces tworzenia zlecenia na platformie Apollo z poziomu platformy Semmelrock wygląda nastepująco:

- Semmelrock pyta o propozycje wolnych okien,
- Apollo je zwraca,
- użytkownik w Semmelrocku wybiera sobie którąś z propozycji i klika "OK",
- w Apollo tworzy się zlecenie z oknem czasowym w wybranym terminie.

## Komunikaty

### Logowanie

Dokładne informacje nt. komunikatu logowania można znaleźć w [API.md](<https://docs.logintegra.com/apollo-backend/7. Microservices %26 Integrations/integrations/api/API/index.md>) w sekcji `Autoryzacja`.  
Poniżej przykładowy komunikat i przykładowa odpowiedź - uzyskany w odpowiedzi token służy do autoryzacji kolejnych zapytań:

Request:

```
POST http://apollo.logintegra.com/apollo/api/login
Content-Type: application/json
APIVersion: v1

{
  "username": "semmelrock-admin",
  "password": "hasło"
}
```

Response:

```
{
  "username": "semmelrock-admin",
  "roles": [
    "ACCESS_TO_TRANSPORT_DETAILS",
    (..)
  ],
  "token_type": "Bearer",
  "access_token": "r78rdcvnmgpf6f767ae4rigvkagql4nj"
}
```

### Pytanie o wolne okna

Dokładne informacje nt. komunikatu sprawdzającego pierwsze wolne miejsca na okno czasowe można znaleźć w [API.md](<https://docs.logintegra.com/apollo-backend/7. Microservices %26 Integrations/integrations/api/API/index.md>) w sekcji `Zapytanie o propozycję wolnych okien`. Przykładowe testowe zapytanie (wraz z mechanizmem autoryzacji) można znaleźć w [find-suggested-slots.http](<https://bitbucket.org/logintegraspzoo/apollo-backend/src/master/src/http-tests/public-api/>). Poniżej przykładowe zapytanie i odpowiedź.

Request:

```
POST http://apollo.logintegra.com/apollo/api/time-windows/suggest
Content-Type: application/json
APIVersion: v1
Authorization: Bearer <token>

{
  "principalCompany": {
    "id": "",
    "alias": "semmelrock"
  },
  "transportType": {
    "id": "",
    "alias": "LOADING"
  },
  "warehouse": {
    "id": "",
    "name": "Magazyn Gdynia"
  },
  "searchStart": "2021-08-05T12:00:00Z",
  "searchStop": "2021-08-05T17:00:00Z"
}
```

Response:

```
{
  "slots": [
    {
      "start": "2021-08-05T12:00:00Z",
      "stop": "2021-08-05T13:00:00Z",
      "ramp": {
        "id": 222498499,
        "warehouse": {
          "id": 222498476,
          "name": "Magazyn Gdynia"
        },
        "name": "1/A",
        "shortName": "1/A"
      }
    },
    {
      "start": "2021-08-05T12:00:00Z",
      "stop": "2021-08-05T13:00:00Z",
      "ramp": {
        "id": 222498595,
        "warehouse": {
          "id": 222498476,
          "name": "Magazyn Gdynia"
        },
        "name": "2/A",
        "shortName": "2/A"
      }
    },
    {
      "start": "2021-08-05T12:00:00Z",
      "stop": "2021-08-05T13:00:00Z",
      "ramp": {
        "id": 222498563,
        "warehouse": {
          "id": 222498476,
          "name": "Magazyn Gdynia"
        },
        "name": "3/A",
        "shortName": "3/A"
      }
    }
  ]
}
```

### Tworzenie zlecenia wraz z danymi awizacji i oknem czasowym

Semmelrock tworzy zlecenie od razu z oknem czasowym i danymi awizacji. Dokładne informacje na temat tych komunikatów można znaleźć w [API.md](<https://docs.logintegra.com/apollo-backend/7. Microservices %26 Integrations/integrations/api/API/index.md>) w sekcjach `Tworzenie transportu`, `Edycja istniejącego transportu`, `Dodanie/edycja awizacji`, `Dodanie/edycja okna czasowego`. Szablony komunikatów testowych można znaleźć w [create-transport.http](<https://bitbucket.org/logintegraspzoo/apollo-backend/src/master/src/http-tests/public-api/>) oraz [update-transport.http](<https://bitbucket.org/logintegraspzoo/apollo-backend/src/master/src/http-tests/public-api/>).

Poniżej przykładowe zapytanie - w odpowiedzi wysyłane są dane utworzonego transportu.

```
POST http://apollo.logintegra.com/apollo/api/transports
Content-Type: application/json
APIVersion: v1
Authorization: Bearer <token>

{
  "erpIdentifier": "2111447",
  "altIdentifier": "2111447",
  "description": "Uwaga: Załadunek tylko bokiem",
  "tradesman": "",
  "carrierCompany": {
    "id": "225680008",
    "contractorNumber": "",
    "shortName": ""
  },
  "principalCompany": {
    "id": "",
    "alias": "semmelrock"
  },
  "transportType": {
    "id": "",
    "alias": "DELIVERY"
  },
  "advice": {
    "driverName": "GRAD PIOTR",
    "carRegistrationNumber": "WGM11150",
    "trailerRegistrationNumber": "WZ2303R",
    "documentNumber": "ATD212324",
    "documentType": "ID_CARD",
    "driverMobilePhoneNumber": "600284363",
    "driverMobilePhonePrefix": "48",
    "personalDataProcessingConsent": "true",
    "termsOfConditionsAccepted": "true"
  },
  "steps": [
    {
      "stepTypeName": "load",
      "orderInTransport": "0",
      "warehouse": {
        "id": "",
        "idx": "",
        "name": "Magazyn Gdynia"
      },
      "company": {
        "id": "225680053",
        "contractorNumber": "",
        "shortName": ""
      },
      "timeWindow": {
        "ramp": "1/A",
        "start": "2021-08-09T13:30:00Z"
      }
    }
  ],
  "customFieldValues": [
    {
      "definitionName": "Typ zlecenia",
      "value": "Załadunek"
    },
    {
      "definitionName": "ID zlecenia TMS",
      "value": "98887"
    }
  ]
}
```

Uwaga: Węzeł `company` w sekcji `step` jest opcjonalny.

W przypadku poprawnego utworzenia zlecenia w odpowiedzi zostaną odesłane dane utworzonego transportu.

W przypadku gdy w żądanym miejscu będzie już istniało okno czasowe zostanie odsłany komunikat:

```
{
  "errors": [
    {
      "status": {
        "enumType": "org.springframework.http.HttpStatus",
        "name": "UNPROCESSABLE_ENTITY"
      },
      "title": "WindowsOverlapException",
      "detail": "Nie możemy zarezerwować okna czasowego o długości 60 minut we wskazanym miejscu, ponieważ magazyn jest już zajęty w tych godzinach. Prosimy o wybranie innej godziny lub rampy.",
      "meta": {
        "exceptionType": "WINDOWS_OVERLAP_EXCEPTION",
        "initialStart": "2021-08-09T13:30:00Z",
        "windowSizeInMinutes": 60,
        "rampName": "1/A"
      }
    }
  ]
}
```
