Service Directory > v32.1 > Resource_Management > Import_Credit_Cards
 

Operation: Import_Credit_Cards

This operation will add or update a Cardholder Listing File. Each file will load one or more Expense Credit Cards. Expense Credit Cards are used in credit card transactions. Expense Credit Card data includes Corporate Credit Card Account Reference, Employee Reference or ID, Credit Card Description, Last 4 Digits of Credit Card Number, Credit Card Expiration Date, Monthly Limit, Transaction Limit, Billing Currency Reference, Cash Access Allowed boolean, Cancel Date, Cardmember Embossed Name, Document Status Reference, Card Holder Listing File Reference, and Expense Credit Card Token.


@ - 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: Credit_Card_Header__HV__Request

Credit Card Header Request.
 
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.   
Card_Holder_Listing_File_Reference  Cardholder_Listing_FileObject  [0..1]  Reference to an existing Card Holder Listing File for update only purposes.   
Card_Holder_Listing_File_Data  Cardholder_Listing_File__HV__Data  [1..1]  Card Holder Listing File Data.   
Validation Description
The Web Service is set to Add Only; but the Card Holder Listing File already exists.  The Web Service is set to Add Only; but the Card Holder Listing File already exists. 
top
 

Response Element: Put_Import_Process_Response

Put Import Process Response element
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Import_Process_Reference  Web_Service_Background_Process_RuntimeObject  [0..1]  Web Service Background Process Runtime element   
Header_Instance_Reference  InstanceObject  [0..1]  Header Instance element   
top
 

Cardholder_Listing_FileObject

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

Cardholder_Listing_FileObjectID

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

Cardholder_Listing_File__HV__Data

part of: Credit_Card_Header__HV__Request
Element containing all Card Holder Listing File data.
 
Parameter name Type/Value Cardinality Description Validations
Card_Holder_Listing_File_Number  string  [0..1]  Card Holder Listing File Number. This is the Card Holder Listing File unique identifier.   
Card_Holder_Listing_File_Name  string  [0..1]  Card Holder Listing File Name.   
Card_Holder_Listing_File_Date  date  [0..1]  Card Holder Listing File Date.   
Credit_Card_Data  Credit_Card__HV__Data  [0..*]  Credit Card Data. 
Validation Description
Another Expense Credit Card assigned to this Employee has the same Last Four Digits of Credit Card Number.   
This credit card has an invalid payment responsibility and is unavailable for reassignment.   
This credit card has an invalid usage and is unavailable for reassignment.   
The corporate credit card account for credit card reference ID [credit card identifier] cannot be modified because there are credit card transactions associated with this credit card.   
The employee for credit card reference ID [credit card identifier] cannot be modified because there are credit card transactions associated with this credit card.   
Credit Card Category can only be Central Travel Card if the Corporate Credit Card Account Usage is for Expenses, the Payment Responsibility is Corporate, and Electronic Load Only is set to True.   
 
top
 

Credit_Card__HV__Data

part of: Cardholder_Listing_File__HV__Data
Element containing all Expense Credit Card data.
 
