Service Directory > v32.1 > Resource_Management > Put_Hotel
 

Operation: Put_Hotel

Creates a new Hotel or modifies an existing Hotel. If you provide a valid ID, the operation modifies an existing Hotel. If no ID is provided, the operation creates a new Hotel.


@ - A parameter name with this symbol denotes an XML attribute within the document instead of an XML element.


Contents

 

Web Service

 

Request

 

Response

 

Element(s)

 

Request Element: Put_Hotel_Request

Element containing Hotel reference for update and all Hotel data items
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
@Add_Only  boolean  [1..1]  Add Only   
Hotel_Reference  HotelObject  [0..1]  Hotel Reference   
Hotel_Data  Hotel_Data  [1..1]  Hotel Data 
Validation Description
The Hotel Data Value "[value]" is already in use.  Spend Data instances of the same Data Value and Attribute Type is not allowed. 
[merchant_name] is already used as an alternate name.   
 
Validation Description
The Web Service is set to Add Only; but the Hotel already exists.  Create a new Hotel, or change 'Add Only' to 'false' to edit the existing Hotel. 
top
 

Response Element: Put_Hotel_Response

Element containing the Hotel Reference and Data that is sent in the response
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Hotel_Reference  HotelObject  [0..1]  Hotel Reference   
top
 

HotelObject

part of: Put_Hotel_Request, Put_Hotel_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  HotelObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

HotelObjectID

part of: HotelObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Hotel_ID, Spend_Data_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Hotel_Data

part of: Put_Hotel_Request
Element that contains Hotel Data
 
Parameter name Type/Value Cardinality Description Validations
Spend_Data_ID  string  [0..1]  Hotel Reference ID   
Hotel_Value  string  [1..1]  Hotel Value   
Merchant_Code_Reference  Merchant_CodeObject  [0..1]  A Merchant Code to map to this Hotel. If a Merchant Code is specified, it will be used on Expense Credit Card Transactions to match the specified Merchant Code to this Hotel. 
Validation Description
The Merchant Code selected is already mapped to a different Merchant: [merchant]  Each Merchant Code can only be assigned to one Merchant (Airline, Hotel, or Car Rental Agency). 
 
Alternate_Merchant_Name_Data  Alternate_Merchant_Name_Data  [0..*]  Alternate Names for Merchant are entered here. 
Validation Description
Cannot have duplicate alternate names.   
[alternate_name] is already used as an alternate name.   
[alternate_name] is already used a merchant name.   
 
Validation Description
The Hotel Data Value "[value]" is already in use.  Spend Data instances of the same Data Value and Attribute Type is not allowed. 
[merchant_name] is already used as an alternate name.   
top
 

Merchant_CodeObject

part of: Hotel_Data
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Merchant_CodeObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Merchant_CodeObjectID

part of: Merchant_CodeObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Merchant_Code  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Alternate_Merchant_Name_Data

part of: Hotel_Data
Alternate Names for Merchant are entered here.
 
Parameter name Type/Value Cardinality Description Validations
Alternate_Name_Value  string  [1..1]  Alternate Name Value   
Validation Description
Cannot have duplicate alternate names.   
[alternate_name] is already used as an alternate name.   
[alternate_name] is already used a merchant name.   
top
 

HotelReferenceEnumeration

part of: HotelObjectID
Base Type
string
top
 

Merchant_CodeReferenceEnumeration

part of: Merchant_CodeObjectID
Base Type
string
top