Travel Allowance Itinerary (Create)

This endpoint creates an itinerary for a user based on its configuration and itinerary segments.

Scopes

travelallowance.itinerary.writeonly - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries

Parameters

Name Type Format Description
userId string uuid Required Unique identifier of a traveler(user)

Payloads

Examples

Request
POST https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries
Content-Type: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

{
  "assignment": {
    "context": "EXPENSE_REPORT",
    "contextId": "42B42F3CFA6D476B88B6"
  },
  "header": {
    "configurationCode": "GERMAN_RATE_DOMESTIC",
    "description": "Project at customer",
    "hasNoLodging": false,
    "overlapTypeCode": "TRIP_HOME",
    "tripTypeCode": "CUSTOMER_FACING"
  },
  "segments": [
    {
      "address": {
        "city": "Nuernberg",
        "communityCode": "",
        "countryCode": "DE",
        "postalCode": "83263",
        "street": "Mozartstr. 95"
      },
      "arrivalDate": "2023-11-01",
      "arrivalLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "arrivalTime": "08:08",
      "borderCrossingDate": "2023-11-01",
      "borderCrossingTime": "08:08",
      "departureDate": "2023-11-01",
      "departureLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "departureTime": "08:08"
    },
    {
      "address": {
        "city": "",
        "communityCode": "",
        "countryCode": "",
        "postalCode": "",
        "street": ""
      },
      "arrivalDate": "2023-11-06",
      "arrivalLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "arrivalTime": "10:00",
      "borderCrossingDate": "2023-11-06",
      "borderCrossingTime": "10:00",
      "departureDate": "2023-11-06",
      "departureLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "departureTime": "10:00"
    }
  ]
}
Response
200 OK
Content-Type: application/json
{
  "header": {
    "configurationCode": "GERMAN_RATE_DOMESTIC",
    "description": "Project at customer",
    "hasNoLodging": false,
    "id": 2703,
    "overlapTypeCode": "TRIP_HOME",
    "tripTypeCode": "CUSTOMER_FACING",
    "userId": "5e029477-6582-48f3-91e8-bc34c7ed8448"
  },
  "segments": [
    {
      "address": {
        "city": "Nuernberg",
        "communityCode": "",
        "countryCode": "DE",
        "postalCode": "83263",
        "street": "Mozartstr. 95"
      },
      "arrivalDate": "2023-11-01",
      "arrivalLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "arrivalTime": "08:08",
      "borderCrossingDate": "2023-11-01",
      "borderCrossingTime": "08:08",
      "departureDate": "2023-11-01",
      "departureLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "departureTime": "08:08"
    },
    {
      "address": {
        "city": "",
        "communityCode": "",
        "countryCode": "",
        "postalCode": "",
        "street": ""
      },
      "arrivalDate": "2023-11-06",
      "arrivalLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "arrivalTime": "10:00",
      "borderCrossingDate": "2023-11-06",
      "borderCrossingTime": "10:00",
      "departureDate": "2023-11-06",
      "departureLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "departureTime": "10:00"
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
      "rel": "self"
    }
  ]
}

Response Header

Data:
    Content-Type: application/json
    Etag: "jVuvyo9fmtwtl8IeZGCpEyYAAAAAAAAA"

Travel Allowance Itineraries (Retrieve)

This endpoint returns the itineraries of a user. This includes header information such as configuration code, overlap type code and trip type code and the itinerary segments.

Scopes

travelallowance.itinerary.read - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries?context={context}&contextId={contextId}&startDate={startDate}&endDate={endDate}&pageId={pageId}

Parameters

Name Type Format Description
userId string uuid Required Unique idetifier of a traveler(user)
context string - This parameter isn’t required. Possible values are TRAVEL_REQUEST and EXPENSE_REPORT. This parameter isn’t required
contextId string - The unique identifier of a travel request or expense report. This parameter isn’t required
startDate date [ISO 8601] yyyy-MM-dd Start date of the selection interval. This parameter isn’t required
endDate date [ISO 8601] yyyy-MM-dd End date of the selection interval. This parameter isn’t required
pageId string - The ID of a page in case pagination is required to get all results

Payloads

Examples

Request

GET https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries?context=EXPENSE_REPORT&contextId=ae6b88fca92245d2a53e&startDate=2023-11-01&endDate=2023-11-10
Accept: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

Response

