User Web Service

Description
The User web service allows third-party developers or clients to add, update or inactivate Concur users at any time of day. This web service provides access to the fields on the Employee Profile form.

The User web service provides a similar level of functionality to the User Import spreadsheet, with the convenience of a web service. The User web service is not intended to be a replacement for the Employee Import.

The Travel Profile information can be viewed using the Travel Profile web service. Travel Suppliers can update the loyalty program information only.
Works With These Concur Products
  • Expense for Concur Professional/Premium
  • Expense for Concur Standard
  • Invoice for Concur Professional/Premium
  • Invoice for Concur Standard
  • Travel Request for Concur Professional/Premium
Concur Connect API Structure

Refer to Web Services > Core Concepts for:

  • Detailed information regarding the format, structure and process of making calls to a Concur Web Service.
  • Information on authentication and authorization for all Concur Web Services.
  • Information on registering and enabling partner applications to use Concur Web Services.
Product Restrictions
Concur products are highly configurable, and not all clients will have access to all features.

Partner developers must determine which configurations are required for their solution prior to the application review process. Use the Developer Forum if you have questions about the configuration settings.

Existing clients can work with Concur Advantage Technical Services to create custom applications that work with their configuration.
Resources Additional Information

User

User Password

Employee Form Field

Responses and Errors

Responses and Errors

Refer to the HTTP Codes page for details of the common responses and errors.

User Errors

The web service will not return a 4xx HTTP response code for a batch operation even when every item in the batch failed to be created or updated. The client must inspect the response to look for warnings or errors with individual batch items.

When there are errors with batch items, the first ten errors are returned in the <errors> element in the request response, which includes their error code, the item that caused the error, and the error message. Any additional error messages are truncated. This prevents a large volume of error data in the event of a formatting mistake.

Error Messages

Message Description
Maximum User Records per Batch Exceeded The batch request contains over 500 records.
Missing Required Parameters This message will be returned if:
  • Fields that are required are missing.
The Request XML is invalid The request XML is not properly formatted.
User Creation Failed The user creation process failed to complete.
Invalid Input: elementname The value for the specified element is invalid.
Form Fields are Invalid or Empty One or more of the Employee form fields are invalid or empty.
Unknown Error The web service encountered an unknown error while processing the request. Try again later.

Return to Top


Last Modified: 6/7/2013 2:55 PM PDT