Travel Change Event

Overview

This page will host the documentation for the travel change related events (Create, Update, Delete) that are publicly available on public.concur.user.profile.travel topic in the Event Subscription Service (ESS). Subscribers will be able to subscribe to these events by following the steps described on the Event Subscription Service v4 page.

Limitations

Access to this documentation does not provide access to the subscription.

Scope Usage

Which scopes are required to interact with this topic.

Name Description
travel.user.event.read Status of a travel user create, change, delete.

Events

This section lists the publicly available events.

Travel Create Event

The TravelProfileCreated eventType is intended to be published when a new travel user has been created. Based on business needs, the event could trigger an application to make API calls to SAP Concur services or start a process in a third-party application.

Travel Update Event

The TravelProfileUpdated eventType is intended to be published when an existing travel user has been updated. Subscribers of the event are able to leverage the data in the message to know what attributes of a user has updated. The value of the attribute will not be shared within the event. Based on business needs, the event could trigger an application to make API calls to SAP Concur services or start a process in a third-party application.

Travel Delete Event

The TravelProfileDeleted eventType is intended to be published when an existing travel user has been deleted. Based on business needs, the event could trigger an application to make API calls to SAP Concur services or start a process in a third-party application.

Schema

Schema for Event

Name Type Format Description
id UUID RFC 4122 EventId, unique identifier of this event.
correlationId UUID RFC 4122 Unique identifier used for logging/traceability.
eventType string string Supported values: TravelProfileCreated, TravelProfileUpdated, TravelProfileDeleted.
topic string string Public topic public.concur.user.profile.travel that the event belongs to.
timeStamp timeStamp RFC 3339 Current system time (UTC) when the event notification is issued.
facts map Facts Schema Required key-value pairs providing the content of the event.
facts.originator string string Source application publishing the event.
facts.companyId string RFC 4122 Organization associated with userId.
facts.userId string RFC 4122 Unique identifier of this user object.
facts.attributes list string Modified fields during an TravelProfileUpdated event, otherwise null.

Create Sample Events

{
  "id": "5ffcdb2f1f9f1f72720a492a1158f12f",
  "correlationId": "bd019209-024f-4186-ac24-137d7e9e2b2b",
  "eventType": "INSERT",
  "topic": "public.concur.user.travel.profile",
  "timeStamp": "2024-07-29T12:22:15.715Z",
  "subtopic": "0723e5bb-1e24-4311-8388-748975ec56a3",
  "facts": {
    "loginId": "5786726d-d961-438c-8a6b-d7b89d2a1f33-test_sync_user@travel-profile-test.com",
    "originator": "-98011",
    "companyId": "6e2a6001-0b51-4c18-af0a-a86c3fb7874f",
    "userId": "0723e5bb-1e24-4311-8388-748975ec56a3",
    "attributes": [ ]
  }
}

Update Sample Events

{
  "id": "5ffcdb2f1f9f1f72720a492a1158f12f",
  "correlationId": "bd019209-024f-4186-ac24-137d7e9e2b2b",
  "eventType": "MODIFY",
  "topic": "public.concur.user.travel.profile",
  "timeStamp": "2024-07-29T12:22:15.715Z",
  "subtopic": "0723e5bb-1e24-4311-8388-748975ec56a3",
  "facts": {
    "loginId": "5786726d-d961-438c-8a6b-d7b89d2a1f33-test_sync_user@travel-profile-test.com",
    "originator": "-98011",
    "companyId": "6e2a6001-0b51-4c18-af0a-a86c3fb7874f",
    "userId": "0723e5bb-1e24-4311-8388-748975ec56a3",
    "attributes": [
      "general",
      "lastModifiedBy",
      "nationalIds",
      "driversLicenses"
    ]
  }
}

Delete Sample Events

{
  "id": "5ffcdb2f1f9f1f72720a492a1158f12f",
  "correlationId": "bd019209-024f-4186-ac24-137d7e9e2b2b",
  "eventType": "DELETE",
  "topic": "public.concur.user.travel.profile",
  "timeStamp": "2024-07-29T12:22:15.715Z",
  "subtopic": "0723e5bb-1e24-4311-8388-748975ec56a3",
  "facts": {
    "loginId": "5786726d-d961-438c-8a6b-d7b89d2a1f33-test_sync_user@travel-profile-test.com",
    "originator": "-98011",
    "companyId": "6e2a6001-0b51-4c18-af0a-a86c3fb7874f",
    "userId": "0723e5bb-1e24-4311-8388-748975ec56a3",
    "attributes": [ ]
  }
}

On this page