200 OK
Content-Type: application/json
{
  "content": [
    {
      "header": {
        "configurationCode": "GERMAN_RATE_DOMESTIC",
        "description": "Project at customer",
        "hasNoLodging": false,
        "id": 2703,
        "overlapTypeCode": "TRIP_HOME",
        "tripTypeCode": "CUSTOMER_FACING",
        "userId": "5e029477-6582-48f3-91e8-bc34c7ed8448"
      },
      "segments": [
        {
          "address": {
            "city": "Nuernberg",
            "communityCode": "",
            "countryCode": "DE",
            "postalCode": "83263",
            "street": "Mozartstr. 95"
          },
          "arrivalDate": "2023-11-01",
          "arrivalLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
          "arrivalTime": "08:08",
          "borderCrossingDate": "2023-11-01",
          "borderCrossingTime": "08:08",
          "departureDate": "2023-11-01",
          "departureLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
          "departureTime": "08:08"
        },
        {
          "address": {
            "city": "",
            "communityCode": "",
            "countryCode": "",
            "postalCode": "",
            "street": ""
          },
          "arrivalDate": "2023-11-06",
          "arrivalLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
          "arrivalTime": "10:00",
          "borderCrossingDate": "2023-11-06",
          "borderCrossingTime": "10:00",
          "departureDate": "2023-11-06",
          "departureLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
          "departureTime": "10:00"
        }
      ],
      "links": [
        {
          "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
          "rel": "self"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "next",
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries?pageId=9uAvyo9fmtwtl8IeZGCpEyYCCCCCCCCC"
    }
  ]
}

Travel Allowance Itinerary (Retrieve)

This endpoint returns a specific itinerary of a user. This includes header information such as configuration code, overlap type code and trip type code and the itinerary segments.

Scopes

travelallowance.itinerary.read - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries/{itineraryId}

Parameters

Name Type Format Description
userId string uuid Required Unique idetifier of a traveler(user)
itineraryId integer int64 Required Unique identifier of an itinerary

Payloads

Examples

Request

GET https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703
Accept: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

Response

200 OK
Content-Type: application/json
{
  "header": {
    "configurationCode": "GERMAN_RATE_DOMESTIC",
    "description": "Project at customer",
    "hasNoLodging": false,
    "id": 2703,
    "overlapTypeCode": "TRIP_HOME",
    "tripTypeCode": "CUSTOMER_FACING",
    "userId": "5e029477-6582-48f3-91e8-bc34c7ed8448"
  },
  "segments": [
    {
      "address": {
        "city": "Nuernberg",
        "communityCode": "",
        "countryCode": "DE",
        "postalCode": "83263",
        "street": "Mozartstr. 95"
      },
      "arrivalDate": "2023-11-01",
      "arrivalLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "arrivalTime": "08:08",
      "borderCrossingDate": "2023-11-01",
      "borderCrossingTime": "08:08",
      "departureDate": "2023-11-01",
      "departureLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "departureTime": "08:08"
    },
    {
      "address": {
        "city": "",
        "communityCode": "",
        "countryCode": "",
        "postalCode": "",
        "street": ""
      },
      "arrivalDate": "2023-11-06",
      "arrivalLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "arrivalTime": "10:00",
      "borderCrossingDate": "2023-11-06",
      "borderCrossingTime": "10:00",
      "departureDate": "2023-11-06",
      "departureLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "departureTime": "10:00"
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
      "rel": "self"
    }
  ]
}

Response Header

Data:
    Content-Type: application/json
    Etag: "jVuvyo9fmtwtl8IeZGCpEyYAAAAAAAAA"

Travel Allowance Itinerary (Update)

This endpoint updates an itinerary for a user.

Scopes

travelallowance.itinerary.writeonly - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries/{itineraryId}

Parameters

Name Type Format Description
userId string uuid Required Unique identifier of a traveler(user)
itineraryId integer int64 Required Unique identifier of an itinerary

Payloads

Examples

Request
PUT https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703
Content-Type: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

{
  "header": {
    "configurationCode": "GERMAN_RATE_DOMESTIC",
    "description": "Project at customer",
    "hasNoLodging": false,
    "id": 2703,
    "overlapTypeCode": "TRIP_HOME",
    "tripTypeCode": "CUSTOMER_FACING",
    "userId": "5e029477-6582-48f3-91e8-bc34c7ed8448"
  },
  "segments": [
    {
      "address": {
        "city": "Nuernberg",
        "communityCode": "",
        "countryCode": "DE",
        "postalCode": "83263",
        "street": "Mozartstr. 95"
      },
      "arrivalDate": "2023-11-01",
      "arrivalLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "arrivalTime": "08:08",
      "borderCrossingDate": "2023-11-01",
      "borderCrossingTime": "08:08",
      "departureDate": "2023-11-01",
      "departureLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "departureTime": "08:08"
    },
    {
      "address": {
        "city": "",
        "communityCode": "",
        "countryCode": "",
        "postalCode": "",
        "street": ""
      },
      "arrivalDate": "2023-11-06",
      "arrivalLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "arrivalTime": "10:00",
      "borderCrossingDate": "2023-11-06",
      "borderCrossingTime": "10:00",
      "departureDate": "2023-11-06",
      "departureLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "departureTime": "10:00"
    }
  ]
}
Response
200 OK
Content-Type: application/json
{
  "header": {
    "configurationCode": "GERMAN_RATE_DOMESTIC",
    "description": "Project at customer",
    "hasNoLodging": false,
    "id": 2703,
    "overlapTypeCode": "TRIP_HOME",
    "tripTypeCode": "CUSTOMER_FACING",
    "userId": "5e029477-6582-48f3-91e8-bc34c7ed8448"
  },
  "segments": [
    {
      "address": {
        "city": "Nuernberg",
        "communityCode": "",
        "countryCode": "DE",
        "postalCode": "83263",
        "street": "Mozartstr. 95"
      },
      "arrivalDate": "2023-11-01",
      "arrivalLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "arrivalTime": "08:08",
      "borderCrossingDate": "2023-11-01",
      "borderCrossingTime": "08:08",
      "departureDate": "2023-11-01",
      "departureLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "departureTime": "08:08"
    },
    {
      "address": {
        "city": "",
        "communityCode": "",
        "countryCode": "",
        "postalCode": "",
        "street": ""
      },
      "arrivalDate": "2023-11-06",
      "arrivalLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "arrivalTime": "10:00",
      "borderCrossingDate": "2023-11-06",
      "borderCrossingTime": "10:00",
      "departureDate": "2023-11-06",
      "departureLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "departureTime": "10:00"
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
      "rel": "self"
    }
  ]
}

Response Header

Data:
    Content-Type: application/json
    Etag: "jVuvyo9fmtwtl8IeZGCpEyYAAAAAAAAA"

Travel Allowance Itinerary (Simulate)

This endpoint returns the detailed calculation results for a simulated itinerary. These calculation results are divided in client and government amounts which are based on rates defined in the travel allowance configuration. The rates are determined by government and company policies and may differ depending on location and length of travel as well as partial days of travel, seasonal travel, and so on.

Scopes

travelallowance.itinerary.read - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itinerarySimulation

Parameters

Name Type Format Description
userId string uuid Required Unique identifier of a traveler(user)

Payloads

Examples

Request
POST https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itinerarySimulation
Content-Type: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

{
"segments": [
    {
      "arrivalDate": "2023-11-01",
      "arrivalLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "arrivalTime": "08:08",
      "borderCrossingDate": "2023-11-01",
      "borderCrossingTime": "08:08",
      "departureDate": "2023-11-01",
      "departureLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "departureTime": "08:08"
    },
    {
      "arrivalDate": "2023-11-06",
      "arrivalLocationNameId": "1e90f2ec-e1ba-4e42-a295-2083421f3a40",
      "arrivalTime": "10:00",
      "borderCrossingDate": "2023-11-06",
      "borderCrossingTime": "10:00",
      "departureDate": "2023-11-06",
      "departureLocationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
      "departureTime": "10:00"
    }
  ]
}
Response
200 OK
Content-Type: application/json
{
  "itineraryDerivedData": {
    "startDate": "2023-11-01",
    "startTime": "08:08:00",
    "startDateUtc": "2023-11-01",
    "startTimeUtc": "07:08:00",
    "endDate": "2023-11-06",
    "endTime": "10:00:00",
    "endDateUtc": "2023-11-06",
    "endTimeUtc": "09:00:00",
    "numberOfDays": 6,
    "domestic": true,
    "homeCountry": "DE",
    "paymentCurrency": "EUR",
    "hasActualsConfigured": false
  },
  "itineraryRateCategoryTotals": [
    {
      "rateCategoryCode": "MEAL",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 112,
      "clientAmountInPaymentCurrency": 112,
      "benefitInKindAmountInPaymentCurrency": 0
    },
    {
      "rateCategoryCode": "LODGING",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 100,
      "clientAmountInPaymentCurrency": 50,
      "benefitInKindAmountInPaymentCurrency": 0
    },
    {
      "rateCategoryCode": "INCIDENTAL",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 0,
      "clientAmountInPaymentCurrency": 0,
      "benefitInKindAmountInPaymentCurrency": 0
    }
  ],
  "dailyResultDetails": [
    {
      "date": "2023-11-01",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 34,
      "clientAmountInPaymentCurrency": 24,
      "benefitInKindAmountInPaymentCurrency": 0,
      "dailyRateCategoryTotals": [
        {
          "rateCategoryCode": "MEAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 14,
          "clientAmountInPaymentCurrency": 14,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "LODGING",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 20,
          "clientAmountInPaymentCurrency": 10,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "INCIDENTAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 0,
          "clientAmountInPaymentCurrency": 0,
          "benefitInKindAmountInPaymentCurrency": 0
        }
      ],
      "dailyRateTypeDetails": [
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "MEAL",
            "rateCategoryCode": "MEAL",
            "expenseTypeCode": "FXMLS",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-01",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-01",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 14,
            "clientAmountInRateCurrency": 14,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 14,
            "clientAmountInPaymentCurrency": 14,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 14,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 14,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 14,
              "deductions": [],
              "resultingAmountInRateCurrency": 14,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 14,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 14,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 14,
              "deductions": [],
              "resultingAmountInRateCurrency": 14,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        },
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "LODGING",
            "rateCategoryCode": "LODGING",
            "expenseTypeCode": "FXLDG",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-01",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-06",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 20,
            "clientAmountInRateCurrency": 10,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 20,
            "clientAmountInPaymentCurrency": 10,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 20,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 20,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 20,
              "deductions": [],
              "resultingAmountInRateCurrency": 20,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 10,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 10,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 10,
              "deductions": [],
              "resultingAmountInRateCurrency": 10,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        }
      ]
    },
    {
      "date": "2023-11-02",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 42.4,
      "clientAmountInPaymentCurrency": 32.4,
      "benefitInKindAmountInPaymentCurrency": 0,
      "dailyRateCategoryTotals": [
        {
          "rateCategoryCode": "MEAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 22.4,
          "clientAmountInPaymentCurrency": 22.4,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "LODGING",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 20,
          "clientAmountInPaymentCurrency": 10,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "INCIDENTAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 0,
          "clientAmountInPaymentCurrency": 0,
          "benefitInKindAmountInPaymentCurrency": 0
        }
      ],
      "dailyRateTypeDetails": [
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "MEAL",
            "rateCategoryCode": "MEAL",
            "expenseTypeCode": "FXMLS",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-02",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-02",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 22.4,
            "clientAmountInRateCurrency": 22.4,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 22.4,
            "clientAmountInPaymentCurrency": 22.4,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-02",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-02",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        },
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "LODGING",
            "rateCategoryCode": "LODGING",
            "expenseTypeCode": "FXLDG",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-02",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-06",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 20,
            "clientAmountInRateCurrency": 10,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 20,
            "clientAmountInPaymentCurrency": 10,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 20,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 20,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 20,
              "deductions": [],
              "resultingAmountInRateCurrency": 20,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 10,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 10,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 10,
              "deductions": [],
              "resultingAmountInRateCurrency": 10,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        }
      ]
    },
    {
      "date": "2023-11-03",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 42.4,
      "clientAmountInPaymentCurrency": 32.4,
      "benefitInKindAmountInPaymentCurrency": 0,
      "dailyRateCategoryTotals": [
        {
          "rateCategoryCode": "MEAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 22.4,
          "clientAmountInPaymentCurrency": 22.4,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "LODGING",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 20,
          "clientAmountInPaymentCurrency": 10,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "INCIDENTAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 0,
          "clientAmountInPaymentCurrency": 0,
          "benefitInKindAmountInPaymentCurrency": 0
        }
      ],
      "dailyRateTypeDetails": [
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "MEAL",
            "rateCategoryCode": "MEAL",
            "expenseTypeCode": "FXMLS",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-03",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-03",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 22.4,
            "clientAmountInRateCurrency": 22.4,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 22.4,
            "clientAmountInPaymentCurrency": 22.4,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-03",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-03",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        },
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "LODGING",
            "rateCategoryCode": "LODGING",
            "expenseTypeCode": "FXLDG",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-03",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-06",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 20,
            "clientAmountInRateCurrency": 10,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 20,
            "clientAmountInPaymentCurrency": 10,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 20,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 20,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 20,
              "deductions": [],
              "resultingAmountInRateCurrency": 20,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 10,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 10,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 10,
              "deductions": [],
              "resultingAmountInRateCurrency": 10,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        }
      ]
    },
    {
      "date": "2023-11-04",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 42.4,
      "clientAmountInPaymentCurrency": 32.4,
      "benefitInKindAmountInPaymentCurrency": 0,
      "dailyRateCategoryTotals": [
        {
          "rateCategoryCode": "MEAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 22.4,
          "clientAmountInPaymentCurrency": 22.4,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "LODGING",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 20,
          "clientAmountInPaymentCurrency": 10,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "INCIDENTAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 0,
          "clientAmountInPaymentCurrency": 0,
          "benefitInKindAmountInPaymentCurrency": 0
        }
      ],
      "dailyRateTypeDetails": [
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "MEAL",
            "rateCategoryCode": "MEAL",
            "expenseTypeCode": "FXMLS",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-04",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-04",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 22.4,
            "clientAmountInRateCurrency": 22.4,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 22.4,
            "clientAmountInPaymentCurrency": 22.4,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-04",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-04",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        },
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "LODGING",
            "rateCategoryCode": "LODGING",
            "expenseTypeCode": "FXLDG",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-04",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-06",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 20,
            "clientAmountInRateCurrency": 10,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 20,
            "clientAmountInPaymentCurrency": 10,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 20,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 20,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 20,
              "deductions": [],
              "resultingAmountInRateCurrency": 20,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 10,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 10,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 10,
              "deductions": [],
              "resultingAmountInRateCurrency": 10,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        }
      ]
    },
    {
      "date": "2023-11-05",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 42.4,
      "clientAmountInPaymentCurrency": 32.4,
      "benefitInKindAmountInPaymentCurrency": 0,
      "dailyRateCategoryTotals": [
        {
          "rateCategoryCode": "MEAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 22.4,
          "clientAmountInPaymentCurrency": 22.4,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "LODGING",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 20,
          "clientAmountInPaymentCurrency": 10,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "INCIDENTAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 0,
          "clientAmountInPaymentCurrency": 0,
          "benefitInKindAmountInPaymentCurrency": 0
        }
      ],
      "dailyRateTypeDetails": [
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "MEAL",
            "rateCategoryCode": "MEAL",
            "expenseTypeCode": "FXMLS",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-05",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-05",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 22.4,
            "clientAmountInRateCurrency": 22.4,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 22.4,
            "clientAmountInPaymentCurrency": 22.4,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-05",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 28,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 28,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 28,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-05",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 22.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        },
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "LODGING",
            "rateCategoryCode": "LODGING",
            "expenseTypeCode": "FXLDG",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-05",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-06",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 20,
            "clientAmountInRateCurrency": 10,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 20,
            "clientAmountInPaymentCurrency": 10,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 20,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 20,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 20,
              "deductions": [],
              "resultingAmountInRateCurrency": 20,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 10,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 10,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 10,
              "deductions": [],
              "resultingAmountInRateCurrency": 10,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        }
      ]
    },
    {
      "date": "2023-11-06",
      "paymentCurrency": "EUR",
      "governmentAmountInPaymentCurrency": 8.4,
      "clientAmountInPaymentCurrency": 8.4,
      "benefitInKindAmountInPaymentCurrency": 0,
      "dailyRateCategoryTotals": [
        {
          "rateCategoryCode": "MEAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 8.4,
          "clientAmountInPaymentCurrency": 8.4,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "LODGING",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 0,
          "clientAmountInPaymentCurrency": 0,
          "benefitInKindAmountInPaymentCurrency": 0
        },
        {
          "rateCategoryCode": "INCIDENTAL",
          "paymentCurrency": "EUR",
          "governmentAmountInPaymentCurrency": 0,
          "clientAmountInPaymentCurrency": 0,
          "benefitInKindAmountInPaymentCurrency": 0
        }
      ],
      "dailyRateTypeDetails": [
        {
          "calculationDetailsSummary": {
            "rateTypeCode": "MEAL",
            "rateCategoryCode": "MEAL",
            "expenseTypeCode": "FXMLS",
            "location": {
              "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
              "uNLocationCode": "DENUE",
              "administrativeRegionId": null,
              "subDivisionCode": "DE-BY",
              "countryCode": "DE"
            },
            "governmentRateCurrency": "EUR",
            "governmentConversionRate": 1,
            "dateOfGovernmentConversionRate": "2023-11-06",
            "clientRateCurrency": "EUR",
            "clientConversionRate": 1,
            "dateOfClientConversionRate": "2023-11-06",
            "paymentCurrency": "EUR",
            "governmentAmountInRateCurrency": 8.4,
            "clientAmountInRateCurrency": 8.4,
            "benefitInKindAmountInRateCurrency": 0,
            "governmentAmountInPaymentCurrency": 8.4,
            "clientAmountInPaymentCurrency": 8.4,
            "benefitInKindAmountInPaymentCurrency": 0
          },
          "governmentCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 14,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 14,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 14,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-06",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 8.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ],
          "clientCalculationDetails": [
            {
              "rates": [
                {
                  "rateAmountInRateCurrency": 14,
                  "rateCurrency": "EUR"
                }
              ],
              "rateCurrency": "EUR",
              "rateAmountInRateCurrency": 14,
              "adjustmentFactors": [],
              "adjustedAmountInRateCurrency": 14,
              "deductions": [
                {
                  "deductionCategoryCode": "BREAKFAST",
                  "deductionTypeCode": "PROVIDED",
                  "deductionCurrency": "EUR",
                  "rateCurrency": "EUR",
                  "conversionRate": 1,
                  "dateOfConversionRate": "2023-11-06",
                  "deductionAmountInDeductionCurrency": 5.6,
                  "deductionAmountInRateCurrency": 5.6,
                  "benefitInKindAmountInRateCurrency": 0
                }
              ],
              "resultingAmountInRateCurrency": 8.4,
              "location": {
                "locationNameId": "0340871b-2d9b-9ef4-b66e-6b044ab0981e",
                "uNLocationCode": "DENUE",
                "administrativeRegionId": null,
                "subDivisionCode": "DE-BY",
                "countryCode": "DE"
              },
              "specialRulesApplied": null
            }
          ]
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itinerarySimulation",
      "rel": "self"
    }
  ]
}

