Service Directory > v32.1 > Financial_Management > Put_Basic_Customer
 

Operation: Put_Basic_Customer

This service operation will add or update basic Customers that can be used as worktags only. Basic Customer data includes reference ID, Name and an Inactive boolean. Basic customers will be available as worktags, but can not be used on many financial transactions such as Customer Invoices that require fully configured customer. Use the Get Customers and Put Customers web services for maintaining full customer information.


@ - 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_Basic_Customer_Request

Element for all Basic Customer data
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
@Add_Only  boolean  [1..1]  Add Only Flag. Indicates that the service is an add only, not an update.   
Customer_Reference  CustomerObject  [0..1]  Customer Reference   
Basic_Customer_Data  Basic_Customer_Data  [1..1]  This element contains basic Customer attributes 
Validation Description
Can not switch an existing non-basic, non-worktag only supplier to be a basic, worktag only.  Can not switch an existing non-basic, non-worktag only supplier to be a basic, worktag only. 
Two Reference ID's have been provided that resolve to different instances. Please provide only one Reference ID or verify that both Reference ID's resolve to the same instance.  Two Reference ID's have been provided that resolve to different instances. Please provide only one Reference ID or verify that both Reference ID's resolve to the same instance. 
 
Validation Description
The Web Service is set to Add Only; but the Customer already exists.  The Web Service is set to Add Only; but the Customer already exists. 
top
 

Response Element: Put_Customer_Response

Element containing Put Customer Response Data
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Customer_Reference  CustomerObject  [0..1]  This is the customer that the invoice is for. This is the reference id value of the customer   
top
 

CustomerObject

part of: Put_Customer_Response, Put_Basic_Customer_Request
 
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  CustomerObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

CustomerObjectID

part of: CustomerObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Customer_ID, Customer_Reference_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
 

Basic_Customer_Data

part of: Put_Basic_Customer_Request
This element contains basic Customer data for customers used as worktags only.
 
Parameter name Type/Value Cardinality Description Validations
Customer_ID  string  [0..1]  Customer ID. This is a unique identifier for the Customer   
Customer_Reference_ID  string  [0..1]  Customer Reference ID. The Customer Reference ID can be used to uniquely identify a Customer. Unlike Customer ID, Workday will not automatically generate a Customer Reference ID if one is not received. The recommended use for Customer Reference ID is where Workday is not the source system of the Customer.   
Customer_Name  string  [1..1]  Customer Name 
Validation Description
Customer Name is already used by another Business Entity   
 
Inactive  boolean  [0..1]  Inactive Flag.   
Validation Description
Can not switch an existing non-basic, non-worktag only supplier to be a basic, worktag only.  Can not switch an existing non-basic, non-worktag only supplier to be a basic, worktag only. 
Two Reference ID's have been provided that resolve to different instances. Please provide only one Reference ID or verify that both Reference ID's resolve to the same instance.  Two Reference ID's have been provided that resolve to different instances. Please provide only one Reference ID or verify that both Reference ID's resolve to the same instance. 
top
 

CustomerReferenceEnumeration

part of: CustomerObjectID
Base Type
string
top