Attendees v1.1

Creates or updates one or more attendee records for the specified expense entry. Attendees are additional people that benefitted from this expense.

Attendee External ID Considerations

Attendees can be uniquely identified outside of Concur by their External ID. This value can originate from the attendee system of record, or can be generated by Concur, depending on configuration. In order to manage (add or update) attendees using Concur web services, the attendee must have an External ID value.

Attendees that are shared in Concur (owned by the System) usually have External ID values, which are established when the attendee was added to the system. Developers that work with these attendees should use the required query parameters in the request URI, and should not include the optional AttendeeID query parameter. The External ID value in the request will identify the attendee. These requests must include the SystemOwner element, set to Yes, to indicate that the attendee is part of a shared list.

Attendees that are privately owned or part of shared lists that allow manual addition (not recommended) may not have an External ID, so they cannot initially be uniquely identified by that value. Developers that need to update private attendees (owned by the report owner) or shared attendees that do not have External IDs should use the optional AttendeeID query parameter to identify the attendee. These developers must provide an External ID value, which they can use to identify the attendee in future requests. For private attendees, this request should include the SystemOwner element, set to No, to indicate that the attendees are private. For shared attendees, this request should include the SystemOwner element, set to Yes.

NOTES:

• Posting expense report information is a multi-stage process. Refer to the Expense Reports v3 documentation for the steps required to post new expense reports and entries.

Limitations

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

Supported Content Types

• application/xml

Post attendees to an expense report entry

Request

Headers

• RFC 7235 Authorization - Authorization header with OAuth token for valid Concur user. The OAuth Consumer must have one of the following roles to post attendees for expenses in reports that they do not own:
  • Web Services Admin for Professional
  • Can Administer for Standard

Parameters

• The reportId value is returned by the Get List of Reports function, and as part of the Report-Details-Url element of the Expense Report Header v1.1 function. The entryId value is returned in the ReportKey element of the Get Report Details function.
• The attendeeId value is returned in the AttendeeKey element of the Get Report Details function, and as part of the Attendee-Details-Url value returned by this function.

URI Template

https://www.concursolutions.com/api/expense/expensereport/v1.1/report/{reportId}/entry/{entryId}/Attendees
https://www.concursolutions.com/api/expense/expensereport/v1.1/report/{reportId}/entry/{entryId}/Attendees/{attendeeId}

Payload

This request contains an Attendees parent element with an Attendee element for each included attendee. The update action only allows one attendee per request. The Attendee element contains the following child elements:

Response

Status Codes

See HTTP Status Codes

Payload

This request will return an attendee-batch-result parent element with the following child elements:

Error

Examples

Request

POST https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRksaas23dsfs/entry/n7We3qWw99u1KoWTMaLhSC$pXBYzQ1UDhn/Attendees
Authorization: OAuth {token}

<Attendees xmlns="http://www.concursolutions.com/api/expense/expensereport/2011/03">
  <Attendee>
    <AttendeeType>BUSGUEST</AttendeeType>
    <LastName>Davis</LastName>
    <FirstName>Pat</FirstName>
    <Title>CFO</Title>
    <ExternalId>224234</ExternalId>
    <Company>Len Dev</Company>
    <Custom1>N</Custom1>
    <Custom2>Meeting</Custom2>
    <CrnCode>USD</CrnCode>
  </Attendee>
  <Attendee>
    <AttendeeType>BUSGUEST</AttendeeType>
    <LastName>Fletcher</LastName>
    <FirstName>Erin</FirstName>
    <Title>Accounting Manager</Title>
    <ExternalId>344534</ExternalId>
    <Company>Len Dev</Company>
    <Custom1>N</Custom1>
    <Custom2>Meeting</Custom2>
    <CrnCode>USD</CrnCode>
    <AssociatedAttendeesCount>5</AssociatedAttendeesCount>
  </Attendee>
</Attendees>

Request: Create an Attendee Owned by the System

This allows you to create attendees for Attendee Types that are configured as Shared Lists (centrally managed).

POST https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRksaas23dsfs/entry/n7We3qWw99u1KoWTMaLhSC$pXBYzQ1UDhn/Attendees
Authorization: OAuth {token}

<Attendees xmlns="http://www.concursolutions.com/api/expense/expensereport/2011/03">
  <Attendee>
    <AttendeeType>BUSGUEST</AttendeeType>
    <LastName>Gato</LastName>
    <FirstName>Bailey</FirstName>
    <Title>Finance Manager</Title>
    <ExternalId>998238</ExternalId>
    <Company>Len Dev</Company>
    <Custom1>N</Custom1>
    <Custom2>Meeting</Custom2>
    <CrnCode>USD</CrnCode>
    <SystemOwner>Yes</SystemOwner>
  </Attendee>
</Attendees>

Response

HTTP/1.1 200 OK
Content-Type: application/xml

<attendee-batch-result xmlns="http://www.concursolutions.com/api/expense/expensereport/2011/03" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <records-succeeded>2</records-succeeded>
  <records-failed>0</records-failed>
  <AttendeeInfoList>
    <AttendeeStatus>
      <Index>1</Index>
      <Status>Success</Status>
      <Attendee-Details-Url>https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzjLoLX67fYGzI$pMGj4dZdfU/entry/nE0avYnILMdxd6MTj0$sM6iloOYz0Mzl$pX/Attendees/nFaAj038Hxv6eoOU9SvVwhK0Rj5Kc7Twl</Attendee-Details-Url>
    </AttendeeStatus>
    <AttendeeStatus>
      <Index>2</Index>
      <Status>Success</Status>
      <Attendee-Details-Url>https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzjLoLX67fYGzI$pMGj4dZdfU/entry/nE0avYnILMdxd6MTj0$sM6iloOYz0Mzl$pX/Attendees/nFaAj038Hxv3gxNiO5ei3$peY761ggLnBh</Attendee-Details-Url>
    </AttendeeStatus>
  </AttendeeInfoList>
</attendee-batch-result>

Response: Error present

HTTP/1.1 200 OK
Content-Type: application/xml

<attendee-batch-result xmlns="http://www.concursolutions.com/api/expense/expensereport/2011/03" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <records-succeeded>1</records-succeeded>
  <records-failed>1</records-failed>
  <errors>
    <error>
      <Index>1</Index>
      <message>AttendeeType Does not Exist: BUSGUEST1</message>
    </error>
  </errors>
  <AttendeeInfoList>
    <AttendeeStatus>
      <Index>2</Index>
      <Status>Success</Status>
      <Attendee-Details-Url>https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzjLoLX67fYGzI$pMGj4dZdfU/entry/nE0avYnILMdxd6MTj0$sM6iloOYz0Mzl$pX/Attendees/nFaAj038HwYk7lweHaEerudeUKgVs8ATS</Attendee-Details-Url>
    </AttendeeStatus>
  </AttendeeInfoList>
</attendee-batch-result>