Travel Allowance Itinerary (Delete)

This endpoint deletes an itinerary for a user.

Scopes

travelallowance.itinerary.writeonly - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries/{itineraryId}

Parameters

Name Type Format Description
userId string uuid Required Unique identifier of a traveler(user)
itineraryId integer int64 Required Unique identifier of an itinerary

Payloads

  • Request: None
  • Response: None

Examples

Request
DELETE https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/270
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US
Response
204 No Content

Travel Allowance Itinerary Day Properties (Retrieve)

This endpoint returns the properties for each day of a specific itinerary of a user. This includes the deductions, lodging and meal type codes and the location name ids per day.

Scopes

travelallowance.itinerary.read - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraryies/{itineraryId}/dayProperties

Parameters

Name Type Format Description
userId string uuid Required Unique idetifier of a traveler(user)
itineraryId integer int64 Required Unique identifier of an itinerary

Payloads

Examples

Request

GET https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraryies/2703/dayProperties
Accept: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

Response

200 OK
Content-Type: application/json
{
  "content": [
    {
      "date": "2021-11-01",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-02",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-03",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-04",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-05",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703/dayProperties",
      "rel": "self"
    },
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
      "rel": "related"
    }
  ]
}

Response Header

Data:
    Content-Type: application/json
    Etag: "jVuvyo9fmtwtl8IeZGCpEyYAAAAAAAAA"