Parameter name Type/Value Cardinality Description Validations
Expense_Credit_Card_Reference  Worker_Credit_CardObject  [0..1]  Reference to an existing Expense Credit Card for update only purposes.   
Expense_Credit_Card_ID  string  [0..1]  Expense Credit Card ID. This is the Expense Credit Card unique identifier.   
Corporate_Credit_Card_Account_Reference  Corporate_Credit_Card_AccountObject  [1..1]  Corporate Credit Card Account Reference for the Expense Credit Card.   
Credit_Card_Category_Reference  Credit_Card_CategoryObject  [0..1]  Central Travel Card boolean for Worker Credit Card   
Employee_Reference [Choice]   EmployeeObject  [0..1]  Employee Reference for the Expense Credit Card. This will only be used in the iLOAD.   
Employee_ID [Choice]   string  [0..1]  Employee ID for the Expense Credit Card. This will only be used by the Integrations Web Service for a standard card holder listing file where the reference to an Employee in Workday is not available.   
Credit_Card_Organizations_Reference  OrganizationObject  [0..*]  Organizations for Central Travel Card   
Credit_Card_Description  string  [0..1]  Expense Credit Card Description.   
Last_4_Digits_of_Credit_Card_Number  string (4)   [0..1]  Expense Credit Card Number Last 4 Digits.   
Credit_Card_Expiration_Date  date  [0..1]  Expense Credit Card Expiration Date.   
Monthly_Limit  decimal (12, 0) >0   [0..1]  Expense Credit Card Monthly Limit.   
Transaction_Limit  decimal (12, 0) >0   [0..1]  Expense Credit Card Transaction Limit.   
Billing_Currency_Reference  CurrencyObject  [0..1]  Billing Currency Reference for Expense Credit Card.   
Cash_Access_Allowed  boolean  [0..1]  Cash Access Allowed boolean for Expense Credit Card.   
Cancel_Date  date  [0..1]  Expense Credit Card Cancel Date.   
Cardmember_Embossed_Name  string  [0..1]  Expense Credit Card Cardmember Embossed Name.   
Document_Status_Reference  Document_StatusObject  [1..1]  Document Status Reference for Expense Credit Card. The statuses are Error (this can occur if the standard card holder listing file does not provide all needed data), Active, Canceled, Deleted, and Suspended.   
Expense_Credit_Card_Token  string  [0..1]  Expense Credit Card Token will only be set by the Integrations Web Service for PCI. This Token will be a unique identifier for each Expense Credit Card. It will be used to represent the Expense Credit Card Numbers. It will get generated by Integrations.   
Reassignment_Enabled  boolean  [0..1]  Manual Reassignment Allowed boolean for Expense Credit Card   
Validation Description
Another Expense Credit Card assigned to this Employee has the same Last Four Digits of Credit Card Number.   
This credit card has an invalid payment responsibility and is unavailable for reassignment.   
This credit card has an invalid usage and is unavailable for reassignment.   
The corporate credit card account for credit card reference ID [credit card identifier] cannot be modified because there are credit card transactions associated with this credit card.   
The employee for credit card reference ID [credit card identifier] cannot be modified because there are credit card transactions associated with this credit card.   
Credit Card Category can only be Central Travel Card if the Corporate Credit Card Account Usage is for Expenses, the Payment Responsibility is Corporate, and Electronic Load Only is set to True.   
top
 

Worker_Credit_CardObject

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

Worker_Credit_CardObjectID

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

Corporate_Credit_Card_AccountObject

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

Corporate_Credit_Card_AccountObjectID

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

Credit_Card_CategoryObject

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

Credit_Card_CategoryObjectID

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

EmployeeObject

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

EmployeeObjectID

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

OrganizationObject

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

OrganizationObjectID

part of: OrganizationObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Company_Reference_ID, Cost_Center_Reference_ID, Custom_Organization_Reference_ID, Organization_Reference_ID, Region_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
 

CurrencyObject

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

CurrencyObjectID

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

Document_StatusObject

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

Document_StatusObjectID

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

Web_Service_Background_Process_RuntimeObject

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

Web_Service_Background_Process_RuntimeObjectID

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

InstanceObject

part of: Put_Import_Process_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]     
ID  Instance_ID  [0..*]     
top
 

Instance_ID

part of: InstanceObject
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@parent_id  string  [1..1]     
@parent_type  string  [1..1]     
@type  string  [1..1]     
top
 

Cardholder_Listing_FileReferenceEnumeration

part of: Cardholder_Listing_FileObjectID
Base Type
string
top
 

Worker_Credit_CardReferenceEnumeration

part of: Worker_Credit_CardObjectID
Base Type
string
top
 

Corporate_Credit_Card_AccountReferenceEnumeration

part of: Corporate_Credit_Card_AccountObjectID
Base Type
string
top
 

Credit_Card_CategoryReferenceEnumeration

part of: Credit_Card_CategoryObjectID
Base Type
string
top
 

EmployeeReferenceEnumeration

part of: EmployeeObjectID
Base Type
string
top
 

OrganizationReferenceEnumeration

part of: OrganizationObjectID
Base Type
string
top
 

CurrencyReferenceEnumeration

part of: CurrencyObjectID
Base Type
string
top
 

Document_StatusReferenceEnumeration

part of: Document_StatusObjectID
Base Type
string
top
 

Web_Service_Background_Process_RuntimeReferenceEnumeration

part of: Web_Service_Background_Process_RuntimeObjectID
Base Type
string
top