Migration of the endpoint POST /v4/proposals/{proposal_id}/transport_details to POST /v5/proposals/{proposal_id}/transport_details

Context

Upgrade from POST - ​/v4/proposals/{proposal_id}/transport_details to POST - ​/v5/proposals/{proposal_id}/transport_details

⭐ 2 Key benefits :

• Get the new time_validity_limit field to retrieve the time validity limit of the current transport (if it exists)
• With the new structure (the whole transport falls into the new "journeys" section), in the future we will be able to add more general fields related to the transport

Impacts

Route to call :

• POST - ​/v5/proposals/{proposal_id}/transport_details

Output

{
+ "time_validity_limit": "20250415T10:23:00.234Z",
! "journeys": [
    {
      "way": "INBOUND",
      "total_duration_in_min": 120,
      "travel_sections": [
        {
          "attendees": [
            {
              "id": "A",
              "ticket_number": "147-5250548512",
              "status": "VALIDATED",
              "reservation_number": "ZTG2MO",
              "pnr": "UP7XZH"
            }
          ],
          "departure": {
            "city": {
              "id": "PAR",
              "label": "PARIS"
            },
            "location": {
              "id": "CDG",
              "label": "PARIS-ROISSY CDG",
              "terminal_code": "2A"
            },
            "date": "2022-04-15",
            "time": "17:00:00"
          },
          "arrival": {
            "city": {
              "id": "PAR",
              "label": "PARIS"
            },
            "location": {
              "id": "CDG",
              "label": "PARIS-ROISSY CDG",
              "terminal_code": "2A"
            },
            "date": "2022-04-15",
            "time": "17:00:00"
          },
          "transport": {
            "type": "PLANE",
            "class": "PLANE_ECONOMY",
            "company": {
              "operator": {
                "id": "SQ",
                "label": "SINGAPORE AIRLINES",
                "logo": "http://www.airfrance.fr/logo",
                "_links": [
                  {
                    "rel": "self",
                    "method": "GET",
                    "href": "https://api.clubmed.com/products",
                    "label": "A label"
                  }
                ]
              },
              "exploiter": {
                "id": "SQ",
                "label": "SINGAPORE AIRLINES",
                "logo": "http://www.airfrance.fr/logo",
                "_links": [
                  {
                    "rel": "self",
                    "method": "GET",
                    "href": "https://api.clubmed.com/products",
                    "label": "A label"
                  }
                ]
              }
            },
            "travel_number": "SQ1234",
            "baggage": {
              "quantity": 2,
              "weight": 23,
              "unit": "KG"
            },
            "vehicle_type": "BOEING 747",
            "reference": "SQ1234",
            "fare_class": "U"
          },
          "clubmed_transport": false,
          "flight_code": "THEO9E",
          "cancellation_policy_type": "THEO",
          "technical_stops": 0,
          "connection_duration_in_min": 130,
          "stopover_duration_in_min": 130
        }
      ]
    }
  ]
}