Travel Allowance Itinerary Day Properties (Update)

This endpoint updates day properties of an itinerary.

Scopes

travelallowance.itinerary.writeonly - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries/{itineraryId}/dayProperties

Parameters

Name Type Format Description
userId string uuid Required Unique identifier of a traveler(user)
itineraryId integer int64 Required Unique identifier of an itinerary

Payloads

Examples

Request
PUT https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703/dayProperties
Content-Type: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

[
    {
      "date": "2021-11-01",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
        "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-02",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-03",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-04", 
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-05",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    }
  ]
Response
200 OK
Content-Type: application/json
{
  "content": [
    {
      "date": "2021-11-01",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-02",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-03",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-04",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    },
    {
      "date": "2021-11-05",
      "deductions": [
        {
          "deductionCategoryCode": "BREAKFAST",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LUNCH",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "DINNER",
          "deductionTypeCode": ""
        },
        {
          "deductionCategoryCode": "LODGING",
          "deductionTypeCode": ""
        }
      ],
      "locationNameIds": [
        "0340871b-2d9b-9ef4-b66e-6b044ab0981e"
      ],
      "lodgingTypeCode": "",
      "mealTypeCode": ""
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703/dayProperties",
      "rel": "self"
    },
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
      "rel": "related"
    }
  ]
}

Travel Allowance Itinerary Assignments (Retrieve)

This endpoint returns the assignments of a specific itinerary of a user. This includes the context of the itinerary and the assignment to a contextId per period. Unassigned periods are returned with empty strings as contextId.

Scopes

travelallowance.itinerary.read - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries/{itineraryId}/assignments

Parameters

Name Type Format Description
userId string uuid Required Unique idetifier of a traveler(user)
itineraryId integer int64 Required Unique identifier of an itinerary

Payloads

Examples

Request

GET https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703/assignments
Accept: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

Response

200 OK
Content-Type: application/json
{
  "context": "EXPENSE_REPORT",
  "itineraryPeriodAssignments": [
    {
      "contextId": "42B42F3CFA6D476B88B6",
      "period": {
        "startDate": "2021-11-01",
        "endDate": "2021-11-05"
      }
    },
    {
      "contextId": "",
      "period": {
        "startDate": "2021-11-06",
        "endDate": "2021-11-06"
      }
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703/assignments",
      "rel": "self"
    },
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
      "rel": "related"
    }
  ]
}

Response Header

Data:
    Content-Type: application/json
    Etag: "jVuvyo9fmtwtl8IeZGCpEyYAAAAAAAAA"

Travel Allowance Itinerary Assignment (Update)

This endpoint updates the assignments of an itinerary.

Scopes

travelallowance.itinerary.writeonly - Refer to Scope Usage for full details.

URI

https://{datacenterURI}/travelallowance/v4/users/{userId}/itineraries/{itineraryId}/assignments

Parameters

Name Type Format Description
userId string uuid Required Unique identifier of a traveler(user)
itineraryId integer int64 Required Unique identifier of an itinerary

Payloads

Examples

Request
PUT https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703/assignments
Content-Type: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5f79e774-de18-4478-957f-403c91cb9acc
Accept-Language: en-US

{
  "context": "EXPENSE_REPORT",
  "itineraryPeriodAssignments": [
    {
      "contextId": "42B42F3CFA6D476B88B6",
      "period": {
        "startDate": "2021-11-01",
        "endDate": "2021-11-05"
      }
    },
    {
      "contextId": "",
      "period": {
        "startDate": "2021-11-06",
        "endDate": "2021-11-06"
      }
    }
  ]
}
Response
200 OK
Content-Type: application/json
{
  "context": "EXPENSE_REPORT",
  "itineraryPeriodAssignments": [
    {
      "contextId": "42B42F3CFA6D476B88B6",
      "period": {
        "startDate": "2021-11-01",
        "endDate": "2021-11-05"
      }
    },
    {
      "contextId": "",
      "period": {
        "startDate": "2021-11-06",
        "endDate": "2021-11-06"
      }
    }
  ],
  "links": [
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703/assignments",
      "rel": "self"
    },
    {
      "href": "https://us.api.concursolutions.com/travelallowance/v4/users/5e029477-6582-48f3-91e8-bc34c7ed8448/itineraries/2703",
      "rel": "related"
    }
  ]
}

Travel Allowance v4 - Endpoints - Schemas

Itinerary Create Request

Name Type Format Description
assignmemt object Itinerary Create Assignment Context and ContextId the itineray should be assigned to.
header object Itinerary Create Request Header General data of the itinerary.
segments array Itinerary Segment List of segments of travel constructing the current itinerary.

Itinerary Create Assignment

Name Type Format Description
context enum - The context of the itinerary. Supported values are: TRAVEL_REQUEST, EXPENSE_REPORT.
contextId string - Context id to which current itinerary period is assigned. Empty string if the period is unassigned.

Itinerary Create Request Header

Name Type Format Description
configurationCode string - The configuration code used to calculate the settlement for the itinerary.
description string - Description of the itinerary.
hasNoLodging boolean - Traveller indicates that the itinerary has no overnight stays, e.g. a truck driver is driving overnight. Should only be set for certain configurations (usually Germany) where you can combine two days of an itinerary into one day.
overlapTypeCode string - Overlap type, can be used to handle different kinds of (overlapping) trips within a trip.
tripTypeCode string - Trip type, can be used to apply different calculation rules or allowance rates.

Itinerary Collection

Name Type Format Description
content array Itinerary Array of itinerary details
links array Link Array of links available for this list of itineraries.

Itinerary

Name Type Format Description
header object Itinerary Header  General data of the itinerary.
segmentList array Itinerary Segment List of segments of travel constructing the current itinerary.
links array Link Array of links available for this itinerary.

Itinerary Header

Name Type Format Description
configurationCode string - The configuration code used to calculate the settlement for the itinerary.
description string - Description of the itinerary.
hasNoLodging boolean - Traveller indicates that the itinerary has no overnight stays, e.g. a truck driver is driving overnight. Should only be set for certain configurations (usually Germany) where you can combine two days of an itinerary into one day.
id integer int64 Identification of the itinerary.
overlapTypeCode string - Overlap type, can be used to handle different kinds of (overlapping) trips within a trip.
tripTypeCode string - Trip type, can be used to apply different calculation rules or allowance rates.
userId string uuid Identification of the owner of the itinerary, i.e. the traveller.

Itinerary Segment

Name Type Format Description
address object Address Address of the professional activity at arrival location. Required to apply special calculations (e.g. german 3-month-rule).
arrivalDate string [ISO 8601] yyyy-MM-dd Date of arrival at the location.
arrivalLocationNameId string uuid Id of the arrival location; is either departure location of the next itinerary segment or home/office when itinerary ends with the current segment.
arrivalTime string HH:mm Time at the arrival location.
borderCrossingDate string [ISO 8601] yyyy-MM-dd Date of border crossing.
borderCrossingTime string HH:mm Time of border crossing.
departureDate string [ISO 8601] yyyy-MM-dd Date of departure from location.
departureLocationNameId string uuid Id of the departure location; is either home/office when itinerary begins with the current segment or the arrival location of the last itinerary segment.
departureTime string HH:mm Time at the departure location.

Itinerary Simulation Request

Name Type Format Description
segmentList array Itinerary Simulation Segment List of segments of travel constructing the current itinerary.

Itinerary Simulation Segment

Name Type Format Description
arrivalDate string [ISO 8601] yyyy-MM-dd Date of arrival at the location.
arrivalLocationNameId string uuid Id of the arrival location; is either departure location of the next itinerary segment or home/office when itinerary ends with the current segment.
arrivalTime string HH:mm Time at the arrival location.
borderCrossingDate string [ISO 8601] yyyy-MM-dd Date of border crossing.
borderCrossingTime string HH:mm Time of border crossing.
departureDate string [ISO 8601] yyyy-MM-dd Date of departure from location.
departureLocationNameId string uuid Id of the departure location; is either home/office when itinerary begins with the current segment or the arrival location of the last itinerary segment.
departureTime string HH:mm Time at the departure location.

Address

Name Type Format Description
city string Max length: 100, Min length: 0 City of location.
communityCode string Max length: 20, Min length: 0 Community code of location.
countryCode string [ISO 3166-1] , length 2 Country code of location.
postalCode string Max length: 20, Min length: 0 Postal code of location.
street string Max length: 200, Min length: 0 Street of location.

Itinerary Assignment

Name Type Format Description
context enum - The context of the itinerary. Supported values are: TRAVEL_REQUEST, EXPENSE_REPORT.
itineraryPeriodAssignments array Itinerary Period Assignment List of periods for the current itinerary with their unique assignment to a given context. Unassigned periods are returned with empty strings as contextId.
links array Link Array of links available for this itinerary assigment.

Itinerary Period Assignment

Name Type Format Description
contextId string - Context id to which current itinerary period is assigned. Empty string if the period is unassigned.
period object Itinerary Period Period of time in which an itinerary is assigned to a context id.

Itinerary Period

Name Type Format Description
endDate string [ISO 8601] yyyy-MM-dd End date of the current itinerary period.
startDate string [ISO 8601] yyyy-MM-dd Start date of the current itinerary period.

Itinerary Day Properties

Name Type Format Description
content array Itinerary Day Property Array of itinerary day property
links array Link Array of links available for this itinerary day properties.

Itinerary Day Property

Name Type Format Description
date string [ISO 8601] yyyy-MM-dd Date of the day within current itinerary.
deductions array Itinerary Deduction List of deduction categories relevant on date; each category can appear only once.
locationNameIds array of strings - List of location keys that the users stayed on this day.
lodgingTypeCode string - Lodging type; can be used to pay a special lodging rate for e.g. sleeping in a hybel or a youth hostel.
mealTypeCode string - Meal type; can be used to pay a special meal rate for e.g. eating in a canteen.

Itinerary Deduction

Name Type Format Description
deductionCategoryCode string - Category of deduction; it can be used to distinguish between e.g. breakfast, lunch, Lunch & dinner, night.
deductionTypeCode string - Type of deduction; it can be used to distinguish e.g between full deduction or partial deduction for the given category.
Name Type Format Description
rel string [RFC 5988] Relation type as defined by the server. There are registered relation types listed in RFC 5988 6.2.2. Initial Registry Contents including pagination relation types of next, self and related.
href string [RFC 3986] The URL of the link.

On this page