KEMBAR78
Admin Guide Integrations | PDF | Electronic Data Interchange | Invoice
Scribd
Upload
31 views2,272 pages

Admin Guide Integrations

This document provides a comprehensive overview of integrations within Workday, including setup considerations, management, and troubleshooting of various integration types. It covers the Enterprise Interface Builder (EIB), Workday Connectors, Benefits Connectors, and Financials Connectors, detailing steps and concepts for each. Additionally, it includes references and guidelines for specific integration scenarios and error handling.

Uploaded by

Ramesh
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
31 views2,272 pages

Admin Guide Integrations

This document provides a comprehensive overview of integrations within Workday, including setup considerations, management, and troubleshooting of various integration types. It covers the Enterprise Interface Builder (EIB), Workday Connectors, Benefits Connectors, and Financials Connectors, detailing steps and concepts for each. Additionally, it includes references and guidelines for specific integration scenarios and error handling.

Uploaded by

Ramesh
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 2272

Integrations

Product Summary

June 13, 2025

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | ii

Contents

Setup Considerations: Integrations.........................................................18

Launch and Manage Integrations............................................................ 23


Launch an Integration....................................................................................................................... 23
Cancel an In-Progress Integration.................................................................................................... 25
Relaunch an Integration.................................................................................................................... 25
Rerun Integration Document Delivery............................................................................................... 26
View Integration Events.................................................................................................................... 27
Audit Integration Events.................................................................................................................... 29
Concept: Mass Actions on Integration Events.................................................................................. 29
Create Integration Notifications......................................................................................................... 30
Delete Integrations and EIBs............................................................................................................ 32
Concept: Integration Schedules and Weekly Service Updates.........................................................33
Reference: Integration Message Components and Error Handling.................................................. 34
Reference: Integration Event Statuses............................................................................................. 36
Example: Schedule Integration for Last Day of Each Calendar Quarter.......................................... 36

Enterprise Interface Builder (EIB)............................................................37


Setup Considerations: Enterprise Interface Builder.......................................................................... 37
Concept: Enterprise Interface Builder............................................................................................... 41
Inbound EIBs..................................................................................................................................... 43
Steps: Set Up EIBs Using Templates from Web Service Operations.................................... 43
Set Up Inbound EIB............................................................................................................... 43
Customize EIB Spreadsheet Template.................................................................................. 46
Generate EIB Spreadsheet Template.................................................................................... 48
Set Up EIB Spreadsheet........................................................................................................ 49
Set Up Business Process Security for EIB Upload................................................................51
Launch EIB Spreadsheet Upload........................................................................................... 51
Concept: EIB Template Models and Spreadsheet Templates............................................... 53
Concept: EIB Spreadsheet Data Entry Guidelines.................................................................54
Concept: Guidelines for Spreadsheets That Launch a Business Process............................. 58
Reference: Inbound Transport Protocol Types for EIBs........................................................ 60
Reference: Inbound Integration Transformations for EIBs..................................................... 60
Reference: Inbound Integration Data Sources....................................................................... 60
Reference: EIB Upload Reports............................................................................................. 61
Example: Generate EIB Spreadsheet Template with Data.................................................... 62
FAQ: EIB Spreadsheet Templates......................................................................................... 63
Outbound EIBs.................................................................................................................................. 64
Steps: Set Up Outbound EIB................................................................................................. 64
Set Up Outbound EIB............................................................................................................ 65
Create Web Service Data Source..........................................................................................70
Create Security Proxy to Grant Report Access..................................................................... 71
Set Up Launch Parameters for Web Service Data Source....................................................72
Create HTTPS Transport Protocol......................................................................................... 75
Create Integration Transformation..........................................................................................76
Manage Outbound EIBs with Custom XSLTs........................................................................ 76
Set Up Custom Report Transformation..................................................................................77

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | iii

Set Up Dynamic Filename Definition..................................................................................... 79


Reference: Outbound Transport Protocol Types for EIBs......................................................79
Reference: Outbound Integration Transformations................................................................ 81
Reference: Outbound Integration Data Sources.................................................................... 81
EIB General Errors and Guidelines.................................................................................................. 82
View Error Messages for an EIB........................................................................................... 82
Troubleshooting: Enterprise Interface Builder........................................................................ 83
Inbound EIB Template Guidelines and Troubleshooting.................................................................. 86
Concept: Inbound EIB Template Guidelines.......................................................................... 86
Absence Management EIBs................................................................................................... 87
Benefits Administration EIBs................................................................................................ 113
Cash Management EIBs.......................................................................................................135
Compensation EIBs.............................................................................................................. 140
Compensation Review EIBs................................................................................................. 162
Custom Objects EIBs........................................................................................................... 167
Financial Management EIBs.................................................................................................170
Human Resources EIBs....................................................................................................... 193
Integrations EIBs.................................................................................................................. 269
Learning EIBs....................................................................................................................... 282
Payroll EIBs.......................................................................................................................... 307
Performance Management EIBs.......................................................................................... 347
Recruiting EIBs..................................................................................................................... 368
Resource Management EIBs................................................................................................399
Staffing EIBs......................................................................................................................... 428
Student Finance EIBs...........................................................................................................462
Talent EIBs........................................................................................................................... 466
Tenant Data Translation EIBs.............................................................................................. 475
Time Tracking EIBs.............................................................................................................. 480
Workday Connect EIBs........................................................................................................ 496

Getting Started with Workday Connectors........................................... 500


Browse Connector Templates......................................................................................................... 500
Concept: Workday Connectors....................................................................................................... 500
Reference: Benefits Connectors Catalog........................................................................................501
Reference: Financials Connectors Catalog.....................................................................................501
Reference: HCM Connectors Catalog.............................................................................................503
Reference: Student Connectors Catalog........................................................................................ 506
Reference: Third-Party Payroll Connectors Catalog....................................................................... 507
Reference: Workday Payroll Connectors Catalog...........................................................................507

Benefits Connectors................................................................................509
Setup Considerations: Cloud Connect for Benefits........................................................................ 509
Getting Started with Cloud Connect for Benefits............................................................................ 512
Concept: Cloud Connect for Benefits...................................................................................512
Concept: Planning a Benefit Provider Integration................................................................ 514
Concept: Cloud Connect for Benefits Integration Templates............................................... 514
Concept: Cloud Connect for Benefits Field Overrides......................................................... 515
Concept: Inbound Cloud Connect for Benefits Integrations................................................. 515
Create Benefit Provider Integration.................................................................................................516
Steps: Set Up Benefit Provider Integration.......................................................................... 516
Set Up Attributes and Maps in Benefits Integration............................................................. 517
Set Up Field Overrides in Benefits Integration.....................................................................519
Test and Manage Benefit Provider Integration............................................................................... 520
Set Up Test Environment for Benefits Integration................................................................520

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | iv

Include Payroll Balances in Benefits Integration.................................................................. 521


Change Benefit Provider Integration Maps.......................................................................... 522
Launch and Troubleshoot Benefit Provider Integration...................................................................523
Steps: Schedule, Launch, and Troubleshoot Benefit Provider Integration........................... 523
Concept: Benefits Integration Launch Parameters...............................................................523
Concept: Benefit Integration Error Reporting....................................................................... 529
Reference: Integration Status Reports................................................................................. 530
FAQ: Benefit Provider Integration Common Issues............................................................. 530
Open Enrollment Integration Tasks.................................................................................................533
Concept: Open Enrollment Integration Checklist................................................................. 533
Link Benefit Plans to Integration Systems........................................................................... 535
COBRA Integration.......................................................................................................................... 535
Set Up Event-Based Change Files...................................................................................... 535
Concept: COBRA Integration............................................................................................... 536
Ended Coverage Reporting.............................................................................................................538
Steps: Report Ended Coverage Once..................................................................................538
Concept: Ended Coverage Options......................................................................................539
Workday Benefits Connector...........................................................................................................542
Concept: Workday Benefits Connector................................................................................ 542
Steps: Set Up the Workday Benefits Connector V2 Integration...........................................544
Set Up Benefits Connector V2 Integration Services............................................................ 545
Set Up Benefits Connector V2 Attributes and Maps............................................................546
Concept: Benefits Connector Workflow................................................................................548
Concept: Benefits Connector V2 Change Detection............................................................ 549
Concept: Benefits Connector V2 Data Validation and Error Handling................................. 550
Reference: Benefits Connector Data Sections.....................................................................550
Reference: Benefits Connector V2 Audit Files.....................................................................552
FAQ: Benefits Connector......................................................................................................553
Workday Benefits Connector (V1)........................................................................................554

Data Initialization Service (DIS) Integration.......................................... 562


Concept: Data Initialization Service (DIS).......................................................................................562
Steps: Set Up Data Initialization Service (DIS) Integration.............................................................563
Set Up Integration Data Initialization Service................................................................................. 564
Set Up Sub-Document for Data Initialization Service (DIS)............................................................569

Document Transformation Connector...................................................571


Steps: Set Up Document Transformation Connector......................................................................571
Reference: Arithmetic Attributes for Document Transformation......................................................572
Reference: Comma-Separated Value (CSV) Attributes for Document Transformation...................576
Reference: Date/Time Attributes for Document Transformation..................................................... 578
Reference: Fixed-Length Formatting Attributes for Document Transformation...............................580
Reference: Grouped Attributes for Document Transformation........................................................581
Reference: Integration Value Attributes for Document Transformation.......................................... 582
Reference: Number Formatting Attributes for Document Transformation.......................................588
Reference: Text Insertion and Removal Attributes for Document Transformation.......................... 589
Reference: Truncation Attributes for Document Transformation.....................................................591
Reference: Validation Attributes for Document Transformation......................................................593
Reference: Document Transformation Sample Use Case.............................................................. 598
Concept: Document Transformation Connector..............................................................................600
Concept: Document Transformation and Validation....................................................................... 601

Financials Connectors............................................................................ 603

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | v

Accounting Journal Connector........................................................................................................ 603


Steps: Set Up Accounting Journal Connector......................................................................603
Concept: Accounting Journal Connector..............................................................................604
Reference: Accounting Journal Connector CSV File Format............................................... 606
Reference: Accounting Journal Connector XML Schema.................................................... 622
Ad Hoc Bank Transaction Connector............................................................................................. 663
Steps: Set Up Ad Hoc Bank Transaction Connector........................................................... 663
Concept: Ad Hoc Bank Transaction Connector................................................................... 664
Reference: Ad Hoc Bank Transaction Connector XML Schema..........................................665
Reference: Ad Hoc Bank Transaction Connector CSV File Format.....................................691
Bank Fee Analysis Connectors.......................................................................................................698
Steps: Set Up Bank Fee Statement Connectors................................................................. 698
Concept: Bank Fee Statement Connectors..........................................................................699
Reference: Bank Fee Statement Connectors XML Schema................................................ 700
Bank Statement Import Integrations................................................................................................711
Steps: Set Up Bank Statement Load Integration................................................................. 711
Concept: Bank Statement Load Integrations....................................................................... 712
Reference: Bank Statements Connector XML Schema....................................................... 713
Credit Card Integrations.................................................................................................................. 718
Steps: Set Up Integration for Credit Cards and Transactions..............................................718
Concept: Credit Card and Card Transaction Integrations.................................................... 720
Concept: MasterCard CDF3 15.01 Credit Card Transaction Integration..............................721
Concept: Visa Commercial Format 4.4 (VCF 4) Credit Card Transaction Integration.......... 723
Reference: Credit Card Formats Supported for Expense Integrations.................................724
Currency Exchange Rate Connector.............................................................................................. 725
Steps: Set Up Integration to Import Currency Exchange Rates into Workday..................... 725
Concept: Currency Exchange Rate Connector.................................................................... 726
Reference: Currency Exchange Rate Connector File Schema............................................ 726
Customer Lockbox Integration........................................................................................................ 729
Steps: Set Up Customer Payment Lockbox Integration.......................................................729
Concept: Customer Payment Lockbox Integration...............................................................730
Reference: Customer Payment Lockbox Integration File Format........................................ 735
DAS2 Integration............................................................................................................................. 740
Steps: Set Up DAS2 Integration.......................................................................................... 740
Concept: DAS2 Integration...................................................................................................742
EBICS Integrations.......................................................................................................................... 743
Steps: Set Up EBICS........................................................................................................... 743
Create EBICS Contract........................................................................................................ 744
EDI Supplier Integrations................................................................................................................ 746
Steps: Set Up Integration to Import EDI 810 Supplier Invoices........................................... 746
Steps: Set Up Integration to Export EDI 850 Purchase Orders........................................... 748
Steps: Set Up Integration to Import EDI 855 Purchase Order Acknowledgments................ 752
Steps: Set Up Integration to Import EDI 856 Advance Ship Notices....................................754
Steps: Configure the Procure-to-Pay Integrations Work Area..............................................756
Concept: EDI Supplier Integrations...................................................................................... 758
Concept: EDI Connector Pre and Postprocessor Common Use Cases...............................758
Reference: EDI Connector Pre and Postprocessor Common Use Cases............................759
Reference: Valid Element Codes for Inbound EDI 810 Files............................................... 760
Reference: Valid Element Codes for Outbound EDI 850 Files............................................ 765
Reference: Valid Element Codes for EDI 855 Purchase Order Acknowledgment Files....... 774
Reference: Valid Element Codes for Inbound EDI 856 Files............................................... 778
Reference: Purchase Order Invoice cXML Schema............................................................ 784
Reference: Purchase Order Invoice with Negative Amounts cXML Schema....................... 793
Reference: Purchase Order Issue cXML Schema............................................................... 794
Troubleshooting: EDI Integrations Complete with Warnings or Errors................................. 799
Electronic Invoice Connector...........................................................................................................802

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | vi

Steps: Set Up Electronic Invoice Connector........................................................................ 802


Steps: Configure UBL Version 2.1 Electronic Customer Invoice Integration Service Map....803
Steps: Configure cXML Electronic Customer Invoice Template...........................................808
Steps: Automate Electronic Invoice Document Delivery for cXML.......................................810
Concept: Electronic Invoice Connector................................................................................ 811
Reference: Electronic Invoice Connector XML Schema...................................................... 817
Electronic Payment Integrations......................................................................................................826
Steps: Set Up Bank Integrations for Settlement Processing................................................826
Steps: Set Up Electronic Filing 1099 Integration................................................................. 828
Steps: Set Up 1099 Electronic Filing Run Event Business Process.................................... 829
Convert Payment Integrations.............................................................................................. 830
Concept: Electronic Payments............................................................................................. 830
ELSTER Integrations....................................................................................................................... 831
Steps: Generate ELSTER Tax Declaration XML................................................................. 831
Reference: Default Mappings for German ELSTER Periodic VAT Return Integrations........832
FEC Integration............................................................................................................................... 835
Steps: Set Up FEC Integration.............................................................................................835
Concept: FEC Integration..................................................................................................... 836
Financial Journal Lines Outbound Connector.................................................................................837
Steps: Set Up Financial Journal Lines Outbound Connector...............................................837
Reference: Financial Journal Lines Outbound Connector XML Schema............................. 838
Financial Management Connector for Salesforce........................................................................... 846
Steps: Set Up Financial Management Connector for Salesforce......................................... 846
Set Up Salesforce Tenant for Financial Management Connector for Salesforce................. 848
Concept: Financial Management Connector for Salesforce................................................. 849
GoBD Integration.............................................................................................................................850
Steps: Set Up GoBD Integration.......................................................................................... 850
Concept: GoBD Integration.................................................................................................. 851
Inventory Label Data Integrations................................................................................................... 851
Steps: Set Up Integrations for Inventory Label Data........................................................... 851
Concept: Inventory Label Data Integrations.........................................................................854
Reference: Inventory Label Data Integration Data Sections................................................ 854
Payment Connector......................................................................................................................... 860
Steps: Set Up Payment Connector Integration.................................................................... 860
Concept: Payment Connector.............................................................................................. 861
Reference: Payment Connector Integration Data Sections..................................................862
Payments Inbound Integrations.......................................................................................................867
Steps: Set Up Integration to Import Payment Status Reports..............................................867
Steps: Set Up Credit Card Payment Integrations................................................................ 868
Payroll Journal Line Export Connector........................................................................................... 870
Steps: Set Up Payroll Journal Outbound Connector............................................................870
Concept: Payroll Journal Outbound Connector....................................................................871
Reference: Payroll Journal Outbound Connector XML Schema.......................................... 872
PSA Inbound Connector..................................................................................................................874
Steps: Set Up PSA Inbound Connector Integration............................................................. 874
Set Up PSA Inbound Connector Integration Attributes........................................................ 875
Concept: PSA Inbound Connector....................................................................................... 876
Reference: PSA Inbound Connector File Schema...............................................................878
Punchout Integrations......................................................................................................................909
Setup Considerations: Supplier Punchout Integration..........................................................909
Steps: Set Up Punchout Catalog Integration....................................................................... 914
Steps: Set Up Punchout Purchase Order Integration.......................................................... 916
Steps: Set Up Supplier Invoicing Integration....................................................................... 919
SAF-T Integrations.......................................................................................................................... 920
Steps: Set Up SAF-T Integration......................................................................................... 920
Concept: SAF-T Integrations................................................................................................ 922

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | vii

Supplier Accounts Integrations........................................................................................................923


Set Up Electronic Invoice Inbound Connector for Supplier Accounts.................................. 923
Reference: Electronic Invoice Connector XML Schema for Supplier Accounts....................924
Third-Party Payments Integration....................................................................................................985
Steps: Set Up Third-Party Payments Integration................................................................. 985
Concept: Third-Party Payments Integration......................................................................... 986
Travel Booking Inbound Connector.................................................................................................987
Steps: Set Up Travel Booking Inbound Connector.............................................................. 987
Map Travel Booking Inbound Connector Integration Data................................................... 989
Concept: Travel Booking Inbound Connector...................................................................... 989
Reference: Travel Booking Inbound Connector File Schema.............................................. 990
Tax ID Validation Integrations.........................................................................................................994
Steps: Set Up Tax ID Validation Integration........................................................................ 994
Reference: European VAT Information Exchange System Tax ID Types............................ 995
Example: Set Up Data Initialization Service for Tax ID Validation....................................... 996
Workday Bank Connectivity............................................................................................................ 999
Concept: Workday Bank Connectivity Integration................................................................ 999
Steps: Manage Workday Bank Connectivity........................................................................ 999
Steps: Set Up Bank Connectivity - Payments Initiation Integration....................................1004
Steps: Set Up Bank Connectivity - Import Payment Status Integration..............................1006
Steps: Set Up Bank Connectivity - Import Bank Statements Integration............................1007
Reference: Import Payment Status Files and Statuses..................................................... 1009
FAQ: Workday Bank Connectivity Integration.................................................................... 1010

HCM Connectors....................................................................................1011
Absence Third-Party Calendar Integration....................................................................................1011
Steps: Set Up Absence Third-Party Calendar Integration..................................................1011
Configure the Absence Third-Party Calendar Integration.................................................. 1012
Steps: Register Your Client-Side Service Account for Google...........................................1014
Steps: Register Your Client-Side Application for Microsoft Outlook................................... 1016
Steps: Create an External Client CredStore for Google Calendar..................................... 1016
Create a Third-Party X.509 Key Pair for Google Calendar................................................ 1017
Create an X.509 Private Key Pair for Google Calendar.................................................... 1018
Create an External Client CredStore for Microsoft Outlook............................................... 1019
Reference: Absence Third-Party Calendar Integration Output Files.................................. 1019
FAQ: Absence Third-Party Calendar Integration................................................................1020
Troubleshooting: Absence Third-Party Calendar Integration............................................. 1023
Account Provisioning..................................................................................................................... 1027
Steps: Set Up Account Provisioning Integration................................................................ 1027
Set Up Account Provisioning Integration Fields................................................................. 1028
Concept: Account Provisioning Integration.........................................................................1029
Account Provisioning Connector................................................................................................... 1030
Steps: Set Up Account Provisioning Connector Integration............................................... 1030
Concept: Account Provisioning Connector......................................................................... 1031
Affordable Care Act (ACA) Connector.......................................................................................... 1032
Steps: Set Up ACA Information Returns Connector.......................................................... 1032
Steps: Set Up ACA Mailing Connector.............................................................................. 1033
Concept: Affordable Care Act (ACA) Connectors.............................................................. 1033
Troubleshoot: Affordable Care Act (ACA) Connectors.......................................................1035
AngelPoints.................................................................................................................................... 1036
Steps: Set Up AngelPoints Integration...............................................................................1036
Steps: Set Up Worklets for SSO-Based Access to AngelPoints........................................ 1039
Concept: AngelPoints Integration....................................................................................... 1041
Assign Organizations Inbound Connector.....................................................................................1042
Steps: Set Up Assign Organizations Inbound Connector Integration.................................1042

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | viii

Set Up Assign Organizations Inbound Connector Attributes..............................................1043


View Assign Organizations Inbound Connector Integration Audits.................................... 1043
Concept: Assign Organizations Inbound Connector.......................................................... 1044
Reference: Assign Organizations Inbound Connector File Schema.................................. 1045
Core Connector: Background Check Order.................................................................................. 1047
Steps: Set Up Core Connector: Background Check Order Integrations.............................1047
Add Integration Steps to Background Check Business Process........................................1049
Concept: Core Connector: Background Check Order........................................................ 1050
Reference: File Schema for Core Connector: Background Check Order Outbound...........1051
Reference: File Schema for Core Connector: Background Check Inbound....................... 1055
Core Connector: Candidate Outbound..........................................................................................1058
Steps: Set Up Core Connector: Candidate Outbound Integration......................................1058
Core Connector: Competency Model............................................................................................1059
Steps: Set Up Core Connector: Competency Model Integration........................................1059
Concept: Core Connector: Competency Model..................................................................1060
Reference: Core Connector: Competency Model Integration Data Sections..................... 1060
Core Connector: Global Worker....................................................................................................1061
Steps: Set Up Core Connector: Global Worker................................................................. 1061
Concept: Core Connector: Global Worker......................................................................... 1062
Core Connector: Job Postings...................................................................................................... 1065
Steps: Set Up Core Connector: Job Postings....................................................................1065
Concept: Core Connector: Job Postings............................................................................1066
Reference: Core Connector: Job Postings XML Schema.................................................. 1067
Core Connector: Job Profile and Job Family................................................................................1068
Steps: Set Up Core Connector: Job Profile and Job Family Integration............................ 1068
Concept: Core Connector: Job Profile and Job Family......................................................1069
Reference: Core Connector: Job Profile and Job Family Data Sections............................1071
Core Connector: Job Requisitions................................................................................................ 1073
Steps: Set Up Core Connector: Job Requisitions Integration............................................ 1073
Set Up Core Connector: Job Requisitions Integration Attributes and Maps....................... 1074
Concept: Core Connector: Job Requisitions...................................................................... 1075
Reference: Core Connector: Job Requisitions Integration Data Sections.......................... 1077
Core Connector: LMS Outbound.................................................................................................. 1079
Steps: Set Up Core Connector: Worker for LMS Outbound Integration............................. 1079
Create Core Connector: Worker for LMS Outbound Worker Selection Criteria..................1083
Concept: Core Connector: Worker for LMS Outbound Integration.....................................1084
Reference: Core Connector: Worker for LMS Outbound Integration Data Sections...........1088
Core Connector: Location............................................................................................................. 1097
Steps: Set Up Core Connector: Location Integration......................................................... 1097
Add Custom Fields to Core Connector: Location Integration.............................................1097
Concept: Core Connector: Location................................................................................... 1098
Reference: Core Connector: Location Data Sections........................................................ 1100
Core Connector: Organization.......................................................................................................1101
Steps: Set Up Core Connector: Organization Integration.................................................. 1101
Concept: Core Connector: Organization............................................................................ 1102
Reference: Core Connector: Organization Data Sections..................................................1104
Core Connector: Positions............................................................................................................ 1104
Steps: Set Up Core Connector: Positions Integration........................................................ 1104
Add Custom Fields to Core Connector: Positions Integration............................................1105
Concept: Core Connector: Positions.................................................................................. 1107
Reference: Core Connector: Positions Integration Data Sections......................................1109
Core Connector: Worker............................................................................................................... 1111
Setup Considerations: Core Connector: Worker................................................................ 1111
Steps: Set Up Core Connector: Worker Integration...........................................................1115
Configure Core Connector: Worker Integration Attributes..................................................1119
Select Workers to Include in a Core Connector: Worker Integration..................................1123

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | ix

Map Core Connector: Worker Integration Data..................................................................1124


View Core Connector: Worker Integration Audits.............................................................. 1125
Concept: Core Connector: Worker..................................................................................... 1126
Concept: Core Connector: Worker Integration Data Mapping............................................1129
Concept: Core Connector: Worker Integration Launch Parameters...................................1130
Reference: Core Connector: Worker Integration Data Sections........................................ 1132
Directory Service........................................................................................................................... 1140
Steps: Set Up Directory Service Integration...................................................................... 1140
Map Directory Service Integration Data............................................................................. 1141
Select Workers to Include in a Directory Service Integration............................................. 1142
View Directory Service Integration Audits.......................................................................... 1143
Concept: Directory Service Integration...............................................................................1144
Concept: Directory Service Integration Data Mapping....................................................... 1146
FAQ: Directory Service Integration.....................................................................................1146
E-Verify.......................................................................................................................................... 1147
Setup Considerations: E-Verify Integration........................................................................ 1147
Steps: Set Up E-Verify Integration..................................................................................... 1151
Complete Set Up and Upgrade Prerequisites for E-Verify Integration............................... 1152
Launch E-Verify Integration Manually................................................................................ 1153
Change E-Verify Account Password.................................................................................. 1155
Concept: E-Verify Integration............................................................................................. 1156
Concept: Mass Resubmit Forms I-9 to E-Verify.................................................................1158
Image Upload................................................................................................................................ 1158
Steps: Set Up Integration to Load Worker Photos in Bulk................................................. 1158
Concept: Worker Photo Recommendations....................................................................... 1159
Inline Assessments........................................................................................................................1160
Steps: Set Up Inline Assessments Integration................................................................... 1160
Concept: Inline Assessments Integration........................................................................... 1160
Reference: Inline Assessments Integration XML Schema................................................. 1161
Kenexa Connectors....................................................................................................................... 1162
Steps: Set Up Kenexa Foundation Data Integration.......................................................... 1162
Steps: Set Up Kenexa User Provisioning Connector......................................................... 1162
Steps: Set Up Kenexa Hire Inbound Integration................................................................ 1163
Concept: Kenexa Connector.............................................................................................. 1164
Reference: Kenexa User Provisioning Attributes............................................................... 1166
Reference: Kenexa Hire Inbound Attributes.......................................................................1167
Kronos Workforce Timekeeper Outbound.....................................................................................1180
Steps: Set Up Integration for Kronos Employee Extract.................................................... 1180
Concept: Kronos Workforce Timekeeper Integration......................................................... 1181
Concept: Kronos Integration Data Mapping....................................................................... 1181
FAQ: Kronos Outbound Integration....................................................................................1182
LinkedIn Recruiter System Connect..............................................................................................1183
Steps: Set Up LinkedIn Recruiter System Connect........................................................... 1183
Steps: Set Up LinkedIn One-Click Export.......................................................................... 1184
Steps: Set Up Inbound LinkedIn Recruiter System Connect............................................. 1185
Steps: Set Up Outbound LinkedIn Recruiter System Connect...........................................1186
Set Up Scheduled LinkedIn Recruiter System Connect Integrations................................. 1187
Concept: LinkedIn Recruiter System Connect................................................................... 1189
Troubleshooting: LinkedIn Recruiter System Connect Integration..................................... 1190
Medicare Integrations.................................................................................................................... 1191
Steps: Set Up Medicare Integrations................................................................................. 1191
Concept: Medicare Integrations..........................................................................................1192
Okta............................................................................................................................................... 1193
Steps: Set Up Okta Integration.......................................................................................... 1193
Concept: Okta Integration...................................................................................................1193
Reference: Okta Integration Output Fields.........................................................................1196

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | x

Organization Inbound Connector.................................................................................................. 1196


Steps: Set Up Organization Inbound Connector................................................................ 1196
Concept: Organization Inbound Connector........................................................................ 1197
View Organization Inbound Connector Integration Audits..................................................1198
Reference: Organization Inbound Connector File Schema................................................ 1199
Salesforce.com Chatter................................................................................................................. 1203
Steps: Set Up Salesforce.com Chatter Integration............................................................ 1203
Create Custom Report for Salesforce.com Chatter Integration..........................................1204
Concept: Salesforce.com Chatter Integration.....................................................................1205
Salesforce.com Worker Sync........................................................................................................ 1206
Steps: Set Up Salesforce.com Worker Sync Integration....................................................1206
Concept: Salesforce.com Worker Sync Integration............................................................1208
Reference: Salesforce.com Worker Sync Integration Fields.............................................. 1209
Skillsoft Integration........................................................................................................................ 1210
Steps: Set Up Skillsoft Integration..................................................................................... 1210
Concept: Skillsoft Integration..............................................................................................1211
Troubleshooting: Error When Syncing Course Data with Skillsoft Integration....................1212
Social Security Number Verification Service.................................................................................1213
Steps: Set Up Social Security Number Verification Service Integration............................. 1213
Concept: Social Security Number Verification Service Integration.....................................1213
Talent Profile Inbound Connector................................................................................................. 1214
Steps: Set Up Talent Profile Inbound Connector............................................................... 1214
Concept: Talent Profile Inbound Connector....................................................................... 1215
Reference: Talent Profile Inbound Connector File Schema............................................... 1215
Unistaff Connectors....................................................................................................................... 1221
Steps: Set Up Unistaff Foundation Connector................................................................... 1221
Steps: Set Up Unistaff Hire Inbound Connector................................................................ 1221
Concept: Unistaff Connectors.............................................................................................1222
Reference: Unistaff Hire Inbound Connector XML File Schema........................................ 1224
Workday Connector for Equifax Verification................................................................................. 1267
Concept: Workday Connector for Equifax Verification....................................................... 1267
Steps: Set Up Notifications for Workday Connector for Equifax Verification...................... 1270
Steps: Enable Workday Connector for Equifax Verification............................................... 1271
Set Up Workday Connector for Equifax Verification.......................................................... 1272
Concept: Verification Inquiries............................................................................................1273
Worker Time Block Inbound Connector........................................................................................ 1274
Steps: Set Up Worker Time Block Inbound Connector......................................................1274
Set Up Worker Time Block Inbound Connector Integration Attributes............................... 1275
Concept: Worker Time Block Inbound Connector..............................................................1275
Reference: Worker Time Block Inbound Connector File Schema......................................1276

Student Connectors.............................................................................. 1279


National Student Clearinghouse Connectors................................................................................ 1279
Setup Considerations: National Student Clearinghouse Connectors................................. 1279
Steps: Set Up Integration to Export Student Degree Data.................................................1283
Steps: Set Up Integration to Export Student Enrollment Data........................................... 1285
Concept: National Student Clearinghouse Connectors...................................................... 1287
Reference: NSC Enrollment Reporting Outbound Connector............................................ 1292
Student Admissions Connectors................................................................................................... 1299
Steps: Set Up Integration to Import Student Admissions Data.......................................... 1299
Concept: Student Admissions Connectors......................................................................... 1300
Reference: Education Test Result Inbound Connector File Schema................................. 1301
Student Financial Aid Connectors.................................................................................................1306
Steps: Set Up Student Alternative Loan Integrations.........................................................1306
Steps: Set Up Student Financial Aid Data Integrations..................................................... 1307

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | xi

Steps: Set Up TSM and FAH NSLDS Transaction Outbound Integration.......................... 1308
Concept: Student Financial Aid Connectors...................................................................... 1310
Concept: Transfer Student Monitoring and Financial Aid History.......................................1316
Student Financials Connectors..................................................................................................... 1317
Steps: Set Up Integration for Student Financials Data...................................................... 1317
Concept: Student Financials Connectors........................................................................... 1318
Student Outbound Connector........................................................................................................1318
Steps: Set Up Student Outbound Connector..................................................................... 1318
Concept: Student Outbound Connector............................................................................. 1319
Reference: Student Outbound Connector File Schema..................................................... 1320
Student Records Connectors........................................................................................................ 1321
Steps: Set Up Integration to Export Student Transcripts................................................... 1321
Concept: Student Records Connectors..............................................................................1322
Reference: Student Transcript Connector File Schema.....................................................1323
Student Recruiting Connectors..................................................................................................... 1324
Steps: Set Up Integration for Student Recruiting............................................................... 1324
Concept: Student Recruiting Connectors........................................................................... 1325
Student Transaction Log Outbound Connector............................................................................ 1326
Steps: Set Up Integration to Export Student Transaction Log Data...................................1326
Reference: Student Transaction Log Outbound Connector File Schema...........................1327
The Common Application Inbound................................................................................................1327
Steps: Set Up Common Application Inbound Integration...................................................1327
Concept: The Common Application Inbound Integration....................................................1331

Global Payroll Connect......................................................................... 1332


Concept: Global Payroll Connect.................................................................................................. 1332
Third-Party Payroll Setup.............................................................................................................. 1333
Third-Party Payroll Organizations.......................................................................................1333
Third-Party Payroll Pay Groups..........................................................................................1337
Third-Party Payroll Earnings and Deductions.................................................................... 1343
External Vendor Mapping and Associations...................................................................... 1353
Third-Party Payroll Concepts..............................................................................................1354
Additional Payroll Data.................................................................................................................. 1359
Steps: Set Up Additional Payroll Data............................................................................... 1359
Concept: Additional Payroll Data........................................................................................1362
Data Changes on Demand........................................................................................................... 1362
Setup Considerations: Data Changes on Demand............................................................ 1362
Steps: Set Up Data Changes on Demand......................................................................... 1366
Create Integration System User for Data Changes on Demand........................................ 1368
Concept: Data Changes On Demand................................................................................ 1369
Concept: Data Changes on Demand Change Detection................................................... 1370
Reference: Data Sections for Data Changes on Demand................................................. 1371
Concept: PECI and DCoD Comparison............................................................................. 1399
Reference: Data Changes on Demand Request Criteria Parameters................................ 1404
Event Outbound Notifications........................................................................................................1410
Steps: Set Up Event Outbound Notifications......................................................................1410
Create Integration System User for Event Outbound Notifications.................................... 1412
Global Payroll Hub........................................................................................................................ 1413
Setup Considerations: Global Payroll Hub.........................................................................1413
Steps: Set Up Global Payroll Hub......................................................................................1415
Set Up Global Payroll Processing Checklists.................................................................... 1417
Inbound Notifications..................................................................................................................... 1418
Steps: Set Up Inbound Notifications.................................................................................. 1418
Create Integration System User for Inbound Notifications................................................. 1419
Reference: Inbound Notifications Request Sample............................................................1419

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | xii

Payroll Interfaces........................................................................................................................... 1420


Concept: Find Your Third-Party Payroll Interface.............................................................. 1420
Concept: Workday Payroll Interfaces................................................................................. 1424
Setup Considerations: Payroll Interfaces........................................................................... 1425
Payroll Effective Change Interface Connector................................................................... 1429
Payroll Interface Integration Command Center.................................................................. 1547
Event-Driven Integration..................................................................................................... 1556
Payroll Interface Configurable Output................................................................................ 1568
Third-Party Payroll Errors Collaboration.............................................................................1573
Global Payroll Reconciliation..............................................................................................1577
Payroll Interface Connector................................................................................................ 1593
Local Payroll Data......................................................................................................................... 1647
Steps: Set Up Local Payroll Data...................................................................................... 1647
Concept: Local Payroll Data...............................................................................................1648
Worker Effective Change Interface............................................................................................... 1649
Setup Considerations: Worker Effective Change Interface................................................ 1649
Steps: Set Up Worker Effective Change Interface.............................................................1652
Steps: Set Up Frequent Integration Runs for Worker Effective Change Interface..............1654
Configure Worker Effective Change Interface Integration Attributes and Maps................. 1655
Test Worker Effective Change Interface Field Overrides...................................................1659
Concept: Worker Effective Change Interface..................................................................... 1660
Reference: Staffing Events in Worker Effective Change Interface Extracts....................... 1662
Reference: Data Sections for Worker Effective Change Interface..................................... 1665
Troubleshooting: Performance Issues in WECI................................................................. 1690
External Payroll Documents and Results......................................................................................1693
Callback for External Payroll.............................................................................................. 1693
External Payroll Documents............................................................................................... 1694
External Payroll Results Inbound Integration..................................................................... 1719
Global Payroll Results........................................................................................................ 1728
Import External Payslips Integration...................................................................................1729
External Payslips REST API.............................................................................................. 1735
External Tax Documents REST API.................................................................................. 1739

Workday Payroll Connectors............................................................... 1741


ADP Check Print Integration......................................................................................................... 1741
Steps: Set Up ADP Check Print Integration.......................................................................1741
Set Up Banking for ADP Check Print Integration...............................................................1743
Concept: ADP Check Print Integration...............................................................................1744
Reference: ADP Check Print Integration Data Sections.................................................... 1745
Australian Superannuation (SuperStream) Integration................................................................. 1753
Steps: Set Up SuperStream Integration.............................................................................1753
Concept: SuperStream Integration..................................................................................... 1753
Australian Taxation Office STP Integration...................................................................................1754
Steps: Set Up ATO STP Integration.................................................................................. 1754
Concept: ATO STP Integration...........................................................................................1755
Canada Annual Tax Filing Integrations.........................................................................................1755
Steps: Set Up Canadian Revenue Agency T4 Integration................................................. 1755
Steps: Set Up Canadian Revenue Agency T4A Integration...............................................1756
Steps: Set Up Canadian Revenue Agency NR4 Integration.............................................. 1756
Steps: Set Up Revenue Agency Quebec RL-1 Integration................................................ 1757
Steps: Set Up Revenue Agency Quebec RL-2 Integration................................................ 1758
Concept: Canada Annual Tax Filing Integrations...............................................................1758
Ceridian Print Service Integration................................................................................................. 1760
Steps: Set Up Ceridian Print Service Integration............................................................... 1760
Set Up Banking for Ceridian Print Service Integration....................................................... 1761

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | xiii

Set Up Payslips and Printing for Ceridian Print Service Integration...................................1762


Concept: Ceridian Check Print Service..............................................................................1763
Check Printing Connector............................................................................................................. 1765
Steps: Set Up Check Printing Connector Integration......................................................... 1765
Concept: Check Printing Connector................................................................................... 1766
Reference: Check Printing Connector Integration Data Sections.......................................1767
Déclaration Sociale Nominative Integrations................................................................................ 1775
Set Up DSN Deposit (Machine to Machine) Integration.....................................................1775
Set Up DSN Polling (Machine to Machine) Integration...................................................... 1775
Electronic Income Withholding Order Integration..........................................................................1776
Steps: Set Up Inbound Electronic Income Withholding Order Integration..........................1776
Steps: Set Up Outbound Electronic Income Withholding Order Integration....................... 1777
Concept: Electronic Income Withholding Order Integrations..............................................1777
External Payroll Documents for Workday Payroll......................................................................... 1778
Steps: Set Up External Payroll Documents Integration for Workday Payroll......................1778
Steps: Set Up Access to Uploaded External Payroll Documents.......................................1780
Set Up External Payroll Document Types for Workday Payroll......................................... 1782
Upload Individual External Payroll Documents.................................................................. 1783
Concept: External Payroll Documents for Workday Payroll............................................... 1785
Reference: External Payroll Documents Reporting............................................................ 1787
Reference: External Payroll Documents File Schema....................................................... 1788
HM Revenue & Customs Incoming Notifications.......................................................................... 1795
Steps: Set Up HM Revenue & Customs-Incoming Notifications Integration.......................1795
Set Up HM Revenue & Customs-Incoming Notifications Integration Attributes..................1796
Concept: HM Revenue & Customs Incoming Notifications Integration.............................. 1796
HM Revenue & Customs RTI Employer Payment Summary........................................................1797
Steps: Set Up HM Revenue & Customs RTI Employer Payment Summary Integration..... 1797
Concept: HM Revenue & Customs RTI Employer Payment Summary Integration............ 1798
HM Revenue & Customs RTI....................................................................................................... 1798
Steps: Set Up HM Revenue & Customs RTI Integration................................................... 1798
Concept: HM Revenue & Customs Real Time Information (RTI) Integration..................... 1799
Service Canada ROE Integration..................................................................................................1802
Steps: Set Up Service Canada ROE Integration............................................................... 1802
Steps: Set Up Outbound Service Canada ROE Integration...............................................1802
Steps: Set Up Inbound Service Canada ROE Integration................................................. 1803
Launch Service Canada ROE Integrations........................................................................ 1804
Concept: Service Canada ROE Integration....................................................................... 1805
FAQ: Service Canada ROE Integration............................................................................. 1805
U.S. Tax Filing Integration............................................................................................................ 1806
Concept: Tax Filing Integration Launch Options................................................................ 1806
Maintain Tax Filing Categories...........................................................................................1809
Concept: Tax Filing Integration.......................................................................................... 1809
Reference: Tax Filing Reports............................................................................................1812
Example: Create Company State and Local Tax Custom Report...................................... 1815
Time Off Inbound and Payroll Input Connectors.......................................................................... 1816
Steps: Set Up Time Off Inbound and Payroll Input Connectors.........................................1816
Steps: Set Up Integration to Import Worker Time Card Data.............................................1816
Steps: Set Up Integration for Worker Payroll Data Import................................................. 1817
Concept: Time off Inbound and Payroll Input Connectors................................................. 1819
Concept: Time off Inbound and Payroll Input Data Mapping Examples............................. 1820
Reference: Worker Payroll Input File Schema................................................................... 1821
Reference: Worker Time Off Inbound File Schema........................................................... 1831
UK Civil Service Pension Files..................................................................................................... 1833
Steps: Set Up UK Civil Service Pension Files Integration................................................. 1833
Concept: UK Civil Service Pension Files Integration......................................................... 1833
Worksite Reporting Integration......................................................................................................1834

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | xiv

Steps: Set Up Worksite Reporting Integration................................................................... 1834


Concept: Worksite Reporting Integration........................................................................... 1834

Integration Business Processes.......................................................... 1836


Concept: Integration Business Processes.................................................................................... 1836
Create Integration Business Process............................................................................................1838
Set Up Integration Delivery........................................................................................................... 1839
Set Up Integration Retrieval..........................................................................................................1845
Test Transport Configuration for an Integration............................................................................1852

Integration Services.............................................................................. 1853


Template-Based Integration Management Tasks......................................................................... 1853
Steps: Set Up Template-Based Integration........................................................................1853
Create Integration System..................................................................................................1854
Set Up Integration Subscriptions........................................................................................1855
Set Up Integration Sequence Generators.......................................................................... 1856
Set Up Integration Field Overrides for a Connector...........................................................1860
Set Up Integration Field Overrides for DIS........................................................................ 1861
Select Workers to Include in Connector Output.................................................................1863
Select and Set Up Connector Output Fields......................................................................1864
Add Custom Fields to Connector Output........................................................................... 1865
Reference: Validations on Extended Fields for DIS...........................................................1866
General Integration Management..................................................................................................1867
Mass Update Integration Tags........................................................................................... 1867
Set Up Integration Attachment Service.............................................................................. 1867
Set Up Integration Custom Objects................................................................................... 1868
Attach Supporting Documentation to Integrations..............................................................1868
Change Transport Protocols...............................................................................................1869
Concept: Disable Integration Subscriptions........................................................................1870
Concept: Enumerations...................................................................................................... 1870
Reference: Preferred SFTP, FTP, and FTPS Endpoint Vendor Software..........................1871
Troubleshooting: SFTP Configuration Issues.....................................................................1872
Integration APIs............................................................................................................................. 1873
Set Up Web Service Operations for Studio Integrations....................................................1873
Concept: My Reports API...................................................................................................1873
Concept: Integration Launch API....................................................................................... 1875
Concept: Listener Service API........................................................................................... 1876
Concept: Message Queue API...........................................................................................1877
Launch Integrations Using OAuth 2.0 Bearer Tokens........................................................1880

Workday Extend.....................................................................................1882
Setup Considerations: Workday Extend....................................................................................... 1882
Workday Extend Fundamentals.................................................................................................... 1887
Install Extend Apps on Tenants......................................................................................... 1887
Create Custom Tasks.........................................................................................................1888
Concept: Workday Extend..................................................................................................1891
Concept: Extend App Components.................................................................................... 1893
Concept: App Authentication.............................................................................................. 1895
Concept: Custom Objects...................................................................................................1897
Concept: Custom Tasks..................................................................................................... 1898
Concept: Custom Tasks and Apps in Workday................................................................. 1899
Reference: Use Model Tasks to Access Extend Apps in Workday....................................1900
Reference: Workday Developer Site Glossary...................................................................1902

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | xv

Reference: Limits on Model Components.......................................................................... 1910


Reference: Orchestration Runtime Limits...........................................................................1912
Reference: Limits on Presentation Components................................................................1914
Reference: Limits on Graph API........................................................................................ 1915
Tenants.......................................................................................................................................... 1916
Concept: WCP Development Tenants............................................................................... 1916
Enable Non-Development Tenants for Workday Extend....................................................1917
Enable Proxy Access on WCP Development Tenants.......................................................1918

Workday REST API................................................................................1920


REST API Fundamentals.............................................................................................................. 1920
Concept: Workday REST APIs...........................................................................................1920
Concept: Workday REST API Date, Time, and Time Zone Handling................................ 1921
Concept: Workday REST API Pagination.......................................................................... 1924
Concept: Workday REST API File Attachments................................................................ 1925
Batch Protocol.................................................................................................................... 1930
REST API Headers.............................................................................................................1947
REST API Security and Authentication.........................................................................................1959
Concept: Workday REST API Security.............................................................................. 1959
Concept: Cross Origin Resource Sharing (CORS)............................................................ 1960
Steps: Configuring OAuth 2.0 for Your REST API Client...................................................1960
Steps: Authenticate REST API with SAML........................................................................ 1961
Prism Analytics REST APIs.......................................................................................................... 1962
Steps: Load Data into a Table Using Data Change with the REST API............................ 1962
Steps: Load Data into a Table Using the REST API......................................................... 1964
Steps: Load Data into a Dataset Using the REST API...................................................... 1966
Concept: Prism Analytics REST API..................................................................................1967
Concept: wBuckets, Buckets, and File Containers............................................................ 1968
Concept: Delimited File Example....................................................................................... 1970
Reference: File Parse Options........................................................................................... 1972
Reference: Table and Dataset Field Attributes.................................................................. 1975
Reference: Source File Format Requirements...................................................................1979
Reference: External Data Limits.........................................................................................1980
Example: Create a Table Using the Prism Analytics REST API........................................ 1980
REST API Resources....................................................................................................................1990
Reference: Budget Check.................................................................................................. 1990
Reference: Currencies........................................................................................................ 1992
Reference: Custom Object Definitions............................................................................... 1994
Reference: Custom Objects (Single-Instance)................................................................... 1996
Reference: Custom Objects (Multi-Instance)......................................................................2001
Reference: Datasets........................................................................................................... 2010
Reference: Datasets/Describe............................................................................................ 2020
Reference: Inbox Tasks......................................................................................................2026
Reference: Job Change Reasons...................................................................................... 2028
Reference: Organizations................................................................................................... 2030
Reference: Organization Types..........................................................................................2032
Reference: Supervisory Organizations............................................................................... 2033
Reference: Supervisory Organizations/Workers.................................................................2035
Reference: System Health Dashboard...............................................................................2037
Reference: Validate Worktags............................................................................................2041
Reference: wBuckets.......................................................................................................... 2048
Reference: wBuckets/Complete..........................................................................................2062
Reference: wBuckets/Files................................................................................................. 2063
Reference: Workers............................................................................................................ 2065
Reference: Workers/Business Title Changes.....................................................................2071

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | xvi

Reference: Workers/Direct Reports....................................................................................2073


Reference: Workers/History................................................................................................2076
Reference: Workers/Inbox Tasks....................................................................................... 2078
Reference: Workers/Job Changes..................................................................................... 2079
Reference: Workers/Organizations.....................................................................................2083
Reference: Workers/Pay Slips............................................................................................2085
Reference: Workers/Supervisory Organizations Managed.................................................2086
Reference: Workers/Time off Entries................................................................................. 2088
Reference: Workers/Time Off Plans...................................................................................2090
REST API Guides......................................................................................................................... 2091
Concept: Change Jobs REST APIs................................................................................... 2091
Concept: Validate Worktags REST API............................................................................. 2098
Custom Objects REST APIs.............................................................................................. 2106
User Activity Logging REST API........................................................................................2134
Global Payroll REST APIs..................................................................................................2146

Workday Web Services and Integration IDs....................................... 2152


Concept: Workday Web Services................................................................................................. 2152
Concept: Workday Web Services Best Practices......................................................................... 2153
Concept: Workday Web Services Versioning............................................................................... 2154
Concept: External Integration Headers......................................................................................... 2156
Steps: Authenticate RaaS with OAuth 2.0.................................................................................... 2157
View Web Service Version Changes Using the API Change Log................................................ 2158
Custom Objects in Workday Web Services.................................................................................. 2159
Concept: Custom Objects in Workday Web Services........................................................ 2159
Retrieve Custom Object WSDL..........................................................................................2160
Retrieve Custom Object WSDL Remotely......................................................................... 2160
Concept: XPath Queries for Custom Objects in WWS...................................................... 2161
Example: Edit Worker Additional Data using WWS........................................................... 2162
Integration IDs............................................................................................................................... 2169
Concept: Integration IDs.....................................................................................................2169
Concept: Integration IDs Best Practices............................................................................ 2171
Concept: Reference ID Maintenance................................................................................. 2171
Set Up Reference IDs........................................................................................................ 2172
FAQ: Integration IDs...........................................................................................................2172
Workday SOAP API Guidelines and Troubleshooting.................................................................. 2173
Concept: SOAP API Web Service Guidelines and Troubleshooting.................................. 2173
Concept: Add Vaccination SOAP Web Service Guidelines and Troubleshooting.............. 2173
Concept: Add Workplace Test SOAP Web Service Guidelines and Troubleshooting........ 2174
Concept: Change Benefits SOAP Web Service Guidelines............................................... 2176
Concept: Change Job SOAP Web Service Guidelines and Troubleshooting..................... 2179
Concept: Change Other IDs SOAP Web Service Guidelines and Troubleshooting........... 2182
Concept: Get Candidate SOAP Web Service Guidelines and Troubleshooting................. 2184
Concept: Get Learning Course Offerings SOAP Web Service Guidelines and
Troubleshooting............................................................................................................. 2186
Concept: Get Organizations SOAP Web Service Guidelines and Troubleshooting........... 2187
Concept: Get Payments SOAP Web Service Guidelines and Troubleshooting..................2192
Concept: Get Purchase Orders SOAP Web Service Guidelines and Troubleshooting.......2195
Concept: Get Reference SOAP Web Service Guidelines and Troubleshooting................. 2197
Concept: Get Workers SOAP Web Service Guidelines and Troubleshooting.................... 2199
Concept: Hire Employee SOAP Web Service Guidelines and Troubleshooting.................2202
Concept: Import Accounting Journal SOAP Web Service Guidelines and
Troubleshooting............................................................................................................. 2205
Concept: Import Budget SOAP Web Service Guidelines and Troubleshooting..................2209

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Contents | xvii

Concept: Import Charges for Students SOAP Web Service Guidelines and
Troubleshooting............................................................................................................. 2211
Concept: Import Payroll Input SOAP Web Service Guidelines and Troubleshooting......... 2214
Concept: Import Payroll Off-Cycle Payment SOAP Web Service Guidelines and
Troubleshooting............................................................................................................. 2220
Concept: Import Reported Time Blocks SOAP Web Service Guidelines and
Troubleshooting............................................................................................................. 2223
Concept: Import Statistic SOAP Web Service Guidelines and Troubleshooting.................2226
Concept: Import Time Clock Events SOAP Web Service Guidelines and
Troubleshooting............................................................................................................. 2231
Concept: Put Applicant SOAP Web Service Guidelines and Troubleshooting................... 2232
Concept: Put Time Clock Events SOAP Web Service Guidelines and Troubleshooting.... 2233
Concept: Request Leave of Absence SOAP Web Service Guidelines and
Troubleshooting............................................................................................................. 2235
Workday Web Services Attributes, Filters, and Patterns.............................................................. 2238
Suppress or Display Descriptor Attribute........................................................................... 2238
Concept: Disable Integration Subscriptions........................................................................2239
Concept: Import Web Service Pattern................................................................................2239
Concept: Replace_All and Delete Attributes...................................................................... 2240
Concept: Validate Only Mode for SOAP Web Services.....................................................2244
Concept: Workday Web Service API Date, Time, and Time Zone Handling......................2245
Concept: Web Services Percentage Behavior................................................................... 2246
Concept: Workday Web Services Response Filter Element.............................................. 2247
Concept: Best Practices for Submit Workday Project Web Service............................................. 2249
Reference: Workday Web Service Version Reports..................................................................... 2250
Reference: Common Workday Web Service Operation Types.....................................................2251
Reference: Rich Text Fields in WWS........................................................................................... 2251
Reference: Workday Web Services Error Messages....................................................................2253

Glossary..................................................................................................2255
Full Glossary of Terms..................................................................................................................2255

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Setup Considerations: Integrations | 18

Setup Considerations: Integrations


You can use this topic to help make decisions when planning your configuration and use of Workday
integrations. It explains:
• Why to set them up.
• How they fit into the rest of Workday.
• Downstream impacts and cross-product interactions.
• Security requirements and business process configurations.
• Questions and limitations to consider before implementation.
Refer to detailed task instructions for full configuration details.

What It Is
Workday integrations enable you to exchange data efficiently between Workday and an external endpoint.
Examples:
• Export payroll data from Workday to a third-party payroll provider.
• Import data for employee hires into Workday using Enterprise Interface Builder (EIB).
You can use Workday integrations to:
• Efficiently export and import large volumes of data.
• Initiate integrations ad hoc or on schedule.
• Complete most tasks in bulk that you can perform in Workday.

Business Benefits
Workday integrations make some tasks easier and other tasks possible. Example, an integration:
• Can save you time and effort when transferring data from other applications into Workday.
• Is necessary to send large volumes of payroll results regularly to a third-party payroll service in the
format they require.
When you need to exchange large volumes of data in a specific format with an external endpoint, Workday
integrations are a good choice. With Workday integrations, you can avoid manual re-entry of data between
Workday and an external application.

Use Cases

Use case Description


Account provisioning With Workday integrations, you can send records of
hires and terminations to other internal applications,
including Active Directory. Account provisioning
enables you to synchronize updates in Workday
with related external accounts automatically.
Payroll, tax, and benefits processing You can use Workday integrations to send worker
data on a schedule to external payroll processing
services and benefits providers.
Bulk import tasks Workday integrations enable you to load data for
large numbers of objects into Workday. Example:
You can change manager assignments for a large
number of workers.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Setup Considerations: Integrations | 19

Questions to Consider

Question Considerations
Does a Workday-delivered integration template If a Workday-delivered integration template
support your use case? supports your use case, using that template can
simplify building the integration.
Do you need to import and export data regularly, or You can configure most Workday integrations to
infrequently? run on a schedule.
Can workers at your organization build the Workday provides customer training for EIB, some
integrations using the technology approach that you Workday Connectors, and Workday Studio.
select?

Recommendations
Workday provides several integration technologies. The best technology for your use case varies
depending on the use case.

Integration Technology Description Advantages


Inbound Enterprise Interface A tool for building simple • Available in Workday tenant.
Builder (EIB) integrations that load data into • Simpler to use than other
Workday. Workday integration
technologies.
• Can use an inbound web
service as a data source.
• Can generate spreadsheet
for data entry by workers who
don't have access to Workday.
• Enables automation of
multistep data entry in
Workday (Example: Hire
business process).
• Best for one-time bulk data
loads.

Outbound Enterprise Interface A tool for building simple • Available in Workday tenant.
Builder (EIB) integrations that export data from • Relatively simple to use.
Workday.
• Can use 1 Workday Custom
Report or outbound web
service as a data source.
• Can run on schedule or launch
from business process step.

Template-Based Integrations (for Tools for building integrations • Available in Workday tenant.
specific endpoints) to specific services and vendors • Workday preconfigures much
(Example: Salesforce.com). of the template for the specific
These integrations support file endpoint it supports.
formats that are specific to the
• Integration supports vendor
service.
file format without additional
configuration required.
• Can run on schedule or launch
from business process step.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Setup Considerations: Integrations | 20

Integration Technology Description Advantages


• Simpler than Workday Studio
or WWS API.
• Best solution if you have to
integrate with the endpoint
that the integration template
supports.

Template-Based Connectors Tools for building integrations • Available in Workday tenant.


that export data of a specific type • Provides a broad range of
(Example: Worker, Organization) data fields.
and export or import data in a
• Can run on schedule or launch
Workday-defined XML format.
from business process step.
• Some Connectors can export
additional report field output if
the Connector doesn't already
include a field for that data.
• Outbound Connectors can
use Document Transformation
Connector to convert Workday
XML into the file format used
by the external endpoint.
• Best solution when Workday
doesn't provide an integration
template for your specific
endpoint.

Orchestrate for Integrations A web-based, low-code, • The central Orchestrate


drag-and-drop development for Integrations tool is
environment. Available from Orchestration Builder, a
the Workday Developer Site at drag-and-drop development
https://developer.workday.com. environment that enables you
to create complex workflows
called orchestrations without
writing code.
• Orchestrations can automate
business processes, transform
data, and facilitate real-time,
event-driven interactions with
third-party services.
• Entirely web-based. No
downloads required.
• Data is encrypted in transit
and at rest.
• Designed to handle high
volumes of data and complex
integration patterns.
• Extensible through the use of
custom logic, third-party APIs,
and Workday's extensive
library of Orchestrate
Expression Language global

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Setup Considerations: Integrations | 21

Integration Technology Description Advantages


functions and member
functions.

Workday Studio An Eclipse-based Integrated • Flexible developer tool


Development Environment (IDE). available from Workday.
You can build custom integrations • Enables you to build custom
that follow the same template- integrations that reside in your
based model as Workday Workday tenant.
Connectors.
• Studio integrations can access
data from any Workday Web
Service operation.
• Can run on schedule or launch
from business process step.
• Best solution if your
developers have completed
Workday Studio training.

Workday Web Services (WWS) This Simple Object Access • API provides access to
API Protocol (SOAP) API supports Workday data from outside of
several thousand Workday Workday.
operations. The API provides • API supports almost all
programmatic access to most operations available in
Workday functionality through Workday.
exchange of XML documents.
• Enables you to use
developers trained on non-
Workday development tools.
• Enables you to use any
development tool.

Workday REST API This API provides access to • API provides access to
a limited number of Workday a limited set of Workday
operations. operations from external
applications.
• API supports smaller
transactions than WWS API.
• Enables you to use
developers trained on non-
Workday development tools.
• Enables you to use any
development tool.

Requirements
No impact.

Limitations

Integration Technology Limitations


Inbound EIB Supports only 1 data source per EIB.
Outbound EIB Supports only 1 data source (Custom Report or
web service) per EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Setup Considerations: Integrations | 22

Integration Technology Limitations


Template-Based Integration (specific vendor) • Can be more difficult to configure than EIB.
• Each template supports a single, dedicated
vendor that you can't change. Integration
templates can't support any other endpoint,
even if use case is similar.

Template-Based Connector • Can be more difficult to configure than EIB.


• The only additional data sources you can add
are report fields.

Orchestrate for Integrations • Orchestrate for Integrations is separate from


your Workday tenant.
• Requires Orchestrate-specific training for
developers.

Workday Studio • Studio is separate from your Workday tenant.


• Requires Studio-specific training for developers.
• Studio integrations generally take longer
to build than template-based integrations,
orchestrations, or connectors.

Workday Web Services (WWS) API Requires non-Workday development expertise and
infrastructure.
Workday REST API Requires non-Workday development expertise and
infrastructure.

Tenant Setup
The Edit Tenant Setup - Integrations task enables you to:
• Disable integration subscription notifications for all integrations in your tenant.
• Require that Studio integrations include source code.

Security
Security setup varies between integration types and specific integrations. Non-EIB integrations require an
associated Integration System User (ISU) account. ISUs enable you to give an integration Get and Put
access to only the domains it needs to run the integration.

Business Processes
Workday provides 1 business process and 1 type of business process step for all integrations except EIBs:
• You can configure the Integration Process Event business process definition in the Integration
functional area to control how an integration runs. Examples:

Inbound integration 1. Initiate.


2. Retrieve file from external endpoint.
3. Fire (load data into Workday).

Outbound integration 1. Initiate.


2. Send approval request to the worker you
designate.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 23

3. After approval, fire (extract data from


Workday).
4. Send data file to external endpoint.

• The Integration business process step enables you to launch an integration from any business process
that supports this step type. View the business process definition to see if the business process
supports an Integration step. Example: You can add an integration step to the Complete Form I-9
business process. This step launches an E-Verify integration to send data for the worker.

Reporting
Workday provides these reports for integrations:

Report Description
View Integration System Displays all integration systems (EIB, Connector,
Orchestrate for Integrations, Studio, and so on) that
you've created.
View Integration Template Displays all integration templates that Workday
provides, enabling you to find the template you
need efficiently.
Integration Events Displays:
• A summary of integration events that are in
process or completed.
• Details about the status for each integration
event.

Integration Exception Audit Displays:


• Critical errors and warnings.
• Suggestions to resolve problems.

Connections and Touchpoints


Workday integrations interact with various parts of Workday, depending on the product area, purpose, and
data sources for the integration:
• Outbound integrations extract data from Workday, but don't change the data in Workday.
• Inbound integrations add and update data in Workday.
Workday offers a Touchpoints Kit with resources to help you understand configuration relationships across
your tenant. Learn more about the Workday Touchpoints Kit on Workday Community.

Launch and Manage Integrations

Launch an Integration

Prerequisites
• Security: Integration Event domain in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 24

Context
You can run integrations:
• Immediately.
• One time.
• Regularly on a schedule.
This can help you to exchange large volumes of data in a specific format with an external endpoint.
Example: You can send large volumes of payroll results regularly to a third-party payroll service in the
format they require. You can also import external data in bulk and process it in Workday.
When you configure multiple integrations with the same run schedule time, Workday prioritizes them based
on the priority configuration on the Edit Tenant Setup - Integrations task.
To avoid bottlenecks and performance issues for scheduled integrations, Workday recommends that you
use start times beyond the beginning of the hour.

Steps
1. Access the Launch / Schedule Integration task.
You can't select an integration system with critical errors.
2. (Optional) Select the Organization for manual launches. The contents of the prompt vary depending on
the Integration Process Event and on your security access:
Option Description
Owning Organization Displays when you associate the integration with
an organization. You can select the organization
or its subordinate organizations when:
• You're a member of the organization.
• You have an organizational role in the
organization.

Organization By Type Displays when the integration has no associated


organization. You can select any organization and
subordinate organization that you're a member of
or have an organizational role in.

For scheduled integrations, Workday ignores the Organization field value and bases the organization
on the Integration Process Event of the integration.
You can also select an organization through the Integration System Context field.
The Integration System Context field enables you to limit access to your integration based on either
organization or academic unit. This does not override any preexisting security prerequisites.
3. (Optional) Specify a Request Name.
Workday uses the Request Name field as the Integration Name.
4. Specify any required launch parameter values on the Integration Criteria tab. To configure a launch
parameter based on a report or calculated field, specify a Value Type of Determine Value at Runtime.

Result
When you schedule the integration, you own the schedule.
The integration background process performs required transformations and displays the appropriate
files or web service messages on the Process Monitor report. When the integration runs for a specific
organization, the organization displays on the business process event of the integration run.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 25

Related Information
Tasks
Manage Scheduled Future Processes
Create Calculated Fields

Cancel an In-Progress Integration

Prerequisites
Security: Integration Event, Integration Build, or Integration Debug domains in the Integration functional
area.

Context
You can cancel these types of integrations while they are in progress:
• Core Connector: Global Worker
• Core Connector: Worker
• Integrations that use Data Initialization Service (DIS)
• Inbound EIBs (except on the Data Load step).
• Kenexa Foundation Data
• Outbound EIBs
• WPN - ACH IAT Payment (Enhanced Performance)
• Consolidated Business Forms Printing
• DocuSign
• EIB Generate Spreadsheet
• Workday E-Signature

Steps
1. Access the Integration Events or Process Monitor report and find the integration event for your
integration.
2. From the related actions menu of the integration event, select Background Process > Abort.
3. Confirm that you wish to cancel the event. Integrations that finish quickly can invalidate your
cancellation request.

Result
Workday:
• Changes the background process status to Aborted.
• Changes the status of associated business process events to Failed.
• Attaches an integration message to the event, which explains that the current user aborted the
integration for auditing purposes.

Relaunch an Integration

Prerequisites
Security: Integration Event, Integration Build, or Integration Debug domains in the Integration functional
area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 26

Context
You can relaunch an integration event with the same launch parameters. Workday sets the launch
parameters and Organization automatically based on the previous integration event. Workday sets the Run
Frequency to Run Now.
You can't relaunch an integration event when:
• The event is more than 30 days old.
• You deleted the associated integration system.
• The integration system has Critical errors.
• You don't have security permissions to launch the integration system.
• You can't run the integration using the Launch/Schedule Integration task.

Steps
1. Access the Integration Events or Process Monitor report and find the integration event for your
integration.
2. From the related actions menu of the integration event, select Integration Event > Relaunch
Integration Event.
3. Confirm or modify the Request Name, Organization (or Academic Unit in the Integration System
Context field), and Integration Criteria.

Rerun Integration Document Delivery

Prerequisites
Security: Integration Event, Integration Build, or Integration Debug domains in the Integration functional
area.

Context
You can redeliver the integration output document without rerunning the integration if:
• Your integration runs successfully but document delivery fails.
• You need to redeliver the document for any reason.
Document redelivery uses the same transport settings as the current document delivery configuration,
and you can't override the delivery configuration. Workday appends the subsequent processes of the
integration event, and doesn't update the event status.
You can't redeliver a document when:
• The event is more than 30 days old.
• The files you want to redeliver no longer exist.
• You've deleted the EIB configuration or document delivery configuration.
• The EIB configuration or document delivery configuration has critical exceptions.
• You don’t have security permissions to redeliver the document.

Steps
1. Access the View Integration Events report and find the integration event for your integration.
2. From the related actions menu of the integration event, select Integration Event > Redeliver
Document.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 27

View Integration Events

Prerequisites
Security: Integration Event domain in the Integration functional area.

Context
View a summary of integration events that are in process or completed and see details about the
integration status, including log files whose contents:
• Vary by integration system.
• Include integration data.
• Are useful for troubleshooting.
Note: Workday provides a tenanted ISU account called Verify Status. This ISU account verifies the status
of an integration event in the background at regular intervals. ISUs have inherent permissions to the
Integration Process security domain. You can access the Do Not Allow UI Sessions option when editing
the Workday account associated with the ISU. Enable this option to prevent the ISU account from signing
in to Workday through the interface.

Steps
1. Access the Integration Events report.
2. Narrow your selection by specifying the Integration System, by Person, Status, Sent After or Sent
Before dates.
3. To open the View Background Request report and view details about the background process and
related messages, select a request.
4. To see more details in the View Background Request about the integration event, select a tab:
Option Description
Integration Details Displays information specific to the integration
event. Example: The parent business process
event, integration system, initiator, and initiation
time.
Select View Consolidated Report and Logs
or View Performance Logs to view additional
details about the integration event. These tasks
aren’t available when:
• The consolidated report has expired.
• The consolidated report is larger than 10 MB.
• The consolidated report doesn't exist.
• You deleted the integration.

Process Info The Technical Details area displays a table


of Process IDs for each child process in the
integration event. These Process IDs enable
Workday Support to troubleshoot integrations.
Output Files Displays any output and audit files generated by
the event.
Messages Displays messages details generated by the
integration during the integration event.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 28

Option Description
Child Processes Displays details about each child process in the
event.
5. If the integration event status has been processing for hours or days, as a related action on the
integration event, select Integration Event > Verify Status.
Workday refreshes the integration status:
• If the event failed, Workday displays a message and changes the status to Failed. Workday also
changes the status to Failed if the integration event is in progress for more than 7 days. You
can optionally select Integration System > Delete as a related action on the event to delete the
associated integration system.
• If the event is:
• Still in progress.
• Queued.
• Temporarily suspended during a tenant Service Update.
Workday displays a message and doesn't change the status.
• If Workday can't locate the integration, Workday displays a message and doesn't change the status.
• If the verification feature isn't running, Workday displays a message and doesn't change the status.

Next Steps
To rerun the document delivery for an EIB, access the integration event for the EIB and select Integration
Event > Re-Deliver Document as a related action.
To rerun the document delivery of an Integration Process Event, access the integration event for the
Document Delivery and select Integration Event > Re-Deliver Document as a related action.
Re-Deliver Document is available regardless of the status of the integration event. (Examples: Failed,
Processing). When you confirm the task, Workday uses the transport settings from the current Document
Delivery configuration. You can't override the configuration. Workday appends a subordinate process for
EIBs or a subsequent process for Integration Process Events. Workday doesn't update the status of the
integration event or Integration Process Event for the EIB, and Workday doesn't restart any subsequent
business process steps.
The Re-Deliver Document option isn't available if:
• The event is more than 30 days old.
• The file that you want to redeliver no longer exists.
• You've deleted the EIB configuration or Document Delivery configuration.
• The EIB configuration or Document Delivery configuration has critical exceptions.
To relaunch an integration with the same launch parameters as a previous integration run, access the
integration event and select Integration Event > Re-Launch Integration as a related action.
Re-Launch Integration is available regardless of the event status of the integration. Examples: Completed,
Failed, or Processing. When you use this task, Workday sets the Run Frequency to Run Now, and uses
the Launch Parameter values and Organization from the integration event. You can't change the launch
parameters of subsequent integration BP steps.
Re-Launch Integration isn't available if:
• The event is more than 30 days old.
• You deleted the associated integration system.
• The integration system now has critical exceptions.
Re-Launch Integration is available only for integration systems that you can launch with the Launch /
Schedule Integration task.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 29

Audit Integration Events

Prerequisites
Security: Integration Build domain in the Integration functional area

Context
You can audit outbound integrations to view the transmission data for troubleshooting and general
reporting. Workday stores the output data in 2 formats:
• The original transmission format, such as XML, CSV, or fixed-width flat files.
• A readable version that displays data in a tabular format for functional users.
Workday enables auditing based on the retention period configuration for the integration. Audit files are
available after you launch an integration and the integration extracts and transforms data. Anyone with
security permission to view integration event data can view the files. Workday automatically deletes the
audit files at the end of the retention period.

Steps
1. Access the Integration Events report.
2. Narrow your selection by specifying the Integration System, by Person, Status, Sent After or Sent
Before dates.
3. In the Integration Events report, select an integration event by selecting the event link.
4. On the View Background Process page, select the Output Files tab.
5. To open the original transmission file and the readable HTML version to view the data, select the links.

Concept: Mass Actions on Integration Events


You can relaunch, redeliver, or abort multiple integration events in the Mass Action on Integration
Events report.
You can relaunch an event if:
• The associated integration system doesn't have error messages.
• The current user can launch or schedule the integration.
• The integration system of the event can't be run using the Launch/Schedule Integration task.
• A user relaunched the integration before or is a relaunch event itself.
You can redeliver an integration event if:
• The event is less than 30 days old.
• The integration system of the event or delivery configuration of the business process don't exist or has
critical exceptions.
• You have security permissions to redeliver.
• The file exists.
• You delivered the event less than 5 times.
You can abort:
• A processing integration event.
• An integration event that supports cancellation.
You can use the Force Failure button to force integrations to fail. The integration must have been running
for at least 2 hours.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 30

When you relaunch or redeliver an integration, Workday doesn't launch all the integrations at the same
time. Workday gradually retriggers integration events in the background.
Use the View Mass Actions on Integration Events report to filter to when someone made the relaunch or
redelivery. You can't add a filter for when the relaunch or redeliver occurred.
You can review integrations that you:
• Redelivered, are waiting to redeliver, and events that Workday couldn't redeliver.
• Relaunched, waiting for relaunch, and events that Workday couldn't relaunch.
Related Information
Reference
Workday 33 What's New Post: Mass Actions on Integration Events

Create Integration Notifications

Prerequisites
Security: Integration Build domain in Integration functional area.

Context
You can configure notifications that Workday sends to specified groups for integration events, such as
launch, completion, or failure. You can send these notifications to Workday My Tasks, an email address,
or both.
Note: If your integration is connected to a business process, we recommend that you configure business
process notifications instead of integration notifications when possible to avoid potential duplicate
notification messages.

Steps
1. Access the View Integration System report.
2. Select Integration System > Configure Integration Notifications from the related actions menu of
the integration.
3. As you complete the Trigger(s) section, consider:
Option Description
Trigger on Launch Triggers when the integration launches.
Trigger on Status Triggers on the selected integration status. You
can select 1 or more of these statuses:
• Aborted
• Completed
• Completed With Errors
• Completed With Warnings
• Failed
• Not Run due to Exceptions on Future Process
• Processing
This task also displays additional statuses that
don't apply to integrations. Don't select these
statuses:
• Initiated
• Purged

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 31

Option Description
• Queued
• Skipped
• Throttled

Note: Workday sends a notification after the service update completes for your tenant when:
• You configure a notification to trigger on launch for an outbound EIB integration.
• You schedule the integration to launch during the weekly service update window.
4. (Optional) In the Conditions and Rules section, select a rule from the list or configure a new rule.
Example: You can configure a rule to notify the integration administrator when an event fails, launches,
or terminates.
5. (Optional) In the Repeat On section, select a related instance. Workday generates separate
notifications for each instance of that field.
Example: You select Launch Parameters from the prompt. Workday generates 1 notification for each
launch parameter of the integration system.
6. As you complete the Recipient(s) section, consider:
Option Description
Recipients Select by Person to send a notification message
to the worker who launches the integration.
Groups Select the active user-based security group that
receives the notification in Workday.
Email Addresses To send email notifications outside of Workday,
enter 1 or more target email addresses.
7. Configure the Message Content section. The External Field can be a report field or a calculated field.
Workday automatically includes a link to the integration event in the notification. If you have a custom
email template for integration event emails, Workday creates the message using the Message Content
that you configure here.
Example: To configure a notification that displays Wanda Smith launched an Integration Event for the
System: Production, configure these Subject elements:
Option Description
Text Event
External Field Integration Event
Text Was Launched.

Configure these Body elements:


Option Description
Field by Person
Text launched an Integration Event for the System:

Field Integration System


Text .

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 32

8. (Optional) To configure email notifications with attachments using the Output Documents option in the
External Field prompt for these integrations:
• Payroll Effective Change Interface
• Payroll Interface Connector
• Worker Effective Change Interface
Ensure that users running the integration have View access to these additional security domains, as
applicable:
• Reports: Pay Calculation Results for Pay Group (Results) - CAN.
• Reports: Pay Calculation Results for Pay Group (Results) - FRA.
• Reports: Pay Calculation Results for Pay Group (Results) - UK.
• Reports: Pay Calculation Results for Pay Group (Results) - USA.
9. (Optional) Click Preview to send a sample notification.
The sample notification contains field names, not values. Workday sends this notification using the
routing rule for general notifications that you configure in the Alerts section on the Edit Tenant Setup -
Notifications task.

Result
Workday sends the notifications when both the Trigger(s) and Conditions and Rules that you configure
occur.

Next Steps
To add links to output files, create an Integration Event Email template and select Attachment Links from
the Dynamic Content prompt.
Related Information
Concepts
Concept: Email Templates
Tasks
Create Business Process Condition Rules
Create Email Templates

Delete Integrations and EIBs

Prerequisites
• (Delete a Connector or Studio integration) Security: Integration Build domain in the Integration
functional area. You also need access to the integration domain within the functional area for the
integration (such as Integrations: Cash Management).
• (Delete an EIB) Security: Integrations: EIBs domain in the Integration functional area.

Context
You can delete any type of integration or EIB.

Steps
1. Access the View Integration System report.
2. From the related actions menu of the integration system, select Integration System > Delete.
3. Select the Confirm Delete check box.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 33

Result
When you delete an integration, Workday deletes any scheduled future processes for that integration
system.

Concept: Integration Schedules and Weekly Service Updates


Workday integrations can perform differently than expected when your tenant enters service update mode
30 minutes before the Weekly Service Update. The behavior of your integrations differs based on when the
process starts.
Consider these scenarios when you run integrations during the Weekly Service Update:

Scenario Impact
The integration starts before the tenant enters There's no impact to the integration.
service update mode and completes in the 30-
minute window before the Weekly Service Update.
The integration starts before the tenant enters When the Weekly Service Update completes,
service update mode, but doesn't complete before Workday restarts the integration. Workday won't
the Weekly Service Update begins. restart the integration when your integration:
• Encounters one of these errors after the Service
Update completes.
• Your job has been Terminated automatically
by Workday as it couldn’t finish by the start of
our maintenance window.
• 529 error code.
• Had the integration schedule run frequency set
to Run Once in the Future.
• Uses 1 of these integration templates:
• ADP PayForce
• Daily Digest
• DocuSign
• EBICS Configuration and Transmission
- For Business Process or For EBICS
Configuration
• ESignature
• Google Spreadsheet Export
• Professional Profile Resume Parsing
• WPN - AMEX Remittance v2 - CANADA,
EMEA, JAPAN, or US

You schedule the integration to start after the The integration doesn't start at the scheduled time,
tenant enters the service update mode. but will start after the Weekly Service Update.

Workday recommends that you schedule your integrations to run outside of the Weekly Service Update
when:
• An inbound integration updates data in Workday. The integration might attempt to reload the data on
completion of the Weekly Service Update.
• The integration uses dynamic date fields that rely on the integration running on a specific day. The
integration might use a different date when it restarts.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 34

• Your integration creates a file for an external process that expects a file at a certain time. The
integration might not create those files in the timeframe expected.
• The integration updates data outside of Workday. The integration might attempt to reupdate the data on
completion of the Weekly Service Update.
• Your integration sends a file outside of Workday. The integration might attempt to resend the data on
completion of the Weekly Service Update.
New inbound API calls to Workday fail when you request them during the Weekly Service Update. In-
process inbound API requests fail when the Weekly Service Update begins.
Workday fails these requests with an HTTP response code of 503 Service Unavailable or 500 Internal
Server Error.
Note: During the maintenance window, we patch our infrastructure components. As we patch our
infrastructure, we can’t guarantee which HTTP response code you will receive in a given moment – if
any. For Soap and RaaS protocols, the 500 response code is standard for most failures. Some possible
responses you can receive during the maintenance window are:

Request Type HTTP Resonse Code Response Body Text


SOAP 500 Service unavailable
RaaS 500 (relabelled to 503 in 503: Service unavailable
response body)

When you encounter these response codes, we recommend that you:


• Implement caching.
• Rerun the API call after the Weekly Service Update completes.
• Configure an exponential back-off retry mechanism for the process that generates your API requests.
Related Information
Reference
Amazon - What is Caching and How it Works
Google - Implementing Exponential Backoff
Amazon - Error Retries and Exponential Backoff in AWS
Microsoft - Implement Retries with Exponential Backoff

Reference: Integration Message Components and Error Handling

Message Severity
Integration messages have these severity levels and processing behavior:

Severity Message Example Processing Behavior Integration Event


Status
INFO Initiated process. Processing continues. Completed.
WARNING Ann Smith has missing or invalid Processing continues. Completed with
data. The value 123-456-78910 warnings.
is too long for Phone Number and
is truncated in the output. Phone
Number should have length equal
to or shorter than 12.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 35

Severity Message Example Processing Behavior Integration Event


Status

ERROR Errors during data load. See Processing continues Completed with errors.
report for details. unless the integration
reaches the maximum
number of allowable
errors.
CRITICAL Unable to complete integration Processing stops. Failed.
processing.

Message Components
Error messages provide information to help you determine the cause and solution for integration errors:

Context Identifies the source of the problem, such as the


name of the worker or integration map that caused
an error.

Condition Describes the error condition. Examples: invalid


data or empty map values.

Requirement Specifies the valid values or conditions that the


integration must meet.

Response Provides a suggested resolution to the problem.

Field Truncation
Workday truncates fields when the field size in the endpoint is smaller than the corresponding fields in
Workday. If Workday finds no other errors, Workday reports the issue as a warning when field truncation
occurs, continues processing, and transmits the data.

Inbound and Outbound Integration Error Processing


Workday processes inbound and outbound integrations differently when errors occur:

Type Processing
Inbound Integrations Workday processes the entire batch of transactions
in inbound integrations. If an error occurs, Workday
generates an error message, skips the transaction
that caused the error, and continues to process
the other transactions in the batch. Transactions
without errors execute successfully.
Outbound Integrations When an error occurs in an outbound integration,
Workday doesn't transmit any data but fully
processes the file to produce a comprehensive
error report.

Message Limits
An integration event can generate up to 500 error messages before processing stops. Although warnings
don't affect integration processing, Workday generates a maximum of 500 warnings. At 500 warnings,
Workday issues a final warning.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Launch and Manage Integrations | 36

Related Information
Concepts
Concept: Workday Scheduled Processes

Reference: Integration Event Statuses


Integration events can have these statuses:

Status Description
Aborted An integration administrator stopped the integration
event.
Completed The background process completed with no
warning or error messages.
Completed with errors The background process completed with 1 or more
error messages, but no critical messages. This
status indicates an issue that you can troubleshoot.
Completed with warnings The background process completed with 1 or
more warning messages, but no critical or error
messages.
Failed The background process had a nonrecoverable
critical error that prevented its completion and
caused it to abort. For Workday-delivered
integrations, this status can indicate a product
defect or service issue.
Not Run due to Exceptions on Future Process Workday couldn't run the background process
because the integration has critical exceptions.
Example: the EIB or schedule owner has
insufficient security.
Processing The background process is running.

Example: Schedule Integration for Last Day of Each Calendar Quarter


This example illustrates how to schedule an integration to run on the last day of each calendar quarter for 1
year.

Context
Your organization includes several legal entities. You use an external system to manage the accounting
for these entities and consolidate their data in Workday. You need to schedule an integration to import
financial results into Workday on the last day of each quarter so that you can approve the journals in
Workday. To avoid interruptions from the Weekly Service Update, you schedule the integration to run
outside of business hours.

Prerequisites
• Set up accounting journal connector named Quarterly Accounting Journal Results.
• Security: Integration Event domain in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 37

Steps
1. Access the Launch / Schedule Integration task.
2. Specify these values:

Field Enter
Integration Quarterly Accounting Journal Results
Organization Leave blank.
Run Frequency Monthly Recurrence
3. Specify any required Integration Criteria.
4. On the Schedule tab, in the Monthly Recurrence Criteria section, specify these values:

Field Enter
Months • March
• June
• September
• December

Day(s) of the Month Last Day of the Month


Start Time A time outside of business hours. Example: 11:55
PM PST.
5. In the Range of Recurrence section, specify these values:

Field Enter
Start Date Last day of this quarter
End Date 1 year from the end of this quarter
6. Click OK.

Result
We deliver accounting data from your legal entities to your accounting journals in Workday on schedule for
your approval.
Related Information
Concepts
Concept: Integration Schedules and Weekly Service Updates on page 33
Concept: Accounting Journal Connector on page 604
Tasks
Steps: Set Up Accounting Journal Connector on page 603

Enterprise Interface Builder (EIB)

Setup Considerations: Enterprise Interface Builder


You can use this topic to help make decisions when planning your configuration and use of Enterprise
Interface Builder (EIB). It explains:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 38

• Why to set it up.


• How it fits into the rest of Workday.
• Downstream impacts and cross-product interactions.
• Security requirements and business process configurations.
• Questions and limitations to consider before implementation.
Refer to detailed task instructions for full configuration details.

What It Is
EIB is an integration tool that enables you to build simple inbound and outbound integrations between
Workday and external endpoints.

Business Benefits
EIB gives you a framework to build integrations based on your unique business needs. EIB enables you to
import and export Workday data in bulk, saving you time and effort when you:
• Hire a large number of workers at the same time.
• Regularly send large volumes of data to a third party in the format that they require.
With EIB, you can avoid manual re-entry of data between Workday and an external application.
You can create an inbound EIB, then generate a spreadsheet based on that EIB. You can add data to
the spreadsheet, then load the spreadsheet into Workday. You can also generate a spreadsheet with
prepopulated rows, enabling you to understand the data requirements for each field more easily.
For EIBs based on web service operations that use Workday business processes, you can configure the
level of automation for the business process.

Use Cases
• Import accounting journals into Workday from a spreadsheet that you provide as an attachment.
• Import data into Workday from a spreadsheet to perform a bulk business process. Example: Hiring a
group of employees or requesting mass compensation changes.
• Import transactions for expense credit cards from a card issuer to process the transactions in Workday
Expenses.
• Import payroll data from external providers, such as absence or time off data, to process in Workday.
• Import off-cycle payments from external providers, such as end-of-year bonuses, to perform bulk
payments.
• Import payroll history from multiple external sources by consolidating into a spreadsheet before
importing into Workday.
• Load supplier invoices from a spreadsheet in Google Drive to process in Workday.
• Export active employee data from Workday in XML format and send it to an external endpoint with
SFTP.
• Export employee hours and billing rates from Workday in CSV format and send it to an external
Amazon Simple Storage Service bucket.
• Export employee headcount and contribution data from Workday in JSON format and send it to a life
insurance provider by email.

Questions to Consider

Questions Considerations
What data source should you use? EIB uses custom report and web service data
sources. Web services data sources retrieve
data from Workday using a Get or Find operation
from the Workday public API. Custom report data

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 39

Questions Considerations
sources are more flexible but they require some
more setup effort.
Workday requires that you specify a value for
many of the fields that custom reports and web
services provide. When the report or web service
that you select includes many unneeded fields, use
a different data source.

How should you send the data to the external Ensure that your external endpoint is compatible
endpoint of an outbound EIB? with the transport protocol of your EIB. Example:
HTTPS, SFTP.

Recommendations
• Use the Workday Web Service API documentation to review available inbound and outbound web
service operations.
• For outbound EIBs, review available Workday reports and report data sources to find reports that match
your data needs.
• Determine the type of external endpoint for outbound EIBs, such as email server or SFTP server, and
use the corresponding transport.
• When the web service operation of an inbound EIB is based on a Workday business process, review
the business process definition. In your EIB spreadsheet, configure the processing rules of the business
process to suit your business needs.

Requirements
No impact.

Limitations
EIBs can only use 1 data source:
• Inbound EIBs can use only 1 Workday Web Service operation as a data source.
• Outbound EIBs can use only 1 custom report or Workday Web Service operation.
EIBs include all fields from the web service operation or custom report. You can't select which fields to
include or exclude.
Outbound EIBs can’t export data in XSLX format. You can export data in CSV format, then import the CSV
file into Microsoft Excel.

Tenant Setup
No impact.

Security
These domains in the Integration functional area:

Domains Considerations
Integration Build Enables you to:
• Create or edit an EIB.
• View an integration system or EIB.

Integration Configure Enables you to configure an EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 40

Domains Considerations
Integration Event Enables you to:
• Launch an EIB.
• View resulting integration events for the EIB,
including integration output documents.

Integration Reports Enables you to view integration reports, including


reports for integration events, exception audits,
messages, and integration IDs.
Integrations: EIBs Enables you to set up and launch an EIB.

To schedule and launch an EIB, you must have:


• Access to a custom report that an outbound integration uses as a data source, unless you use a
security proxy to run the report from another account.
• Get permission on a Workday Web Service operation that an outbound integration uses as a data
source.
• Put permission on a Workday Web Service operation that an inbound integration uses as a transport
protocol.

Business Processes
Inbound EIBs can use Workday business processes, by using the corresponding web service operation, to
enter data into Workday.

Reporting

Report or Dashboard Description


Integration Events Displays:
• A summary of events that are in process or
completed.
• Details about the status for each integration
event.

Public Web Services To verify that you have access permission, select
Security > View Web Service Operations
Security Groups from the related actions menu of
a web service.
Supported Inbound EIB Operations Displays:
• Available web service operations, excluding Get
operations.
• The parent Workday Web Service for each
operation.
• Available web service operations for generating
a spreadsheet with data.
The report also indicates whether the web service
operation enables you to rescind business
processes in bulk.

View Integration System Displays all EIBs that you create.


EIB Dashboard Displays worklets for:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 41

Report or Dashboard Description


• EIB integration events by EIB type.
• Success metrics.
• Success metrics by EIB type.
You can set up the dashboard and add the worklets
using the Maintain Dashboards report.

Scheduled Future EIBs Exception Audit Displays:


• EIBs that the owner can't launch due to
insufficient security.
• EIBs that business process steps can't trigger
due to insufficient security. Modify the security
of the worker specified in the workflow step
or assign a different worker to the business
process step.
When you don't modify the security permissions
of the scheduled owner or transfer ownership of
an EIB with exceptions, the integration fails with a
process status of Not Run due to Exceptions on
Process Definition.

Connections and Touchpoints


Workday integrations interact with various parts of Workday, depending on the product area, purpose, and
data sources for the integration:
• Outbound EIBs extract data from Workday but don't change the data in Workday.
• Inbound EIBs add and update data in Workday.
Workday offers a Touchpoints Kit with resources to help you understand configuration relationships across
your tenant. Learn more about the Workday Touchpoints Kit on Workday Community.
Related Information
Concepts
Concept: EIB Template Models and Spreadsheet Templates on page 53
Enterprise Interface Builder (EIB)
2022R2 What’s New Post: EIB Dashboard
Tasks
Steps: Set Up EIBs Using Templates from Web Service Organizations on page 43
Steps: Set Up Outbound EIB on page 64
Steps: Set Up Dashboards and Landing Pages

Concept: Enterprise Interface Builder


You can use Enterprise Interface Builder (EIB) to build simple inbound and outbound integrations between
Workday and external endpoints. EIB gives you a framework to build your own integrations based on your
unique business needs.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 42

EIB Type Description

Inbound You can upload data into Workday using:


• An attachment.
• A REST-based URL.
• A file transfer from an external SFTP, FTP/SSL, or FTP endpoint.

Outbound You can export data from Workday in various formats, such as:
• CSV
• Google Data (GData)
• JavaScript Object Notation (JSON)
• Really Simple Syndication (RSS)
• Text files
• Workday XML
You can then send the data to an external endpoint using various
protocols, such as:
• AS2
• Email
• SFTP, FTP/SSL, or FTP
• HTTPS

You can design EIBs with the Create EIB task, which guides your configuration with appropriate options
based on the data flow. You can launch EIBs using the Launch / Schedule Integration task.

EIB Components
An EIB has 3 components:

Get Data This component can indicate:


• The data Workday receives from an external
source (example: a spreadsheet of budget data)
and the location of that data (example: a specific
URL or FTP site).
• The data that the integration extracts from
Workday. Example: a specific custom report.

Transform This component converts the data into a format


that Workday or the receiving external endpoint
can understand. You can use a transformation
that Workday delivers or create your own custom
transformation.
Deliver This component defines how Workday imports
data from or exports data to an external endpoint.
Example: email, SFTP, or web service.
Related Information
Reference
Workday 32 What’s New Post: Enterprise Interface Builder

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 43

Inbound EIBs

Steps: Set Up EIBs Using Templates from Web Service Operations

Prerequisites
• Access the Supported Inbound EIB Operations report to see:
• All available web service operations, excludes Get operations.
• The parent Workday Web Service for each operation.
• The web service operations available for generating a spreadsheet with data, if any.
• If the web service operation supports mass rescinding of business processes.
• Review the Workday Web Service API documentation and familiarize yourself with the details of the
web service operation.
• Review the Public Web Services report to verify that you have access permission. Select Security >
View Web Service Operations Security Groups from the related actions menu of a web service.

Context
To load large amounts of data into Workday in bulk, create an Enterprise Interface Builder integration.

Steps
1. Set Up Inbound EIB on page 43.
Create an EIB based on an inbound, public Workday Web Service operation.
2. (Optional) Create an Integration System User (ISU) and grant the ISU Get and Put access to the
Integration Event security domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. From the related actions menu of the integration system for the upload, select Template Model >
Generate Spreadsheet Template.
To maintain the correct spreadsheet format, don't change the .xml or .xlsx file extension.
Security: these domains in the Integration functional area:
• Integrations: EIBs
• Integration Configure (including Get and Put)
• Integration Event
4. Customize EIB Spreadsheet Template on page 46.
To customize the template, edit the EIB template model.
5. Generate EIB Spreadsheet Template on page 48.
6. Set Up EIB Spreadsheet on page 49.
Enter business data into the spreadsheet.
7. Launch EIB Spreadsheet Upload on page 51.

Set Up Inbound EIB

Prerequisites
Security:
• Integration Build domain in the Integration functional area.
• Integration Process domain in the Integration functional area.
• Put access to the domain that secures the web service operation or custom report that your EIB uses.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 44

Context
You can import data into Workday in bulk by creating an inbound EIB. You can import data using these
external sources:
• A custom object spreadsheet.
• A spreadsheet based on a Workday Web Service operation.

Steps
1. Access the Create EIB task.
2. As you complete the Get Data page, consider:
Option Description
Retrieval Method When you select:
• Amazon Simple Storage Service, enter your
S3 bucket name in the Bucket field. You can't
specify a folder in this field.
• FTP/SSL, enter the address using 1 of these
formats:
• Implicit SSL: ftpse://x.x.x.x:port-number
• Explicit SSL: ftpse://x.x.x.x:port-number
When you don’t specify a port number,
Workday uses port 990 for implicit SSL and
port 21 for explicit SSL.
• Google Drive, select a web service
spreadsheet template in the Data Format
section.
Decompression, decryption, and delete after
retrieval aren't available with this option.
• SFTP, enter the address using this format
(when you don’t specify a port number,
Workday uses the default):
• sftp://x.x.x.x:port-number
• REST URL, enter the host name or server
address in http://www.example.com/rest format
for the REST Endpoint.

Directory (FTP/SSL and SFTP only) Name is case-


sensitive. Include a leading slash (/) only for a full
path, not a relative path.
Use Temp File (FTP/SSL and SFTP only) Select this check box
to write the output to a randomly named file.
Workday renames the file to the correct name
when it completes the data transfer. This option
prevents automatic scripts from retrieving the
file from the FTP server before the data transfer
completes.
File Name Enter the name or regular expression (regex)
pattern for the file to upload into Workday. This
field is case-sensitive. Workday doesn't support
full regex syntax for file retrieval. Workday only
supports (*) and (?) characters as wild cards

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 45

Option Description
in the filename pattern. For SFTP and FTP/
SSL transport protocols, entering an asterisk (*)
character at the start of this field isn’t valid for
regular expressions.
For Amazon Simple Storage, you can retrieve
files from folders using this format: folder1/
folderN/filename.format.

Decrypt Using (FTP/SSL and SFTP only) To decrypt the


uploaded file using Pretty Good Privacy (PGP),
select the PGP private key of the key pair you
generated to decrypt the inbound integration file.
Restricted To Select the target environment for this transport
protocol.
When you don't select an environment, Workday
applies the retrieval method to each environment
in which the integration runs.
Each environment can have only 1 transport
protocol. To ensure that you don't exchange data
between test and nontest endpoints, create a
separate transport for each environment.

File Type Select:


• Web Service Spreadsheet Template to import
data into a web service using a spreadsheet.
Select a public, inbound web service operation
from the Web Service Operation prompt.
• Custom Object Spreadsheet Template to
import data into a custom object. Select
an active custom object definition from the
Custom Object prompt. These items aren't
available:
• Custom object definitions that you haven't
activated yet.
• Custom objects that use instance
references.
• Effective-dated custom objects.
• Multi-instance custom objects that don't
have their Reference ID set.

3. (Optional) As you configure the Details section for your delivery method, consider:
Option Description
Decrypt Using (FTP/SSL and SFTP only) Select a PGP private
key of the key pair that you generated to decrypt
the inbound integration file.
When you decrypt an inbound integration file, you
can also:
• Include an integrity check of the data in the file.
• Digitally sign the file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 46

Option Description
Force Integrity Check (FTP/SSL and SFTP only) To verify that the
encrypted file didn’t become altered or corrupt
during transport, select this check box.
Digital Signature Validation Using (FTP/SSL and SFTP only) To verify the origin of
the encrypted inbound file, select a PGP public
key provided by your trading partner.
4. As you complete the Transform page, consider:
Option Description
Transformation Type Select from:
• Custom Transformation: Select a custom
transformation that you created on the Create
XSLT Attachment Transformation task.
• Template Model: Only applicable if the format
of the data source is a spreadsheet template.
• Delivered Transformation: Don’t use.

5. As you complete the Deliver page, consider:


Option Description
Delivery Method Select a method to define the destination of the
inbound data.

Next Steps
When your data source is a spreadsheet template based on a web service operation:
• Generate a spreadsheet template.
• Generate a spreadsheet template populated with Workday data.
When your EIB uses the Google Drive retrieval method:
• Select Enterprise Interface > Authorize for Google Drive from the related actions menu to
authenticate with Google.
• Select a Google account to store and retrieve EIB spreadsheets. Grant permission for Workday to
manage Google Drive files that you’ve created with Workday.
• Use the Workday Account > Edit related action to assign an integration system user to run the EIB.
• Use the Enterprise Interface > Assign Google OAuth Token to Workday Account related action to
assign the Google Drive OAuth Token you created to the integration system user you assigned.
Launch or schedule the integration to upload data into Workday.
Related Information
Reference
2020R2 What’s New Post: Google Drive Support in Inbound EIBs
Bucket Restrictions and Limitations

Customize EIB Spreadsheet Template

Prerequisites
• Generate a baseline EIB spreadsheet template and review the spreadsheet details.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 47

• Security: These domains in the Integration functional area:


• Integrations: EIBs
• Integration Configure
• Integration Event

Context
You can customize EIB spreadsheets to meet business requirements by modifying the worksheets, areas,
and columns of the template model.
You can create multiple versions of a template model for the same data source type, but each version
requires its own EIB definition. However, when you populate multiple spreadsheets based on the same
template model, you can use the same EIB for each upload.

Steps
1. Select Template Model > View as a related action on the integration system.
2. (Optional) To hide an area, select Template Model Area > Hide from the related actions menu on the
section.
3. (Optional) To edit column values, select Template Model Column > Edit Details from the related
actions menu on the column.
The combined list of reference IDs for permitted values must not exceed 255 characters to ensure that
the spreadsheet displays the permitted values.
Note: Shortening reference IDs can cause other integrations to fail.
4. As you complete the Edit Template Model Sheet or Edit Template Model Area task, consider:
Option Description
Separate Type Column Select this check box to ensure that each cell in
the ID Value column provides a prompt listing all
valid ID values.
Value Override Workday adds this value to the spreadsheet when
the integration runs.
Reference ID Type When more than 1 reference ID type is available,
Workday populates the first type alphabetically.
You can select a different type from the prompt.
5. (Optional) To insert columns for fields that accept multiple values, such as worktags, select Template
Model Column > Maintain Additional Columns from the related actions menu of a column.
Example: You can create additional worktag columns in a financial spreadsheet and assign multiple
worktags to a single entry line.
6. (Optional) To customize the template for a web service operation based on a business process, select
Edit Business Processes for Template Model on the Business Process tab.

Next Steps
Generate an EIB spreadsheet template.
Related Information
Reference
Reference: Integrations and Web Service Limits

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 48

Generate EIB Spreadsheet Template

Prerequisites
• Customize your EIB Spreadsheet Template.
• Security: These domains in the Integration functional area:
• Integration Configure
• Integration Event
• Integrations: EIBs

Context
You can generate an EIB spreadsheet template to populate with data from an external source. You can
either:
• Generate an empty spreadsheet.
• Generate a spreadsheet with data.
Generating a spreadsheet with data enables you to understand the data requirements more easily by
showing current Workday data along with the column labels. You can use the Supported Inbound EIB
Operations report to identify which web service operations support generation with data.
When you generate a spreadsheet using the Web Service Spreadsheet Template file type, Workday
displays the web service version on the generated spreadsheet.

Steps
1. Access the View Integration System report.
2. From the Integrations System prompt, select your EIB.
You can enter the name of the EIB or search alphabetically or by template category.
To filter by a list of mostly EIBs, select By Template Category > Integration.
To determine whether an integration system is an EIB:
a. Access the related action menu of the integration system.
b. Verify that Enterprise Interface Builder displays in the Integration Template field.
If you don't find the EIB you need, you can select Create. You must have access to create integration
systems.
3. Select Template Model > Edit from the related actions menu of the EIB.
4. (Optional) To generate a spreadsheet with data, select Edit Template with Data Options. Configure a
Filter for your template:
Option Description
Reference ID Specify 1 or more ID and ID Type pairs.
Condition Rule Specify 1 or more rule conditions. If Workday
displays an error message, use a reference ID
filter instead.

Workday doesn't require a filter for EIBs created before v28.2 that have support for spreadsheet
generation.
5. From the related actions menu of the EIB, select 1 of:
• Template Model > Generate Spreadsheet Template
You can generate XLSX spreadsheets in Google Drive when you configure your EIB with the Google
Drive retrieval method and a Google OAuth Token. Workday uses the token linked to the EIB

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 49

that you selected on the Integration System configured for Template Model field to generate
a spreadsheet in the associated Google Drive. To avoid formatting errors, we recommend not
converting the spreadsheet into a Google Sheet.
• Template Model > Generate Spreadsheet with Data
When you open and save an XML spreadsheet, Excel truncates fields with base64 data or other
long text fields that exceed 32,767 characters.
For XLSX spreadsheets, Workday requires that you edit the template model to hide any columns
with base64 or other long text fields that exceed the 32,767 character limit.
Related Information
Tasks
Create Integration System on page 1854

Set Up EIB Spreadsheet

Prerequisites
• Generate an Enterprise Interface Builder (EIB) spreadsheet template in Workday.
• Retrieve the required reference IDs using the Integration IDs report. Spreadsheet columns with a
format of Lookup must be populated with a reference ID.
• Security: Business Process Administration domain in the System functional area.

Context
You can save time when transferring data in bulk from other applications into Workday by entering
reference IDs and business data into an EIB spreadsheet. For business processes, you can select
processing options in your spreadsheet to trigger review and approval workflow, or automatically complete
workflow steps. You can also process and perform actions in Workday with the data you upload.

Steps
1. (Optional) For high-volume business process EIBs, run the Business Process Configuration Options
report to identify allowed subprocesses for your business process.
When your business process configuration includes subprocesses that have no corresponding
spreadsheet section, you can run the spreadsheet upload for the supported subprocesses. However,
you must complete the unsupported subprocesses in Workday.
When the spreadsheet is based on an Import Web Service operation with multiple business
subprocesses, Workday displays separate sheets for each subprocess and for the:
• Header sheet.
• Line sheet for the business process. Line keys must be unique across header keys.
• Overview sheet for business processes and subprocesses.
2. Open your empty spreadsheet template.
3. (Optional) For high-volume business processes, select an option in the Processing Instruction prompt
to specify the level of workflow automation for the main process and each supported subprocess.
Option Description
Manual Processing When you select this option for a subprocess,
you can enter partial data in the corresponding
spreadsheet section and the remaining data in
Workday.
Provide all required data for the main process,
even when the automation level for this process is
manual.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 50

Option Description
Automatic Processing When available on a business process, Workday
automatically completes workflow steps for a
process or subprocess and bypasses:
• Approvals
• Document reviews
• Questionnaires
• Notifications
• To do tasks
Enter data in all of the fields marked Required in
the related worksheet. These fields represent the
minimum amount of data required to automate
the business process fully. Your business process
configuration might require other fields.
The EIB load initiates the event and finishes.
Workday processes the workflow steps and
subprocesses of the event asynchronously.
The EIB can complete quickly but the overall
business process can take longer to complete in
the background.

Skip Processing when Step is marked This option is only available on subprocesses.
Optional
Run Now Select to complete the business process before
the EIB finishes loading. Although this option
Run Now with Automatic Processing
causes the business process to complete more
quickly, it affects the performance of the EIB load.
Example: Select when you want to chain together:
• An EIB and a Studio integration and the
subsequent integration depends on the EIB
completing.
• Multiple EIBs.

Note: Workday recommends selecting a Processing Instruction for each subprocess row.
You can also enter an optional Processing Comment that Workday adds to the business process
event for each worker.
4. Manually populate the spreadsheet with the required reference IDs to protect cell formatting.
Note: When you copy and paste reference IDs from the Integration IDs report, you can overwrite the
data type format of the spreadsheet cells.
Columns that contain reference IDs enable you to select a specific reference ID type.
5. Provide any other necessary information.
Related Information
Concepts
Concept: Inbound EIB Template Guidelines on page 86

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 51

Set Up Business Process Security for EIB Upload

Prerequisites
Security: Security Configuration domain in the System functional area.

Context
Before you upload data into a high-volume business process with the Enterprise Interface Builder (EIB),
configure security for the web service that initiates the business process.

Steps
1. Access the View Security for Securable Item report.
2. In the Domain Item field, search for the business process that receives data from the spreadsheet
upload.
Note: Due to naming differences in the time off business processes and web services, use the web
service name to find the correct domain item. Search for Adjust Time Off rather than Correct Time Off
and Enter Time Off instead of Request Time Off.
3. From the search results, select the web service task that corresponds to the business process.
4. Select Business Process Policy > Edit from the related actions menu of the applicable business
process listed in the Initiating Action for Business Process column.
5. Under Who Can Start the Business Process, find the web service initiating action for the business
process. Example: Request One-Time Payment (Web Service).
6. Select 1 or more Security Groups that can launch the business process through the web service.
Example: Select Compensation Administrator for a one-time payment upload.

Next Steps
Enable the new security policy using the Activate Pending Security Policy Changes task.

Launch EIB Spreadsheet Upload

Prerequisites
• Set up your inbound Enterprise Integration Builder (EIB) integration.
• Generate a spreadsheet template in Workday and populate it with data.
• Security:
• Put permission on the Workday Web Service that your EIB uses as a transport protocol.
• Integrations: EIBs domain in the Integration functional area.
• Integration Event domain in the Integration functional area.

Context
To import spreadsheet data into Workday, launch an EIB upload. Run every EIB upload process in a
sandbox environment before uploading data into your production environment. To troubleshoot errors
before you run a full upload, select these launch options:
• Validate Only Load
• Add Errors to Attachment

Steps
1. Access the Launch / Schedule Integration task.
You can't select an integration system with Critical errors.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 52

2. On the Integration prompt, select the EIB to launch.


3. (Optional) To schedule an integration for later, select another frequency on the Run Frequency prompt.
4. As you configure the Integration Criteria, consider:
Option Description
Integration Attachment Select an existing file or create a new attachment.
Load Error Limit The default Load Error Limit is Unlimited, which
sets the limit to 10000 errors before Workday
stops processing the upload. To change the limit,
select an option between 1 and 10000.
Load Error Limit isn't available to EIBs that use:
• Web services that use custom objects.
• Import web services.

Validate Only Load (Not available for EIBs that use custom objects.)
Select this check box to create a trial run before
performing an actual upload.
Workday validates the data until it reaches the
Load Error Limit, after which it attaches a failure
report to the integration event.
Validate Only Load applies only to validations
that Workday documents in the Workday API
documentation. Documented validations include
line level validations but don't include:
• Custom validations or validations that occur
postprocessing.
• Validations that occur at the operation level
after Workday persists data.

Add Errors to Attachment (Not available for EIBs that use Import
web services. Use the Errors & Warnings
Spreadsheet instead.)
Select this check box to create an Excel
spreadsheet attachment in the Integration
Events report. Workday inserts comments in the
key fields of rows that have errors.

Errors & Warnings Spreadsheet (Available only for EIBs that use Import web
services.)
Select this check box to create an Excel
spreadsheet attachment in the View Background
Process report for the EIB upload.
The spreadsheet includes only headers and lines
that have standard and custom validation errors
and warnings.
The integration generates messages after
completing the Import Web Service requests.
Workday inserts comments about these errors
and warnings in the Header Key field of each row.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 53

Option Description
Handle Import Processing Errors (Available only for EIBs that use Import web
services v43.0 or greater.) Selected by default.
Enables Workday to report on these types of
import processing errors:
• Update conflict errors. Example: Duplicate
record inserts.
• Custom validation errors.
When Workday encounters these types of errors,
it reports them on the View Background Process
page. If the EIB fails to load, you can view the
error and address the issue. When you clear the
check box, Workday no longer reports these types
of errors on the View Background Process page.

Google Drive File (Only available for EIBs that use the Google Drive
retrieval method.) Select a file to retrieve from
Google Drive. Workday retrieves the spreadsheet
based on the unique Google Drive File ID
assigned when you generate the spreadsheet.

Result
The integration runs at the scheduled time, uploading the data as if you entered it manually.
Related Information
Concepts
Concept: Import Web Service Pattern on page 2239
Tasks
Cancel an In-Progress Integration on page 25
Reference
Reference: Common Workday Web Service Operation Types on page 2251
API Documentation: Workday REST Services Directory
API Documentation: Workday Web Services Directory

Concept: EIB Template Models and Spreadsheet Templates


To load data into Workday using Workday Web Services, Workday provides template models and
corresponding spreadsheet templates. The template model:
• Represents the columns associated with a particular Workday Web Service definition.
• Provides the basis for both generating a spreadsheet template and transforming spreadsheet data
during an upload.

Generating Template Models


Each spreadsheet template is based on a template model that defines the column information for
an upload. When you generate a spreadsheet using the Web Services Spreadsheet Template file
type, Workday displays the web service version on the generated template. To simplify data entry and
streamline the upload process, you can edit the template model. Examples:
• Override column values.
• Provide your own labels and cell comments.
• Reorder worksheets.
• Hide unwanted items to customize the template for a specific purpose.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 54

To update the web service version of your template model without losing customizations, you can use the
Generate Merged Template Model related action.
To configure a spreadsheet upload, use the Create EIB task. When you select a spreadsheet template as
a data source, Workday completes the EIB configuration by:
• Creating a template model.
• Selecting a data transformation.
• Selecting a Workday Web Service.
From the related actions menu of the EIB, you can view and edit the template model and generate your
own spreadsheet template for data entry.
You can create multiple template models for different purposes. Example: To upload annual compensation
changes into several plan types, you can create separate template models for:
• Base pay.
• Bonus plan data.
• Allowance plan data.
For each template model, you can hide the columns that aren’t relevant to that compensation plan. Each
version of a template model requires a separate EIB.

Spreadsheet Templates Based on Business Processes


Some spreadsheet templates load data into Workday business processes. To manage the online workflow
that an upload triggers, you can:
• Enforce or bypass certain business processes when you prepare the spreadsheet.
• Specify whether Workday performs a business process automatically or manually.
• Cancel or rescind certain business processes to undo the results of an upload.

Generating Spreadsheets with Data


For some web service operations, you can generate a spreadsheet with existing data from your Workday
tenant. By using this option, you can make the data entry process easier by showing current Workday data
along with the column labels.
Don't generate a spreadsheet with data:
• As a means of sending data to an external endpoint, such as payroll processing.
• For validation of loaded data.
• To receive setup data or functionality.
• To learn how to populate EIB spreadsheets.
Workday orders the data in the prepopulated spreadsheet by WIDs of the filter criteria. Workday
prepopulates a maximum of 50,000 items matching the filter criteria.
If you configure a Reference ID with an invalid ID value, you won’t be able to generate a spreadsheet with
data.

Concept: EIB Spreadsheet Data Entry Guidelines


For troubleshooting information and examples of how to populate the spreadsheet for common EIBs, see:
Concept: Inbound EIB Template Guidelines on page 86
Note: Additional restrictions apply when using spreadsheets with custom object data.

Template
• Always generate a spreadsheet template in Workday for the upload.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 55

• Keep the template in its original XML Spreadsheet 2003 or XLSX format. Don’t save a template to any
other format.
• Add only data values to the generated spreadsheet. Don’t make formatting changes, introduce hard
breaks or returns, use formulas, rearrange rows or columns, or add new rows and columns. Doing
so can cause the upload to fail. When adding data to an XLSX spreadsheet, ensure that there are no
whitespace characters. XLSX treats whitespace characters, such as spaces, as values. To prevent
translation issues:
• Avoid using multiple fonts in XML spreadsheets.
• Use XSLX spreadsheets if you require multiple fonts for your data.
You can make a limited number of spreadsheet changes by editing the template model associated with
your EIB. Example: you can customize the template for a specific purpose by:
• Overriding column values.
• Providing your own labels and cell comments.
• Reordering worksheets.
• Hiding unwanted items.

Editing or Deleting Data


For some web services, you can use an EIB spreadsheet to update or delete existing data in Workday.
You can enter new values in spreadsheet cells to replace existing values.
Note: Some web services don't support partial updates. To avoid unintentionally deleting data, Workday
recommends that you populate the spreadsheet with all existing data.
For some web service that supports updating data, you can delete data by entering {empty} in spreadsheet
cells. You can only delete values in these field types:
• Boolean
• Date
• Lookup
• Number
• Text
Example: To replace or delete position data in Workday, enter these values in your EIB spreadsheet:

Spreadsheet Column Current Data in Inbound Spreadsheet Result in Workday


(Field) Workday Data
Updated Position ID 388.8 {empty} No value in field.
Employee Type Regular Regular Regular
Job Profile Staff Recruiter 30350 (Workday Senior Recruiter
reference ID for Senior
Recruiter)

Updating Records
Some EIB templates enable you to update an existing record in Workday. To update an existing record,
specify its Reference ID.
This example displays how to change the staffing model for the Information Technology department from
Job Management to Position Management:

Spreadsheet Column Current Data in Inbound Spreadsheet Result in Workday


(Field) Workday Data
Organization Name Information Technology Information Technology Information Technology

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 56

Spreadsheet Column Current Data in Inbound Spreadsheet Result in Workday


(Field) Workday Data
Organization 2500.5 2500.5 Identifies all other entries
Reference ID in spreadsheet row
as updates to existing
organization.
Job Management Y N Disables Job
Enabled Management for the
organization.
Position Management N Y Enables Position
Enabled Management for the
organization.

Loading Multiple Values


You can enter multiple values in multiselect fields by adding rows immediately after the first row for the
multiselect field. Only enter data in key and multiselect fields. Workday ignores values that you enter
beyond the key and multiselect fields.
When a spreadsheet template has multiple key fields, specify values for each on the additional rows.
Example: The Cost Center field accepts more than 1 value. To add multiple cost centers, specify only the
Employee ID key field in the additional rows. Specify a reference ID for each Cost Center:

Employee ID Employee Name Company Cost Center Region


E01032 Julie Smith 2501.21 61200 2503.42
E01032 61210

Multi-Instance Custom Objects


You can update existing data for multi-instance custom objects in Workday using an EIB spreadsheet
based on one of these web services:
• Edit Job Requisition Additional Data
• Edit Position Restrictions Additional Data
• Edit Worker Additional Data
• Put Job Application Additional Data
To update existing data for a multi-instance custom object, specify its Reference ID. Ensure reference ID
values are unique. Subsequent rows in the EIB with duplicate reference ID values overwrite previous rows.
Workday recommends that you populate the spreadsheet with all existing data to prevent data override if:
• You don't specify a reference ID.
• The web service for the EIB doesn’t support partial updates.
To preserve historical changes in effective-dated custom object data, Workday recommends that you load
data from oldest to most recent effective date.
You can enter data for:
• Multi-instance reference fields by specifying a comma-separated list of reference IDs.
• Multi-instance custom list fields by specifying a comma-separated list of web service alias list values.

Required Data
• Each worksheet section, or area, indicates whether an element is optional or required.
• Each column in the spreadsheet indicates whether a field is optional or required.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 57

Note:
Workday displays Optional in the Restrictions row and doesn't display an asterisk or multi-occurs (+) next
to the field name for:
• Required single- and multi-instance reference fields.
• Reference fields that you don't configure as single- or multi-instance.
• Required single- and multi-instance custom list fields.

Default Data
• Some fields have default values. If the spreadsheet requires a field, and you want to use the default
value, leave the field blank in the spreadsheet. EIB inserts default values before checking required
fields for a value.
• To override a default value, enter {empty} in the spreadsheet cell.
• Use the spreadsheet key to coordinate the header information throughout the tabs of the spreadsheet.
Keep the same spreadsheet key for each row as you add information in the subsequent tabs. Workday
requires the spreadsheet key to coordinate multiple child rows that roll up to the same parent row.

Data Types
• Each column in the spreadsheet indicates the data type.
• Columns with formats such as YYYY-MM-DD, Y/N, Text, or Number accept data only in the specified
format.
• Dates must always be in YYYY-MM-DD format.
• Spreadsheet cells provide basic data validation for text, date, numeric, and currency formats only.
• To protect cell formatting, enter values manually or reapply the correct formats if you paste data from
another spreadsheet or report.
• For rich text fields, ensure that you enter data that is valid HTML markup. Example: to enter Sales Goal
< $4000, enter Sales Goal &lt; $4000 in the spreadsheet cell. To enter line breaks, enter <br> in the
spreadsheet cell.

ID Type Columns
• For any Reference ID column, you can select the Reference ID Type from a drop-down list. This action
applies the selected Reference ID Type to all row of data in the column.
• Columns identified as holding ID Type values enable you to select a Reference ID Type for each
row of data. Example: if you’re loading employees and contingent workers in a single EIB, select the
Reference ID Type for each person/row.
• If Reference ID values are empty in Workday, assign values with the Maintain Reference IDs task.
Assign Reference IDs before you can upload data.
You can also assign Reference IDs using the Put Reference web service operation or EIB.

ID Columns
When left blank, some ID columns trigger the Workday ID generator to assign new ID values during the
upload. To find out if Workday generates IDs automatically, refer to the spreadsheet comments in ID
columns.

Formatting Reference IDs


Workday formats Reference ID fields as text fields to retain trailing zeros. If the spreadsheet upload
process fails to recognize a reference ID, enable trailing zeros for the field formatting.
Example: The spreadsheet converts the ID to 345.45 by dropping the zero under these conditions:
• The reference ID for a company insider type is 345.450.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 58

• The Company Insider Types field has a format of General which doesn't support trailing zeros.
Note: To prevent XML-formatted spreadsheets from rounding numbers in text fields, add an apostrophe
before the numerical value in each field.
Related Information
Concepts
Concept: Custom Objects in Solutions and Integrations
The Next Level: Writing Spreadsheet Formulas
Tasks
Set Up Reference IDs on page 2172

Concept: Guidelines for Spreadsheets That Launch a Business Process


Data Entry • Most spreadsheets have separate tabs for the
main business process and each supported
subprocess. Within each tab, Workday groups
columns of related data into sections that
correspond to the process elements.
• Workday always marks the main business
process Required. Include all required data for
this process; subprocesses can include full or
partial data.
• Workday disregards data in the spreadsheet
for a subprocess that has no business process
configuration for the worker. Workday continues
processing the transaction as long as the
automation level is set to Skip or Manual.
• An Optional subprocess can contain required
fields (columns). If you provide data for this
subprocess, all fields are required if you set the
processing level to Automatic.
• Set a Processing Instruction value for each
subprocess row in the Overview tab. Don’t leave
this field blank for any row.

Automation • The fields (columns) marked Required


represent the minimum amount of data
required to automate a process or subprocess
fully. Depending on your configuration, the
spreadsheet can require additional fields.
• Automatic processing triggers data validation
that produces errors when no data is provided.
Set the automation level to Skip for any
subprocess that isn’t included in your business
process configuration. Set the automation level
to Skip for any subprocess for which there’s no
data to update.
• If you specify full automation for a subprocess
but don't provide all required data, Workday
automatically populates the data where possible.
If automatic population isn’t possible, Workday
carries forward existing data without changes.
• If you specify full automation for any of these
subprocesses but don't provide all required data,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 59

Workday generates an error. Workday doesn't


initiate the inbound EIB request for that worker:
• Assign Matrix Organization
• Assign Organizations (Create Position and
Edit Position templates only)
• Assign Pay Group
• Create Benefit Life Event
• Create Workday Account
• Request One-Time Payment
• Request Stock Option Grant
• For fully automated business processes,
Workday automatically skips:
• Steps that require action or approvals.
• Steps that are both not configurable within
the web service and not a subprocess on the
EIB.
Workday continues to evaluate entry condition
rules for Integration steps, Service steps, and
Action steps that initiate subevents.
• The process history for an automated process
displays only the completion step in the Process
Monitor and Integration Events reports. It
doesn't display the individual process steps.
Workday identifies the person who launched
the process and indicates that an external load
triggered the event.

Included Employees • You can include employees from multiple


supervisory organizations in the same
spreadsheet. Workday processes each
employee using the business process configured
for their supervisory organization.
The business process definition used by the EIB
upload process is the same one used when a
business process runs online.
• Include each employee included in a subprocess
in the main process. However, a subprocess can
include all or only a portion of the employees in
the main process under these circumstances:
• For leave of absence uploads. The list of
workers submitted for a subprocess can be a
subset of the workers in the main process.
• For hire, terminate, and edit position
uploads. The list of workers submitted for
a subprocess doesn’t have to match the
workers in the main process. This option
is available as long as the subprocess
uses manual processing. If you want to
automate the upload fully, all workers
in the spreadsheet must have identical
processing requirements. If you have data
for some processes and not others, set the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 60

automation level to Automatic for processes


with data. Set the automation level to Skip
for subprocesses without data (or Manual for
required subprocesses without data). If some
employees skip a subprocess and others
require an auto-process update for the same
subprocess, perform separate spreadsheet
uploads.

Reference: Inbound Transport Protocol Types for EIBs

Overview
An inbound transport protocol tells Workday how to load data into Workday. When creating an integration
transport protocol for an EIB, Workday supports these transport protocol types to import data:

Custom Object Imports data into Workday by using a Custom


Object definition. You can create an inbound
integration that has a spreadsheet template as a
data source. Workday selects the correct Custom
Object transformation to deliver the data.

Workday Web Service Imports data into Workday using a Workday Web
Service.

Reference: Inbound Integration Transformations for EIBs


An integration transformation defines how Workday converts inbound data between Workday and external
endpoints. Workday supports these transformations:
• Template model.
• Delivered transformations:
• ACH Returns Inbound File Upload Service
• AMEX Credit Card KR1025 Transformation Inbound
• Currency Conversion Rates from Foreign Exchange Site
• Schwab 401K Spreadsheet Upload
• VISA BofA SBF Transformation
• XSLT attachment transformations. XSLT attachment transformations are custom transformations that
you create using Extensible Stylesheet Language Transformations (XSLT).

Reference: Inbound Integration Data Sources


An integration data source tells Workday how to retrieve data from an external endpoint. If you're uploading
a file in Workday XML format, place each web service request in the file in a <root> element. Since your
file can include an arbitrary number of web service requests, Workday identifies each <root> element and
its contents as a separate web service request. Workday supports these types of integration data sources.

Attachment Attaches a file during upload.

FTP/SSL Exchanges data with external endpoints using


an FTP server over a Secure Sockets Layer
(SSL). Workday supports FTP with passive mode;
Workday doesn't support active mode. Workday
supports implicit and explicit SSL.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 61

Active and Passive Mode:


• Workday doesn't support Active mode
processing for FTP/SSL or FTP.
• Passive mode enables Workday to use a
random unprivileged port for communication.
This mode doesn't require the server to establish
a connection to the client.
Implicit and Explicit SSL:
• Implicit SSL automatically encrypts connections
between FTP clients and servers. For implicit
SSL, the FTP server defines a specific port for
the client (990). The address string format for
implicit SSL is ftpsi://x.x.x.x.
• Explicit SSL enables FTP clients to explicitly
activate encryption on connections. Explicit SSL
connections use port 21. If Workday is unable
to establish a secure connection, it transfers the
data using the basic unencrypted FTP protocol.
The address string format for explicit SSL is
ftpse://x.x.x.x.

REST URL Workday can:


• Provide the results of a custom report by using
REST-based web services.
• Upload the data found at the REST-enabled
URL.

SFTP Retrieves a file from the specified SFTP endpoint.

Reference: EIB Upload Reports


Workday records the data upload as an integration event. You can configure notification messages for
integration events. To view EIB process details and integration messages, access these reports:

Report Security Domain Purpose


Process Monitor My Reports View status of background
processes that are currently
running or completed.
Report displays:
• The start date and time.
• The process type and name.
• The request name.
• Status of the process.
• Who started the process.
• Percent complete.
View process messages by
drilling down on the numbers in
the Errors & Warnings column.

Integration Events Integration Event View status of EIB upload


process.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 62

Report Security Domain Purpose


Report displays:
• The date and time that you
launched the upload.
• Who started the upload.
• The status of the upload.
• The event response message.
To open the View Background
Process report, select a specific
integration event. The View
Background Process report
summarizes the data load results
on the Integration Details tab.
Verify the number of uploaded
records, failed records, and the
completion percentage. Access
a failure report if the upload was
unsuccessful. If you selected
the Add Errors to Attachment
launch option, you can access the
spreadsheet under Attachment
With Failure Details.
Select View Consolidated
Report and Logs or View
Performance Logs to view
additional details about the
integration event. These tasks
aren't available when:
• The consolidated report has
expired.
• The consolidated report is
larger than 10MB.
• The consolidated report
doesn't exist.
• You deleted the integration
system.

Integration Messages Integration Event View status summary and details


of the EIB upload.
Report includes links to the View
Integration System and View
Background Process report for
the EIB upload.

Example: Generate EIB Spreadsheet Template with Data


This example illustrates how to generate an EIB spreadsheet template with data.

Context
You set up an EIB to bulk import supplier invoices into Workday. You want to populate the EIB
spreadsheet with data in the correct format. To guide your data entry, you generate a spreadsheet

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 63

template with data from your tenant. Workday requires you to configure a filter to generate a spreadsheet
with data.

Prerequisites
• Set up an inbound EIB named Submit Supplier Invoice EIB using the Submit Supplier Invoice web
service.
• Security:
• Integration Build domain in the Integration functional area.
• Set Up: System domain in the System functional area.

Steps
1. Access the View Reference IDs report.
2. From the Business Object prompt, select Supplier Invoice.
3. Click OK.
4. Note the first 5 reference ID values on the grid.
5. Access the View Integration System report.
6. Select Submit Supplier Invoice EIB from the Integration System prompt.
7. Click OK.
8. Select Template Model > Edit from the related actions menu of the EIB.
9. Click Edit Template with Data Options.
10.In the Filter section, add 4 rows to the grid.
11.In the ID column on each row, specify the reference ID values you noted.
12.Click OK.
13.On the Edit Generate Spreadsheet Template with Data Options page, click Generate Spreadsheet
Template with Data.
14.Select the Generate Spreadsheet with Data check box.
15.Click Submit.
16.Click Refresh until the generation completes.
17.To download the spreadsheet, select the file in the Output Files section.

Next Steps
Open the spreadsheet and note the formatting requirements of the supplier invoice data for the reference
IDs you entered.

FAQ: EIB Spreadsheet Templates


Can I use the same spreadsheet to load data Yes. You can modify the spreadsheet template
with different reference IDs? model to split a column into:
• ID type, a lookup column where you select the
type of reference id.
• ID value, a column where you enter the
reference id.
Example: To upload data for both employees
and contingent workers, you can add an
Employee Type ID column that enables you to
select Contingent_Worker_Type_ID, WID, or
Employee_Type_ID.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 64

1. Select Template Model > View from the related


actions menu of the integration system.
2. In the right pane, navigate to the template model
area and select Edit Template Model Area.
3. In the Area Details grid, access the row for the
data you want to load and select Separate Type
Column.
4. Select Template Model > Generate
Spreadsheet Template from the related actions
of the template model.

How can I find reference IDs? Access the Integration IDs report and specify
the appropriate Business Object at the prompt.
Each lookup column in the spreadsheet contains a
comment that identifies the relevant business object
and reference ID type.
Where is there a list of EIB templates to select Access the Supported Inbound EIB Operations
from? report to see a list of templates for Workday Web
Services. You can use these templates to set
up EIB integrations. The report lists:
• All available web service operations that
Workday makes available for inbound EIB
integrations, excluding Get operations.
• The parent Workday Web Service for each
operation.
• If the web service operation supports mass
rescinding of business processes.
• The web service operations available for
generating a spreadsheet with data, if any.
Run the report for all web services to see which
operations can generate a spreadsheet with data.

Outbound EIBs

Steps: Set Up Outbound EIB

Prerequisites
Determine the data source (web service or custom report) that best fits your needs.

Context
You can export Workday data in bulk to an external endpoint using an outbound EIB. You can configure
your EIB to get data from 1 of these data sources:
• Web service. You can select a public, outbound Workday Web Service operation.
• Custom report. You can select (or create and select) a custom report.

Steps
1. (Optional) For custom report EIBs, select the Enable As Web Service check box when you create the
custom report.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 65

2. Create a data source for the outbound EIB:


• (Web service) Create Web Service Data Source on page 70.
• (Custom report) Steps: Create Advanced Reports.
3. (Custom report) Create Security Proxy to Grant Report Access on page 71.
4. (Web service) Set Up Launch Parameters for Web Service Data Source on page 72.
5. Set Up Outbound EIB on page 65.
6. Grant the Integration System User Get and Put access to the Integration Event domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.

Set Up Outbound EIB

Prerequisites
• Security: Integration Build domain in the Integration functional area.
• Create a security proxy to grant report access when:
• Your integration uses a custom report data source.
• The integration owner doesn't have permission to run the report.

Context
To export data from Workday to an external endpoint, you can create an outbound Enterprise Interface
Builder (EIB) integration. You can export data from Workday using these data sources:
• Custom reports.
• Web services.
If you plan to use a web service as your data source, you must first create the web service data source
using the Create Web Service Data Source task.

Steps
1. Access the Create EIB task.
2. As you complete the Get Data page, consider:
Option Description
Custom Report Select a custom report definition. Displays only
custom reports that you enable for web services.
Web Service Select the web service data source that you
created using the Create Web Service Data
Source task.
See Create Web Service Data Source on page
70.

3. As you complete the Details section, consider:


Option Description
Alternate Output Format Select an alternate output format to generate
custom reports in a format other than Workday
XML. Workday removes Workday IDs and
reference IDs from these alternate formats.
Run As System User When the integration owner doesn't have
permission to run the report, select a Workday

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 66

Option Description
account with the appropriate permissions. Only
lists Workday users that have a security proxy.
4. As you complete the Transform page, consider:
Option Description
Custom Report Transformation Select to format the output of custom reports.
Custom Transformation Select a custom transformation that you
created on the Create XSLT Attachment
Transformation task. You can only use custom
transformations for these data sources:
• Custom reports that don't have an Alternate
Output Format or have an Alternate Output
Format of Simple XML.
• Web services.

New Custom Report Transformation When you select this option, Workday creates a
new custom report transformation.
5. As you configure a Delivery Method, consider:

Delivery Method Description


Amazon Simple Storage Service Note: For S3 transports, add a tag to your IAM
user with a key of workday-type and a value of
integration. This tag is case sensitive and doesn't
ignore whitespace.
• Enter your S3 bucket name in the Bucket field.
You can't specify a folder in this field.
• Enter a key alias for AWS KMS client-side
encryption.
• Pretty Good Privacy (PGP) encryption isn’t
configurable for EIBs using Amazon Simple
Storage.
• Select the Enable Transfer Acceleration
check box to increase transfer speeds.
• When you select an option from the Storage
Class prompt, you don't need to update the
storage class manually in Amazon Simple
Storage Service.
• To deliver files to a specific folder, enter a
File Name using this format: folder1/folderN/
filename.format.

AS2 To specify a port number, add it to the end of the


URL in the AS2 Endpoint field. When you don't
specify a port number, Workday uses the default.
Email • Separate multiple email addresses with
semicolons.
• This transport protocol requires you to encrypt
the outbound file by selecting a PGP public
key certificate in the Encrypt Using prompt.
When you don't encrypt the output, you

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 67

Delivery Method Description


can save the EIB but need approval from
your security administrator to run it. When
your security administrator overrides this
requirement, you can run the EIB an unlimited
number of times. If you edit the EIB later,
your security administrator must approve the
override again.

FTP • To specify a port number, add it to the end of


the URL in the FTP Address field. When you
don't specify a port number, Workday uses the
default.
• This transport protocol requires you to encrypt
the outbound file by selecting a PGP public
key certificate in the Encrypt Using prompt.
• Directory names are case-sensitive. Include
a leading slash (/) only for a full path, not a
relative path.
• Select the Use Temp File check box to write
the output to a randomly named file. Workday
renames the file to the correct name when
it completes the data transfer. This option
prevents automatic scripts from retrieving
the file from the FTP server before the data
transfer completes.

FTP/SSL • Use these formats:


• Implicit SSL: ftpsi://x.x.x.x:port-number
• Explicit SSL: ftpse://x.x.x.x:port-number
• When you don’t specify a port number,
Workday uses port 990 for implicit SSL and
port 21 for explicit SSL.
• Directory names are case-sensitive. Include
a leading slash (/) only for a full path, not a
relative path.
• Select the Use Temp File check box to write
the output to a randomly named file. Workday
renames the file to the correct name when
it completes the data transfer. This option
prevents automatic scripts from retrieving
the file from the FTP server before the data
transfer completes.

HTTPS • To specify a port number, add it to the end of


the URL in the HTTP Address field. When you
don't specify a port number, Workday uses the
default.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 68

Delivery Method Description


• Types of web service invocation:
• Basic Auth: Basic access authentication
that encodes the user name and password.
• No Security: Indicates that you trust the
connection and that the connection doesn't
need security.
• OAuth 2.0: Authorizes access using
Bearer tokens. Contact your OAuth service
provider to obtain token values.
When the Access Token expires, Workday
uses the Client ID, Client Secret, and
Refresh Token values to reach your
Refresh Token URL and generates a new
access token. Workday then uses the new
access token to deliver the files.
• WS-Security User Id/Password: Applies
security to web service messages through
the Web Services Security protocol.
• When you use an Outbound EIB with HTTP
and select WS-Security User Id/Password or
No Security, consider:
• When you configure an XSLT
transformation, the XSLT must wrap the
payload using a SOAP envelope.
• When you use a custom report and
the output isn't XML, add an XSLT
transformation to wrap the payload using a
SOAP envelope.

SFTP • To specify a port number, add it to the end of


the URL in the SFTP Address field. When you
don't specify a port number, Workday uses the
default.
• Directory names are case-sensitive. Include
a leading slash (/) only for a full path, not a
relative path.
• Select the Use Temp File check box to write
the output to a randomly named file. Workday
renames the file to the correct name when
it completes the data transfer is complete.
This option prevents automatic scripts from
retrieving the file from the FTP server before
the data transfer completes.

6. Specify how long Workday retains the EIB output file in the Document Retention Policy (in Days)
field.
Workday requires a retention period when you send an output file back to Workday as an attachment.
Workday recommends retaining files for audit purposes when you send an output file to an external
endpoint.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 69

7. As you configure the Details section for your delivery method, consider:
Option Description
Sequence Generator for Filename Select a sequence generator to create output files
with unique filenames.
The initiating user account that launches or
schedules the integration must have security
access to the sequence generator you select.
Verify that the user has access to the sequence
generator.

Dynamic Filename Select this check box to enable you to configure


dynamic filenames for output files for EIBs based
on custom report data sources.
MIME Type Select a Multipurpose Internet Mail Extensions
(MIME) type for the output file. This option doesn't
change the actual file format. To change the file
format, select an alternate output format or modify
your transformation.
Compressed Select to compress the output file in ZIP format.
Workday adds a .zip file extension to your
output file. Workday compresses files delivered
to external endpoints only. Workday ignores
this check box for output files attached to the
integration event.
Encrypt using Select a PGP public key to encrypt the file.
Workday ignores the Encrypt using setting for
output files attached to the integration event.
When you use FTP, FTP/SSL, or SFTP protocols
to encrypt an outbound integration file, you can
also:
• Include an integrity check of the data in the file.
• Digitally sign the file.

Containing Integrity Check (FTP, FTP/SSL, and SFTP only) Select to verify
that the outbound file doesn't become altered or
corrupt during transport.
Digitally Sign Using (FTP, FTP/SSL, and SFTP only) Select a PGP
private key of the key pair that you generated to
sign the outbound file digitally.
Restricted To Select a target environment for this transport
protocol.
When you leave this field empty, Workday applies
the delivery method to every environment in which
the integration runs. Each environment can have
only 1 transport protocol. To ensure that you
don't exchange data between test and nontest
endpoints, create a separate transport for each
environment.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 70

Next Steps
• When you create a custom report data source that uses a custom report transformation, configure the
transformation.
• When you create a web service data source, define the launch parameters for the XML request
message.
Launch or schedule the integration.
Related Information
Tasks
Create HTTPS Transport Protocol on page 75
Create an X.509 Public Key
Create an X.509 Private Key Pair
Create a PGP Public Key
Set Up Dynamic File Name Definition on page 79
Reference
2020R2 What's New Post: Explicit FTPS Support

Create Web Service Data Source

Prerequisites
Security: Integrations: EIBs domain in the Integration functional area

Context
You must first create a web service data source if you plan to use a web service as your data retrieval
method in an outbound Enterprise Interface Builder (EIB) integration. The data source tells Workday how
and from where to access and export the data.

Steps
1. Access the Create Web Service Data Source task.
2. As you specify details about the web service data source, consider:

Field Description/Notes
Web Service Operation You can continue to use this web service data
source with subsequent Workday releases.
However, if you edit the data source, Workday
updates the version number to the current version
number.
Version Keep the default setting. The initial version of a
web service data source defaults to the current
version of the public API.

Next Steps
Define launch parameters for the XML request message.
Related Information
Concepts
Concept: EIB Template Models and Spreadsheet Templates on page 53

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 71

Create Security Proxy to Grant Report Access

Prerequisites
Security: Security Administration domain in the System functional area

Context
In an Enterprise Interface Builder integration that uses a custom report, the Workday account that launches
the integration sometimes doesn't have security privileges to run the report. You can create a security
proxy to grant report access.
This feature only grants access through web services. By creating a security proxy, you ensure that the
integration user can access only the report, not other items that the report owner can also access.
You can specify 1 or more user accounts to access the report.

Steps
1. Access the Create Security Proxy task.
2. Configure the proxy:
Option Description
For Report Definition Don't select any reports under the Standard
Reports by Action filter. You can't use standard
reports as a data source.
Expiration Date If you leave this field blank, the proxy doesn't
expire until you delete or edit the proxy.
Proxied Workday Account Select a proxied account that has permission to
access the specified report.
Authorized Workday Accounts The authorized accounts access the report by
using the credentials of the proxied account.
However, the accounts can't access any other
data to which the accounts wouldn't otherwise
have access. Example: If the report has other
ways to see data that the Workday account would
ordinarily not see, the account doesn't have
access to those actions.

Result
You can now select one or more authorized Workday accounts to run the custom report in your integration.
When you create the custom report data source using these tasks, the Run as System User prompt lists
authorized users:
• Create Custom Report Data Source
• Create EIB

Next Steps
To change or delete a security proxy, use the related actions menu for the proxy or access the Edit
Security Proxy or Delete Security Proxy task.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 72

Set Up Launch Parameters for Web Service Data Source

Prerequisites
• Create a web service data source (WSDS).
• Security: Security Administration domain in the System functional area.

Context
You can define the launch parameters for a WSDS in outbound Enterprise Interface Builder (EIB)
integrations. When you launch the EIB, you can specify parameter values to define what data Workday
retrieves for the EIB.
Workday provides a prepopulated XML request that includes tokens you can use as input parameters. The
request contains all subelements, including subelements that are optional or mutually exclusive to other
subelements. You can edit the prepopulated request XML to remove unwanted tokens and subelements.
You can create launch parameters for the tokens that you keep.
The XML request and launch parameters for a particular WSDS apply to all integration systems that use
that data source. However, you can specify different values for the parameters at each launch. Workday
appends integration system IDs to the data source name to differentiate each launch, and the View Web
Service Data Source report also displays usage details.

Steps
1. Access the View Web Service Data Source report.
2. From the related actions menu of the data source that you want to create launch parameters for, select
Web Service Data Source > Edit.
3. As you edit the prepopulated XML request message in the Request XML field, consider:
Option Description
Token • Tokens have the format %Token%.
• Remove tokens that you don't want to use as
input parameters.
• Assign each token a unique name. Example:
When 2 subelements have an %Effective
Date% token, rename them %Effective
Date1% and %Effective Date2%.

Subelement • Subelements have the format


<Element_Tag>...</Element_Tag>.
• Remove unwanted subelements and
subelements from which you remove tokens.
• When you add multiple occurrences of a
particular subelement, give the related tokens
a unique name.

To revert to the prepopulated request XML after you create launch parameters for a WSDS, you can
select Edit from the related actions menu of the WSDS.
4. Create a launch parameter for each token in the Request XML field.
As you complete the Launch Parameters grid, consider:
Option Description
Name Enter the parameter exactly as it displays in the
Request XML field, excluding the % delimiters.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 73

Option Description
Launch Parameter Type Select the parameter Data Type, or select
Enumeration to define your own web service
enumeration. Example: When you select a report
field for a parameter that represents an instance
set from the Data Type prompt, Workday prompts
you to select the instance when you launch the
integration.
Default Processing Specify default parameter behavior at launch.
Example: By selecting Determine Value
at Runtime, you can specify that Workday
automatically populates the current date when
you launch the integration.
5. (Optional) When your WSDS supports paging, maintain the %WWS Page% and %WWS Count% tokens in
the prepopulated message and create corresponding launch parameters to limit data retrieval. As you
complete the task consider:
Option Description
%WWS Page% Retrieves a single page of data. Create a numeric
launch parameter and specify the number of the
page that you want to retrieve.
To retrieve all pages, remove the token from
the request message. If you specify a page that
doesn't exist, Workday retrieves no data.

%WWS Count% Only applies to the page returned by the %WWS


Page% parameter.
Create a numeric launch parameter to specify the
number of records per page, up to a maximum of
999. When you remove the token, Workday sets
the number of records per page to 100.

Result
When you launch or schedule the integration, Workday prompts you to specify values for all parameters,
excluding parameters set to Do Not Show.

Example
This is an example of a prepopulated XML request message for an EIB using the
Get_Compensation_Grades web service operation as a data source:

<wd:Get_Compensation_Grades_Request xmlns:wd="urn:com.workday/bsvc">
<wd:Request_References>
<wd:Compensation_Grade_Reference>
%Compensation Grade Instances%
</wd:Compensation_Grade_Reference>
</wd:Request_References>
<wd:Response_Filter>
<wd:As_Of_Effective_Date>
%Effective Date%
</wd:As_Of_Effective_Date>
<wd:As_Of_Entry_DateTime>
%Entry Moment%
</wd:As_Of_Entry_DateTime>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 74

<wd:Page>
%WWS Page%
</wd:Page>
<wd:Count>
%WWS Count%
</wd:Count>
</wd:Response_Filter>
<wd:Response_Group>
<wd:Include_Reference>
%Include Reference%
</wd:Include_Reference>
</wd:Response_Group>
</wd:Get_Compensation_Grades_Request>

To retrieve information about a particular compensation grade based on an effective date, remove these
tokens from the prepopulated request message:
• <wd:As_Of_Entry_DateTime >%Entry Moment%</wd:As_Of_Entry_DateTime>
• <wd:Page >%WWS Page%</wd:Page>
• <wd:Count >%WWS Count%</wd:Count>
You only use these tokens to retrieve data based on the moment of entry in Workday or limit the response
size.
Create launch parameters for the remaining tokens:

Name Data Type Option(s) Default Processing


Compensation Grade Compensation Grades Required Leave blank.
Instances
Effective Date Date Required • Select the Default at
Launch check box.
• Select Determine
Value at Runtime
from the Value Type
prompt.
• Select Current
Effective Date from
the External Field
used as Default for
Launch Parameter
prompt.

Include Reference Boolean Do Not Show • Select the Default at


Launch check box.
• Select Specify Value
from the Value Type
prompt.
• Select the Boolean
check box.

When you launch the integration, Workday prompts you to select the compensation grade instances.
The Effective Date parameter automatically populates to the current date when you run the web service
operation. You can view the launch parameters and values on the View Background Process page.
Related Information
Tasks
Launch an Integration on page 23

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 75

Create HTTPS Transport Protocol

Prerequisites
Security: Integrations: EIBs domain in the Integration functional area.

Context
You can create an HTTPS transport protocol to use in Enterprise Interface Builder (EIB) integrations. Use
this option only if you need to configure HTTP headers.

Steps
1. Access the Create HTTPS Transport Protocol task.
2. Specify details about the transport protocol:
Option Description
HTTP Address Use this format: https://x.x.x.x:port-number .
If you don't specify a port number, Workday
automatically selects the port number.

Web Service Invocation Type • Basic Auth: Basic access authentication that
encodes the account name and password.
• No Security: Indicates that you trust the
connection, and that the connection doesn't
need security.
• OAuth 2.0: Authorizes access using Bearer
tokens. Contact your OAuth service provider to
obtain token values.
When the Access Token expires, Workday
uses the Client ID, Client Secret, and
Refresh Token values to reach your Refresh
Token URL and generates a new access
token. Workday then uses the new access
token to deliver the files.
• WS-Security User Id/Password: Applies
security to web service messages through the
Web Services Security protocol.

User ID, New Password, and Verify Password Required if you select:
• Basic Auth.
• WS-Security.

Header Name and Header Value Add one or more HTTP request fields. Workday
adds the headers to each HTTP request. The
HTTP requests must be valid for the endpoint.

Next Steps
When you set up your outbound EIB, select Use Existing Delivery Method from the Delivery Method field.
Select the HTTPS transport protocol you created.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 76

Create Integration Transformation

Prerequisites
• Determine which type of integration transformation you need (custom report, delivered, or XSLT
attachment) to convert the source data to a format that the target endpoint can read.
• Security: Integrations: EIBs domain in the Integration functional area.

Context
Create a transformation associated with an Enterprise Interface Builder (EIB) integration in your tenant.
You can use a Workday-delivered transformation or your own custom transformation.

Steps
1. Access the task for the type of transformation that you want to create:
• Create Custom Report Transformation
• Create XSLT Attachment Transformation
2. Configure the transformation:
Option Description
Custom Report Transformation Select the source Custom Report from the
prompt.
To customize the report transformation, access
the EIB and select Enterprise Interface >
Configure Transformation from the related
actions menu.

XSLT Attachment Transformation From the XSLT Version Used in Attachment


prompt, select the version of the XSLT file you're
uploading. Workday recommends that you
upload version 3.0 files. Workday displays this
version when you view an inbound or outbound
integration system.
Select Browse and upload your XSLT file.

Next Steps
If you created a Custom Report Transformation, configure the transformation to specify how the Custom
Report formats the output.
Related Information
Tasks
Set Up Custom Report Transformation on page 77

Manage Outbound EIBs with Custom XSLTs

Prerequisites
Security:
• Integrations: EIBs domain in the Integration functional area
• My Reports domain in the System functional area

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 77

Context
Outbound EIBs with custom XSLT transformations use as much as 10 times the amount of memory
that the source data requires. Workday recommends that you transform no more than 100 MB of data.
Although EIBs that transform more than 400 MB of data have a high risk of malfunctioning, Workday still
attempts to complete all EIBs.

Steps
Workday strongly recommends that you take these steps to avoid failed data loads:
1. Monitor the data source size of your outbound EIBs that use custom XSLT transformations.
To find the related EIB requests, use the Process Monitor report. If you transformed more than
400 MB, the Messages tab displays the actual data source size transformed, as well as a warning
message.
2. Filter the data source by running the EIB with either:
• Custom report filters.
• Web service data source launch parameters.
3. Use Studio with splitter and aggregator components.
4. Test your XSLT for infinite loops using an XML editor.
Related Information
Concepts
Concept: Components

Set Up Custom Report Transformation

Prerequisites
• Create an outbound EIB that uses a:
• Custom report data source.
• Custom report transformation.
• Security: Integrations: EIBs domain in the Integration functional area.

Context
You can configure how an EIB formats the output file for the custom report it uses. When configuring the
custom report transformation:
• Configure as much as you can in the custom report, rather than in the transformation.
• Use a custom report that already has the fields you want in the order that you want. You can't add or
remove fields in the Custom Report Transformation.
• If you add or remove report fields from the custom report definition, Workday updates the corresponding
columns in the transformation. Workday performs this action when you select Enterprise Interface >
Configure Transformation.
• If you make other changes to the custom report after creating the transformation, edit the transformation
to accommodate these changes. When you change a custom report, Workday recommends that you
test any EIBs or Studio integrations that depend on it.
• Ensure that report fields in the custom report are in Text or Numeric format. Create a calculated field to
transform report fields that are of a different type into Text or Numeric format.

Steps
1. Access the EIB that includes the Custom Report Transformation.
2. From the related actions menu of the EIB, select Enterprise Interface > Configure Transformation.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 78

3. Specify the Delimiter character such as (,) or (;) to separate the columns in the output file.
Enter \t for tab or \b for space. Workday disables the Delimiter when you select Fixed Width mode.
4. Select any row and specify formatting options for the column. As you complete the task, consider:
Option Description
Source Column Select a new Source Column if you want to place
that column at the selected position in the grid.
Column Width Enter a numeral to set the column width or zero
for no limit.
Column Heading Override (Optional) Enter a custom column heading for
the Target Column or leave empty for a blank
heading. Workday trims starting spaces for any
Column Heading Overrides that start with a
space.
Pad Character If you specified a column width, enter a character
that pads the report field content. Enter \s to pad
with spaces.
Left Padding / Right Padding Select whether the column is left- or right-justified.
Target Column Previews the formatting options that you
configured using the Column Heading Override.
5. (Optional) Select the Header tab and configure an Optional Report Header.
This text displays at the top of the output file. Enter plain text or select 1 of:
• Actual Start Date and Time for the date and time the background process began. You can't
configure the format of this field.
• Row Count for the number of rows in the custom report data. Each row of a custom report can have
multiple lines.
• Line Count for the number of lines in the output file, excluding the header and footer.
• File Name for the name of the output file.
6. (Optional) Select the Footer tab and enter plain text or select a tag for the Optional Report Footer.

Result
Workday performs the transformation, populating dynamic report fields with the corresponding values at
that moment. Examples:
• If you later alter the sort order of the columns in the custom report definition, Workday doesn’t update
the column sort in the transformation. If you change the order of the columns in your report, Workday
might require you to delete the existing transformation and create a new custom report transformation
for the column sort to match.
• If you delete a column in the custom report definition, Workday doesn’t update the transformation.
Reconfigure the transformation in order to accept the changes to the custom report definition.

Next Steps
To delete your custom report transformation, select Custom Report Transformation > Delete from the
related actions menu of the transformation. When you run the EIB, Workday doesn't transform the output
file. When you delete a custom report transformation, Workday doesn't delete the custom report itself.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 79

Set Up Dynamic Filename Definition

Prerequisites
Create an outbound EIB with a custom report data source and a dynamic filename.
Security: Integrations: EIBs domain in the Integration functional area.

Context
You can configure dynamic filenames for the output files of your EIB. You can base these filenames on:
• Report prompts.
• External report fields.
Filenames can only be between 1-255 characters long and can’t be more than 1 line.

Steps
1. Select Enterprise Interface > Configure Dynamic Filename Definition as a related action on your
EIB.
2. On the Tags grid, assign report prompts or external report fields to tags 1 to 5, then insert the tags into
the Filename Definition.
Workday doesn't support optional prompts or prompts configured with Do Not Prompt at Runtime. When
you change or delete the report prompts used in tags, you must also update the filename definition.

Result
Workday converts report prompts and external report fields into the filename:
• Boolean: Zero or 1.
• Currency: Display ID.
• Date: Display ID.
• Instance: Display ID.
• Numeric: The number value.
• Multi-instance: Comma-separated display IDs.

Next Steps
When you launch the EIB, select Use System Default for the Filename integration criteria to use the
configured dynamic filename definition.

Reference: Outbound Transport Protocol Types for EIBs

Overview
An outbound transport protocol tells Workday how to deliver data to an external endpoint. When creating
an integration transport protocol for an EIB, Workday supports these transport protocol types to export
data:

AS2 Exports data from Workday by using the


Applicability Statement 2 (AS2) protocol. Workday
requires that you encrypt and digitally sign AS2 data
using an X.509 public key and X.509 private key
pair.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 80

Amazon Simple Storage Service Exports data from Workday using the Amazon
Simple Storage Service (s3) protocol. Workday
requires Bucket and Access Key ID values.
Workday requires a Secret Key ID value when you
select Access Key ID.

Email Exports data from Workday using email. Delivers


data to multiple email addresses, including carbon
copy (cc and bcc) recipients. Supports custom
messages for the email body.

FTP Exchanges data with external endpoints using FTP


in passive mode. Workday doesn't support FTP with
active mode. FTP requires PGP encryption.

FTP/SSL Exchanges data with external endpoints using


an FTP server over a Secure Sockets Layer
(SSL). Workday supports FTP with passive mode;
Workday doesn't support active mode. Workday
supports implicit and explicit SSL.
Active and Passive Mode:
• Workday doesn't support Active mode
processing for FTP/SSL or FTP.
• Passive mode enables Workday to use a
random unprivileged port for communication.
This mode doesn't require the server to establish
a connection to the client.
Implicit and Explicit SSL:
• Implicit SSL automatically encrypts connections
between FTP clients and servers. For implicit
SSL, the FTP server defines a specific port for
the client (990). The address string format for
implicit SSL is ftpsi://x.x.x.x.
• Explicit SSL enables FTP clients to explicitly
activate encryption on connections. Explicit SSL
connections use port 21. If Workday is unable
to establish a secure connection, it transfers the
data using the basic unencrypted FTP protocol.
The address string format for explicit SSL is
ftpse://x.x.x.x.

HTTPS Exports data from Workday by using Hypertext


Transfer Protocol Secure (HTTPS).

SFTP Exchanges data with external endpoints using


Secure File Transfer Protocol (SFTP).

Workday Attachment Exports data from Workday by creating a Workday


attachment. Create this transport protocol once and
then reuse it as needed.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 81

Related Information
Reference
2020R2 What's New Post: Explicit FTPS Support

Reference: Outbound Integration Transformations

Integration Transformations Overview


An integration transformation defines how Workday converts outbound data between Workday and
external endpoints. Workday supports these types of integration transformations:
• Custom report transformations.
• XSLT attachment transformations.

Custom Report Transformations


Custom report transformations are custom transformations that you define in Workday. Custom report
transformations enable you to:
• Include or exclude report fields.
• Define output order.
• Format individual report fields.
• Add headers and footers to output files.

XSLT Transformations
XSLT attachment transformations are custom transformations that you create using Extensible Stylesheet
Language Transformations (XSLT).

Reference: Outbound Integration Data Sources


An integration data source tells Workday what sort of data it can export to an external endpoint. Workday
supports these types of integration data sources.

Custom Report Workday runs the custom report and gathers the
results for export. You can optionally generate the
report data in a format other than Workday XML.
Alternate output options include:
• CSV (comma-separated values).
• GData (Google data).
• JSON (JavaScript Object Notation).
• RSS (Really Simple Syndication).
• Simple XML.
Workday removes Workday IDs and reference IDs
from these alternate formats.
Before you can use custom reports in integrations,
enable the reports for web services. This step
enforces additional validations that stabilize the
report structure. When you transform a report to
CSV format, the report columns in the integration
output files sometimes don't match the columns that
Workday displays:
• If you set the display option for a column as
Do Not Show If Empty, Workday still includes
the column in integration output files. Field

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 82

display options only apply to the report output


in Workday, not to integration output. Workday
always includes empty columns in outbound EIB
integration files.
• If a column name starts with a number or
a punctuation character, Workday adds a
XMLNAME prefix to the name in the transformed
spreadsheet.

Web Service Retrieves data from Workday by using a Get or


Find web service operation from the Workday
public API. The initial version of a web service data
source defaults to the current Workday version
number. You can continue to use this version of the
data source with subsequent Workday releases.
However, if you edit the data source, Workday
updates the version number to the current version
of the public API.

Related Information
Concepts
Concept: EIB Template Models and Spreadsheet Templates on page 53

EIB General Errors and Guidelines

View Error Messages for an EIB

Prerequisites
Security: My Reports domain in the System functional area

Context
View error messages for EIBs that didn’t complete successfully.

Steps
1. Access the Process Monitor report and run the report with these filters:
Option Description
From Date and Time and To Date and Time Select a date and time range for the integration.
Process Type Select Integration.
2. Find the integration event in the list and note the Correlation ID for that integration in the Integration
Event Correlation ID column.
When you open a support case to resolve an integration issue, Workday Support asks you for this
Correlation ID.
3. Select the event link in the Integration Event column, then select the Messages tab.
The Severity column displays icons for each message.
4. Select the message link in the Message column.

Result
Workday displays the error message in the Detail field.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 83

Next Steps
Depending on the type of error:
• Resolve the error condition and run the EIB again.
• View the consolidated report for the EIB for more detailed information about why Workday returned
errors and warnings for the EIB.
• See if your error and the required resolution display in the Common EIB Issues FAQ.
• Open a case with Workday Support if you can’t resolve the error condition. Provide the Correlation ID
for the EIB when you contact Workday Support.

Troubleshooting: Enterprise Interface Builder


• Integration prompt on the Launch / Schedule Integration task doesn't display the EIB. on page 83
• Characters display incorrectly in Microsoft Excel when you open a CSV output file. on page 83
• EIB output is missing data and spreadsheet column headings display Instance# instead of the
configured column heading. on page 83
• Filename doesn't include the date and time variables configured on the sequence generator. on page
84
• Workday doesn’t use a configured sequence generator for Filename. on page 84
• Workday doesn't generate a sequenced filename for an outbound EIB integration. on page 84
• Workday displays a BadRequestException error message. on page 85
• Workday displays a transform failed error message. on page 85
• Workday displays an Invalid Subelement error. on page 85
• Numbers with leading zeros don't display correctly in Microsoft Excel. on page 85
• Microsoft Excel for Mac crashes when you copy a spreadsheet cell. on page 85
• Microsoft Excel for Mac returns a stylesheet error when you save the XML spreadsheet file. on page
86
• Can't recover an XSLT transformation file

Integration prompt on the Launch / Schedule Integration task doesn't display the EIB.

Cause Solution
You don’t have the security permissions required to Verify the security configuration of your EIB. Ask
launch the EIB. your security administrator to grant you access.
The EIB contains critical errors. Security: These domains in the Integration
functional area:
• Integration Build
• Integration Configure
Use the Edit EIB task to resolve any critical errors.

Characters display incorrectly in Microsoft Excel when you open a CSV output file.
Cause: The CSV file encoding doesn't use UTF-8 encoding.
Solution: Use any of these workarounds.
• Before you open the CSV file in Excel, open it in Notepad and save with UTF-8 encoding.
• Import the CSV file into Excel.
• Load the CSV file into Google Docs.

EIB output is missing data and spreadsheet column headings display Instance# instead of the
configured column heading.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 84

Cause: The web service version of the underlying custom report is V8 or lower.
Solution:

Steps
1. Select Custom Report > Edit from the related actions menu of the custom report.
Security: Manage: All Custom Reports domain in the System functional area.
2. In the Advanced tab, select the latest Web Service API Version.
3. Delete the existing EIB.
See Delete Integrations and EIBs on page 32.
4. Create a new EIB based on the same custom report.
See Set Up Outbound EIB on page 65.

Filename doesn't include the date and time variables configured on the sequence generator.
Cause: The File Name launch parameter isn’t configured to use the sequence generator.
Solution:

Steps
Security: Integration Event domain in the Integration functional area.
1. Access the Launch / Schedule Integration task and select your EIB from the Integration prompt.
2. For the File Name integration criteria, select:
Option Description
Value Type Determine Value at Runtime
Value Next Sequence for Integration File Utility

Workday doesn’t use a configured sequence generator for Filename.


Cause: You configure a segment-based security group with:
• A constrained integration system security group.
• An integration system security segment.
Solution:

Steps
Security: Security Configuration domain in the System functional area.
1. Access the Create Security Group task.
2. From the Security Groups prompt, select an unconstrained security group.
Ensure that you don’t grant the unconstrained security group access to other domains, such as
Integration Build or Integration Event.
3. From the Access to Segments prompt, select an integration system security segment.

Workday doesn't generate a sequenced filename for an outbound EIB integration.


Cause: The account for the initiating user of the outbound EIB integration doesn't have permissions to the
sequence generator that you selected.
Solution:

Steps
Security: Integration Event domain in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 85

1. Look up the security group for the sequence generator that you selected for the outbound EIB
integration.
2. Add the initiating user account to the security group for the sequence generator.
3. Relaunch or reschedule the outbound EIB integration.

Workday displays a BadRequestException error message.


Cause: You haven't set a value for a required prompt on the report for your EIB.
Solution: Ensure that Workday completes all required prompts when the EIB launches. When the
scheduler launches the EIB, edit the scheduler.

Workday displays a transform failed error message.


Cause: The encoding used in the custom XSLT transformation doesn't support a character in the report
output.
Solution:

Steps
1. Open the XSLT transformation file in a text editor.
2. Set the encoding= value for the <xsl:output> element to UTF-8 .
3. When the recipient of the EIB can’t accept UTF-8-encoded files, change the source data in Workday to
exclude unsupported characters.

Workday displays an Invalid Subelement error.


Cause: There are missing processing instructions for business processes on the Overview tab of the
spreadsheet.
Solution: Select a Processing Instruction for all business processes on the Overview tab of the
spreadsheet. If you're not uploading data for a specific sheet, select Skip Processing when Step is
marked Optional.

Numbers with leading zeros don't display correctly in Microsoft Excel.


Cause: Excel changes the data type of cells in the spreadsheet.
Solution:

Steps
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure
1. Access the Edit EIB task and select your EIB.
2. In the Get Data section, select CSV from the Alternate Output Format prompt.
3. Launch the EIB.
See Launch an Integration on page 23.
4. Import the CSV output file into Excel.
5. For dates, change the format of the column to Date.
6. For numeric values with leading zeros, change the format of the column to Text.

Microsoft Excel for Mac crashes when you copy a spreadsheet cell.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 86

Cause: The spreadsheet contains comments on each column header cell.


Solution: Clear comments from column header cells.

Microsoft Excel for Mac returns a stylesheet error when you save the XML spreadsheet file.
Cause: Excel for Mac corrupts the spreadsheet file when you save more than 1 stylesheet.
Solution: Select the sheet, then select Edit > Clear > Formats.

Can't recover an XSLT transformation file


An Enterprise Interface Builder (EIB) outbound integration system has an incorrect XSLT transformation
file attached to it. You need to replace it with the correct file, but you don’t have it.
Cause: Unavailability of the correct XSLT transformation file.
If the correct file was originally attached to the EIB but then removed using the Trash icon in Edit the XSLT
Attachment Transformation task, the removal also unlinked the correct file from the EIB. Although you
can see the correct file as the Prior Value in the View Instance Viewer by ID or WID report, you can’t
click the filename to access it.
Solution: If the correct XSLT transformation file is already used in a previous EIB integration event, you
can access it through the EIB for that integration event.

Steps
Security: Integration Event domain in the Integration functional area.
1. From the related actions menu of the EIB for the integration event, select Integration System >
Integration Events.
2. Select a date range that includes the time when the integration event occurred using the XSLT
transformation file that you want to recover.
Ensure the date range is before the incorrect file was uploaded.
3. On the integration event, click the XSLT file in the Transformation field on the Enterprise Interface
Event section.
Cause: The correct XSLT transformation file was never used in an integration event.
Solution: Contact your Named Support Contact. Provide them with the filename of the XSLT
transformation file that you need from the View Instance Viewer by ID or WID report.
Related Information
Tasks
Launch EIB Spreadsheet Upload on page 51
Reference
Handling Accent Characters and Changing Character Encodings

Inbound EIB Template Guidelines and Troubleshooting

Concept: Inbound EIB Template Guidelines


This section provides topics for widely used inbound Enterprise Interface Builders (EIBs). Each topic
includes:
• A description of the web service operation, including alternate web service operations to use.
• The equivalent Workday task for the EIB.
• Template-specific guidance for filling out the EIB spreadsheet.
• Common issues and errors for the EIB.
• The business process type used by the EIB, if any.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 87

• Details about the add, update, and delete capabilities of the EIB.
• Details about how to recover from a bad EIB upload.
• A link to a sample EIB spreadsheet for the web service operation.

Absence Management EIBs


Concept: Adjust Time Off EIB

Background
You can use this EIB to adjust an existing time off entry. The adjusted units must be passed in (and not the
corrected units).
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• On the Worker Profile related actions menu, select Time and Leave. Then depending on your
configuration, select either Correct Absence or Correct Time Off.
• The Enter Absence or Enter Time Off tasks, depending on your configuration.
You can also use these EIBs:

EIB Name Purpose


Enter Time Off and Import Time Off Request Event Use to submit new time off entries.
Batch
Put Absence Input Use to add or update an accrual or time off
adjustment/override for a worker.
Put Override Balance Use to add or update a new time off plan override
balance record for a given worker and time off plan.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Correct Time
Off business process type in the Time Off and
Leave functional area to run this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 88

which provides a general overview for populating


EIB files.
As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each worker.
Run Time Off Turn this flag on when
Validations you’re validating time
off entries for a time off
request. If this flag is
turned on and any time
off entries fail validation
for a time off request, it
will reject the entire time
off request.
Worker This section is
required. Update the
reference in row 4 from
Contingent_Worker_ID
to Employee_ID.
Row ID This is typically 1 value
for each entry, unless
you have multiple row
entries for the same
worker.
Time Off Entry ID Leave blank if you want
the EIB to autoassign
reference ID values.
You can specify a value
here if you want to
assign your own ID
values. If you specify
a value, verify it’s not
already in use.
Time Off Entry Specify the reference
ID of the time off entry
that you're adjusting. To
find the reference
ID value, access the
View Reference IDs
report and search for
the Time Off Entry
business object.
Adjustment to Specify the number of
Requested units to add or remove
from the time off entry.
Example: if you want
to adjust the time off

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 89

Field Considerations
from 8 hours to 6 hours,
specify -2.
Comments Optional. You can add
comments for your
entries if needed.

Common Issues and Errors

Issue Cause and Solution


EIB issues error Validation error occurred. Invalid This usually occurs if the reference id type is set to
ID value. 'xxxxx is not a valid ID value for type = contingent worker instead of employee ID. If you’re
'Contingent_Worker_ID' attempting to adjust time for employees, check the
value in cell D4 and ensure it’s Employee_ID.
Slow Performance • This issue can be caused by how you store
balances. Workday recommends that you
persist balances for 91 days or more. For more
details, see Concept: Guidelines for Storing
Time Off Balances.
• If loading time offs is required for terminated
employees, load the time offs before completing
the termination.
• If you want to load large volumes of time off
requests (Example: 1000+) consider using
the Import Time Off Request Event Batch
EIB instead, as this EIB is designed to process
large volumes of data. Test in a nonproduction
tenant to determine which EIB works best for
you.

Use Cases and Guidelines for Recovering from a Bad Load


• This EIB only adjusts existing time off entries. You can’t delete entries.
• There’s no Mass Rescind option for this EIB. If you've uploaded incorrect entries, you can update the
original EIB input file and reverse the Adjustment to Requested values for each row. Example: if
Adjustment to Requested is -2, you can change it to 2. Then reload the EIB. This will negate the
original entries that you loaded.
• The Correct Time Off event has a cancel option. If the business process events are still in progress, you
can run the Mass Cancel Business Processes task (secured to the Business Process Administrator
domain in the System functional area) to back them out if needed.
• For reference documentation for all web services including Adjust Time Off, see Operation Directory.

Sample EIB Input File


Adjust_Time_Off-WD32

Concept: Enter Time Off EIB

Background
You can use this EIB to load new time off entries.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 90

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• On the Worker Profile related actions menu, select Time and Leave. Then depending on your
configuration, select either Enter Absence or Enter Time Off.
• The Enter Absence or Enter Time Off tasks, depending on your configuration.
You can also use these EIBs:

EIB Name Purpose


Adjust Time Off Use to adjust an existing time off entry.
Import Time Off Request Event Batch Use to load large volumes of time off
entries (Example: 2000 or more).
Put Absence Input Use to create or update time off adjustments or
overrides for a worker.
Put Override Balance Use to create or update a time off override balance
for an employee.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Request Time
Off business process type in the Time Off and
Leave functional area to run this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Use a unique value for
each worker.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 91

Field Considerations
Row ID Use a unique value for
each time entry for a
given worker.

Common Issues and Errors

Issue Cause and Solution


Slow performance. • This issue can occur depending on how you
store balances. Workday recommends that you
persist balances for 91 days or more.
• If you have to load time offs for terminated
employees, load the time offs before completing
the termination.
• If you're loading large volumes of time off
requests (thousands), consider using the Import
Time Off Request Event Batch EIB instead.
This EIB is designed to process large volumes
of data. To determine which web service
performs best for your EIB, test these EIBs in a
nonproduction tenant.

Business Processes
Request Time Off.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service is add-only. It doesn't support deletions or updates.
• The Request Time Off business process doesn’t enable you to rescind. If you inadvertently upload
incorrect entries and they're still in progress, you can use mass cancel; otherwise, use the Adjust Time
Off EIB to reverse the incorrect entries.
For reference documentation for all web services including Enter Time Off, see Operation Directory.

Sample EIB Input File


Enter_Time_Off-WD31

Concept: Import Time Off Request Event Batch EIB

Background
You can use this EIB to load large volumes of new time off entries (approximately 2,000 requests or more).
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• On the Worker Profile related actions menu, select Time and Leave. Then depending on your
configuration, select either Enter Absence or Enter Time Off.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 92

• The Enter Absence or Enter Time Off tasks, depending on your configuration.
You can also use these EIBs:

EIB Name Purpose


Enter Time Off Use to adjust existing time off entries.
Put Absence Input Use to add or update an accrual or time off
adjustment/override for a worker.
Put Override Balance Use to add or update a new time off plan override
balance record for a given worker and time off plan.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Import Time Off
Request Event Batch business process in the
Time Off and Leave functional area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields in the input file,
consider:

Field Considerations
Header Key Determines the batch
for a leave event. Use
the same header key
to group all events in a
batch.
Example: To load
events in 2 batches,
use 1 for the first
5,000 rows and 2 for
the next 5,000 rows.

Line Key An incremental value


for each row within a
header key batch.
Example: Use 1 for
the first row, 2 for the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 93

Field Considerations
second row, 3 for the
third row, and so on.
Each worker should
have only 1 line key
value. Restart the
numbering at 1 for
new header key value.

Row ID You need a unique


row ID for each time
off entry.
Turn Off Run Time Set to Y to turn
Calculations with OFF Run Time
Time Off Approval Calculations with
Time Off Approvals.
Setting to Y will
improve performance.
Set to N to turn ON
calculations. If you
set to Y, you can
find instructions
to run calculations
after the import in
Manually Run Time
Calculations.
Run Time Off Set to Y if you DO
Validations want to validate Time
Off Entries. Set to N
if you do NOT want to
validate them. Setting
to N will improve
performance.
• Below are other considerations to take
when preparing the EIB file and loading
the data. We recommend you abide by
these recommendations to obtain optimal
performance:
• Preparing the EIB
• You can use multiple header keys. All
Time Off requests for the same worker
must be under the same header key.
• Each worker should have only 1 line key
value.
• Each Time Off request in the same Time
Off Type has only 1 unit for the same date
per row. Example: A worker requests 3
hours time off and 2 hours time off, of the
same type and on the same date. Include
these requests as 5 hours on the same
row. If you’re loading requests with Start

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 94

and End Times, you can use multiple


rows.
• Each row has a unique ID in the tenant.
• Don't split workers across files. All entries
for a worker should be in the same file.
• Order requests chronologically, from
oldest to most recent.
• Consider not entering a Time Off request
before the latest persisted balance date.
• Consider entering an optional Time Entry
ID to help manage requests by batch.
• Loading Data
• Don't split workers across files. All entries
for a worker should be in the same file.
• Order requests chronologically, from
oldest to most recent.
• For manageable high volume of data, load
the data in 1 file.
• For extremely high volume of data, you
could split the data across multiple files,
but this option introduces risk.
• Loading multiple files in parallel doesn't
give a performance improvement and also
introduces risk.
• Re-evaluation should always remain
on. Turning it off can create invalid data
that impacts workers’ balances and
downstream payroll.

Common Issues and Errors

Issue Cause and Solution

No option to launch the EIB This issue is security-related.


Check the request time off business process
security policy and ensure you have access to
initiating Action Import Time Off Request Event
Batch.

Slow performance Consider these options:


1. Persist balances up to just before the earliest
data. Example: If your earliest data is in January
2020, persist up to December 2019. Don't
enter a time off entry before the latest persisted
balance date.
2. If you must load time offs for terminated
employees, load the time offs before completing
the termination.

Business Processes
Request Time Off.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 95

Use Cases and Guidelines for Recovering from a Bad Load


• This web service is add-only. It doesn't support deleting or updates.
• Note that the Request Time Off business process doesn’t allow you to rescind. If you've inadvertently
uploaded incorrect time off entries, rescind isn't an option. Therefore, you would need to use the Adjust
Time Off EIB to reverse the incorrect entries unless the entries are still in-progress. In that case, you
could use the Mass Cancel business process.
For reference documentation for all web services including Import Time Off Request Event Batch, see
Operation Directory.

Sample EIB Input File


Import_Time_Off_Request_Event_Batch-WD36

Concept: Put Absence Input EIB

Background
You can use this EIB to add or update time off adjustments/overrides for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The Maintain Accrual and Time Off Adjustments/Overrides is the equivalent task.
You can also use these EIBs:

EIB Name Purpose


Adjust Time Off Use to adjust an existing time off entry.
Enter Time Off Use to submit new time off entries.
Import Time Off Request Event Batch Use to load large volumes of new time off entries
(approximately 2,000 requests or more).
Put Override Balance Use to create or update a time off override balance
for an employee.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From related actions of the EIB, select
Template Model > View.
2. You can view the version on this page. Verify
you’re using a newer version.
3. If using an older web service version, you can
create a new EIB to get the latest version.
• You must have access to the Worker Data:
Time Off (Accrual and Time Off Adjustments/
Overrides by Batch ID) domain in the Time Off
and Leave functional area to run this EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 96

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• This EIB has a Generate Spreadsheet with
Data option, which is very helpful to use when
you aren’t certain how to populate the input file.
To use it:
• First manually enter an adjustment or
override like the ones you wish to load.
• Then, from related actions of your EIB, select
Template Model -> View.
• Go to bottom of page and select Edit
Template with Data Options.
• Set filter to Condition Rule Filter.
• Go to the Rule Conditions Filter and add
conditions to retrieve the information you
entered. Note that the conditions you need
to enter will vary based on the information
you wish to retrieve. Below are some sample
conditions that you could enter:
• Comment is not blank
• Comment contains 2019
• Unit of Time not in the Selection List
Months (if you have no absence inputs
that use months, then this option would be
a way to extract all entries)
• If you regenerate the template and select the
Generate Spreadsheet with Data option,
you can view how the EIB populates the file
for the existing absence input entries.
• Refer to Customize EIB Spreadsheet
Template for more details.
• After you load the file, you can use 1 of these
standard reports to validate the loaded data:
• Accrual and Time Off Adjustments/
Overrides: Is a standard report, so you also
have the option of making a copy if you wish
to add additional fields.
• Accrual and Time Off Adjustments/
Overrides by Batch ID.
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each entry.
Absence Input Populate this field only
if updating an existing
absence input. Note
that if there’s no

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 97

Field Considerations
Absence_Input_ID
value assigned to the
absence input that
you wish to update,
then you can use
the Workday ID (aka
WID). Change the
reference id type
(in cell C4) from
Absence_Input_ID to
WID. You can find the
Absence_Input_ID
or WID value that
you need to populate
by making a copy of
the standard report
Accrual and Time
Off Adjustments/
Overrides report and
add fields Workday ID
and/or Reference ID.
Batch ID Optional field. We
highly recommend you
provide a value as it
enables you to easily
remove the entry in
the event you make an
error and need to back
out your changes.
Typically you would
use the same batch id
value for all entries in
the input file.
Worker Workday requires a
Worker ID.
Position Typically optional
unless using a
position-based plan.
Absence Component Can refer to an
accrual or time off.
Make certain you
specify the appropriate
reference id in row
4 (Typically you
use this EIB to
make adjustments
or overrides to
accruals. Therefore
the reference id
type would be
Accrual_Code)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 98

Field Considerations
Start Date The start date of
start period. Workday
requires the field.
End Date The end date of End
Period. The field is
optional for overrides
but required for
adjustments.
Reference Date Used to determine
the effective date to
retrieve the snapshot
for the absence
component for the
input. For Accruals,
set the reference date
to start date
Hours Optional field. Specify
the units for the
absence input.
Adjustment Enter Y for Adjustment
or N if Override.
Comment Optional field.
We recommended
including a comment.

Common Issues and Errors

Issue Cause and Solution

The EIB successfully completes, but the worker’s You can start by checking what happens if you
accrual/time off values haven’t changed. manually make the same change with the User
Interface. This check will help you determine
whether its an issue with the EIB or a configuration
issue. If that doesn’t help, below are a few other
items to check:
1. Make certain you didn’t run the EIB in validation
mode.
2. Verify that the worker is eligible for the
adjustment.
3. Enable the absence component (accrual or time
off) that you’re using to allow for adjustments
and overrides.
4. Make certain the worker hasn’t reached the
upper limit for the accrual.

EIB issues error: Validation error occurred. Start Check the start and end dates that you select
Period must equal End Period when Adjustment is and make certain they’re valid. Note that for
true. adjustments, you can specify only 1 period. If
everything looks ok, then you can test entering the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 99

Issue Cause and Solution


adjustment with the User Interface to see if you can
enter the same values specified in the EIB input
file. If there’s no issue manually entering the values,
then generate spreadsheet with data to verify how
to populate the input file.

Slow Performance Refer to the suggestions on the EIB page for Enter
Time Off EIB – Inbound.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries
using the web service.
• This web service doesn’t use a business process, therefore there’s no rescind option. However, if
you have inadvertently uploaded incorrect entries, use can use task Delete Accrual and Time Off
Adjustments/Overrides by Batch ID to remove the entries. If you didn’t specify a batch id when you
loaded the entries, then the solution becomes a bit more involved: but 1 option would be to:
• Get the WID (Workday ID) for all the bad entries. To obtain the ID, make a copy of the standard
report Accrual and Time Off Adjustments/Overrides and add field workday id to the report
definition. This action would then get you the WID.
• Then, rerun the original load and:
• Add the Workday ID value (from above report) in column C (and change C4 to WID)
• Add a batch id
• You can then use task Delete Accrual and Time Off Adjustments/Overrides by Batch ID to
remove the absence input entries.
For reference documentation for all web services including Put Absence Input, see Operation Directory.

Sample EIB Input File


Put_Absence_Input-WD32

Concept: Put Override Balance EIB

Background
You can use this EIB to add or update a time off override balance for an employee.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The Maintain Time Off Plan Override Balances is the equivalent task.
You can also use these EIBs:

EIB Name Purpose


Adjust Time Off Use to adjust an existing time off entry.
Enter Time Off Use to load new time off entries.
Import Time Off Request Event Batch Use to load large volumes of new time off entries
(approximately 2,000 requests or more).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 100

EIB Name Purpose


Put Absence Input Use to add or update time off adjustments/overrides
for a worker.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Worker Data: Time
Off (Time Off Balances) domain in the Time Off
and Leave functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• After you load the file, you can run the Time Off
Plan Override Balances by Batch ID report to
validate the data.
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each override
balance entry.
Override Balance Leave empty.
ID Populate this field if
you want to assign
reference ID values to
new entries that you’re
uploading. You need
a unique value for
each override balance
entry.
Batch ID Although optional, we
highly recommend you
provide a value. By
providing a value, you
can easily remove the
entry if you made an
error and need to back

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 101

Field Considerations
out your changes.
Typically you would
use the same batch ID
value for all entries in
the input file.
Worker Workday requires
an ID. Most likely,
you’ll need to change
the reference ID
type (cell F4) from
Contingent_Worker_ID
to Employee_ID
Position Typically only needed
when using a position-
based plan.
Time Off Plan Name Enter the time off
plan. To identify the
reference ID value,
run Integration IDs
report and search
for business object
Absence Plan.
Override Balance Effective date for the
Date balance override.
Override Balance Enter the new balance
Units value
• Only populate these fields if the time off plan
has a carryover expiration date. To help you
determine how to populate these fields (and how
many entries to add for the worker), run task
Maintain Time Off Plan Override Balances.
Enter the time off plan for one of the employees
that you’re updating:

Field Considerations
Row ID There might be
multiple carryover
periods (if the
expiration time spans
multiple balance
periods). Enter a
unique row ID value
for each carryover
period for a given
employee/time off
plan. Keep in mind
that you should
populate only the
number of carryover
periods that are
applicable based on

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 102

Field Considerations
the employee’s hire
date.
Carryover Date Date the amount
carries over.
Carryover Expiration Enter expiration date
Date of each carryover
period.
Carryover Override Enter any applicable
Balance Units override balance units.

Common Issues and Errors

Issue Cause and Solution

The EIB issues an error like this: Override Balance This error will occur if the plan permits carryover
needs exactly 5 carryover components balances for multiple periods. In this case, you
need to populate an entry in the input file for each
carryover period.

The EIB issues an error like this: Processing This type of error indicates that the load contains
error occurred. Duplicate insert on index: duplicate information. This duplication will occur
Time Off Plan Balance-ID-Calculated and if ID (column D) doesn’t contain unique values—
Override Balance Index (95$2026),value: you need to either specify a unique value for each
1, new instance: id=2161$48673967 employee/time off plan, or leave it blank.
wid=e6328055bc6201f7df8bbcb686428dfc
disp=2161$48673967, existing: id=2161$4104
wid=c2544f9572a81055cf9a7f107bcfab7fdisp=2161$4104

Slow Performance Refer to the suggestions in Future: Concept: Enter


Time Off EIB.

The EIB issues an error like this: 1. Make certain you're using the latest web service
version. If you're not sure what version you're
Carryover Expiration Date for XXXXX with an
using, create a new EIB to uptake the latest
Override Balance Date of MM/DD/YYYY must be
version.
a valid date (MM/DD/YYYY) that the Carryover
Balance expires for XXX 2. If the latest web service version doesn't resolve
it, test adding a 12-month expiry date to the
plan. This option should open up the desired
field.

EIB issues an error like this: Time Off balance design currently doesn’t permit a
value higher than 3 digits. If over 999 hours, you’ll
Error Message: Validation error occurred. The
need to split into multiple entries.
value specified for Time Off Hours, 1215.000000,
must be less than 1000.

There’s no option to launch the EIB. This problem is most likely security-related. When
running the Report View Security for Securable
Item and specifying securable item Put Override
Balance, you’ll see that you need access to domain
Worker Data: Time Off (Time Off Balances). To
change the security, complete these steps:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 103

Issue Cause and Solution


1. Edit the domain security policy for Worker Data:
Time Off (Time Off Balances).
2. Go to the Integration Permissions Section and
add the appropriate security groups. Ideally you
should have access through an unconstrained
security group so you can add entries for any
worker.
3. Check the box for Put access.
4. Activate the security change.

EIB issues an error like this: Make certain you aren’t performing an override
on your own employee ID. If you are, then have
The entered information does not meet
someone else enter the override value for you, or
the restrictions defined for this field.
configure the Integration System User (ISU) to run
(Employee_Reference).
the EIB.

Business Processes
None.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries
using the web service.
• To update existing override balances, just populate the input file with the employee/time off plan/
balance date that you wish to update (no need to supply a reference ID). The web service will then
update the entry if it exists for that employee/time off plan/balance date combination. Otherwise, it will
add a new entry.
• This web service doesn’t use a business process, therefore there’s no rescind option. However, if you
have inadvertently uploaded incorrect entries, you can use task Delete Override Balances by Batch
ID to remove the entries. If you didn’t specify a batch ID when you loaded the entries, do these steps:
• Edit the EIB input file that you originally loaded and add a batch ID value for each entry.
• Rerun the EIB to add the batch ID value to the override entries that you previously loaded.
• After completing these steps, you can use task Delete Override Balances by Batch ID to remove
the balance overrides.
For reference documentation for all web services including Put Override Balance, see Operation Directory.

Sample EIB Input File


Put_Override_Balance-WD36_0

Concept: Request Leave of Absence EIB

Background
You can use this EIB to create or update leave of absence events.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
If you want to create return from leave of absence requests, we recommend that you use a Request Return
from Leave of Absence EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 104

Equivalent Workday Task


The Place Worker on Leave task is the equivalent task.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Request Leave of
Absence business process in the Time Off and
Leave functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• IMPORTANT NOTE regarding Canadian
Workers: if you’re loading Leave of Absence
Events for Canadian workers, you must first edit
the leave type and configure the Last Date for
Which Paid field to be a required field. If you
don’t do this task, the date won’t load, even if
you populate the date in the EIB input file. See
the first entry in the Common Issues and Errors
section for more details on how to configure the
leave type so that the EIB properly loads the
data.
• IMPORTANT NOTE regarding Notifications
for Corrections: The Correction functionality
doesn’t support suppression of notifications,
even if you use the Automatic Processing
processing instruction. If you have a business
requirement not to send notifications for
corrections, we recommend you:
1. Add a condition to the business process
notifications, such as, External Load is blank,
to prevent them from firing when making
corrections use the EIB.
2. Also note that for any changes to the
notifications, Workday only honors for newly
initiated Request Leave of Absence events.
If you need to correct leaves already initiated
(before making the change in item#1 above),
then you might want to temporarily disable
all notifications in the tenant, using task Edit

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 105

Tenant Setup - Notifications, while you run


the EIB.
• As you populate these fields in the input file,
consider:
• Overview worksheet in the EIB input file:

Field Considerations
Processing Set to Automatic
Instructions Processing if you
want to bypass
all approvals,
review steps,
to do steps and
notifications. Set to
Manual Processing
if you want to
manually process
the approval/review/
to do steps (and the
notifications sent).
Discard on Exit As of November
Validation Error 2022, this field isn’t
yet available for use.
Leave blank.
Comment You’ll need to enter
a comment if you’re
correcting any Leave
of Absence Entries.
• Request Leave of Absence worksheet in
the EIB input file:

Field Considerations
Spreadsheet Key (Required) Specify
a unique value
for each Leave of
Absence Event.
Worker (Required) Most
likely, you’ll need
to change the
reference ID in
Cell C4 from
Contingent_Worker_ID
to Employee_ID.
Request Leave of A required field only
Absence ID if you’re correcting
an existing Leave of
Absence Request.
See theUse Cases
and Guidelines for
Recovering from a
Bad Load section,
which demonstrates

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 106

Field Considerations
how to identify the
values for Request
Leave of Absence
ID. Note that if
correcting a Leave
of Absence request,
you also need to set
the Correction field
to Y.
Correction Set this field to Y to
correct an existing
Leave of Absence
Request. You’ll also
need to populate the
Request Leave of
Absence ID field.
Leave of Absence (Required) To
Type determine the
reference ID type
value needed
to populate this
field, run the View
Reference IDs
report and search
business object
Event Classification
Subcategory. You
can then filter the
Business Object
Instance column
(such as, search
Leave or Disability)
to find the reference
ID value for the
leave types you wish
to use.
First Day of Leave (Required) Date for
first day of leave.
Enter using format
YYYY-MM-DD.
Last Day of Work Date for last day of
work. Enter using
format YYYY-MM-
DD.
Estimated Last Day (Required) Date
of Leave value for estimated
last day of leave.
Enter using format
YYYY-MM-DD.
Last Date for Which Workday requires
Paid this field for Canada.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 107

Field Considerations
In addition, be sure
to configure the
leave type in your
tenant, so that this
field becomes a
required field. Refer
to the first entry in
the Common Issues
and Errors section
for more details.

Common Issues and Errors

Issue Cause and Solution

The EIB doesn’t load the Last Day for Which Paid When using the EIB, you must make certain to
(LDFWP) field even though it’s populated in the EIB configure the Leave Type so that Last Date for
input file. Workday requires this field to submit an Which Paid (LDFWP) is a required field. Resolve as
ROE for Canada. follows:
1. Run task Edit Leave Type.
2. Select the Leave Type that you’re referencing in
the EIB input file.
3. Click OK.
4. Go to the Additional Field tab.
5. Select the + in the Additional Fields section.
6. In the Additional Field, select Last Date for
Which Paid.
7. Check the Required check box.
8. You might see a warning that there are Pending
requests that need corrected or canceled. Go
ahead and click OK.
9. If you've already loaded Leave of Absence
events where the LDFWP is missing, then you’ll
need to do one of these options:
• Option 1: Mass Rescind the Events and
reload them.
• Option 2: Correct the existing events by
rerunning the EIB and populating the
Request Leave of Absence ID and Correction
fields.

Unable to launch the EIB This issue is most likely security-related. When
running report View Security for Securable Item
for securable item Request Leave of Absence
(Web Service), you’ll see that you need access to
business process Request Leave of Absence. To
change the security, you can:
1. Edit the business process security policy for
Request Leave of Absence.
2. Go to the section for Initiating Action Request
Leave of Absence (Web Service).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 108

Issue Cause and Solution


3. Make certain you have access (ideally you
should have access through an unconstrained
security group so that you can load Leaves for
any worker).
4. Activate the change.

EIB issues an error like this: Verify that the reference ID type in cell C4 of your
EIB input file is Employee_ID.
Invalid ID value. '21133' isn’t a valid ID value for
type = 'Contingent_Worker_ID'.

EIB issues errors like this: Enter the dates in your EIB input file with format
YYYY-MM-DD.
• Invalid format for date text=3/1/2020 on attr
Event Effective Date
• Invalid format for date text=02/29/2020 on attr
Last Day of Work.
• Invalid format for date text=02/29/2020 on attr
Estimated Last Day of Leave.
• Invalid format for date text=02/29/2020 on attr
Last Day for which Paid.

EIB issues error: If you’re making any corrections, you must:


Each correction must have a comment. Add 1. Edit the EIB input file.
comments for each correction that you’re 2. In the Overview tab, add a value for Processing
processing.. Comment for the Request Leave of Absence
business process.

When submitting corrections, notifications occur The Correction functionality doesn't support
even though I specified processing instruction suppression of notifications. See the EIB Input File
Automatic Processing. Guidelines section for tips on working around this
restriction.

Business Processes
Request Leave of Absence.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add new entries or correct existing entries. You can’t delete entries.
However there are options to rescind or cancel the Business Process event.
If you've inadvertently uploaded incorrect entries, there are a couple options to recover.
• Option 1: Cancel or rescind the incorrect entries. Run task Mass Cancel Business Processes or
Mass Rescind Business Processes (depending on whether the business process event completed
or in progress). You can then select Business Processes Loaded by EIB to find the integration event
that you wish to cancel or rescind. Or the other method is to enter Request Leave of Absence at the
Business Process Types prompt; then enter a date range that you ran the EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 109

• Option 2: Correct the existing entries by rerunning the EIB with the correct values. To correct the data:
• Edit the EIB input file.
• Set the Correction field to Y for entries that need corrected.
• Populate the Request Leave of Absence ID field with the Leave of Absence event that needs
corrected. You can create a custom report to identify the values to populate in the Request Leave of
Absence ID field.
• Change any fields that have incorrect values before reloading.
For reference documentation for all web services including Request Leave of Absence, see Operation
Directory.

Sample EIB Input File


Request_Leave_of_Absence-v39

Concept: Request Return from Leave of Absence EIB

Background
You can use this EIB to create return from leave of absence requests.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
If you want to create new leave of absence requests or correct existing leave of absence events, we
recommend that you use a Return from Leave of Absence EIB.

Equivalent Workday Task


The Return Worker from Leave task is the equivalent task.
See also, Concept: Importing Leave of Absence Events for more information.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Request Return
from Leave of Absence is a business process in
the Time Off and Leave functional area to run
this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 110

• As you populate the EIB input file, consider:


• Overview worksheet in the input file:

Field Considerations
Processing Set to Automatic
Instructions Processing if you
want Workday to
bypass all approvals,
review steps,
to do steps and
notifications. Set to
Manual Processing If
you want to manually
process the
approvals/review/to
do steps and send
notifications.
Comment You’ll need to enter
a comment if you’re
correcting any
Return from Leave of
Absence Entries.
• Request Return from Leave of Absence
worksheet in the input file:

Field Considerations
Spreadsheet Key (Required) Specify
a unique value for
each worker.
Worker (Required) Most
likely, you’ll need
to change the
reference id in
Cell C4 from
Contingent_Worker_ID
to Employee_ID
First Day Back at (Optional) Enter
Work using format MMM-
YY-DD.
Row ID (Required) Enter a
unique row id value
for each leave of
absence event for a
given worker. Most
likely, there would
be just 1 return per
worker, therefore the
row id value would
always be 1.
Request Leave of (Required) Refer
Absence to the sample

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 111

Field Considerations
report below which
demonstrates how
to identify the values
for this field.
Correction Set to Y to correct an
existing Return from
Leave of Absence
entry.
Actual Last Day of (Required) Enter
Leave using format MMM-
YY-DD.
• Make certain that the steps in the Request
Return from Leave of Absence business process
definition align to what you're populating in the
EIB input file. Example: If the business process
has an Assign Roles to Worker step, then you
need to either populate the role information in
the EIB input file, or else add a condition rule to
skip the step in the business process. Example:
Add condition rule External Load = N.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but the workers This issue might occur because the business
remain on leave process events are still in progress. Check the
worker history for one of the worker’s and verify
that the Return from Leave of Absence event
successfully completed. If not, you can:
1. Check why the business process event is still
in progress. Then make appropriate changes
to theRequest Return from Leave of Absence
business process definition. Example: You might
need to remove steps or add a condition rule
such as External Load is not blank so that
Workday skips the steps.
2. Use Mass Cancel Business Process task to
cancel the business process events.
3. Rerun the EIB.
The other reason that the workers might still display
as being on leave, is if the return date is in the
future.

Unable to launch the EIB This issue is most likely security-related. When
running report View Security for Securable Item
for securable item Request Return from Leave of
Absence (Web Service), you'll see that you need
access to business process Request Return from
Leave of Absence. To change the security:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 112

Issue Cause and Solution


1. Edit the business process security policy for
Request Return for Leave of Absence.
2. Go to the section for Initiating Action Request
Return from Leave of Absence (Web Service).
3. Make certain you have access (ideally you
should have access through an unconstrained
security group so that you can load Returns for
any worker.)
4. Activate the security change.

EIB issues an error like this: Make certain that the reference id type in cell C4 of
your EIB input file is Employee_ID.
Validation error occurred. Invalid ID value.
'21001' is not a valid ID value for type =
'Contingent_Worker_ID'.

EIB issues errors like this: Make certain that you specified the correct
Employee ID and Request Leave of Absence id
The "Request Leave of Absence Reference" must
in the EIB input file.
be for the employee specified in the "Employee
Reference". Also, if making a correction to an existing Return,
be certain to set the Correction field to Y.
Return from Leave of Absence Requests can only
be made to "Successfully Completed" but not yet
returned from Request Leave of Absence Events.

EIB issues error: Enter a comment if correcting a return from leave of


absence event. You can:
Validation error occurred. A correction cannot be
processed without a comment. 1. Edit the EIB input file.
2. Go to the Overview tab.
3. Enter a value in the Processing Comment field
for the Request Return from Leave of Absence
business process.

EIB issues error: Make certain you included a value for Row ID in the
EIB input file.
Validation error occurred. Element Content
'Leaves_Returning_from_Data' is required, on
internal element 'Request Return from Leave of
Absence Data'.

When running the Request Return from Leave Workday is looking into this issue. For now, you can
of Absence EIB, it triggers the Compensation work around the problem as follows:
subprocess (which is an optional step) despite
1. Go to business process definition for Request
setting processing instruction as Skip when marked
Return from Leave of Absence.
optional.
2. Either remove the compensation step or add a
condition step to the compensation step such as
External Load is Blank.
If the above workaround isn’t acceptable to your
organization, open a case with Workday Support
and reference ticket HRCOMPROC-184.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 113

Business Processes
Request Return from Leave of Absence.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or correct existing entries. You can't delete entries.
However, there are options to rescind or cancel the Business Process event.
• If you've inadvertently uploaded incorrect entries, there are a couple options:
• Option 1: Cancel or Rescind the incorrect entries. Run the task Mass Rescind Business
Processes (or Mass Cancel Business Processes if the business process event is in progress).
You can then select Business Processes Loaded by EIB to find the integration event that you wish
to cancel or rescind. Or the other method is to enter Request Return from Leave of Absence at the
Business Process Types prompt; then enter a date range that you ran the EIB.
• Option 2: Correct the existing entries by rerunning the EIB with the correct values. To correct the
data:
• Edit the EIB input file.
• Set the Correction field, in the EIB input file, to Y.
• Change any fields that have incorrect values before reloading.
• If you need a report to get the reference id values for the Request Leave of Absence events, you
can create a custom report.
For reference documentation for all web services including Request Return from Leave of Absence, see
Operation Directory.

Sample EIB Input File


Request_Return_from_Leave_of_Absence-WD34

Benefits Administration EIBs


Concept: Add Dependent EIB

Background
You can use this EIB to add new dependents in Workday. For updating existing dependents, you can use
the Edit Dependent EIB.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


See Benefits > View Dependents from the related actions of the worker's profile.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 114

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Dependent Event
business process type in the Benefits functional
area to run this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files. Additionally, as you populate these fields
in the input file, consider:

Fields Consideration
Spreadsheet Key Specify a unique value
for each dependent,
even if multiple
dependents are
associated with the
same employee.
Dependent ID If you leave this blank,
the EIB automatically
assigns an ID value at
launch. Alternatively,
you can assign your
own ID by entering a
value. If you enter a
value, it must be unique
and not already in use.
Employee Update cell F4 to
Employee_ID.
Related Person You can find a list of
Relationship reference ID values
by running the View
Reference IDs report
and searching for
the Related Person
Relationship business
object.
Use Employee If set to Y, then the
Address dependent shares
the same primary

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 115

Fields Consideration
home address as the
employee.
Use Employee Phone If set to Y, then the
dependent shares the
same primary home
phone data as the
employee.
Country The country of the
dependent. If you click
the down arrow in cell
M4, you’ll see 3 different
reference ID types
that you can use for
the country:
• ISO_3166-1_Alpha-2_Code
• ISO_3166-1_Alpha-3_Code
• ISO_3166-1_Numeric-3_Code
You can find a list
of reference ID values
by running the View
Reference IDs report
and searching for
the Country business
object.

Address Data If you set the Use


Employee Address
field to N, then you must
enter an address.
Date of Birth Use format YYYY-MM-
DD.
Gender You can find a list
of reference ID values
by running the View
Reference IDs report
and searching for the
Gender business object.

Common Issues and Errors

Issue Cause and Solution


Failure to load Add Dependent EIB data after 1. Verify that you ran the EIB in live mode and not
completion. validate only mode.
2. Verify that the business process successfully
completed. If it’s still in progress, take the
necessary actions to ensure it processes or
skips all steps.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 116

Issue Cause and Solution


3. Mass cancel the dependent events that you
loaded using the Mass Cancel Business
Processes task and rerun the EIB.

EIB issues an error like this: Check the reference ID type specified in the
Employee field. You need to change cell F4 to
Invalid ID value. '21001' is not a valid ID value for
Employee_ID.
type = 'Contingent_Worker_ID'

EIB issues an error like this: Specify an address for the beneficiary.
Validation error occurred. At least one address is • If you want to use the same address as the
required for beneficiaries or dependents. Please employee, enter Y in the Use Employee
enter an address for the beneficiary or dependent. Address field.
• If you aren’t using the same address as the
employee, then you must enter an address.

EIB issues an error like this: Verify that you’ve populated the country in the
address data section.
Country Reference is required unless address is
being deleted.

EIB issues an error like this: You’re populating a field that has reference ID type
IID (Instance ID). Check for any government or
Validation error occurred. Instance ID cannot be
national IDs that populate in the EIB input file, and
parsed.
confirm that you’re populating the correct field.
Unable to launch the EIB. This is most likely security-related.
Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Dependent Event business
process type in the Benefits functional are.

Business Processes
Dependent Event.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only adds dependents. It can’t update or delete existing dependents. If you’ve uploaded incorrect
entries, you can:
• Option 1: Use the Edit Dependent EIB to update the entries with the correct information.
• Option 2: Use either the Mass Cancel Business Processes task (if the event is still in progress)
or Mass Rescind Business Processes task (if the event is complete). Both of these tasks are
secured to the Business Process Administrator domain in the System functional area. You can then
select Business Processes Loaded by EIB to find the integration event that you want to cancel or
rescind. Alternatively, you can enter Dependent Event in the Business Process Types prompt and
enter the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Add Dependent, see Operation Directory.

Sample EIB Input File


Add_Dependent-v37_0

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 117

Concept: Change Benefits EIB

Background
You can use this EIB to change benefit elections for an employee.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


See Benefits > Change Benefits from the related actions of a worker profile.
Note:
The Change Benefits EIB has some differences from the user interface (UI) task.
Example: The UI task has additional functionality that the EIB doesn't support, such as: coordination of
events, calculation of FSA and HSA per pay periods and benefit defaulting.
We recommend using the EIB only to mass load new employees during initial setup, or to support the
acquisition of a large volume of new employees.
For this reason, we don't recommend using the Change Benefits EIB for loading ongoing benefit
enrollments from third-party systems.

EIB Input File Guidelines


We recommend that you:
• Review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which provides a general
overview for populating EIB files.
• Submit a test benefit event in a nonproduction tenant using the information that you intend to specify in
the EIB input file.
• This enables you to test your configuration in Workday and identify what information you want to
supply in the EIB input file.
• Specify each benefit plan on a separate row in the EIB input file. Example: if you want to add a health
plan and an HSA for an employee, put each of them on a separate row.
• Specify each dependent on a separate row as well.
If you want to:
• Submit additional coverage for an existing benefit event type, then populate the EIB input file with all the
plans that the worker already has for that benefit event type - not just the new coverage you’re adding.
We recommend creating a specific benefit event type that only contains the coverage types that you
want to change.
• Remove an existing plan, then specify the event type in the input file and include no other information
regarding the plan. This is equivalent to waiving the plan. You can't waive autoenroll plans. To remove
workers from autoenroll plans, change the eligibility rule to make the workers ineligible for the plan.
As you populate these fields in the input file, consider:

Field Considerations
Spreadsheet Key Specify a unique value for each combination of
worker and benefit event type.
Coverage Begin Date (Required) Specify a Coverage Begin Date that's on
or after the benefit event date.
Workday bypasses the Coverage Begin Date
value in the input file and instead calculates the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 118

Field Considerations
Coverage Begin Date based on the Start or Waive
Coverage tab of the Enrollment Event Rule. We
also calculate the Deduction Begin Date based on
the Enrollment Event Rule.

Original Coverage Begin Date Leave blank. Avoid populating this field. If
you include this data on the file, it displays as
the Coverage Begin Date for the election. There’s
no way to edit or correct this date in the user
interface.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but there’s no Check if the employee is eligible for any plans:
benefit information added or updated.
1. From the related actions menu of the worker
profile, click Worker History > View Worker
History by Category.
2. Select the Benefits tab and check the business
process event that you loaded with the EIB.
3. Check the Details tab. If you see a message
stating that there are no elected benefit plans,
then it's likely that the employee wasn’t eligible
for the plans listed in the input file. You can
manually submit the same benefit changes
in Workday to determine the employee's plan
eligibility. Remove any ineligible plans from the
input file and resubmit the EIB.

The EIB is wiping out existing benefit plans for the If you want to add or update coverage for an
worker. existing benefit event type, include all existing plans
for the worker. Otherwise, Workday removes any
existing plans that weren't included.

Even when setting the EIB processing instructions This is working as we would expect. This EIB is
to Manual Processing, the EIB skips notifications intended for administrators to load data without
and bypasses all approval steps, document review any employee actions. It was specifically designed
steps, and so on. to finalize the events, bypassing any steps in the
business process.

Business Processes
This EIB uses the Change Benefits for Life Event business process. The parent business process is
Change Benefits.

Use Cases and Guidelines for Recovering from a Bad Load


If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if
the event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both
of these tasks are secured to the Business Process Administrator domain in the System functional area.
Enter Change Benefits in the Business Process Types prompt and enter the date range that corresponds
to when you ran the EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 119

For reference documentation for all web services including Change Benefits, see Operation Directory..

Sample EIB Input File


Change_Benefits-WD30_0

Concept: Edit Dependent EIB

Background
You can use this EIB to update a dependent.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


Select Benefits > Dependents from the related actions of the worker's profile.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Dependent Event
business process type in the Benefits and
Personal Data functional areas to run this EIB.

Guidelines for Creating a Custom Report for the To get information needed to populate the EIB input
EIB Input File file, you might find it helpful to create a custom
report using the All Dependents data source and
the Dependent primary business object. This
table lists a sampling of the business objects and
report fields that you can select. You’ll need to
make some modifications based on the type of
information you’re loading.

Business Object Field


Dependent Dependent
Dependent Reference ID
Worker Employee ID
Dependent Legal Name
Dependent Relationship
Dependent Date of Birth

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 120

Business Object Field


Dependent Uses Tobacco
Dependent Phone Number -
Primary with Country
Code
Dependent Primary Address - Full
Other IDs Custom ID
Other IDs Workday ID
Other IDs Custom ID Type
Government Identifiers Identification Number
National Identifiers National Identifier
National Identifiers Identification Number

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each dependent.
Dependent Enter the reference
id value of the
dependent you wish
to update. You can
get the id from the
report above or you
get the ids by running
the View Reference
IDs report and enter
business object
Dependent.
Dependent ID Enter a value here
only if you wish
to assign a new
reference id value
to the dependent.
Otherwise, leave this
field empty. If you
wish to update the
reference ID only,
Workday recommends
that you use Put
Reference ID instead.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 121

Field Considerations
Reason To view values, run
the View Reference
IDs report and select
business object
Event_Classification_Subcategory.
Then filter the
Business Object
Instance column by
searching on a string
such as Dependent
to find the relevant
values.
Related Person Reference to the
Relationship relationship between
the dependent and
the related person. To
find the reference id
values, run the View
Reference IDs report
and enter business
object Related Person
Relationship.
Custom ID If updating or deleting
an existing Custom
ID (aka Other ID),
you must supply the
Workday ID (aka WID)
of the ID. You can get
the ID for a custom
report if you created
one. Note: the WID
value can change
each time you update
the Custom ID. So
make certain you
check the WID value
before each new EIB
load.
ID Type If providing Custom ID
information, populate
the ID type. To get
a list of reference id
values, run the View
Reference IDs report
and enter business
object Custom ID
Type.
Date of Birth Enter the date of birth
for the dependent in
format YYYY-MM-DD.
Workday requires this
field.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 122

Field Considerations
Gender Enter the gender
of the dependent.
Workday requires
this field. For a
list of reference id
values, run the View
Reference IDs report
and search business
object Gender.
Inactive Date Enter a date if you
wish to inactivate the
dependent.

Common Issues and Errors

Issue Cause and Solution

EIB issues these errors: Workday requires Gender and Date of Birth
values when updating dependents using the web
• Element Content 'Gender_Reference' is
service. You might want to create a custom report
required, on internal element 'Related Person
as described in the Guidelines for Creating a
Personal Information Data'
Custom Report for the EIB Input File section to get
• Element Content 'Date_of_Birth' is required, the Gender/Date of Birth values needed to populate
on internal element 'Related Person Personal the EIB.
Information Data'

Unable to launch the EIB. This issue is most likely security-related.

Business Processes
Dependent Event.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to update existing dependents only. If you need to add or delete
dependents, select 1 of these options:
• Add dependents: use web service Add Dependent
• Delete dependents: Workday doesn't support deleting dependents in bulk. If you need to delete,
you must manually do so. And even if manually deleting, you can delete dependents only if they
have never enrolled.
• If you have inadvertently uploaded incorrect entries, use the Mass Cancel Business Processes or
Mass Rescind Business Processes. Select cancel or rescind based on whether the business process
event has completed or is still in progress. You can then select Business Processes Loaded by EIB to
find the integration event that you wish to cancel or rescind. Or the other option is to enter Dependent
Event at the Business Process Types prompt and enter a date range that you ran the EIB.
For reference documentation for all web services including Edit Dependent, see Operation Directory.

Sample EIB Input File


Edit_Dependent-WD35

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 123

Concept: Import 1095-C Form Recipients Data EIB

Background
You can use this EIB to add or update 1095-C form data for a given 1095-C recipient.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Process: ACA Tax
Filing 1094-C/1095-C (Run) - USA domain in
the Benefits functional area to run this EIB.

Additional Input File Guidelines • To ensure you're using the latest web service
version, create a new EIB integration each 1095
Season.
• We suggest you start by reviewing Steps: Import
ACA 1095-C Recipient Data for instructions on
using this EIB.
• Start by running the Create ACA 1095-
C/1094-C task. Then, run the View 1095-C
Form Recipient Data. Export report. Use
the report output as input for the EIB.
• We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• As you populate these fields in the input file,
consider:

Field Considerations
Header Key Specify 1 header key
value for each unique
combination of year
and company. We
recommend you load
just 1 company and
year within each EIB
input file. Loading 1
company and year

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 124

Field Considerations
will make it easier to
identify and fix any
errors issued when
loading the data.
Line Key Use the same line
key value for a worker
and their covered
individuals. Populate
all covered individuals
for the worker. If you
don’t include all of
them in the input file,
they get removed.
Employee Populate the
employee ID when
making updates to any
worker who already
exists in the Workday
tenant. If you leave
the field blank, a new
entry gets added and
you’ll have duplicates.
Also, note that the
reference ID type (in
cell D4) defaults to
Contingent_Worker_ID.
Most likely you’ll
want to change it to
Employee_ID. If you
make any changes to
an employee, include
any dependents for
this employee in the
EIB input file. Include
the dependents
even if you aren’t
making changes to the
dependents.
Zip Code You only need to
populate this field if
there’s an Individual
Coverage Health
Reimbursement
Arrangement (ICHRA).
Plan Start Month The EIB requires
this entry as of Tax
Year 2020. Enter a
2-digit number from
00-12 for Plan Start
Month. If there’s no
health plan under the
coverage offered to

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 125

Field Considerations
the employee, enter
00. Format this field
as a text box so that
the leading 0 doesn't
get truncated when
entering a single digit
value such as 01.
External 1095-C If you’re transmitting
Recipient ID information for a
worker who doesn’t
exist in Workday,
specify the External
1095-C Recipient ID
instead of employee
ID. The first time you
load the external
recipient, leave this
field blank. If you
make any subsequent
updates, reference
the value that got
assigned to the
external recipient ID,
so that a duplicate
doesn’t get created.
Generation Source This field is for internal
use, so leave it blank.
Is Transmitted Leave this field blank.
Row ID Use a different
value for each of the
covered individuals for
a given worker.
Covered Individual When updating an
Reference existing Covered
Individual, you can
populate the Covered
Individual Reference
ID if the unmasked
SSN isn’t available.
You can leave this
field blank if one
of these conditions
exists:
• You’re adding
a new covered
individual.
• The entry is
for an existing
covered individual
and you’re able

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 126

Field Considerations
to supply an
unmasked SSN.

SSN When populating the


worker SSN or the
SSN for the covered
individual
• For any entry
where you
don’t specify an
employee ID/
contingent worker
ID (in column
D), make certain
all SSNs get
unmasked for that
entry.
• Note: there
are 2 places in
each row where
an SSN can
get specified:
Column L is the
Employee SSN
and Column BL
is the Covered
Individual SSN.
• If you’re adding
an SSN for a new
covered individual,
enter an unmasked
SSN in column BL.
• If the SSN starts
with a 0, follow one
of these options:
• Option 1:
Format the cell
as text and then
ensure that the
leading zero is
there.
• Option 2:
Format the cell
as number and
then add an
apostrophe to
the beginning of
the number (an
example would
be '011223333).

DOB If the SSN isn’t


available for a covered

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 127

Field Considerations
individual, then
provide a Date of
Birth.

• After you’ve loaded the data through EIB, you


might find it helpful to rerun the View 1095-C
Form Recipient Data report to validate that the
data loaded as you expected. Also, you might
find it helpful to filter by the Generation Source
column. All recipients initially have value WG for
Generation Source, but after the EIB load, you’ll
notice that:
• The Generation Source column displays
value WE for employees updated through
EIB.
• The Generation Source column displays
value EG for any External Recipients that you
uploaded through EIB.

Common Issues and Errors


NOTE: When Workday returns errors, the Line Number value in the error report isn’t the line number in
the Excel file. Rather, it signifies the nth employee in the EIB input file. Example: If the error indicates a
problem for line #5, check the fifth employee in the EIB input file.
Use sequential line key values in the EIB input file. Otherwise, the line # specified in the error message
might not match up to the Line Key value in the EIB input file.

Issue Cause and Solution

The EIB issues the error SSN of new records • This issue occurs if the Covered Individual
cannot be masked. Reference value in the EIB input file is incorrect.
• Note: every time you create the ACA data,
the covered individual Reference IDs will get
newly assigned. Also, IDs won’t match up
between different tenants such as Sandbox and
Production. You might need to rerun the View
1095-C Form Recipient Data report to pick up
the correct values.
• This issue also occurs when the EIB input
file contains masked SSN values for covered
individuals, yet the Covered Individual
Reference value is blank. If the Covered
Individual Reference value is blank, specify
unmasked SSNs in column BL.
• This issue can also occur if the SSN starts with
a 0. If the SSN starts with a 0, make sure it’s a
text box, and that the 0 isn’t getting dropped.
Also, when entering the SSN, use dashes (such
as 011-22-3333). Be sure to verify the SSN
values for the employee (column L) as well as
the covered individual (column BL).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 128

Issue Cause and Solution

The EIB issues the error The SSN for this 1095-c This issue can occur if the SSN starts with a 0.
is not valid. Please use the valid formatting. xxx-xx- If the SSN starts with a 0, make sure it’s a text
xxxx. box and that the 0 isn’t getting dropped. Also,
when entering the SSN, use dashes (such as
011-22-3333). Be sure to verify the SSN values for
the employee (column L) as well as the covered
individual (column BL).

The EIB issues these errors: For the entry where failure occurred, check that a
Social Security Number gets populated in column L.
• Element Content 'Social_Security_Number'
is required, on internal element 'Employee
Information Data'
• The SSN for this 1095-c is not valid. Please use
the valid formatting. xxx-xx-xxxx

The EIB issues an error similar to ERROR: This issue can occur if you’re trying to modify the
com.workday.index.DuplicateIndexException: recipient name. If this error occurs, we recommend
Duplicate insert on index: ACA Report Form Box you:
(Dependent Month Based)-ID-Covered Individual
1. Remove the Covered Individual Reference value
Box ID (95$3951), value: CoveredIndividual-….
in the EIB input file, for any persons where the
error occurs.
2. Unmask all SSNs in the EIB input file for the
individuals where error occurs.
3. Rerun the EIB.

The EIB issues an error for an entry that has no • This issue might occur if you’re loading more
errors. than 1 company (and subsequently more than 1
header key value) in the same EIB input file.
• If there’s more than 1 header key in the input
file, and you receive an error in Par Count Line
Number 1, you won’t know the cause of the
error. The error can be the first entry for header
key 1 or the first entry for header key 2. To avoid
this problem, load only 1 header key per input
file.

The EIB issues an error similar to Invalid ID This issue usually occurs because in the input
value.'21001' is not a valid ID value for type = file, the reference ID for Employee references
'Contingent_Worker_ID'. Contingent_Worker_ID instead of Employee_ID.
Workday populates the EIB input file with the
reference ID type for the first valid type that
it finds. Workday selects the ID based on
alphabetical order. To resolve this issue, change
the value in cell D4 from Contingent_Worker_ID to
Employee_ID.

The EIB issues an error Invalid Attribute This issue occurs if there’s a value in the
Generation_Source-urn:com.workday/bsvc for Generation Source column of the EIB input file.
element ACA_1095-C_Form (6$89256). Remove any values in this column.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 129

Issue Cause and Solution

The EIB issues error: Enter a 2-digit number from This issue might occur if you’re entering a 1-digit
00-12 for Plan Start Month. number (Example: 1) instead of a 2-digit number
(01). To resolve this issue:
1. Edit the EIB input file.
2. Click the column for Plan Start Month (this
column is column R if using the latest EIB
version).
3. Format Cells and select Text.
4. Then if you’re entering a single digit month,
reenter it with the leading 0. Example, enter 01
instead of 1.

The EIB issues an error Invalid boolean value=Yes This issue occurs if you specify the value Yes or No
for type All 12 Months Bool. in the All 12 Months column (column BN) of the
EIB input file. Instead, you need to specify Y or N.

The EIB completes successfully, however no 1. Ensure that you didn’t run the EIB in validation
updates got made. mode.
2. If you specified covered individual reference
values in the EIB input file, ensure that they’re
correct.
a. The reference IDs aren’t the same across
all tenants, and the IDs get regenerated
each time you create the 1095 data. Use the
View 1095-C Form Recipient Data report to
validate the values.
b. You don’t need to supply the reference IDs
if SSNs get unmasked and are for existing
covered individuals.
3. Ensure that you’re using the latest web service
version. If you aren’t certain, create a new EIB,
which will pick up the latest web service version.
4. Also, note that EIB creates corrections only if
there’s a change in worker data to what you sent
previously. If no changes get detected in the
incoming record, it gets ignored.

The EIB completes with some errors. However I For some of the Import Web Service operations,
don’t see the updates in the tenant, for the entries such as this operation, the load is all or nothing for
that got successfully processed. each given header key value. Workday processes
all the entries for a given header key in 1 batch.
Therefore you must resolve all errors before the
entries get loaded.

The EIB is adding duplicate entries for an employee If you’re updating an employee, ensure that the
or external recipient instead of updating the existing employee ID gets specified in the input file (Column
entries. D). If you’re updating an external recipient, ensure
that the External 1095-C Recipient ID gets specified
in the input file (Column E). If these fields are
empty, the web service assumes it’s a new entry.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 130

Issue Cause and Solution

When importing corrections, the EIB issues You can't use the EIB to import 1095-C data if
the error This 1095-C cannot be added or any of the transmissions aren’t in Accepted or
updated because the Integration Event is in Accepted with Error status. Check the status:
Processing. Please wait until all transmissions
• Check the status of the transmission using the
for the Integration Event are either Accepted or
ACA Transmission Status Report.
Accepted with Errors.
• If you think that the transmission has the
incorrect status, launch the integration again
in Check Status mode. This action returns the
status of the transmission from the IRS. It might
take 2-3 days for the IRS to process your data
during busy times, so check the status every
few hours. See: Concept: Affordable Care Act
(ACA) Connectors

When importing corrections, the EIB If this error occurs, we recommend you:
issues an error similar to ERROR:
1. Remove the Covered Individual Reference
com.workday.index.DuplicateIndexException:
values in the EIB input file.
Duplicate insert on index: ACA Report Form Box
(Dependent Month Based)-ID-Covered Individual 2. Unmask all SSNs in the EIB input file for the
Box ID (95$3951), value: CoveredIndividual-…. covered individuals.
3. Rerun the EIB.

After importing corrections, you can't locate them This issue occurs if you run the Create
in Workday. 1095C/1094C Data(Corrections) task after
uploading EIB corrections. The task will revert the
changes created through EIB.

EIB issues these errors: Check the header and line keys in the EIB input
file. Some rows might not have line key or header
• Could not retrieve a file with the label: EIB
key values. Alternately, you’re specifying header
Transformation
key values in worksheet2 that are invalid in
• Empty message received on step id worksheet1(or the other way around).
CopyInputFile.

There’s no option to launch the EIB. If you run the report View Security for Securable
Item and search for securable item import 1095-
c, it will display you that you need Put access
to domain security policy Process: ACA Tax
Filing 1094-C/1095-C (Run)-USA) to use the web
service.
To resolve the issue, add the appropriate security
groups to the above domain with Put access. Then
activate the change.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries.
• If you have inadvertently uploaded incorrect entries, rerun the EIB using an input file with same workers
and corrected data.
• To delete ACA data, use task Delete ACA 1095-C/1094-C Data. If you do so, it will delete all data.
You’ll need to start all over using the Create 1094-C/1095-C data and then use the EIB again to import
any updates.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 131

For reference documentation for all web services including Import 1095-C Form Recipients Data, see
Operation Directory.

Sample EIB Input Files


Import_1095-C_Form_Recipients_Data-WD35-Example1-One-Company
Import_1095-C_Form_Recipients_Data-WD35-Example2-Multiple-Companies

Concept: Put Benefit Individual Rate EIB

Background
You can use this EIB to update benefit individual rates for employees. These rates are calculated outside
of Workday.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB
This EIB doesn't create benefit events. Before you use this EIB, ensure that there’s a benefit event in
Workday for each employee.

Equivalent Workday Task


The Manage Individual Rates task is the equivalent task.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Manage: Benefits
for Organizations domain in the Benefits
functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique
value for each Benefit
Individual Rate.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 132

Field Considerations
Benefit Individual Leave blank.
Rate
Benefit Individual Use a custom report to
Rate ID identify the value.
• If you need to change the rate for existing
coverage, we recommend that you first create
a new benefit event for when the new rate
becomes effective. Then use this EIB to update
the rate associated with the new event.
• Although this web service provides the ability to
generate with data, this feature isn’t particularly
helpful for this EIB. There’s no employee ID
field populated in the EIB input file, making it
difficult to identify the employee associated with
each entry. Instead, there's a Benefit Individual
Rate ID in the EIB input file, which links to
the employee’s ID and rate. For this reason,
it's better to use a custom report to help you
populate the EIB input file, as it will display
the Benefit Individual Rate ID in EIB input file
with the employee that it belongs to. If you still
choose to generate with data:
1. From related actions of your EIB, select
Template Model > View.
2. Select Edit Template with Data Options.
3. Set the filter to Condition Rule Filter.
4. Add a rule condition that picks up all entries.
Example: Always True (Workday Delivered)
isn't blank.
5. Regenerate the template.
6. Use a custom report to identify the
employees associated with each entry in the
EIB input file. You can use the Excel vlookup
tool to link the Benefit Individual Rate ID with
the employee.

Common Issues and Errors

Issue Cause and Solution

There’s no column to populate Employee ID in the This EIB doesn’t use employee ID. Instead,
EIB input file. populate Benefit Individual Rate ID, which is linked
to the employee.

EIB issues an error like this: The reference ID value in the Benefit Individual
Rate ID field is invalid.
Validation error occurred. This web service
can only be used to update existing Verify the Benefit Individual Rate ID you populated
Individual Rates. Please make sure the in the EIB input file is correct.
Benefit Individual Rate ID is a valid one.
ADDITIONAL_BENEFITS_INDIVIDUAL_RATE-1-12345.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 133

Issue Cause and Solution

Unable to launch the EIB This issue is most likely security-related.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to update individual rates. You can’t delete entries.
• Since this EIB doesn’t use a business process, there’s no option to rescind or cancel. If you’ve
inadvertently uploaded incorrect entries, rerun the EIB with the correct amounts.
For reference documentation for all web services including Put Benefit Individual Rate, see Operation
Directory.

Sample EIB Input File


Put_Benefit_Individual_Rate-WD37

Concept: Put Health Care Rate EIB

Background
You can use this EIB to add or update health care rates.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB
This EIB loads calculated health care rates only. You can't use it to update rates that require configuration
directly on health care plans. Those rates still require a manual update.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Health Care Rate
• Edit Health Care Rate

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Set Up: Benefits
domain in the Benefits functional area to run this
EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 134

54, which provides a general overview for


populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
Health Care Rate EIB. See: Example: Generate
EIB Spreadsheet Template with Data on page
62.
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each Health Care
Rate. All entries for
a given Health Care
Rate should have the
same spreadsheet key
value.
Health Care Rate Leave blank.
(column C)
Effective Date: Effective date of
health care rate. If
you want to update
existing entries,
populate the same
effective date that the
health care rate is
currently using.
Health Care Rate ID If updating an existing
(column E) health care rate, enter
the reference id value.
The best way to get
this information is
to use the Generate
Spreadsheet with Data
functionality. If you’re
creating a new health
care rate, you can
enter a value, or else
leave it blank and the
EIB will automatically
assign a value.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it appears Check and confirm:


that it didn't load the data.
1. You didn't run the EIB in Validate Only mode.
2. The effective date in the EIB input file is
accurate.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 135

Issue Cause and Solution

EIB issues an error like this: If loading rates for an existing Benefit Rate, it’s
considered an update. You'll need to populate the
Benefit Rate Name already in use existing Health Care Rate ID in the EIB input file
(column E).

Unable to launch the EIB This issue is most likely security-related. When
running the report View Security for Securable
Item for securable item Put Health Care Rate (Web
Service), you’ll see that you need Put access to
domain security policy Set Up: Benefits. To change
the security, complete these steps:
1. Edit domain security policy for Set Up: Benefits
2. Confirm you have Put access to the domain.
Ideally you should have access through an
unconstrained security group.
3. Activate the security change

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new health care rates or update existing health care rates. You
can’t delete the health care rates nor can you delete the rate bands.
• Since this EIB doesn’t use a business process, there's no option to rescind or cancel. If you have
inadvertently uploaded incorrect entries, there are options to correct the information:
• Rerun the EIB and update with the corrected healthcare rate information (you might need to use the
Generate Spreadsheet with Data option to populate the spreadsheet with the existing data). When
you update the data, use the same effective date you used when you previously loaded the data to
ensure that the incorrect data gets replaced.
If you can't find a way to easily correct the loaded health care rate, another option is to start fresh by:
1. Manually edit the health care rate and rename it to indicate that you shouldn’t use it anymore.
Example: You could add DNU to the beginning of the name.
2. Use the EIB to create a brand new health care rate with the correct information.
3. Edit the benefit plan that uses the health care rate and change it to use the newly created health
care rate.
For reference documentation for all web services including Put Health Care Rate, see Operation Directory.

Sample EIB Input File


Put_Health_Care_Rate-WD35

Cash Management EIBs


Concept: Submit Payment Election Enrollment EIB

Background
You can use this EIB to replace a worker’s current payment elections with new elections.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 136

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Maintain Payment Elections for Worker.
• On the related actions menu of the worker profile, select Pay > Payment Elections.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to these domains to run
this EIB:
• Manage: Payment Election domain in the
Express functional area.
• Worker Data: Payroll (Payment Elections)
domain in the Core Payroll functional area.
• Worder Data: Payroll Interface (Payment
Elections) domain in the Payroll Interface
functional area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Important notes regarding this web service:
• When you load payment elections for a given
worker, the EIB is expecting the input file to
include ALL elections for the worker. That is,
existing elections and any new or updated
elections for the worker. If you don’t include
existing elections, the web service assumes
that you want them removed.
• It’s normally not possible to retain in-progress
and unused bank accounts for a worker when
using this EIB.
• Due to the above behavior of this web
service, we suggest you thoroughly test
in Sandbox before loading the EIB in your
Production tenant
• You can distribute payments to multiple
accounts by creating multiple rows for a
single payment election rule. The distribution
amount for the payment election rule must

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 137

add up to 100 or one of the last accounts


must be marked as distribution balance.
Example: To distribute half of a worker’s
regular payments to 1 account and split
the remainder evenly between 2 others,
add rows to the template with Payment
Election Rule set to Regular Payments to
the appropriate account numbers, with a
Distribution Percentage of 0.50 on the first,
0.25 on the second, and Y for Distribution
Balance on the third.
• You can use the Integration IDs report to
help identify reference id values needed to
populate the EIB input file. Example: You
can search these business objects, from the
Integration IDs report, to get a list of values
and reference ids:
• Bank Account Type
• Payment Type
• Payment Election Rule
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each worker.
Row# The row number can
be tricky to populate,
especially if the worker
has multiple pay types
and is using split
distributions. You
might find it helpful to
review the attached
sample input file to
determine how to
populate the row
numbers.
Retain Unused This field can be a
Worker Bank bit misleading as it
Accounts implies that you're
able to keep the
worker’s unused bank
accounts. However,
make note of the full
description for this
field. While True, the
request won’t remove
any existing and
unused Worker Bank
Accounts in the most
recently Completed
Enrollment (not

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 138

Field Considerations
including In-Progress
Enrollments). If you're
using the Worker
Bank Account but
don't reference it in
the incoming request,
then the EIB removes
the Worker Bank
Account regardless
of this attribute. While
False, the request will
remove all Worker
Bank Accounts
not assigned to a
Payment Election.
Auto Complete This flag controls
whether the business
process skips
approvals, reviews,
to do steps and
notifications. Set to Y
to skip.
Role ID Specify the Employee
or Contingent worker.
Note that if you're
adding payment
elections for both
employees and
contingent workers,
you might find it
helpful to split the
columns using the
Separate Type
Column option
as described in
Customize EIB
Spreadsheet
Template. By doing
this, you can list
both employees and
contingent workers in
the same input file.
• Refer to the attached sample input file for
examples, as this file will help in determining
how you need to populate other fields within the
input file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 139

Common Issues and Errors

Issue Cause and Solution

The EIB is unexpectedly removing the worker’s This EIB is expecting you to include all elections
previous payment elections. (new and existing) in the input file. If you don't
include existing elections, the EIB assumes you
want them removed. If you inadvertently remove
the worker’s payment elections, mass rescind the
business process events. Then correct the input file
and reload.

The EIB is unexpectedly removing bank accounts As noted in the Additional Input File Guidelines
that aren’t part of the current payment elections. section, it's normally not possible to retain in-
progress or unused bank accounts when using this
EIB. If you inadvertently removed this information,
mass rescind the business process events. Then
correct the input file and reload

The EIB issues error: There’s 1 of 2 possible issues that could trigger this
error:
You must have the balance option selected for
the last election or the percentage must add up to 1. The EIB input file specified percentages don’t
100%. add up to 100%.
2. Or the EIB input file specified amounts but didn't
select balance for the last entry for the worker.
Check the last 3 columns in the input file to make
certain the EIB properly populate Distribution
Amount, Distribution Percentage, and Distribution
Balance.

Business Processes
Payment Election Enrollment Event.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables only replace all payment elections capability for each worker, therefore, you can't
selectively delete or modify specific payment elections for a worker. The only option is to reload all the
worker’s payment elections each time you need to make a payment election modification for a worker.
If you've inadvertently uploaded incorrect entries, an option would be to use task Mass Rescind Business
Processes (or Mass Cancel if the events are still in progress), to remove the entries. There’s currently no
Business Processes Loaded by EIB option available when using the mass cancel or mass rescind tasks for
this web service. Instead, you can:
• Make certain you have the necessary permission to cancel or rescind. If you're not certain, check the
business process security policy for business process Payment Election Enrollment Event to make
certain that rescind and cancel sections specify the appropriate security groups.
• Enter the task that you need to use. That is, Mass Rescind Business Processes or Mass Cancel
Business Processes
• Go to the business process types prompt and enter Payment Election Enrollment Event.
• Then select the date range used for the EIB to find the events that you need to cancel or rescind.
For reference documentation for all web services including Submit Payment Election Enrollment, see
Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 140

Sample EIB Input File


Submit_Payment_Election_Enrollment-WD31

Compensation EIBs
Concept: Import Eligible Earnings Override EIB

Background
You can use this EIB to add or update eligible earnings override information for an employee.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB
If you have an in-progress bonus process with configured participation rules, then that process will interact
with the eligible earnings in this EIB.

Equivalent Workday Task


The Create Eligible Earnings Override task is the equivalent task.

EIB Input File Guidelines


Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check the
Version field to verify you’re using the latest
web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Set Up:
Compensation Management domain in the
Advanced Compensational functional area to run
this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields on the Import
Eligible Earnings Override worksheet in the
input file, consider:
• There should be just 1 entry in this
worksheet.

Field Considerations
Spreadsheet Key
Eligible Earnings To find the reference
Override Period id for the Eligible

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 141

Field Considerations
Earnings Override
Period:
1. Run the View
Eligible
Earnings
Override Period
report.
2. From the related
actions of the
period you wish
to use, select
Integration IDs >
View IDs.

Eligible Earnings Leave this field


blank.
Eligible Earnings ID This field is optional,
even if updating
an existing entry.
The web service
always checks for
existing entries
that have the same
employee, position,
or period value as
the incoming entry in
the EIB input file. If it
finds a match, it will
update it. Otherwise
it will add an entry.
When working with
this field, consider:
• If you’re creating
a new earnings
override, you can
enter a value
here if you wish
to assign the ID.
However, you can
also leave the
field blank and
the web service
will assign a
value.
• If you’re
updating an
existing earnings
override, you
can specify the
reference ID
value here or
leave it blank
(since the web

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 142

Field Considerations
service always
tries to find
existing entries).

Employee You might want to


change the value
in cell F4 from
Contingent_Worker_ID
to Employee_ID.
Position Only required if
the employee has
multiple positions.
Apply to All Bonus Enter Y or N
Plans depending on
whether it applies to
all bonus plans.
Restrict to Bonus To restrict this
Plans entry to bonus plans,
enter them here
(enter each bonus
plan on a separate
line). If you enter a
value in this field,
then the Apply to
All Bonus Plans
field must be value
N.
Amount Enter the amount.
Currency Enter the Currency
code. To find the
value, you can run
the Integration IDs
report and search
for the Currency
business object.

Common Issues and Errors

Issue Cause and Solution

EIB completes successfully but no data loads, or You can:


just the first entry in the EIB input file loads.
1. Make certain there’s a different line key value
populated for each unique employee and
position combination. If you use the same line
key value for all the entries, then only the first
entry in the EIB input file will get processed.
2. You can run the Eligible Earnings Override
report to verify that the values display correctly
in this report. This action will verify that EIB
loads the data is properly.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 143

Issue Cause and Solution


3. If the amounts only reflect incorrectly in the
bonus process:
• Verify that the compensation grid includes
the Eligible Earnings field.
• Make certain that the bonus plan specified
in the EIB input file is using eligible earnings
override as a compensation basis.
• Verify that the correct eligible earnings period
displays.
4. If the issue persists after checking steps 1 to 3,
test manually by entering the eligible earnings
override for one of the employees. This test will
help determine whether the issue is specific to
the web service.

The EIB completes with errors for just some of This issue occurs for this Import web service since
the eligible earnings overrides loaded. However, a background process loads the data. Make certain
you find that none of the entries loaded, even all errors get addressed before you load all the
the eligible earnings overrides where no errors eligible earnings overrides.
appeared.

EIB fails with error: You can:


The Eligible Earnings Override Period is currently in 1. Make certain that no one else is updating
use by another Import Web Service. Please wait for the eligible earning overrides, through User
that one to finish before starting another. Interface or another integration, while you’re
running the EIB.
2. If the issue persists after checking steps 1 and
2, open a case with Workday Support.

The EIB fails with these 3 errors: Make certain you aren’t performing an override on
your own employee ID. If you are, have someone
• Position submitted is not filled as of the effective
else enter the override value for you, or configure
date.
the EIB to have an Integration System User (ISU)
• The entered information does not meet run it.
the restrictions defined for this field.
(Employee_Reference).
• The job is not valid for the employee.

The EIB fails with these 2 errors: Make certain you have unconstrained access to
the domain security policy that secures web service
• Position submitted is not filled as of the effective
(Set Up: Compensation Management).
date.
• The job is not valid for the employee.

The EIB fails with these 3 errors: These issues can occur if the worker has more
than 1 position, but you don’t populate the position
• Position submitted is not filled as of the effective
value. Check the employee and if there are multiple
date.
positions, populate the appropriate position in
• The employee you have selected has more than column G.
one job. You must supply the job to which this
operation applies.
• The job is not valid for the employee

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 144

Issue Cause and Solution

The EIB fails with error: If you specify an Eligible Earnings ID in the EIB
input file, it must be unique for each worker.
Duplicates exist for Eligible Earnings ID. Eligible
Otherwise you’ll receive this error. Verify there’s a
Earnings IDs should be unique.
unique value for each worker in column E (if worker
has multiple positions, you need a unique eligible
earnings ID for each worker/position combination).

Unable to launch the EIB When running report View Security for Securable
Items, you’ll see that you need Put access to
domain security policy Set Up: Compensation
Management to run this EIB. Add the access and
activate the change. Then retest.

The EIB fails with these 2 errors: This issue occurs if the Line Key values are missing
in your EIB input file. To resolve the issue, check
• Could not retrieve a file with the label: EIB
the Line Key values in column C of the Eligible
Transformation
Earnings worksheet and make certain there’s a
• Empty message received on step id value populated for each entry.
CopyInputFile.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to create or update eligible earnings overrides. You can’t remove eligible
earnings overrides.
• There’s no rescind or cancel option since this web service doesn’t use a business process.
• If you've inadvertently uploaded incorrect entries, update the entries to specify the correct information.
For reference documentation for all web services including Import Eligible Earnings Override, see
Operation Directory.

Sample EIB Input File


Import_Eligible_Earnings_Override-WD33

Concept: Put Compensation Eligibility Rule EIB

Background
You can use this EIB to create or update a compensation eligibility rule.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Compensation Eligibility Rule
• Edit Compensation Eligibility Rule

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 145

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Set Up:
Compensation domain in the Core
Compensation functional area to run this EIB.

Guidelines for Modifying the EIB Template Modify the template to specify multiple types of
fields in the EIB input file.
1. From the related actions of your EIB, select
Template Model > View.
2. On the left window pane, click Condition Item
Data+.
3. On the right window pane, locate Source
External Field.
4. From related actions of the magnifying glass
next to Source External Field select Template
Model Column Edit Details.
5. Select the Reference ID Type as Separate
Column check box.
6. Click OK.
7. Regenerate the template with data.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
External Disability Self Identification Record EIB.
See: Example: Generate EIB Spreadsheet
Template with Data on page 62.

Common Issues and Errors

Issue Cause and Solution

EIB issues this error: This issue will occur if the EIB file doesn't populate
the field Source External Field. The default
Validation error occurred. The entered information
reference id for this field is Calculated_Field_ID.
does not meet the restrictions defined for this field.
However, the condition rule might be using a
(Relational_Operator_Reference).
different reference ID. And if that happens, then
the Generate Spreadsheet with Data option

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 146

Issue Cause and Solution


doesn't know how to populate Source External
Field, leading to the error.
To address this issue, see section Guidelines for
Modifying the EIB Template to use the Separate
Column option.

When I generate the spreadsheet with data, it’s See the tips in the Guidelines for Modifying the EIB
missing some information. Template section about using the Separate Column
option.

Unable to launch the EIB This issue is most likely security-related. When
running report View Security for Securable Item
for securable item Put Compensation Eligibility Rule
(Web Service), you need Put access to the Set Up:
Compensation domain security policy. To change
the security, you can:
1. Edit the domain security policy for Set Up:
Compensation.
2. Make sure you are in a security group that
has Put access. Ideally, you should be in an
unconstrained security group so that you can
move any candidate using the web service.
3. Activate the security change.

The EIB fails with one of these errors: This issue will occur if the eligibility rule is for an
inactive compensation plan or compensation grade.
• Validation error occurred. The
Proceed as follows:
entered information does not meet
the restrictions defined for this field. 1. Display the eligibility rule.
(Compensation_Plan_Reference). 2. Go to the Rule Usage tab.
• The entered information does not meet 3. This tab will allow you to check where the rule is
the restrictions defined for this field used, so that you can identify any inactive plans
(Compensation_Grade_Reference) or grades. You might want to delete the inactive
plans/grades or remove the eligibility rule from
the plans/grades.

The EIB fails with errors indicating that certain fields This issue will occur if you’re loading rules that
can’t be used in a Compensation Eligibility Rule. aren’t compensation eligibility rules. You can
Examples: check if a rule is for compensation by running the
Compensation Eligibility Report.
• Validation error occurred. The field(s) Expense
Items on Expense Report cannot be used in a If you’re using the Generate Spreadsheet with
Compensation Eligibility Rule. Data option, make sure you’re adding a condition
• Validation error occurred. The field(s) Country to the filter to check Used As = Compensation
cannot be used in a Compensation Eligibility Eligibility Rule.
Rule.
• Validation error occurred. The field(s) Status
cannot be used in a Compensation Eligibility
Rule.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, and delete entries.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 147

• If you have inadvertently uploaded incorrect entries, we suggest you reload the entries with correct
information.
• If you need to delete the entries, try one of these options:
• Delete using the EIB by setting the Delete flag to Y in the EIB input file (this might not work as the
EIB might perceive the rule as in use).
• If above doesn’t work, you could update the compensation eligibility rules and append zzDNU to the
beginning of the description so the rules display in the bottom of list.
• Or you could manually delete the compensation eligibility rules.
For reference documentation for all web services including Put Compensation Eligibility Rule, see
Operation Directory.

Sample EIB Input File


Put_Compensation_Eligibility_Rule-WD34_0

Concept: Put Compensation Grade EIB

Background
You can use this EIB to add or update compensation grades including compensation grade profiles, pay
ranges, and compensation step information.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Add Compensation Grade Profile
• Create Compensation Grade
• Edit Compensation Grade
• Edit Compensation Grade Profile
• Maintain Compensation Steps

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Set Up:
Compensation Packages domain in the Core
Compensation functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 148

54, which provides a general overview for


populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
Compensation Grade EIB. See: Example:
Generate EIB Spreadsheet Template with Data
on page 62.
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each compensation
grade.
Compensation Grade If updating an existing
ID (column E) compensation grade,
populate this field
with the reference id
of the compensation
grade. If adding a new
compensation grade,
you can leave this field
blank and the web
service will autoassign
the id. Or if you prefer,
you can enter a value
(if creating a new
compensation grade,
make certain you
assign a value that
isn’t already in use).
Delete There are multiple
delete fields in the
EIB input file, as you
can delete different
components of the
compensation grade
such as profiles, pay
ranges and steps.
But note that you
can delete these
components only if
they aren’t in use.
Also, you can't delete
the compensation
grade through the web
service. However, if
you've never used the
grade, you do have
the option of manually
deleting it.
Inactive There are 2 inactive
fields in the EIB
input file since you

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 149

Field Considerations
can inactivate the
compensation grade
or the compensation
profile.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it appears There are a few different reasons that this issue
that the data wasn't loaded. might occur. Check to make sure:
1. You populated the spreadsheet key value in the
EIB input file
2. If you specified an effective date, make certain
that there's not already another change for the
compensation grade with a newer effective date:
if so, that change will take precedence since it’s
more recent.
3. You're not running the EIB in validate-only mode

Unable to launch the EIB. This issue is most likely security-related. When
running report View Security for Securable Item
for securable item Put Compensation Grade (Web
Service), you'll see that you need access to domain
Set Up: Compensation Packages. To change the
security:
1. Edit the domain security policy for Set Up:
Compensation Packages.
2. Make certain you're in a security group that has
Put access (ideally you should have access
through an unconstrained security group).
3. Activate the security change.

I can't find a way to delete the compensation grade You can't delete compensation grades with this
using the EIB. EIB, but you can inactivate them. See Use Cases
and Guidelines for Recovering from a Bad Load
section.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new compensation grades or update existing compensation
grades.
• You can't delete compensation grades. However, you can inactivate them. Also, you can delete and
inactivate some components of the compensation grade such as profiles, pay ranges and steps.
• This EIB doesn't use a business process, therefore there’s no option to rescind or cancel. If you
inadvertently uploaded incorrect compensation grades that you want to delete, there are 2 options:
• Update the compensation grades and set them to Inactive. You can also update the compensation
name and add zDNU to the beginning of the name.
• Or, manually delete the compensation grades.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 150

For reference documentation for all web services including Put Compensation Grade, see Operation
Directory.

Sample EIB Input File


Put_Compensation_Grade-WD34_0

Concept: Put EEO Data Record EIB

Background
You can use this EIB to upload W-2 Box 1 and EEO hours worked data for the Equal Employment
Opportunity Commission (EEOC), helping you to meet U.S. regulatory reporting requirements.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Reports:EEO
Compliance domain in the Regulatory Reporting
(HCM) functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• There are 3 sections below that cover creating,
updating, and deleting entries. Note that if
updating or deleting entries, you might find it
helpful to create a custom report to help you
populate the EIB input file. Refer to the Sample
EIB Input File section for an example.
• Creating New Entries: Spreadsheet Key,
Employee ID, Calendar Year, Company, and
at least W-2 Box 1 or EEO Hours Worked are
required fields if your goal is to create new

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 151

external EEO data records. As you populate


these fields in the input file, consider:

Field Considerations
Spreadsheet Key Use a unique value
for each EEO data
record.
External EEO-1 Data Leave blank.
Reference Record Use a unique value
for each EEO data
record. You can leave
this field blank if you
would like Workday to
automatically generate
the key. However,
we recommend you
populate the value as
it will make it easier
to apply subsequent
updates, if needed.
Employee ID Enter the Employee
ID.
Calendar Year Enter 2017 or later.
Company Enter
Company_Reference_ID,
Organization_Reference_ID,
or WID.
W-2 Box 1 Enter an employee’s
W-2 Box 1
information.
Workday Payroll
customers don’t
need to enter this
information.
EE Hours Worked Enter in either the
actual hours worked or
proxy hours worked.
• Updating Existing Entries: If your goal is to
update an existing external EEO data record,
then Employee ID, Calendar Year, External
EEO-1 Data, and Company are required fields

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 152

along with the updated fields. Details are as


follows:
Note: To clear out any unwanted fields, enter
zero. As you populate these fields in the input
file, consider:

Field Considerations
Spreadsheet Key Use a unique value
for each EEO data
record.
External EEO-1 Data Enter the reference
record value that
you used when you
added the entry. If
you don’t know the
value, you can run the
Integration IDs report
and search business
object External EEO-1
Data for a list of all the
existing EEO-1 entries
and their reference
IDs.
Employee ID Enter Employee ID.
Calendar Year Enter 2017 or later.
Company Enter
Company_Reference_ID,
Organization_Reference_ID,
or WID.
W-2 Box 1 Enter new value or
enter zero to clear out
a previous value.
EE Hours Worked Enter new value or
enter zero to clear out
a previous value.
• Deleting Existing Entries: If your goal is to
delete an existing external EEO data record,
then Spreadsheet Key, Delete Flag, External
EEO-1 Data and Delete are required fields.
As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Use a unique value
for each EEO data
record.
External EEO-1 Data Enter the reference
record value that
you used when you
added the entry. If

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 153

Field Considerations
you don’t know the
value, you can run the
Integration IDs report
and search business
object External EEO-1
Data. This search will
provide a list of all the
existing EEO-1 entries
and their reference
IDs.
Delete Enter Y.

Common Issues and Errors

Issue Cause and Solution

Unable to launch the EIB You can:


• Edit Domain Security Policy Permissions for
Report: EEO Compliance.
• Add the appropriate security groups to the
Integration Permissions.
• Activate the change.

Receive this error when attempting to generate the Don't check the Generate Spreadsheet with Data
template: option. Note that if you check this check box, then
you need to provide a filter specifying the existing
View your template model and configure a filter
data that you want populated in the EIB template.
using the Edit Template with Data Options button.

The EIB completes successfully. However, you This issue will occur if you don't have W-2 Box 1
don't see EEO Hours Worked in reports. data since Workday categorizes Hours Worked by
pay bands. For non-Workday Payroll customers to
correct the problem, you must upload W-2 Box 1
data for all employees missing from reports.

The EIB completes successfully. However, you This issue will occur if you’re a Workday Payroll
don't see W-2 Box 1 data that the EIB uploaded. customer. Workday will automatically retrieve W-2
Box 1 data from the employee’s profile. If no data
exists in the employee’s profile, then the Workday
uses the external W-2 Box 1 data.

EIB issues this error: There’s already an EEO entry for the employee that
you’re loading. If updating an existing entry, make
Validation error occurred. This employee already
certain you’re supplying the correct External EEO-1
has an EEO1 Record for that Company and
Data value that the EIB assigned when the entry
Calendar Year.
initially loaded.
You can try to find the entry by running the
Integration IDs report and search business object
External EEO-1 Data. This search will provide a list
of all the existing EEO-1 entries and their reference
IDs.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 154

Workday Reports Used to Report Information Loaded by This EIB


1. EEO-1 Component 2 Employee Data
2. EEO-1 Component 2 Employee Data by Establishment or Location
Note: You need access to domain security policy Reports: EEO Compliance to access these reports.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, or delete entries.
• Note that this web service doesn’t use a business process. If you inadvertently uploaded incorrect
entries, rescind isn’t an option. However, you have 2 options:
• Use the Delete option in the EIB input.
• Refer to the attached EIB input file for an example of how to remove an entry.
• Update the existing entry and populate the correct values.
• Refer to the attached EIB input file for an example of how to update an existing entry.
For reference documentation for all web services including Put EEO Data Record, see Operation Directory.

Sample EIB Input File


Put_EEO_Data_Record-WD33

Concept: Request Compensation Change EIB

Background
You can use this EIB to request a compensation change for an employee using the Request
Compensation Change business process.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Request Compensation Change
• From the related actions menu of the worker profile, select Compensation > Request
Compensation Change.
You can also perform mass compensation changes through:
• Remove Compensation Plans from Employees.
• Rollout Compensation Plans to Employees.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 155

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Request
Compensation Change business process in the
Core Compensation functional area to run this
EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields in the input file,
consider:

Field Considerations
Spreadsheet Key Specify a unique value
for each employee.
Reason Most likely, you’ll
want to change
the reference
id, in cell H4,
fromBenefits_Event_Subcategory_ID
to
General_Event_Subcategory_ID.
To get a list of
reasons and their
reference code values,
navigate to View
Reference IDs >
Business Object:
General Event
Subcategory and
then find the Request
Compensation
Change reason you
need.

• If you need to remove compensation plans,


there are sections at the end of the input file
that enable you to remove plan data. See
the examples in the attached EIB input file. If
you plan on replacing existing compensation
plans with other plans, then the other option

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 156

you can take is to use the Replace All option.


Example: If you want to replace a couple of
the employee’s allowance plans with another
allowance plan, then check the Replace All
option in the Allowance Plan section of the
input file and populate information for the new
allowance plan.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but you don’t see Most likely the business process events are still
the compensation changes you loaded. in progress as one of the steps didn’t complete.
You can:
1. Make certain you’re specifying Automatic
Processing in the Overview tab of the EIB input
file.
2. Check the business process definition. If there
are action steps that the EIB should skip, add a
condition rule External Load=N.

The EIB issues an error such as: Check the reference id that you're using for
Reason. In cell H4, change the value from
Validation error occurred. Invalid ID value.
Benefits_Event_Subcategory_ID to
"Request_Compensation_Change_Adjustment_Ad-
General_Event_Subcategory_ID.
hoc' isn’t a valid ID value for type =
'Benefits_Event_Subcategory_ID'.

The EIB issues this error: This error occurs if you populate the EIB input
file with both a Compensation Change Date and
Validation error occurred. Multiple Element
you enter Y for field Compensation Change On
Contents, including Request Compensation
Next Pay Period*: if you specify a Compensation
Change Data/d1/Event Effective Date [DT(day)
Change Date, then you need to enter N for
[LD]], contain data where only one is allowed by
Compensation Change On Next Pay Period*.
mutex Request Compensation Change Data.

The EIB issues an error such as: This error will occur if you’re providing too much
information for the plan. Note that some of the
Validation error occurred. Multiple Element
plans enable you to populate either an amount, a
Contents, including Proposed Base Pay Plan
percent change, or an amount change. Be sure
Assignment Data/b2/Percent Change [NM], contain
you’re populating only one of these fields.
data where only one is allowed by mutex Proposed
Base Pay Plan Assignment Data.

The EIB issues an error like this: This error occurs when you configure the allowance
plan for no override. Therefore the input file isn’t
Plan ABC doesn’t allow for individual overrides.
expecting any parameters to be passed. Below are
the options to resolve this issue:
• Option 1: If it’s acceptable to use the value
assigned to the allowance plan, then just
remove the value from the input file.
• Option 2: If you need to override the value, 1
option would be to use Set Up Allowance Plan
Adjustment.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 157

Issue Cause and Solution


• Option 3: If you need to override the value,
another option is to remove the allowance plan,
then add a new one with correct values.

The EIB issues this error: This error will occur if changing to a compensation
grade/profile that doesn’t use steps. If there
Validation error occurred. Compensation step isn’t
shouldn’t be a step, then set the step value to
valid for the compensation grade profile.
{empty}.

EIB performs slowly. This issue can occur when you have in progress
merit events. The web service then needs to
examine each of the participation rules within
the event and runs all the eligibility rules. It also
needs to process the participation options if the
eligibility rule evaluates to true. To determine
if you have in progress merit requests, run the
Compensation Review Process Status report. At
the Compensation Review Process prompt, check
for any reviews with In Progress status.
Also, if loading more than 1,000 compensation
requests, you might want to consider using Import
Request Compensation Change. It's designed for
importing high volumes of compensation changes.

Business Processes
Request Compensation Change.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, delete, and replace entries.
• If you've inadvertently uploaded incorrect entries, use task Mass Cancel Business Processes or
Mass Rescind Business Processes (depending on whether the business process event is completed
or in progress). You can then select Business Processes Loaded by EIB to find the integration event
that you wish to cancel or rescind. Or the other option is to enter Request Compensation Change at the
Business Process Types prompt, and enter a date range that you ran the EIB.
For reference documentation for all web services including Request Compensation Change, see Operation
Directory.

Sample EIB Input File


Request_Compensation_Change-WD32

Concept: Request One-Time Payment EIB

Background
You can use this EIB to request a one-time payment for an employee.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


The Request One-Time Payment task is the equivalent task.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 158

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Request One-
Time Payment business process in the Core
Compensation functional area to run this EIB.

Modifying the EIB Template to Add Additional • If you need to populate multiple worktags for the
Worktag Fields one-time payments, you'll want to add additional
worktag fields to your spreadsheet for each
worktag you use.
• To add worktags:
1. From the related actions of the EIB, select
Template Model > View.
2. In the left pane, click One Time Payment
Sub Data+ .
3. Click the magnifying glass for One Time
Payment Worktags+ row.
4. From the related actions of the One Time
Payment Worktags row, select Template
Model Column > Maintain Additional
Columns.
5. Add a row for each possible worktag type
that you might be specifying in your EIB input
file. Note that you don't have to populate
worktag values for all the worktags you
specify. Example: If you currently don’t use
the Fund worktag but think you might use it in
the future, you can add it now to avoid editing
the template later.
6. After you complete the changes, regenerate
the template.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields in the input file,
consider:

Field Considerations
Processing Specify the instruction
Instruction in the Overview tab of

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 159

Field Considerations
the EIB input file. Use
value:
• Automatic
Processing to
skip approval,
review, to do steps
and to bypass
notifications.
• Manual
Processing if you
want the business
process event
to stop at the
approval/review/to-
do steps and send
notifications.

Spreadsheet Key Specify a unique value


for each one-time
payment.
Employee_ID Workday requires an
Employee ID.
Position Required field only
if the employee has
multiple positions.
Effective Date Effective date of the
One-Time Payment.
Workday requires this
field.
Employee Visibility Date the employee
can view the one-
time payment event.
Enable the Employee
Visibility Date in the
HCM tenant settings.
Reason You’ll need to change
the reference id
type (cell G4) from
Benefit_Event_Subcategory_ID
to
General_Event_Subcategory_ID.
To determine the
reference id value,
you can run the View
Reference IDs report
and select business
object General Event
Subcategory. Then
filter Business Object
Instances containing

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 160

Field Considerations
One-Time Payment,
to find the entries
specific to one-time
payments.

Row ID Enter a unique row id


value for each bonus
plan for a given one-
time payment request.
One Time Payment For a list of the
Plan reference id values,
run the View
Reference IDs report
and select business
object One-Time
Payment Plan.
Scheduled Payment Date the employee
Date will receive the
one-time payment.
Workday defaults
the effective date if
you don't provide a
Scheduled Payment
Date. Enable Multiple
One-Time Payments
on the Edit Tenant
Setup - HCM task to
use this field.
Do Not Pay If set to Y, Workday
Payroll doesn’t
process the payment
(this is equivalent to
the Send to Payroll
field when manually
creating a one-time
payment).
FLSA Workweek Although this field
Calendar displays as a required
field, you shouldn’t
enter any value.
Worktag If you need to
populate multiple
worktags, see
Modifying the EIB
Template to Add
Additional Worktag
Fields section to add
all relevant worktag
columns to the EIB
template. Also, note
that there’s no need
to populate the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 161

Field Considerations
related worktags as
they’ll automatically
populate. If needed,
you can configure
worktag type
precedence. See
Configure Worktag
Defaulting for more
details.

Common Issues and Errors

Issue Cause and Solution

The EIB fails with errors such as: You can:


• Position submitted is not filled as of the effective • Make certain you have security properly
date configured for business process Request One-
• The job is not valid for the employee Time Payments. You need access to initiating
• The entered information does not meet action Request One-Time Payment (Web
the restrictions defined for this field Service). If you have role-based access, you
(Employee_Reference) might want to retest with unconstrained access
• You'll receive this type of error if you’re adding a
one-time payment for yourself. The web service
and user interface don't permit this action.
• If above doesn’t help, you might want to
manually enter the one-time payment for the
employee where you’re receiving the error,
as the user interface might provide a more
descriptive error message, indicating the cause
of problem.

The EIB issues an error such as: Note that decimal precision of the amount must
match the currency. You can find the precision for
The value could not be loaded (decimal precision
each currency running View Country Currency.
set to 2).
Also, note that currency precision is Workday
Delivered, and you can't configure it.

The EIB issues an error like this: Make certain that you're not populating any of the
FLSA Workweek Calendar fields in the EIB input
Validation error occurred. 'Within relationship' is
file. Although these fields display as required, you
empty for index 95$1943
should leave them blank

The EIB issues this error: Only enter a scheduled payment date value
when you’ve enabled Multiple One Time Payment
Error: “Validation Error occurred. Scheduled
(MOTP).
Payment Date must be equal to Event Effective
Date when Multiple One-Time Payment is not…”

The EIB issues an error like this: Edit the EIB input file and change
the reference id type in cell G4, from
Validation error occurred. Invalid ID value. 'One-
Benefit_Event_Subcategory_ID to
Time_Payment_Incentive_Bonus' is not a valid ID
General_Event_Subcategory_ID.
value for type = 'Benefits_Event_Subcategory_ID'

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 162

Issue Cause and Solution

The EIB loads One-Time Payments for plans that The web service doesn't enforce eligibility rules. We
the worker isn’t eligible for. typically use web services as an administrative tool
to mass upload large volumes of date because they
provide more flexibility.

Business Processes
Request One-Time Payment.

Use Cases and Guidelines for Recovering from a Bad Load


• The web service enables you to add only. You can't change, correct, or delete the One-Time Payment
Request through the EIB.
• If you've inadvertently uploaded incorrect entries, the options are:
• Run Mass Rescind Business Processes or Mass Cancel Business Processes, depending on
whether the business process event completed or is in progress. You can then select the Business
Process Loaded by EIB option to find the EIB used for the load. Or the other option is to go to the
Business Process Types prompt and enter Request One-Time-Payment. Then enter the date and
time range that you submitted the EIB.
• The other option would be to manually correct the One-Time Payment Requests from the related
action of each event.
For reference documentation for all web services including Request One-Time Payment, see Operation
Directory.

Sample EIB Input File


Request_One-Time_Payment-WD34

Compensation Review EIBs


Concept: Import Compensation Review Budget Pools EIB

Background
You can use this EIB to update budget pool, holdback, and reserve information for supervisory
organizations.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB
If you want to run this EIB, you must do so after completing the distribute pools step of the compensation
review event - but before the process fully completes. Your compensation administrator should also have
the Launch Award Proposals task in their inbox. You can't create holdbacks before the distribute pools
step.
For more information about compensation review budget pools in Workday, see Setup Considerations:
Compensation Reviews.

Equivalent Workday Task


This EIB is equivalent to updating budget pool information during the distribute pools step of the
compensation review event.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 163

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Process:
Compensation Management Events domain in
the Advanced Compensation functional area to
run this EIB.

Additional Input File Guidelines • As you populate these fields on the first
worksheet of the input file, consider:

Field Considerations
Header Key This cell should have
a value of 1.
Compensation You can specify the
Review Event Workday ID (aka WID)
or the value for the
Compensation_Review_Event_ID.
To get these values,
select Integration
IDs->View IDs from
related actions of the
compensation event.
Include All Select Y to update all
Organizations organizations
in the process.
This selection will
replace all holdbacks
and adjustments
accordingly.

Note: There should be only 1 row in this


worksheet, assuming you're updating pools for
only 1 compensation review event.
• As you populate these fields on the second
worksheet of the input file, consider:

Field Considerations
Header Key This cell should have
a value of 1 for all
entries, assuming
you’re updating
pools for only 1

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 164

Field Considerations
compensation review
event.
Line Key Each organization
should have a unique
line key value.

Note: You can run the report Compensation


Review Budget Pools to help you populate
this worksheet. This EIB worksheet should
contain the same organizations and plans/award
types that you see in the Compensation Review
Budget Pools report.

Common Issues and Errors

Issue Cause and Solution

EIB issues one of these errors: This issue occurs if you have not populated all
organizations and plans/award types in the input
• “Not all organizations are configured in the web
file that are visible in the Compensation Review
service. Please add all organizations prior to
Budget Pools report. If you encounter this error:
proceeding, or use Maintain Pools to adjust
select organizations. Missing.” 1. Run the Compensation Review Budget Pools
• “Not all plans/award types are configured in the report.
web services. Please add all plans/award types 2. Populate the EIB input file with all the
prior to proceeding or use Maintain Pools to organizations and award types included in the
adjust pools.” report. Make certain each organization has a
unique line key value.
Another option to consider, based on your
business requirements, is to set theUpdate All
Organizations field, in worksheet 1 of the input file,
to N.

Error: “An Import Compensation Review Budget Make certain you specify only 1 header key value
Pool web service has not completed for this for each compensation review event. If you’re
Compensation Review Process." importing budget pools for 1 compensation review
process, all entries should be header key value 1
(refer to attached example).

The budget amounts loaded for some Since Workday calculates pools at an employee
organizations aren’t exactly the same as what was level, some rounding can occur.
in the EIB input file. Example: they might be off by a
penny.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to load the budget pool information for the organizations within the event. If
needed, you can reload the pool information if you need to make corrections or adjustments.
If there were mistakes, the recovery process will depend on what you need to undo or correct. Consider
these options:
• Cancel the parent event (exampleInitiate Merit Process).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 165

• Use theCompensation Review Process Maintain Pools task.


.
For reference documentation for all web services including Import Compensation Review Budget Pools,
see Operations Directory.

Sample EIB Input File


Import_Compensation_Review_Budget_Pools-WD31

Concept: Import Employee Awards EIB

Background
You can use this EIB to update employee awards for a specific employee or employees in a compensation
review process.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB

Equivalent Workday Task


The My Task item in which planners and compensation administrators make their award recommendations
on the grid.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Process:
Compensation Management Events domain in
the Advanced Compensation functional area to
run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields on the first tab of
the input file, consider:

Field Considerations
Line Key Employees can have
more than 1 line key
depending on the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 166

Field Considerations
award types you’re
updating.
• Ensure that the spreadsheet contains only 1 row
for each compensation review event.
• When an employee is eligible for multiple
awards of different types in a compensation
review process, you only need to populate the
fields that you want to update.
• To remove an existing award for an employee,
enter zero in the appropriate field. Example: to
change a merit increase % from 3.5% to zero,
enter 0 in the Merit Increase Percent field.
• If you have a bonus plan set up with Multiple
Factors, Workday includes only the discretionary
portion of the award on the Get Employee Award
Data Outbound EIB. In addition, only the Import
Employee Award Inbound EIB can update only
the discretionary portion of the award.
• Minimize the time between pulling current
budget pools and employee awards and
importing new values into the compensation
cycle. Minimizing this time is especially
important when you include parallel processing
rules. To mitigate the risk of planners
submitting conflicting award updates, Workday
recommends that processing take place only
after you submit all organizations.

Common Issues and Errors

Issue Cause and Solution

The employee awards EIB for a bonus process If employees have multiple bonus plans in process,
loaded without error, but the EIB didn't update the specify all bonus plans on the EIB spreadsheet.
data.

Workday returns this error: The compensation review must have a unique
Please confirm the compensation review process is inReference
progress and
ID. Ensure
Launch that
Award
youTask
specify
is Completed.
the correct
compensation review process Reference ID in the
template. To avoid errors with EIB processing,
Workday recommends that you don’t change the
Initiate Compensation Review business process
after launching the event.

Workday returns this error: In the Employee column of the Employee


Invalid ID value. 'XXXXX’' is not a valid ID value for type
Award
= 'Contingent_Worker_ID.
Data tab, change the format from
Contingent_Worker_ID to Empoyee_ID before
running the EIB.

Workday returns this error: Invalid ID value. For employees who have multiple positions, include
'XXXXX' is not a valid ID value for type = both the Employee ID and Position ID on the
'Position_ID.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 167

Issue Cause and Solution


Employee Award Data tab that is associated with
the compensation review process.

Use Cases and Guidelines for Recovering from a Bad Load


The Import Employee Awards web service operation enables you to load the employee award information
for the employees in a compensation review event. You can reload the employee award information if you
need to make corrections or adjustments. When you do, the recovery process depends on what you need
to undo or correct. You can also reenter the award information on the configurable grid or Compensation
Review Process Search Employees report.

Sample EIB Input File


Import_Employee_Awards_v43.0

Custom Objects EIBs


Concept: Non Effective-Dated Custom Object EIBs

Background
You can use this EIB to load Non Effective-Dated Custom Objects. Note that Workday uses REST API for
Custom Objects.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
If you’re using effective-dated custom objects, then use a different EIB, based on the type of effective-
dated object you’re using. Examples:
• If you're using an effective dated worker object, use the Edit Worker Additional Data EIB.
• If you're using an effective dated job requisition object, use the Edit Job Requisition Additional Data EIB.
For instructions on creating a custom object, see Create and Edit Custom Object Definitions.
If you plan to populate the custom object using an EIB, specify a Reference ID on the Activate Custom
Object page (this page is the last page that Workday displays when you create a custom object). If you
don’t supply a Reference ID, you won’t be able to create the EIB if it’s a multi-instance custom object.
If you’re creating a multi-instance custom object, select a Reference ID that makes each entry unique for
a given worker. Example: if the Reference ID that you select for a worker object is a date field, then you
can’t add multiple entries with the same date for the same worker.
The Reference ID value that you select must be of type date, number, or text.
How to create an EIB for a Non-Effective Dated Custom Object.
When creating an EIB for a non-effective-dated object, perform these steps:
1. Use task Create EIB and select Inbound.
2. In the Data Format section, set File Type to Custom Object Spreadsheet Template and select your
custom object. If you’re unable to find your custom object, refer to the Common Issues and Errors
section.

Equivalent Workday Task


From the related actions menu of the worker profile, select Additional Data > Edit.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 168

Common Issues and Errors

Issue Cause and Solution

When creating the EIB, the custom object doesn't 1. Ensure that you have this security access:
display in the list
• Modify access to theIntegration Events domain.
• View access to the Integration: EIBs domain.
2. Verify that the custom object is active by
accessing the View Custom Object task, then
selecting the search option to view active custom
objects.
3. When you display the custom object, set the
Effective Dated field to No. If you don't set this
value, then you need to use a different web service
such as Edit Worker Additional Data,
4. When you display the custom object, the
Reference ID field should have a value (if it’s a
multi-instance object). If you don’t see a Reference
ID, then delete the custom object and rebuild it.
See the Add/Update/Delete Capabilities for this EIB
and how to recover from Bad Load section of this
topic for instructions on how to delete the custom
object. Then refer to the (Requirements for creating
Custom Object used by EIB) section for instructions
on how to rebuild the custom object.
5. If the custom object includes a custom instance
reference such as Worker Reference, you can't use
this EIB.

Unable to run EIB in validate only mode Workday doesn't support Validate mode for custom
objects.

EIB issues an error similar to this message: An issue that will cause this error is specifying an
Validation error occurred in the custom object invalid custom list value in the input file. Also, note
API: "error":"invalid request: errors have that custom list values are case-sensitive. If one
occurred","errors":[{"error": not found:Small"," of the custom list values is small and you specify
location":"Line:1, column: 95"}] Small, then you’ll receive this error.

When you load the data, the EIB fails with an error This issue occurs if there are special characters in
similar to one of these messages: the name of the custom object. Example: a custom
object that is titled Worker’s Shoe Size or Vehicle &
• The transformation expected worksheet 'Vehicle
Make would cause the error due to the apostrophe
&amp; Make for Worker' but encountered
and ampersand in the names. See Create and Edit
worksheet ‘Vehicle and Make for Worker. Check
Custom Object Definitions , which states:
that the spreadsheet template is the correct
version and/or that the transformation deployed Workday recommends that you don't use special
in your environment is the correct version. characters because it might result in an error when
• The transformation expected worksheet generating an EIB template for the custom object.
'Worker&apos;s Shoe Size for Wor' but Examples: forward-slash (/), colon (:), apostrophe
encountered worksheet 'Worker's Shoe Size (').
for Worker'. Check that the spreadsheet Edit the custom object and remove the special
template is the correct version and/or that the character from the name.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 169

Issue Cause and Solution


transformation deployed in your environment is
the correct version.

After generating an EIB template, you receive one This issue occurs if the custom object name
of these errors when you try to open the input file: contains a special character such as a colon or
asterisk. Edit the custom object and remove the
• Problem came up in the following area during
special character from the name.
load: Workbook Setting
• The file is corrupt and cannot be opened

One of these issues occurs: Use View Custom Object to review your custom
object. Check the value for Reference ID. Note that
1. EIB is removing existing entries
this ID is the value that makes each entry unique
2. Or when loading the EIB, the EIB doesn't load for a given worker. Example: if the reference id
all entries, yet Workday returns no errors. is a date field, then you can’t have 2 entries with
the same date for the same worker. If you add
an entry within the EIB input file using a date that
already exists for the worker, the EIB file value
replaces the existing entry. Thus it can seem as if
Workday removed an entry.
Perform these steps:

EIB issues an error similar to this message: • Make certain that you populate all required fields
Validation error occurred in the custom object in the input file. If you're not certain of which
API: internal error","caseId ":"20aaa626- fields the file requires, then manually add the
aec4-4805-8632-c2b11ae0b8c9” custom object using the Workday UI, to check
which fields Workday requires.
• This issue can also occur if you’ve changed
the format of the fields in the EIB input file.
Example: changing a field from Text format to
Percent. Check the format of the fields in input
file and verify that they're correct. Or create
a new EIB template. And when you paste in
values, use Excel’s paste special so that you
don’t paste in any invalid formats
• This issue also occurs if you enter 0 (zero) in a
field whose field type is Integer. To solve this
issue and enter 0 (zero), the field type should be
Decimal not Integer.
• You might also encounter this issue in a decimal
field due to an Excel limitation with storing
decimals when using xml files. To check for this
issue, edit the EIB input file with a text editor
such as Notepad++. You might notice that Excel
is storing some of the numbers with many digits.
Example: 7.49999999999999 instead of 7.5.
Work around this issue with these steps:
• Copy the column of numbers to a separate
Excel file.
• Then use a formula to convert them. Ex:
=text(a1,"0.00").
• Paste Special from Excel to the EIB input file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 170

Business Processes
There’s no business process used when creating or updating non effective-dated custom objects.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries.
• If you've inadvertently uploaded incorrect entries, you could reload the same entries with the correct
values. If they need deleted, refer to the information below.
If you need to remove just some of the custom object entries, consider one of these options:
• Option 1: Use the Delete Custom Object Additional Data task and use a condition rule to indicate
which entries to remove (back up the data before performing this action). See Delete Custom Object
Data.
• Option 2: You could extract the data from the custom object, then remove all data (using task Delete
Custom Object Additional Data), then reload the data you need to keep.
• Option 3: You can also delete data from custom objects using the REST API. However, if you aren’t
familiar with using REST API, this option can be complex. See Reference: DELETE Custom Objects
(Multi-Instance).
• Option 4: You can also manually remove the custom object entries, one at a time, using the Workday
UI.
If you have a need to remove the custom object completely and start over, perform these steps:
1. If the custom object contains data that you wish to save, extract the data so that you can reload
the data into the newly created custom object. You could create a custom report to extract the
data. Example: if using Worker object, create a custom report with data source All Workers and report
the custom object fields.
2. You need to delete the data before removing the custom object. So if the object contains data, use the
Delete Custom Object Additional Data task to remove the data
3. Now use task Delete Custom Object to remove the custom object definition. You won’t be able to
delete the custom object if:
• The custom object contains data.
• A custom report, calculated field, EIB, or other Workday object references the custom object.
4. Now you can create another custom object and reload data if needed.
If for any reason, you can’t completely remove the custom object, you can hide access to the custom
object:
1. Edit the custom object and change the name (Example: add DNU to the beginning of the name).
2. Secure the custom object to a domain that no one has access to. Note: there are 200 custom domains
available in your tenant available to use.

Sample EIB Input File


Apparel

Financial Management EIBs


Concept: Import Accounting Center Detailed Journal EIB

Background
You can use this EIB to create or update accounting center detailed journals (ACDJs), which enable you
to upload manual journals with worktags and additional attributes. Workday summarizes the ACDJs before
Workday posts them to the general ledger.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 171

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The Create Accounting Center Detailed Journal task is the equivalent task.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Accounting Center
Detailed Journal Approval Event and Accounting
Center Detailed Journal Batch Initiation Event
business process types in the Accounting Center
functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate these fields on the
Worksheet#1 for Accounting Center Detailed
Journal Header data in the input file, consider:

Field Considerations
Header Key Use a unique header
key value for each
journal.
Accounting Center Specify the Reference
Detailed Journal ID ID of an existing
Accounting Center
Detailed Journal if
updating an existing
journal. You can
update the journal only
if it isn’t yet Approved
or Canceled.
Autocomplete Set this value to Y
to bypass approval
steps. Recommended
to hide in your
Production tenant.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 172

Field Considerations
Submit Set to N if you want
to create the journal
but not submit it for
Approval (Workday
processes a blank
value in this field as
N).
Accounting Source Required. Enter the
Accounting Source
that the ACDJ is for.
• As you populate these fields on the
Worksheet#2 for Accounting Center Detailed
Journal Line data in the input file, consider:

Field Considerations
Header Key Populate this field for
every row in the EIB
and correspond to a
Header Key provided
in the first tab.
Line Key Use a unique value for
each unique line entry
for a given journal.
The EIB groups
multiple rows with the
same Line Key to form
a single ACDJ line.
Populate this field for
every row in the EIB.
Account Set Ensure this field has a
value. Otherwise you
might get an invalid
Ledger Account ID
error.
Worktags You can specify
worktags by adding
additional columns to
the template model
corresponding to
specific worktag types.
Example: Cost Center.
Alternately, you can
select the Separate
Type Column check
box for the Worktags
column when editing
the Template Model
Area.
Additional Attributes • Unlike Worktags,
(AA) you don’t need

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 173

Field Considerations
to add additional
columns to the
Template Model
for AAs, and
we recommend
you not check
theSeparate Type
Column check
box in the template
model.
• You can find the
External_Analytics_Data_Source_
for the AA found
directly off of the
AA in the Journal
Line Rules of the
Accounting Source.
Alternately, you
can find it in the
View Detailed
Journal Additional
Attributes
Configuration
task. You can
also run the View
Reference ID task
and enterAnalytics
Data Source Field
External as the
Business Object.
• Enter each AA in
2 columns, one
for the name and
another column
for the value.
These columns
automatically
display on the
template so they
don’t need to be
added manually to
the template.

Performance Considerations
These factors might impact EIB performance:

Journal Size We recommend a maximum of 20,000 as-entered


lines per individual journal for optimal performance.
You’ll see performance degradation with journals
above 20,000 lines. If you have journals above this
threshold, we recommend splitting these journals
into multiple journals that have a max of 20K lines

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 174

each. Performance degradation below 20,000 lines


is possible depending on other factors below.

Intercompany Accounting Intercompany detailed journals require Workday to


create additional ACDJs, thus increasing overall
processing time.

Custom Validations Custom validations can slow down performance,


especially if you have a large number of custom
validations or if the validations are complex.

View ACDJ Similar to Accounting Journals, we display up to


1,000 ACDJ lines using the View ACDJ page before
displaying the Summarized Journal Lines grid.
This grid enables you to review more journal lines
without UI performance degradation. You can still
view the detailed lines of a summarized ACDJ by
clicking theDisplay Journal Lines Details button.
Clicking this button affects UI performance at high
line volumes.

Edit ACDJ Trying to edit ACDJs with high line volumes in the
UI negatively impacts performance. We recommend
using the EIB to edit high-volume ACDJs to avoid
performance issues in the UI. Don't use the UI as
the primary method of creating or modifying high-
volume ACDJs.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but you can't find Run the Find Accounting Center Detailed
the journal in the UI. Journal report to search for the journal. The EIB
might have loaded the journal to the wrong period,
loaded with Submit set to No, or have some other
issue causing it to not fully load.

When running the EIB in Validation mode, it doesn’t Validate mode only tests the validations listed in
catch all errors the API Documentation for a given web service
operation. We don’t test custom validations and
validations that occur postprocessing after Workday
persists the lines.

EIB issues this error:A processing fault occurred • Make certain you’ve populated the Line Key
generating the spreadsheet. value in all entries in the Journal Entry Line
Replacement tab of the EIB input file
• If the issue persists, regenerate the spreadsheet
template and use the new template

EIB issues these errors: Check the header and line keys in the EIB input file.
Possibly some rows don't have line key or header
• Could not retrieve a file with the label: EIB
key values. Or you might be specifying header key
Transformation.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 175

Issue Cause and Solution


• Empty message received on step id values in Worksheet2 that Worksheet1 doesn't
CopyInputFile. use (or the other way around).

Business Processes
• Accounting Center Detailed Journal Approval Event
• To submit the EIB, the user security group must have access to:
• Create Accounting Center Detailed Journal
• Import Accounting Center Detailed Journal (WS Background Process)
• This business process (BP) is the first BP that Workday initiates after the EIB has passed
validations.
• Accounting Center Detailed Journal Batch Initiation Event
• This BP automatically starts once the Accounting Center Detailed Journal Approval Event is
complete. You don't have to make any security policy updates.
For reference documentation for all web services including Import Accounting Center Detailed Journal, see
Operation Directory.

Sample EIB Input File


Import_Accounting_Center_Detailed_Journal_v45.0

Concept: Import Accounting Journal EIB

Background
You can use this EIB to create or update accounting journals.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The Create Journal task is the equivalent task.
You can also use these EIBs:

EIB Name Purpose


Core Connector: Accounting Journal You can use this integration template to import
Inbound integration accounting journal data files into Workday from
an external SFTP endpoint. See Steps: Set Up
Accounting Journal Connector on page 603.
Submit Accounting Journal You can use this EIB to load small volumes of
journals (Example: less than 1000).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 176

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Accounting Journal
Event business process type in the Financial
Accounting functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you complete these fields in Worksheet#1
for Import Accounting Journal input file,
consider:

Field Considerations
Header Key Use a unique header
key value for each
journal.
Accounting Journal Specify a value if
updating an existing
journal (you can
update the journal only
if it hasn't posted yet).
Autocomplete Set this field to Y
to bypass approval
steps.
Submit Set to N if you want to
create the journal but
not post it.
Locked If you set this field to
Yes, you can’t unpost
the journal.
• As you complete these fields in Worksheet#2
for Journal Entry Line Replacement input file,
consider:

Field Considerations
Line Key Use a unique value for
each line entry for a
given journal.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 177

Field Considerations
External Supplier Originating source of
Invoice Source the supplier contract.
Populate this field
only if using the
Supplier Contract
ID External field on
the spreadsheet to
reference a supplier
contract.
• We recommend splitting the journals into smaller
groups when the line volume approaches
100,000 lines per journal.
• After loading the journals, you can use report
Find Journals to review the uploaded journals.

Common Issues and Errors

Issue Cause and Solution

The EIB is running slowly. Refer to the Guidelines for Improving EIB
Performance section below for recommendations to
improve performance

After loading a large journal, you’re unable to edit There are some restrictions within the Workday
it. You might receive a notify me later message if UI in regard to editing large transactions (even
editing during the review step. You might see that within the business process event). So we expect
the step has a Withdrawn status. to see this behavior when editing a transaction that
is too large for the UI to process and display. For
this reason, you need to rely on the web service
to supply all information for the journal. Using the
web service ensures that you don't have to make
any updates in the UI. Workday enables you to
add an attachment to the journal without actually
entering edit mode. If you merely need to add
an attachment, use the Journal > Add/Change
Attachmentrelated action on the journal.

The EIB completes successfully but you can't locate Running the Find Journals report and search for
the journal in Workday. the journal. The EIB might have loaded the journal
to the wrong period, loaded with Submit set to No,
or have some other issue causing it to not fully
load.

EIB issues this error when you attempt to attach Workday returns this error when the size of the EIB
the input file to the EIB event: The size of the file input file exceeds the 30 MB maximum attachment
‘xxxx’ is greater than the maximum permitted size limit. To resolve this issue:
file size….
1. Load your EIB input file to an SFTP site. Then,
configure your EIB with a retrieval step that
pulls the file from the SFTP site (instead of you
manually attaching the file from your browser).
This approach enables you to load a file up to 1
GB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 178

Issue Cause and Solution


2. If you don’t have an SFTP site available, split up
the EIB input file into smaller files. Then, load
into multiple journals. Alternately, check if you
can condense the size of the input file (Example:
edit the template and hide the fields you don’t
use).

When running the EIB in Validation mode, it doesn’t Validate mode only tests the validations listed in
catch all errors the API Documentation for a given web service
operation. We don’t test custom validations and
validations that occur postprocessing or at the
operation level after Workday persists the lines.

EIB issues errors such as:Invalid ID value. Make certain you’re populating the Account Set
'5000' is not a valid ID value for type = field in the Journal Entry Line Replacement tab of
'Ledger_Account_ID' the EIB Input file.

EIB issues error: A processing fault occurred • Make certain you’ve populated the Line Key
generating the spreadsheet value in all entries in the Journal Entry Line
Replacement tab of the EIB input file
• If issue persists, regenerate the spreadsheet
template and use the new template

EIB issues these errors: Check the header and line keys in the EIB input file.
Possibly some rows don't have line key or header
• Could not retrieve a file with the label: EIB
key values. Or you might be specifying header key
Transformation
values in worksheet2 that aren’t used in worksheet1
• Empty message received on step id (or the other way around).
CopyInputFile.

Guidelines for Improving EIB Performance


Below are factors that might cause your EIB to run slowly, along with recommendations to improve
performance:

Custom Validations Custom validations can slow down performance,


especially if you have a large number of custom
validations or if the validations are complex. Check
the validation rules for accounting journals using
task Maintain Custom Validations. There’s a Test
validations button that will help you determine if a
validation rule has a slow execution time.

Journals with a Large Number of Lines If loading a journal with a large number of lines,
we recommend 10,000 lines per journal for optimal
performance. Example: splitting 10 journals with
50,000 lines each into 50 journals with 10,000 lines
each might cut processing by as much as 50%.
* If using Worktag Balancing, use 5,000 lines per
journal instead of 10,000 lines per journal.

Intercompany Accounting Intercompany accounting requires Workday


to create additional journals, which increases

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 179

processing time. Consider this factor when splitting


large journals into smaller chunks.

Worktag Balancing You have the option to specify the balancing


worktag in the transaction header. Workday
automatically creates due to or due from entries for
the other balancing worktag values in the journal.
As a result, the journal line volumes can increase
when you enable the feature, thus increasing
processing time. When using Enhanced Worktag
Balancing, we recommend 5,000 lines per header.

Business Processes
Accounting Journal Event.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to create new journals or update existing journals (that haven’t posted
yet). You can’t delete journals. And also, there’s no Cancel or Rescind option available in the Account
Journal Event.
• If you've inadvertently uploaded incorrect entries, below are options to consider:
• If the journals haven't posted yet:
• Get the reference IDs of the accounting journals that you loaded and populate your EIB input
file with these values. To get the reference ID values, make a copy of the standard report Find
Journals and then add Reference ID to the report.
• Make any other necessary data corrections to the EIB input file.
• Rerun the EIB to update the previously loaded journals with corrections.
• If the journals have posted:
• You might want to consider using the Cancel Accounting Journal EIB to back out the entries.
• You can also use the Unpost Reverse Accounting Journal EIB (if the journal isn’t in locked
status) to unpost the journal. Unposting the journal enables you to correct it.
For reference documentation for all web services including Import Accounting Journal, see Operation
Directory.

Sample EIB Input File


Import_Accounting_Journal-WD32

Concept: Import Budget EIB

Background
You can use this EIB to add or update budget details.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The Maintain Budget task is the equivalent task.
You can also use the Import Position Budget EIB to create or update position budgets.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 180

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Process: Budget
domain in the Budgets functional area to run this
EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Before populating the EIB input file, you might
want to test populating a budget entry through
the user interface using the Maintain Budgets
task. This step helps ensure that you've
configured everything properly and that you’re
able to add a budget line successfully.
• You’ll likely need to make some changes to
your EIB template to add the worktags you've
assigned to the plan structure. See Customize
EIB Spreadsheet Template and the Adding
Worktags to the Template section below.
• If your budget contains over 25,000 entries,
we suggest you load 25,000 per EIB. For the
first load, use import mode REPLACE_ALL.
For each additional load, use import mode
INCREMENTAL_ADD_ONLY.
• Complete the Worksheet #1 for Import Budget
High Volume worksheet:
Note: There should be only 1 row in this
worksheet (assuming you’re loading info for just
1 budget).

Field Considerations
Header Key This value should be
1.
Budget It’s normally not
necessary to populate
this field.
Import Mode The View Plan Import
Modes report displays
the allowable values,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 181

Field Considerations
descriptions, and their
associated reference
ID values. The most
commonly used
values are:
• REPLACE_ALL:
Replaces the
budget with the info
in the EIB input file.
• INCREMENTAL_ADD_ONLY:
Adds new or
update existing
entries.
• INCREMENTAL_ADD_WITH_DEL
Deletes existing
plan lines by
specifying an
amount of 0.00
• REPLACE_ALL_BY_PERIOD:
Replaces all plan
lines in a single
budget period.

AutoComplete Set this field to Y for


the business process
event to automatically
process, then skip
approval and To Do
steps.
Budget Structure You can use this
method to identify
the Budget Structure
value:
1. Locate your budget
using Find Plan
Templates.
2. You'll then see
the company, plan
structure, plan
name, and other
items for your
budget.
3. From the related
actions of your
Plan Structure
value, select
Integration IDs
>View IDs.
4. This view displays
the value for the
reference ID type
Budget_Structure_ID.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 182

Field Considerations
Budget Name Based on the Plan
Type that you're
importing, you'll need
to update the format
for the Budget Name.
This field defaults to
Award_Proposal_ID.
For Project
Budgets, specify the
reference ID type
Project_Budget_ID.
For Financial
Budgets, specify the
reference ID type
Custom_Budget_ID.
To find the reference
ID value:
1. Locate your budget
using Find Plan
Templates. You'll
then see the
company, plan
structure, plan
name, and other
items for your
budget.
2. From the related
actions of your
Plan Name value,
select Integration
IDs >View IDs.
3. This view displays
the value for the
reference ID type
and ID.

• Complete the Worksheet #2 for Budget Lines


Data worksheet:

Field Considerations
Header Key This value should
be 1 for all entries
(assuming you’re
loading information for
just 1 budget).
Line Key Each entry needs
a unique value. We
recommend you start
with value 1 and
increment by 1 for
each additional entry.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 183

Field Considerations
Year and Fiscal Time To determine the
Interval values for these fields:
1. Use the View
Fiscal Year report
and select the
fiscal schedule
used by your plan
structure.
2. Find the value for
the fiscal year and
fiscal time interval
from the related
actions of the fiscal
year and fiscal
posting interval.
3. For Budgets by
Duration, the
fiscal year should
be the fiscal year
corresponding
to the start of
the project.
Set the Fiscal
Time Interval to
Fiscal_Posting_Interval_ID
and set the Fiscal
Time Interval to
the first period of
the plan. If the plan
starts on March
3, 2019 and your
calendar year is
the same as your
fiscal year, then:
• The fiscal year
is 2019.
• The Fiscal
Posting Interval
for all plan lines
is March.
4. For Project
Budgets by
Period, use
the Fiscal Year
and Fiscal
Posting Interval
corresponding with
the budget period.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 184

Common Issues and Errors

Issue Cause and Solution

The EIB fails with a Gumby Collision error such as: The Import Budget web service locks the entire
com.workday.instancedata.gumby.GumbyCollisionException:
budget. This error can occur if the tenant detects
Import Budget (WS Background Process) cannot 2 processes that are updating the same budget. If
process Budget Details: 2019 Mar (2019 My you encounter this error:
Budget - xxxx until Import Budget (WS Background
1. Ensure that you haven't entered more than 1
Process) finishes.
entry in the first tab (worksheet) of the EIB input
file when loading information for 1 budget. The
first tab enables you to break up the data load
into multiple batches or processes (each entry
in this tab would represent 1 batch). Use only
1 entry here (for header key value 1) so that
Workday doesn't split the processing for a single
budget into multiple concurrent processes.
2. Ensure that you don't concurrently launch more
than 1 Import Budget EIB for the same budget.
3. Ensure that no one is updating the budget using
the user interface at the same time the EIB is
running.

The EIB fails with the error: If you encounter this error:
One or more budget lines have matching Company, 1. Check for duplicate entries in the input file.
Ledger Account Summaries/Ledger Accounts, and When you compare the ledger account and all
Accounting Worktags with another line. the worktags within each fiscal period, each line
should be unique. To find duplicate lines, you
can use this method:
a. Sort the input file by company, ledger
account, period, and worktags
b. Add a new column and insert a formula that
concatenates the company, ledge account,
period, and worktag.
c. You can now use any of several Excel tools
to find duplicates. You can go to the Home
tab and select Conditional Formatting >
Highlight Cell Rules > Duplicate Values.
2. If your web service has related worktags
enabled, it's possible the EIB is retrieving related
worktags that then cause duplicate entries. To
prevent this issue, run the Maintain Worktag
Type Precedence task, delete any rows, then
retest.
3. Verify that you're using the most recent web
service version. If you're not sure which web
service version you're using, create a new EIB,
which will pick up the latest web service version.

The EIB fails with the error: This error indicates that you haven't specified the
correct Year or Fiscal Time Interval.
Budget Period does not exist for Budget.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 185

Issue Cause and Solution

The EIB fails with the error: If you encounter this error, test whether you can
enter the information through the user interface
Worktag is not valid for the Budget Line.
using Maintain Budget. Determine if this error is
a configuration issue or an issue with how you're
populating the EIB input file. This error can occur if:
1. You specify an inactive worktag.
2. You specify a worktag that references a related
worktag that is inactive.
3. The worktag doesn't have a configuration
for the structure dimension. Alternately, the
worktag has a configuration in the structure
dimension but the configuration doesn’t include
all members.

EIB fails with one of these error messages: The errors occur when the EIB input file doesn't
have correct reference ID value for the Budget
• xyz is not a valid ID value for type =
Name field.
"Custom_Budget_ID"
• xyz is not a valid ID value for type = There are 2 options to correct the EIB that isn't
"Project_Budget_ID" loading:
• Option 1: Change the reference IDs to match
what is in the EIB input file, by running the
Maintain Reference IDstask. Enter Project
Budget Source or Financial Budget at the
Business Object Prompt, depending on what
you are loading. Select theInclude Default
Values Only check box. You can now change
the values of the reference IDs to match what is
in the EIB input file.
• Option 2: Change the EIB input file to use the
existing reference ID values by following the
steps above to find Budget Name.
To prevent the issue from reoccurring:
• Option 1: Access the Edit Tenant Setup –
Financials task and navigate to the Budget
Options section. Select the Generate Budget
Source Reference ID as Plan Name. check
box
• Option 2: Set the plan name, when running the
Put Budget Template EIB, by populating the
Budget Source ID field with the reference ID
value you wish to use. Ensure that your EIB
is using a recent web service version as the
Budget Source ID field isn’t available in older
versions.

There’s no option to launch the integration. This error occurs if you don't have the proper
access to thePlan Event business process
security policy. To fix this issue, you can:
1. Check the Plan Event business process
security policy to make certain you have

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 186

Issue Cause and Solution


access to Initiating Action Import Budget (WS
Background Process) .
2. Activate the change.

The EIB Fails with the error: This error can occur if you update a plan template
without plan lines using the Put Budget Template
You can't change the Multicurrency setting if plan
web service to enable multicurrency.
lines exist.
You can prevent this error from reoccurring on the
Put Plan Template by:
• Adding the Template ID to either Column D and
Column E.
• Entering No in Column C.

Business Processes
Plan Event

Use Cases and Guidelines for Recovering from a Bad Load


There’s no option to mass-rescind or mass-cancel the business process event. However, if you
inadvertently loaded incorrect entries, you could reload the correct entries using import mode
REPLACE_ALL.

Adding Worktags to the Template 1. From the related actions menu of your EIB,
select Template Model> View.
2. On the left, select All under the Budget Lines
Data section. On the right, scroll down to locate
Accounting Worktags..
3. From the related actions on the magnifying glass
next to Accounting Worktags, select Template
Model Column > Maintain Additional
Columns.
4. Enter all worktags you need to assign to the
budget.
5. After you’ve completed the previous steps,
regenerate the spreadsheet template and add
newly added worktags to the spreadsheet
template.

For reference documentation for all web services including Import Budget, see Operation Directory.

Sample EIB Input Files


Import_Budget-WD31-Example1-Financial-Budget_0
Import_Budget-WD31-Example2-Project-Budget-by Period_1
Import_Budget-WD31-Example3-Project-Budget-by-Duration_0

Concept: Submit Customer Invoice EIB

Background
You can use this EIB to add or update customer invoices.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 187

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Customer Invoice
• Find Customer Invoices
• Manage Customer Invoices. See Manage Multiple Customer Invoices at Once for more information.

EIB Input File Guidelines

Web Service Version and Security Configuration • We frequently update the Submit Customer
Guidelines Invoice web service. Workday recommends
using the latest web service version for your
EIB. You can check the version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to the Customer Invoice
Event business process in the Customer
Accounts functional area to run this EIB.

Modifying the EIB Template to Add Additional • If you need to populate multiple worktags
Worktag Fields for your customer invoice, you'll want to add
additional worktag fields to your spreadsheet for
each worktag you use.
• Note that you can add worktags fields at both
the customer invoice header and at the line item
level.
• To add worktags to the Header:
1. From the related actions of the EIB, select
Template Model > View.
2. In the left pane click Customer Invoice Data.
3. Click the magnifying glass for Worktags+
row.
4. From the related actions of the Worktags
+ row, select Template Model Column >
Maintain Additional Columns.
5. Add a row for each possible worktag type that
you might be specifying in your EIB input file.
6. Click OK.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 188

• To add worktags at the line level:


1. From the related actions of the EIB, select
Template Model > View.
2. In the left pane click Customer Invoice Line
Replacement Data+.
3. Click the magnifying glass for Worktags+
row.
4. From the related actions of the Worktags
+ row, select Template Model Column >
Maintain Additional Columns.
5. Add a row for each possible worktag type that
you might be specifying in your EIB input file.
6. Click OK.

Modifying the EIB Template to Hide Attachment If you plan on using the Generate Spreadsheet
Data with Data option and some of the invoices contain
attachments, you should change the template
to hide the attachment file. We recommend this
modification because the attachments are typically
too large to fit in an Excel file (which has a limitation
of 32,767 bytes per cell), so Excel truncates the
data. To hide the attachment.
1. From the related actions of the EIB, select
Template Model > View.
2. In the left pane, click Invoice Attachment.
3. Locate the Template Model Area and from the
related actions select Template Model Area >
Hide.

Configure the EIB to Generate with Data • It can be very helpful to generate the template
with data if you're updating existing customer
invoices or creating customer invoices and
want to see how the EIB input file should be
populated.
• If creating new invoices, you might want to start
by manually creating 1 customer invoice like the
invoices you plan on loading using the EIB, then
configure the EIB.
• Find an existing customer invoice similar to
the type of invoices that you wish to load.
• From the related actions of the invoice, select
Integration IDs > View.
• Copy the ID value. You'll use it in a later step.
• From the related actions of the EIB, select
Template Model > View.
• Click Edit Template with Data Options.
• From the ID Type prompt, select Customer
Invoice Reference ID.
• In the ID column, enter the reference ID you
previously copied.
• Regenerate the EIB and select the Generate
Spreadsheet with Data check box. Note:
It populates all data including derived date.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 189

You might need to clean up the EIB input file


and remove unnecessary field values before
using it.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that
you generate your spreadsheet with data
for the Submit Customer Invoice EIB. See:
Example: Generate EIB Spreadsheet Template
with Data on page 62.
• Complete these options on the EIB input file:

Field Considerations
Spreadsheet Key Specify a unique value
for each customer
invoice.
Add Only Set to Y only if
adding new customer
invoices. If adding
new lines to existing
invoices, set it to N.
Customer Invoice Populate this field if
(column D) updating an existing
customer invoice.
Auto Complete If set to Y, Workday
skips all approval
steps, review steps,
and to do steps,
and suppresses
notifications.
Customer Invoice ID Populate this field if
(column H) updating an existing
customer invoice, or if
creating a new invoice
and assigning your
own customer invoice
ID.
Submit Set to Y to submit the
Invoice. If set to N, it
will stay in draft status.
Locked in Workday If set to Y, you can
make modifications
to the invoice only
using the EIB or web
service.
Company Workday requires the
Company field. To find
the value, you can use

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 190

Field Considerations
the Reference IDs
report and search
for business object
Company.
Customer ID Workday requires this
field.
Invoice Line Data Specified in the
Customer Line
Replacement Data
section, which starts
in column ET in the
attached sample input
file. Note that:
• Row ID (Column
ET): Enter a unique
row ID value for
each line item.
• Customer
Invoice Line
and Customer
Invoice Line
Reference ID: If
you’re updating an
existing customer
invoice, you need
to include the
existing lines and
you must populate
these fields. The
easiest way to
populate this
information is to
use the Generate
Spreadsheet with
Data option.

Worktags If you’re populating


worktag values in
either the header
or line item, see
Modifying the EIB
Template to Add
Additional Worktag
Fields section for
instruction how to add
additional worktag
fields.
External Supplier Originating system of
Invoice Source the supplier contract.
Populate this field
only if using the
Supplier Contract

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 191

Field Considerations
ID External field on
the spreadsheet to
reference a supplier
contract.
Attachment Data Although you can add
or update attachments
using this EIB, we
don't recommend it
as there are some
challenges in loading
document content
using the EIB. If
you need to add
attachments using
an integration, you
might find it helpful
to refer to section
How to Populate
File Attachments
in EIB Input File
in the Community
page for Put Worker
Document. Although
it's covering a different
web service, the
same information
applies to Submit
Customer Invoice in
regard to populating
attachments.

Common Issues and Errors

Issue Cause and Solution

EIB performance is slow. Below are items to check:


• If you have a lot of custom validations, it can
degrade performance.
• Evaluate which web service to use. If most
of the invoices have very few line items, use
Submit Customer Invoice. But if the invoices
have a larger number of line items, test using
Import Customer Invoice instead.

After updating existing customer invoices, If you don't include existing customer invoice
information is missing including line items. information in the EIB input file, Workday
might remove it. We recommend that you use the
Generate Spreadsheet with Data functionality to
avoid losing data.

The EIB issues this error when updating existing If you generated the spreadsheet with data,
customer invoices: the EIB input file populates both the bill-to

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 192

Issue Cause and Solution


Validation error occurred. Usage Data is required address reference ID along with all the address
unless address is being deleted. attributes, which can cause confusion.
If you aren't making any changes to the bill-to
address, then remove the address values from
the EIB input file from column R (Row ID of Bill to
Address) to column BC (Municipality Local).

When attempting to generate the spreadsheet with This EIB uses Get Customer Invoices web service
data, it fails with this error: to fetch the information needed to generate the
template with data. You can find this information in
Integration Failed.
the Supported Inbound EIB Operations report.
com.capclear.mediation.MediationException:
The Get Customer Invoices web service is secured
application=assemblyGenerateSpreadsheetE2
by the Process: Customer Invoice - View domain.
- Error code : 1" "The task submitted is not
Verify you have Get access to this domain security
authorized.
policy. Activate security policy changes.

When attempting to generate the spreadsheet with This issue occurs when extracting invoices with
data, it fails with this error: attachments. To work around this issue, complete
the steps in the section Modify the EIB Template to
Integration Failed.
Hide Attachments.
com.capeclear.mediation.MediationException:
application=assemblyGenerateSpreadsheetE2
- Custom step id=GenerateWhenSplit,
ref=SpreadsheetGenerationBean_EIBWXF - Error
while invoking bean, reason: One or more of the
columns in your template model includes file-
based (base64) data that will be cut off due to a
spreadsheet cell limit of 32,767. To fix this, go to
the template model and hide the related file-based
data columns. Root Cause: java.lang.Exception:
One or more of the columns in your template model
includes file-based (base64) data that will be cut off
due to a spreadsheet cell limit of 32,767. To fix this,
go to the template model and hide the related file-
based data columns. See the consolidated report
for further details.

When launching the EIB, this error displays when The size of the EIB input file, for customer
attempting to attach the EIB input file: invoices, can be quite large due to the amount
of data associated with each customer invoice.
The size of the file 'xxxx' is greater than the
Unfortunately, there isn't a way to increase the file
maximum permitted file size (30,720KB). Please
limitations when attaching EIB input files. But below
select a different file or reduce the size of this file.
are a couple suggestions that might help.
• If you have an SFTP server, 1 option would be
to load your EIB input file to the SFTP site, and
then configure your EIB with a retrieval step
that pulls the file from the SFTP site (instead of
manually attaching the file from your browser).
If you do this action, you can load a file up to 1
gig.
• If you’re using an XML input file, consider
switching to XLSX format as the file size will be
smaller.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 193

Issue Cause and Solution

Unable to launch the EIB This issue is most likely security-related. See
Web Service Version and Security Configuration
Guidelines section for instructions to verify that
you’re using the most recent web service version
and you've configures the security properly.

Business Processes
Customer Invoice Event.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new customer invoices or update existing customer invoices. You
can't delete or rescind customer invoices.
• If you've inadvertently uploaded incorrect customer invoices, check if 1 of these options will work for
your situation:
• Rerun the EIB and update the invoices with correct information.
• Use the Cancel Customer Invoice EIB.
• If the events are still in progress, try Mass Cancel Business Processes.
For reference documentation for all web services including Submit Customer Invoice, see Operation
Directory.

Sample EIB Input File


Submit_Customer_Invoice-WD35

Human Resources EIBs


Concept: Add Update Organization EIB

Background
You can use this EIB to add a new organization or update an existing organization.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on the type of organization that you’re creating or updating.
Examples of equivalent Workday tasks include:
• Create Cost Center
• Create Custom Organization
There are additional integrations and EIBs related to organizations functionality. Consider these options as
you determine what works best for you:
• Change Organization Assignments: You can use this EIB to assign members to an organization.
Workday recommends using Change Organization Assignments to assign members to an organization,
however the Assign Organizations and Assign Members to Custom Organization EIBs are also
available. Review the documentation for those EIBs to determine what works best for you.
• Inactivate Organization: You can use this EIB to inactivate an organization.
• Org Studio and Mass Actions: Consider using this functionality if you're performing a reorganization.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 194

• Organization Inbound Connector: You can use this integration to import organization changes into
Workday.
• Put Company, Put Cost Center and Put Location: These are organization-related web services. Review
the API documentation for these web services in the Operation Directory to determine if you wish to use
them.
• Put Supervisory Organization Assignment Restrictions: You can use this EIB to assign and enable
organization values for a Supervisory Organization.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage:
Organization Update Integration domain
security policy in the Organization and
Roles functional area to run this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files. Additionally, as you populate the EIB input
file, consider:
• Spreadsheet Key: Specify a unique value for
each organization that you're adding or updating.
• Organization Reference ID: If you're updating
an existing organization, you need to specify its
reference ID in this field. If you're creating a new
organization, ensure the value that you enter
isn’t already in use.
• Organization Type Name and Organization
Subtype Name: Populate these fields if you're
creating new organizations. You can find a
list of values by running the Integration IDs
report and searching for the Organization Type
and Organization Subtype business objects. Use
the actual name of the organization type and
subtype as you populate the EIB input file, not
the reference ID value. The values that you need
to populate in the EIB input file display in the
Instance column of the Integration IDs report.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 195

• Superior Organization: Populate this field if


assigning:
• A hierarchy to a superior hierarchy.
• An organization to a parent organization.
Example: Assigning a supervisory
organization to a parent supervisory
organization.
• Primary Business Site: If you create a
supervisory organization, specify the location
here.
• Container Organization: Populate this field if
you're assigning an organization to a hierarchy.
Example:
• Assigning a cost center to a hierarchy.
• Assigning a company to a hierarchy.
• Assigning custom organization to a hierarchy.

Common Issues and Errors

Issue Cause and Solution


There’s no option to launch the integration. This is typically a security-related issue.
Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and that you have access to
the Manage: Organization Update Integration
domain security policy in the Organization and
Roles functional area.

EIB issues errors when run in validate-only mode, This occurs if you’re loading multiple organization
but works fine when running in nonvalidate mode. assignments where each entry builds on the
previous entry.
Example: The first entry builds a hierarchy and
the second entry assigns an organization to that
hierarchy. This doesn’t work in validate only mode
since it fails to commit to each change. Therefore
there isn’t a way to run this scenario successfully in
validate-only mode.

I moved an organization to a new hierarchy Workday can't include an organization in more


using the EIB. After completing the change, the than 1 node within the same top-level hierarchy to
organization is in both the old hierarchy and the avoid double-counting. We deliberately support an
new hierarchy. organization being able to be in more than one top-
level hierarchy because each top-level hierarchy
can serve a different purpose (roll up). Example:
You can group cost centers in different ways. We
don’t plan to change the existing behavior since
many customers currently rely on the ability to
have the same organization belong to multiple
hierarchies.

EIB issues this error: • Verify you're populating the name of the
organization subtype in the EIB input file. The

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 196

Issue Cause and Solution


Validation error occurred. Organization Subtype values that you need to populate in the EIB
isn’t valid for Organization Type. input file display in the Instance column of the
Integration IDs report.
• Run the Maintain Organization Subtypes
task and verify that the same subtype
doesn't occur in more than 1 entry. Example:
Organization types Cost Center Hierarchy and
Supervisory both use the Group organization
subtype. There shouldn’t be 2 separate entries,
but rather just 1 entry for the subtype Group
used by both organization types.
• Verify that you’ve configured the organization
subtype for the organization type you’re
using. You can use the Maintain Organization
Subtypes task to check.
• Verify that the organization subtype name isn’t
already in use. Example: There are Workday
delivered organizations such as Region and
Business Unit. So overlapping names can cause
issues if you have custom organizations with
these same names. To resolve the issue, use
the Maintain Organization Subtype task to
change the subtype to a unique value.

After loading organizations, they aren’t searchable. There’s an index build process that runs
periodically in your tenant. Wait for this build to
complete before the newly loaded organizations
are searchable. The index build runs hourly in
Production and every 6 hours in non-Production
tenants.

Roles marked as Self-Assign are automatically To prevent auto-assignment, use the Maintain
assigned to the user who runs the EIB. Assignable Roles task to filter in the Self-Assign or
Leadership columns and deselect the roles.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add new entries or update existing entries. You can’t delete entries and you can't
rescind additions or updates since the web service doesn’t use a business process event.
If you have uploaded incorrect entries, you can:
• Resubmit the EIB with the corrections.
• Inactivate the organizations by using the Inactivate Organization web service.
For reference documentation for all web services including Add Update Organization, see Operation
Directory.

Sample EIB Input Files


Add_Update_Organization-WD35-Example1-Miscellaneous
Add_Update_Organization-WD35-Example2-Build-Cost-Centers-and-Hierarchies

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 197

Concept: Add Vaccination EIB

Background
You can use the Add Vaccination EIB to load a worker's vaccine events, including their vaccine status,
type, and manufacturer. If you want to load a worker's workplace health and safety tests, you can use
the Add Workplace Testing EIB instead.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Add Vaccination.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Add
Vaccination business process type in the
Vaccination Tracking functional area to run
this EIB.
• You must have access to the Person Data:
Vaccination domain in the Vaccination
Tracking functional area to view the
vaccination data for this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files. Additionally, as you populate the EIB input
file, consider:
• Spreadsheet Key: Specify a unique value
for each vaccination. If you load multiple
vaccinations for the same person, the
spreadsheet key value still needs to be unique
for each entry.
• Person: Specify the reference ID of the person.
Update the reference ID value in cell C4 from
Academic_Affiliate_ID to Employee_ID.
• Vaccine Type: Example: COVID-19. To find the
reference ID value, access the View Reference

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 198

IDs report and search for the Vaccine Type


business object.
• Vaccination Status: Examples: Vaccinated,
Partially Vaccinated. To find the reference
ID value, access the View Reference IDs
report and search for the Vaccination Status
business object.
• Vaccine: Examples: Pfizer, Moderna. To find
the reference value, access the View Reference
IDs report and search for the Vaccine business
object.
• Vaccination Event Type: Examples: First Dose,
Booster. To find the reference value, access the
View Reference IDs report and search for the
Vaccination Event Type business object.
• Vaccination Date: Use format YYYY-MM-DD.
Consider creating a custom report from the
Vaccinations report data source to:
• Determine which workers already have
vaccination information, or
• Verify that the EIB successfully loaded the
vaccination information.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it looks Check these:


like the data didn't load.
• Check the status of the event. If it’s still in
progress, consider mass canceling all in-
progress events, making any needed changes
to the EIB and rerunning it.
• Verify you have the correct security
configuration. Ensure that you are in the
relevant security group and have access to
these domains and business processes in the
Vaccination Tracking functional area:
• Add Vaccination
• Person Data: Vaccination

EIB issues an error like this: Verify that you have appropriately set the reference
ID type in cell C4. Most likely, you’ll need to change
Validation error occurred. Invalid ID value.
it to Employee_ID.
'21002' isn’t a valid ID value for type =
'Academic_Affiliate_ID'

Unable to attach a file, such as an image of a The EIB doesn't support attaching files. If you need
vaccination card, through the EIB. to attach files, you need to submit the request using
the SOAP API instead of using EIB.

Unable to launch the EIB This is most likely security-related.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 199

Issue Cause and Solution


Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and have access to these domains
in the Vaccination Tracking functional area:
• Add Vaccination
• Person Data: Vaccination

Business Processes
Add Vaccination.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only enables you to add vaccinations. You can’t update or delete existing vaccination entries with
this EIB.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind. Alternatively, you can enter Add Vaccination in the Business Process Types prompt and enter
the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Add Vaccination, see Operation Directory.

Sample EIB Input File


Add_Vaccination-V37

Concept: Add Workday Account EIB

Background
You can use this EIB to add a new Workday account (Example: username and password) with the
information you supply. You can create accounts for workers (Example: employee or contingent workers)
and nonworkers (Example: recruiting agency users or supplier contacts).
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday for creating Workday accounts varies depending on the worker type.
Examples of equivalent Workday tasks include:
• For employees or contingent workers, you can select Security Profile > Create Workday Account
from the related actions menu of the worker profile.
• For recruiting agency user, you can use Add Workday Account for Agency User.
• For supplier contact, you can use Create Workday Account for Supplier Contact.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 200

• There are additional EIBs you can use to create or update Workday Accounts. Consider these options
as you determine what works best for you:
• Manage Extended Enterprise Learner: You can use this EIB to create an extended enterprise
learner and their Workday account.
• Update Workday Account: You can use this EIB to update an existing Workday account.
• There's also a Create Workday Account subprocess available from within some EIBs, such
as Contract Contingent Worker and Hire Employee.

EIB Input File Guidelines

Security Configuration Guidelines • If you set the Generate Random Password


field to Y, then the EIB will generate the new
password information and email it to the email
address associated with the account.
• To test that the emails deliver successfully, you
can:
1. Access the Edit Tenant Setup – Security task
and select the Enable Security Mails check
box. Select the appropriate option to send
the email to either the home email address
or work email address associated with the
account.
2. Confirm that the recipients have an email
configured in their account.
3. Verify that the recipients receive emails
containing the:
• Account name
• Password.

Guidelines for Modifying the EIB Template You can modify the EIB template and use it for any
type of worker or nonworker.
1. From related actions of your EIB, select
Template Model > View. Select the second
occurrence of All . Select the magnifying
glass icon and then select Related Actions >
Template Model Column > Edit Details.
2. Select the Reference ID Type as Separate
Column check box.
3. Regenerate the template. On the regenerated
template, you can choose any type of worker or
nonworker.

Guidelines for Populating Fields in the EIB Input Workday recommends that you populate the
File Worker ID and Reference ID type in the EIB input
file. This ensures that the EIB creates an account
that is associated with a person.
We also recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files. Additionally, as you populate the EIB input
file, consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 201

• Spreadsheet Key: Specify a unique value for


each Workday account that you create.
• Non-Worker: Although this field is titled Non-
Worker, you can use it to populate any type
of person (Example: employee, contingent
worker, supplier contact, and so on). Use option
Reference ID Type as Separate Column as
noted in the Guidelines for Modifying the EIB
Template section above to select any type of
worker or nonworker. You can find the IDs of
the worker using a custom report. Workday
recommends:
• If you're building accounts for employees
or contingent workers, create a custom
report by using the Indexed All Workers data
source and include these fields:
• Employee ID
• Has Workday Account
• Worker Type
• If you're building accounts for supplier
contacts, create a custom report using
the Suppliers data source and include
these fields from the Supplier Contacts for
Supplier business object:
• Name
• Reference ID Value
• Workday Account
• If you're building accounts for recruiting
agency users, create a custom report
using the Recruiting Agency data source
and include these fields from the Agency
Users business object:
• Name
• Reference ID Value
• Workday Account
• Username: Specify the username.
• Generate Random Password: If you set
this field to Y, the EIB will generate the new
password information and email it to the email
address associated with the account.
• Notifications: Below are details for populating
fields associated with notifications. When
you update a notification type, it replaces all
instances. To avoid removing information,
ensure that the EIB input file includes all
channel information for the notification type.
Also, you must supply Workday IDs (WIDs) for
each of these fields. The WIDs would typically
be available from the Integration IDs report.
However, at this time they aren’t available due
to a permission-related issue that the Workday

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 202

development team is investigating. Instead, refer


to the lists of WID values in the tables below.
• Notification Sub Type: This is the
notification type. (Examples: Approvals, Give
Feedback, Tasks.) Enter the WID of the
notification type. (Refer to the tables below).
• Channel: Specify the channel (Examples:
Email, Mobile Push Notification). You’ll need
to enter the WID for the channel (Refer to the
tables below).
• Delivery Frequency: Specify the delivery
frequency (Examples: Immediately, Daily).
You’ll need to enter the WID (Refer to the
tables below).
Notification Sub Type WIDs

Sub Type WID


Academic Advising cb44bb05eac9100018eb6ff35b851bd2
Accounting Center Job e27757ee7b2010000fd3de185eea0155
Process
Active Candidates a706101145a710000dc4aecfec560e31
Activity Comments 129b10b7c5f3420fa4fddf996926a202
(Workfeed Category)
Activity Comments 82ab74b4ae6f100004e8556f218800fa
(Notification Category)
Add employee to Comp 34fd44019fd010001918a0314ed91f14
Process
Ad Hoc Worker 1011c352e20210001ca79c9258e20000
Admissions 5f65e7293d2c10000edb8d02537b8209
Advising 5f65e7293d2c10001003ee972c1c8235
All (Workfeed Category) 4aaeaf783ff010001467d931d5e10dc3
All (Notification c4a3ace8c553100003d6c837a893328f
Category)
Anniversaries d992163bd1c64545b6838a11db55f295
(Workfeed Category)
Anniversaries 82ab74b4ae6f10000dac2b7d47810103
(Notification Category)
Approvals (Workfeed 774bf71042c54ba699e55ed144c7727f
Category)
Approvals (Notification c1b1c0d7c622100008114eee19a500f3
Category)
Assignee Change 6fe1b925df1c100014e4e5e2d88a00ac
Attachment 6fe1b925df1c100014d851ef129000a9

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 203

Sub Type WID


Background Error 5e355d7bd78c10001c8c5e155115054e
Notifications
Background 5e355d7bd78c10001c91553923e40551
Notifications
Background Process 74dba421e130100022915d5e52ee011
Notifications
Birthdays (Workfeed 777410acf79949a09b333447ff89fd95
Category)
Birthdays (Notification 82ab74b4ae6f10000d72427432380100
Category)
Bonus, Comp, Stock, 34fd44019fd01000190e8ea57c351f0e
Merit review
Candidate Home f8c28585e999100016a455ff3f8e0020
Account Deactivated
Case Creation 6fe1b925df1c100014c029e453a900a5
Case In Progress / On 6fe1b925df1c100014e97920fd9600ae
Hold / In Review
Case Note Tagging 815fb7b786b71000172fe31f416802f9
Case Resolved / 6fe1b925df1c100014ee5d65180d00b0
Cancelled
Case Resolver Digest f395b3d16ab91000184b2386a05905a1
Case Type Change 848867ad45001000047a8844a45d00f9
Change Service Team 6c5e98dd2bfa100017027064e84300f9
Check-Ins bff93e85cf2c10000a7bbead7a8d001c
Conversations 2e0e51f8c9341000061babcd5c6f03ee
Custom Business a2b194bb781910000476d4558ec2001
Process Notifications
Customer Accounts 70736b73cdb01000506f60f24a68019e
Development
Notification Destination
Configuration Category
Customer Central 9ff3b5ef4f7c10000ff4de10be3f1259
Delegation Notifications beceb2fbfb4f100015eabed7e2090161
Document Management 163e32abf03a100003240c0b1429000f
Add File
Document Management 163e32abf03a100003423a6e18940013
Add Folder
Document Management 163e32abf03a10000348f8f7abd50016
Virus Detected
Drive Access Additions 25eb81dbb2ea10001c20bce216c40016

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 204

Sub Type WID


Drive Access Changes 4f63ca15e20110001711aab81c7d006d
Drive Access Removals 25eb81dbb2ea10001c2604f16cbd0018
E&G Committee 34fd44019fd01000191dffd566281f18
Invitation
Email Footer 457f0884361710004742d7c7a99a0151
Evidence of Insurance 34fd44019fd01000190bab539fbd1f0c
Expense Receipt 710a01298a24100005e509ea22a200f9
Extended Enterprise 96c808035d7e10000b810107223f0000
Campaigns
External Async beceb2fbfb4f10001c4f90c547b801e7
Notifications
Favorites (Workfeed 9fdb829ecbbe40b184dd3f9eb47fe168
Category)
Favorites (Notification 579a3365758843649c876e9c66bccaf7
Category)
Financial Aid - Awards 5f65e7293d2c10000f434e5c95d58221
Financial Aid - 5f65e7293d2c10000f2f56d9eca0821d
Disbursements
(Workfeed Category)
Financial Aid - c91c56bbcd4010000ccdb8655ee7000f
Disbursements
(Notification Category)
Financial Aid - General cb44bb05eac9100018db28b5e6dd1bd0
Financial Aid - ISIR 5f65e7293d2c10000ee9a0860bf9820e
Financial Aid - 1524448c314210002153b281854405e
Packages
Financial Aid - Plans 5f65e7293d2c10000f0d07d2170c8214
Financial Aid - 5f65e7293d2c10000f1e8888c7508219
Satisfactory Academic
Progress
Friends and Family e94b19c30bd110001bd70a57e71b03e
Account Linking
General Notifications 2ff49da119294aa29758efe9b848540b
(Workfeed Category)
General Notifications 82ab74b4ae6f10000c295c1069e200fd
(Notification Category)
Gigs e94adfdfecde10000fe7706ac71200e3
Give Feedback 5ea84c6beb8710000839eea3298e000
Global Payroll 0c52cc7b3b9010000abb1a4975720135
Assignments

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 205

Sub Type WID


Goal Notes a2b194bb78191000047c98885f4a0015
Help 56e51c95192010001161ae0a7c9d0579
Insight Publish bac9a2e4337f10000617c6baf4af00d6
Notification
Integration Staging a407ce54494510000f274cd22b5f00ff
Table
Integration Task Status a407ce54494510000f2a93a536590101
Integrations a2b194bb78191000047187fe2b420011
Interview Schedule e2cc9ac78d7c10000b2cb807492c0043
Communications
Inventory Average Daily 5074e595d83910000e2c969b78af006a
Usage
Inventory Count 48715d24386a100012a41da79f5e0063
Notification
Inventory Preferred e4da97efccd910001d55a63dc69f0041
Supplier Lead Time
Inventory e1c5cf8731961000050add2f790e03a9
Replenishment
Job Alerts - External 65676c189c3c10000bbce88642831906
Candidates
Job Alerts - Internal b5b2384b49cb100016f2865d62420119
Candidates
Job Application - 34fd44019fd0100019117ac6cb9b1f10
Interview Additions
Knowledge Base cda1b849845d100023d4c0f0f3340012
Notification
Learning Campaigns bcbbab73dcd7100004ed54d17aa80df4
Learning Expiration bb00e05a6171100005e617e7e29c002
Periods
LinkedIn Recruiter 6c58aec13c3e10000498ae4cc4830014
notifications
LiveSafe 638823379e8610000a55dd55b2cf000c
Manage Individual 34fd44019fd010001914ea80cccd1f12
Benefit Rates
Marketplace 8b9652d258d41000118888bc416b131
Opportunity Promotion
MCC Test Notification f9d144b32329100033584bbd4edf038d
Type
Media 0db520c2dc12100011d5864be5e92b69

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 206

Sub Type WID


Metric Review f1de2cb9d5d710a0335cecb1f8701f90
Notification
My Requests ba0ed042cad044cf9800bbaa49c9e6ab
New Work Schedule 5c6dfecfabf310001a088a401aff025a
Published
Onboarding Setup d5f091ea94601000050890fb9bd500d6
Open Enrollment for 34fd44019fd01000191bd569e87b1f16
Benefits
Out of Order Plan 66755215d5131000051ca8604d60001
Overdue 273cac0c65cb4b8c9177e4995e96819e
Passive Enrollment efde3f15b27510000382037f5fc20000
Event
Pay Calculation 2f2d43a42ff31000097b38bb689c001a
Scheduler
Pay France DSN d737b361447f100017a05cefcc7100ef
Rejected
Planning Notifications 27513ca83229100006bf673576bd0400
Prism Data Acquisition f21fc1062ada100005d0c560fa3911f9
Notification
Prism Wbucket 25b1a682dca8100004641aef191100f4
Complete Notification
Process Task a407ce54494510000f0748acae6a00f5
Processes 66220f2e75a4423a92198e2dc9f5ba17
Publish Dataset a02747a1227b100011916fd30add000f
Read Notifications 1ddd59e7d90a4de29765bb8b953eb73
Reassign Notifications 526af104c8e1100016bcfe2301ac000b
Recruiting Business 27c29ee4946610000967dc296104001a
Process Communication
Recruiting Marketing e37ea5cc6b7110000a2f8d3547d600a3
Recruiting Personal 74739a7d78e510000e19a758151a019
Reminders
Reply 6fe1b925df1c100014d53347d93a00a7
Request for Quote d515cc9d884910001eaffa1bc226003a
Notifications
Scheduled Future a2b194bb78191000049336306542001
Processes
Scheduled Report a2b194bb78191000048c2d88d9da001
Completion
Send Notification a407ce54494510000f116d386ac300f9

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 207

Sub Type WID


Share notifications beceb2fbfb4f10001747aac841be01a1
Share Report a407ce54494510000f165316631700fb
Share Snapshot a407ce54494510000f1ba5b395d500fd
SMS Opt in OTP 72b7b87dcb9e100007802bd4808801f0
Student Engagement 02b3334d89af10001d1896d8cea00342
Monitoring
Student Financials 5f65e7293d2c10000f5299acbf928225
(Workfeed Category)
Student Financials 75ddcf3c56fb100029702045620b37cf
(Notification Category)
Student Financials - fa2f1d3b402e10000ab12850630f02cf
Holds
Student Financials - a638bb30f4d8100013bbdaec70c00061
Proactive Notifications
Student Financials - 5f65e7293d2c10000f66fb8ab282822b
Refund
Student Financials - b08dfa0adbe3100027aeebe8c2fb0092
Soft Drop
Student Financials - 94c8dd6236a21000145b57d02575002
Student Payment Plans
Student Privacy 63107a3e92a4100016198ed4aebe173
Settings
Student Records 5f65e7293d2c10000ff80c04ef0e8231
(Workfeed Category)
Student Records 75ddcf3c56fb100029744f95242137d1
(Notification Category)
Student Recruiting 5f65e7293d2c10000eba234afd4781ff
Student Recruiting - 3425f92a809f10001d92b763e4a4301e
Marketing
Student Recruiting - 10dc118f64ac1000177e79cd6d7a009f
Transactional
Student Recruiting 5f65e7293d2c10000ec7b2261a448204
Event Invitations
Student Recruiting 3fc6ea8ed103100024079074ae3d0024
Events: Transactional
Supplier Contract da13aa757448100013770295ebbf0074
Expiration
Supplier Contract 50693554b71d100025dd9465898a002
Renewals
Supplier Invoice b17763e65f1a10000d9358d0b53200f3

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 208

Sub Type WID


Surveys e6c9d635b8f2100037f66d1e5c280bda
System Monitor 83bcb1d27fb0100011c9a0b898ae000d
Notifications
Talent Pool Notifications 72d49a1365b810000f05570487bb18ef
Tasks (Workfeed 843b80610065426ab6205a1e815e5d3
Category)
Tasks (Notification c1b1c0d7c622100009c995e7ae9200f6
Category)
Third-Party Payroll c885344368a710001481838fde952244
Errors
Time Off (Workfeed 20c5bfcdc45c42eea031a8ed67a79368
Category)
Time Off (Notification 82ab74b4ae6f10000dbb9350cce20106
Category)
To-Dos (Workfeed c9da9ef2fc79486799f1770c3d4e8f32
Category)
To-Dos (Notification 82ab74b4ae6f100004d2a7a41c7800f7
Category)
Trainee Academic 9160d7e8871210000a451d8967e600f8
Records
Trigger Based 968fe662d959100010771ddaeadf0018
Notification Category
UK Pensions Auto 4fbf629a6bec10000947e06c7df60015
Enrolment
Unread c4a3ace8c553100003d6c843d3f93290
Unsubscribe from all 5bc010319cb8100004563f9560be002b
emails
Voluntary Self- 084541a1480510000a50de20184c00a
Identification of
Disability
Webhook Service Steps 730df0ddf2e110000dc5c223100700f9
Workbook Access 38390a5ef33810001debd3bc0fad0076
Additions
Workbook Access aadf8f959752100009566ad72cbd0023
Removals
Workbook Comments 371d2412aae1100065654be42613000
Workbook 38390a5ef33810001e5fb805bc490089
Conversations
Workbook Import 38390a5ef33810001e56cd879ac60086
Failures

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 209

Sub Type WID


Workbook Import 38390a5ef33810001e47784f48130083
Successes
Workbook Live Data 88ca3dc3b0991000069a1a35c7f81252
Scheduled Updates
Workbook Notify If 93ebefd14c55100026e520b0cd2c0103
Function Notifications
Workbook Tasks 93ebefd14c55100026de814208670101
Workday 3adc355ae75510000fc90421964a00f0
Benchmarking:
Compensation
Workday Usage Metric 68485a80be4310001576b00a3ba112d
Email
Worker cc7f892a924a100009c9501e8c0e000b
Communications
Workflow a407ce54494510000f0c3bb6728000f7
Workpet Registration e6f2b6130636100003d3889f617b017f
Notification

Notification Channel WIDs

Channel WID
Apple Push Notification 13f130bff894460cb83ca156ec0efa62
Caddie Talk c90078aab04710003605957aa5ad000
Daily Digest Email 5873db5601a110000801fafffabe0014
Disabled 0704d6b35914100006b6f0689578001c
Email 214f18241d5f10000a384f905edf001c
Google Actions c90078aab04710001d83e082a734000
Google Cloud 592bf2a45f31100005d5f6ad738e001b
Messaging
Immediate Email 9617f74221f748ee8014fd5f73128b2d
Mobile Push Notification 214f18241d5f10000a441104813b001e
My Tasks 04462b24e11f4479ba9a02af11147a21
Pop-up notification 592bf2a45f31100005dffc944ec0001d
Slack 99481547e979100007e92d4746b2001
SMS 1645dcb55d6710001bf6f5e034f601fb
Webhooks ac0b7bfdaf3210000cc63c3ac2a70008

Notification Delivery Frequency WIDs

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 210

Frequency Workday ID (WID)


Immediately d48c61128dfe1000062e2c013b4e0017
Mute 5b0c4f689b6310000eace355122e004e
Daily d48c61128dfe1000062a90478d390015

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but it appears that Check these:


the data didn't load.
• Check the status of the event. If it’s still in
progress, consider mass canceling all in-
progress Create Workday Account events,
making any needed changes to the EIB
(Example: Removing any steps from the Create
Workday Account business process definition
that prevent it from completing, or adding
condition rules to the steps to skip them) and
then rerunning the EIB.
• Verify that you ran the EIB in live mode and not
validate only mode.
• Check the EIB input file and verify that you
properly populated the Reference ID type and
Reference ID value for the user.

EIB issues one of these errors: You can't create a Workday account until there's a
valid worker record. If there's a valid worker, then
• Validation error occurred. Employee Reference
verify that you’ve entered the correct value and
Integration ID does not exist!"
Reference ID type for the worker, in the EIB input
• Validation error occurred. Contingent Worker file.
Reference Integration ID does not exist!"
If the worker ID is numeric and starts with zeros,
the leading zeros might be removed. You can fix
this by changing the formatting of the column to text
in the EIB input file.

EIB issues an error like this: This indicates that there’s already a Workday
Account for the worker. If you’re attempting to add a
Validation error occurred. A Workday Account
Workday Account for a worker who already has an
already exists for referenced Worker.
account, consider:
• Use Update Workday Account to modify the
existing account, instead of this EIB.
• If you haven't accessed the existing Workday
account for the worker, then you could rescind it
and use this EIB to add the desired account.

EIB issues this error: This indicates that there’s already an account with
the same username. You can run the All Workday
Validation error occurred. User name already taken,
Accounts report to find the account.
please choose another one.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 211

Issue Cause and Solution

When loading recruiting agency users with the Check the items listed in the error. Also verify that
Generate Random Password option, you receive the EIB is using the latest web service version.
this error: This is necessary as you need v35.0 or higher to
ensure you have the fix delivered for this issue. If
Validation error occurred. If
you haven't verified the web service version you’re
Generate_Random_Password is true, the user
using, create a new EIB, which will uptake the latest
must have an email address on file, the tenant must
version.
be set up to send security emails, and the user
cannot use delegated authentication.

EIB issues this error when attempting to create a You can't create Workday accounts for former
Workday account for a former worker: workers with the Add Workday Account web
service. Former Workers shouldn't sign into
The entered information does not meet
Workday. Terminees can sign in, but former
the restrictions defined for this field.
workers can't.
(Non_Worker_Reference).

The users aren’t receiving an email notification for • Review the EIB input file and verify that
their new account. Generate Random Password = Y. Set this to Y
to trigger an email notification.
• Access the Edit Tenant Setup – Security task.
Verify that you’ve enabled the Enable Security
Emails option, and that you have set it
appropriately to send the email to home or work.
• Verify that the worker or nonworker has an email
configured in their profile.
• Ask users to check if the email notifications are
in their SPAM folder.

You selected the Generate Random Password Randomly generated passwords expire the same
option and are concerned the temporary password way as any other passwords. The Maximum
will expire before users can reset it. Password Age in Days field on the Maintain
Password Rules task or the Maintain Payment
Card Industry Password Rules task controls
password expiration. You can check that field to
determine how many days the user has to reset
their temporary password.

Unable to launch the EIB This is most likely security-related.


Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and have access to the Workday
Accounts security domain in the System functional
area.

Business Processes
Create Workday Account.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only adds new Workday accounts. To edit existing Workday accounts, use the Update Workday
Account EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 212

If you need to back out business process events that are in-progress, you can run the Mass Cancel
Business Processes task (secured to the Business Process Administrator domain in the System
functional area). You can enter Create Workday Account on the Business Process Types prompt and
enter the date range that corresponds to when you ran the EIB.
If you’ve uploaded incorrect entries, consider:
• If the user hasn't yet accessed the account, you can run the Mass Rescind Business Processes
task (secured to the Business Process Administrator domain in the System functional area) to remove
it. Enter Create Workday Account on the Business Process Types prompt and enter the date range
that corresponds to when you ran the EIB.
• If the user has already accessed the account, you can still run the Mass Rescind Business
Processes task, but it won’t fully rescind it. This will disable the account. You can then use the Update
Workday Account EIB instead to modify the existing account to meet your needs.
For reference documentation for all web services including Add Workday Account, see Operation
Directory.

Sample EIB Input File


Add_Workday_Account-WD35

Concept: Add Workplace Test EIB

Background
You can use the Add Workplace EIB to load a worker's workplace health and safety tests, including the
test type and results. If you want to load a worker's vaccine events, including their vaccine status, type, and
manufacturer, you can use the Add Vaccination EIB instead.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Add Workplace Test.

EIB Input File Guidelines

Security Configuration Guidelines • Verify you have the correct security


configuration.
• You must have access to the Add Workplace
Test business process type in the Workplace
Test Tracking functional area to run this EIB.
• You must have access to the Person Data:
Workplace Testing domain in the Workplace
Test Tracking functional area to view
the workplace test data for this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value
for each workplace test. If you load multiple
workplace tests for the same person, the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 213

spreadsheet key value still needs to be unique


for each entry.
• Person: Specify the reference ID of the person.
Change the reference ID value in cell C4 from
Academic_Affiliate_ID to Employee_ID.
• Workplace Test Type: Example: COVID-19.
To find the reference ID value, access the
View Reference IDs report and search for the
Workplace Test Type business object.
• Workplace Test Result: Examples: Negative,
Positive. To find the reference ID value, access
the View Reference IDs report and search for
the Workplace Test Result business object.
• Workplace Test Result Date: Use YYYY-MM-
DD format.
Consider creating a custom report from the
Workplace Tests report data source to:
• View the existing workplace testing information
for workers, or
• Verify that the EIB successfully loaded the
workplace testing information.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it displays Check these:


that the data wasn’t loaded.
• Check the status of the event. If it’s still in
progress, consider mass canceling all in-
progress events, making any needed changes
to the EIB (Example: Removing any steps from
the business process definition that prevent it
from completing, or adding condition rules to the
steps to skip them) and then rerunning the EIB.
• Verify you have the correct security
configuration. Ensure that you are in the
relevant security group and have access to
these domains and business processes in
the Workplace Test Tracking functional area:
• Add Workplace Test
• Person Data: Workplace Testing

Unable to attach a file, such as an image of a test The EIB doesn't support attaching files. If you need
result, through the web service to attach files, you need to submit the request using
the SOAP API instead of using EIB.

Business Processes
Add Workplace Test.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only adds workplace tests. You can’t update or delete existing test entries.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 214

If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind. Alternatively, you can enter Add Workplace Test on the Business Process Types prompt and
enter the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Add Workplace Test, see Operation Directory.

Sample EIB Input File


Add_Workplace_Test-V37

Concept: Assign Members to Custom Organization EIB

Background
You can use this EIB to assign or unassign workers as members of a custom organization. The custom
organization type must have this configuration on the Maintain Organization Types report (secured to the
Set Up: Organizations domain in the Organizations and Roles functional area) in Workday:
• Allow Reorganization Tasks = Yes
• Position Assignment Unique = No
If the custom organization type doesn't have this configuration on the Maintain Organization Types report
in Workday, the EIB will fail. The EIB needs to use reorganization tasks to assign and unassign members
to custom organizations. We recommend using the Change Organization Assignments EIB for custom
organization types that don't have this configuration.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


There are similar EIBs that you can use to assign or unassign workers as members of organizations.
Consider these options as you determine what works best for you:
• Assign Organization: You can also use this EIB to assign organizations to worker positions, however we
recommend that you use the Change Organization Assignments EIB instead.
• Change Organization Assignments: We recommend that you use this EIB to assign members to
organizations.
• Import Assign Matrix Organization: You can use this EIB to assign members to matrix organizations.
• Import Remove Matrix Organization: You can use this EIB to remove members from matrix
organizations.
• Move Workers by Organization: You can use this EIB to move workers to different organization types.
The equivalent task in Workday also depends on your configuration. Examples of equivalent Workday
tasks that enable you to mass-assign organizations to workers include:
• Move Workers (Supervisory)
• Move Workers (By Organization)
If you’re performing a reorganization, you might also consider reviewing the Org Studio and Mass Actions
functionality.

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 215

• Spreadsheet Key: Specify the same spreadsheet value (Example: 1) for all the positions that you want
to assign to the organization.
• Assign Members to Custom Organization: Change the value in cell C4 to
Custom_Organization_Reference_ID. You can find a list of reference ID values by running the View
Reference IDs report and searching for the Custom Organization business object or by creating a
custom report using the Custom Organizations report data source.
• Reorganization: You can find the reference ID by accessing the Reorganizations report (secured to
the Set Up: Reorganizations domain in the Organizations and Roles functional area) and then selecting
Integration IDs > View IDs on the related actions of your reorganization.
Note: The effective date of the reorganization date is the effective date of the organization assignment
to the position.
• Positions to Add: Ensure that your EIB uses the latest version of the Assign Members to Custom
Organization web service. Older versions require that you specify the Workday ID (WID) of the position
in this column. You can find the position id values by creating a custom report using the All Workers
report data source.
• Positions to Remove: You can find the position id values by creating a custom report using the All
Workers report data source.

Common Issues and Errors

Issue Cause and Solution

The EIB load is taking a long time to process. This can occur if you’re assigning more than 100
positions to an organization. Consider grouping
position assignments together into 1 spreadsheet
key.
Ensure that your EIB is using the latest version of
the Assign Members to Custom Organization web
service. If you're unsure which version your EIB
uses, consider creating a new EIB to uptake the
latest version.

The EIB completes successfully, but when checking This can occur if your EIB uses an old
the assignments, some positions aren’t assigned to reorganization date. Ensure that the effective
the custom organization. date of reorganization events to assign workers or
move retirees is after the hire or transfer date of
all relevant workers in the affected organizations.
Workers who haven't been hired or transferred as
of the reorganization effective date can't be moved
as part of the reorganization.
See: Concept: Reorganizations .

The EIB issues these errors: The custom organization type must have this
configuration on the Maintain Organization Types
• The entered Organization must be a custom
report in Workday:
organization whose organization type is
configured with options: ‘Allow Organization • Allow Reorganization Tasks = Yes
Tasks’ = Yes and ‘Position Assignment Unique’ • Position Assignment Unique = No
= No.
You can check the custom organization type
• The entered information does not meet
configuration by:
the restrictions defined for this field.
(Assign_Members_to_Custom_Organization_Reference).
1. Accessing the Maintain Organization Types
report.
2. Navigating to the Custom tab.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 216

Issue Cause and Solution


3. Filtering the grid for these values:
• Allow Reorganization Tasks = Yes
• Position Assignment Unique = No
We recommend using the Change Organization
Assignments EIB for custom organization types that
don't have this configuration.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to assign or unassign workers as members of a custom organization.
You can't rescind this EIB. If you upload incorrect entries, you can remove them by populating the
Positions to Remove column on the EIB input file and rerunning the EIB.
For reference documentation for all web services including Assign Members to Custom Organization, see
Operation Directory.

Sample EIB Input File


Assign_Members_to_Custom_Organization-v38_0

Concept: Change Business Title EIB

Background
You can use this EIB to update a business title for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Change Business Title.

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Spreadsheet Key: (Required) Specify a unique value for each business title change
• Worker: (Required) If you want to specify values for employees, you need to change the reference ID
type in cell C4 from Contingent_Worker_ID to Employee_ID.
• Job: If the worker has two or more jobs, you must populate the position id in this field.
• Event Effective Date: (Required) Specify the effective date of the business title change. Use YYYY-
MM-DD format.
• Proposed Business Title: (Required) Specify the new business title.

Common Issues and Errors

Issue Cause and Solution

Although the title change is successfully updated, it This might happen you if you use an EIB that has a
isn’t listed in the worker history. web service version of v30.1 or older.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 217

Issue Cause and Solution


Workday recommends using the latest web service
version for your EIB. You can check the version of
your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check the
Version field to verify you’re using the latest
web service version.
3. If you're using an older web service version, you
can create a new EIB to get the latest version.

EIB issues an error like this: Change cell C4 to Employee_ID in the EIB input
file.
• Validation error occurred. Invalid ID value.
'21001' isn’t a valid ID value for type =
'Contingent_Worker_ID'

Unable to launch the EIB This is most likely security-related.


Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and have access to the Title Change
business process type in the Staffing functional
area.

EIB issues errors like this: This occurs if you change a title for a worker
with multiple positions but don't specify the job.
• Enter an Effective Date that is either on or
To resolve this issue, edit the EIB input file and
before the date the position was last vacated or
populate the Job field with the position id for the
on or after the date the position was last filled.
relevant position.
• Job is required for workers with more than 1
position.

Business Processes
Title Change.

Use Cases and Guidelines for Recovering from a Bad Load


If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind. Alternatively, you can enter Title Change in the Business Process Types prompt and enter the
date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Change Business Title, see Operation
Directory.

Sample EIB Input File


Change_Business_Title-WD34

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 218

Concept: Change Emergency Contacts EIB

Background
You can use this EIB to add or update emergency contacts. You can't delete primary contacts with this
EIB, but you can use the EIB to replace them. If you need to remove a primary emergency contact, you
can only do this by using the Clear Emergency Contact task in Workday.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Emergency Contacts for Worker.
• On the related actions menu of the worker profile, select Personal Data > Change Emergency
Contacts.

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for each worker.
• Person: Specify the reference ID of the person. Change the reference ID value in cell C4 from
Academic_Affiliate_ID to Employee_ID.
• Replace All: Specify Y if you want to replace all the worker’s emergency contacts with the information
provided in the input file.
• If you want to remove portions of the contact information for an emergency contact, you can specify
Y in the Delete field of the relevant section of the input file.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but you don’t find Check these:
the changes you loaded.
• Check if any row is missing a Row ID value. If
a row ID is missing, Workday ignores any
information you provide in that section.
• Check if the emergency contact is linked to a
dependent or beneficiary. If the emergency
contact is linked to a dependent or beneficiary,
you can't update it with this EIB. If you want
to remove the contact, you can use the Clear
Emergency Contact task (secured to the
Change Emergency Contacts business process
type in the Contact Information functional area).
• Ensure that the business process isn’t still in
progress. Check the Business Processes tab
on the EIB integration event to verify if the EIB
successfully completes.

Unable to launch EIB This is most likely security-related.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 219

Issue Cause and Solution


Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and have access to the Change
Emergency Contacts business process type in the
Contact Information functional area.

Business Processes
Change Emergency Contacts.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add new emergency contacts or update existing emergency contacts.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if
the event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both
of these tasks are secured to the Business Process Administrator domain in the System functional area.
You can then select Business Processes Loaded by EIB to find the integration event that you want
to cancel or rescind. Alternatively, you can enter Change Emergency Contacts in the Business Process
Types prompt and enter the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Change Emergency Contacts, see Operation
Directory.

Sample EIB Input File


Change_Emergency_Contacts-WD31

Concept: Change Government IDs EIB

Background
You can use this EIB to add, update, or delete government IDs for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Personal Data > Edit Government IDs from the related actions of the worker's profile.

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for each person. Consider creating a custom report with the
Indexed All Workers data source to get the reference IDs and other information for the workers.
• Replace All: Specify Y if you want to replace all the worker’s ID information with the information
provided in the input file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 220

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but entries don't Check these:


load or update.
• Check if any row is missing a Row ID value. If
a row ID is missing, Workday ignores any
information you provide in that section.
• Ensure that the business process isn’t still in
progress. Check the Business Processes tab
on the EIB integration event to verify if the EIB
successfully completes.

Workday displays this error when you delete IDs: This occurs when the Replace All field isn’t
Processing error occurred. Duplicate insert within populated. To delete entries, set the field to N.
same transaction: ADD of relationship…

Business Processes
Edit Government IDs.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add, update, or delete government IDs for a worker.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind. Alternatively, you can enter Edit Government IDs in the Business Process Types prompt and
enter the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Change Government IDs, see Operation
Directory.

Sample EIB Input File


Change_Government_IDs-v39

Concept: Change Home Contact Information EIB

Background
You can use this EIB to add, update, or remove home contact information for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See View Dependents > Change Home Contact Information from the related actions of the worker's
profile.
There are also similar EIBs that you can use to update contact information. Consider these options as you
determine what works best for you:
• Change Emergency Contacts: You can use this EIB to update emergency contact information for a
person.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 221

• Change Work Contact Information: You can use this EIB to add or update work contact information for a
person.

EIB Input File Guidelines


We recommend that you:
• Review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which provides a general
overview for populating EIB files.
• Test this EIB in a nonproduction tenant first to avoid inadvertently removing any contact information that
you intended to keep.
• Consider creating a custom report with the All Active and Terminated Workers data source to get the
reference IDs and other information for the workers.
Additionally, as you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for each person.
• Person: If you want to specify values for employees, you need to change the reference ID type in cell
C4 from Contingent_Worker_ID to Employee_ID.
• Country_Code: (Required for phone numbers) You can find a list of reference ID values by running the
View Reference IDs report and searching for the Country Phone Code business object.
• Complete Phone Number: If you’ve configured phone validations in the Edit Tenant Setup – Global
task, then this field should contain numbers only. Don't include the country code in this field.
• Replace All: Specify Y if you want to replace all current entries in Workday (Example: all email
address contact entries). If you want to remove an entry and not replace it, specify: Y for Replace All, Y
for Delete and then specify the reference ID for the item you want to remove.

Common Issues and Errors

Issue Cause and Solution

There’s no option to launch the integration. This is most likely security-related.


Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and have access to the Home
Contact Change business process type in the
Contact Information functional area.

The EIB fails with errors such as: These types of errors usually occur when the EIB
can't identify the country.
• Address Line 1 is not valid for this Country.
• Postal Code is not a valid address component • Check for any missing Row ID values. Ensure
for certain countries. that you specify a row ID in the section of the
• Municipality is not a valid address component input file where you populate the country.
for certain countries. • Ensure that you populate the country value.

Receive this error when attempting to delete an Ensure that you:


email: E1: Email Reference is required.
• Don't specify the existing email address (you
don't need this when you delete an email).
• Specify the email ID you wanted to delete.

EIB fails with Error: This can occur if:


Validation error occurred. Contact Change Events • There’s an existing contact event for the worker
that change an Address must be done in order. To with an effective date that's after the date
submit an event that changes an address with an specified in the EIB input file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 222

Issue Cause and Solution


earlier effective date, you must rescind any Contact • The EIB input file doesn't specify an event
Change Events that change an address with a later effective date.
effective date.
To resolve this:
1. Verify that you've populated the Event Effective
Date in the EIB input file.
2. If there are still issues, check the worker
history for one of the workers where the error
is occurring and verify that there are no contact
dates with an effective date after the date you
specify in the EIB input file.

Business Processes
Home Contact Change.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add, update, and delete home contact information for a worker.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind. Alternatively, you can enter Home Contact Change in the Business Process Types prompt
and enter the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Change Home Contact Information, see
Operation Directory.

Sample EIB Input Files


Change_Home_Contact_Information-WD32

Concept: Change Licenses EIB

Background
You can use this EIB to add, update, or delete licenses for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Personal Data -> Edit Licenses on the related actions menu of the worker's profile.
For similar EIBs, see:
• Change Other IDs
• Change Government IDs

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 223

• Spreadsheet Key: Specify a unique value for each person.


• Person: Change the reference id type in cell C4 from Academic_Affiliate_ID to Employee_ID.
• Replace All: If you want to replace all of the worker’s existing licenses with the values in the EIB input
file, specify Y in this field.
• Row ID: Specify 1 for each entry, unless you have multiple row entries for the same person. For
multiple row entries, increment the row ID sequentially.
• Example: If a person has 2 row entries, specify 1 for the first row ID and 2 for the second row ID.
• Delete: If you want to delete a specific license for a worker, specify Y in this field.
• ID: Specify the license ID value.
• ID Type: Change the reference id type in cell J4 fromI9_License_Identifier_Type_Code to
License_ID_Type_ID. You can find a list of reference ID values by running the Integration IDs report
and searching for the License ID Type business object.
• License ID Shared: If you want to update or delete a license, specify the reference id of the license in
this field.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but the licenses This can occur if the information in the EIB input file
weren’t changed. doesn't align with the steps in your Edit Licenses
business process definition in Workday.
1. Run the Mass Cancel Business Processes
task (secured to the Business Process
Administrator domain in the System functional
area) to cancel any in progress Edit Licenses
events.
2. Update the information in your EIB input file
to align with the steps in your Edit Licenses
business process definition.
3. (Optional) In Workday, consider updating the
business process definition by:
• Marking any unnecessary steps as optional
and then setting the processing instructions
in the EIB input file to Skip Processing for
optional steps.
• Adding condition rules on steps to skip them
in the business process if needed. Example:
Add a condition rule where External Load =
N.
4. Rerun the EIB.
You can use the Business Processes tab in
the EIB integration event to view and identify the
business processes that are still in progress.

The EIB completes successfully, but there’s no Edit The EIB automatically detects duplicates if the
License event. Replace All field is set to N.
If you attempt to add or update a license to
match an existing license in Workday, the EIB
automatically ignores the entry as a duplicate.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 224

Issue Cause and Solution

When attempting to remove a license, the EIB fails Ensure that the Replace All field in the EIB input
with an error like this: file is set to N.
Processing error occurred. Duplicate
insert within same transaction: ADD of
relationship=Global_Identifier_Event.change_to_Global_Identifier--
IS (3$2407), target=464$621 within
instance=4645$38 with changeInfo=Chg:
70368744167663 Txn: 4294957295 entryDate:
2020-04-09T16:44:17.803 XpressO Call
Stack Trace= 83$12:464$621, 371$13198,
82$22940:464$621, 54$29945:4645$38,
371$48428, 82$22378:4645$38,
54$29944:4645$38, 371$48427,
82$22377:4645$38, 54$29941:4645$38,
371$48422, 82$22375:4645$38, 2996$3438

Business Processes
Edit Licenses.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add, update, or delete licenses for a worker.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind. Alternatively, you can enter Edit Licenses in the Business Process Types prompt and enter
the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Change Licenses, see Operation Directory.

Sample EIB Input File


Change_Licenses-WD32

Concept: Change Other IDs EIB

Background
You can use this EIB to add, update, or remove Other IDs for a person.
You can use Other IDs to store ID information from a third-party system for a worker.
This EIB is intended for static IDs. Avoid storing dynamic values that change frequently as this will cause
performance degradation over time.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Edit IDs.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 225

• On the related actions menu of the worker profile, select Personal Data > Edit Other IDs.
There are also similar EIBs that you can use to update IDs. Consider these options as you determine what
works best for you:
• Change Government IDs: You can use this EIB to update government IDs and national IDs for a
person.
• Change Licenses: You can use this EIB to update licenses for a person.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Edit Other IDs
business process type in the Personal Data
functional area to run this EIB.
• If you want to generate the spreadsheet with
data, you must also access to the Person
Data: ID Information domain in the Personal
Data functional area.

Guidelines for Modifying the EIB Template You can modify your EIB template to change the
person type.
1. From related actions of your EIB, select
Template Model > View.
a. Select All in the left window pane.
b. Select the magnifying glass next to Person.
c. On the related actions menu of the
magnifying glass, select Template
Model Column > Edit Details.
d. On the Reference ID Type field, specify the
person type you would like to use for the EIB.
• Example: Employee ID.
See Customize EIB Spreadsheet Template on page
46.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 226

To prevent data loss, we recommend that


you generate your spreadsheet with data for
the Change Other IDs EIB. See: Example:
Generate EIB Spreadsheet Template with Data on
page 62.
As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each person.
• Person: Specify the reference ID of the person
whose other ID that you’re updating. Ensure that
you specify the correct reference ID type in cell
C4 of the EIB input file.
• Example: For employees, specify
Employee_ID as the reference ID type in cell
C4 of the EIB input file.
• Replace All: Consider:
• If you don’t want to replace all existing other
IDs for the person, set this field to N. The
default value is Y.
• If you want to replace all existing other ID
values for the person, then set this field to Y
and populate the new values in the Custom
ID Data section.
• If you want to remove all existing other ID
values for the person and not add any new
IDs, then set this field to Y and leave the
Custom ID Data section blank.
• Row ID: Specify a unique value for each ID that
you’re assigning to a person.
• Delete: Specify Y if you want to remove an ID.
If you want to delete an ID (but not all IDs), you
must also set the Replace All field to N. If you
want to remove all existing other ID values for
the person and not add any new IDs, then set
the Replace All field to Y and leave the Custom
ID Data section blank.
• Custom ID: Leave blank.
• ID: Specify the value for the ID that you’re
adding or updating (if you're removing an ID,
leave blank).
• ID Type: Specify the reference ID value of
the ID type. You can find a list of reference ID
values by running the View Reference IDs
report and searching for the Custom ID Type
business object.
• Organization ID: (Optional) Specify a reference
ID of the organization that issued the ID.
• Custom Description: (Optional) You can use
this field to add a description of the ID.
• Custom ID Shared: If you're updating or
removing an ID, this field is required. You can
create a custom report to get the values you

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 227

need for this field in the spreadsheet. Consider


creating a custom report with the Indexed All
Workers data source to get the custom shared
IDs.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but there are no Check these:


IDs added or updated.
• Check if there are any Edit Other IDs business
process events that are still in progress. This
can happen if you don’t specify automatic
processing for the processing instructions in the
EIB input file.
• Ensure that you’ve specified a row ID for each
row in the EIB input file.
• Ensure that you haven't run the EIB in validate-
only mode.

When deleting IDs, this error is issued: This can happen if you leave the Replace All field
blank.
A processing error occurred. Duplicate insert within
same transaction: ADD of relationship. Ensure that you populate the Replace All field with
either Y or N when you delete entries.

There are duplicate IDs after loading the EIB input This can happen if you update existing IDs but
file. don’t specify the reference ID value of the IDs in the
Custom ID Shared field in the EIB input file.
To fix this problem:
1. Remove the duplicate entries.
2. Update the EIB input file to include the reference
ID values.
3. Rerun the EIB.

EIB issues this error: This can happen if you attempt to remove an ID
but have incorrectly populated the Custom ID Data
Validation error occurred. Custom Identifier with
section of the EIB input file.
reference is marked for deletion. Custom ID Data
shouldn’t be included. To fix the problem:
1. Populate the reference ID value in the Custom
ID Shared field.
2. Leave the other fields in the Custom ID Data
section blank.
3. Rerun the EIB.

EIB issues this error: This EIB doesn’t support all person types.
The entered information doesn’t meet Ensure that you populate the Person field with a
the restrictions defined for this field. reference ID type that this EIB supports. Examples:
(Person_Reference) Employee_ID or Contingent_Worker_ID.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 228

Issue Cause and Solution

Error when generating template with datE Ensure that you have access to the Person Data:
ID Information domain in the Personal Data
functional area.

Unable to launch the EIB. This is most likely security-related.


Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Edit Other IDs business
process type in the Personal Data functional area.

EIB performs slowly. This EIB is intended for static IDs. Avoid storing
dynamic values that change frequently as this will
cause performance degradation over time.

Business Processes
Edit Other IDs.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add, update, or delete other ID values for a person. If you’ve uploaded incorrect
entries, you can:
• Option 1: Use either the Mass Cancel Business Processes task (if the event is still in progress)
or Mass Rescind Business Processes task (if the event is complete). Both of these tasks are
secured to the Business Process Administrator domain in the System functional area. You can then
select Business Processes Loaded by EIB to find the integration event that you want to cancel or
rescind. Alternatively, you can enter Edit Other IDs in the Business Process Types prompt and enter
the date range that corresponds to when you ran the EIB.
• Option 2: You can delete the IDs using the Delete field in the EIB input file.
For reference documentation for all web services including Change Other IDs, see Operation Directory.

Sample EIB Input File


Change_Other_IDs-WD35

Concept: Change Work Contact Information EIB

Background
You can use this EIB to add, update, or remove work contact information.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Personal Data > Change Work Contact Information from the related actions of the worker's
profile.
There are also similar EIBs that you can use to update contact information. Consider these options as you
determine what works best for you:
• Change Home Contact Information: You can use this EIB to add or update home contact information.
• Change Emergency Contacts: You can use this EIB to update emergency contact information.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 229

• Change Institutional Contact Information: You can use this EIB to add or update institutional contact
information.
• Import Change Work Contact Information: You can use this EIB to upload large amounts of contact
information (Example: 1000 or more entries).

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for each person.
• Person: If you want to specify values for employees, you need to change the reference ID type in cell
C4 from Contingent_Worker_ID to Employee_ID.
• Country_Code: (Required for phone numbers) You can find a list of reference ID values by running the
View Reference IDs report and searching for the Country Phone Code business object.
• Complete Phone Number: If you’ve configured phone validations in the Edit Tenant Setup – Global
task, then this field should contain numbers only. Don't include the country code in this field.
• If you want to update or remove contact information, consider creating a custom report with the All
Active and Terminated Workers data source to help find information to populate the EIB input file.
• If you want to remove contact information entries, consider these 2 approaches. We recommend that
you test this EIB in a nonproduction tenant first to avoid inadvertently removing any contact information
that you intended to keep:
1. If you want to remove an entry and don’t want to replace it with another entry:
• Set the Replace all field to N.
• Set the Delete field to Y.
• Specify the reference ID for the item that you want to remove.
2. If you want to remove all the entries (such as all entries for email) and replace them with another
entry, set the Replace all field to Y. In this scenario, you don't need to specify the reference IDs of
items you want to delete.

Common Issues and Errors

Issue Cause and Solution

There’s no option to launch the integration. This is most likely security-related.


Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Work Contact Change
business process type in the Contact Information
functional area.

Receive this error when attempting to delete an Ensure that you specify the email ID that you
email E1: Email Reference is required when you want to delete. You don't need to specify the
delete an email address. existing email address, just the email ID.

EIB fails with error: This can occur if either:


Validation error occurred. Contact Change Events • There’s an existing contact event for the worker
that change an Address must be done in order. To with an effective date that is after the date
submit an event that changes an address with an specified in the EIB input file.
earlier effective date, you must rescind any Contact • There's no event effective date specified in the
EIB input file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 230

Issue Cause and Solution


Change Events that change an address with a later To resolve this:
effective date.
• Populate the Event Effective Date field in the
EIB input file.
• If there are still issues, check the worker
history for one of the workers where the error is
occurring. Verify that there are no contact dates
with an effective date that's after the date you
specify in the EIB input file

EIB fails with error: This can occur if the worker shares their home
address with a dependent and the dependents
Validation error occurred. Address Reference must
have been removed. We recommend manually
match an existing (and not deleted) address in use
updating the address.
by the person subject of this request.

Business Processes
Work Contact Change.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add, update, or remove work contact information.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind.
For reference documentation for all web services including Change Work Contact Information, see
Operation Directory.

Sample EIB Input File


Change_Work_Contact_Information-v38

Concept: Create Position EIB

Background
You can use this EIB to create a position for a supervisory organization using the position
management staffing model.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Position.
There are also similar EIBs that you can use for positions. Consider these options as you determine what
works best for you:
• Change Job: You can use this EIB to perform a job change on an employee or contingent worker.
• Create Job Requisition: You can use this EIB to create new job requisitions for a position.
• Edit Position: You can use this EIB to edit a filled position.
• Hire Employee: You can use this EIB to hire a pre-hire (new or existing) into an employee position.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 231

• Import Create Position: You can use this EIB to load large volumes of positions (Example: 1000 or
more). If you need to load large volumes of positions, consider testing in your sandbox tenant to
determine which EIB performs better for your use case.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Create Position
business process type in the Staffing
functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• You can find it helpful to start by manually
creating a position similar to the type of positions
you want to load using the EIB. By manually
creating a position, you can verify which fields
Workday requires. This method can also be
helpful when populating reference ID values
in the input file. You can view the reference ID
values from the related actions of the position
that you manually created.
• Make certain that the steps in the Create
Position business process definition align to
what you’re populating in the EIB input file.
Example: if the Create Position business
process includes an Assign Pay Group step,
then you need to complete 1 of these actions:
• If you wish to update the pay group field, then
populate the pay group information in the EIB
input file.
• If you don’t want to update the pay group
field, then you can add a condition rule to
skip the step in the Create Position business
process definition.
• Example: you can add a condition rule with N
for External Load.
• Or you can edit the Create Position business
process definition and mark the step as

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 232

Optional. Then in the EIB input file, set the


processing instructions to Skip Processing
when Step is marked optional.
• Example: if you're populating Organization
in the EIB input file, then the Create
Position business process definition
needs to have a Change Organization
Assignments step.
• You’ll need to go through the above check points
for each step in the Create Position business
process definition. If the business process
definition and the EIB input file don't align,
Workday sometimes doesn't load information
and the Create Position event displays as in
progress, after you complete the EIB load.
• Overview worksheet in the EIB Input File
1. For sections where you want to load data and
have it automatically processed by the EIB:
• Set processing instructions to Automatic
Processing.
• Populate all required data in the
corresponding worksheets.
2. For sections that you aren’t using:
• Set processing instructions to Skip
Processing when Step is marked
Optional.
• Edit the Create Position business process
definition and you can either mark the
corresponding step as Optional or else
add a condition rule to the step such as
External Load is not blank.
3. Notifications: Note that the EIB doesn't
submit notifications when using processing
instructions Automatic Processing. Also, the
EIB skips To Do steps, Approval, and review
steps.
• Create Position worksheet in the EIB Input File
• Spreadsheet Key: Specify a unique value for
each position that you’re creating.
• Supervisory Organization (Required):
Enter the reference ID for the supervisory
organization. To find the values, you can run
the View Reference IDs report for business
object Supervisory Organization. Or create
a custom report using a data source such as
Supervisory Organizations.
• Position Request Reason: If you wish to
populate a reason, you can find the reference
ID values by running the View Reference
IDs report for business object General Event
Subcategory. Then filter the business object

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 233

instance column by a value such as create


position to find the relevant values.
• Position ID: Enter a value if you wish to
assign a position ID. If you leave the field
blank, the web service will autoassign a
position ID.
• Job Posting Title (Required): Value used in
the job posting for this position opening.
• Job Description Summary: If left empty, the
value populates from the job profile assuming
a job profile populates in the EIB input
file and that the job profile job description
summary has a value.
• Job Description: If left empty, the value
populates from the job profile assuming a
job profile populates in the EIB input file
and that the job profile job description has a
value. (Optional) You can use html markup if
desired.
• Critical Job: This field is a boolean value, so
select Y or N from the drop-down menu.
• Difficulty to Fill: To find reference id values,
run the View Reference IDs report for the
business object Difficulty to Fill.
• Enter a separate row for each of these
sections:
• Responsibility
• Work Experience
• Education
• Language
• Competency
• Certification
• Training
• Skill
• Availability Date: Date the job opening
is available. Defaults to current date if left
empty. Use format YYYY-MM-DD
• Earliest Hire Date: Earliest date that a
worker can be hired or contracted into the
opening. Defaults to current date if left blank.
Use format YYYY-MM-DD
• Job Family: To find the reference ID values,
you can run the View Reference IDs report
for business object Job Family. If you use this
field, you’ll need to change the reference ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 234

type (cell BH4) from Job_Family_Group_ID to


Job_Family_ID.
• Job Profile: To find the reference ID values,
you can run the View Reference IDs report
for business object Job Profile.
• Location: To find the reference ID values,
you can run the View Reference IDs report
for business object Location.
• Worker Type: To find the reference ID
values, you can run the Integration IDs report
for business object Worker Type.
• Time Type: To find the reference ID values,
you can run the View Reference IDs report
for business object Position Time Type.
• Position Worker Type: To find the reference
ID values for an employee, run the View
Reference IDs report for business object
Employee Type. To find the reference ID
values for a contingent worker, run the
View Reference IDs report for business
object Contingent Worker Type. Also,
you’ll need to change the value in cell
BM4 to either Employee_Type_ID or
Contingent_Worker_Type_ID depending on
the reference ID value you’re using.
• Edit Assign Organization worksheet in the EIB
Input File
• If you’ve configured the supervisory
organizations to use default organization
values, then those organizations will
automatically default into the position. In
this case, you don't have to populate the
organization in the EIB input file, and you
can skip the organization step in your Create
Position business process. To add additional
organization assignments to the positions,
include both the default organization values
and any additional organizations that you
wish to assign.
• Request Default Compensation worksheet in
the EIB Input File
• Refer to the Example 2 attachment if you
wish to default compensation values for the
position. If you populate a compensation
package that includes plans for bonuses,
allowances, and so on, that the position is
eligible for. It’s not necessary to populate
these plans in the EIB input file. Workday
populates these plans automatically in the
position as noted in FAQ: Compensation
Defaulting.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 235

• Assign Pay Group worksheet in the EIB Input


File
• Refer to the Example 2 attachment for
examples.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it appears Most likely the business process events are still
that the EIB didn't load any data. in Progress because the steps didn’t complete.
This issue is due to the EIB input file and business
process definition being out of alignment. Refer to
instructions in the Tips section on how to get the
business process definition and input file aligned.
To recover, you can run Mass Cancel Business
Processes to cancel the In Progress change job
events. Then correct the problem, and run the EIB
again.
Also, note that there's Business Processes tab
that displays in the EIB integration event, after the
EIB successfully completes. This tab enables you
to view all business process events that the EIB
loaded. From here, you can determine whether the
events completed or are still in progress. You can
take a closer look at any of the job changes from
the related action of the event.

EIB issues an error like this: This issue occurs if there are custom organizations
required for the position. Perform these steps
At least one of the Custom organization types is
to determine which organizations the position
required based on the position assignment details
required:
settings but has no entries.
1. Access the Maintain Organization Types task
2. Go to the Custom tab.
3. Go to column Position Assignment Required
and filter by Value=Yes
Workday displays all custom organization types
required when creating position
For all custom organization types returned in above
list, perform one of these actions:
• Include the organization in the EIB input file
• Edit the supervisory organization for the position
and add the custom organization as a default
organization

Unable to launch the EIB This issue is most likely security-related. When
running the Report View Security for Securable
Item for securable item Create Position (Web
Service), you’ll see that you need access to the
Create Position business process security policy.
To change the security, complete these steps:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 236

Issue Cause and Solution


1. Edit the business process security policy for
Create Position.
2. Access the section for Initiating Action Create
Position (Web Service).
3. Confirm you have access. Ideally you should
have access through an unconstrained security
group so that you can load positions for any
worker.
4. Activate the security change.

Business Processes
Create Position.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add new positions.
If you need to edit the positions, use Edit Position web service.
If you’ve inadvertently uploaded incorrect positions, use Mass Rescind or Mass Cancel. What you use
depends on whether the business process event is complete or is still in progress. You can then select
Business Processes Loaded by EIB to find the integration event that you want to cancel or rescind. Your
other option is to enter Create Position at the Business Process Types prompt and enter the date range
that you ran the EIB.
For reference documentation for all web services including Create Position, see Operation Directory.

Sample EIB Input Files


Create_Position-WD35-Example1
Create_Position-WD35-Example2

Concept: Inactivate Organization EIB

Background
You can use this EIB to inactivate an organization.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Reorganization > Inactivate Organization from the related actions of the organization.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 237

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage:
Organization Update Integration domain in
the Organizations and Roles functional area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• Spreadsheet Key: Use a unique value for
each organization.
• System ID and ID:
• This is an older web service that isn’t yet
using reference IDs. For this reason, you
must specify the Workday ID (WID) of the
organization that you want to inactivate.
Note that the System ID should always
have a value of WD-WID and the ID
contains the Workday ID (WID) for the
organization you’re inactivating.
• You might want to create a custom report
to get a list of the organizations along
with their Workday ID. The data source
that you use for your custom report will
depend on the types of organizations
you’re inactivating. Example: if you’re
inactivating custom organizations, use
data source Custom Organizations. And
if inactivating supervisory organizations,
you would use data source Supervisory
Organizations. There’s also data source
Cost Centers, and so on.
• Keep in Hierarchy: A Y or N value to
indicate whether the organization should
stay within its hierarchy. If you remove the
organization from the hierarchy, it could affect
role-based access if someone has role-based

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 238

access to the superior organization and all


subordinates.
• Organization for Subordinates: If the
organization you’re inactivating has active
subordinate organizations, the EIB moves
subordinates to the superior organization.
If you want them to move to another
organization, specify its Workday ID (WID) in
this field.

Common Issues and Errors

Issue Cause and Solution

The EIB issues these 3 errors: One cause of these errors is specifying the wrong
Workday ID in the input file. If the EIB input
• Organization is inactive as of entered effective
file contains an ID that the integration doesn’t
date so it cannot be inactivated.
recognize, it assumes that the organization must
• Organization has events in progress, so it not be effective yet or is in progress.
cannot be inactivated.
• Organization Reference Integration ID does not
exist!

The EIB issues error: There are multiple causes for this error including:
Organization has events in progress, so it cannot • There are indeed positions associated with
be inactivated. the organization that you’re inactivating. Try to
manually inactivate the organization to confirm
this is an issue.
• It could occur if you specify an older effective
date and made changes to the organization after
that effective date.
• If you don't specify the Workday ID in the input
file, or specify the wrong ID, this error will occur.

Business Processes
Activation.

Use Cases and Guidelines for Recovering from a Bad Load


If you inactivated the wrong organizations, you can mass rescind the business process (the business
process is called Activation), however the role assignments and the superior organization don't get
restored. So, you would need to either manually reassign the superior organization and role assignments,
or else use other web services such as add update organization andassign roles.
You normally can’t make updates using this EIB after the inactivating the organization. So, if you need to
change something, the best bet is to rescind the event and start over.
For reference documentation for all web services including Inactivate Organization, see Operation
Directory.

Sample EIB Input File


Inactivate_Organization-WD30

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 239

Concept: Put Assign User-Based Security Group EIB

Background
You can use this EIB to assign Workday accounts to user-based security groups.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Any information that you submit with this EIB replaces and overwrites the information currently in Workday.
To avoid data loss, include all existing users and any new users you want to add for a security group in
your EIB input file.

Equivalent Workday Task


Task: Assign Users to User-Based Security Group.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
• From the related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the User-Based
Security Group Administration domain in the
System functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• For versions older than v41.2, this EIB can
REPLACE ALL. To avoid issues with the
REPLACE ALL functionality, we recommend to:
• Thoroughly test in a nonproduction
tenant first. And even when testing in a
nonproduction tenant, you must be careful
because if you don't property populate
the EIB input file, you could inadvertently
remove your access from security groups,
and subsequently lose access to some
functionality within the tenant. When you run
an initial test, avoid updating assignments for
a powerful security group such as Security

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 240

Administrator, just in case something goes


wrong.
• Use the Generate spreadsheet with data
option.
• It’s easy to get this EIB mixed up with the
other EIB that assigns security groups to
a user (such as Put User-Based Security
Group Assignments). Before you run the EIB,
check the EIB input file and make certain
you’re running the correct EIB (cell A1 in the
EIB input file, should display Assign User
Based Security Group. Note that Group is
singular whereas it’s plural for the other EIB)
• As you populate these fields in the input file,
consider:
• Spreadsheet Key: Specify a unique value for
each security group specified in the EIB input
file. It's important to properly set this value: if
you assign different spreadsheet key values
for the same security group, the EIB deletes
assignments.
• User-Based Security Group: Enter the
reference id value of the security group. You
can run the View Reference IDs report and
select business object User-Based Security
Group to get a list of security groups and
reference IDs.
• Workday Accounts: List each Workday
account (in a separate row) to assign to the
security group.

Common Issues and Errors

Issue Cause and Solution

After running the EIB, existing user accounts were This functionality is working as expected as the
removed from the security group. EIB removes all existing user assignments from the
security group and replaces the assignments with
the entries in the EIB input file. So be sure that you
list all user accounts (existing accounts and new
accounts you wish to assign) in the EIB input file.

The EIB assigns only the last user account listed in Verify that you’re using the same spreadsheet key
the EIB input file. value for each security group specified in the EIB
input file. Example: All entries for security groupA
use spreadsheet key 1. And all entries for security
group B use spreadsheet key 2

When specifying multiple accounts for a securityVerify that you’re using the correct web service.
group, it fails with message: You should be using web service Put_Assign_User-
Based_Security_Group. Check the EIB input file
<wd:Message>Element Content
and make certain that cell A1 displays Assign
Workday_Account_Reference Singular error Assign
User Based Security Group. (Note thatGroup is
User-Based Security Groups Data</wd:Message>.
singular whereas it’s plural for the other EIB)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 241

Issue Cause and Solution


If not, you might want to create a new EIB to insure
you have the correct web service.

There’s no option to launch the EIB. This issue is most likely security-related. Report
View Security for Securable Items displays that you
need Put access to domain security policy User-
Based Security Group Administration to access the
web service. So you’ll need to:
• Edit the domain security policy for domain User-
Based Security Group Administration.
• Make certain you are in a security group that
has Put access to this domain.
• Activate the security change.

Use Cases and Guidelines for Recovering from a Bad Load


Since the web service doesn’t use a business process, there isn’t an easy way to recover if you load
incorrect entries. An option would be to find another tenant that still has the correct security group
assignments. Then use Generate spreadsheet with data option in that tenant to build an EIB input file to
load to the tenant with the incorrect data.
For reference documentation for all web services including Put Assign User-Based Security Group, see
Operation Directory.

Sample EIB Input File


Put_Assign_User-Based_Security_Group_v44.0

Concept: Put External Disability Self Identification Record EIB

Background
You can use this EIB to add, delete, or edit external disability self-identification records.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
This EIB is designed to load disability information from outside of Workday. Workday treats the information
that you load with this EIB as external data and stores it separately from the information an employee
enters in the Change Self-Identification of Disability task.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 242

• Verify you have the correct security


configuration.
• You must have access to the Worker Self-
Identification of Disability - USA domain in the
Personal Data functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
External Disability Self Identification Record EIB.
See: Example: Generate EIB Spreadsheet
Template with Data on page 62.
• As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value
for each external disability self-identification
record.
• Delete: Set to Y if you wish to delete an entry
(if deleting an entry, populate only 4 fields:
Spreadsheet Key, Delete, External Disability
Self Identification Record and Employee).
• External Disability Self Identification
Record: Populate this field only if removing a
self-identification record. You can find values
by either generating the spreadsheet with
data or by using the View Reference IDs
report and selecting business object External
Disability Self-Identification Record..
• ID: Populate this field in for these scenarios:
• When updating an existing record. You
can find values by either generating the
spreadsheet with data or by using the
View Reference IDs report and selecting
business object External Disability Self-
Identification Record..
• If you’re adding a new entry, you can
populate a value here if you wish. If you
don’t populate a value, the web service
automatically assigns a value for you.
• Employee ID: Enter the id of the employee.
• Disability Status: Enter the reference id for
the Disability Status. To find the reference
id values, run the Integration IDs report and
select business object Self-Identification of
Disability Status..
• Invitation Date: The invitation date for the
External Disability Self-Identification Record.
The format is YYYY-MM-DD. If you wish to

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 243

also include the time, use format YYYY-MM-


DD00:00:00.000.
• Response Date: The response date for the
External Disability Self-Identification Record.
The format is YYYY-MM-DD. If you wish to
also include the time, use format YYYY-MM-
DD00:00:00.000.
To validate the data that you loaded, you might
want to run report Latest Disability Self-Identification
Results for Active Employees.

Common Issues and Errors

Issue Cause and Solution

When using the Generate Spreadsheet with Data This issue will occur if there aren't any entries for
option, it fails with error: external disability self identification. Load at least 1
entry before using the Generate Spreadsheet with
Select a condition rule that matches a business
Data option.
object.

Unable to launch the EIB This issue is most likely security-related. Verify you
have security access for the EIB.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, and delete.
• Since this EIB doesn’t use a business process, there’s no option to rescind or cancel. If you have
inadvertently uploaded incorrect entries, we suggest you reload the entries with correct information. If
you need to restore the original values, you can
• Find another tenant such as a sandbox or an implementation tenant that still has the correct
information.
• Then use Generate Spreadsheet with Data option in that tenant to build an EIB input file to load into
the tenant where information needs corrected.
For reference documentation for all web services including Put External Disability Self Identification
Record, see Operation Directory.

Sample EIB Input File


Put_External_Disability_Self_Identification_Record-WD35

Concept: Put External Form I-9 EIB

Background
You can use this EIB to load a record of an external form I-9 into Workday.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Note: Any attachments that you might want to load with this EIB need to be base-64 encoded. This is
extremely challenging to do in the input file for this EIB. For this reason, consider creating a custom Studio
integration instead.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 244

Equivalent Workday Task


Task: Manage Form I-9 Assignment for Worker.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Put External
Form I-9 business process in the Onboarding
functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• As you populate the EIB input file, consider:
• Processing Instruction: Make certain the
value for this field (in cell C7 of the Overview
tab in the EIB input file) is blank. If it isn't
blank, you'll receive the message You can
not start another Form I-9 until you have
completed your pending/upcoming Form I-9
event when you update Section 3.
• Worker: You’ll likely need to change
the reference ID type in cell D4 from
Contingent_Worker_ID to Employee_ID.
• Form I-9 Reference ID: This field is optional.
If you don't specify a reference ID value,
Workday will assign one.
• External Form I-9 Source: Find reference
ID values by running the Integration IDs
report and searching for business object
External Form I-9 Source. If you can’t find
the appropriate values, add External Record
Source options into Workday through the
Maintain Form I-9 Settings task.
• Citizenship Status: Find reference ID
values by running the Integration IDs report

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 245

and searching business object Form I-9


Citizenship Status (Workday Owned) .
• Document Title: There are different
reference ID types that you can select.
Use the drop-down box in cells CB4, CH4,
CM4, CS4, and CY4 to view reference ID
types you can use. If you’re using more than
1 reference ID type, it might be easier to
populate the Workday ID (also known as
WID) value. The other method is to edit the
EIB template and configure the Separate
Type Column option, so you can populate
the values for the reference ID types in
the EIB input file, instead of using the WID
values. Below are instructions for populating
the Workday ID/WID:
1. Find the WID value from the above report
for the documents that you want to use
and paste into the EIB input file.
2. Run the Integration IDs report and enter
these 4 business objects:
a. National ID Type
b. Form I-9 License ID Type (Workday
Owned)
c. Form I-9 Passport ID Type (Workday
Owned)
d. Form I-9 Government ID Type
(Workday Owned)
3. Change cells CB4, CH4, CM4, CS4, and
CY4 to value WID.
• File Attachments: See Populating File
Attachments for the EIB Input File section for
more details.
• After loading the file, you can verify the entries
loaded by using 1 of these options:
• Run the Form I-9 Process Status report to
see how many External Records loaded in
the last week. If you hover over the number,
you can see the list of forms and who they
were for.
• Run the Form I-9 Internal Audits report to
view the loaded entries. You’ll want to filter
the Latest Form I-9 column for any entries
containing the string External.
• Run the report View Form I-9 for Worker.

Common Issues and Errors

Issue Cause and Solution

Unable to launch the EIB You can:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 246

Issue Cause and Solution


1. Edit Business Process Security Policy for
Complete Form I-9.
2. Add the appropriate security groups to the
Initiating Action Change External Form I-9
(Web Service).
3. Activate the change.

The EIB issues this error: This issue will occur if you attempt to load 2
external forms with same Form I-9 Reference ID.
Processing error occurred. Duplicate
insert on index: Form I-9-ID-Form
I-9 Reference ID (95$5262), value:
Ext_Form_21001, new instance: id=6241$325
wid=0184898fffb601f223064ef82c009b02
disp=6241$325, existing: id=6241$324
wid=0184898fffb601cc286bf1122c002e02
disp=6241$324

Even though the EIB completes successfully, the This issue can occur if the base-64 encoded value
attachment loaded as a corrupted file. you pasted into the EIB input file is greater than
32,767 characters. If there are more characters
than this, the encoding is truncated and the file is
subsequently corrupted.
If you encounter issues with corrupted attachments,
see Populating File Attachments in EIB Input File
section.

The EIB completes successfully. However, if you This issue will occur if you set the processing
attempt to update section 3 after the load, you instruction field to Automatic Processing. To correct
receive the message: the problem, you must:
You can not start another Form I-9 until you have 1. Rescind the External Form I-9.
completed your pending/upcoming Form I-9 event. 2. Rerun the EIB and leave the processing
instructions blank (in cell C7 of the Overview tab
in the EIB input file).
3. Retest completing section 3.

The EIB fails with this error when attempting to load At this time, the web service doesn't support the
an I-9 with no documents: creation of an I-9 without any documents. Workday
is evaluating whether to change this functionality,
Validation error occurred. Enter at least one
but the current expectation is that you should have
document in List A, List B, or List C.
a least 1 supporting document for an I-9.

Business Processes
Complete Form I-9.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 247

Populating File Attachments for the EIB Input File


• It can be tricky loading documents using EIB for 2 reasons:
• You need to base-64 encode the documents and then populate the base-64 value in the EIB input
file.
• Excel has a limitation of 32,767 characters per cell. After encoding the document, it needs to be
fewer than 32,767 characters.
• For the above reasons, customers often opt to use a custom integration when it’s necessary to load
attachments. If you have someone at your organization experienced with Workday Studio, a custom
integration might be a better option to take.
• If you wish to go forward with using the EIB, try these suggestions for populating attachments:
• First, you’ll need a tool to base-64 encode your file. There are many free tools available to base-64
encode files (such as Notepad++, for which you'll need to install the MIME Tools plug-in).
• After you encode the document, the size needs to be under 32,767 characters to be able to paste it
into Excel. If it’s larger, there are a couple options:
• If the document is an image, you could make it smaller using a third-party tool such as Image
Optimizer (this tool isn’t Workday endorsed. Proceed at your own risk).
• You could edit the EIB input file with a text editor such as Notepad++ (instead of opening it with
Excel) and paste in the encoded value. This removes the restriction of 32,767 characters.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries only (not update or delete existing entries).
• If you have inadvertently uploaded incorrect entries:
• Use task Mass Cancel Business Processes or Mass Rescind Business Processes (depending
on whether the business process event completed or is in progress).
• Then select Business Processes Loaded by EIB to find the integration event you wish to cancel or
rescind, or enter Complete Form I-9 at the Business Process Types prompt.
For reference documentation for all web services including Put External Form I-9, see Operation Directory.

Sample EIB Input File


Put_External_Form_I-9-WD36

Concept: Put Job Family Group EIB

Background
You can use this EIB to add or update a job family group. It also adds or removes a group's associated job
families. If you want to update the job families directly, consider using a Put Job Family EIB instead.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Job Family Group
• Edit Job Family Group

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 248

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Job Information
domain in the Jobs & Positions functional
area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each job family group.
• Add Only: Set to Y if only adding new
entries.
• Job Family Group: If updating an existing
job family group, enter the reference id here.
To find reference id values, run the View
Reference IDs report and select business
object Job Family. Note that it will display
both job family groups and job families). You
could also run a custom report to get this
information. Refer to sample report definition
below.
• ID: If adding a new job family id, enter the ID
value here.
• Effective Date: Effective date of job family
group. If you enter a date, use format YYYY-
MM-DD. If no value is present, the effective
date populates with the current date.
• Name: If adding a new Job Family Group,
enter the name. If updating an existing Job
Family Group, enter name if you wish to
change it.
• Inactive: Enter Y to inactivate the job family
group.
• Job Family Data section:
• Row ID (column J): If adding or removing
job families from the job family group,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 249

enter a unique row id value for each family


that you add/remove.
• Delete: If removing a job family from a job
family group, enter Y.
• Job Family: Enter the reference id of the
job family that you’re adding or removing.
To find reference id values, run the
View Reference IDs report and select
business objectJob Family. Note that it
will display both job family groups and
job families. You could also run a custom
report to get this information. Refer to
sample report definition below.
• Job Profile Info Data section: This is
information only and you can't update it.

Common Issues and Errors

Issue Cause and Solution

When attempting to use the Generate Spreadsheet The Generate Spreadsheet with Data functionality
with Data functionality, it fails with this error: isn’t available at this time. Workday is researching
this issue (internal ticket HRCORE-55286).
The entered information does not meet
the restrictions defined for this field. In the meantime, use a custom report to help you
(Job_Family_Reference). populate the EIB input file.

Unable to launch the EIB. This issue is most likely security-related. See the
Additional Input File Guidelines section.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new job family groups or update existing job family groups. You
can't delete job family groups.
• Since this EIB doesn't use a business process, there's no option to rescind or cancel.
• You can't delete job family groups. So if you accidentally load new job family groups that you don't wish
to keep, an option would be to:
• Update the job family groups using the EIB.
• Set the Inactive flag to Y.
• You could also change the job profile group names and precede them with zDNU which will drop
them to the bottom of the list.
For reference documentation for all web services including Put Job Family Group, see Operation Directory.

Sample EIB Input File


Put_Job_Family_Group-WD36

Concept: Put Job Profile EIB

Background
Note:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 250

The Put Job Profile web service is deprecated starting with v44.0 Workday recommends that you use the
Submit Job Profile web service instead. You can use this EIB to add or update job profiles. See Concept:
Submit Job Profile EIB on page 252.
If you want to load skills to job profiles, consider using workbooks. See Mass Update Job Profile Skills with
Workbooks.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Job Profile
• Edit Job Profile

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Job Information
domain in the Jobs & Positions functional
area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
Job Profile EIB. See: Example: Generate EIB
Spreadsheet Template with Data on page 62.
• If updating existing job profiles, note that:
• For many fields, you can use value {empty} if
you need to remove an existing value.
• For the fields where multiple values are
possible, such as competencies, the web
service generally performs a Replace All. If
you’re adding, changing, or removing values,
you need to populate the EIB input file with
the new values as well as any existing values
you wish to keep.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 251

• As you populate the EIB input file, consider:


• Spreadsheet Key: Use a unique value for
each job profile.
• Job Code: Populate the job code if updating
an existing job profile
• Effective Date: Enter the effective date of the
change. If field remains blank, it defaults to
today's date.
• Referral Payment Plan: If updating an
existing job profile that uses this field,
populate existing value in the EIB input file
otherwise the EIB input file removes it.
• Restrict to Country: If updating an existing
job profile that uses this field, populate
existing value in the EIB input file otherwise
the EIB input file removes it.

Common Issues and Errors

Issue Cause and Solution

The EIB issues 1 of these errors: This issue occurs if you don’t properly populate the
Location Context or ISO 3166 1 Alpha 2 Code. To
• Validation error occurred. Element Content
correct this problem, populate column AL with the
'Location_Context_Reference' is required, on
ISO_3166-1_Alpha2_Code value and leave column
internal element 'Job Profile Exempt Data'.
AM blank.
• Within relationship' is empty for index 95$744.

EIB issues this error: This error occurs when a job profile name for a job
code isn’t unique in a job family.
Validation error occurred. This Job Title along with
one or more Job Families combination is already You might find it helpful to run report View
in the system. Combination of Job Title and Job Reference IDs (select business object Job Profile).
Family has to be unique in the system. Then extract the output to check for duplicate
job profile names. In situations where there are
identical names, you’ll either need to:
• Change one of the names
• Make certain that the job families don't contain
duplicate job profiles.

EIB returns this error when trying to add a new job This issue occurs when the effective date on the
classification: EIB is before the creation date of the new job
classification. Enter an effective date that is on or
Validation error occurred. The entered information
after the creation date of the new job classification.
doesn’t meet the restrictions defined for this field.
(Job_Classifications_Reference).

Although the EIB successfully completes, it didn’t This issue can occur when updating existing job
make the updates I specified in the EIB input file. profiles and specifying an older effective date in the
EIB input file. Example: If the existing job profile
has an effective date of 9/1/2020 and you then load
updates to the job profile and populate an effective
date of 8/1/2000, those changes aren't visible if you
view the job profile as of 9/1/2020, since they’re
outdated.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 252

Issue Cause and Solution


To resolve this issue, you need to reload the data
with a more recent effective date.

When using the Generate Spreadsheet with Data When running the View Security for Securable
option, it doesn't generate the template file. And if Item report and searching for the Put Job Profile
viewing the template generation job in the process web service, it displays that you need Put access to
monitor, the error displays: The task submitted isn’t domain security policy Job Information.
authorized.
To fix this problem, complete these steps:
1. Edit domain Job Information security policy.
2. Give Put access to the appropriate security
groups.
3. Activate the change.

I’m unable to launch the EIB. When running report View Security for Securable
Item and searching for the Put Job Profile web
service, it displays that you need Put access to
domain security policy Job Information.
To fix this problem, complete these steps:
1. Edit domain Job Information security policy.
2. Give Put access to the appropriate security
groups.
3. Activate the change.

I made changes to job classification, competencies, The job profile currently doesn’t take Snapshots of
job family, and so on, and loaded the EIB the qualifications at this time.
successfully. However, when I use the view job
profile off the related actions of the job profile, and
select a date before the effective date on my EIB,
it has the same information as what I loaded for my
effective date. Shouldn't I see what it looked like
before my load if I select an effective date that is
before the effective date on my EIB?

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add new entries or update existing entries. You can’t delete entries nor
can you rescind since there’s no business process associated with this web service.
If you have inadvertently uploaded incorrect entries, you can update the entries to make corrections.
You can’t delete job profiles. If you have job profiles that you no longer wish to use, you can update them
and set the Inactive flag to Y. You could also change the name of the job profile and prefix it with DNU.
For reference documentation for all web services including Put Job Profile, see Operation Directory.

Sample EIB Input File


Put_Job_Profile-WD30

Concept: Submit Job Profile EIB

Background
You can use this EIB to add or update job profiles.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 253

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
If you want to load skills to job profiles, consider using workbooks. See Mass Update Job Profile Skills with
Workbooks.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Job Profile
• Edit Job Profile

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Submit Job
Profile initiating action on the Manage Job
Profile business process to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the
Submit Job Profile EIB. See: Example: Generate
EIB Spreadsheet Template with Data on page
62.
• If updating existing job profiles, note that:
• You can leave the field blank if you need
to remove an existing value. Workday will
default today's date for the Effective Date
field.
• For the fields where multiple values are
possible, such as competencies, the web
service generally performs a Replace All. If
you’re adding, changing, or removing values,
you need to populate the EIB input file with
the new values as well as any existing values
you wish to keep.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 254

• As you populate the EIB input file, consider:


• Spreadsheet Key: Use a unique value for
each job profile.
• Job Code: Populate the job code if updating
an existing job profile
• Effective Date: Enter the effective date of the
change. If field remains blank, it defaults to
today's date.
• Referral Payment Plan: If updating an
existing job profile that uses this field,
populate existing value in the EIB input file
otherwise the EIB input file removes it.
• Restrict to Country: If updating an existing
job profile that uses this field, populate
existing value in the EIB input file otherwise
the EIB input file removes it.

Common Issues and Errors

Issue Cause and Solution

The EIB issues 1 of these errors: This issue occurs if you don’t properly populate the
Location Context or ISO 3166 1 Alpha 2 Code. To
• Validation error occurred. Element Content
correct this problem, populate column AG with the
'Location_Context_Reference' is required, on
proper ID Types.
internal element 'Job Profile Exempt Data'.
• Within relationship' is empty for index 95$744. 1. Access the Edit Template Model Area task for
Job Profile Exempt Data.
2. In the Location Context row, set the Separate
Type Column toYes.
3. Use the Get Job Profile web service to retrieve
the job profile data.
See Customize EIB Spreadsheet Template on
page 46.

EIB issues this error: This error occurs when a job profile name for a job
code isn’t unique in a job family.
Validation error occurred. This Job Title along with
one or more Job Families combination is already You might find it helpful to run report View
in the system. Combination of Job Title and Job Reference IDs (select business object Job Profile).
Family has to be unique in the system. Then extract the output to check for duplicate
job profile names. In situations where there are
identical names, you’ll either need to:
• Change one of the names
• Make certain that the job families don't contain
duplicate job profiles.

EIB returns this error when trying to add a new job This issue occurs when the effective date on the
classification: EIB is before the creation date of the new job
classification. Enter an effective date that is on or
Validation error occurred. The entered information
after the creation date of the new job classification.
doesn’t meet the restrictions defined for this field.
(Job_Classifications_Reference).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 255

Issue Cause and Solution

Although the EIB successfully completes, it didn’t This issue can occur when updating existing job
make the updates I specified in the EIB input file. profiles and specifying an older effective date in the
EIB input file. Example: If the existing job profile
has an effective date of 9/1/2020 and you then load
updates to the job profile and populate an effective
date of 8/1/2000, those changes aren't visible if you
view the job profile as of 9/1/2020, since they’re
outdated.
To resolve this issue, you need to reload the data
with a more recent effective date.

When using the Generate Spreadsheet with Data When running the View Security for Securable
option, it doesn't generate the template file. And if Item report and searching for the Submit Job
viewing the template generation job in the process Profile web service, it displays that you need Put
monitor, the error displays: The task submitted isn’t access to domain security policy Job Information.
authorized.
To fix this problem, complete these steps:
1. Edit domain Job Information security policy.
2. Give Put access to the appropriate security
groups.
3. Activate the change.

I’m unable to launch the EIB. When running report View Security for Securable
Item and searching for the Submit Job Profile web
service, it displays that you need Put access to
domain security policy Job Information.
To fix this problem, complete these steps:
1. Edit domain Job Information security policy.
2. Give Put access to the appropriate security
groups.
3. Activate the change.

I made changes to job classification, competencies, The job profile currently doesn’t take Snapshots of
job family, and so on, and loaded the EIB the qualifications at this time.
successfully. However, when I use the view job
profile off the related actions of the job profile, and
select a date before the effective date on my EIB,
it has the same information as what I loaded for my
effective date. Shouldn't I see what it looked like
before my load if I select an effective date that is
before the effective date on my EIB?

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add new entries or update existing entries. You can’t delete entries nor
can you rescind since there’s no business process associated with this web service.
If you have inadvertently uploaded incorrect entries, you can update the entries to make corrections.
You can’t delete job profiles. If you have job profiles that you no longer wish to use, you can update them
and set the Inactive flag to Y. You could also change the name of the job profile and prefix it with DNU.
For reference documentation for all web services including Submit Job Profile, see Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 256

Sample EIB Input File


Submit_Job_Profile_v44.0.xlsx

Concept: Put Location EIB

Background
You can use this EIB to add or update a location.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Location
• Edit Location

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Manage:
Location domain in the Organizations and
Roles functional area to run this EIB.

Configure the EIB to Generate with Data • This EIB has a Generate Spreadsheet with
Data option. Always use this option when
updating existing locations for these reasons:
• This web service can remove existing fields
if you don't populate values for them in the
EIB input file. By generating the spreadsheet
template with data, you can reduce the
chances that the web service removes fields.
• By generating the spreadsheet template
with data, Workday populates all existing
information in the EIB input file. Then you can
merely update the EIB input file with the fields
you need to change.
• If you’re loading new locations, you might want
to start by manually creating a location similar
to the locations you’re loading. Then you can

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 257

generate the spreadsheet with data to determine


how you’ll need to build the EIB input file.
• To configure a filter to generate your
spreadsheet with data:
1. From the related actions of your EIB, select
Template Model > View.
2. Click Edit Template with Data Options.
3. In the Filter section, select the Condition
Rule Filter option.
4. Enter the rule condition.
5. From the related actions of the EIB, select
Template Model > Generate Spreadsheet
Template.
6. Generate the spreadsheet with data.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
Location EIB. See: Example: Generate EIB
Spreadsheet Template with Data on page 62.
• Note:
• Effective date must be blank for new
locations to be consistent with new locations
created in the UI.
• When effective date is blank, the value is
effective as of the beginning of time.
• The Effective Date applies to these fields
only: Location Name, Inactive, and Location
Hierarchy Reference.
• If Location Hierarchy Reference is blank
for an existing location, Workday removes
location from all location hierarchies it’s
included in as of the effective date specified.
• If these fields are blank, the web service
removes existing values: Altitude, Latitude,
Longitude, Trade Name, Worksite
Identification Code, Locale, User Language,
Location Attribute, Location Type, Time
Profile, Time Zone, Superior Location.
• Note: If you’re updating an existing location
that uses any of these fields, you must
populate these fields in the EIB input file to
prevent their removal. We recommend that
you use the Generate Spreadsheet with
Data option if updating existing locations to

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 258

ensure that the location retains all existing


data:
• Location Hierarchy
• Superior Location
• Time Zone
• Time Profile
• Location Type
• Location Attribute
• Trade Name
• Worksite
• Locale
• User Language
• Altitude/Latitude/Longitude
• As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each Location
• Location (column D): If updating an existing
location, populate this field with the reference
ID value of the location that you wish to
update. We recommend that you use the
Generate Spreadsheet with Data option
if updating existing data. Then copy the
reference ID value in the Location ID column
(column E) into this field. You can also find
the reference ID value by creating a custom
report using a report data source such as
Locations.
• Location ID (column E): Populate this field
in these situations:
• If you’re updating the location: place the
reference ID value of the location in this
field. Or if you want to change the current
reference ID value for the location, place
the new reference ID value in this field.
• If you’re creating a new location and you
wish to assign the reference ID, place the
value in this field. If the field is blank, the
web service will automatically assign a
reference ID value
• Effective Date: Specifies the Effective Date
for updates to these fields only: Location
Name, Inactive, and Location Hierarchy
Reference. Blank means that these field
values will be effective as of the beginning of
time. Must be blank for new locations.
• Location Name: (Required)
• Location Usage (required): Enter the
Location Usages. Note that if updating an
existing location, you must populate all
location usages as the web service does
a Replace All. To identify the reference ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 259

values for Location Usage, run the Integration


IDs report and search business object
Location Usage.
• Inactive: Set this flag to Y to inactivate a
location. You might also want to append
zDNU to the beginning of the location name.
• Trade Name and Worksite ID Code: If you
populate these fields, it’s also necessary to
populate the primary address in the EIB input
file.
• Location Hierarchy: You can specify one or
more location hierarchies. Always populate
this field if updating an existing location that
already has a location hierarchy assigned, so
that the value remains.
• Defaulted Business Site Address:
Select Y for the EIB to ignore the address
information, not trigger a remove/add
transaction for the address (which could
impact integrations such as PECI). Select N
if you want to update the address, with the
address information provided in the EIB input
file.

Common Issues and Errors

Issue Cause and Solution

EIB issues this error when updating the Trade The EIB requires that the EIB input file contains the
Name and Worksite ID even though the location is primary address when updating the trade name and
US-based: worksite ID so that it can validate that the location is
still in the US. You might want to use the Generate
Validation error occurred. Worksite ID Code and
Spreadsheet with Data option to help populate the
Trade Name are valid only for Locations based in
address in the EIB input file.
US

There’s no option to launch the integration. This issue is normally security-related:


1. Edit the domain security policy for domain:
Manage: Location
2. Make certain you are in a security group that
has Put access.
3. Activate the Security Change.

When attempting to generate the spreadsheet with This issue is normally security-related:
data, it fails with error:
1. Edit the domain security policy for domain:
Processing error occurred. The task submitted is Manage: Location
not authorized. 2. Make certain you are in a security group that
has Put access.
3. Activate the Security Change.

I’m unable to populate an External URL value in the There isn’t an option to assign external URLs to
EIB input file. locations, through a web service. If you need to do
this task, consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 260

Issue Cause and Solution


• There's a Contact Information section
associated with the location, where you can
enter web addresses.
• There’s an EIB called Put External URL that
enables you to set up external URLs. However,
you would still need to manually assign them to
the locations.

Even though I populated address details in EIB Verify that field Defaulted Business Site
input file, it doesn't load the information. Addressvalue is N in the EIB input file.

EIB issues this error: The EIB requires a Time Profile for locations whose
usages include Business Site: note that even if
Validation error occurred. Time Profile is required
you’re updating an existing location, you must still
for a location whose usages include Business Site.
populate the Time Profile in the EIB input file. If
updating an existing location, we recommend using
the generate with data option to help populate the
existing data in the EIB input file.

After updating an existing location, the EIB removes When updating an existing location, populate
some fields, including: all existing values. If you don’t take this action,
Workday removes the values.
• Location Hierarchy
• Superior Location We recommend using the Generate Spreadsheet
• Time Zone with Data option when updating existing locations
• Time Profile so that you can ensure that all existing data
remains.
• Location Type
• Location Attribute
• Trade Name
• Worksite
• Locale
• User Language
• Altitude
• Latitude
• Longitude

Slow performance Loading a large volume of locations with Worksite


IDs can negatively impact performance. Workday
is in the process of improving performance. In the
meantime, if you encounter this issue, remove
the worksite ID and rerun the EIB. You can also
break the load into multiple files and load them
concurrently.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new locations or update existing locations. You can’t delete
locations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 261

• Since this EIB doesn’t use a business process, there’s no option to rescind or cancel. If you have
inadvertently uploaded incorrect entries, we suggest you reload the entries with correct information. If
you need to restore the original values:
• Find another tenant such as a Sandbox or implementation tenant, that still has the correct location
information.
• Use Generate Spreadsheet with Data option in that tenant to build an EIB input file to load into the
tenant with incorrect location information.
• You can’t delete locations. If you accidentally loaded new locations that you don’t wish to keep, you
can update the locations and set the Inactive flag to Y. You could also change the location names and
precede them with zDNU, which would drop them to the bottom of the list.
For reference documentation for all web services including Put Location, see Operation Directory.

Sample EIB Input File


Put_Location-WD35_0

Concept: Put Supervisory Organization Assignment Restrictions EIB

Background
You can use this EIB to update the assignment restrictions for a supervisory organization.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Supervisory Organization > Edit Supervisory Organization from the related actions of a
supervisory organization.
There are also similar EIBs related to supervisory organizations. Consider these options as you determine
what works best for you:
• Add Update Organization: You can use this EIB to add a new organization or update an existing
organization.
• Change Organization Assignments: You can use this EIB to assign organizations to worker positions.
You can also perform mass organization changes through:
• Move Workers (Supervisory) task.
• Move Workers (by Organization) task.
• Workbooks: See Initiate Change Organization Assignments in Mass Action Workbooks.
• Org Studio: See Org Studio and Mass Actions.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 262

• Verify you have the correct security


configuration.
• You must have access to the Manage:
Supervisory Organization domain in the
Organizations and Roles functional area to
run this EIB.

Configure the EIB to Generate with Data This EIB has a Generate Spreadsheet with
Data option, which is very helpful to use when
you aren’t certain how to populate the input file. To
use it:
• You might want to manually add default
values and allowed values to one supervisory
organization (like the updates you want to make
to all the supervisory organizations through the
EIB load).
• From the related actions of your EIB, select
Template Model > View.
• Click Edit Template Model Sheet.
• Go to the template model area with label
Allowed Organization Data+ and change the
reference id type for Allowed Organization*+
from Business Unit ID to Organization Reference
ID.
• Go to the template model area with label Default
Organization Data+, and change the reference
id type for Default Organization from Business
Unit ID to Organization Reference ID.
• Click OK then Done.
• Add a filter to your EIB template:
• From the related actions of your EIB, select
Template Model > View.
• At the bottom of the page, select Edit
Template with Data Options.
• Set filter to Condition Rule Filter.
• Create a condition rule to get the supervisory
organizations you wish to update. Example:
you could select Primary Location in the
selection list Chicago. Or if you want it to
extract everything, select Primary Location
not in the selection list Virgin Islands (or
some other location not associated with your
supervisory organizations).
• If you regenerate the template and select the
Generate Spreadsheet with Data option,
it will contain the supervisory organizations
you selected. You can then make your
modifications and run the EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 263

Common Issues and Errors

Issue Cause and Solution

The EIB issues an error such as Validation error You need to make certain that your template
occurred. Invalid ID value. 'COMPANY-16-292' is model is referencing the proper reference id
not a valid ID value for type = 'Business_Unit_ID' type. Check your EIB input file for any references
to Business Unit_ID and replace them to
Organization_Reference_ID

No option to launch the EIB Make certain you have Put access to domain
security policy Manage: Supervisory Organization

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, and delete entries.
• If you have inadvertently uploaded incorrect entries, you might want to download the original
supervisory organization assignments from another tenant (where original entries are still intact) and
then load them to production with the replace all option
For reference documentation for all web services including Put Supervisory Organization Assignment
Restrictions, see Operation Directory.

Sample EIB Input File


Put_Supervisory_Organization_Assignment_Restrictions-WD32

Concept: Put User-Based Security Group Assignments EIB

Background
You can use this EIB to assign user-based security groups to Workday accounts.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Any information that you submit with this EIB replaces and overwrites the information currently in Workday.
To avoid data loss, include all existing users and any new users you want to add for a security group in
your EIB input file.

Equivalent Workday Task


Task: Assign User-Based Security Groups for Person.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 264

• Verify you have the correct security


configuration.
• You must have access to the User-Based
Security Group Administration domain in the
System functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• This EIB can be very dangerous since it does a
replace all. We recommend you:
• Make certain that it's truly the EIB that you
wish to use. This EIB assigns user-based
security groups to selected users. It's similar
to the task Assign User-Based Security
Groups for Person. There’s also another
more commonly used EIB, titled Put Assign
User-Based Security Group that assigns
users to a selected user-based security group
(similar to the task Assign Users to User-
Based Security Group).
• Thoroughly test in a nonproduction
tenant first. Even when testing in a
nonproduction tenant you must be careful. If
you don't properly populate the EIB input file,
you could inadvertently remove your access
from security groups, and subsequently
lose access to some functionality within the
tenant. When you run an initial test, avoid
updating assignments for a super user, just in
case something goes wrong.
• Use the Generate Spreadsheet with Data
option. See Configure the EIB to Generate
with Data section.
• It's easy to get this EIB mixed up with the
other EIB that assigns users to a security
group (Put Assign User-Based Security
Group). Before you run the EIB, check the
EIB input file and make certain you're running
the correct EIB (cell A1 in the EIB input file,
should display Assign User Based Security
Groups. Note that Groups is plural whereas
it’s singular for the other EIB)

Configure the EIB to Generate with Data • This EIB has a Generate Spreadsheet with
Data option. We strongly recommend you use
this option since this is a replace all web service.
Therefore the Generate Spreadsheet with Data
option will be helpful since you can populate

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 265

the template with all existing security group


assignments. To use this option:
1. From related actions of your EIB, select
Template Model > View.
2. Click Edit Template with Data Options.
3. Enter a Workday account (Example: lmcneil)
in the ID field. Or if you want to extract
multiple accounts, then select Condition
Rule Filter and add a condition rule.
Example: Account Disabled or Expired is not
blank.
4. Click OK.
5. If you regenerate the template and select the
Generate Spreadsheet with Data option,
you can view all existing user-based security
group assignments for selected accounts.

Additional Input File Guidelines • As you populate these fields in the input file,
consider:
• Spreadsheet Key: Use a unique value for
each Workday account specified in the EIB
input file. It's important to properly set this
value: if you assign different spreadsheet key
values for the same Workday account, you’ll
lose the assignments.
• Workday Account: List the Workday
account that you wish to assign security
groups to.
• User-Based Security Group: Enter the
reference id value for each security group
that you’re assigning. You can run the View
Reference IDs report and select business
object User-Based Security Group to get a
list of security groups and reference ids

Common Issues and Errors

Issue Cause and Solution

After running the EIB, the user account is missing This feature is working as expected. The EIB
security group assignments that they previously removes all existing security group assignments
had. from the user and replaces the security group
assignments with the entries in the EIB input file.
Be sure to list all security group assignments
(existing assignments and new assignments) in the
EIB input file.

The EIB assigns only the last security group listed Verify that you're using the same spreadsheet key
in the EIB input file. value for each user account specified in the EIB
input file. Example: All entries for user account A
use spreadsheet key 1. And all entries for user
account B use spreadsheet key 2, and so on.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 266

Issue Cause and Solution

There’s no option to launch the EIB. This issue is most likely security-related. Report
View Security for Securable Items displays that
you need Put access to domain security policy
User-Based Security Group Administration to
access the web service. You’ll need to:
• Edit the domain security policy for domain User-
Based Security Group Administration.
• Make certain you're in a security group that has
Put access to this domain.
• Activate the security change.

The EIB issues this error: Make certain you're using the same spreadsheet
key value for a given Workday account.
Validation error occurred. Element Content
'Workday_Account_Reference' is required, on
internal element 'Assign User-Based Security
Groups Data'.

Use Cases and Guidelines for Recovering from a Bad Load


Since the web service doesn’t use a business process, there isn't an easy way to recover if you load
incorrect entries. You can find another tenant that still has the correct security group assignments for the
Workday accounts. Then use the Generate Spreadsheet with Data option in that tenant to build an EIB
input file to load to the tenant with the incorrect data.
For reference documentation for all web services including Put User-Based Security Group Assignments,
see Operation Directory.

Sample EIB Input File


Put_User-Based_Security_Group_Assignments-WD34

Concept: Update Workday Account EIB

Background
You can use this EIB to update existing Workday accounts for employees, contingent workers, and
implementers.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Edit Workday Account.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 267

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to Workday Accounts
domain in the System functional area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Use a unique value for
each Workday account that you’re updating.
• The EIB input file includes a section for
specifying the Workday account for an
employee and another section for specifying
the Workday account for a contingent worker.
Be sure to complete the correct section
based on whether the worker is an employee
or contingent worker.
• System ID: Set the field value to WD-
EMPLID in the employee section or
contingent worker section depending on
the account. For reference documentation
of other role ID types, see Operation:
Update_Workday_Account.
• Generate Random Password:
• If set to Y, it generates a random
password for the specified Workday
Account and emails the new password
to the email address associated with
that account. (Run Edit Tenant Setup -
Security and verify that the configuration
enables security emails. For terminated
workers, you might also need to
temporarily change the setting to Send to
home email, else work email.)
• If set to N, you can provide a new
password in a different field. If you don't
provide a password, the associated
Workday Account's password doesn't
change. Note that the Maximum
Password Age in Days field on the
Maintain Password Rules task or

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 268

the Maintain Payment Card Industry


Password Rules task controls the
password expiration for the randomly
generated password.
• Notifications: Below are details on how
to populate the fields associated with
Notifications. There’s also 1 entry in the
attached sample EIB Input file, demonstrating
an update to notifications. When you update
a notification type, it replaces all instances.
To avoid removing information, ensure
that the EIB input file includes all channel
information for the notification type. Also, you
must supply Workday IDs (WIDs) for each of
these fields. The WIDs are typically available
from the Integration IDs report. However,
at this time they aren’t available due to a
permission-related issue that the Workday
development team is investigating. Instead,
refer to the attached file Workday-IDs-for-
Notification-Fields.xlsx, to get a list of WID
values.
• Notification Sub Type: This is the
notification type. (Examples: Approvals,
Give Feedback, Tasks.) Enter the WID
of the notification type. (Refer to the
attached file Workday-IDs-for-Notification-
Fields.xlsx for a list of values.)
• Channel: Enter the channel (Example:
Email, Mobile Push Notification). You’ll
need to enter the WID for the channel.
(Refer to the attached file Workday-IDs-
for-Notification-Fields.xlsx for a list of
values.)
• Delivery Frequency: Enter the delivery
frequency (Example: Immediately, Daily).
You’ll need to enter the WID. (Refer to the
attached file Workday-IDs-for-Notification-
Fields.xlsx for a list of values.)

Common Issues and Errors

Issue Cause and Solution

EIB fails with this error: This issue occurs if your tenant configuration
doesn't permit the preferred language populated in
The value specified isn’t configured for this
the EIB input file. You can:
country..
1. Run the Maintain Localization Settings task.
2. At Area prompt, select Personal Information.
3. Locate the row with Localized Field = Preferred
Communication Language (Worker).
4. Enter all applicable countries in theAllow for
Countries or Regions prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 269

Issue Cause and Solution


5. Select theActive check box for the entry to
activate settings.
6. Run Configure Preferred Communication
Languages task.
7. Add all applicable countries/languages.

After using EIB to update delivery frequency, some When you update a notification type using the
of the delivery frequency information is missing Update Workday Account web service, it replaces
or has changed for other channels that weren't all instances. To avoid removing information, make
updated. sure that the EIB input file includes all channel
information for the notification type. Pay close
attention to row IDs.

The notification fields in the sample EIB input file There were many changes made to notification
look different than what I see in my EIB input file. fields in recent web service versions. Verify you're
using the latest web service version. If you're not
certain what version you're using, create a new EIB
to pick up the latest version.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to update entries only. If you need to add new entries, use Add Workday
Account EIB.
• If you have inadvertently uploaded incorrect entries, reload the entries with correct values.
• You can’t delete Workday Accounts. If you have accounts that you don't want to use, you can disable
them using this web service.
For reference documentation for all web services including Update Workday Account, see Operation
Directory.

Sample EIB Input File


Update_Workday_Account-WD36
Workday-IDs-for-Notification-Fields_0

Integrations EIBs
Concept: Approve Business Process EIB

Background
You can use this EIB to approve business processes by user.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
The EIB must be run by a user who is listed in the awaiting action list for the business process step.
Example: If a Request Compensation Change event displays that the approval step is awaiting action for
user A or B, then user A or B must run the EIB.
If you aren't a user listed in the awaiting action list for the business process step and need to run the EIB,
consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 270

Approach #1 Reassign the business process actions that you


want to approve to 1 user, who can then run the
EIB:
1. Mass reassign the business process steps to 1
user.
2. Sign in as the user you reassigned the tasks to
and run the Approve Business Process EIB.

Approach #2 Configure a service center representative to run the


EIB. This is a preemptive approach that you can
use to help avoid future issues with mass approving
business process events.
1. Create a service center representative and a
Workday account.
2. Add the service center representative to a
security group.
3. For any business processes that you want to
mass approve events for in the future:
a. Edit the business process security policy and
add the service center security group (from
step 2) to the approve section.
b. Edit the business process definition and
add the security group to any business
process approval steps that you want to
mass approve in the future.
4. Add the security group (from step 2) to the
Integration Events domain security policy so that
the service center representative can run the
EIB.
5. Activate the security changes.
6. Sign in as the service center representative to
run the EIB.

Equivalent Workday Task


You can approve the action from My Tasks.
You can also mass approve using the Bulk Approve option from My Tasks.
Note: You can't undo an approval. Review any relevant business processes carefully before you approve
events.

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files.
As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for each event where you want to approve a business
process step.
• Event: Specify the Workday ID (WID) and change the value in cell C4 of the EIB input file from
Absence_Case_ID to WID.
• Comment: Required, unless you select the Disable Comments check box in the business process
security policy.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 271

Common Issues and Errors

Issue Cause and Solution

The EIB issues this error: Displays if you try to run the EIB and aren't
a user listed in the awaiting action list for the
Validation error occurred. The entered information
business process step.
does not meet the restrictions defined for this field.
(Event_Reference). Refer to the Background section above for
suggestions on how to address this situation.

The EIB issues an error like this: The EIB input file needs to specify WID as the
reference ID type.
Validation error occurred. Invalid ID value.
'ad176699557701e05eed7775de07d00d' is not a Change the value in cell C4 of the EIB input file
valid ID value for type = 'Absence_Case_ID' from Absence_Case_ID to WID.

EIB completes successfully but doesn't approve the Verify that you’re specifying an approvable step.
step.
Example: If you specify a to do step, the EIB
ignores it.

Use Cases and Guidelines for Recovering from a Bad Load


You can't undo an approval. Review any relevant business processes carefully before you approve events.
For reference documentation for all web services including Approve Business Process, see Operation
Directory.

Sample EIB Input File


Approve_Business_Process-WD34

Concept: Cancel Business Process EIB

Background
You can use this EIB to cancel a business process.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
You can also use this EIB to cancel individual steps in a business process if those steps are associated
with a subprocess event. If the individual steps aren’t associated with a subprocess event (Example: an
approval step), then you can't cancel the step. See Setup Considerations: Mass Operations on Business
Processes for more information.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Mass Cancel Business Processes
• Mass Operation Management

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 272

• Spreadsheet Key: Specify a unique value for each event.


• Event: We recommend that you specify the Workday ID (WID) value for each event. Change the value
in cell C4 of the EIB input file from Absence_Case_ID to WID. Consider creating a custom report with
the Business Process Transactions data source to get the WIDs.
• Comment: (Required) Enter a comment for each event.
• Suppress Notifications: Enter Y to suppress notifications for each event you want to cancel.

Common Issues and Errors

Issue Cause and Solution

The EIB issues this error: Check these:


Validation error occurred. Business Process cannot 1. Check the security policy for the business
be canceled via Web Service. process that you are canceling and ensure you
have access to cancel it.
2. Verify that you entered the correct Workday ID
(WID) in the EIB input file.
3. Verify that the event can be canceled. Create
and run a custom report with the Business
Process Transactions data source and check
that the Cancelable field is set to Yes.

The EIB issues an error like this: The EIB input file needs to specify WID as the
reference id type. Ensure the value in cell C4 of the
Validation error occurred. Invalid ID value.
EIB input file is WID instead of Absence_Case_ID .
'ad176699557701e05eed7775de07d00d' is not a
valid ID value for type = 'Absence_Case_ID'

Use Cases and Guidelines for Recovering from a Bad Load


You can't undo a Cancel Business Process EIB. If you cancel business process events in error, the only
option would be to resubmit the original business process events to restore them.
For reference documentation for all web services including Cancel Business Process, see Operation
Directory.

Sample EIB Input File


Cancel_Business_Process-WD33

Concept: Deny Business Process EIB

Background
You can use this EIB to deny a business process.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
To run the EIB, Workday must display your name in the Awaiting Action list for the business process step.
Example: If a Request Compensation Change event displays that the approval step is awaiting action for
Logan McNeil or Betty Liu, then one of them must run the EIB.
If Workday doesn't display your name in the Awaiting Action list for the business process step and need to
run the EIB, consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 273

Reassign to 1 Person Reassign the business process actions that you


want to deny to 1 person, who can then run the EIB:
1. Mass reassign the business process steps to 1
person.
2. Sign in as the person you reassigned the tasks
to and run the Deny Business Process EIB.

Reassign to Service Center Representative Configure a service center representative to run the
EIB. This method is a preemptive approach that
you can use to help avoid future issues with mass
denying business process events.
1. Create a service center representative and a
Workday account.
2. Add the service center representative to a
security group.
3. For any business processes for which you
want to deny events in bulk in the future:
a. Edit the business process security policy
and add the security group for the service
center (from step 2) to the approval and deny
sections.
b. Edit the business process definition and add
the security group to any business process
approval steps that you want to deny in bulk
in the future.
4. Add the security group (from step 2) to the
Integration Events domain security policy so that
the service center representative can run the
EIB.
5. Activate the security changes.
6. Sign in as the service center representative to
run the EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Mass Cancel Business Processes
• Mass Operation Management

EIB Input File Guidelines


• We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating EIB files. Additionally, as you populate the EIB input
file, consider:
• Spreadsheet Key: Specify a unique value for each event
• Event: we suggest you enter the Workday ID (aka WID). You can find the WID value using
the sample report definition below. Also, change the value in cell C4 of the EIB input file, from
Absence_Case_ID to WID.
Comment: the EIB requires a comment , unless you select Disable Comments in the business
process security policy.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 274

• Note that you can't reverse a denial action. Proceed with caution if you deny events in bulk.
• You might want to create a custom report to help you populate the EIB input file. If you select this
option, you can create a custom report based on the Business Process Transactions data source.
Ensure that 1 column has a Workday ID field from the related business object Action Event. The
Workday ID report field provides the Workday ID (WID) value that you need for the EIB input file.

Common Issues and Errors

Issue Cause and Solution

The EIB issues this error: This error occurs if a worker not listed in the
Awaiting Action step of the event you wish to deny
Validation error occurred. The entered information
runs the EIB. Refer to section Preparation Steps to
does not meet the restrictions defined for this field.
use this EIB for suggestions on how to address this
(Event_Reference).
situation

The EIB issues an error like this: The EIB input file needs to specify reference id type
WID. To correct this problem, edit the EIB input file
Validation error occurred. Invalid ID value.
and replace Absence_Case_ID with WID in cell C4
'ad176699557701e05eed7775de07d00d' is not a
valid ID value for type = 'Absence_Case_ID'

Use Cases and Guidelines for Recovering from a Bad Load


You can't reverse denial of a business process action. If you deny events in error, the only option is to
resubmit the original events.
For reference documentation for all web services including Deny Business Process, see Operation
Directory.

Sample EIB Input File


Deny_Business_Process-WD34

Concept: Put Reference EIB

Background
You can use this EIB to update the reference ID on a business object.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
You can't update external IDs with this EIB.
You can use the Maintain Reference IDs task to find business objects with reference IDs that you might
want to update.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Maintain Reference IDs
• From the related actions of the object, see Integration IDs > Edit Reference ID.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 275

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Integration
Build domain in the Integration functional
area to run this EIB

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Use a unique value for
each object that you’re changing.
• You might find it helpful to create a custom
report for the object you’re changing to get a
list of the current reference IDs and Workday
IDs (aka WIDs). Note that for most objects,
the data source includes a Reference ID
field and a Workday ID field. For workers,
the reference ID is the Employee ID or
Contingent Worker ID.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it didn't If the EIB can't locate the reference id or WID that
update the reference ids with the values provided in you populated in the EIB input file, it will ignore it
the EIB input file. rather than issuing an error.
If the updates aren't successful, double-check
the EIB input file and verify that you provided the
correct reference id or WID value.

Use Cases and Guidelines for Recovering from a Bad Load


If you have inadvertently uploaded incorrect entries, you will need to resubmit the EIB with corrected
values. There’s no rescind or undo option.
For reference documentation for all web services including Put Reference, see Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 276

Sample EIB Input File


Put_Reference-WD35_0

Concept: Reassign Business Process Step EIB

Background
You can use this EIB to reassign a business process step.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
The user that runs the EIB must display in the awaiting action list for the business process step.
The recipient of the business process step must have security access to the domains that secure the
business process step.
For more information about reassigning business processes, see Reference: Actions Available on
Business Processes.

Equivalent Workday Task


Task: Reassign Tasks.
You can reassign business processes in bulk using Mass Operation Management (MOM). See Setup
Considerations: Mass Operations on Business Processes for more information.
You can also configure business processes to reassign automatically. See Concept: Auto-Manage
Business Processes for a Worker for more information.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Tenant Non-
Configurable functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each reassignment.
• Event Record: Should be the Workday
ID (WID) of the Awaiting Action step that

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 277

needs reassigned. Also, note that you’ll need


to change the Reference ID type in row 4 of
your EIB input file from IID to WID.
• Reassign To: The employee id that you’re
reassigning the step to.
• Reason: you can add a note as to the reason
you’re reassigning the step

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but the This issue occurs if you specify the incorrect WIDs
reassignments didn't happen. in the input file.

The EIB issues these 3 errors: This issue usually occurs if you try to reassign
steps that are Awaiting Assignment. You can only
1. The business process step: Awaiting
reassign steps that are Awaiting Action.
Assignment cannot be reassigned to xxxx.
2. The processing user does not have the
privileges to reassign Awaiting Assignment .
3. The entered information does not meet
the restrictions defined for this field.
(Event_Record_Reference).

EIB issues error: Make sure you're specifying the WID for the step
that is in status Awaiting Action.
Invalid instance 1673$6181 for
Event_Record_Awaiting_Action--IS (15$362832).

Use Cases and Guidelines for Recovering from a Bad Load


If you have inadvertently reassigned the wrong person to the business process steps, update the input file
to use the correct reassign to values and run the EIB again for the same entries.
For reference documentation for all web services including Reassign Business Process Step, see
Operation Directory.

Sample EIB Input File


Reassign_Business_Process_Step-WD31

Concept: Rescind Business Process EIB

Background
You can use this EIB to attempt to rescind a business process (if the business process is rescindable).
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Mass Rescind Business Processes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 278

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Tenant Non-
Configurable functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each event
• Event: We suggest you enter the Workday ID
(aka WID). You’ll need to change the value in
row #4 from Absence_Case_ID to WID.
• Comment: Workday requires a comment.
• Suppress Notifications: You can enter Y
to suppress notifications when rescinding
the event. If the business process you're
rescinding also has subprocesses, then the
Workday might not suppress notifications for
subprocesses. Test a rescind first to verify
whether you sent any unwanted notifications.
• Note that you can't undo a rescind. Proceed with
caution when mass rescinding events.
• You might want to create a custom report to help
you populate the EIB input file.

Common Issues and Errors

Issue Cause and Solution

The EIB successfully completes however the web If you use an older web service AND if an event
service didn't rescind 1 or more events. isn’t rescindable, the web service doesn’t issue an
error. Instead, it dismisses the entry and takes no
action.
Make certain you’re using the most recent web
service version.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 279

Issue Cause and Solution

The EIB fails with an error such as: The EIB input file isn’t specifying the correct
reference ID type.
Validation error occurred. Invalid ID value.
'64914c4e8bc201da65c444b0a9204402' is not a Edit the EIB input file and change cell C4 from
valid ID value for type = 'Absence_Case_ID'. Absence_Case_ID to WID.

Workday still sends some notifications, despite If the business process you're rescinding also has
setting the Suppress Notifications flag to Y. subprocesses, then Workday might not suppress
the notifications on subprocesses. Test a rescind
first to verify whether Workday sends any unwanted
notifications. If the test yields unwanted results
consider 1 of these options:
• Disable notifications in tenant while running the
EIB.
• Test using task Mass Rescind Business
Processes instead of the EIB. Test a rescind
first.

The EIB fails with this error: This error is most likely security related. Check the
business process security policy for the business
Business Process cannot be rescinded via Web
process that you’re rescinding and verify that you
Service.
have access to action Rescind (Web Service).
If you make any changes, activate them before
retesting.

Use Cases and Guidelines for Recovering from a Bad Load


You can’t undo a rescind. If you rescind events in error, the only option is to resubmit the original events.
For reference documentation for all web services including Rescind Business Process, see Operation
Directory.

Sample EIB Input File


Rescind_Business_Process-WD34

Concept: Send Back Business Process EIB

Background
You can use this EIB to send back business process events in bulk.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


On the related actions menu of the business process event, select Business Process > Manual Send
Back.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 280

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
for the business process that you're sending
back. The security requirement varies depending
on the business process.

Identifying the Step ID to populate in EIB To identify the Business Process Step ID value
that you'll need to populate in the EIB file:
1. Create a custom report from the Business
Process Transactions (Indexed) Report Data
Source that retrieves the WID values for the
events that you want to send back.
2. Open the business process definition.
3. Locate the step that you're sending back to and
click the magnifying glass.
4. From the related actions, select Integration IDs
> View IDs.
5. Place the ID value in the Business Process
Step ID column in the EIB input file.
6. You'll need the step ID from the subprocess if:
• The event is in the middle of a subprocess
event.
• You want to send back to another step within
the same subprocess.
Example: To send back to the initiation step
of the Manager Evaluation, you'll need the
reference ID value of this step.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each business process event.
• Event (Required): Change the reference
ID type in cell C4 from Absence_Case_ID
to WID. Then populate the field with the
WID values that you retrieved previously
from the custom report in Step 1 above.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 281

Always populate the WID of the parent event.


Example: If sending back to the initiation step
within the Manager Evaluation subprocess,
you would specify the WID of the Start
Performance Review event.
• Event Description: Workday doesn't save
this information. You can use this field to
include a more understandable description of
the Event.
• Business Process Step ID (Required):
Populate the field with the reference ID of the
Step ID that you’re sending back to.
• Business Process Step Description:
Workday doesn't save this information.
You can use this field to include a more
understandable description of the business
process step ID.
• Comment (Required): Enter any information
that you wish in this comment field.
• After you load the EIB, you might want to rerun
the report in Step 1 to verify that Workday sent
the events successfully back to the proper step.

Common Issues and Errors

Issue Cause and Solution

EIB issues this error: You can:


Manual Send Back isn’t available for this event. • Verify that the WID, populated in the EIB, is
Ensure this event currently allows Manual Send correct. Refer to Step 1 above for instructions to
Back, and you have the security permissions to get the WID.
perform this action. • Verify that the Business Process Step ID,
populated in the EIB input file, is correct. Refer
to Step 2 above for instructions to get this ID.
• Verify that you have permissions needed to
complete the Manual Send Back.
• You might also want to send back one of the
events manually to verify that it works within
the UI.

EIB issues this error: Populate the Comment field in the EIB input file.
Element Content 'Comment' is required, on internal
element 'Send Back Business Process Data'.

EIB issues this error: You can:


Validation error occurred. You can’t send the event • Verify that the Business Process Step ID,
back to this business process step. Specify a valid populated in the EIB input file, is correct.
business process step ID. • You might also want to send back one of the
events manually to the business process step
that you’re specifying in the EIB. This action
enables you to determine if the UI permits you to
select the step.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 282

Use Cases and Guidelines for Recovering from a Bad Load


• Once completing the send back, you can't reverse it. If you inadvertently send back the step, you might
need to do 1 of these options:
• Advance the step (if this option is available for the business process you’re using).
• If you can’t advance: Manually complete the steps to get back to the proper business process step
within the event.
For reference documentation for all web services including Send Back Business Process, see Operation
Directory.

Sample EIB Input File


Send_Back_Business_Process-WD35

Learning EIBs
Concept: Cancel Learning Enrollment EIB

Background
You can use this EIB to cancel learning enrollments with a cancel reason.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Mass Cancel Learning Enrollments
• Waive Learning Assignment
• On the related actions menu of a learning enrollment, select Cancel Learning Enrollment.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Cancel
Learning Enrollment business process type in
the Learning Core functional area to run this
EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 283

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files. Additionally, as you populate the EIB input
file, consider:
• Spreadsheet Key: Specify a unique value for
each enrollment that you want to cancel.
• Learning Enrollment: Specify the reference
IDs of the learning enrollments that you want to
cancel. Consider creating a custom report with
the Learning Enrollments data source to get
the learning enrollments IDs.
• Cancel Reason: Specify the reference IDs
of the cancel reasons you want to use for
each learning enrollment. You can find a list
of reference ID values by running the View
Reference IDs report and searching for the
Cancel Enrollment Event Subcategory business
object. You can create cancel reasons using
the Maintain Cancel Enrollment Reason
Categories task (secured to the Set Up:
Learning Catalog domain in the Learning Core
functional area).

Common Issues and Errors

Issue Cause and Solution

EIB issues an error like this: Currently, you can't waive or cancel a completed
enrollment that's based on a learning assignment.
Validation error occurred. Enrollments that have
learning assignments can't be canceled.

Unable to launch the EIB This is most likely security-related.


Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Cancel Learning Enrollment
business process type in the Learning Core
functional area.

Business Processes
Cancel Learning Enrollment.

Use Cases and Guidelines for Recovering from a Bad Load


You can't rescind this EIB. If you've canceled enrollments by mistake, and if the business process event
is still in progress, you can run the Mass Cancel Business Processes task (secured to the Business
Process Administrator domain in the System functional area) to attempt to cancel the business process
before it completes.
For reference documentation for all web services including Cancel Learning Enrollment, see Operation
Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 284

Sample EIB Input File


Cancel_Learning_Enrollment-WD36_0

Concept: Enroll in Learning Content EIB

Background
You can use this EIB to enroll in learning content using the Enroll in Content business process. We
recommend using this EIB for new enrollments that haven’t started yet. The reminders you configure for
learning content also work with this EIB. See Create and Manage Reminders for Learning Content.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See:
• Mass Enroll Learners.
• Steps: Set Up and Launch Learning Campaigns (for scheduling a campaign).
There are also similar EIBs that you can use for learning enrollments. Consider these options as you
determine what works best for you:
• Put Learning Enrollment: You can use this EIB to create or update enrollments.
• Put Learning Imported Record: You can use this EIB to load historical enrollments.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Enroll in
Content business process type in the
Learning Core functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each enrollment.
• Learning Content: Enter the reference
ID value for the course or course offering.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 285

There are 3 different reference ID


types that you can specify in cell C4:
Learning_Course_ID , Learning_Course and
Learning_Course_Offering_ID.
• If loading enrollments for a course
(with no offering), use either the
Learning_Course_ID or Learning_Course
reference ID types. To find reference ID
values, access the View Reference IDs
report for the Learning Course business
object.
• If loading enrollments for offerings,
use the Learning_Course_Offering_ID
reference ID type. To find reference ID
values, access the View Reference IDs
report for the Learning Course Offering
business object. Note: The course offering
must be open.
• Learner: You might need to change
the reference ID type in cell D4 from
Academic_Affiliate_ID to Employee_ID
(or whatever learner type you're loading).
If populating values for multiple types of
learners, such as both employees and
contingent workers, consider using the
Separate Type Column option. This option
enables you to load both types of learners in
the same EIB input file. See Customize EIB
Spreadsheet Template.
• Required: Enter Y or N
• Due Date: If you specify a due date, use
format YYYY-MM-DD

Common Issues and Errors

Issue Cause and Solution

EIB issues an error similar to this message: This issue can occur if the Learner has an incorrect
reference ID type. If you’re enrolling employees:
Invalid ID value. '21289' is not a valid ID value for
type = 'Academic_Affiliate_ID' 1. Edit the EIB input file.
2. Change the value in cell D4 from
Academic_Affiliate_ID to Employee_ID.
If you're populating values for multiple types of
learners such as both employees and contingent
workers, consider using the Separate Type Column
option. This option enables you to load both
types of learners in the same EIB input file. See
Customize EIB Spreadsheet Template .

EIB issues an error similar to this message: This issue can occur if you specify a value for a
Learning_Course_ID, but you've set the EIB input
Invalid ID value. 'DIGITAL_COURSE-16-37' is not a
file to use a Learning_Course reference ID type. To
valid ID value for type = 'Learning_Course'

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 286

Issue Cause and Solution


resolve this issue, change the value in cell C4 from
Learning_Course to Learning_Course_ID.

EIB issues an error similar to this message: Workday returns this error if you're adding an
enrollment for a blended course, but specifying
Validation error occurred. Invalid instance
a course ID instead of an offering ID. Blended
17815$25 for Learning_Registerable_to_Enroll_In--
courses must have an open offering ID associated
IS (15$394657)
with the course. To resolve this issue:
1. Ensure that there’s an open offering associated
with the blended course. If you don’t have
regular offerings, you can create a single
offering for that blended course and use the
same Learning_Course_Offering_ID each time.
2. Change the value in cell C4 to
Learning_Course_Offering_ID.

Workday doesn't launch the EIB. This issue is most likely security-related. See
Web Service Version and Security Configuration
Guidelines.

EIB fails with this error message: Ensure that you have Put access to the Learning
Access domain security policy.
Validation error occurred. The entered information
does not meet the restrictions defined for this field.
(Learning_Course_Reference).

When configuring a notification within the Enroll in Currently, the only Due Date that is accessible
Content business process definition that includes from the notification is the due date of the business
a Due Date, the notification doesn't display the Due process event itself. The enrollment due date
Date. isn't accessible from within the Enroll in Content
business process definition.
If you have to include the Enrollment Due Date
in the notification, consider creating a custom
report from the Learning Assignment by Learning
Organization data source. Then, configure an alert
that uses this custom report.

Business Processes
Enroll in Content.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new enrollments. You can't update existing enrollments or remove
enrollments.
• If you’ve inadvertently uploaded incorrect entries, use the Mass Cancel Business Processes or Mass
Rescind Business Processes tasks. What you use depends on whether the business process event
has completed or is still in progress. You can then select Business Processes Loaded by EIB to find the
integration event that you want to cancel or rescind. Alternately, enter Enroll in Content at the Business
Process Types prompt and enter a date range that you ran the EIB.
• If you need to update due dates, another option is to use the Reset Learning Due Dates task.
For reference documentation for all web services including Enroll in Learning Content, see Operation
Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 287

Sample EIB Input File


Enroll_In_Learning_Content-WD36

Concept: Manage Course Offering EIB

Background
You can use this EIB to schedule and make changes to course offerings, including Microsoft Outlook
calendar invites.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Tasks


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Edit Course Offering
• Schedule Offering

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage
Course Offering business process type in the
Learning Core functional area to run this EIB.

Guidelines for Modifying the EIB Template There are some fields within the EIB input file,
where you can specify multiple reference id types.
If you want to make use of multiple reference id
types, then you should edit the template model and
configure these fields to use separate type column.
You can then populate all reference id types in
the same EIB input file. Example: To configure
the template to support both external and internal
instructors:
1. From the related actions of your EIB, select
Template Model > View.
2. In the left panel, click each section to find the
fields you want to configure to use multiple
reference ID types.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 288

3. From the related actions of the field you want to


change, select Template Model Column > Edit
Details.
4. Select the Reference ID Type as Separate
Column check box.
5. Additional information to consider:
• You can apply the same steps to other fields
if needed.
• If you’re changing your EIB input file to
accept multiple ID types for Instructors,
you'll need to repeat the above steps for
other sections of the template since the EIB
input file uses the Instructor fields in multiple
sections.
6. Regenerate the template. You’ll have a column
to specify the reference ID type and another
column to populate the value.

Guidelines for Creating a Custom Report for the You might find it helpful to create a custom report to
EIB Input File assist with populating the EIB input file. This custom
report might be particularly helpful if updating
existing course offerings. Consider using Learning
Content report data source. Using this data source,
you can access fields such as:
• Blended Course
• Course Offering
• Learning Content Number
• Start Date / End Date
• Instructors
• Course Offering Locations
• Lesson Content Type
• Title

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• NOTE: This web service doesn’t support
incremental updates. If you’re updating an
existing offering, it’s important to populate all
existing data in the EIB input file, so the EIB
input field doesn't remove it. Also, if adding or
updating an offering with multiple lessons, you
should populate the EIB input file with all lessons
so that they display on the offering.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 289

• Below are additional details for some of the


fields with focus on the most commonly used
fields:
• Spreadsheet Key: Specify a unique value for
each course offering.
• Course Offering: If updating an existing
course offering, enter the reference id here.
Another option is to use a custom report to
identify the reference id value.
• Blended Course: Enter the reference id of
the course where you’re adding offerings.
To find the reference id value, you can
run the Integration IDs report and select
business object Multi Course Template. .
You could also use a custom report. Note
that when populating the Blended Course
field, you can either enter the reference id for
Learning_Course_ID or for Learning_Course.
Change the value in cell E4 to reflect the
reference id type that you use.
• Instructor: To find reference id values for
this field, you can:
1. Run the View Learning Instructor report.
2. Get the reference id value from the
related actions of the instructor that you’re
using. Note that you can have internal
and external learning instructors. Make
certain that the reference id type, in row
4, specifies the proper reference id type
based on the type of instructor you’re
populating.
3. If you need to populate both internal and
external instructors in the same input file,
then follow the steps in Guidelines for
Modifying the EIB Template section 2
so that you have a separate column to
populate the reference id type.
• Required Learning Course Content: Set
this field Y for at least 1 lesson.
• Location: To find reference id values for this
field, you can run the Integration IDs report
and select Location business object.
• Start Date and End Date: Enter date
and time for start and end of lesson.
No need to specify time zone since the
EIB input file stores it in a separate field
(Time Zone). The start date and end date
fields should use format: YYYY-MM-
DDTHH:MM. Example: 2021-09-01T14:00). If
needed, you can enter times with precision
down to the microsecond. Example:
2021-12-31T09:00:00.000). Make certain

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 290

that the cells holding start/end dates are text


format.
• Time Zone: To identify the reference id
values, run Integration IDs report and search
business object Time Zone.

Common Issues and Errors

Issue Cause and Solution

Some of the field values that were previously in the This web service doesn’t support incremental
offering disappear after using the EIB to update updates. Therefore if you’re updating an existing
existing offerings. offering, it’s important to provide all existing data
to avoid lost data. Also, if adding or updating an
offering with multiple lessons, you should populate
the EIB input file with all lessons so that they
display on the offering.
If you inadvertently remove data, use the mass
rescind business process task to back out the
EIB updates.

EIB issues an error like this: Double check the reference id type used in the
Blended Course field in the EIB input file. Note that
Validation error occurred. Invalid ID value.
there are 2 reference id types you can select from:
'MULTI_COURSE_TEMPLATE-16-23' is not a valid
ID value for type = 'Learning_Course'. 1. Learning_Course
2. Learning_Course_ID
Verify which one you’re using and then change the
value in cell E4 accordingly.

EIB issues an error like this: Populate row id in column F (section Learning
Course Offering Detail Data+ (All > Course Offering
Validation error occurred. Element Content
Data)).
'Learning_Course_Offering_Detail_Data' is
required, on internal element 'Learning Course
Offering Data'.

Offering loads but there are no lessons. Make certain row id value displays in column AQ
(section Offering Lesson Data+ (All > Course
Offering Data > Learning Course Offering Detail
Data+). Also, the EIB should have an entry for each
lesson within the offering.

EIB issues an error like this: Double check any start dates in the EIB input file to
verify they are after the effective date specified in
The Start Date must be on or after 11/05/2020, the
the error message. Also, verify that the dates are
Effective Date of the Learning Course..
intext cells and are using this format: YYYY-MM-
DDTHH:MM.

EIB issues an error like this: Edit the EIB input file and set field Required
Learning Course Content to Y for at least 1
Set Make Lesson Mandatory on at least 1 lesson..
lesson.

Unable to launch the EIB. This issue is most likely security-related. See the
Additional Input File Guidelines section.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 291

Business Processes
Manage Course Offering.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new offerings or update existing offerings. You can’t delete
offerings.
• If you've inadvertently uploaded incorrect entries, use the Mass Cancel Business Processes or
Mass Rescind Business Processes tasks. What you use depends on whether the business process
event completed or in progress. You can then select Business Processes Loaded by EIB to find the
integration event that you wish to cancel or rescind. Your other option is to enter Manage Course
Offering at the Business Process Types prompt and enter a date range that you ran the EIB.
For reference documentation for all web services including Manage Course Offering, see Operation
Directory.

Sample EIB Input File


Manage_Course_Offering-v40

Concept: Manage Extended Enterprise Learner EIB

Background
You can use this EIB to create or update extended enterprise learners.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
For more information about extended enterprise learners, see Setup Considerations: Extended Enterprise
Learning.

Equivalent Workday Tasks


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Extended Enterprise Learner
• Edit Extended Enterprise Learner

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage
Extended Enterprise Learner business

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 292

process type in the Extended Enterprise for


Learning functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that
you generate your spreadsheet with data for
the Manage Extended Enterprise Learner EIB.
See: Example: Generate EIB Spreadsheet
Template with Data on page 62.
• As you populate these field in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each Extended Enterprise Learner.
• ID: If updating an existing Extended
Enterprise Learner, enter the ID here. To
find the ID, you could create a custom report
from the Extended Enterprise Learners
data source.
• External Learning User: Enter the reference
ID of the External Learning User (ELU). To
find the ID, you can create a custom report
using data source External Learning User.
• Send Email Notification for User Name and
Send Email Notification to Password: Set
these fields to value Y if you’re creating new
accounts and want to notify the users.

Common Issues and Errors

Issue Cause and Solution

After running the EIB to update existing Enterprise This web service removes existing values for some
Learners, some of the field values are missing such fields, if the EIB input file doesn't populate a value.
as the Extended Enterprise Learner Type. Therefore, we recommended you generate the
spreadsheet with data so you don't lose existing
data.

The extended enterprise learner isn't receiving Edit the EIB input file and check the setting for
email notifications their new account and password. fields Send Email Notification for Username and
Send Email Notification for Password.

Unable to launch the EIB. This issue is most likely security-related.

Business Processes
Manage Extended Enterprise Learner.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new Extended Enterprise Learners or update existing Extended
Enterprise Learners. You can’t delete Enterprise Learner.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 293

• Although this web service uses a business process, it doesn’t permit rescinds. However, you can cancel
the event if it’s still in progress.
• If you have inadvertently uploaded incorrect entries, we suggest you:
• Reload the entries with correct information.
• If you need to restore the original values, you could find another tenant, such as a sandbox or
implementation tenant, that still has the correct information.
• Use generate with data in that tenant to build an EIB input to load into the tenant with incorrect
information.
• You can’t delete Extended Enterprise Learners. If you accidentally load new Learners that you don’t
wish to keep, you could update the Learners and enable the Persona Inactive field.
For reference documentation for all web services including Manage Extended Enterprise Learner, see
Operation Directory.

Sample EIB Input File


Manage_Extended_Enterprise_Learner-WD37

Concept: Manage External Learning User EIB

Background
You can use this EIB to create or update external learning users.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
For more information about external learning users, see Setup Considerations: Extended Enterprise
Learning.

Equivalent Workday Tasks


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create External Learning User
• Edit External Learning User

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage
External Learning User business process
type in the Extended Enterprise for Learning

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 294

and Learning Core functional areas to run


this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that
you generate your spreadsheet with data for
the Manage External Learning User EIB. See:
Example: Generate EIB Spreadsheet Template
with Data on page 62.
• As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each External Learning User (ELU)
• ID: If updating an existing ELU, enter the
ID here. To find the id, you could create a
custom report using the External Learning
Users data source. Or the other option is to
generate the spreadsheet with data.

Common Issues and Errors

Issue Cause and Solution

EIB issues errors like this: These messages indicate that you’re attempting to
add an ELU that has a username or email address
• Enter a username that isn't already in use..
that is already in use.
• Submit an email address that isn’t already in use
by an external learning user.. If you’re updating an existing ELU, you need to
populate the ID of the ELU in the ID column.

Unable to launch the EIB. This issue is most likely security-related.

Business Processes
Manage External Learning User.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new External Learning Users (ELUs) or update existing ELUs. You
can’t delete ELUs.
• Although this web service uses a business process, it doesn’t permit rescinds. However, you can cancel
the event if it’s still in progress.
• If you have inadvertently uploaded incorrect entries, we suggest you:
• Reload the entries with correct information.
• If you need to restore the original values, you could find another tenant, such as a sandbox or
implementation tenant, that still has the correct information.
• Use generate with data in that tenant to build an EIB input file to load into the tenant with incorrect
information.
• You can’t delete ELUs. If you accidentally load new ELUs that you don’t wish to keep, you could update
the ELUs and change the email, name, and so on. You could precede the values with DNU or another

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 295

value to indicate they aren’t of use. Note that the username can’t be changed. Also, the ELUs will
remain inactive as long as there are no active persona’s associated with the ELU.
For reference documentation for all web services including Manage External Learning User, see Operation
Directory.

Sample EIB Input File


Manage_External_Learning_User-WD37

Concept: Manage Learning Course EIB

Background
You can use this EIB to create or update blended and digital learning courses.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Course.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage
Learning Course business process in the
Learning Core functional area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• You might find it helpful to start by manually
entering a course similar to the courses you
want to load using the EIB. It can help you verify
which fields Workday requires. It might also be
helpful when populating reference id values in
the input file, as you can view the reference id
values from the related actions of the course you
manually created.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 296

• If updating existing learning courses, to avoid


losing data, you must populate all existing data
in the EIB input file.
• Be certain you test first in a nonproduction
tenant, as it can be difficult to reverse the
updates, if incorrectly loaded.
• When populating reference ideas, you might
find it helpful to create a custom report from the
Learning Content data source to identify the
reference id values.
• There are separate sections within the input file
for Blended Courses and Digital Courses.
You’ll need to fill out the appropriate sections
based on the type of courses you’re loading.
• First Section (Blended Courses): If you’re
populating fields in this section of the input
file, consider:
• Spreadsheet Key: Specify a unique value
for each Course: note that all Lesson
entries within the Course will have the
same spreadsheet key value.
• Learning Blended Course Field: If
updating an existing blended course,
supply the reference id value here. Also,
when updating a course, to avoid losing
information, you must include existing
information for all lessons in the input file.
• Workdrive Document Content: If you
need to populate images that Drive
previously uploaded, run View Reference
IDsreport for Workdrive Document
Content to get the image's file ID. Then
populate in the Workdrive Document
Content field.
If populating images that the input field
didn't previously load, refer to images
section below.
• Images: Refer to Images section below
for more details about populating images.
• Course Lesson Data Section: You’ll
need to add 1 row for each lesson.
Each row needs to have a unique row id
assigned.
• Language: Specify the Language
Workday ID (WID) or the
User_Language_ID. Run the Integration
IDs report and select the User Language

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 297

business object to find the list of


User_Language_IDs.
• Second Section (Digital Courses): If you’re
populating fields in this section of the input
file, consider:
• You need to load your media before
running the EIB. Then you can reference
the media reference id value in the EIB
input file.
• Also note that versioning and capacity
functionality isn’t available at this time
(Oct 2018) for Digital Course so leave
these fields blank.
• Spreadsheet Key: Specify a unique value
for each Course. Note that all Lesson
entries within the Course will have the
same spreadsheet key value.
• Learning Digital Course: If updating
an existing digital course, supply the
reference id value here. When updating
a course, you need to include existing
information for all lessons in the input file
to avoid losing the information.
• On Demand: When a course is On
Demand it means it doesn’t require
enrollment, and that the students can
take the course at their convenience. If a
course isn’t On Demand, the student must
enroll in the course to take it. So, if you
would like a course to require enrollment,
you would fill out the EIB and set On
Demand to N. If you would like a course
not to require enrollment, you would fill out
the EIB and set On Demand to Y .
• Course Lesson Data Section: You’ll
need to add 1 row for each lesson.
Each row needs to have a unique row id
assigned.
• Language: Specify the Language
Workday ID (WID) or the
User_Language_ID. Run the Integration
IDs report and select the User Language
business object to find the list of
User_Language_IDs.
• Workdrive Document Content: If you
need to populate images previously
uploaded by Drive, run View Reference
IDs report for Workdrive Document
Content to get the image's file ID. Then
populate in the Workdrive Document
Content field.
• Images: It can be challenging to populate
new images in the EIB due to Excel
limitations and because the images must

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 298

be base64 encoded. Below are steps to


populate images within the EIB input file:
• Start by converting your image to base64.
You can use any base64 encoder tool of
your choice (Workday doesn't endorse
any encoder tools, so proceed at your
own risk).
• Note that Excel allows only 32,767
characters per cell. After you complete the
above step, check the size of the encoded
value. If it is over 32,000 characters, you’ll
need to select the appropriate option:
• Option 1: Manually load the image
with the user interface.
• Option 2: You might be able to reduce
the size of the image to get it small
enough to place in the EIB input file.
Example: by using a tool such as
ImageSmaller (Note that Workday
doesn't endorse this tool. Proceed at
your own risk). Then after reducing the
size of the image, encode it again and
verify it’s fewer than 32,767 characters.
• Option 3: Before you load the input
file, use an xml editor or text editor
such as Notepad++ and edit the EIB
input file. Then paste the encoded
image value into the file. It might be a
bit tedious, however, it would enable
you to work around the Excel limitation.
• Option 4: Look into using a custom
integration (such as Studio integration)
instead of using EIB.
• After loading the EIB input file, use report
Manage Courses and Lessons to validate the
load.

Common Issues and Errors

Issue Cause and Solution

When loading a digital course, you receive this This error is security-related. Be sure to share the
error: media on the Drive folder for the integration owner
to access it.
The entered information does not meet
the restrictions defined for this field.
(Media_Reference).

You receive these errors when attempting to load a We don’t support a reference to an existing image
course where you specify the reference id value for at this time.
an existing image:
• Element Content 'Image' is required, on internal
element 'Learning Image Data'.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 299

Issue Cause and Solution


• Element Content 'File_Name' is required, on
internal element 'Learning Image Data'.
• Element Content 'Content_Type' is required, on
internal element 'Learning Image Data'.

When loading a digital course, and specifying The Content Type is case-sensitive. Make certain
image information, you receive this message: its lower case. Example: use image/png instead of
Image/png.
Validation error occurred. Content Type not
supported. An image is required..

EIB fails with error: This issue occurs if reference ID/WID value is
incorrect for the file. You can:
You can only add a file from Drive as the media for
a learning lesson if you're the owner of the file or it's 1. Edit EIB input file.
shared with you. 2. Locate the Workday Drive Content field.
3. Verify that you populated the correct Workday
ID (WID) or Reference ID value.

EIB fails with error: This issue occurs if you include multiple lesson
types within the same row, within the EIB input file:
Validation error occurred. Multiple Element
Check your EIB input file to:
Contents, including Learning Course Lesson Data/
g/External Content Lesson Data [EL], contain • Verify that you're not populating more than 1
data where only one is allowed by mutex Learning lesson type section in each row.
Course Lesson Data. • Also, verify that no extra fields are accidentally
visible in the other lesson sections.

When updating an existing course, EIB fails with an This issue occurs if attempting to update or
error like this: inactivate an external learning course, which this
EIB doesn't support. Options:
Validation error occurred. Invalid instance 22699$2
for Digital_Course_Secured_for_Web_Services--IS • Manually update or inactivate the courses.
(15$390633). • If the courses are Skillsoft courses, try clearing
the courses in the Skillsoft Portal. After running
a delta integration, they should become inactive
in Workday Learning.

Business Processes
Manage Course.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add new entries or update existing entries. You can’t delete entries,
however you can set existing entries to inactive.
If you have inadvertently uploaded incorrect entries, there are a couple options to recover:
• OPTION 1: Use either Mass Rescind or Mass Cancel (depending on whether the business process
event is complete or in progress). You can then select Business Processes Loaded by EIB to find the
integration event that you wish to cancel or rescind. Note that this option won’t completely remove the
changes, but rather inactivate them.
• OPTION 2: Rerun the EIB with the entries you inadvertently added, and set the Inactive flag to Y. You
might also want to add DNU to the course title.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 300

For reference documentation for all web services including Manage Learning Course, see Operation
Directory.

Sample EIB Input File


Manage_Learning_Course-v40_0

Concept: Put Learning Enrollment EIB

Background
You can use this EIB to create, update, or rescind legacy enrollments.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Mass Enroll.
There are also similar EIBs related to learning enrollment. Consider these options as you determine what
works best for you:
• Cancel Learning Enrollment: You can use this EIB to cancel learning enrollments with a cancel reason.
• Enroll in Learning Content: You can use this EIB to enroll in learning content using the Enroll in Content
business process.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Reports:
Learning Record domain in the Learning
Core functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Additionally, as you populate the EIB input file,
consider:
• Learning Enrollment: For new enrollments,
you can leave this field blank and enable
Workday to assign a value. However, if
you want to assign a value, make certain
the value is a unique value. If updating an

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 301

existing enrollment, you need to specify the


Learning_Enrollment_ID for the enrollment.
If updating existing enrollments, you might
want to create a custom report using data
source Learning Enrollments to help you
find the reference IDs.
• Learning Course: If a course has
offerings, you would need to use reference
ID Learning_Course_Offering_ID.
Otherwise, you could use reference ID
Learning_Course. (Note that a blended
course requires an offering ID). You can
look up the reference ID values for Learning
Course and Learning Course Offering using
View Reference IDs.
• Learner: If you’re adding enrollments for
both employees and contingent workers,
you might find it helpful to split the columns
using the Separate Type Column option. By
doing this, you can list both employees and
contingent workers in the same EIB input
file. For more information, see Customize EIB
Spreadsheet Template.
• Learning Enrollment Completion Date:
You can specify a date and time, or just
specify a date. If you specify just a date, then
it defaults to the time 12:00 am PT. Note that
any times you provide are considered to be
Pacific Time. If you're in another time zone,
you might find it preferable to populate the
input file using a UTC offset to correctly load
the time zone for completion date.
Examples showing the UTC format:
• Oct 25 at 8:00am CET is:
2020-10-25T08:00:00+02:00
• Oct 25 at 8:15am EST is:
2020-10-25T08:15:00-05:00
• Oct 25 at 8:15am EDT is:
2020-10-25T08:15:00-04:00
• Expiration Date: If you populate this field
and set the Manual Expiration Override
to N, Workday uses the expiration settings
defined on the learning content. If you set
Manual Expiration Override flag to Y,
Workday uses the expiration date defined in
the EIB input file and overrides the expiration
settings on the learning content.
• Rescind Enrollment: Set to Y to rescind the
enrollment. Note that this field works only for
enrollments loaded using the web service.
If you loaded them using user interface (UI),
then use the rescind functionality of the UI
(which uses a business process event).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 302

Common Issues and Errors

Issue Cause and Solution

The EIB fails with error: This issue occurs if you’re adding a new enrollment,
but specifying a Learning Enrollment reference ID
Invalid Worker for Enrollment.
value that already exists. If you’re creating a new
learning enrollment, you can leave the Learning
Enrollment field blank so that the Workday can
assign a unique value.

The EIB fails with an error like this: This issue occurs if you’re adding or updating
enrollments for a course with offerings, yet you
Validation error occurred.
specify a Learning_Course_ID value in the
Invalid instance 17815$1 for
Learning Course field. Instead, you would need
Learning_Registerable_Secured_by_Transactions--
to specify a Learning_Course_Offering_ID. Also,
IS (15$382741).
please note that if you’re loading information for a
blended course, then you must populate a course
offering ID. Otherwise, you’ll receive this error.

The EIB fails with an error like this: This issue occurs if the EIB input file is using
reference ID type Learning_Course_Offering_ID
Validation error occurred. Invalid ID value.
but you’re adding enrollments for a course with no
'xxx' is not a valid ID value for type =
offerings.
'Learning_Course_Offering_ID'..
To resolve this, edit the EIB input file and change
the reference ID type for Learning Content in cell
E4 to Learning_Course_ID.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add, update, or delete learning enrollments.
If you have inadvertently uploaded incorrect entries, reload the entries and set the field Rescind
Enrollment in the input file, to Y.
For reference documentation for all web services including Put Learning Enrollment, see Operation
Directory.

Sample EIB Input File


Put_Learning_Enrollment-v39

Concept: Put Learning Imported Content EIB

Background
You can use this EIB to create a shell of a course for noncatalog content. You can then load learning
records for the course using these EIBs:
• Manage Learning Course
• Put Learning Enrollment
• Put Learning Imported Record
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 303

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Set Up:
Learning Catalog domain in the Learning
Core functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Additionally, as you populate the EIB input file,
consider:
• This EIB has a Generate Spreadsheet with
Data option. To use it:
• From related actions of your EIB, select
Template Model > View.
• Select Edit Template with Data Options.
• Set the filter to Condition Rule Filter.
• Enter a rule condition that always
evaluates to true. Example:1=0 is blank.
• If you regenerate the template and select
the Generate Spreadsheet with Data
option, you can view all the existing
entries.
• If creating a new entry, populate the fields as
follows:
• Spreadsheet Key: Specify a unique value for
each course.
• Learning Imported Content: Leave this field
blank.
• ID: You have the option of entering a
reference id value, or leaving the field
blank so that the web service automatically
populates the field.
• Title: Specify a unique title for imported
content.
• Description: Description for imported
content.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 304

• To update an existing entry, populate the fields


as follows:
• Spreadsheet Key: Specify a unique value for
each course
• Populate just 1 of the 2 following fields:
• Learning Imported Content: Enter
the Course Title and set cell C4 to
Learning_Imported_Content. Another
option is to specify the Workday ID (aka
WID), and set cell C4 to value WID.
• ID: If you don’t populate Learning
Imported Content field (above), then
populate this field with the reference id
value. To find the reference id value,
you can run Integration IDs report and
select business object Learning Imported
Content.
• Title: Specify a unique title for imported
content.
• Description: Description for imported
content.

Common Issues and Errors

Issue Cause and Solution

Unable to launch the EIB Make certain you have Put access to domain
security policy Set Up: Learning Catalog (you
can find this information by running report View
Security for Securable Item and selecting
business object Put Learning Imported Content).

EIB issues errors like this: This issue will occur if you attempt to add a new
entry that has the same Title as an existing entry.
Processing error occurred. Duplicate Value Found
To resolve this issue:
on Learning Imported Content-Title-Learning
Imported Content, value=xxxxxxx 1. If you want to add a new entry, you’ll need to
change the Title to make it unique.
2. If your intention is to update an existing entry,
specify the course name in the Learning
Imported Content field.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries
• Since this EIB doesn’t use a business process, there’s no option to rescind or cancel. If you have
inadvertently uploaded incorrect entries, you might want to update the entries and add DNU to the
beginning of the title and description.
For reference documentation for all web services including Put Learning Imported Content, see Operation
Directory.

Sample EIB Input File


Put_Learning_Imported_Content-WD34

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 305

Concept: Put Learning Imported Record EIB

Background
You can use this EIB to load learning records for courses that you created using a Put Learning Imported
Content EIB.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
When you load historical learning records with this EIB, the information only displays in the learning section
of the career tab in the worker's profile (secured to the Person Data: Learning domain in the Learning Core
functional area). The historical learning records don't display on any other dashboards and reports, except
the Learning Record. report data source.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Reports:
Learning Record domain in the Learning
Core functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each learning record.
• Learning Imported Record: If creating
a new assignment, leave this field blank.
If updating an existing assignment, we
recommend populating the Workday ID (aka
WID). You’ll need to set cell C4 to value WID.
See the Sample EIB Input File section below.
• ID: Populate this field as follows:
• If adding new content: You can leave this
field blank. Or if you want to assign the
reference id value, populate a value here
(make certain that the value isn’t already
in use).
• If updating an existing entry, you can
enter the reference id here. Note that it's

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 306

necessary only if you didn’t populate


the Learning Imported Record field (see
above). You can identify the reference
id value, by running the Integration IDs
report and selecting business object
Learning Imported Record.
• Learner: Enter the reference id of the
learner. If the learner is an employee, enter
the employee ID. Most likely, you’ll want to
change cell E4 from Academic_Affiliate_ID to
Employee_ID.
• Learning Imported Content: Enter the title
of the course that you’re assigning to the
learner. Note that you must specify a course
that the Put Learning Imported Content web
service created. To get a list of course titles,
run the Integration IDs report and select
business object Learning Imported Content..
• Start Date: You can specify a date and
time, or just specify a date. If you specify
just a date, then it will populate the time
12:00 am PT. Note that any times you
provide are considered as Pacific Time. If
you're in another time zone, you might find
it preferable to populate the input file using
a UTC offset to correctly load the time zone
for start date. Examples showing the UTC
format:
• Feb 25 at 8:00am CET is
2020-02-25T08:00:00+02:00.
• Feb 25 at 8:15am EST is
2020-02-25T08:15:00-05:00.
• Feb 25 at 8:15am EDT is
2020-02-25T08:15:00-04:00.
• Completion Date: Enter completion date.
You have the same date/time formatting
options as available for the Start Date field
(above).
• Learning Grade: To find the reference
id value for the learning grade, run report
Integration IDs and search business object
Learning Grade..
• Overall Score: If entering a score, use
format 99.999.
• Inactive: Enter Y to inactivate the learning
record. If set to Y, the entry won’t display
in the worker's learning transcripts nor the
report.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 307

Common Issues and Errors

Issue Cause and Solution

Unable to launch the EIB Make certain you have Put access to domain
security policy Reports: Learning Record. You
can find this information by running report View
Security for Securable Item and selecting
business object Put Learning Imported Record.

EIB issues an error like this: Make certain that you’re specifying the appropriate
reference id type in cell E4 of the EIB input file.
Invalid ID value. '21289' isn’t a valid ID value for
Example: If the learner is an employee, the
type = 'Academic_Affiliate_ID'.
reference id type would be Employee_ID.

EIB issues this error: If you’re adding a new assignment, then make
certain you don't populate a value in the Learning
You can't update a person when updating a
Imported Record field (column C) or the ID field
tracking record.
(Column D).

Even though the EIB successfully loads the This issue will occur if the Inactive flag is set to Y in
learning records, they don’t display in the worker's the EIB input file. If you inadvertently set the flag to
learning transcript or in the report. Y, you can use the EIB to correct the entries.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries.
• Since this EIB doesn’t use a business process, there’s no rescind option. If you have inadvertently
uploaded incorrect entries, reload the entries and set the Inactive field to Y.
For reference documentation for all web services including Put Learning Imported Record, see Operation
Directory.

Sample EIB Input File


Put_Learning_Imported_Record-WD34

Payroll EIBs
Concept: Assign Costing Allocation EIB

Background
You can use this EIB to add, update, or delete costing allocations (distributions) based on worker, position,
earning, and position restrictions criteria. This EIB doesn't process earning-level costing overrides.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Assign Costing Allocation.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 308

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Assign Costing
Allocation business process type in the Core
Payroll and Payroll Interface functional areas
to run this EIB.
• You must also have access to the
organizations that the costing allocation is
associated with.

Guidelines for Modifying the EIB Template You can modify your EIB template and use it
for allocations that have more than 1 worktag.
1. From related actions of your EIB, select
Template Model > View.
a. Select Costing Allocation Detail Data +.
b. Select the magnifying glass next to Costing
Override Worktag+.
c. On the related actions menu of the
magnifying glass, select Template Model
Column > Maintain Additional Columns.
2. Add a row for each worktag that you want to
use.
We recommend also applying these changes to
prevent the FLSA Workweek Calendar column
from displaying next to each worktag in your EIB
input file:
1. From related actions of your EIB, select
Template Model > View.
a. Select the magnifying glass next to Costing
Override Worktag+.
b. On the related actions menu of the
magnifying glass, select Template Model
Column > Maintain Additional Columns.
2. Select Costing Allocation Detail Data +.
3. Select the magnifying glass next to FLSA
Workweek Calendar.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 309

4. On the related actions menu of the magnifying


glass, select Template Model > Edit Details >
Hide.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
If you want to update existing costing allocations,
consider:
• Making a copy of the All Workers Costing
Allocations standard report.
• Modifying it to include only the information you
need to update or replace through the EIB.
• Using the report to help populate your EIB input
file.
As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each costing allocation.
• Worker: Specify the ID of the employee or
contingent worker. If you want to specify
values for employees, you need to change
the reference ID type in cell C4 from
Contingent_Worker_ID to Employee_ID.
• Position: Optional. You can specify a position
level for the costing allocations.
• Earning Code: You can specify an earning level
for the costing allocations.
• Position Element Effective As-of Date:
Determines if the position restriction is valid: The
position restriction must be available on the as-
of-date. The position must be filled on the as-of
date.
• Replace Existing Cost Allocation Intervals:
If you set this to Y, it removes all existing
costing allocation intervals for your selected
criteria (Example: earning, worker, position) and
replaces them with the newly submitted costing
allocation interval data that you've specified in
your EIB input file. Generally, you would only
use this during initial implementation.
• Row ID (column I): Enter 1.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 310

• Section: Costing Interval Update Key+ (All):


If you want to update or delete existing costing
allocations, specify these values in this section:
• Row ID: Enter 1.
• Delete: If you want to delete costing
allocations, set to Y.
• Costing Override ID Update Key: Leave
blank. Populate the Start Date Update Key
column instead.
• Start Date Update Key: Specify the start
date of the existing allocation.
• Start Date: Specify the start date for the
allocation.
• End Date: Specify the end date for the
allocation.
• Row ID (Column Q) : Specify a unique value for
each line within a given costing allocation.
• Order: Orders the allocation details (Example: a,
b, c, and so on). During general ledger costing,
we use the last allocation detail to reconcile any
rounding issues resulting from the distributions.
• Default from Organization Assignment:
Select Yes (Y) to indicate that you want to
allocate the corresponding percentage using the
worker's (or position's) default organizational
assignments with no overrides. Workday detects
if this request represents a subevent embedded
within a higher-level business process, and if
so, searches for a possible Assign Organization
subevent containing relevant assignments.
• Costing Override Company: The overriding
company for an allocation detail. Generally, you
would use this for intercompany accounting.
• Worktag Section: Specify relevant worktags.
• FLSA Workweek Calendar:If this value
displays in your EIB input file, leave it blank.
• Distribution Percent: The distribution
percentage for a given allocation. We express
this as a decimal value. Example: 0.5 is 50
percent.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it seems • Ensure that you've specified values for all
that the data wasn't loaded. relevant columns, especially for Costing
Allocation Interval Data (column I in the EIB
input file).
• Verify that the event has successfully completed
and isn’t still in progress.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 311

Issue Cause and Solution

When updating or deleting an existing allocation, Check these:


the EIB fails with this error:
• Verify that you've populated the row ID in the
Validation error occurred. The Costing Allocation Costing Interval Update Key section.
Interval Update Keys submitted don’t correspond • Verify that the start date, populated in the
with an existing Costing Override. Costing Interval Update Key section, matches
the start date of the existing allocation.
• Check the Position column. If there's a position
assigned with the existing allocation, then you
must populate the position field in the EIB input
file.

EIB issues an error like this: Verify that there are no rows with a missing
spreadsheet key value.
Validation error occurred. Element Content
'Costing_Allocation_Data' is required, on the
internal element 'Assign Costing Allocation
Request.'

EIB issues an error like this: Verify that the reference ID is set correctly in the
Worker column of the EIB input file. If you want
Validation error occurred. Invalid ID value.
to load employees, change the value in cell C4 to
'25735' isn’t a valid ID value for type =
Employee_ID.
'Contingent_Worker_ID'

EIB issues multiple errors like this: Verify that the row ID is populated in column I of the
Costing Interval Update Key+ (All)section.
Costing Allocation Interval date ranges must not
overlap - the date range-submitted conflicts with
another proposed Costing Allocation Interval.
Allocation percentage must total 100%.
A Start Date is required when adding a new Costing
Allocation Interval.

EIB issues an error like this when updating existing This occurs if you populate both of these columns
allocations: in the Costing Interval Update Key section of the
EIB input file:
Multiple Element Contents, including Costing
Interval Update Key/b/Costing Override ID Update • Costing Override ID Update Key
Key [TX], contain data where only one is allowed by • Start Date Update Key
mutex Costing Interval Update Key.
Only populate 1 of these columns.

Unable to launch the EIB Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and have access to the Assign
Costing Allocation business process type in the
Core Payroll and Payroll Interface functional areas.

Business Processes
Assign Costing Allocation.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 312

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add, update, or delete costing allocations. If you’ve uploaded incorrect entries, you
can:
• Option 1: Create a new Assign Costing Allocation EIB to update the entries with the correct information
or delete them.
• Option 2: Use either the Mass Cancel Business Processes task (if the event is still in progress)
or Mass Rescind Business Processes task (if the event is complete). Both of these tasks are
secured to the Business Process Administrator domain in the System functional area. You can then
select Business Processes Loaded by EIB to find the integration event that you want to cancel or
rescind. Alternatively, you can enter Assign Costing Allocation in the Business Process Types prompt
and enter the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Assign Costing Allocation, see Operation
Directory.

Sample EIB Input File


Assign Costing Allocation v43.1

Concept: Assign Pay Group EIB

Background
You can use this EIB to assign workers to pay groups.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


• EIBs:
• Change Job
• Edit Position
• Workday tasks:
• Assign Pay Group

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Spreadsheet Key (Required): Specify a unique value for each pay group assignment.
• Assign Pay Group Event ID (Optional): If you want to assign a value to the event, you can specify it
here. If you leave this field blank, the EIB will automatically assign an event ID.
• Worker (Required): Specify the ID of the employee.
• Pay Group (Required): Specify the reference ID of the pay group that you want to assign to the
worker. You can find a list of reference ID values by running the View Reference IDs report and
searching for the Pay Group business object.
• Position ID (Required): Specify the position ID of the worker. Consider creating a custom report to get
the position ID.
• Effective Date (Required): Specify the effective date of the pay group assignment in this format: YYYY-
MM-DD.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 313

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it seems This might occur if the business process events are
that the data wasn’t loaded. still in progress.
• Edit the EIB input file and verify that the
processing instructions in the Overview tab are
set to Automatic Processing.
• Check the Assign Pay Group business process.
If it contains any nonessential steps (apart
from approval, review, or to-do steps), consider
adding a condition rule for the EIB to skip them.

EIB issues these errors: This occurs if the worker’s position isn’t populated
in the EIB input file. To find the position ID, use the
• Element Content 'Position_Reference' is
report outlined in section Tips for Populating the
required, on the internal element 'Assign Pay
Input File.
Group Event Data'.
• Position ID isn’t valid as of the event’s Effective
Date. Specify a different Position or Effective
Date.

The EIB isn’t automatically populating the This web service doesn’t support automatic pay
pay group even though automatic pay group group assignment: if you need to use automatic pay
assignment is configured. group assignment, use the Edit Position or Change
Job EIBs instead.

EIB issues an error like this: This occurs if you specify a value in the Assign
Pay Group Event ID column that has already been
Validation error occurred. You can’t update an
used. To address this issue, you can update the
existing pay group assignment event. To create a
EIB input file by:
new event, remove or change the Reference ID.
• Removing the value from the Assign Pay
Group Event ID column and leaving the cell
blank so that Workday can assign a unique
value.
• Or, changing the value in the Assign
Pay Group Event ID column to a unique
value hasn't already been used.

Unable to launch the EIB Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Assign Pay Group business
process type in the Core Payroll and Payroll
Interface functional areas.

Business Processes
Assign Pay Group.

Use Cases and Guidelines for Recovering from a Bad Load


• This EIB only adds new pay group assignments. You can’t update or delete entries.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 314

• If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task
(if the event is still in progress) or Mass Rescind Business Processes task (if the event is complete).
Both of these tasks are secured to the Business Process Administrator domain in the System functional
area. You can then select Business Processes Loaded by EIB to find the integration event that you
want to cancel or rescind. Alternatively, you can enter Assign Pay Group in the Business Process
Types prompt and enter the date range that corresponds to when you ran the EIB.
For API documentation for all web services including Assign Pay Group, see Operation Directory.

Sample EIB Input File


Assign_Pay_Group-WD35

Concept: Import Payroll Input EIB

Background
You can use this EIB to create or update payroll input.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Add Payroll Input by Worker.
If you want to manage bulk payroll input using worksheets, see Steps: Using Payroll Input Workbooks.
There are additional integrations and EIBs related to payroll functionality. Consider these options as you
determine what works best for you:
• Import Payroll Off-Cycle Payment: You can use this EIB to load large volumes of off-cycle payments
(Example: 1000 or more).
• Put Payroll Off-Cycle Payment: You can use this EIB to create or update off-cycle payments.
• Put Payroll History Payment: You can use this EIB to create or update payroll history payments.
• Submit Payroll Input: You can use this EIB to create or update payroll input data.
• Worker Payroll Input Async: You can use this integration template to import files with worker payroll
data from an external server into Workday. See Steps: Set Up Integration for Worker Payroll Data
Import.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 315

• Verify you have the correct security


configuration.
• You must have access to the Worker Data:
Payroll (Payroll Input) domain in the Core
Payroll functional area to run this EIB.

Additional Input File Guidelines • This EIB has a Generate Spreadsheet with Data
option, which is very helpful when you aren’t
certain how to populate the input file. To use it:
1. Manually enter a payroll input.
2. From the related actions of the input, select
Integration IDs > View IDs to get the
Payroll_Input_IDweb service (you’ll need this
later on).
3. From the related actions of the EIB, select
Template Model > View.
4. Click Edit Template with Data Options.
5. Set the filter to Reference ID Filter.
6. Enter the ID from the first step.
7. Generate a spreadsheet template and select
Generate Spreadsheet with Data.
8. You can now view the file with the payroll
input you created.
• We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Header Key: This Import web service
batches the payroll input entries into jobs and
processes them asynchronously. The value
of the header key determines how many
entries get batched per job. We recommend
you batch at least 1,000 payroll inputs per job
(test in a nonproduction tenant first to find out
what works best for you). This means that the
first 1,000 entries have a header key value of
1, the next 1,000 entries have a header key
value of 2, and so on.
• Default Batch ID: Use this when you don’t
specify any batch IDs in the Payroll Input
Data worksheet.
• Note: You typically use the same batch ID
for all entries. The batch ID is useful when
you need to validate or delete the entries
you loaded.
• Line Key: Use a unique value for each
payroll input entry within a header key.
• Payroll Input ID: When you update an
existing payroll input, you must specify
the input ID for that payroll input. To find
the ID, create a custom report using data
source "Payroll Inputs" and then add field

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 316

"Reference ID" to the report. For new


entries, the web service will populate this
value. If you opt to enter a value, make
certain you specify a new ID.
• Related Calculation: Note that
some Related Calculation codes
are Workday owned, so be sure to
specify the correct reference ID.
Example: Related_Calculation_ID vs.
Workday_Related_Calculation_ID. See
below for more details:
• After loading the payroll input, you can use the
Payroll Input by Batch ID report to view the
entries.
• You can’t add attachments to the EIB, but you
can with the Add Payroll Input by Worker task
in Workday.

Common Issues and Errors

Issue Cause and Solution

The EIB successfully finishes but some, or all, of A few possible causes:
the payroll inputs are missing.
• Since this is an Import web service, Workday
processes the data asynchronously. Though
the EIB integration event has finished, the
background job might still be running. Use the
Payroll Input by Batch ID report to periodically
monitor progress and verify that payroll inputs
continue loading.
• If you accidentally use the same line key value
for all entries, each entry will wipe out the
previous entry. Make certain that the line key is
unique for each payroll input entry.
• If you specified a Payroll Input ID in the EIB
input file, it must have a unique value for each
pay input entry. We recommend you leave it
blank if adding new entries.
• The performance will be very slow if you assign
a separate header key value to each payroll
input. Example: You upload 1,000 payroll inputs
and assign each input a different header key
value. Workday creates 1,000 background
jobs that queue up and take a long time to
process. There’s no easy way to recover from
this scenario other than to wait for all the jobs to
complete their processing.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 317

Issue Cause and Solution


• Check if FLSA calendar needs extended as
follows:
1. Search and select the task View FLSA Work
Period Calendar.
2. Search and select your FLSA calendar in the
FLSA Work Period Calendar prompt.
3. Click OK.
4. From the related actions, select FLSA Work
Period Calendar > Build Work Period
Events.
5. Set the Number of Work Periods as desired.

You receive the message: Changing the worker This error message indicates that you already used
associated with a Payroll Input isn’t allowed when some of the payroll input IDs in the EIB input file.
updating an existing Payroll Input. The web service is trying to update the entries,
but is unable to because they're either complete
or assigned to a different worker. When you add
new payroll input and want to specify the payroll
ID, you might want to preface the payroll input ID
with a date (such as: 2018-06-12) to ensure that it’s
unique.

When populating a related calculation in the You’re specifying the incorrect reference ID type
input file, you receive an error message such in the input file for the related calculation: Note
as: Validation error occurred. Invalid ID value. that for related calculations, there’s 1 reference ID
'W_NETGU isn’t a valid ID value for type = type called Related_Calculation_ID and another
'Related_Calculation_ID' calledWorkday_Related_Calculation_ID.
If you aren’t sure which ID to specify, run
Integration IDs report to search the values.
Example: for related calculations, search Related
Calc in the business object prompt. Then select
Related Calculation and Related Calculation
(Workday Owned). This will list all related
calculations and the reference ID type they’re
using. Then populate row 4 appropriately in your
input file.

When using the Generate with Data option, it's not Check the Related Calculation section of the EIB
populating all the information in the EIB input file, input file as some information is populated here.
such as hours.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries
through the web service.
• If you inadvertently upload incorrect entries, access the Delete by Batch ID task to remove the entries
by specifying the batch ID you used in the input file.
• Note: You can’t delete payroll inputs used in payroll results.
For reference documentation for all web services including Import Payroll Input, see Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 318

Sample EIB Input File


Import_Payroll_Input-WD30

Concept: Import Payroll Off-Cycle Payment EIB

Background
You can use this EIB to add or update off-cycle payments (manual or on-demand payments).
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


On the related actions of the worker's profile, select Payroll >Manual Payment (for manual payments) or
Payroll >On-Demand Payment (for on-demand payments).
There are additional EIBs related to payroll functionality. Consider these options as you determine what
works best for you:
• Import Payroll Input: You can use this EIB to load large volumes of payroll input entries (Example: 1000
or more).
• Put Payroll Off-Cycle Payment: You can use this EIB to create or update smaller volumes of off-cycle
payments (Example: less than 1000).
• Put Payroll History Payment: You can use this EIB to create or update payroll history payments.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Process: Off
Cycle (On Demand) and Process: Off Cycle
(Manual Payment) domains in the Core
Payroll functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider
• Refer to this documentation Concept: Dates in
Payroll Off-Cycle Payment EIB Spreadsheets,
which provides examples for this EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 319

• Use report Pay Calculation Off-Cycle Inputs


for Group of Workers to help you validate the
data you’re loading. You can run this report for
specific statuses and batch IDs.
• Notes for populating these fields in the input file:
• Spreadsheet Key: Specify a unique value for
each off-cycle payment
• Payment ID: Required field. Enter a unique
entry if creating a new off-cycle payment.
• State Work and State Resident: If
populating either of these fields, locate the
reference ID using Integration IDs report and
search Payroll State Authority.
• Earning and Deduction Codes: Note
that some earning and deduction
codes are Workday owned. Be sure
to specify the correct reference ID
depending on whether it’s Workday
owned. Example: Deduction_Code vs
Workday_Deduction_Code. Update row 4
in the input file to indicate which reference ID
you’re using.
• Related Calculations: note that some Related
Calculation codes are Workday owned.
Be sure you specify the correct reference
ID Example: Related_Calculation_ID vs
Workday_Related_Calculation_ID)

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully, however, you When you load the off-cycle payments using the
don’t see the off-cycle payments in the tenant. EIB, they get loaded as unprocessed. You would
then need to run pay calculations to process
them. To validate the data you loaded, use report
Pay Calculation Off-Cycle Inputs for Group
of Workers. You can run this report for specific
statuses or batch IDs.

The EIB issues an error such as 1 of these errors: You’re using the wrong reference IDs in the
input file for deduction or related calc. Note
• Invalid ID value. W_TTWG isn’t a valid ID value
that for deductions, there’s 1 reference ID
for type = Related_Calculation_ID
called Deduction_Code and another called
• Invalid ID value. W_OASER isn’t a valid ID value Workday_Deduction_Code. Also, for related
for type = Deduction_Code calculation IDs, there’s 1 reference ID called
Related_Calculation_ID and another called
Workday_Related_Calculation_ID.
If you aren’t sure which ID to specify, run
Integration IDs report to search the values.
Example: for deductions:
1. Search Deduction in the business object
prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 320

Issue Cause and Solution


2. Select Deduction and Deduction (Workday
Owned). This action will display a list of all
deductions and the reference ID they’re using.
3. For related calculations, select Related
Calculation and Related Calculation
(Workday Owned).
4. Populate row 4 appropriately in your input file.

The EIB issues the error: There are multiple causes for this issue. If you
receive this error, it might be helpful to test it in the
Validation error occurred. No eligible processing
user interface by entering the off-cycle payment
period exists for the period date.
using the same information you populated in the
input file. You might find that you receive an error or
can’t enter the information you provided in the input
file, as it isn’t valid for the worker.
• Previous Period isn’t complete: You can’t
process payments in a given period until the
previous period is complete.
• The Period Date/Run Category/Pay Group that
you provided isn’t permitting the web service
to find a period for processing: Note that the
web service uses the Period Date to identify the
target period for the off-cycle payment. If you
populate Run Category, the web service will
check for the period date within the run category
you specified. If Run category blank, the web
service will look for the period date in the regular
run category. If you populate the pay group, it
also assists in identifying the correct period. If
the pay group is blank, then the web service
looks for the pay group that the worker is in as
of the period date.

My EIB input file looks different than the attached This web service underwent major changes starting
sample: it has 2 worksheets. with v36.2. Create a new EIB to make certain
you’re using v36.2 or higher.

Slow Performance This issue will occur if you’re using an EIB older
than v36.2 and you’ve assigned a separate
header key value to each off-cycle payment entry.
Example: You upload 1,000 off-cycle payments and
assign each payment a different header key value.
The result is that it creates 1,000 background jobs,
which queue up and take a long time to process.
There’s no easy way to recover from this scenario
other than wait for all the jobs to complete their
processing. Create a new EIB to verify you’re using
v36.2 or higher.

EIB fails with error: Net amount entered isn’t correct This issue can occur for 2 reasons:
• The net amount and earning/deduction
amounts, specified in the EIB input file, don’t
balance out to $0.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 321

Issue Cause and Solution


• Or spreadsheet key values and row id values
aren’t correct in the EIB input file.
Take these steps to resolve the issue:
1. Verify that the net amount and earnings and
deduction amounts balance to $0 for each
payment in the EIB input file
2. Check the spreadsheet key values and row id
values for each off-cycle payment. Keep in mind
that all entries for a given payment must use the
same spreadsheet key value and payment id.

EIB fails with error: Confirm that you’ve GET access to domain Worker
Data: Payroll (Payroll Input).
Validation error occurred. The entered information
does not meet the restrictions defined for this field.
(Position_Reference)

EIB fails with an error like this: This issue occurs if you populate both the On
Demand Payment and Manual Payment sections
Validation error occurred. Multiple Element
of the EIB input file.
Contents, including Payroll Off-cycle Payment Data/
l2/Manual Payment Data [EL], contain data where Check the file and verify that you’re populating only
only one is allowed by mutex Payroll Off-cycle 1 section for each payment entry.
Payment Data

EIB completes successfully but doesn't update the Current functionality requires you to populate Pay
Pay to Balance Account field. Group field to properly update the Pay to Balance
Account field
We’re investigating whether to change this behavior
(internal ticket PAYWDCORE-42542). In the
meantime, you need to populate the Pay Group
field.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries nor
can you rescind since this EIB doesn't use a business process.
• If you have inadvertently uploaded incorrect entries, you can use task Delete by Batch ID and
then remove the entries by specifying the batch ID you used in the input file. Note: You can’t delete
entries used in completed payroll results.
For reference documentation for all web services including Import Payroll Off-Cycle Payment, see
Operation Directory.

Sample EIB Input File


Import_Payroll_Off-Cycle_Payment-WD36

Concept: Import Position Budget EIB

Background
You can use this EIB to add or update position budget details.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 322

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Position Budget
• Create Position Budget Amendment
There’s also a similar EIB - Import Budget - that you can use to create or update budgets for financial
projects.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Process:
Position Budget domain in the Budgets
functional area to run this EIB.

Guidelines for Adding Worktags to the EIB 1. From the related actions of your EIB, select
Template Template Model > View.
2. On the left, click All for Position Budget Lines
Replacement Data section.
3. On the right, locate Accounting Worktags.
4. From the related actions on the magnifying glass
next to Accounting Worktags, select Template
Model Column > Maintain Additional
Columns.
5. Enter all worktags that you need to assign to the
template.
• Note: if you selected Pay Component on
your Plan Structure, you’ll be using Earning
Code and Workday Deduction Code when
maintaining the additional columns on the
EIB.
• You won’t be adding Ledger Account here as
there are separate columns:
6. After you’ve completed the previous steps,
regenerate the spreadsheet template and add

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 323

newly added worktags to the spreadsheet


template.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• Before populating the EIB input file, you
might want to first test populating a budget
entry by using the User Interface, using
Create Position Budget task. This action will
help ensure that you can successfully add a
budget line with the proper configuration.
• Most likely, you’ll need to make some
changes to your EIB template to add all the
worktags that you’ve assigned to the plan
structure. If you aren’t certain how to do this
action, see Guidelines for Adding Worktags
to the EIB Template section.
• Worksheet#1 for Import Position Budget. As
you populate this worksheet, consider:
• There should be only 1 row in this worksheet
(assuming you’re loading information for just
1 budget).
• Header Key: This field should have a value
of 1.
• Add Only: Selecting Yes will add new plan
lines. Selecting No will enable updates to the
existing budget.
• Position Budget: This field remains blank
for original budgets and you can populate the
field if you're updating an existing position
budget.
• Row ID: Normally there's only 1 row
populated with a 1.
• AutoComplete: Set this field to Y if you
wish for the business process event to
automatically process and skip approval and
to do steps.
• Locked in Workday: Locked in Workday
is a boolean flag controlling a user's ability
to edit the transaction. If Workday sets
the flag, the user can't edit, cancel, or
change the transaction inside the Workday
application, however the user can submit a
draft transaction. You can only update the
transaction from the web service.
• Submit: Submit for Approval, indicating the
action of the transaction (submit or save in
draft mode). If this flag value is Y, Workday

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 324

submits the transaction, otherwise Workday


saves the transaction in draft.
• Position Budget Group: Workday requires
this field for original position budget. Workday
doesn't populate the field when loading
Position Budget Amendments. To locate the
Position Budget Group id, use the related
actions of your Position Budget Group value,
select Integration IDs > View IDs.
• Budget Structure: To locate theI Budget
Structure id, use the related actions of your
Plan Structure value, select Integration IDs -
> View IDs.
• Fiscal Year Number: Displays on the View
Fiscal Year report.
• Fiscal Time Interval: Workday sets this field
to Fiscal_Summary_Interval_ID with a line
value representing Annual. Use the View
Fiscal Summary Schedule report for Annual.
• Position ID: for this header row of data.
• Compensation Budget Total: This
REQUIRED field represents the sum of the
compensation lines from Worksheet #2 for
this Position ID.
• Business Plan Amendment Type: Workday
only requires an Amendment Type when
loading Position Budget Amendments.
Reference Maintain Budget Amendment
Types.
• Worksheet#2 for Budget Lines Data. As you
populate this worksheet, consider:
• Header Key: This field should have a value
of 1 for all entries (assuming you’re loading
information for just 1 budget).
• Line Key: Each entry needs a unique value.
We recommend you start with value 1 and
increment by one for each additional entry.
• Line Order If specified, lines will be sorted by
this value when displayed.
• Company on Budget Line: Used this field
when you have included Company on your
structured Dimensions on the Plan Structure.
Otherwise leave it blank.
• Compensation Account: The ledger
Account where Workday posts the
compensation.
• Account Set: The Account Set specified on
the Plan Structure.
• Fringe Account: The ledger Account where
Workday posts the Fringe benefits.
• Account Set: The Account Set specified on
the Plan Structure.
• Compensation Amount: Workday sums up
the amounts entered here for a position (if

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 325

there are multiple lines) and compares with


the amount on Worksheet #1, column T.
• Fringe Amount: If you’re budgeting for
Fringe, this amount will be the fringe benefits
for the compensation on this line.
• Account Worktags: Note that if you’re
budgeting for Spend Category, the Spend
Category for Fringe Benefits will populate
from the Plan Structure.
• If your budget contains over 25,000 entries, we
suggest you load 25,000 per EIB. You can add
Multiple Loads to 1 Position Budget Group ID.

Common Issues and Errors

Issue Cause and Solution

The EIB fails with the error: The Import Position Budget web service validates
the Job Profile, Job Family or, Job Family
Job Families for Position Restriction are not
Group with the respective value on the Position
Included on the Budget Structure
Restriction.
You’ll need to validate that all Position Restrictions
have a valid value for the Structured Dimension
configured on the Plan Structure.

The EIB fails with the error: . If you encounter this error, take these steps to
resolve the issue:
One or more budget lines have matching Company,
Ledger Account Summaries/Ledger Accounts and • First, check for duplicate entries in the input
Accounting Worktags with another line file: when you compare the ledger account and
all the worktags within each position, each line
should be unique.
• Check that the Template Model hasn’t had
columns added or deleted.

The EIB fails with the error: This issue indicates that you’ve not specified the
correct Year or Fiscal Time Interval. Check the
Budget Period does not exist for Budget
instructions in the Tips for Populating the Input File
section above, on how to populate the year and
fiscal time interval.

The EIB fails with the error: There are multiple causes of this issue. If you
encounter this error, you can test whether you can
Worktag is not valid for the Budget Line
enter the information by the user interface using
Create Position Budget. Performing this test would
help determine whether it's a configuration issue or
an issue with how you’re populating the EIB input
file:
• This issue can occur if you’ve specified an
inactive worktag,
• Another cause is if you haven't configured
the worktag in the structure dimension. Or
you’ve configured the worktag in the structure
dimension but it doesn’t include all members.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 326

Issue Cause and Solution

There’s no option to launch the integration This issue will occur if you don’t have the proper
access to the Position Budget Group Event
business process security policy. Try these actions:
• Check the Position Budget Group Event
business process security policy and make
certain you have access to Initiating Action
Import Position Budget (WS Background
Process).
• Activate the change.

Business Processes
Position Budget Group Event.

Use Cases and Guidelines for Recovering from a Bad Load


Position Budgets does have Cancel functionality. The ability to cancel a Position Budget added either
from an EIB or by the User Interface gets secured to the domains Process: Cancel Position Budget and
Process: Position Budgets Amendments. If the business process hasn’t been completed, then the cancel
button is visible on the approval page. If the business process is complete, the cancel functionality is
available through a related action on the business process.
To update the budget, use the amend functionality.
For reference documentation for all web services including Import Position Budget, see Operation
Directory.

Sample EIB Input Files


Import_Position_Budget-WD32-Example1-Original Budget
Import_Position_Budget-WD32-Example2-Budget Amendment

Concept: Put Payroll History Payment EIB

Background
You can use this EIB to add or update payroll history payments.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Run History Payment for Worker.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 327

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Process: Load,
Calculate, Cancel, Complete History domain
in the Core Payroll functional area to run this
EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Enter a unique value for
each Payroll History Payment.
• This EIB has a Generate Spreadsheet with
Data option, which is very helpful to use
when you aren’t certain how to populate the
input file. To use it:
• Verify that your EIB is using the latest web
service version. If you're not certain what
version you're using, create a new EIB,
which will uptake the latest version.
• From related actions of your EIB, select
Template Model > View.
• Select Edit Template with Data Options.
• Set the filter to Condition Rule Filter.
• Select a rule condition to retrieve specified
history payments. Example: You could
select a payment date greater than or
equal to a specified date.
• If you regenerate the template and
select the Generate Spreadsheet with
Data option, you can view how the file
populates for the payroll history payments
that you selected.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 328

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but there are no You need to use Run History Payment for
entries loaded or updated. Worker or Run History Pay Calculation to
complete the transactions.

After you upload your payroll history and execute Use the Payroll Input Not Processed report to do
Run Pay History Calculation, some of the pay your balancing against your input files and against
history might still be unprocessed. any of the delivered payroll registers.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add new payroll history payments or update existing payroll history
payments. You can’t delete entries through the EIB nor can you rescind since this EIB doesn’t use a
business process.
If you have inadvertently uploaded incorrect entries, below are some options to consider:
• If you’ve not yet run history payment, you can
• Use Delete by batch ID and specify the batch ID you entered in the input file when you originally
loaded the entries.
• Select Delete Off-Cycle Payment and enter the batch ID.
• Remove the entries.
• If you’ve already run the history payment, use Run History Pay Cancel.
• Another option would be to reload the entries with corrected information.
For reference documentation for all web services including Put Payroll History Payment, see Operation
Directory.

Sample EIB Input File


Put_Payroll_History_Payment-WD30

Concept: Put Payroll Involuntary Withholding Order EIB

Background
You can use this EIB to add or update withholding orders.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Any information that you submit with this EIB replaces and overwrites the information currently in Workday.
To avoid data loss, include all existing withholding orders and any new withholding orders in your EIB
input file. You can do this by generating your EIB spreadsheet with data. See: Example: Generate EIB
Spreadsheet Template with Data on page 62.
If you use ADP SmartConnect to manage your garnishments, consider consulting with ADP first to
determine their bandwidth for the changes you want to make.

Equivalent Workday Task


Task: Record US Withholding Order for Worker.
You can also use these integrations to update information related to Withholding Orders:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 329

• Electronic Income Withholding Order Inbound: An integration template to import electronic income
withholding orders into Workday from the Federal Office of Child Support Enforcement (OCSE) portal.
See Steps: Set Up Inbound Electronic Income Withholding Order Integration for more information.
• Put Canada Income Withholding Order: This web service adds or updates all types of income
Withholding Orders for Canada.
• Put Withholding Order Local Minimum Wage Rate: This web service will load Withholding Order
Local Minimum Wage(s) for existing Withholding Orders.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Worker Data:
Payroll (Income Withholding Orders) domain
in the Core Payroll functional area to run this
EIB

Guidelines for Modifying the EIB Template If you're planning to update existing withholding
orders, you should modify the EIB template,
configure the EIB to generate with data, and then
generate the template with data. Note that if you
don’t modify the template, when you generate with
data, there will most likely be some fields without
data. Example: In situations where the default
reference id type, used by the template, is different
than the reference id type used by your withholding
orders.
• From the related actions of your EIB, select
Template Model > View.
• On the left, click Payroll Involuntary
Withholding Order .
• On the right, click Edit Template Model Sheet
. You’ll need to wait a few seconds before
information displays.
• Scroll down and locate the template model area
with the label Payroll Involuntary Withholding
Order Data:.
• Locate the row with Employee* label and select
the check the box for Separate Type Column.
• Locate the row with the Issued in* label
and select the check box for Separate Type
Column.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 330

• Go to the Template Model Area and locate


the row with the label Non Resident State:
and select the check box for Separate Type
Column.
• Click OK.

Configure the EIB to Generate with Data • From the related actions of your EIB, select
Template Model > View.
• Click Edit Template with Data Options.
• Select Condition Rule Filter in the Filter
section.
• Build the rule conditions. Note: It might not be
possible to refine the conditions to extract the
specific withholding orders that you plan to
update. If that is the case, relax the conditions
and then you can edit the EIB input file after it's
built and remove any nonrelevant orders.
• Regenerate the EIB and select the Generate
Spreadsheet with Data check box.
• There are a few items to be aware of:
• The Payroll Involuntary Withholding Order
filed in column D is empty. You’ll need to
populate this field. You can copy the filed
values in the last column (Withholding
Order ID) to column D. After you make this
change, the values in column D and the last
column should be the same.
• For the fields where you changed the
template to use the Separate Type Column
option, you’ll see that there are now 2
columns in the EIB input file for each of
these fields. The first column (ID Type)
displays the reference id type and the second
column (ID Value) displays the value. These
columns enable you to easily include multiple
reference id types in your EIB input file.

Additional Input File Guidelines • NOTE: When using the EIB to update existing
withholding orders, the EIB input file must
include all existing field values. If you don’t
include the existing field values, the EIB will
remove the values from the withholding order.
For this reason, you’ll want to use the generate
with data option if updating existing withholding
orders.
• Be sure to thoroughly test in Sandbox before
using the EIB in your production tenant.
• We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 331

• As you populate the EIB input file, consider:


• To prevent data loss, we recommend that
you generate your spreadsheet with data
for the Put Payroll Involuntary Withholding
Order EIB. See: Example: Generate EIB
Spreadsheet Template with Data on page
62.
• Spreadsheet Key: Specify a unique value for
each withholding order
• Add Only: Set to Y if adding a new
withholding order. Set to N if updating
existing withholding orders.
• Payroll Involuntary Withholding Order
(column D): Leave blank if creating a new
withholding order. If updating an existing
withholding order, the field needs populated
with the reference id value for the withholding
order that you’re updating. Note that if you
generated the template with data, you can
merely copy the value from the very last
column (Withholding Order ID) into this field.
• Withholding Order Case*: If updating an
existing order, this field must contain the
reference id of the existing case order
• Case Number: If updating an existing order,
this field must be blank. If adding a new
withholding order, this field must have a
value.
• Withholding Order ID (in very last column):
If you’re creating a new withholding order,
you can either leave the field blank, or
populate it if you want to assign your own
reference id value. If you’re updating an
existing order, this field should contain the
same value as the Payroll Involuntary
Withholding Order field in column D.

Common Issues and Errors

Issue Cause and Solution

The EIB issues this error: This issue will occur if you try to change a case#
for an existing withholding order. You can’t update
Element Content Case_Number Required Mutex
the Case Number. Instead, you’ll need to end the
error Payroll Involuntary Withholding Order Data
existing withholding order and set up a new one.

The EIB issues this error: This issue can occur if you’re attempting to update
an existing withholding order but don’t populate
Validation error occurred. Withholding Order
the Withholding_Order_ID value in column D.
Case Reference is not valid when adding a new
Note that if you generated the template with data,
Withholding Order for any Withholding Order type
you can copy the value from the very last column
except Support Order. Use Case Number instead.
(Withholding Order ID) into this field.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 332

Issue Cause and Solution

When updating existing withholding orders, the EIB This EIB requires that you populate the EIB input
completes successfully but data is missing from the file with all existing data. If you don't populate
withholding orders existing data in the EIB input file, the web service
removes it.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new withholding orders or update existing withholding orders. You
can’t delete withholding orders; however, you can inactivate them.
• This web service doesn't use a business process. There’s no rescind/cancel option to use if you
inadvertently created incorrect withholding orders or accidentally overwrote existing data. Below are
recovery options to consider:
• Rerun the EIB and update the withholding orders with correct information. Or you could inactivate
any faulty withholding orders and then load new ones.
• If data was overwritten, possibly you can recover the data from a nonproduction tenant such as
Sandbox, by generating a spreadsheet with data. Then use the EIB to reload the data to production.
For reference documentation for all web services including Put Payroll Involuntary Withholding Order, see
Operation Directory.

Sample EIB Input File


Put_Payroll_Involuntary_Withholding_Order-WD34_2

Concept: Put Payroll Off-Cycle Payment EIB

Background
You can use this EIB to add or update off-cycle payroll payments.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


On the related actions of the worker's profile, select Payroll > Manual Payment (for manual payments) or
Payroll > On-Demand Payment (for on-demand payments).
There are also similar EIBs related to payroll. Consider these options as you determine what works best for
you:
• Import Payroll Off-Cycle Payment: You can use this EIB to add or update large volumes of off-cycle
payments (Example: 1000 or more entries).
• Import Payroll Input: You can use this EIB to load large volumes of payroll input entries (Example: 1000
or more).
• Put Payroll History Payment: You can use this EIB to create or update payroll history payments.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 333

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Process: Off
Cycle (On Demand) domain in the Core
Payroll functional area to run this EIB

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• See Concept: Dates in Payroll Off-Cycle
Payment EIB Spreadsheets, which provides
examples for this EIB.
• Spreadsheet Key: Each off-cycle payment
needs a unique spreadsheet key.
• Row ID: The Row ID can be tricky to
populate, especially if an off-cycle payment
has multiple earnings/deductions or multiple
related calculations. Refer to the attached
example to better understand how to
populate the row ID.
• Payment ID: Workday requires this field.
Enter a unique entry if creating a new off-
cycle payment.
• State Work and State Resident: If
populating either of these fields, locate the
reference ID using Integration IDs report and
search Payroll State Authority.
• Earning and Deduction Codes: Note
that some earning and deduction
codes are Workday owned. Be sure
to specify the correct reference ID
depending on whether it’s Workday
owned (Example: Deduction_Code vs
Workday_Deduction_Code). You’ll need to
update row 4, in the input file, to indicate
which reference ID you’re using.
• Related Calculations: Note that
some Related Calculation codes

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 334

are Workday owned. So be sure


you specify the correct reference ID
(Example: Related_Calculation_ID vs
Workday_Related_Calculation_ID)

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but you don’t see When you load the off-cycle payments using the
the off-cycle payments in the tenant. EIB, they get loaded as unprocessed. You’ll need
to run pay calculations to process. To validate the
data you loaded, use the Pay Calculation Off-
Cycle Inputs for Group of Workers report. You
can run this report for specific statuses or batch
IDs.

The EIB issues an error such as: You’re using the wrong reference IDs in the
input file for deduction or related calculation.
• Invalid ID value. W_TTWG isn’t a valid ID value
Note that for deductions, there’s 1 reference
for type =Related_Calculation_ID
ID called Deduction_Code and another called
• Invalid ID value. W_OASER isn’t a valid ID Workday_Deduction_Code. Also, for related
value for type =Deduction_Code calculation IDs, there’s 1 reference ID called
Related_Calculation_ID - and another called
Workday_Related_Calculation_ID.
If you’re unsure which ID to specify, run Integration
IDs report to search the values. Example: For
deductions, search Deduction in the business
object prompt. Then select Deduction and
Deduction (Workday Owned). You’ll see a list of
all deductions and the reference ID they’re using.
For related calculations, select Related
Calculation and Related Calculation (Workday
Owned). Then populate row 4 appropriately in your
input file.

The EIB issues error: There are multiple causes for this issue. If you
receive this error, you can test in the user interface
Validation error occurred. No eligible processing
by entering the off-cycle payment using the same
period exists for the period date.
information you populated in the input file. You
might find that you receive an error and can’t enter
the information you provided in the input file, as it
isn’t valid for the worker.
• Previous Period isn’t complete: You can’t
process payments in a given period until the
previous period is complete.
• The Period Date/Run Category/Pay Group that
you provided isn’t allowing the web service to
find a period for processing. Note that the web
service uses the Period Date to identify the
target period for the off-cycle payment. If you
populate Run Category, the web service will
check for the period date within the run category
you specified. If Run category remains blank,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 335

Issue Cause and Solution


the web service will look for the period date in
the regular run category. If you populate the pay
group, it assists in identifying the correct period.
If the pay group remains blank, then the web
service looks for the pay group that the worker is
in as of the period date

EIB fails with an error like this: Make certain you’re populating the payment ID in
column E (Payment ID) with a unique value. Don't
Validation error occurred. Invalid ID value. '1' isn’t a
populate the ID in column C or you’ll receive this
valid ID value for type = 'Payment_ID'
error.

EIB fails with error: This issue can occur for 2 reasons:
Net amount entered isn’t correct. • The net amount and earning/deduction
amounts, specified in the EIB input file, don’t
balance out to $0.
• Or spreadsheet key values and/or row id values,
aren’t correct in the EIB input file.
To resolve the issue:
1. Verify that the net amount and earnings and
deduction amounts balance to $0 for each
payment in the EIB input file
2. Check the spreadsheet key values and row ID
values for each off-cycle payment. Keep in mind
that all entries for a given payment must use the
same spreadsheet key value and payment ID.

EIB fails with this error: Confirm that you’ve GET access to domain Worker
Data: Payroll (Payroll Input).
Validation error occurred. The entered information
does not meet the restrictions defined for this field.
(Position_Reference)

EIB fails with an error like this: This issue occurs if you populate both the On
Demand Payment and Manual Payment sections
Validation error occurred. Multiple Element
of the EIB input file.
Contents, including Payroll Off-cycle Payment Data/
l2/Manual Payment Data [EL], contain data where Check the file and verify that you’re populating only
only one is allowed by mutex Payroll Off-cycle 1 section for each payment entry.
Payment Data

EIB completes successfully but ignores the Pay to Current functionality requires you to populate Pay
Balance Account field. Group field to properly update the Pay to Balance
Account field

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries nor
can you rescind since this EIB doesn’t use a business process.
• If you have inadvertently uploaded incorrect entries, an option would be to use task Delete by Batch ID
and then remove the entries by specifying the batch ID you used in the input file. Note: You can’t delete
entries used in payroll results.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 336

For API documentation for all web services including Put Payroll Off-Cycle Payment, see Operation
Directory.

Sample EIB Input File


Put_Payroll_Off-cycle_Payment-WD32

Concept: Put Payroll USA State and Local Tax Election EIB

Background
You can use this EIB to create worker USA tax elections for state and local tax authorities.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Add Worker US Tax Elections.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Worker Data:
Payroll (Company Specific) - USA domain
in the USA Payroll functional area to run this
EIB

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• As you populate the EIB input file, consider:
• Proceed with great caution when using this
EIB, as there’s no mass rescind option nor is
there a way to mass update or mass delete
tax elections. Be certain you thoroughly test
in a Sandbox tenant
• You might want to create a custom report
if you need to review existing tax election
information for employees. The tax election

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 337

information is available from the Worker


Business Object.
• The EIB input file contains sections for this
information:
• General Applies to all types of elections
• State (Column G to BC)
• SUTA (Column BD to BE)
• County (Column BF to BJ)
• City (Column BK to BZ)
• School District (Column CA to CF)
• Other (Column CG to CK)
• Details about the various sections with
information for the more commonly used
fields.
• General (Column A to F): The fields in
this section should always have a value,
regardless of the type of tax elections
you're loading:
• Spreadsheet Key: Specify a different
value for each unique combination of
Worker/Company/State/Effective Date.
• Company: The company to which the
worker for this tax election belongs.
If left blank, it populates with the
company of the worker's primary
position as of the effective date
provided. To find the reference ID
value for the company, run the View
Reference IDs report and select
business object Company.
• Worker: Typically you would specify
employee IDs, and set cell D4 to
Employee_ID. If you want to add
information for both employees and
contingent workers, split the columns
using the Separate Type Column
option as described in: Customize EIB
Spreadsheet Template. By using this
option, you can list both employees
and contingent workers in the same
input file. (Note that this is optional,
and the attached sample EIB input file
isn't using this option).
• Effective Date: Enter effective date of
tax election in format YYYY-MM-DD.
• Payroll State Authority: The Payroll
State Authority to which these
elections apply. To find the reference
ID value, run the Integration IDs

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 338

report and select business object


Payroll State Authority.
• State (Column G to BC): Populate this
section if loading State elections
• Effective Date: Leave blank.
• Payroll Withholding Status: To
find the reference ID value, run the
Integration IDs report and select
business object Payroll Withholding
Status.
• Number of Allowances: Enter integer
value for the number of allowances.
• City (Column BK to BZ)
• Tax Address Type: Tax Address Type
of Home, Work or Both that denotes
whether this local tax election applies
to the worker’s home or work tax
authority or both.
• Payroll Local City Authority: To
find the reference ID value, run the
Integration IDs report and select
business object Payroll Local City
Authority.

Common Issues and Errors

Issue Cause and Solution

EIB issues an error such as: Remove the effective date value from column G.
Validation error occurred. Attribute not supported
by California Tax Authority. Valid Attributes
are: Additional Amount, Copy Mode, Estimated
Deductions, Exempt Indicator, Lock In Letter,
MSRR Exempt, No Wage No Tax Indicator,
Number of Allowances, and Tax Authority Not in
Proposed Company.

Although the EIB completes successfully, I don't You can:


see any updates.
1. Edit EIB input file.
2. Verify that you populated the Row ID value in
the section you’re updating.

EIB issues an error like this: Add the Payroll State Authority in Column F of
the EIB spreadsheet. This task is to ensure that
Error: Other Tax Authority Reference doesn’t
the selected authority matches up correctly to the
share the same County Region as the State Tax
selected state.
Authority.

EIB fails with this error: Populate SLE in EIB input file, if applicable.
The Company specified is not valid for the Worker. Alternatively, use the EIB and manually enteri1 of
the entries that’s failing. This test will verify that the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 339

Issue Cause and Solution


user interface allows the company you’re trying to
load with the EIB.

Unable to launch the EIB. This issue is most likely security-related. See
EIB Input File Guidelines section for details on
configuring security.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries. You can't update existing entries or delete entries.
• There’s no option to cancel or rescind since the EIB doesn't use a business process
• If you inadvertently loaded incorrect data, below are options to consider:
• You can manually update or delete the tax elections.
• You could correct the tax election information in the EIB input file and then resubmit. (This correction
won't update the previously loaded entry, but it will add a new entry with the correct information.)
• You could also set the Inactivate flag to Y in the EIB input file and then reload the data. Again, it
won't remove the previously loaded entry, but it adds a new entry to indicate that the election is now
inactive.
For reference documentation for all web services including Put Payroll USA State and Local Tax Election,
see Operation Directory.

Sample EIB Input File


Put_Payroll_USA_State_and_Local_Tax_Election-v39

Concept: Put Period Schedule EIB

Background
You can use this EIB to add or update period schedules.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Period Schedule
• Edit Period Schedule

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 340

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the:
• Set Up: Payroll - Pay Group Specific
domain in the Core Payroll functional area
to run this EIB.
• Set Up: Time Off (Calculations - Absence
Specific domain in the Time Off and
Leave function area to run this EIB.
• Set Up: Payroll Interface domain in the
Payroll Interface functional area to run this
EIB.
• Set Up: Period Schedule domain in the
Project Tracking functional area to run this
EIB.

Configure the EIB to Generate with Data • From the related actions of your EIB, select
Template Model > View.
• Click Edit Template with Data Options.
• Select Condition Rule Filter in the Filter
section.
• Add a rule condition.
• Click OK.
• Regenerate the template and select the
Generate Spreadsheet with Data check box.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
Period Schedule EIB. See: Example: Generate
EIB Spreadsheet Template with Data on page
62.
• If you’re extending an existing period schedule,
it's not necessary to populate section Period
Data+ (All > Period Schedule Data) with the
existing period start/end dates but rather you
can just add the new period start and end dates.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 341

• You might find it easiest to use the Generate


Spreadsheet with Data option to help
determine how to populate the fields. If you're
creating a new period schedule, we suggest you
manually create it and add 1 or 2 periods. Then
you can generate with data and have a helpful
template to use to add remaining periods.
• As you populate the EIB input file, consider:
• Section All:
• Spreadsheet Key: Specify a unique value
for each Period Schedule.
• Add Only: Set to Y only if adding new
schedules.
• Period Schedule ID (column D): This
field should remain blank.
• Section Period Schedule Data (All):
• Period Schedule ID (column E):
• If updating an existing schedule, place
the period schedule’s reference id
value in this field.
• If you're creating a new schedule,
populate the field with the reference id
value you wish to assign or else leave
the field blank, and the Workday will
assign a value.
• Period Schedule Name: Name of the
period schedule.
• Frequency: Schedule frequency. To
find the reference id value, run the View
Reference IDs report and select business
object Frequency.
• Usage: Enter all usages that apply to the
schedule. Each usage needs to be on a
new row. To find the reference ID values,
run the Integration IDs report and select
business object Period Schedule Usage.
• Section Period Data+ (All > Period
Schedule Data):
• Row ID: Enter a unique Row ID value for
each Period Start/End Date.
• Period Start Date: Enter the period start
date in format YYYYMMDD. You can
also specify time if you wish. Sample
field values: 2021-02-01T00:00:00 or
2021-02-01. If you’re extending an
existing period schedule, you might find it
helpful to use this method from Microsoft
to populate the dates:
• Period End Date: Enter the period end
date in format YYYYMMDD. You can
also specify time if you wish. Sample

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 342

field values: 2021-02-01T00:00:00 or


2021-02-01.
• Payroll Payment Date: This field is only
for Workday Payroll and Workday Payroll
interface usage. Enter the payroll payment
date in format YYYYMMDD. You can also
specify time if you wish.
• Period ID:
• If updating an existing period, specify
the reference id value of the period.
• If creating a new period, you can either
populate the field with the reference
id value you wish to assign, or else
leave the field blank and the Workday
will assign a value. Be very careful not
to specify a reference id value that is
already in use as it will overwrite an
existing period. To find values currently
in use, run the Reference IDs report
and select business object Period.

Common Issues and Errors

Issue Cause and Solution

EIB issues Error - The load contains a duplicate key Check your EIB input file and verify that the
' spreadsheet key is present for each entry.

EIB fails with this error: This issue occurs when loading a period schedule
for Absence and omitting the Usage Type. To
Payroll Payment Date can only be entered if period
resolve:
schedule usage includes Payroll. Payroll Payment
Date is required if period schedule usage includes 1. Edit EIB input file.
Payroll. 2. Set Usage+ field to: Usage_Absence.

When adding new periods to an existing schedule, This issue occurs if the EIB input file isn't specifying
the EIB completes successfully but you observe 1 a new value for Period ID but rather it's using a
of these issues: reference id value that's already in use. When
adding new periods, you should leave the Period
• It didn’t load some of the entries.
ID value blank (or else specify a value that isn’t yet
• You might notice that some existing data was used).
overwritten.
There are 2 options to resolve this issue with option
1 being the easiest and safest:
1. Leave the Period ID value blank for new entries
that you’re adding. The web service will treat
this as a new entry and assign a reference id
value that isn’t yet in use
2. The other option would be to assign a more
meaningful reference id value so that you’re
certain it isn’t in use. Example: You could
assign a reference ID = to name of the
schedule + period begin date. Example UK-
Annual-2021-02-01.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 343

Issue Cause and Solution


If data was overwritten:
1. Use the Generate Spreadsheet with Data
option in a tenant such as sandbox, where the
data is still intact
2. Then use the spreadsheet to reload the data.

I uploaded an EIB for Period Schedule and after This issue can occur if you update an existing
successfully uploading it, I noticed it removed some schedule but don’t populate all the usage types
values from the schedule. used by the schedule. If this occurs, do this:
1. To recover the data, you could use the
Generate Spreadsheet with Data option in a
tenant such as sandbox, where the data is still
intact.
2. Use the above spreadsheet to reload the data.

Unable to launch the EIB. Check your security. See the EIB Input File
Guidelines section.

When I load the EIB, it's creating new period Make certain you specify the Period ID field in the
schedules for each individual line in the EIB instead EIB input file.
of adding to the existing period schedule.
There isn't a way to remove the incorrect entries.
You can update them and add zDNU to the
beginning of the period schedule names.

When loading a new value for Override Accounting This issue will occur if changing the date for a
Date, it’s ignored. payroll period that's in progress or complete. In this
situation, Workday ignores the date value.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries.
• This EIB doesn't use a business process. There's no option to rescind or cancel. If you inadvertently
uploaded incorrect entries, consider:
• If you need to correct existing entries, reload the entries with correct information. If you need to
restore the original values, you can find another tenant, such as a sandbox or implementation
tenant, that still has the correct period schedule. Then use Generate Spreadsheet with Data in that
tenant to build an EIB input file to load into the tenant with incorrect period schedule information.
• You can’t delete period schedules. If you inadvertently loaded schedules you want to remove, you
can change the names of the schedules and add zDNU to the beginning of the schedule name.
Adding this prefix will drop the schedules down to the bottom of the list and make them less visible.
For reference documentation for all web services including Put Period Schedule, see Operation Directory.

Sample EIB Input Files


Put_Period_Schedule-Example1-Create-New-Absence-Schedule
Put_Period_Schedule-Example2-Add-Entries-to-Existing-Absence-Schedule
Put_Period_Schedule-Example3-Add-Entries-to-Existing-Schedule-with-all-Usages

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 344

Concept: Submit Payroll Input EIB

Background
You can use this EIB to create or update payroll input.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Add Payroll Input by Worker.
If you want to manage bulk payroll input using worksheets, see Steps: Using Payroll Input Workbooks.
There are additional integrations and EIBs related to payroll functionality. Consider these options as you
determine what works best for you:
• Import Payroll Off-Cycle Payment: You can use this EIB to load large volumes of off-cycle payments
(Example: 1000 or more).
• Put Payroll Off-Cycle Payment: You can use this EIB to create or update off-cycle payments.
• Put Payroll History Payment: You can use this EIB to create or update payroll history payments.
• Worker Payroll Input Async: You can use this integration template to import files with worker payroll
data from an external server into Workday. See Steps: Set Up Integration for Worker Payroll Data
Import.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Worker Data:
Payroll (Payroll Input) domain in the Core
Payroll functional area to run this EIB.

Configure the EIB to Generate with Data • This EIB has a Generate Spreadsheet with Data
option. Use this option when you aren’t certain
how to populate the input file. To use it:
• Manually enter a payroll input like the inputs
that you wish to load.
• From related actions of the input, select
Integration IDs > ViewIDs to get the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 345

Payroll_Input_ID (you’ll need this ID later


on).
• From related actions of your EIB, select
Template Model > View .
• Click Edit Template with Data Options.
• Set filter to Reference ID Filter.
• Enter the Payroll Input ID from a previous
step.
• If you regenerate the template and click the
Generate Spreadsheet with Data option,
you can view how the file gets populated for
the payroll input you manually created.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider
• Spreadsheet Key: Use a unique value for
each payroll input entry.
• Row ID: Typically is a value of 1 for each
entry, unless you have multiple row entries
for 1 payroll input.
• Payroll Input ID: If you’re updating an
existing payroll input, you need to specify
the input ID for that payroll input. To find the
ID, create a custom report using data source
Payroll Inputs and then add field Reference
ID to the report. For new entries, you can
leave this value blank and the web service
will populate it. Or if you choose to populate
it, make certain you’re using a unique ID.
• Related Calculation: Note that
some Related Calculation codes
are Workday owned. Be sure to
specify the correct reference ID.
Example: Related_Calculation_ID vs.
Workday_Related_Calculation_ID.
• After loading the payroll input, you can use
Payroll Input by Batch ID to view the loaded
entries.
:

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully, but there are no • This issue can occur if you fail to populate the
entries loaded or updated. row ID in the input file.
• When updating an existing payroll input and
once payroll input is used in a result, then you’re
restricted to updating only certain fields such
as Company and End Date. If you attempt to

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 346

Issue Cause and Solution


update other fields such as Amount, the web
service will ignore it. To troubleshoot this issue,
manually enter a payroll input using the same
information as what you specified in the input
file. Then you can validate whether it’s allowed.
• Also, if you specified a Payroll Input ID in the
EIB input file, it must have a unique value for
each pay input entry. We recommend you leave
it blank if adding new entries
• Check if FLSA calendar needs extended as
follows:
• Search and select the task View FLSA Work
Period Calendar.
• Search and select your FLSA calendar in the
FLSA Work Period Calendar prompt.
• Click OK.
• From the related actions, select FLSA Work
Period Calendar > Build Work Period
Events.
• Set the Number of Work Periods as desired.

You receive the message: This error message indicates that some of the
payroll input IDs specified in the EIB input file are
Changing the worker associated with a Payroll
duplicated. Therefore, it’s trying to update the
Input isn’t allowed when updating an existing
existing entries, but it’s unable to as they’re either
Payroll Input.
completed or assigned to a different worker. If
you’re adding new payroll input, and want to specify
the payroll ID, you might want to prefix the payroll
input ID with a date (Example: 2018-06-12) or
something to ensure that it’s unique.

When populating a related calculation in the input You’re specifying the incorrect reference ID type in
file, you receive an error message such as: the input file for the related calculation: Note that
for related calculations, there’s 1 reference ID type
Validation error occurred. Invalid ID value.
called Related_Calculation_ID and another called
'W_NETGU isn’t a valid ID value for type =
Workday_Related_Calculation_ID.
'Related_Calculation_ID'
If you aren’t sure which ID to specify, run
Integration IDs report to search the values.
Example:
1. For related calculations, search Related Calc in
the business object prompt.
2. Select Related Calculation and Related
Calculation (Workday Owned). You'll see all
the related calculations and the reference ID
type they’re using.
3. Populate row 4 appropriately in your input file.

When using the Generate Spreadsheet with Check the Related Calculation section (far
Data option, it's not populating all the information in right) of the EIB input file as it populates some
the EIB input file, such as hours. information here.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 347

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can’t delete entries.
• If you have inadvertently uploaded incorrect entries, an option would be to use task Delete by Batch
ID and then remove the entries by specifying the batch ID you used in the input file (note that you can’t
delete payroll inputs used in payroll results).
For reference documentation for all web services including Submit Payroll Input, see Operation Directory.

Sample EIB Input File


Submit_Payroll_Input-WD32

Performance Management EIBs


Concept: Import Employee Reviews EIB

Background
You can use this EIB to import employee reviews from an external system. You can load reviews for
employees, contingent workers, and terminated workers.
Note: This EIB discards all reviews if a single review fails to load. If you want to avoid this scenario,
consider using the Load Employee Reviews EIB instead.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Start Performance Review for Employee.
• Start Development Plan for Employee.
• Start Disciplinary Action for Employee.
• Start Performance Improvement Plan for Employee.
• Start Performance Review for Organization.
There are also similar EIBs that you can use for employee reviews. Consider these options as you
determine what works best for you:
• Manage Goals: You can use this EIB to add new worker goals and edit existing goals for a worker.
• Start Performance Review: You can use this EIB to create in-progress or completed performance
reviews for an employee.
• Update Employee Review Rating: You can use this EIB to update employee reviews. You can update
the manager's overall ratings and comments along with the item and section ratings.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 348

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Set Up:
Employee Reviews domain in the
Performance Enablement functional area to
run this EIB.

Additional Input File Guidelines • This EIB has a Generate Spreadsheet with Data
option, which is very helpful when you aren’t
certain how to populate the input file. To use it:
1. Manually complete a performance review (in
your Sandbox tenant) on the user interface,
and enter the same information that you want
the EIB to load.
2. Open the performance review and from
related actions, select Integration IDs >
View IDs. This option enables you to find the
reference ID value for Employee_Review_ID.
3. Copy the value to clipboard.
4. Go to the EIB, and from related actions,
select Template Model > View.
5. Click Edit Template with Data Options.
6. Set the filter to Reference ID Filter.
7. Enter the Employee Review ID value for
the performance review that you manually
completed.
8. Generate a spreadsheet template and select
Generate Spreadsheet with Data.
9. You can now view the template to see what
the EIB is expecting. Use this template as a
starting point when creating a performance
review for another employee. Note that you’ll
need to make some changes to the input
file such as removing the Employee Review
ID and changing the worker ID. Also, the
Generate with Data file does always populate

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 349

all fields, but it should be helpful in getting


started.
Refer to Customize EIB Spreadsheet Template
for more details.
• There are hundreds of fields available in the EIB
input file and it isn’t possible to describe every
field in detail. To help you get started, here’s
some general information:
• Manually complete a performance review
and enter the same information that you want
the EIB to load. This information helps you
determine what fields to populate.
• Always use the Generate Spreadsheet
with Data option. Although the Generate
Spreadsheet with Data option might not
populate every field, you can go to the
performance review you manually created
and use the related actions option to find the
reference ID of fields you populated.
• We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider
• As you populate the EIB input file, consider:
• Import Employee Reviews worksheet in the
EIB Input File
• Header Key: Any Import web service,
such as this one, batches the input file
entries into jobs and processes them
asynchronously. The value of the header
key determines how many entries get
batched per job. We recommend you
batch at least 1,000 reviews per job (test
in a nonproduction tenant first to find out
what works best for you). As a result,
the first 1,000+ reviews have a header
key value of 1, the next 1,000+ reviews
have a header key value of 2, and so on.
So you’ll likely have just 1 entry in this
worksheet with value 1.
• Employee Review Data worksheet in the
EIB Input File
• Header Key: As noted above, the
value would typically be 1 for all entries

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 350

(unless you have a very large number of


performance reviews)
• Line Key: Use a unique value for each
performance review.
• Employee Review ID: Leave this value
blank and the web service will assign it.
• Review Completed: Set to:
• Y if you want to complete the review
after running the EIB.
• N if you want the web service to launch
the event and then use the business
process definition to determine who to
route the next step to. Note that if you
set this field to N, you can't populate
the evaluation data in the EIB input file.
• Worker: Enter the employee ID. If you’re
updating contingent workers, change cell
F4 to Contingent_Worker_ID. If you're
loading both employees and contingent
workers, you can configure the separate
type column option so that you can load
both types of workers using the same EIB
input file. Change Emergency Contacts
EIB - Inbound is for another EIB, but
provides more details about configuring
the separate type column.
• Supporting Documents: Although the
EIB input file has a section to specify file
attachments, it’s typically not possible to
load attachments using an EIB due to the
size limitations of Excel. Currently, Excel
supports a maximum of 32,767 characters
per cell. Most documents would be much
larger than 32,767 characters (especially
after encoding in base 64, which Excel
requires when uploading a document
using a web service). If you need to load
attachments, you might want to consider
developing a custom integration.
• A few more guidelines specific to loading
reviews with multiple Goals sections:
• You can’t load a combination of Workday-
delivered and custom sections when you use
multiple sections. Use all custom (tenanted)
sections if there are multiple sections.
• The integration IDs for the sections must
come from the Maintain Employee Review
Section Types entries. To view the integration
IDs, use the related action off of each entry.
• Set Section_Type_Tenanted_ID as the
column header format for Goals Review

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 351

Section Data+ (All) > Section Type (column


DE).
• Increment the Goals Review Section Data
> Row ID (column BI) field by 1 for each
section.
• Add the section Integration ID for each row.

Common Issues and Errors

Issue Cause and Solution

EIB fails with the error: Make certain column HP, in the EIB input file, has a
value of OVERALL.
Section Type is invalid for an Overall Section

The EIB successfully completes, however when Although this EIB doesn’t fully adhere to the
viewing the review from the worker profile, there are business process framework, it does need these
no ratings. steps to exist in the Start Performance Review
business process definition if you wish to load
employee review ratings or manager review ratings:
• Step: Complete Self-Evaluation
• Step: Complete Manager Evaluation

Unable to launch the EIB This issue is security-related. Refer to Web Service
Version and Security Configuration Guidelines.

Unable to generate template with data with this This issue is security-related. Refer to Web Service
error: Version and Security Configuration Guidelines.
Integration Failed.
com.capeclear.mediation.MediationException:
application=assemblyGenerateSpreadsheetE2 -
Error code : 1 The following error occurred when
getting data for the template: Processing error
occurred. The task submitted is not authorized. See
the consolidated report for further details.

EIB fails with errors such as: If you wish to load evaluation data, you must
change the Review Completed flag in the EIB
• Evaluation data is only allowed for reviews
input file to Y.
where Review Completed is true.
• Overall Evaluation Data can only be included on
completed reviews.

The EIB completes with errors for just some of the This issue occurs for this Import web service since
reviews that loaded. However, you find that none a background process loads the data. Address all
of the reviews loaded (even the reviews where no errors before you load the reviews.
errors appeared).
If you want the EIB to load all reviews except the
ones that don’t pass validation, then use EIB Load
Employee Reviews instead.

EIB fails with the error: There are a couple of reasons this error can occur:
An Employee Review already exists for this 1. You’re loading a review for an employee that
employee Jane Doe, review type, and date range. already has a review, because you’re trying to

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 352

Issue Cause and Solution


update the review. Note that you can’t update an
existing review. Instead, cancel or rescind the
existing review and then reload it.
2. There’s an issue with the EIB input file and there
are 2 entries for the same worker with different
line IDs. Verify that the line ID value is the same
for all entries that belong to 1 worker.

I want to change the Review Date values but am There isn’t a way to change review dates on an
unable to do so in-progress or completed review with the web
service or in the user interface. You could cancel
the reviews and start over. You would also have to
create a new review template when the template
includes specified review period dates. This
solution might not be ideal, but that is the only
option to change the dates currently.

EIB fails with the error: This issue occurs if you don’t populate the Header
Key value in the EIB input file. Make sure that all
The worksheet 'Employee Review Data' contains
entries have a header key value. The value will
identifying key values 'null' for which there is no
most likely be 1.
corresponding row in the parent sheet 'Import
Employee Reviews'

EIB fails with an error like this: This issue indicates that the EIB input file is missing
a value for section type. Make certain that the
Missing Required Parm
section type field populated for all sections within
Employee_Review_Section_Type__Mixed_--IS
the EIB input file, where data is present. To find
(1$7804) XpressO Call Stack Trace= 86$69757:null
the reference ID values for section type, you can
run the Integration IDs report and search business
object Employee Review Section Type.

EIB fails with an error like this: This issue can occur if the EIB input file contains
a value for Employee Review ID. Leave this field
com.workday.index.DuplicateIndexException:
blank so that the web service can assign a unique
Duplicate insert on index: Employee
value.
Review-ID-Employee Review ID (95$3516),
value: DEVELOPMENT_PLAN-1-4,
new instance: id=2489$5
wid=4b778a4d53f00125ce7640a30b001905
disp=2489$5, existing: id=2489$4
wid=4b778a4d53f0018d489362730a004f04
disp=2489$4

EIB fails with an error like this: This error is common when the EIB input file
contains characters in the comments that cause
Invalid Rich Text internal syntax: Unexpected char
issues when the integration tries to transform the
in markup at 839
EIB input file into XML. XML uses certain tags (like
&, <, >) and XML considers these characters as
reserved characters. If the comments contain these
characters, it causes a problem when translating
the input file into web service requests. Check for
comments with the reserved characters and then
replace them. Example: for <, replace it with less
than or with an escape character.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 353

Issue Cause and Solution


Examples of some of the reserved characters,
along with their escape characters.
& - &amp;
< - &lt;
> - &gt;
" - &quot;
' - &apos;

I accidentally canceled or rescinded the Be aware there are 2 EIBs to load Performance
performance reviews. Can I reloaded them using an Data:
EIB?
1. Start Performance Review
2. Import Employee Reviews
The ability to use these EIBs to reload the data
depends on the type of information loaded to the
performance reviews and whether they are in
progress or completed.
The Start Performance EIB only supports the
importing of the overall rating.
The Import Employee Reviews EIB works for
completed reviews (if the review is still in progress,
then you can’t load the evaluation data with this
EIB).
Depending on the state of the review and the data
you need to load, you might be able to use one
of the EIBs. However, if the EIBs don’t meet your
need, then consider:
1. If the review data exists in a nonproduction
tenant, you might be able to gather it from that
tenant and reenter it to your Production tenant
after relaunching the reviews. Or you might be
able to extract it from the nonproduction tenant
using the Generate With Data option for the
Import Employee Reviews EIB. Then load it
back to the Production tenant using the EIB.
However, this action works only for completed
reviews.
2. Reviewing the information from the full process
event of the canceled or rescinded reviews, and
reenter it.
3. Using the Start Performance Review web
service to load the overall ratings, but the
employees would then need to reenter other
missing information.
4. Creating a report to provide to employees with
the information they need to reenter, using
theEmployee Reviews Indexed data source.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 354

Issue Cause and Solution


5. As a last resort, restoring the Production tenant
to a time before the cancel or rescind. But you’ll
lose any data entered after the restore time.

Business Processes
Depending on the type of review template that you use, this EIB uses these business processes:
• Start Performance Review: For performance reviews.
• Start Development Plan: For development plans.
• Start Performance Improvement Plan: For performance improvement plans.
This EIB doesn't check condition rules in the business process definition and automatically skips steps with
insufficient information.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to create new performance reviews. You can’t delete reviews. You can’t
update existing reviews except for 1 exception: you can use EIB Update Employee Review Rating to
update the manager's overall ratings/comments along with the item and section ratings.
• If you have inadvertently uploaded incorrect entries, use Mass Rescind or Mass Cancel (depending
on whether the business process event is complete or in progress). Note that there isn’t an option to
specify the EIB when canceling or rescinding for Import Employee Reviews. Instead, you can enter:
1. Start Performance Review (or the applicable business process event) at the Business Process
Types prompt.
2. The date and time range that you submitted the EIB.
Note: Proceed with Caution because if you inadvertently cancel or rescind the wrong events, you
can’t undo the cancel or rescind.
For reference documentation for all web services including Import Employee Reviews, see Operation
Directory.

Sample EIB Input File


Import_Employee_Reviews-WD33_0

Concept: Manage Goals EIB

Background
You can use this EIB to add or edit goals for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Tasks


See Talent > Edit Goals from the related actions of the worker's profile.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 355

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage
Goals business process in the Performance
Enablement functional area.

Guidelines for Modifying the EIB Template If you want to add more than one type of tag that
the goals relate to (competencies, development
items, feedback, or flex teams), modify the template
to add a separate column for the ID type for
Relates To+ before generating the template.
1. Click the related action from your Manage Goals
EIB.
2. Select Template Model, then select View.
3. Select Edit Template Model Sheet.
4. In the Worker Goal Detail Data+ Template
Model Area, select the check box for Separate
Type Column for Relates To+.
5. Save and generate the EIB template.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each worker.
• Worker: Most likely, you’ll need to change
the reference id type, in row 4, from
Contingent_Worker_ID to Employee_ID.
• Row ID (in column #4): Specify a unique row
ID for each goal for a given worker.
• This EIB does a Replace All. If you're
updating existing goals, include all existing
fields in EIB input file, to prevent the EIB
from removing the fields. You might find it
helpful to create a custom report to help you
populate the EIB input file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 356

Common Issues and Errors

Issue Cause and Solution

Can’t find a field in the EIB to make the goal not The editable option isn’t available on the EIB.
editable. Therefore, by default, any goals you load by
the EIB will be editable. You’ll need to manually edit
the goal to make it not editable.

The EIB issues an error similar to this: The use of the character < outside of rich text tags
creates this error: Check your input file for the
Validation error occurred. Invalid Rich Text internal
<character in the goal name or description.
syntax: Unexpected char in markup at 22.
To work around this issue, you can either:
• Replace < with the words less than, or
• Replace < with escape expressions. For <, you
would use &lt; . Example, if the description
contains <150 days , you would use &lt; 150
days instead.

The EIB fails with error: The error typically occurs if there are some entries
in the EIB input file with rich text. Perhaps you
Error parsing Excel file. Make sure the spreadsheet
copied and pasted information from another tool
is in Excel XML or XLSX format. Other Excel
that allowed these characters. You can:
formats (e.g. xls) are not supported.
1. Make a copy of the EIB input file.
2. Then start loading chunks of it at a time, until
you encounter the error.
3. Copy and paste the field from the EIB input file
into a text editor such as Notepad. Most likely
the Description field has odd characters.

There’s no option to choose the EIB when This issue will occur if you don’t have the proper
launching the integration. access to the Manage Goals business process
security policy. Make certain you have access to
Initiating Action Manage Goals (Web Service).

The EIB completes successfully, but you don’t find Most likely the business process events are still
the goals you loaded. in progress as a step didn’t complete due to the
EIB input file and business process definition being
out of alignment. If this occurs, you can run a
mass cancel to cancel the in progress manage
goals events. Make any necessary changes to the
business process definition and then reload the
EIB.

The EIB issues error: Validation error occurred. A If updating an existing goal, it’s still necessary to
goal must have a name. include the goal name as well as any other existing
information for the goal. If you don’t populate it in
the input file, the EIB removes it.

Some of the goal information is missing after using If updating an existing goal, you must include
the EIB to update an existing goal. all existing information for the goal: if you don’t
populate it in the input file, the EIB removes it.
If this occurs, rescind the business process events
for the EIB. Then populate the EIB input file with all

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 357

Issue Cause and Solution


existing information that you wish to retain, before
resubmitting

The EIB issues error: This issue will occur if the EIB input field doesn't
property populate the field Goal Target and
Validation error occurred. You must set the Track
Annual Track By. Populate the Workday ID (aka
By for goal targets and actuals to Percent.
WID) value in this field.
To get the WID, you can:
1. Run Integration IDs Report.
2. In the Business Object prompt select:
•Goal Target And Actual Track By
(Metadata).
• Goal Target And Actual Track By
(Tenanted).
3. The Workday ID (WID) value displays.

Business Processes
Manage Goals.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new entries or update existing entries. You can't delete entries.
• If you have inadvertently uploaded incorrect entries, use task Mass Cancel Business Processes or
Mass Rescind Business Processes. What you use depends on whether the business process event
is complete or in progress. You can then select Business Processes Loaded by EIB to find the
integration event that you wish to cancel or rescind. The other option is to enter Manage Goals at the
Business Process Types prompt.
For reference documentation for all web services including Manage Goals, see Operation Directory.

Sample EIB Input File


Manage_Goals-WD32

Concept: Start Performance Review EIB

Background
You can use this EIB to create in-progress or completed performance reviews for an employee.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Start Performance Review for Employee
• Start Development Plan for Employee
• Start Disciplinary Action for Employee
• Start Performance Improvement Plan for Employee
• Start Performance Review for Organization

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 358

There are also similar EIBs that you can use for employee reviews. Consider these options as you
determine what works best for you:
• Manage Goals: You can use this EIB to add new worker goals and edit existing goals for a worker.
• Put Organization Goal: You can edit a new or existing Goal for an organization.
• Import Employee Reviews: You can use this EIB to import employee reviews from an external system.
• Update Employee Review Rating: You can use this EIB to update employee reviews. You can update
the manager's overall ratings and comments along with the item and section ratings.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Start
Performance Review business process in the
Performance Enablement functional area to
run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• It's very important to make certain that
everything aligns between the EIB input file and
Start Performance Review Business Process
Definition and Employee Review Template.
Example:
• Start Performance Review business
process definition: If you don’t want to
process a step such as the Complete Self
Evaluation step, add a condition rule to the
step such as External Load isn’t blank. Or
you can populate the Overview section of the
EIB input file to skip the step if it's marked as
optional in the business process definition.
• Employee Review Template: The fields
you need to populate in the EIB input file
depend on the configuration of the template.
Example: If you don’t populate the period
start and end dates in the Employee Review
Template, then you need to populate these
dates in the EIB input file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 359

• We suggest you start by testing the EIB load


for 2 or 3 performance reviews in your Sandbox
tenant. You can then make certain that the
information is populating properly and the
business process event is landing on the desired
step.
• As you populate the EIB input file, consider:
• Overview worksheet in the EIB input file:
• For sections where you want to load data,
and have it automatically processed by
the EIB:
• Set processing instructions to
Automatic Processing.
• Populate all required data in the
corresponding worksheet for this
section.
• For sections where you want someone to
manually process the data:
• Set processing instructions to Manual
Processing.
• Don’t populate any data in the
corresponding worksheet for this
section, except for the Complete
Manager Evaluation worksheet.
Populate the spreadsheet key at
a minimum if you want this step
processed.
• For sections that you aren’t using:
• Set processing instructions to Skip
Processing when Step is marked
Optional.
• Then edit the Start Performance Review
business process definition and you can
either mark the corresponding step as
Optional or else add a condition rule to the
step such as External Load is not blank.
• Notifications: Notifications aren’t submitted
when using processing instructions Automatic
Processing. Also, Workday skips to do steps,
approval, and review steps.
• Start Performance Review worksheet in the
EIB input file:
• Spreadsheet Key: Specify a unique value for
each worker
• Employee ID: Specify the employee’s
ID. Note that this web service doesn't
support contingent workers. Use EIB Import
Employee Reviews instead.
• Review Template: To find the reference ID
value, you can run the Integration IDs report
and select business object Employee Review
Template. Or you can use View Employee

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 360

Review Template and from related actions,


select Integration IDs > View IDs. Also,
note that the review template must be of
type: Performance Review. Load other types
of review templates using the EIB Import
Employee Reviews.
• Period Start Date and Period End
Date: Specify these values only you're
not providing a start and end date in the
Employee Review Template. Note that
you're unable to change these dates once
the review has started, so make certain
to properly populate the dates.
• Complete Manager Evaluation worksheet in
the EIB input file:
• If you want to manually complete the
Complete Manager Evaluation step by
the manager, then populate only the
Spreadsheet Key value and leave all other
fields blank.
• Manager: If you're populating this field, most
likely you'll need to change cell C4 from
Contingent_Worker_ID to Employee_ID .
• Rating: To find the reference id, go to the
Employee Review Template to identify the
rating scale that it uses. You can then view
the rating scale to check the Review Rating
values. From the related action of the Review
Ratings, select Integration IDs > View IDs.

Common Issues and Errors

Issue Cause and Solution

I accidentally canceled or rescinded the Note that there are 2 EIBs to load performance
performance reviews. Can I reload them using the data:
EIB?
1. Start Performance Review
2. Import Employee Reviews
Based on the type of information loaded to the
performance reviews and based on whether they're
in progress or completed, you might or might not be
able to use 1 of the above EIBs to reload the data.
Review the information below to help you determine
options.
Note that Start Performance EIB only allows the
importing of the overall rating.
The Import Employee Reviews EIB
supports completed reviews. If the review is still in
progress, then you can't load the evaluation data
with this EIB.
Depending on the state of the review, and
depending on the data you need to load, you might

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 361

Issue Cause and Solution


be able to use one of the EIBs. However, if the
EIBs don't meet your need, then consider:
1. If the review data exists in a nonproduction
tenant, you might be able to gather it from that
tenant and reenter it to your production tenant
after relaunching the reviews. Or you might be
able to extract it from the nonproduction tenant
using the Generate Spreadsheet with Data
option for the Import Employee Reviews EIB.
Then load it back to the production tenant using
the EIB. However, this option will work only for
completed reviews.
2. You might be able to review the information
from the full process event of the canceled or
rescinded reviews, and reenter it.
3. You could use the Start Performance Review
web service to load the overall ratings, but the
employees would then need to reenter other
missing information.
4. You could create a report, using data source
Employee Reviews Indexed, to provide to
employees with the information they need to
reenter.
5. As a last resort, you could restore the production
tenant to a time prior to the cancel or rescind,
but you’ll lose any data entered after the restore
time.

The EIB fails with error: The integration is expecting information for the
manager evaluation. If you want to complete
Validation error occurred. Element Content
this step manually, then update the EIB input file
'Manager_Reference' is required, on internal
and populate only the Spreadsheet Key value in the
element 'Complete Manager Evaluation Sub
Complete Manager Evaluation tab.
Business Process'.

The EIB fails with error: Check to:


Validation error occurred. Invalid ID value. '99999' • Make certain the employee ID is valid.
is not a valid ID value for type = 'Employee_ID'. • Make certain you aren’t specifying a contingent
worker. This EIB doesn't support contingent
workers.

I want to change the Review Date values but am There isn't a way to change review dates on an in-
unable to do so. progress or completed review. You can't do this
in the web service or user interface. Note that you
could cancel the reviews and start over. You would
also have to create a new review template if you
specified the review period dates in the template.
Most likely, you wouldn't want to do this, but that is
the only option to change the dates at this time.

The EIB fails with error: The issue occurs because you're populating the
start and end date in the EIB input file, even though
you've already specified this information in the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 362

Issue Cause and Solution


Period Start Date cannot be populated when the template. To resolve the issue, remove the start
<name of your template> Review Template doesn't and end date from the EIB input file.
contain a Period End Date. Please remove the
Period End Date from the request, or change the
Review Template to a be a Review Template that
allows for Period End Date to be entered.

The notifications aren’t firing. Check the processing instructions. Note that if the
processing instructions are Automatic Processing,
then Workday suppresses notifications (and also
skips approval steps, review steps and to do steps).
You'll need to switch the processing instructions to
manual processing if you need notifications.

The EIB fails with error: Check to:


The entered information does not meet • Make certain the employee isn't terminated. This
the restrictions defined for this field. EIB doesn't support terminated workers. Use
(Employee_Reference). Import Employee Reviews EIB instead.
• Check the business process security policy for
Start Performance Review and make certain you
have unconstrained access to initiating action
Start Performance Review (Web Service). If you
make any changes to the policy, activate the
changes before retesting the EIB.

The EIB fails with an error like this: This EIB only supports the loading of Reviews
where review type is Performance Review. If you
The ABC Development Plan Template is not for the
need to load any reviews with a type other than
category of performance review. Please review a
Performance Review, consider using the Import
Template that is for performance reviews.
Employee Reviews EIB.

EIB isn’t following Business Process steps resulting This issue will occur if using a rule-based business
in unexpected results such as event remaining process configuration as we don't yet support
in progress when you expect it to complete. Or rule-based definitions when using the EIB. In
event completes when you expect it to remain in the meantime, configure the default definition to
progress. support the EIB steps.

Business Processes
Start Performance Review.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to create new performance reviews. You can't delete reviews. You can't
update existing reviews except for 1 exception: you can use EIB Update Employee Review Rating to
update the manager's overall ratings/comments along with the item and section ratings.
If you've inadvertently uploaded incorrect entries, use task Mass Rescind or Mass Cancel (depending
on whether the business process event was completed or in progress). Note that there isn't an option to
specify the EIB when canceling/rescinding for Start Performance Review. So instead, you can enter Start
Performance Review on the Business Process Types prompt and enter the date and time range that you
submitted the EIB. Proceed with caution because if you inadvertently cancel or rescind the wrong events,
you can't undo the cancel or rescind.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 363

For reference documentation for all web services including Start Performance Review, see Operation
Directory.

Sample EIB Input Files


Start_Performance_Review-WD33-Example1
Start_Performance_Review-WD33-Example2
Start_Performance_Review-WD33-Example3

Concept: Update Employee Review Rating EIB

Background
You can use this EIB to update employee reviews.
Note:
• You can only update manager ratings, you can't update employee evaluation information.
• You can only add rating information to existing sections and items, you can't add new sections or items.
• We recommend that you use the EIB only after you complete the manager evaluation in Workday.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Business Process > Correct on the related actions menu of a manager evaluation event.
There are also similar EIBs that you can use for employee reviews. Consider these options as you
determine what works best for you:
• Import Employee Reviews: You can use this EIB to import employee reviews from an external system.
• Start Performance Review: You can use this EIB to create in-progress or completed performance
reviews for an employee.

EIB Input File Guidelines

Web Service Version and Security Configuration • This web service underwent major changes for
Guidelines v35.0, so you’ll want to make certain your EIB is
using a recent web service version. To check the
version:
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• You must have access to Process: Employee
Reviews domain in the Performance
Enablement functional area.

Guidelines for Modifying the EIB Template Prepare the EIB to generate with data.
1. From the related actions of your EIB, select
Template Model > View.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 364

2. Click Edit Template Model Sheet.


3. Locate the Review Section Evaluation Data+
section.
4. Select the Separate Type Column check box
for Manager Section Rating.
5. Locate the Review Component Data+ section.
6. Select the Separate Type Column check box
for Manager Item Rating.
7. Click OK.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
To prevent data loss, we recommend that you
generate your spreadsheet with data for the Update
Employee Review Rating EIB. See: Example:
Generate EIB Spreadsheet Template with Data on
page 62.
It's easiest to generate the template with data.
Then you can merely update the template with any
ratings, comments, and so on, that need revising.
There's no need to remove the sections or items of
the review that you don't need to update: instead,
you can just leave them in the EIB input file as is.
If you're not prepopulating the EIB input file by
using the Generate Spreadsheet with Data option,
it might be challenging to find reference id values.
One possible option would be to review the
employee review template and get the reference id
values from related actions of the fields within the
template.
If populating any data in a given section, include
existing values to prevent the web service from
removing the data.
• Primary Section
• Spreadsheet Key: Specify a unique value for
each individual review.
• Employee (Required): Enter Employee ID or
Contingent Worker ID.
• Review Type (Required): To find the
reference id value, you can run the
Integration IDs report and select business
object Review Type.
• Period Start Date and Period End Date
(Required): Be sure to select the dates that
match the review you need to update (you

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 365

can specify just the date, or you can specify


the date and time).
• Rating: The overall rating assigned to the
review.
• Override Overall Rating: Specify whether
to override the rating for the section. The
web service ignores the value if you haven’t
enabled the Rating with Overrides option.
• Manual Override: Overall rating assigned
to the review if manually overriding. (Only
applies to configurations with manual
override.)
• Comment: Overall Manager Comment. You
can use html markup, if desired
• Review Section Evaluation Data
• Row ID: Enter a unique row id value for each
different section within a given employee
review.
• Section ID: The Reference ID of a Review
Section. You can't add new sections to the
review.
• Manager Section Rating: The manager's
rating of the section, if permitted in the
employee review template. Updating this
field implies you’re attempting to override
the current rating. You can enter a reference
id value for either the proficiency rating or
the review rating, depending on what you
configured for the section. In the attached
sample EIB input file, we used the Separate
Type Column option so that you can
populate both the reference id type and the
reference id value. This option is helpful as
it allows you to easily populate rating and
proficiency scales within a single EIB input
file. Refer to Guidelines for Modifying the
EIB Template section on how to modify the
template to separate the rating column so
that you can specify both the reference id
type and reference id value.
• Override Section Rating: Applies if you
configured a section with override.
• Manager Section Comment: Manager
Comment for the section. You can use html
markup, if desired.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 366

• Review Component Data (Items for each


Section)
• Row ID: Enter a unique row id value for each
individual item within a given section.
• Item ID: The Reference ID value of an Item.
You can't add new items to the review.
• Item Name: The name of the item. This field
is informational only and you can leave it
blank if you wish.
• Weight: Enter value if applicable and if
permitted for the item.
• Manager Item Rating: The manager's rating
of the item. Updating this field implies you're
attempting to override the current rating. You
can enter a value for either the proficiency
rating or the review rating, depending on
what you configured for the item. In the
attached sample EIB input file, it uses the
Separate Type Column option so that you
can populate both the reference id type and
the reference id value. This option is helpful
as it allows you to easily populate either
rating or proficiency scales within a single
EIB input file. See Guidelines to Modifying
the EIB Template section on how to modify
the template to separate the columns.
• Manager Item Comments: Manager
Comments for the item. You can use html
markup, if desired.

Common Issues and Errors

Issue Cause and Solution

Unable to launch the EIB. When running report View Security for Securable
Items, you'll see that you need “Put” access
to domain security policy Process Employee
Reviews to run this EIB. Add the access and
activate the change. Then retest.

The EIB issues errors like these: This issue will occur if the EIB can't find an existing
review that matches the review type and the period
• Rating Reference is not allowed unless the
start/end date that you selected. If you receive this
employee review uses a template with an overall
error, verify you’ve entered the correct start and
rating method of "Prompt for Overall Rating" or
end date and that the reference id, for the review
"Calculated Rating with overrides". These are
type, is correct.
the only 2 rating methods that allow for a Rating
Reference to be entered.
• Review Rating is not valid for the rating scale
used for this review.
• A manager evaluation does not exist for the
following information provided: Employee:
Review Type: Annual Performance Review Start
Date: 2019 01 01 End Date: 2019 01 02

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 367

Issue Cause and Solution

My EIB input file has fewer columns than the There are 2 things to check:
attached sample EIB input file.
1. Make certain you're using version v35.0 or
newer as this version includes several new
fields. If you're not certain what version you’re
using, create a new EIB, which will uptake the
latest version
2. The attached EIB input file uses the Separate
Type Column option for some fields so that you
can specify both the reference id type and value
to use. To use this option, see Guidelines for
Modifying the EIB Template section on how to
modify the template to separate the columns.

The EIB issues this error: This error might occur if the review is still in
progress. Note that the review event must have
Validation error occurred. A manager evaluation
already reached or gone past the Complete
does not exist for the following information
Manager Evaluation step.
provided: Employee: Review Type: Annual
Performance Review Start Date: 2019 01 01 End
Date: 2019 12 31.

The EIB completes successfully but didn't update Note that:


all the ratings.
• Values entered in the Section or Overall rating
fields are ignored for configurations other than
Calculated with Overrides.
• If you configured the Employee Review
Template to calculate with overrides, then check
the EIB input file and verify that fields Override
Overall Rating and Override Section Rating
are set to Y.

After the EIB completes, some of the existing The web service does a replace all for each
information, such as comments, are removed. section. If populating any data in a given section,
include existing values to prevent the web service
from removing the data.

EIB fails with an error like this: This issue occurs if the Item Name you specified
in the EIB input file is different than the Item Name
You cannot change the name of a review
used by the review.
component.
To resolve this issue:
• Use the Generate Spreadsheet with Data
option to create the EIB input file. This option
should populate the correct item name in the
EIB input file.
• Another option is to remove the Item Name
value from the EIB input file since it’s a read-
only value

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to update or remove rating information.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 368

• There’s no rescind option. If you have inadvertently uploaded incorrect entries, just correct the ratings in
the EIB input file and resubmit it. If you need to remove a rating, use value {empty} in the EIB input file
(refer to attached sample file for an example)
For reference documentation for all web services including Update Employee Review Rating, see
Operation Directory.

Sample EIB Input Files


Update_Employee_Review_Rating-WD35_0
Update_Employee_Review_Rating-v40

Recruiting EIBs
Concept: Create Evergreen Requisition EIB

Background
You can use this EIB to create new evergreen job requisitions.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Evergreen Requisition.
There are also similar EIBs that you can use for job requisitions. Consider these options as you determine
what works best for you:
For evergreen job requisitions:
• Close Evergreen Requisition
• Edit Evergreen Requisition
For non-evergreen job requisitions:
• Close Job Requisition
• Create Job Requisition
• Edit Job Requisition

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files.
Ensure that the steps in your Evergreen Requisition business process definition in Workday align with the
information that you populate in the EIB input file. Example: If the Evergreen Requisition business process
has a Post Job step, either populate the post job information in the EIB input file or add a condition rule to
the Evergreen Requisition business process to skip the step. Example: Add a condition rule where External
Load = N.
As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for each evergreen requisition.
• Job Description: You can use HTML to add rich text formatting, such as bold, italics, and bullets to any
field.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 369

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but evergreen This can occur if the information in the EIB input
requisitions don't load. file doesn't align with the steps in your Evergreen
Requisition business process definition in Workday.
1. Run the Mass Cancel Business Processes
task (secured to the Business Process
Administrator domain in the System functional
area) to cancel any in progress Evergreen
Requisition events.
2. Update the information in your EIB input file
to align with the steps in your Evergreen
Requisition business process definition.
3. (Optional) In Workday, consider updating the
business process definition by:
• Marking any unnecessary steps as optional
and then setting the processing instructions
in the EIB input file to Skip Processing for
optional steps.
• Adding condition rules on steps to skip them
in the business process if needed. Example:
Add a condition rule where External Load =
N.
4. Rerun the EIB.
You can use the Business Processes tab in
the EIB integration event to view and identify the
business processes that are still in progress.

The EIB displays an error message such as: In the Worker Sub-Type field, specify employee ID
values instead of contingent worker ID values.
Invalid ID value. Regular is not a valid ID value for
type = Contingent_Worker_Type_ID.

The EIB displays an error message such as: In the Academic Affiliate ID fields on the Assign
Organization Roles tab, specify position ID values
Invalid ID value. P-00017 is not a valid ID value for
instead of academic affiliate ID values.
type = Academic_Affiliate_ID.

Business Processes
Evergreen Requisition.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only enables you to add new evergreen requisitions. If you want to update existing requisitions,
consider using the Edit Evergreen Requisition EIB.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 370

For reference documentation for all web services including Create Evergreen Requisition, see Operation
Directory.

Sample EIB Input File


Create_Evergreen_Requisition-WD31

Concept: Create Job Requisition EIB

Background
You can use this EIB to create new job requisitions.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Job Requisition.
There are also similar EIBs that you can use for job requisitions. Consider these options as you determine
what works best for you:
• Close Job Requisition
• Edit Job Requisition
For evergreen job requisitions:
• Close Evergreen Requisition
• Create Evergreen Requisition
• Edit Evergreen Requisition
For posting and unposting jobs:
• Post Job
• Unpost Job
• Update Job Posting

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Job Requisition
business process type in the Pre-Hire
Process functional area to run this EIB.

Additional Input File Guidelines We recommend that you:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 371

• Review Concept: EIB Spreadsheet Data Entry


Guidelines on page 54, which provides a
general overview for populating EIB files.
• Ensure that the steps in your Job Requisition
business process definition in Workday align
with the information that you populate in the
EIB input file. Example: If the Job Requisition
business process has a Request Requisition
Compensation step, either populate the
compensation information in the EIB input file
or add a condition rule to the Job Requisition
business process to skip the step. Example: Add
a condition rule where External Load = N.
As you populate the Overview tab of the EIB input
file, consider:
• We recommend that you set the Create
Requisition processing instructions to Run Now
with Automatic Processing. This ensures that
all job requisition information is ready when the
Post Job step runs.
As you populate the Create Requisition tab of the
EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each job requisition.
• Position Restriction: Specify the position ID.
Only populate if the position already exists. The
position must be in a position-management
organization.
• Supervisory Organization: Only populate if the
position hasn't been created yet.
• Create Job Requisition Reason: You can find
a list of reference ID values by running the View
Reference IDs report, searching for the General
Event Subcategory business object and then
filtering the Business Object Instance field for
Create Job Requisition.
• Attachment Section: We recommend that you
avoid adding attachments to this EIB to prevent
data processing issues.
• Job Description: You can use HTML to add
rich text formatting, such as bold, italics, and
bullets to any field.
On the Post Job tab (Optional) of the EIB input file,
consider:
• If you prefer, you can post jobs later using a
Post Job EIB instead.
• Job Posting Site: You can find a list
of reference ID values by running the View
Reference IDs report and searching for theJob
Posting Site business object.
On the Assign Organization Roles tab
(Optional) of the EIB input file, consider:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 372

• If you prefer, you can assign roles later using a


Assign Roles EIB.
• Effective Date: We recommend that you leave
this field blank.
• Organization Role: Specify the type of role.
Example: Primary Recruiter.
• Row ID: Specify a unique value for each role for
a given job requisition.
• Role Assignee++: Specify the person assigned
to the role. Change the reference ID type in cell
C4 to Position_ID.
On the Request Requisition Compensation tab
(Optional) of the EIB input file, consider:
• Compensation Grade, Compensation Grade
Profile, Compensation Package: These values
might populate automatically in Workday based
on your eligibility rules configuration. For more
details, see FAQ: Compensation Defaulting.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, no job This can occur if the information in the EIB input file
requisitions are loaded or some information is doesn't align with the steps in your Job Requisition
missing. business process definition in Workday.
1. Run the Mass Cancel Business Processes
task (secured to the Business Process
Administrator domain in the System functional
area) to cancel any in progress Job Requisition
events.
2. Update the information in your EIB input file
to align with the steps in your Job Requisition
business process definition.
3. (Optional) In Workday, consider updating the
business process definition by:
•Marking any unnecessary steps as optional
and then setting the processing instructions
in the EIB input file to Skip Processing for
optional steps.
• Adding condition rules on steps to skip them
in the business process if needed. Example:
Add a condition rule where External Load =
N.
4. Rerun the EIB.
You can use the Business Processes tab in
the EIB integration event to view and identify the
business processes that are still in progress.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 373

Issue Cause and Solution

EIB completes successfully but doesn’t post the Check these:


job to the career site. Or the job is posted but the
• Check the business process event for one of the
description is missing.
job requisitions and verify that the posting step
was processed. If not, verify that the posting
step is in the business process definition and
isn’t being skipped due to a condition rule.
• Check the Overview tab of the EIB input file and
verify that processing instructions are set to Run
Now with Automatic Processing for the Create
Requisition business process. This will ensure
that job requisition information is ready at the
Post step.
• Wait 1-2 hours as it might take some time for the
indexing job to complete.

EIB issues this error: Change the reference ID type in cell C4 to


Position_ID.
Invalid ID value. 'Regular' is not a valid ID value for
type = 'Contingent_Worker_Type_ID.

EIB issues this error: Ensure that your EIB input file doesn't contain any
special characters. Example: &.
Error parsing Excel file. Make sure the spreadsheet
is in Excel XML or XLSX format. Other Excel
formats (e.g. xls) are not supported.

EIB issues an error similar to this: In the Academic Affiliate ID fields on the Assign
Organization Roles tab, specify position ID values
Invalid ID value. 'P-00017' isn’t a valid ID value for
instead of academic affiliate ID values.
type = 'Academic_Affiliate_ID'.

EIB issues an error like this: This can occur if you attempt to populate the EIB
input file with both a supervisory organization and a
Validation error occurred. Multiple Element
position.
Contents, including Create Job Requisition Data/
a1/Supervisory Organization from Position Group In this scenario, the position is already associated
[WS], contain data where only one is allowed by with a supervisory organization so the integration
mutex Create Job Requisition Data. gets confused by the redundant information
supplied in the input file.
Remove the value for supervisory organization.

Unable to launch the EIB This is most likely security-related.


Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Job Requisition business
process type in the Pre-Hire Process functional
area.

Business Processes
Job Requisition.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 374

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only enables you to add new job requisitions.
If you want to update existing requisitions, consider using the Edit Job Requisition EIB.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind.
For reference documentation for all web services including Create Job Requisition, see Operation
Directory.

Sample EIB Input File


Create_Job_Requisition-v39

Concept: Edit Job Requisition EIB

Background
You can use this EIB to edit existing job requisitions. You can only edit open job requisitions.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Edit Job Requisition.
There are also similar EIBs that you can use to update job requisitions. Consider these options as you
determine what works best for you:
• Create Job Requisition: You can use this EIB to create job requisitions (nonevergreen).
• Manage Job Requisition Freeze: You can use this EIB to freeze or unfreeze a job requisition.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Job Requisition
Change business process type in the Pre-
Hire Process functional area to run this EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 375

Additional Input File Guidelines • Ensure that the steps in the Job Requisition
Change business process definition align with
what you're populating in the EIB input file.
Example: if the business process definition
includes an Assign Roles step, then you need to
perform one of these actions:
• To assign a role, populate the role
assignments in the EIB input file. Also, in
the Overview tab of the EIB input file, set
the processing instructions to Automatic
Processing for Assign Organization Roles.
• If you don’t want to assign roles, you can
add a condition rule to skip the step in the
business process definition (Example: add
condition rule External Load = N).
• Or modify the business process definition and
mark the step as optional. Then in the EIB
input file, set the processing instructions to
Skip Processing when Step is optional.
• If you’re populating a subprocess within the
EIB input file, ensure that the Job Requisition
Change business process definition has a step
for this process. Example: if you’re populating
Compensation in the EIB input file, then the Job
Requisition Change business process definition
needs to include the Request Requisition
Compensation step.
• Perform these checks for each step in the Job
Requisition Change business process definition.
Ensure that the business process definition and
the EIB input file align. Otherwise you might
encounter situations where the EIB doesn't
load information, or the Job Requisition Change
event remains In Progress, after the EIB load
completes.
• We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• As you populate the EIB input file, consider
• Spreadsheet Key: Specify a unique value for
each job requisition
• Edit Job Requisition Reason: Workday
requires this field. If you need to view the
list of reference ID values, you can run the
Integration IDs report and search business
object General Event Subcategory
• Referring to the attached EIB input files to see
examples of how other fields are populated.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 376

Common Issues and Errors

Issue Cause and Solution

EIB issues errors related to posting the job In some cases, it’s necessary to unpost the job
requisitions. requisitions before reposting them through the Edit
Job Requisition EIB. To unpost the jobs, run the
Unpost Job EIB.

The EIB issues error: Questionnaires for Job This issue can occur if using an older web service
Requisition can’t be modified once a Candidate has version or if the tenant configuration doesn’t permit
applied to a Job Posting for the Job Requisition. updates to questionnaires. Verify this configuration:
• First, go to Edit Tenant Setup – HCM and make
certain that you’ve set Enable questionnaire
removal or replacement on evergreen and job
requisitions.
• Also, make certain that your Edit Job Requisition
EIB is using the latest web service version. If
you aren’t sure, create a new EIB, which will
ensure that the EIB uses the latest version.

The EIB issues this error: Element Content Make certain that the Row ID in column F has a
'Job_Requisition_Data' is required, on internal value.
element 'Edit Job Requisition Event Data'

The EIB completes successfully. Some changes Most likely the business process definition has
display correctly in Workday, but other changes are condition rules causing some steps to get skipped.
missing. If you supply information in the input file, Workday
ignores the information if:
• The business process step has a condition rule
that evaluates to False.
• The business process definition is missing the
step.
To check for these types of issues, view the full
process record of the business process event
and look for steps that the record displays as not
required. Change the condition rules on these
steps, if needed. After you make corrections, run
the Mass Cancel Business Processes or Mass
Rescind Business Processes task (depending on
whether the events have completed). Then, rerun
the EIB.

The EIB completes successfully but Workday didn't This issue occurs when business process events
make the changes. are still in progress. The underlying cause is that 1
of the steps didn’t complete due to the EIB input
file and business process definition being out of
alignment. If this misalignment occurs, use the
Mass Cancel Business Processes task to cancel
the job requisition changes that are in-progress.
Then correct the problem, and rerun the EIB.
Also note that there’s a Business Processes tab
that displays in the EIB integration event after
the EIB successfully completes. This tab enables

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 377

Issue Cause and Solution


you quickly to view all business process events that
the EIB loaded. You can determine whether the
events completed or are still in progress. To view
details about any of the job requisition events, you
can view the full process record from the related
action of the event.

Can't launch the EIB. This issue is most likely security-related. See the
Web Service Version and Security Configuration
Guidelines section of this topic.

Business Processes
Job Requisition Change.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to edit only. If you wish to add new entries, you can use the Create Job
Requisition web service.
If you have inadvertently uploaded incorrect entries, use either the Mass Cancel Business Processes
task or the Mass Rescind Business Processes task. You can then select Business Processes Loaded
by EIB to find the integration event that you wish to cancel or rescind. Or the other option is to enter Job
Requisition Change at the Business Process Types prompt.
For reference documentation for all web services including Edit Job Requisition, see Operation Directory.

Sample EIB Input Files


Edit_Job_Requisition-WD34-Example1-Misc-Changes
Edit_Job_Requisition-WD34-Example2-Compensation-and-Role-Assignments_1

Concept: Edit Position EIB

Background
You can use this EIB to edit a filled position.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Edit Position.
There are also similar EIBs that you can use for positions and jobs. Consider these options as you
determine what works best for you:
• Change Job: You can use this EIB to perform a job change on an employee or contingent worker.
• Create Job Requisition: You can use this EIB to create new job requisitions for a position.
• Edit Position: You can use this EIB to edit a filled position.
• Hire Employee: You can use this EIB to hire a pre-hire (new or existing) into an employee position.
• Import Edit Position: You can use this EIB to edit large volumes of positions (Example: 1000 or more). If
you need to edit large volumes of positions, consider testing in your sandbox tenant to determine which
EIB performs better for your use case.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 378

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Edit Position
business process type in the Staffing
functional area to run this EIB.

Additional Input File Guidelines • You might find it helpful to start by manually
editing a position and making the same type
of changes you want to load using the EIB. By
making these changes, you can verify which
fields Workday requires. Manually editing a
position might also be helpful when populating
Reference ID values in the input file. You can
then identify the Reference ID values by viewing
the position that you manually updated. Then,
go to each field, and from related actions,
selectIntegration IDs -> View IDs
• Ensure that the steps in the Edit Position
business process definition align to what you are
populating in the EIB input file. Example: if the
Edit Position business process has an Assign
Pay Group step, then perform 1 of these actions:
• To update the pay group field, populate the
pay group information in the EIB input file.
Then, in the Overview tab of the input file,
set the processing instructions to Automatic
Processing for Assign Pay Group.
• If you don't want to update the pay group
field, you can add a condition rule to skip the
step in the Edit Position business process
definition. Example: add condition rule
External Load = N.
• Modify the Edit Position business process
definition and mark the step as optional.
Then, in the EIB input file, set the processing
instructions to Skip Processing when Step is
marked optional.
If you’re populating a subprocess within the EIB
input file, ensure that the Edit Position business
process definition has a step for this process.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 379

Example: if you’re populating default compensation


in the EIB input file, then the Edit Position business
process definition needs to have the Request
Default Compensation for Position Event step.
Perform these checks for each step in the Edit
Position business process definition. If the business
process definition and the EIB input file don't align,
then you might encounter these situations:
• The EIB doesn't load information into Workday.
• The Edit Position event displays as still in
progress after the EIB load completes.
• We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each Position.
• Worker and Position: You can enter just
the worker reference if the worker has only 1
position that you can edit. If the worker has
more than one accessible position, you must
specify the position.
• Effective Date: Enter the effective date of
the change. If the position has more recent
effective date changes than what you specify
in the input file, then the current position
information won't reflect the change.
• Additional Job Classifications: the web
service operation performs a replace all
for this field. Therefore, you must list all
relevant job classifications in the EIB input
file (one per row). Those classification entries
will replace the current job classification
values assigned to the position. To remove
existing job classifications, and not replace
the classifications with new values, then enter
value {empty}.

Common Issues and Errors

Issue Cause and Solution

EIB issues this error: Validation Populate at least 1 field in the Position Details
error occurred. Element Content sections of the EIB. If you encounter this error,
'Filled_Position_Edit_Details_Data' is required, on populate field Position ID (column G), as populating
internal element 'Edit Position Event Data'. this field satisfies the requirement of populating at
least 1 detail field

The EIB completes successfully and makes some This issue typically occurs for 1 of 2 reasons:
changes in Workday, but other changes are
• You entered an older effective date, and made
missing.
other changes to the position, with a newer

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 380

Issue Cause and Solution


effective date. Therefore, the changes in the
EIB input file don't match the current position
information. To resolve this problem, specify a
more recent effective date in the input file. Then,
mass-rescind the edit position events that you
loaded, and reload the EIB file.
• The other cause of this issue is that
the business process events are still in
progress. This issue occurs because one of
the steps didn’t complete due to the EIB input
file and business process definition being out
of alignment. If this issue occurs, you can run
Mass Rescind Business Process to cancel the
in progress edit position events. Then correct
the problem, and rerun the EIB.
Also, note that there’s a Business Processes
Loaded tab that displays in the EIB integration
event, after the EIB successfully completes. This
tab enables you to view all business process events
that the EIB loaded. From here, you can determine
whether the events have completed or are still in
progress. To view details about the position events,
view the full process record from the related action
of the event.

The EIB completes successfully but the changes Most likely, the business process definition has
don't display in Workday. condition rules causing the EIB to skip some of the
steps. Even if you supply information in the input
file, the EIB ignores the information if
• The business process step has a condition rule
that evaluates to false.
• The business process definition is missing the
step.
To check for these types of issues, view the full
process record of the business process event and
look for steps that are not required. Change the
condition rules on these steps, if needed. After
making corrections, you can run a mass cancel or
mass rescind (depending on whether or not the
events complete. Then you can rerun the EIB.

When using the Request Compensation Change When editing the position (either manually or using
subprocess, the subprocess removes or adds plans EIB), the EIB uses default compensation from the
that aren't in the EIB input file. position as a source to populate compensation
attributes automatically. If default compensation
isn't available, then the EIB uses eligibility rules
to populate compensation attributes. If you need
to edit compensation for a filled position and don't
want to use any default values, then you might want
to consider using the Request Compensation
Change EIB instead. See FAQ: Compensation
Defaulting .

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 381

Issue Cause and Solution

When using Request Compensation Change Submitting plans with no value counts as $0 for
subprocess and populating only the plan name, the this web service. Workaround is to populate the
web service sets amount to $0 individual target, amount, frequency, and currency.
instead of using the default values for the plan.

Business Processes
Edit Position.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to edit positions. You can’t add or delete positions using this web service.
• If you have inadvertently uploaded incorrect entries, use either the Mass Rescind Business
Processes or the Mass Cancel Business Processes tasks. You can then select Business Processes
Loaded by EIB to find the integration event that you wish to cancel or rescind. Another option is to enter
Edit Position at the Business Process Types prompt and then enter the data range when the EIB ran.
For reference documentation for all web services including Edit Position, see Operation Directory.

Sample EIB Input Files


Edit_Position-WD31-Example1-Change-Pay-Group
Edit_Position-WD31-Example2-Change-Position-Details
Edit_Position-WD31-Example3-Change-Location
Edit_Position-WD31-Example4-Add-Default-Compensation

Concept: Manage Job Requisition Freeze EIB

Background
You can use this EIB to freeze or unfreeze job requisitions. Don’t file or close the requisition.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Tasks


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Manage Job Requisition Freeze.
• Mass Action on Job Requisitions. See Steps: Set Up Mass Actions on Job Requisitions for more
information.
There are also similar EIBs that you can use for job requisitions. Consider these options as you determine
what works best for you:
• Close Job Requisition
• Create Job Requisition
• Edit Job Requisition
For evergreen job requisitions:
• Close Evergreen Requisition
• Create Evergreen Requisition
• Edit Evergreen Requisition

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 382

For posting and unposting jobs:


• Post Job
• Unpost Job
• Update Job Posting

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage Job
Requisition Freeze business process in the
Pre-Hire Process functional area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each job requisition.
• Job Requisition: Enter the job requisition id.
• Freeze Unfreeze Reason: Workday requires
this field. To find the reference id values
for the reasons, you can use the View
Reference IDs report and select business
object General Event Subcategory. Then you
can filter the business object instance column
byfreeze to view the appropriate entries.
• Freeze Unfreeze Date: Enter the freeze or
unfreeze date in format YYYY-MM-DD.
• Frozen: Enter Y or N.

Common Issues and Errors

Issue Cause and Solution

EIB issues this error when attempting to unfreeze a Workday delivered a fix in 2020R2 (internal ticket
job requisition: HRJOBREQ-4833), to address this issue. If you still
encounter this error, create a new EIB to uptake the
Validation error occurred. Cannot unpost job when
latest web service version. Then, retest. If you still
unfreezing a job requisition
experience the issue, you can:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 383

Issue Cause and Solution


• Create a new EIB that you’ll use specifically for
unfreezing job requisitions. You might want to
name it Manage Job Requisition Unfreeze.
• From the related actions of the EIB, select
Template Model > View.
• At the bottom of the page, you’ll see a Business
Process Tab listing each step.
• Click Edit Business Process for Template.
• Check the Hidden check box on the Unpost Job
Sub Business Process entry.
• Click OK.
• Regenerate the template.
• Repopulate the data in the new template and
retest.

EIB issues this error when attempting to freeze a To resolve the error, you can:
job requisition:
• Edit the EIB input file.
Validation error occurred. Cannot post job when • Go to the Overview tab.
freezing a job requisition. • Set the processing instructions to Automatic
Processing for Post Job.
• Go to the Post Job tab. In Column B, enter
the same spreadsheet key value that matches
corresponding entry in the Manage Job
Requisition Freeze tab

Business Processes
Freeze Job Requisition.

Use Cases and Guidelines for Recovering from a Bad Load


If you have inadvertently uploaded incorrect entries:
• Use task Mass Cancel Business Processes or Mass Rescind Business Processes (depending
whether the business process event is complete or in progress).
• You can then either:
• Select Business Processes Loaded by EIB to find the integration event that you wish to cancel or
rescind.
• Enter Freeze Job Requisition at the Business Process Types prompt and enter a date range that you
ran the EIB.
For reference documentation for all web services including Manage Job Requisition Freeze, see Operation
Directory.

Sample EIB Input Files


Manage_Job_Requisition_Freeze-WD34-FREEZE
Manage_Job_Requisition-Freeze-WD34-UNFREEZE

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 384

Concept: Move Candidate EIB

Background
You can use this EIB to move a candidate from any recruiting stage to the next possible stage or to a
disposition stage.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Job Application > Move Candidate from the related actions menu of the candidate's
profile. For more information, see ../../../../human-capital-management/recruiting/recruiting-setup/
bml1563928837942.dita.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security configuration
• You must have access to the Move
Candidate domain in the Recruiting functional
area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Please test thoroughly in a nonproduction tenant
for these reasons:
• You can’t undo dispositions if
they’re incorrectly updated using the EIB.
• If the notifications aren’t properly disabled
prior to launching the EIB, you can't stop
the email delivery of the notifications after
initiating the EIB.
• As you populate the fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each job application
• You need to populate just 1 of these 3
fields depending on whether you want to
disposition the candidate or move them to a
step or a parallel step. To find the reference

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 385

ID value for these fields, refer to instructions


in section How to find the reference id for a
disposition stage or next step:
• Next Step
• Disposition Stage
• Start Parallel Stage
• Row ID: Specify a unique row ID value for
each entry within a given spreadsheet key
value.
• To indicate which candidate to move, you
need to populate one of these fields, but
don’t populate both sets of fields. To find the
reference ID value for these fields, refer to
instructions in section How to find reference
ids for candidate, job requisition, and job
application:
• Job Application
• Candidate and Requisition

Find the Reference ID for a Disposition Stage or To populate the Disposition Step, Next Step or
Next Step Parallel fields in the EIB input file:
1. Display the Job Application business process
definition and go the appropriate subtab.
2. From the related actions of the step you're
moving the candidate to select Integration IDs >
View ID's.

Disable Notifications There are several options to disable notifications for


the candidates you’re updating. Test the EIB for a
few candidates in a non-Production tenant to verify
that the emails aren’t firing.
• Option 1
• Disable notifications in the Job Application
business process and any relevant
subprocesses. Example: If you’re moving all
candidates to a specific disposition, you can
disable the notification for that disposition.
• If you select this option, run Maintain
Business Process Definition Selection
and verify that you enabled the Dynamic
Business Process Effective Date option for
the Job Application business process and
subprocesses.
• Option 2
• Add a condition rule that evaluates to false
to any notifications that you don’t wish to
fire. You might want to consider adding a
condition to exclude the user running the EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 386

Example Current user not in selection list


UserABC.
• As noted in option 1, run task Maintain
Business Process Definition Selection
to verify that you enabled the Dynamic
Business Process Effective Date option for
the Job Application business process and
subprocesses.
• Option 3
• Temporarily disable all notifications in
the tenant using task Edit Tenant Setup -
Notifications.
• If you select this option, it disables ALL
notifications in the tenant. If you elect this
option, you might wish to run the EIB when
there’s very little activity in the tenant.

Common Issues and Errors

Issue Cause and Solution

EIB issues error: This issue will occur if:


Validation error occurred. The next step, parallel • The disposition step, populated in the EIB, isn’t
step, or disposition chosen is invalid for the job valid for the job application.
application process. • The EIB requires a condition step on the
disposition step.
If you don’t see any issues with the above
configuration, you can try manually moving 1 of the
candidates to the disposition, just to verify it’s truly
valid.

Unable to launch the EIB This issue is most likely security-related. When
running report View Security for Securable Item
for securable item Move Candidate (Web Service),
you’ll see that you need Put access to domain
security policy Move Candidate. To change the
security, you can:
1. Edit the domain security policy for Move
Candidate.
2. Make certain you are in a security group that
has Put access. Ideally, you should be in an
unconstrained security group so that you can
move any candidate using the web service.
3. Activate the security change.

EIB issues an error like this: This error will occur if the EIB input file contains
conflicting information. Make sure that you’re
Validation error occurred. Multiple Element
populating only one of these 3 fields:
Contents, including Dynamic Business Process
Parameters/a1/Recruiting Next Workflow Step 1. Next Step
Singular [WS], contain data where only one is 2. Disposition Step
allowed by mutex Dynamic Business Process 3. Start Parallel Stage
Parameters

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 387

Issue Cause and Solution

EIB issues an error like this: This issue will occur if the EIB input file contains
overlapping information regarding the candidate
Validation error occurred. Multiple Element
you're moving. Make sure you populate only the
Contents, including Move Candidate Data/c/Move
job application -OR- the candidate/job requisition.
Candidate Criteria [EL], contain data where only
one is allowed by mutex Move Candidate Data

Notifications are firing even though I disabled them. See Disable Notifications section for instructions to
properly disable notifications.

Business Processes
The business process that this EIB uses depends on the step you move the candidate to. These include:
• Assess Candidate
• Interview
• Review Candidate

Use Cases and Guidelines for Recovering from a Bad Load


• Although the EIB uses a business process, there’s no rescind option.
• If you have inadvertently declined job applications, it is not possible to undo this action. Instead, you
would need to start a new job application.
• If you inadvertently moved candidates to the wrong step, you might possibly be able to rerun the EIB
and move them to the correct step. Or other option is to manually undo the move.
For reference documentation for all web services including Move Candidate, see Operation Directory.

Sample EIB Input File


Move_Candidate-WD34_0

Concept: Offer EIB

Background
You can use this EIB to initiate an offer for a job application. The job application must be in a step before
the offer, and the offer must be a next possible stage for the job application.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See ../../../../human-capital-management/recruiting/offers/san1462472397084.dita.

EIB Input File Guidelines

Web Service Version and Security Configuration • Ensure that your EIB uses the most recent web
Guidelines service version for the latest enhancements and

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 388

fixes. If you aren't certain what version you're


using, follow these steps:
1. From related actions of the EIB, select
Template Model > View.
2. You can view the version on this page. Verify
you’re using a newer version.
3. If using an older web service version, you can
create a new EIB to get the latest version
• Verify you have the correct security
configuration.
• You must have access to the Offer business
process in the Recruiting functional area to
run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To use this EIB, the job application must be in
a stage before offer. The offer must be a next
possible stage for the application.
• The Offer EIB will populate compensation as
described in FAQ: Compensation Defaulting.
• As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each Job Application.
• Next Step: This field is optional. Populate it
only if you intend for the EIB to fully complete
the offer and move the candidate to the
next stage. If populating this field, refer
to the screenshot below for assistance in
determining the reference ID value to use.
• Disposition Step: This field is optional.
Populate it only if you intend for the EIB to
fully complete the offer and then you wish
to disposition the candidate. If populating
this field, refer to the screenshot below for
assistance in determining the reference ID
value to use.
• There are a few different options, outlined
below, to specify the job application
information. The attached EIB input file
includes an example for each option.
• Option 1: Populate the Candidate and
Requisition (columns K and L).
• Option 2: Populate the Workday ID (WID)
of the Job Application Event (column I).
You'll also need to change cell I4 from IID
to WID.
• Option 3: Populate the Job Application
(column J). If selecting this option, create

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 389

a custom report from data source All


Job Applications, to get the reference ID
value.
• Auto Complete: This field is available for
each separate section of the EIB, such
as the offer process. It's also available
for subprocesses, like compensation and
one-time payment. Enter Y if you wish for
the section to autocomplete and to skip
approvals, to-dos, and notifications.
• Refer to the attached EIB input file for
examples of how the EIB populates other
fields.

Common Issues and Errors

Issue Cause and Solution

EIB issues an error like this: This error indicates that the EIB input file populated
an invalid next step or disposition. Refer to the
Validation error occurred. The next step, parallel
screenshot in Step 2 to identify the reference ID
step, or disposition chosen is invalid for the job
value. If you continue to experience issues:
application process.
• Try manually populating the job offer for one of
the offers where you receive the error, and
• Verify that you can use the same next step or
disposition that you’re populating in the EIB
input file.

Unable to launch the EIB This error is most likely security-related. Refer to
Step 1 above.

The initiation step of the Offer business process This functionality is working as intended: The
doesn't evaluate the conditions, even when initiation step doesn't evaluate the conditions since
disabling the auto-complete flag. the offer is part of a dynamic business process.

Business Processes
Offer.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to initiate the offer. You can't update or delete an existing offer
• Although this EIB uses a business process, there would be no option to rescind or cancel the business
process. If you inadvertently loaded incorrect offer data, consider these scenarios:
• If the offer events successfully completed, you could resubmit the offer, provided there’s an option to
move to offer stage from the job application' current stage.
• If the offer event is still in progress, you could:
• Manually correct it, or
• Consider using Move Candidate to move the job application to a stage from which you can then
reinitiate the offer EIB.
For reference documentation for all web services including Offer, see Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 390

Sample EIB Input File


Offer-v37

Concept: Put Applicant EIB

Background
You can use this EIB to add or update pre-hires.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Pre-Hire.
There are also similar EIBs that you can use for pre-hires. Consider these options as you determine what
works best for you:
• Import Applicant: You can use this EIB to load large volumes of pre-hires (Example: 1000 or more). If
you need to load large volumes of pre-hires, consider testing in your sandbox tenant to determine which
EIB performs better for your use case.
• Hire Employee: You can use this EIB if you want to upload the applicant and then immediately proceed
with the hire event.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage Pre-
Hire Process: Manage Pre-Hires domain in
the Pre-Hire Process functional area to run
this EIB

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
Applicant EIB. See: Example: Generate EIB
Spreadsheet Template with Data on page 62.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 391

• As you populate the EIB input file, consider:


• Spreadsheet Key: Specify a unique value for
each pre-hire.
• Add Only: Y/N field to indicate whether this
pre-hire is new or existing.
• Applicant: If updating an existing pre-hire,
enter the reference ID here.
• Applicant ID: If adding a new applicant,
you can enter the reference ID value here,
or leave field blank for the web service to
autoassign. If specifying your own ID, verify it
isn’t already in use.

Common Issues and Errors

Issue Cause and Solution

EIB issues errors such as: Fields, such as Gender, Date of Birth, Ethnicity, and
Race are localized fields. That means that only for
E1: Gender is not tracked for the specified Location
certain countries track these fields. The country of
Context. The Location Context is derived from the
the position associated with the pre-hire determines
Country of the Location for the Position.
what fields Workday tracks. If you don’t populate a
E2: The field Date of Birth is not tracked for the value in the Positions Considered For field, or if the
specified Location Context. The Location Context position is associated with a country that doesn’t
is derived from the Country of the Location for the allow the localized field value, you’ll receive 1 of
Position. these errors. Consider these workarounds:
• Add a position in the input file, in the Positions
Considered For field. You don't need to
ultimately assign the pre-hire to this position.
Rather, you could just reference a position
belonging to the location that you could hire
them for.
• Update the localized information later in the
process when the pre-hire has an associated
position. Example: If you’ll eventually run a hire
EIB for these applicants, then you could enter
the information at that time.

EIB loads successfully but is missing information Verify that no row IDs are missing in the sections
such as address, email, and phone# of the EIB where you populated the contact
information.

EIB issues an error like this: Verify that no row IDs are missing in the sections
of the EIB where you populated the contact
Validation error occurred. At least 1 email address,
information.
phone number or address is required to create a
new applicant.

I want to update rehire eligibility You can update the rehire eligibility using this EIB.
Refer to example in the sample EIB input file.

Unable to launch the EIB This issue is most likely security-related. Refer to
EIB Input File Guidelines section above.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 392

Issue Cause and Solution

Can I update the reference ID of an existing pre- Yes, you could also update the EIB using the Put
hire? Reference EIB.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new pre-hires or update existing pre-hires. You can’t delete pre-
hires.
• Since this EIB doesn’t use a business process, there's no option to rescind or cancel. If you’ve
inadvertently uploaded incorrect entries, consider:
• If you want to retain the pre-hires, you could get the applicant IDs, and then reload the pre-hires with
correct information
• If you need to remove the pre-hires, consider using the Delete Pre-Hires task.
For reference documentation for all web services including Put Applicant, see Operation Directory.

Sample EIB Input File


Put_Applicant-WD37

Concept: Put Candidate EIB

Background
You can use this EIB to add or update a candidate (a person associated with a job requisition) or a
prospect (a person with no job requisition).
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Avoid using this EIB for pre-hires. We recommend that you use the Put Applicant EIB for pre-hires.
This EIB supports placing candidates into the initial job application stage, but it doesn’t support updates to
the job application process. If you need to disposition a candidate for an existing job application process,
avoid using this EIB. Consider using the Move Candidate EIB instead.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Prospect
• Create Job Application (if you want to create a candidate and immediately initiate a job application)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 393

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Candidate
Data: Job Application domain in the
Recruiting functional area to run this EIB

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• This EIB has a Generate Spreadsheet With
Data option. It's very helpful to use when you
aren’t certain how to populate the EIB input file.
This EIB doesn’t support using conditional rules
to extract candidate data. However, you can
extract single candidates as follows:
• Manually create a prospect or candidate like
one that you wish to load.
• From related actions of the candidate,
select Integration IDs > View IDs to get the
Candidate ID (you’ll need this ID in a later
step).
• From related actions of your EIB, select
Template Model > View.
• Go to bottom of page and select Edit
Template with Data Options.
• Set filter to Reference ID Filter.
• Then enter the Candidate ID from a previous
step.
• If you regenerate the template and select
the Generate Spreadsheet with Data option,
you can view how the data populates in the
input file for the candidate that you manually
created.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 394

• As you populate these fields in the input file,


consider:
• Spreadsheet Key: Specify a unique value for
each Candidate or Prospect.
• Candidate ID: Populate this field if updating
an existing candidate or prospect.
• Candidate Tag: If you need to load multiple
candidate tags, you can:
• On the related action of your EIB, select
Template Model > View.
• In left windowpane, scroll to the bottom
of the list of fields on the template to
Candidate Data (which is the section that
stores Candidate Tags) and select it.
• In the Area Details section within the right
windowpane, select the Action menu for
Candidate Tag+ and select Template
Model Column > Maintain Additional
Columns.
• Create the number of rows that you want
and name the column header label.
• In Reference Type ID, search for
Candidate Tag.
• Click OK and Done.
• Generate a new template and you’ll see
your new columns.
• Refer to the attached sample input file to
review how other fields are populated

Common Issues and Errors

Issue Cause and Solution

When using the EIB to add a new job application This EIB doesn’t fully support incremental updates:
for an existing candidate, the EIB wipes out some therefore the EIB input file needs to include all
of the existing candidate information such as existing candidate information that you wish to
education, skills, job history, resume. retain.

The EIB issues error: The EIB validates personal information by checking
the configuration of the localization settings.
You have entered Personal Information for this
This error message indicates that there’s invalid
Candidate, however none of the jobs applied for are
personal information for the given candidate’s
in locations where Personal Information is captured.
location. To address this error, you can:
• Use task Maintain Localization Settings and
enter Personal Information at the prompt for
Area.
• Filter the resulting list by Applies to Person Type
and select Candidate.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 395

Issue Cause and Solution


• For any localized field that you plan on
populating in the web service, verify:
• In the Allow for Countries section, add any
applicable countries.
• Check the Active field.

Unable to launch the EIB Add put access to both of these domain security
policies. Then activate the change:
• Prospects
• Candidate Data: Job Application

Business Processes
The business process that this EIB uses depends on the type of information you load.
• For job application data, the EIB uses the Job Application business process.
• For creating or updating prospects, the EIB doesn't use a business process.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add new entries or update existing entries. You can’t delete entries.
If you have inadvertently uploaded incorrect entries that are associated with a job application, then you can
remove the candidate and job application as follows:
• Use task Mass Cancel Business Processes.
• Enter Job Application at the business process type prompt.
• Select a date range for when you loaded the EIB.
• If you have inadvertently uploaded incorrect entries for a prospect (that is, you didn't use a business
process event), you cannot delete the prospect. However, you could reload the data with the corrected
information. To reload the data, you need to make certain that the input file includes the candidate id for
the prospects that you incorrectly loaded.
For reference documentation for all web services including Put Candidate, see Operation Directory.

Sample EIB Input File


Put_Candidate-WD36

Concept: Put Interview EIB

Background
You can use this EIB to submit interview data for the Schedule Interview task. The job requisition must be
in the interview step when you submit the EIB. See Steps: Manage Interviews for more information.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 396

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Candidate
Data: Interview Schedule domain in the
Recruiting functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each job application.
• Populate 1 of the 3 following groups of fields.
Don’t populate more than 1:
1. Candidate Data and Requisition
2. Job Application
3. Interview Event
• Interviewers: Most likely, you’ll need to
change the reference ID in cell K4 from
Contingent_Worker_ID to Employee_ID.
• Interview Start Time and Interview End
Time: Use the format YYYY-MM-DD-
HH:MM:SS. Example: 2022-01-20T09:00:00.
• Interview Location: To find reference ID
values, run the View Reference IDs report
and select the Location business object.
• Interview Type: To find reference ID values,
run the View Reference IDs report and
select the Interview Type business object.
• Time Zone: To find list of reference ID
values, run the Integration IDs report and
select the Time Zone business object.

Common Issues and Errors

Issue Cause and Solution

EIB issues 1 or both of these errors: This issue will occur if:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 397

Issue Cause and Solution


• The Interview Event must be In Progress to • The person running the EIB doesn't have the
create an Interview Team. permission to schedule the interview.
• You aren't authorized to schedule an interview • Or if the job application isn’t at the Schedule
for this candidate and job requisition because Interview Step.
the interview event isn't awaiting your action.
To resolve this issue, you can:
• Confirm that the Schedule Interview step is
awaiting action.
• Confirm that the person who’s running the EIB
is in a security group permitted to schedule
interviews. Consider creating a Service Center
Representative and adding them to Schedule
Interview step. Then, run the EIB as the Service
Center Representative.

EIB issues an error like: This issue occurs if you're populating the EIB input
file with an employee ID, but the reference ID type
Validation error occurred. Invalid ID value.
is Contingent_Worker_ID.
'21105' is not a valid ID value for type =
'Contingent_Worker_ID'. Change the reference ID in cell K4 from
Contingent_Worker_ID to Employee_ID.

EIB issues an error like: The date/time format needs to be: YYYY-MM-
DDThh:mm:ss.
Validation error occurred. Invalid format for date
text=2022-01-19T9:00:00 on attr Interview Start In this example, the error occurred because the
Time. time is 9:00:00 instead of 09:00:00.

EIB issues an error like: This issue will occur if you're overpopulating the
information for the job application. Make certain
Validation error occurred. Multiple Element
you’re populating only 1 of these fields:
Contents, including Interview Data/ac/Move
Candidate Criteria [EL], contain data where only • Interview Event
one is allowed by mutex Interview Data. • Job Application
• Candidate and Requisition

EIB issues an error like: To include questionnaires on the interview, you


need GET permission to Questionnaire Creation
The entered information does not meet
and Distribution policy.
the restrictions defined for this field.
(Interview_Questionnaires_Reference).

Unable to launch the EIB. This issue is most likely security-related. See the
EIB Input File Guidelines section.

Business Processes
Interview subprocess of the Job Application Event.

Use Cases and Guidelines for Recovering from a Bad Load


If you inadvertently loaded incorrect data, consider using the Move Candidate EIB to move candidates
forward to a step that schedules another interview, if that is available in your Job Application Event.
For reference documentation for all web services including Put Interview, see Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 398

Sample EIB Input File


Put_Interview-v38

Concept: Unpost Job EIB

Background
You can use this EIB to unpost jobs.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Unpost Job.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Unpost Job
business process in the Recruiting functional
area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• When populating the EIB input file, you should
use one of the 2 combinations below. Note
that if you populate more than what the EIB
requires, the EIB issues an error because it
detects redundant data:
• Combination 1: Populate just the
Spreadsheet Key and Job Posting.
• Combination 2: Populate the Spreadsheet
Key, Job Requisition, and then either Job
Posting Site Name or Job Posting Site.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 399

Common Issues and Errors

Issue Cause and Solution

The EIB fails with this error: This issue typically occurs if you’re overpopulating
fields within the EIB input file. You need to
Validation error occurred. Multiple Element
populate a specific combination of fields. See
Contents, including Unpost Job Business Process
Additional Input File Guidelines section for the field
Data/a2/Job Posting Reference Data [EL], contain
combination.
data where only one is allowed by mutex Unpost
Job Business Process Data.

Business Processes
Update Job Posting.

Use Cases and Guidelines for Recovering from a Bad Load


If you have inadvertently unposted the wrong jobs, use task Mass Cancel Business Processes (or Mass
Rescind Business Processes if the business process event completed). You can then select Business
Processes Loaded by EIB to find the integration event that you wish to cancel or rescind. Or the other
option is to enter Update Job Posting at the Business Process Types prompt.
For reference documentation for all web services including Unpost Job, see Operation Directory.

Sample EIB Input File


Unpost_Job-WD31

Resource Management EIBs


Concept: Import Supplier Invoice EIB

Background
You can use this EIB to add or update supplier invoices with a large number of lines. Example: Invoices
with 300 lines or more. If you want to load invoices with fewer lines, consider using the Submit Supplier
Invoice EIB.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Supplier Invoice.
There are additional integrations and EIBs related to supplier invoices. Consider these options as you
determine what works best for you:
• Submit Supplier Invoice: You can use this EIB to load many invoices with a small number of lines.
Example: 1000 supplier invoices with 5 lines each. If you try to use this EIB to load a supplier invoice
with more than 5000 lines, the EIB will fail.
• Supplier Network Connector – Procurement Punchout Purchase Order and Invoicing: You can use this
integration template to manage supplier invoices. See Steps: Set Up Supplier Invoicing Integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 400

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Supplier Invoice
Event business process type in the Supplier
Accounts functional area to run this EIB.

Guidelines for Adding Worktags to the EIB You can specify more than 1 worktag for any of the
Template student charges.
From the related actions of your EIB, select
Template Model > View..
1. On the left, click the second occurrence of All
for Invoice Line Replacement Data. On the right,
locate Worktags.
2. From the related actions on the magnifying
glass next to Worktags, select Template Model
Column > Maintain Additional Columns.
3. Enter all worktags that you need to assign to the
template.
4. (Optional): Modify the template to use a
Separate Type Column option for both the
Purchase Order Line and the Supplier
Contract Line.
5. Regenerate the spreadsheet template and
add newly added worktags to the spreadsheet
template.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• This EIB doesn’t have a generate with data
option. However, the Submit Supplier Invoice
EIB does have the generate with data option.
If you’re encountering issues with populating
the EIB template, you can test with the Submit
Supplier Invoice EIB to get a better idea of how
to populate the EIB input file.
• If you’re updating existing supplier invoices, you
must include all existing lines; this web service

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 401

will first delete all the existing lines and then


recreate everything using fields in the EIB input
file.
• Import Supplier Invoice worksheet in the EIB
Input File. As you populate this worksheet,
consider:
• Header Key: Specify a unique value for each
Supplier Invoice.
• Supplier Invoice ID (column H): Populate
this field if updating an existing supplier
invoice or if you want to assign your own
supplier invoice ID.
• Auto Complete: Set to Y to bypass all
approval steps, review steps and to do steps.
This selection also suppresses notifications.
• Invoice Number (column K): Populate this
field if updating an existing supplier invoice
or if you want to assign your own supplier
invoice ID.
• Submit: Set to Y to submit the Invoice. If set
to N, it will stay in draft status.
• Locked in Workday: If set to Y, you can
make modifications to the invoice only by the
EIB or web service.
• Company: Workday requires this field. To
find the value, you can use the reference
IDs report and search for business object
Company.
• Supplier ID and Contingent Worker fields:
Supply a value for either Supplier ID -or-
Contingent Worker. But don’t populate a
value for both fields.
• Ship-To Address: As of v35.0, Workday
populates the header ship-to-address from
the company you provide.
• Supplier Contract: Enter supplier contract ID
if you’re referencing a contract.
• Attachment Data: Although you can
add or update attachments using this
EIB, there are some challenges in loading
document content by EIB. If you need to add
attachments using an integration, refer to the
EIB Input File Guidelines section in Concept:
Import Supplier Invoice EIB. Although it’s a
different web service, the same information
applies to Import Supplier Invoice regarding
populating attachments. You can also use the
Put Procurement Document Attachment web
service to add attachments.
• Taxes: The EIB populates header
information (including tax information onto
taxable documents). If you don't want the tax

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 402

fields to populate, you need to explicitly enter


{empty} in the field.
• Invoice Line Replacement Data worksheet
in the EIB Input File. As you populate this
worksheet, consider:
• Header Key: Use same header key
value specified in the Import Supplier Invoice
worksheet for this invoice
• Line Key: Enter a unique value for each line
item for a given invoice.
• Purchase Order Line: If you’re referencing a
purchase order, be sure to:
• Modify the template to use a Separate
Type Column option for the Purchase
Order Line.
• Update the EIB input file and change
the reference ID type for the Parent ID
Value to Document_ Number (cell L4 in
the attached sample file). See the sample
input file, which demonstrates how to
populate the PO number and line in the
Purchase Order Line section (starting in
column I in the example).
• (Optional): Modify the template to use a
Separate Type Column option for both the
Purchase Order Line and the Supplier
Contract Line.
• (Optional): Modify the template to use a
Separate Type Column option for both the
Purchase Order Line and the Supplier
Contract Line.
• Supplier Contract Line: If you’re referencing
a contract line, be sure to:
• Modify the template to use a Separate
Type Column option for the Supplier
Contract Line.
• Update the EIB input file and change the
reference ID type for the Parent ID Value
to Supplier_Contract_ID (cell P4 in the
attached sample file). See the sample
input file, which demonstrates how to
populate the Contract number and line
in the Supplier Contract Line (starting in
column M in the example).
• Worktags: If you’re using multiple worktags,
be sure to follow the instructions in Step #2
above to add all relevant worktag columns
to the EIB template. Also, note that there’s
no need to populate the related worktags
as they’ll automatically populate. If needed,
you can configure worktag type precedence.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 403

See Configure Worktag Defaulting for more


details.
• External Supplier Invoice Source:
Originating system of the supplier contract.
Populate this field only if using the Supplier
Contract ID External field on the spreadsheet
to reference a supplier contract.
• Invoice Split Line Item Data: If you need
to specify details for split lines, enter this
data in the Supplier Invoice Split Line
Data section, which starts in column BP
in the attached sample input file. If you’re
referencing a PO that has split items, the
EIB automatically brings this information into
the invoice and doesn’t need populating in
the EIB input file, unless you wish to change
it to be different than the PO.

Common Issues and Errors

Issue Cause and Solution

The EIB issues this error: Make certain that your EIB is using v34.0 or higher.
This version of the web service started supporting
The total extended amount of all lines must be
$0 amounts. Create a new EIB to ensure you're on
greater than zero.
the latest web service version.

Performance is slow. Below are items to check:


• A high number of custom validations can
degrade performance.
• Evaluate which web service to use: if most
of the invoices have very few line items, use
Submit Supplier Invoice. But if the invoices
have a larger number of line items, test using
Import Supplier Invoice instead.

The EIB issues errors such as Check the business process security policy for
Supplier Invoice Event and make certain you
Task submitted isn’t authorized.
have access to Initiating Action Import Supplier
-or- Invoice (WS Background Process). If you’re loading
supplier invoices across all organizations, you
The entered information doesn’t meet
should have unconstrained access to the business
the restrictions defined for this field.
process security policy.
(Supplier_Reference)

When attempting to attach the EIB input file, you The size of the EIB input file, for supplier
receive an error like this: invoices, can be quite large due to the amount
of data associated with each supplier invoice.
The size of the file 'xxxx' is greater than the
Unfortunately, there isn’t a way to increase the file
maximum permitted file size (30,720KB). Please
limitations when attaching EIB input files. But below
select a different file or reduce the size of this file.
are a couple suggestions that might help.
• If you have an SFTP server, you can load your
EIB input file to the SFTP site, and then
configure your EIB with a retrieval step that pulls

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 404

Issue Cause and Solution


the file from the SFTP site. Do this task instead
of manually attaching the file from your browser
and you can load a file up to 1 gig.
• If you’re using an XML input file, consider
switching to XLSX format as the file size will be
smaller.

The EIB doesn't populate the Withholding Tax In general, the web service doesn’t populate values
Code on the invoice line in these situations: because we don't know if the value should be blank
or populated. However, for this field, you can use
• When the invoice header level contains Default
the feature Withholding Tax Rule for Country. When
Withholding Tax Code.
configuring this rule, the user interface and web
• When the Supplier has a default Withholding service will populate the value to the line.
Tax Code.

When loading load invoices with split lines, the EIB This issue occurs if the EIB doesn't populate the
completes successfully however doesn’t liquidate Line Split Allocation value in the Supplier Invoice
the PO. Split Line Data section.
When the EIB doesn't populate the value, the web
service is unable to match the split information
against the PO line splits, and doesn’t properly
liquidate the PO.
To resolve this issue, you can:
Populate Workday ID (WID) of PO line splits in
theLine Split Allocation field of the EIB input file.
• Or, if none of the line split information is
changing, you can remove all the data from the
Supplier Invoice Split Line Data section.

When using the EIB to update an existing invoice When updating an existing invoice, the EIB will
and add new lines, it removes any existing lines. remove all the existing lines and then add the lines
from the EIB input file. So you must include all lines
in the EIB input file.

I can’t find a hold removal option using the EIB. The web service currently doesn’t support this
functionality.

Business Processes
Supplier Invoice Event.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new supplier invoices or update existing supplier invoices. You
can’t delete or rescind supplier invoices.
• If you’ve inadvertently uploaded an incorrect supplier invoice, check if one of these options will work for
your situation:
• Rerun the EIB and update the invoices with correct information.
• Use the Cancel Supplier Invoice EIB.
For reference documentation for all web services including Import Supplier Invoice, see Operation
Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 405

Sample EIB Input File


Import_Supplier_Invoice-v39

Concept: Put Assign Supplier to Contingent Worker EIB

Background
You can use this EIB to assign suppliers to contingent workers. You can make new assignments or update
existing assignments.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Assign Supplier to Contingent Worker.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Set Up: Assign
Contingent Worker domain in the Suppliers
functional area.

Guidelines for Modifying the EIB Template Prepare the EIB to generate with data.
1. From the related actions of your EIB, select
Template Model > View.
2. On the left, click Contingent Worker Data.
3. Click Edit Template Model Area.
4. Modify the Reference ID Type to Supplier ID for
the Supplier Row.
5. Click OK.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
External Disability Self Identification Record EIB.
See: Example: Generate EIB Spreadsheet
Template with Data on page 62.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 406

• As you populate the EIB input file, consider:


• Spreadsheet Key: (Required): Specify a
unique value for each Contingent Worker
• Contingent Worker ID: (Required): Enter
the contingent worker’s id. To find the values,
you could create a custom report using
a report data source such as Indexed All
Workers.
• Contingent Worker: (Optional): Contingent
Worker’s Name. This field is informational
only.
• Supplier: (Required): Most likely, you'll
want to set cell E4 to value Supplier_ID, if
it doesn’t already have this value. To get
a list of supplier id's, you can run the Find
Suppliers report.

Common Issues and Errors

Issue Cause and Solution

EIB issues an error like this: Verify that the Supplier ID value is present in
your EIB input file (you can’t remove a supplier
Validation error occurred. Element Content
assignment by leaving this field empty or by using
'Supplier_Reference' is required, on internal
the {empty} value).
element 'Contingent Workers Data'

EIB issues an error like this: The supplier ID reference id type defaults
toScout_ID. To modify it, you can:
Validation error occurred. Invalid ID value. 'S-0016'
is not a valid ID value for type = 'Scout_ID' 1. Edit the EIB Input File
2. Change the value in cell E4 from Scout_ID to
Supplier_ID

Unable to launch the EIB This issue is most likely security-related. When
running report View Security for Securable Item for
securable item Put Assign Supplier to Contingent
Worker (Web Service), you’ll see that you need
access to Set Up: Assign Contingent Worker. To
change the security:
1. Edit the domain security policy for Set Up:
Assign Contingent Worker
2. Make certain you havePut access (ideally you
should have access through an unconstrained
security group so that you can assign suppliers
to any contingent worker.)
3. Activate the security change

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add supplier assignments or update existing assignments. You can’t
remove existing assignments.
• Since this EIB doesn’t use a business process, there’s no option to rescind or cancel. If you have
inadvertently uploaded incorrect entries, reload the EIB with the correct supplier assignments

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 407

For reference documentation for all web services including Put Assign Supplier to Contingent Worker, see
Operation Directory.

Sample EIB Input File


Put_Assign_Supplier_to_Contingent_Worker-WD35_0

Concept: Put Expense Company Default EIB

Background
You can use this EIB to add or update a default company on expense reports.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Edit Expense Company Defaults.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Set Up:
Expenses Processing domain in the
Expenses functional area to run this EIB.

Guidelines for Modifying the EIB Template Prepare the EIB to generate with data.
1. From the related actions of your EIB, select
Template Model > View.
2. On the left, click Expense Company Default
Data.
3. Click Edit Template Model Area.
4. Select the Separate Type Column check box
for the Worker row.
5. Click OK.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 408

• To prevent data loss, we recommend that you


generate your spreadsheet with data for the Put
Expense Company Default EIB. See: Example:
Generate EIB Spreadsheet Template with Data
on page 62.
• As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each company
• Company: To find the reference id value for
the company, run the View Reference IDs
report and select business object Company.
• Worker: Depending on whether you modified
the EIB template, you might have just 1
column for worker or 2 columns.
• If there’s just 1 column, then populate
cell D4 with either Employee_ID or
Contingent_Worker_ID (depending on
type of worker) and populate the worker id
values accordingly
• If there are 2 columns, then populate
the ID type column (Column D) with the
type of worker. Example: Employee_ID
or Contingent_Worker_ID. Then populate
the ID value column (Column E) with the
worker’s id value

Common Issues and Errors

Issue Cause and Solution

Even though I populated the EIB with multiple This issue will occur if you use a different
workers, only 1 worker is updated spreadsheet key value for each assignment. To
resolve this issue, edit the EIB input file and set the
Spreadsheet Key field to the same value for all the
workers for a given company

The EIB loads all the workers, however the This EIB removes all existing assignments for a
previously assigned workers no longer display. given company. So you must include both new
and existing assignments in the EIB input file each
time you load data for a given company. Use the
generate with data option to prepopulate the EIB
input file with existing assignments.

The EIB issues these errors: This issue can occur if you modify your template
but don't select the Separate Type Column check
A processing fault occurred generating the
box for the Worker row.
spreadsheet.
Ensure you select the check box if you modify your
The worksheet 'Expense Company Default' has
template.
3 columns but should have 4 columns. Choose
Template Model->Generate Default Template
Model from related action of the EIB to create a
new spreadsheet template. Then re-populate the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 409

Issue Cause and Solution


input data using the newly generated spreadsheet
template.

Unable to launch the EIB This issue is most likely security-related.

Use Cases and Guidelines for Recovering from a Bad Load


• Each time you want to add or remove entries, you can do so by reloading all the workers who you want
assigned to the company.
• Since this EIB doesn’t use a business process, there’s no option to rescind or cancel. If you
inadvertently upload incorrect entries, we suggest you reload the correct entries through the EIB. If you
need to restore the original values, you can:
• Find another tenant such as a sandbox or an implementation tenant that still has the correct
information.
• Then use Generate Spreadsheet with Data option in that tenant to build an EIB input file to load into
the tenant that has incorrect information.
For reference documentation for all web services including Put Expense Company Default, see Operation
Directory.

Sample EIB Input File


Put_Expense_Company_Default-WD35

Concept: Put Purchase Item EIB

Background
You can use this EIB to add or update purchase items (goods and services that you've purchased from
suppliers).
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Purchase Item
• Edit Purchase Item
You can also mass update purchase items using worksheets. See Reference: Mass Maintain and Request
Purchase Items with Worksheets for more information.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 410

EIB Input File Guidelines

Web Service Version and Security • Workday recommends using the latest web
Configuration Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Set Up:
Purchase Item domain in the Procurement
functional area to run this EIB

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• This web service doesn’t support incremental
updates. Therefore, when updating purchase
items, you need to populate all existing
information in the EIB input file to avoid the web
service removing the data. If you’re updating
existing purchase items, we strongly recommend
that you use the Generate Spreadsheet with
Data option to avoid losing information.
• As you populate the EIB input file, consider:
• Updating Existing Purchase Items:
This EIB doesn’t fully support incremental
updates. So if you’re updating existing
purchase items, we recommend you use the
Generate With Data option to prevent loss of
existing purchase item data.
• Creating New Purchase Items: If creating
new purchase items, you might find it helpful
to manually create a purchase item like
the ones you want to load. Then use the
Generate Spreadsheet with Data option to
determine how to populate the EIB input file.
• Images: Although you can add images using
this EIB, we don't recommended it as there
are some challenges in loading document
content through EIB. If you need to add
images through an integration, you might
find it helpful to refer to the Populating File
Attachments for the EIB section in Future:
Concept: Put Worker Document EIB . This
is a different web service, but the same

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 411

information applies to Put Purchase Item in


regard to populating attachments.
• Worktags: If using worktags, see the EIB
Input File Guidelines section for tips on
changing the template.

Common Issues and Errors

Issue Cause and Solution

EIB issues an error like this when Generating This issue can occur if you’re generating data for
Spreadsheet with Data: purchase items with images. To avoid this error,
hide the images. See the EIB Input File Guidelines
Response Message.
section.
Integration Failed.
com.capeclear.mediation.MediationException:
application=assemblyGenerateSpreadsheetE2
- Custom step ID=GenerateWhenSplit,
ref=SpreadsheetGenerationBean_EIBWXF - Error
while invoking bean, reason: One or more of the
columns in your template model includes file-
based (base64) data that will be cut off due to a
spreadsheet cell limit of 32,767. To fix this, go to
the template model and hide the related file-based
data columns. Root Cause: java.lang.Exception:
One or more of the columns in your template model
includes file-based (base64) data that will be cut off
due to a spreadsheet cell limit of 32,767. To fix this,
go to the template model and hide the related file-
based data columns. See the consolidated report
for further details.

After using the EIB to update existing purchase This EIB doesn't fully support incremental updates.
items, some information is missing such as Therefore, if you update existing purchase items
commodity code and supplier information and don’t include the existing information in the EIB
input file, you might lose data. If you lost data in
Production, to recover:
1. Find a nonproduction tenant that still has the
data.
2. Generate with data in the nonproduction tenant.
3. Then load the file to Production.

After loading purchase items, they display in the There’s an indexing job that runs periodically to
Find Purchase Item report but not in search make the purchase items searchable. Wait 4 hours
catalog when creating a requisition. and check again.

Unable to launch the EIB This issue is most likely security-related. See the
EIB Input File Guidelines section.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new purchase items or update existing purchase items. You can't
delete purchase items.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 412

• Since this EIB doesn’t use a business process, there’s no option to rescind or cancel. If you've
inadvertently uploaded incorrect entries, you can either:
• Rerun the EIB to update the purchase item with correct information
• Or rerun the EIB and update the purchase items with Inactive flag enabled. You could also add DNU
to the beginning of the purchase item name.
• If you need to restore the original values, 1 option would be to find another tenant such as a Sandbox or
an implementation tenant, that still has the correct information. Then use Generate Spreadsheet with
Data in that tenant to build an EIB input file to load into the tenant where information needs corrected.
For reference documentation for all web services including Put Purchase Item, see Operation Directory.

Sample EIB Input File


Put_Purchase_Item-v39

Concept: Submit Requisition EIB

Background
You can use this EIB to add or update procurement requisitions.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
For job requisitions, consider using either a Create Job Requisition or an Edit Job Requisition EIB.

Equivalent Workday Task


Task: Create Requisition.
You can also perform mass procurement requisition changes through:
• Mass Cancel Procurement Documents
• Mass Close Procurement Documents
• Mass Reopen Procurement Documents

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Submit
Requisition business process in the
Procurement functional area to run this EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 413

Guidelines for Adding Worktags to the EIB If you're populating more than 1 worktag for the
Template requisition goods lines or service lines, then add
extra worktags to the template.
• From the related actions of your EIB, select
Template Model > View.
• On the left click Item Request Line Data+.
• On the right, locate Worktags+.
• From the related actions on the magnifying glass
next to Worktags+, select Template Model
Column > Maintain Additional Columns.
• Enter all worktags that you need to assign to the
template.
• Click OK.
• (Optional): If you wish to add worktags to
Service Lines, select Service Request Line
Data+ in the left panel and follow the same
steps.
• Regenerate the spreadsheet template.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• A you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each requisition.
• Requisition: Populate this field if updating
existing requisition. Change cell D4 to
Requisition_Number. If updating an existing
requisition, include all existing lines and other
information to prevent it from removal.
• Auto Complete: Set to Y to automatically
complete approvals, reviews, and To Do
steps in business process and to suppress
notifications
• Worker: If populating this field, most likely,
you’ll want to change the reference ID type,
in cell H4, from Contingent_Worker_ID to
Employee_ID.
• Submit: Set to Y to submit business process.
If set to N, the requisition loads in Draft
Status
• Requisition Type: You can find the
reference ID values by running the View
Reference IDs report for business object
Requisition Type.
• Ship-To Address: Change the reference
ID type (on or near cell W4), from IID to
WID. You can use a custom report to get the
Workday ID (WID) of the Ship-To Address.
The custom report that you use will depend

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 414

on whether you want a location address or


company address.
• Item Request Line Data+ Section: This
section starts at around column AU (column
location might vary based on web service
version you’re using and any customizations):
Enter the goods lines in this section. Enter a
unique row ID for each goods line.
• Service Request Line Data+ Section: This
section starts at around column DN (column
location might vary based on web service
version you’re using and any customizations):
Enter the service lines in this section. Enter a
unique row ID for each service line.
• Worktags both the goods lines and service
lines, have a section where you can populate
worktags. If you wish to populate 2 or more
worktags in the EIB input file to add extra
worktags to the EIB input file, follow the steps
in Guidelines for Adding Worktags to the EIB
Template section. Workday automatically
assigns worktags to the requisition and it isn’t
necessary to populate them in the EIB input
file.

Common Issues and Errors

Issue Cause and Solution

EIB issues an error like this: This issue occurs if the Ship-To Address field is
using reference ID type IID instead of WID. Change
Validation error occurred. Instance ID cannot be
the reference ID type in cell W4 to WID.
parsed.

Unable to launch the EIB This issue is most likely security-related. Follow
the steps in Web Service Version and Security
Configuration Guidelines section.

Business Processes
Requisition Event.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new requisitions or update existing requisitions that are still in
progress. You can’t delete, close, or cancel requisitions through this web service.
• Although this web service uses a business process, there’s no option to cancel or rescind. So if you’ve
inadvertently uploaded incorrect entries, consider using the Cancel Requisition web service to back
out the requisitions if they’re still in progress. Or run 1 of these tasks:
• Mass Cancel Procurement Documents
• Mass Close Procurement Documents
• Mass Reopen Procurement Documents
For documentation for all web services including Submit Requisition, see Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 415

Sample EIB Input File


Submit_Requisition-WD37

Concept: Submit Supplier Contact Information EIB

Background
You can use this EIB to create or update supplier contact information. The supplier must be in an Approved
state.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Any information that you submit with this EIB replaces and overwrites the information currently in Workday.
To avoid data loss, include all existing supplier contact information and any new supplier contact
information that you want to add in your EIB input file.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Change Supplier Contact Information.
• On the supplier in Workday, select Overview > Contact and edit the contact details.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Submit Supplier
Contact Information business process in the
Suppliers functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• As you populate the EIB input file, consider:
• If you're updating or removing any contact
information, you might find it helpful to create
a custom report, using a data source such
as Suppliers to help you populate the EIB

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 416

input file. Refer to end of this document for an


example of a custom report you could create.
• If you need to remove entries (such as
remove a phone number or remove an email
address), there are 2 approaches you can
use. There are also examples in the attached
input file. Be sure to test in a nonproduction
tenant to verify you're not inadvertently
removing any contact information that you
intended to keep:
• If you want to remove an entry and don't
want to replace it with another entry,
then set the Do Not Replace All flag to
‘Y’, set the delete flag to Y, and specify
the reference id for the item you wish to
remove.
• If you want to remove all the entries
(Example: all entries for email) and
replace with another entry, set Do Not
Replace All flag to ‘N’. (No need to
populate reference id of items you wish to
delete, for this scenario).
• If adding or updating phone numbers, note:
• Country_Code: Workday requires this
field. You can get a list of country codes
by running the Integration ids report and
searching for business object Country
Phone Code.
• Complete Phone Number: If you’ve
configured phone validations (in edit
tenant setup – global), then this field
should contain numbers only. Also, don’t
include the country code

Common Issues and Errors

Issue Cause and Solution

There’s no option to launch the integration This issue will occur if you’ve not yet created the
business process and if you don’t have the proper
access to the Supplier Contact Info Change
Event business process security policy. To resolve:
• Check if the business process exists. If not, use
Create Business Process Definition to create
it.
• Check the business process security policy
and make certain you have access to Initiating
Action Submit Supplier Contact Information
(Web Service)
• Activate the change.

Can’t delete Primary Address / Email Address / You can’t delete using Web Service a Primary
Phone Address / Email Address / Phone as it is Required

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 417

Issue Cause and Solution


to have a Primary Address / Email Address /
Phone. However, you can update the instance by:
• Referencing the Primary Address / Email
Address / Phone.
• Setting Do Not Replace All flag as True.
• Populating the items that you wish to update.

Receive this error when attempting to delete an 1. Don't specify existing email address. It isn't
email: needed when deleting an email.
E1: Email Reference is required when you delete 2. Be sure to specify the email_id you wish to
an email address. delete.
Refer to the example in the attached input file that
displays how to remove an email address

Receive this error when attempting to delete an At the moment, this Web Service doesn't support
address: deleting addresses.
Validation error occurred. Address deletion is not
supported in this web service request.

Business Processes
Supplier Contact Info Change Event.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add, update, or delete existing entries.
Although Workday uses a business process to add/update/delete the supplier contact information, there
isn't an option to cancel or rescind the event. If you've inadvertently uploaded incorrect entries, you would
need to reload the entries with the corrected information.
For reference documentation for all web services including Submit Supplier Contact Information, see
Operation Directory.

Sample EIB Input File


Submit_Supplier_Contact_Information-v39

Concept: Submit Supplier EIB

Background
You can use this EIB to add or update a supplier.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Workday provides 2 web service operations:
• Submit Supplier supports operations for up to 1,000 suppliers.
• Bulk Import Submit Supplier supports operations for more than 1,000 suppliers. Bulk Import Submit
Supplier doesn’t support the Generate Spreadsheet With Data option. If you want to use Bulk Import
Submit Supplier, but you aren’t certain how to populate the fields, use Submit Supplier first. Then, copy
generated data into your EIB Input file for Bulk Import Submit Supplier.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 418

Before loading a large volume of suppliers, test EIBs based on both web service operations in a
nonproduction tenant to determine what performs best for your data.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Supplier: You can use this task to create a new supplier.
• Find Suppliers: You can use this task to update an existing supplier. On the related actions of the
supplier, select Supplier > Create Supplier Change.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Submit Supplier
business process in the Suppliers functional
area to run this EIB.
• In addition, if you wish to use the Generate
Spreadsheet with Data option, you’ll need
access to the Reports: Supplier domain in
the Suppliers functional area.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
External Disability Self Identification Record EIB.
See: Example: Generate EIB Spreadsheet
Template with Data on page 62.
• When updating existing suppliers, best practice
is to populate the EIB input file with all existing
field values.
• If you’re updating existing suppliers, then you
can use the Generate Spreadsheet with Data

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 419

option to help you populate the EIB input file. But


in addition, below are a couple other tips:
• You could also create a custom report using
a report data source such as Suppliers.
• Copy the standard report Find Suppliers then
modify and add or remove fields to suit your
needs.
• After loading the data, you might find it helpful
to run the Supplier Change History report and
spot check the changes for a few suppliers to
verify that the data loaded as expected. This
report is secured by domain security policy
Supplier Change History.
As you populate the EIB input file, consider:
• Spreadsheet Key : Specify a unique value for
each Supplier.
• Auto Complete: Set to Y if you want to bypass
all approvals, reviews, to-dos, and notifications.
• Supplier and Supplier ID: If you’re updating
an existing supplier, populate these columns
(Column D and Column H) with the supplier ID.
(The Find Suppliers report lists the Supplier ID
values).
• Supplier Name (required): Specify the supplier
name. Note that the value in this field must
match the value in the Business Entity Name
field.
• Restricted to Companies: If you've selected to
restrict Supplier to certain companies, list each
company on a separate line.
• Submit: Set to Y if you want to automatically
submit the supplier event. If you set it to N, it will
remain in Draft status.
• Supplier Category (required): Enter the
reference ID for the supplier category. To find
valid IDs, you can run the View Reference ID
report and search for business object Supplier
Category.
• Payment Types Accepted (required): Enter
the reference ID for the payment type. If there
are multiple payment types that apply, enter
each payment type on a separate line. To find
the reference ID values, you can run the View
Reference ID report and search for business
object Payment Type.
• Default Payment Type (required): Enter the
reference ID for the payment type. To find the
reference ID values, you can run the View
Reference ID report and search for business
object Payment Type.
• Business Entity Name (required): Specify the
supplier name. Note that the value in this field

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 420

must match the value in the Supplier Name


field.
• Status: If you wish to inactivate the Supplier,
enter INACTIVE here.
• Worktags: Worktag information can be a bit
tricky to populate. If you need to make mass
changes to the supplier worktags, you can:
• From the related actions of your EIB, select
Template Model > View.
• On left panel, edit sections Related Worktags
by Type Data and Allowed Worktag Data.
• In the right section, locate the worktag and
select Separate Type Column.
• Save your changes.
• Manually add the worktags to 1 supplier
• Use the Generate Spreadsheet with
Data option for the above supplier and it will
display how to populate the worktags in the
EIB input file.

Common Issues and Errors

Issue Cause and Solution

When updating an existing supplier, you can There’s a validation process in this web service that
receive one or more of the errors below: requires certain fields to be populated (even if you
aren’t updating these fields). See Additional Input
• Element Content 'Supplier_Name' is required,
File Guidelines section for the required fields. Also,
on internal element 'Supplier Data'
the best practice is to always populate all existing
• Business Entity Data is required. field values when updating through a web service.
• Default Payment Type Reference is required. If you choose not to do this, then make certain no
• Payment Types Accepted Reference is required. existing Supplier fields are removed after running
• Supplier Category Reference is required. the EIB.
• Supplier Name must match Business Entity
Name

When updating an existing supplier, you receive Update the EIB input file and set the Do Not
one or more of the errors below: Replace All fields to Y.
• When Do Not Replace All is False for all phone
elements, you can't pass a Phone Reference.
• When Do Not Replace All is False for all email
elements, you can't pass an Email Reference.
• When Do Not Replace All is False for all Instant
Messenger elements, you can't pass an Instant
Messenger Reference.
• When Do Not Replace All is False for all web
address elements, you can't pass a Web
Address Reference.

When updating existing suppliers, the web service Before v37.0, this web service didn’t support
wipes out some of the existing fields such as 1099 incremental updates for some fields. Make certain
status, default spend category and other fields you’re using v37.0 or higher to take advantage of
incremental updates. Refer to Web Service Version

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 421

Issue Cause and Solution


and Security Configuration Guidelines section for
instructions on how to check your EIB's version.

EIB issues this error: This issue occurs if you populate the same TAX ID
in both Tax_ID_Text and Business_Entity_Tax_ID
Business Entity Tax ID cannot be used as tax ID for
fields in the EIB input file. To resolve, test by
Supplier.
removing the ID from Business_Entity_Tax_ID.
Verify that this eliminates the error and that the
information properly loads.

I’m not able to change the value for the Supplier You can’t change the supplier reference ID using
Reference ID. this EIB. However, you can do this using the Put
Reference EIB.

When running the Generate Spreadsheet with Data This issue is a security-related error. Note that
option, Workday doesn't create a spreadsheet Get Suppliers web service is used to generate
template. the template with data. Therefore, you must have
access to this web service. To resolve this issue,
And if I check the background process that created
make certain that you have get access to domain
the template, it displays an error that includes the
security policy Reports: Supplier.
message Task Submitted is not Authorized.

Even though I set the Auto Complete and Submit This issue can occur if you have configured custom
fields to Y in my EIB input file, the Suppliers validations and the suppliers that you’re updating
that I uploaded weren’t submitted and are still in are failing to pass the validation check. To address
progress. this issue:
1. Use EIB Cancel Pending Supplier Change to
undo the updates that you loaded.
2. Review the custom validations and either modify
them or temporarily disable them.
3. Resubmit the EIB.

EIB issues this error when adding a secondary This issue will occur if adding a secondary email
email address. address but omitting the primary address from the
EIB input file.
One and only one business email address must be
marked as primary. If adding a secondary email address, you must also
populate the existing primary address. Consider
using Generate with Data option to populate
existing supplier data in the EIB input file.

When submitting the EIB, the default value The Tax Applicability relies on a value being
configured for the Tax Applicability, doesn’t get submitted for the Ship-To Address.
populated. However when processing the same
Include Ship-To Address in the EIB input file, for the
in the User Interface (UI) the default works as
tax applicability to properly populate.
expected.

I’m unable to launch the EIB In the Supplier Event business process security
policy, add access to the initiating action Submit
Supplier (Web Service).

Business Processes
This EIB uses 2 different business processes depending on the scenario:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 422

• If you create new suppliers, this EIB uses the Supplier Event business process.
• If you update existing suppliers, this EIB uses the Supplier Change Event business process.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new Suppliers or update existing Suppliers. You can’t delete
Suppliers; however, you can use the EIB to set them to an Inactive status.
• Although this web service uses a business process, there are no cancel or rescind options. If you have
inadvertently uploaded incorrect entries, you might want to consider taking 1 of these actions:
• Run the EIB again and update the Supplier with the correct data. If existing data was overwritten and
you no longer have access to the correct values, check if they’re still available in a nonproduction
tenant such as Sandbox.
• If you inadvertently created Suppliers that you don’t want to keep, you can run the EIB again and set
them to inactive. And you might also want to add DNU to the beginning of the supplier name.
• If you uploaded Supplier changes that are still in progress, you can use EIB Cancel Pending
Supplier Change to cancel the changes and then resubmit the corrected data.
For reference documentation for all web services including Submit Supplier, see Operation Directory.

Sample EIB Input Files


Submit_Supplier-v39
Bulk_Import_Submit_Supplier-v39_0

Concept: Submit Supplier Invoice EIB

Background
You can use this EIB to add or update supplier invoices.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Supplier Invoice.
There are additional integrations and EIBs related to supplier invoices. Consider these options as you
determine what works best for you:
• Import Supplier Invoice: You can use this EIB to add or update supplier invoices with a large number of
lines. Example: Invoices with 300 lines or more.
• Supplier Network Connector – Procurement Punchout Purchase Order and Invoicing: You can use this
integration template to process supplier invoices. See Steps: Set Up Supplier Invoicing Integration for
more information.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday frequently updates and enhances the
Guidelines Submit Supplier Invoice web service. Workday
recommends using the latest web service

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 423

version for your EIB. You can check the version


of your EIB by:
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Submit Supplier
Invoice business process in the Supplier
Accounts functional area to run this EIB.

Guidelines for Adding Worktags to the EIB If you need to populate multiple worktags for your
Template supplier invoice, you’ll want to add additional
worktag fields to your spreadsheet for each worktag
you use.
• From the related actions of your EIB, select
Template Model > View.
• On the left, click Invoice Line Replacement
Data+. If there are 2 entries titled Invoice Line
Replacement Data+, select the second one.
If you need to add worktags for split lines, then
click Supplier Invoice Split Line Data+.
• Locate the Worktags+ label in the right pane.
• From the related actions of the magnifying glass
next to Worktags+, select Template Model
Column > Maintain Additional Columns.
• Add a row for each worktag type that you might
specify in your EIB input file. You don't need to
populate worktag values for all the worktags you
specify.
• Regenerate the spreadsheet template and add
newly added worktags to the spreadsheet.

Modify the EIB Template • From the related actions of your EIB, select
Template Model > View.
• On the left, click Invoice Line Replacement
Data+. If there are 2 entries titled Invoice Line
Replacement Data+, select the first one.
• Click Edit Template Model Area.
• Select the Separate Type Column check
box for both the Purchase Order Line and the
Supplier Contract Line. If you never reference
POs or Contracts, it's not necessary to do select
the check box. However, it does no harm to
make this change.
• (Optional): Change the Reference ID type for
the Purchase Item from Catalog Item ID to
Purchase Item ID or Supplier Item ID.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 424

• Click OK.

Configure the EIB to Generate with Data This EIB has a Generate Spreadsheet with Data
option. Use this option when you aren’t certain how
to populate the input file. To use it:
• You might find it helpful to start by manually
creating a supplier invoice like the invoices that
you plan on loading by EIB.
• From the related actions of your EIB, select
Integration IDs > View IDs.
• Copy either the Supplier_Invoice_Reference_ID
value or the WID value to the clipboard as you'll
need 1 of these values in a later step.
• From the related actions of your EIB, select
Template Model > View.
• Click Edit Template with Data Options.
• Paste in either
the Supplier_Invoice_Reference_ID value or the
WID value from the supplier invoice ID. If you
use the WID value, change the ID Type from
Supplier Invoice Reference ID to WID.
• You can regenerate the template and click the
Generate Spreadsheet with Data option. Note
that this option populates all data even derived
data. You might need to clean it up and remove
unnecessary field values before you can use it.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
To prevent data loss, we recommend that you
generate your spreadsheet with data for the Submit
Supplier Invoice EIB. See: Example: Generate EIB
Spreadsheet Template with Data on page 62.
As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each supplier invoice.
• Supplier Invoice (column D): Populate this field
if updating an existing supplier invoice or if you
want to assign your own supplier invoice id.
• Auto Complete: If set to Y, Workday skips all
approval steps, review steps and to do steps
and suppresses notifications.
• Supplier Invoice ID (column H): Populate this
field if updating an existing supplier invoice or if
you want to assign your own supplier invoice id.
• Submit: Set to Y to submit the Invoice. If set to
N, it will stay in draft status.
• Locked in Workday: If set to Y, you can make
modifications to the invoice only by the EIB or
web service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 425

• Company: Workday requires this field. To find


the value, you can use the Reference iIDs
report and search for business object Company.
• Supplier ID and Contingent Worker fields:
Supply a value for either Supplier ID -or-
Contingent Worker. But don’t populate a value
for both fields.
• Ship-To Address: As of v35.0, the header ship-
to-address populates from the company that you
provide.
• Attachment Data: Although you can add or
update attachments using this EIB, it isn’t
recommended as there are some challenges
in loading document content through EIB. You
can also use the Put Procurement Document
Attachment web service to add attachments.
• Taxes: The EIB defaults header information
(including tax information onto taxable
documents). If you don't want the tax fields to
populate, you need to explicitly enter {empty} in
the field.
• Invoice Line Item Data: The invoice line data
displays in the Invoice Line Replacement
Data section, which starts in column DH in the
attached sample input file. Below are additional
details for some of the more commonly used
fields:
• Row ID (Column DH): Enter a unique row id
value for each line item.
• Purchase Order Line: If you’re referencing
a purchase order, be sure to follow the
instructions in Modify the EIB Template
section on how to change the template to
use a separate type column for the purchase
order line. You’ll also need to update the
EIB input file and change the Reference ID
Type for the Parent ID Value to Document_
Number (cell DQ4 in the attached sample
file). Refer to the sample input file, which
displays how you populate the PO number
and line in the Purchase Order Line section
(starting in column DL in the example).
• Supplier Contract Line: If you’re referencing
a contract line, be sure to follow the
instructions in Modify the EIB Template
section on how to change the template
to use a separate type column for the
supplier contract line. You’ll also need to
update the EIB input file and change the
Reference ID Type for the Parent ID Value
to Supplier_Contract_ID (cell DU4 in the
attached sample file). Refer to the sample
input file, which displays how you populate
the Contract number and line in the Supplier

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 426

Contract Line section (starting in column DR


in the example).
• Worktags: If you’re using multiple worktags,
be sure to follow the instructions in
Guidelines for Adding Worktags to the EIB
Template section to add all relevant worktag
columns to the EIB template. Also, note that
there’s no need to populate the related tags
as they’ll automatically populate. If needed,
you can configure worktag type precedence.
See Configure Worktag Defaulting for more
details.
• External Supplier Invoice Source:
Originating system of the supplier contract.
Populate this field only if using the Supplier
Contract ID External field on the spreadsheet
to reference a supplier contract.
• Invoice Split Line Item Data: if you need
to specify details for split lines, enter this
data in the Supplier Invoice Split Line
Data section, which starts in column FX in
the attached sample input file. Note that
if you’re referencing a PO that has split
items, Workday automatically brings in this
information into the invoice, and doesn’t need
to be populated in the EIB input file, unless
you wish to change it to be different than the
PO.

Common Issues and Errors

Issue Cause and Solution

The EIB issues this error: Make certain that your EIB is using v34.0 or higher
as this version is when the web service started
The total extended amount of all lines must be
supporting $0 amounts. Create a new EIB to
greater than zero.
ensure you are on the latest web service version.

Performance is slow. • If you have a lot of custom validations, it can


degrade performance.
• Evaluate which web service to use: if most
of the invoices have very few line items, use
Submit Supplier Invoice. But if the invoices
have a larger number of line items, test using
Import Supplier Invoice instead.

The EIB issues errors such as Check the business process security policy for
Supplier Invoice Event and make certain you
Task submitted isn’t authorized
have access to Initiating Action Submit Supplier
-or- Invoice (Web Service). If you’re loading supplier
invoices across all organizations, you should have
The entered information doesn’t meet
unconstrained access to the business process
the restrictions defined for this field.
security policy.
(Supplier_Reference)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 427

Issue Cause and Solution

When attempting to attach the EIB input file, you The size of the EIB input file, for supplier
receive an error like this: invoices, can be quite large due to the amount
of data associated with each supplier invoice.
The size of the file 'xxxx' is greater than the
Unfortunately, there isn’t a way to increase the file
maximum permitted file size (30,720KB). Please
limitations when attaching EIB input files. But below
select a different file or reduce the size of this file.
are a couple suggestions that might help.
• If you have an SFTP server, 1 option would be
to load your EIB input file to the SFTP site, and
then configure your EIB with a retrieval step
that pulls the file from the SFTP site (instead of
manually attaching the file from your browser). If
you do this step, you can load a file up to 1 gig.
• If you’re using an XML input file, consider
switching to XLSX format as the file size will be
smaller.

The Withholding Tax Code isn't populated on the In general, the web service doesn’t populate
invoice line in these situations: values because we don't know if the value was
intended to be blank or defaulted. However, for
• When a Default Withholding Tax Code is
this field, you can use the Withholding Tax Rule
populated on the invoice header level.
for Country feature. When configuring this rule, the
• When the Supplier has a Default Withholding user interface and web service will populate the
Tax Code. value to the line.

When loading load invoices with split lines, the EIB This issue occurs if the Line Split Allocation value
completes successfully however doesn’t liquidate isn’t populated in the Supplier Invoice Split Line
the PO. Data section. When the value isn't populated, the
web service is unable to match the split information
against the PO line splits, and doesn’t properly
liquidate the PO.
To resolve this, you can:
• Populate Workday ID (WID) of PO line splits in
the Line Split Allocation field of the EIB input
file
• Or, if none of the line split information is
changing, then you can remove all the data from
the Supplier Invoice Split Line Data section.

When using the EIB to update an existing invoice When updating an existing invoice, the EIB will
and add new lines, it removes any existing lines. remove all the existing lines and then add the lines
from the EIB input file. So you must include all lines
in the EIB input file.

I can’t find a hold removal option using the EIB. The web service currently doesn’t support this
functionality.

Business Processes
Supplier Invoice Event.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 428

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new supplier invoices or update existing supplier invoices. You
can’t delete or rescind supplier invoices.
• If you have inadvertently uploaded incorrect supplier invoices, check if 1 of these options will work for
your situation:
• Rerun the EIB and update the invoices with correct information. (You could create a custom
report using a data source such as Supplier Invoices to help identify the supplier invoice reference
id values, and invoice numbers that need populated in the EIB input file to update the existing
invoices.)
• Use the Cancel Supplier Invoice EIB to cancel the erroneous invoices.
For reference documentation for all web services including Submit Supplier Invoice, see Operation
Directory.

Sample EIB Input File


Submit_Supplier_Invoice-v39

Staffing EIBs
Concept: Assign Organization EIB

Background
You can use this EIB to assign company, cost center, region, fund, grant, business unit, program, and
custom organizations configured for staffing usage to a staffing position.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Note: When you run this EIB, it replaces all existing organization assignments data for a worker or
position with the information that you specify in the EIB input file. We recommend using the Change
Organization Assignments EIB for your organization assignments instead.

Equivalent Workday Task


There are similar EIBs and tasks that you can use to assign organizations. Examples include:
• Change Organization Assignments: We recommend that you use this EIB to assign members to
organizations.
• On the related actions menu of a worker profile, select Organization > Change Organization
Assignments.
• Workday tasks that enable you to mass-assign organizations to workers, such as:
• Move Workers (Supervisory)
• Move Workers (by Organization)

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• This EIB replaces all existing organization assignments data for a worker or position with the
information that you specify on the sheet.
• Include all organizations that are already assigned to a worker or position, as well as any organizations
that you want to add. If you don't include the existing organization assignments, the EIB will overwrite
and replace them when you run it.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 429

Business Processes
Change Organization Assignments for Worker.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB replaces all existing organization assignments data for a worker or position with the information
that you specify in the EIB input file.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind.
For reference documentation for all web services including Assign Organization, see Operation Directory.

Sample EIB Input File


Assign_Organization-WD31

Concept: Assign Roles EIB

Background
You can use this EIB to assign roles to positions, workers, or eligible investigators. For more information
on eligible investigators, see ../../../../education-and-government/grants-management/grants-management-
role-assignments/concept--eligible-investigators.dita.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
Role assignment changes aren’t rescindable. We recommend that you exercise extreme caution and
review and finalize any role assignment changes before you submit them.

Equivalent Workday Task


See Assign Roles from the related actions menu of the worker profile.

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Academic Affiliate: You can change this to the reference ID type of the position, worker, or eligible
investigator instance that you want to assign to or remove from a role assignment. Example: To assign
a role to an eligible investigator, change Academic Affiliate to Eligible Investigator Reference ID on the
Assignees to Add+ column.
• Academic Division Configuration ID: You can change this to the reference ID type of the object on
which you want to assign the role. Example: To assign a role on an award, change Academic Division
Configuration ID to Award Reference ID on the Role Assigner column.
• Effective Date: To make the role assignment effective immediately, leave this field blank to default to
today's date. You can also specify a future date. Avoid using a date in the past; we don't recommend
backdating role assignments.
• Event Target Assignee: Specify the position or worker that you want to assign to a role.
• Remove All Role Assignments for Event Target Assignee: Removes all role assignments for
an assignee if you specify TRUE ALL - including role assignments with a future-dated effective
date. Role assignment changes aren’t rescindable. We recommend that you review and finalize any
role assignment changes before you submit them.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 430

• Update Later Dated Assignments: Workday recommends that you set this field to Y so that assignees
don’t lose their role assignments in the future. If you set it to N, Workday might drop the role assignment
if there are any future-dated assignments for the role.
• Assignees to Add+: Specify the position, worker, or eligible investigator that you want to assign a role
to.
• Remove Existing Assignees for Assignable Role on Role Assigner: You can set this to Y if you
want to remove all role assignments for a given role and organization. Role assignment changes
aren’t rescindable. We recommend that you exercise extreme caution and review and finalize any role
assignment changes before you submit them.
Select theEdit check box.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully, but you don’t see • You might have specified an older effective date
the new role assignments. in the input file. Role assignments with the most
recent effective dates take precedence and
immediately override older role assignment.
• Ensure you’ve populated the Assignees to Add
+ field.

There’s no option to launch the integration. Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Assign Roles business
process type in the Organizations and Roles
functional areas.

Performance is slow. • The Effective Date in the EIB input file might
be before today's date. Avoid backdating the
effective date.

The EIB issues these errors: Access the Maintain Assignable Roles task and
ensure that there’s a value in the Assigned by
• Assignable Role isn’t valid
Security Groups field for the role in question.
• The entered information doesn’t meet
the restrictions defined for this field
(Assignable_Role_Reference)

The EIB fails with this error: This occurs if you try to remove all role
assignments and then add them back in the same
Validation error occurred. "Role Assignees to Add"
request. If you want to remove all assignees and
can't contain existing assignee as of effective date
then add them back, submit separate requests.
specified.

The EIB partially loads roles and uses the assignee If a tenant is configured to use the assignee
location for the role assignment time zone. location for the role assignment time zone, then
Workday assumes the effective date that you
specify in the EIB input file is Pacific time. If
you then try to load multiple roles for the same
organization using separate spreadsheet key
values, they might use different effective dates/
times - which causes some roles to be immediately
outdated.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 431

Issue Cause and Solution


If you want to assign multiple positions to the same
role/organization, we recommend grouping them
together using the same spreadsheet key value so
that they all have the same effective date/time.

EIB fails with these errors when you specify This EIB currently doesn't support the
WorkdayUserName in the EIB Input File. WorkdayUserName identifier. We only support
this identifier for the Assign Roles web service, not
• E1: The provided Role Assignee is not valid as
the Assign Roles EIB.
an Event Target Role Assignee.
• E2: The entered information does not
meet the restrictions defined for this field.
(Assignees_to_Add_Reference).

Business Processes
Assign Roles.

Guidelines for Recovering from a Bad Load


You can't rescind this EIB. If you’ve uploaded incorrect entries, rerun the EIB to update the role
assignments. You can also use the Role Assignment Snapshots for Role Assignee report to help
identify role assignments you might have changed or removed.
For reference documentation for all web services including Assign Roles, see Operation Directory.

Sample EIB Input Files


Assign_Roles-v39-Example1-General
Assign_Roles-v39-Example2-Gifts
Assign_Roles-v39-Example3-Account-Certification

Concept: Change Job EIB

Background
You can use this EIB to perform a job change on an employee or contingent worker. This can include
changing worker-related information such as organization assignments, compensation changes, pay
groups and locations.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Job Change > Transfer, Promote or Change Job on the related actions menu of the worker's
profile.
For a similar EIB, consider the Import Change Job EIB. You can use the Import Change Job EIB to
load large volumes of job changes (Example: 1000 or more). If you need to load large volumes of job
changes, consider testing in your sandbox tenant to determine whether the Change Job or Import Change
Job EIB performs better for your use case.
You can also perform mass change jobs through:
• Worksheets: See Initiate Change Job in Mass Action Workbook.
• Org Studio: See Org Studio and Mass Actions.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 432

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Ensure that the steps in your Change Job business process definition in Workday align with the
information that you populate in the EIB input file. Example: If the Change Job business process has an
Assign Pay Group step, then:
• If you want to update the pay group field, populate the pay group information in the EIB input file.
• If you don't want to update the pay group field, edit the Change Job business process definition in
Workday and mark the step as optional. Then in the EIB input file, set the processing instructions
to Skip Processing for optional steps. You can also add condition rules on steps to skip them in
the business process if needed. Example: Add a condition rule where External Load = N.
• If the business process definition doesn't align with the EIB input file, then the EIB might fail to complete
or load with incomplete information.
• If you populate a subprocess in the EIB input file, ensure that the Change Job business process
definition in Workday has a step for that subprocess.
• Example: If you’re populate role assignments in the EIB input file, ensure that the Change Job
business process definition in Workday has an Assign Roles step.
• The Reason field in the EIB input file is required. As you populate the Reason field, consider:
• Specify the reference id type as Change_Job_Subcategory_ID on row 4 in the input file.
• You can find a list of reference ID values by running the Integration IDs report and searching for the
Change Job Subcategory business object.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully but you don’t find This can occur if the information in your EIB input
the change job events you loaded. file doesn't align with the steps in your Change Job
business process definition in Workday.
1. Run the Mass Cancel Business Processes
task (secured to the Business Process
Administrator domain in the System functional
area) to cancel any in progress Change Job
events.
2. Update the information in your EIB input file
to align with the steps in your Change Job
business process definition.
3. (Optional) In Workday, consider updating the
business process definition by:
•Marking any unnecessary steps as optional
and then setting the processing instructions
in the EIB input file to Skip Processing for
optional steps.
• Adding condition rules on steps to skip them
in the business process if needed. Example:
Add a condition rule where External Load =
N.
4. Rerun the EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 433

Issue Cause and Solution


You can use the Business Processes tab in
the EIB integration event to view and identify the
business processes that are still in progress.

The EIB completes successfully and some changes The business process definition might have
are made but others are missing. condition rules that skip some of the steps.
View the business process event and look for
steps that are marked as not required. Change the
condition rules on the steps as needed.
The input file might also be missing a row ID.
When you populate a section of an EIB input file
that contains a row ID, you must specify a row ID
value or the section is skipped automatically.
After you adjust the business process definition or
input file, you can mass cancel or mass rescind the
previous EIB and then rerun the updated EIB.

EIB issues this error: Validation error occurred. If you want to move an employee to a new
Either the Proposed Position Restriction is required supervisory organization, then you need to either
or Create Position needs to be true. specify a new position or move the position
restriction from the old organization to the new
organization.
To move the position restriction, specify MOVE in
the Headcount Option field.
To create a new position, specify Y in the Create
Position field in the EIB input file.

Role assignments are missing after the Change job Role assignments are associated with the position,
event completes. not the employee.
If an employee is promoted to a new position,
they lose their existing role assignments on the
effective date of the promotion and pick up any
role assignments that are assigned to their new
position.
If the new position doesn't have any role
assignments associated with it, you can either:
• Specify the new role assignments in the Change
Job EIB.
• Create a separate Assign Roles EIB to assign
the relevant roles to the new position.

Unexpected changes to the worker’s organization If a worker moves to a new position or supervisory
assignments. organization, the organization assignments might
change based on the configuration of the new
assignments.
See Reference: Default Organization Assignments
for more information.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 434

Business Processes
Change Job.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only enables you to add new change job events. You can’t update or delete existing change job
events with this EIB.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind.
For reference documentation for all web services including Change Job, see Operation Directory.

Sample EIB Input Files


Change_Job-WD31-Example1-Position-Changes
Change_Job-WD31-Example2-Add Roles and Organizations
Change_Job-WD31-Example3-Move-Manager-and-Team
Change_Job-WD31-Example4-Change-Pay-Group
Change_Job-WD31-Example5-Change-Location

Concept: Change Organization Assignments EIB

Background
You can use this EIB to assign organizations to worker positions. You can assign organizations to a filled
position or position restriction.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Change Organization Assignments
• On the related actions menu of the worker profile, select Organization > Change Organization
Assignments.
There are also similar EIBs that you can use to assign organizations. Consider these options as you
determine what works best for you:
• Assign Members to Custom Organization: You can use this EIB to assign and unassign worker
positions as members of a custom organization. This functionality is also supported by the Change
Organization Assignments EIB.
• Import Assign Matrix Organization: You can use this EIB to assign members to matrix organizations.
• Import Change Organization Assignments: You can use this EIB to load large volumes of organization
assignments (Example: 1000 or more). If you need to load large volumes of organization assignments,
consider testing in your sandbox tenant to determine whether the Change Organization Assignments or
Import Change Organization Assignments EIB performs better for your use case.
• Import Remove Matrix Organization: You can use this EIB to remove members from matrix
organizations.
You can also perform mass organization changes through:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 435

• Move Workers (Supervisory) task


• Move Workers (by Organization) task
• Workbooks: See Initiate Change Organization Assignments in Mass Action Workbooks.
• Org Studio: See Org Studio and Mass Actions.

EIB Input File Guidelines


We recommend that you review Concept: EIB Spreadsheet Data Entry Guidelines on page 54, which
provides a general overview for populating EIB files. Additionally, as you populate the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for each position.
• Position (Required): Specify the position ID for the worker. Consider creating a custom report with the
All Workers data source to get the position ID.

Common Issues and Errors

Issue Cause and Solution

Unable to launch the EIB This is most likely security-related.


Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Change Organization
Assignments for Worker business process type in
the Organizations and Roles functional area.

EIB issues one of these two errors: Select the Show Change Organization
Assignments and Job Requisitions checkbox for
• Validation error occurred. One of the Custom
the organization type you want to assign or remove:
Organizations is not allowed because its type is
not allowed for positions. 1. Access the Maintain Organization Types task.
• Validation error occurred. The custom a. Security: Set Up: Organization domain in the
organization(s) xxxxx does not exist on this Organization and Roles functional area.
worker and cannot be deleted.
2. On the Custom tab, locate the organization type
you want to assign or remove.
3. Click the Edit button.
4. Select the Show Change Organization
Assignments and Job Requisitions checkbox
for the organization type you want to assign or
remove.
You should then be able to successfully run the
Change Organization Assignments EIB. When
you're done, you can us the same steps to unselect
the checkbox if you want.

EIB issues the following errors: Populate the position field in the EIB input file.
• The Company is required based on the position
assignment details settings for the company
organization type.
• The Cost Center is required based on the
position assignment details settings for the
organization type.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 436

Issue Cause and Solution


• Element Content Position_Reference is
required, on internal element Change
Organization Assignments Data.

EIB issues this error: Validation error occurred. Check these:


You cannot initiate this action because there are
• If you want to assign a future dated termination,
other pending or completed organization actions for
ensure you're using the latest web service
P00001 (Position Vacate:12/31/2018) that conflict
version for your EIB. This functionality isn't
with this one.
available for older web service versions.
• If you're not attempting to assign to a future
dated termination:
• Check historical org assignments for the
worker.
• Ensure they're prior to the effective date used
in the EIB input file.
• Verify there are no pending organization
assignments for the worker.
• If you need to make out-of-order organization
assignments, see Set Up Out of Order
Insertion and Correction for Organization
Assignments .

EIB issues an error like this: Validation error This can occur if you specify an employee ID
occurred. Invalid instance 247$5174 for instead of a position ID in the Position column in
Staffing_Interface_for_Assign_Organization_Secured--
the EIB input file.
IS (15$34955).
Ensure that you specify a position ID in the EIB
input file.

EIB issues an error like this: Validation error This can occur if you don't include all required
occurred. At least one of the Custom organization custom organization assignments in the EIB input
types is required based on the position assignment file:
details settings but has no entries.
1. Access the Maintain Organization Types task.
2. On the Custom tab, identify all organization
types where Position Assignment Required =
Yes.
3. Edit EIB input file and add all required
organizations.

Business Processes
Change Organization Assignments for Worker.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add new organization assignments, replace existing assignments and delete
assignments.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 437

For reference documentation for all web services including Change Organization Assignments, see
Operation Directory.

Sample EIB Input File


Change_Organization_Assignments-WD31_0

Concept: Contract Contingent Worker EIB

Background
You can use this EIB to add new contracts for pre-hires in a contingent worker position.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Contract Contingent Worker.
There are also similar EIBs that you can use to update contracts and contingent worker information.
Consider these options as you determine what works best for you:
• Correct Contingent Worker: You can use this EIB to correct the contract start date and conversion start
date.
• End Contingent Worker Contract: You can use this EIB to end a contingent worker’s contract.
• Import Contract Contingent Worker: You can use this EIB to load a large volume of contingent worker
contracts (Example: 1000 or more).
• Maintain Employee Contracts: You can use this EIB to load contracts for an employee.
• Put Applicant: Creates pre-hires.
• You can also create pre-hires with the Contract Contingent Worker EIB. If you prefer to create the
pre-hires before running the Contract Contingent Worker EIB, you can use the Put Applicant EIB.
• Put Assign Supplier to Contingent Worker: You can use this EIB to add or update a supplier for an
existing contingent worker.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Contract
Contingent Worker business process type in
the Staffing functional area to run this EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 438

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files. Additionally, as you populate the EIB input
file, consider:
• Spreadsheet Key: Specify a unique value for
each contingent worker.
• Applicant: This field performs the same function
as specifying an existing pre-hire when hiring in
Workday. Leave this field blank if you want to
create the pre-hire within the EIB.
• Position: Populate this field if you want to add a
new contract for a worker from an open position.
If you populate the Position field, don’t populate
the Job Requisition field.
• Job Requisition: Populate this field if you want
to add a new contract for a worker from an
open job requisition. If you populate the Job
Requisition field, don’t populate the Position
field.
• Position ID: Leave blank unless you
want to add a new contract for a worker
in a headcount group or job management
organization and you know that a new position
will be created for them.
• Contract Worker Reason: You can find a list
of reference ID values by running the View
Reference IDs report, searching for the General
Event Subcategory business object and then
filtering the Business Object Instance field for
Contract Contingent Worker.
• Create Purchase Order: Set to True if you use
Workday Procurement and you want to create a
purchase order for the contingent worker.
• If you set this field to True, it initiates the
Create Purchase Order for Contingent
Worker subprocess. The subprocess
only initiates if it’s defined as part of the
supervisory organization's business process
definition. You also need to manually finish
the process manually online to activate the
purchase order. Setting the field to True also
makes the Contract End Date field required
and will require currency and frequency
(hourly) values if you specify a pay rate.
• Supplier: If the worker isn’t an independent
contingent worker, specify the reference ID for
the supplier.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 439

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it seems This can occur if the information in your EIB input
that the data wasn’t loaded. file doesn't align with the steps in your Contract
Contingent Worker business process definition in
Workday.
1. Run the Mass Cancel Business Processes
task (secured to the Business Process
Administrator domain in the System functional
area) to cancel any in progress Contract
Contingent Worker events.
2. Update the information in your EIB input file to
align with the steps in your Contract Contingent
Worker business process definition.
3. (Optional) In Workday, consider updating the
business process definition by:
•Marking any unnecessary steps as optional
and then setting the processing instructions
in the EIB input file to Skip Processing for
optional steps.
• Adding condition rules on steps to skip them
in the business process if needed. Example:
Add a condition rule where External Load =
N.
4. Rerun the EIB.
You can use the Business Processes tab in
the EIB integration event to view and identify the
business processes that are still in progress.

I need to mass update existing contracts to change Consider:


the start date.
• Using a Correct Contingent Worker EIB to
correct the contract start date and conversion
start date.
• Manually updating the dates in Workday.
• Running the Mass Rescind Business
Processes task (secured to the Business
Process Administrator domain in the System
functional area) for the contingent worker
contracts and then reloading them with the
corrected date.

Can I mass update any contract information using This EIB only enables you to add new contracts.
this EIB? You can’t update existing contingent worker
contracts.

Can I convert employee to contingent or the other This EIB doesn't support this functionality. As a
way around, using this EIB? workaround, you can terminate the worker in their
current position and then hire them into their new
position.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 440

Issue Cause and Solution

The EIB isn’t creating the Workday account, even There are 2 different Create Workday Account
though the user information is populated in the EIB steps that you can configure in the Contract
input file. Contingent Worker business process. One is a
Service step, and the other is an Action step:
• If you're using the Service step: The business
process event automatically initiates the step
and creates the Workday account based on
the naming conventions specified through the
Maintain User Name Rules and Maintain
Password Rules tasks (secured to the System
Administrator domain in the Customer Central
and System functional areas). The EIB then
ignores any Workday account information
populated in the EIB input file.
• If you're using the Action step: The event uses
the information supplied in the EIB input file to
create the Workday account.
To address this issue, check the Contract
Contingent Worker business process definition and
verify that the Create Workday Account step is an
Action step.

EIB issues an error like this: If you specify an applicant ID (that is, a pre-hire ID)
or a former worker ID in the EIB input file, then you
Validation error occurred. Multiple Element
can’t populate any other data associated with the
Contents—including Contract Contingent Worker
applicant or former worker, such as name, country,
Business Process Data/a3/Create Applicant Data
email, phone, or addresses.
[EL]—contain data where only one is allowed
by mutex Contract Contingent Worker Business This information is redundant, and the EIB issues
Process Data. an error so that you don't overwrite existing
information.
To resolve this error, remove all applicant/former
worker information from the input file—including
any sections in the EIB input file with description
containing applicant/former worker data—and
specify only the applicant ID or former worker ID.
If you need to update information for the applicant
or former worker, you can either:
• Update it within a subprocess of the EIB (the
Change Personal Information business process,
secured to the Personal Information Change
domain in the Personal Data functional area).
• Run another integration after the Contract
Contingent Worker EIB to update the applicant/
former worker information (Examples: Change
Home Contact Information, Put Applicant, and
so on).

EIB performs slowly Consider these:


• If you want to load a large volume of contingent
worker contracts (Example: 1000 or more),

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 441

Issue Cause and Solution


consider using the Import Contract Contingent
Worker EIB for your use case.
• If you’re attempting to load a large volume of
workers to the same supervisory organization,
we advise loading no more than 1000-2000 at a
time to avoid data congestion.

Unable to launch the EIB This is most likely security-related.


Verify you have the correct security configuration.
Ensure that you are in the relevant security group
and have access to the Contract Contingent Worker
business process type in the Staffing functional
area.

Business Processes
Contract Contingent Worker.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only enables you to add new contracts. You can’t delete or update existing contracts.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel
or rescind. Alternatively, you can enter Add Vaccination in the Business Process Types prompt and enter
the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Contract Contingent Worker, see Operation
Directory.

Sample EIB Input File


Contract_Contingent_Worker-v38

Concept: Delete Worker Document EIB

Background
You can use this EIB to delete worker documents.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Maintain Worker Documents.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 442

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
You must have access to the Worker Data:
Edit and Delete Worker Documents domain in
the Personal Data functional area to run this
EIB.

Additional Input File Guidelines • Proceed with great caution when using this web
service as you can’t recover the documents
once the EIB deletes them.
• To help you populate the EIB input file, you can
create a custom report using the All Workers
report data source. As you define the custom
report and filters:
• Add columns with values from the Worker
Documents related business object.
Ensure that 1 field is Reference ID. Use the
Reference ID value returned by the report for
the ID field in the EIB input file.
• In the Filter tab, define a filter And | Worker
Documents | is not empty, along with any
other filter criteria for your business use case.
• Add a
• In the Subfilter tab, define a filter on the
Worker Documents related business object
And | Business Process | is empty.
• We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each worker.
• Worker: If deleting documents for
employees, you'll need to change

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 443

the reference ID type in Row #4 from


Contingent_Worker_ID to Employee_ID.
• Row ID: This field is typically a value 1 for
each entry, unless you have multiple row
entries for the same worker.
• Worker Document: This field is the
reference ID for the document. Use the
above report to find this value from the
Reference ID field.

Common Issues and Errors

Issue Cause and Solution

Unable to Launch the Integration This issue occurs if you don’t have proper security
access. Make sure you have Put access to domain
security policy Worker Data: Edit and Delete
Worker Documents.

The EIB issues an error like: Validation The File_ID specified in the input file isn’t the
error occurred. Invalid instance 13230$3 for proper reference ID type. Use the above custom
Delete_Worker_Document__Singular--IS report to get the correct file ID.
(15$406825)

EIB issues error: Validation error occurred. You You can’t use this EIB to delete worker documents
can’t delete a worker document that’s attached to a that are part of a business process event. Instead,
business process. To remove the worker document, you must correct the business process event to
correct the business process event. remove the document (or use the task Manage
Attachments, see Concept: Business Process
Step AttachmentsandSteps: Enable Attachments
on an Individual Business Process ).

EIB issues error: Validation error occurred. Invalid Make sure you specified the correct reference ID
ID value. 'xxxxx' is not a valid ID value for type = type for the worker. If you're removing a document
'Contingent_Worker_ID' for an employee, you need to change the reference
ID type (cell C4) from Contingent_Worker_ID to
Employee_ID.

EIB issues one of these 2 errors: The File_ID that you specified for the worker isn’t
correct. Verify the File_ID you entered by using the
1. Validation error occurred. Invalid ID value. 'xxxx’
above report to identify the correct file ID.
is not a valid ID value for type = 'File_ID'
2. Validation error occurred. Worker document is
not valid for the specified worker.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to remove documents only. If you need to add or update documents, use
Put Worker Document.
You can’t recover the documents once the EIB deletes them. If you have inadvertently removed the wrong
documents, check if the documents are still available from another tenant (Example: Sandbox). Then
retrieve the documents from the other tenant and upload the documents to Production.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 444

Note: you can't upload worker documents using EIB, as there are limitations on the size of files that EIB
can upload. To upload documents, create a custom integration or load the documents manually using the
Workday UI.
For reference documentation for all web services including Delete Worker Document, see Operation
Directory.

Sample EIB Input File


Delete_Worker_Document-WD32

Concept: Edit Worker Additional Data EIB

Background
You can use this EIB to update effective dated custom objects for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


From the related actions menu of the worker profile, select Additional Data > Edit Effective-Dated
Custom Object.
There are additional EIBs related to custom objects. Consider these options as you determine what works
best for you:
• Edit Job Requisition Additional Data
• Edit Position Restrictions Additional Data

EIB Input File Guidelines

Security Configuration Guidelines Verify you have have access to the Edit Worker
Additional Data Event business process type in the
Staffing functional area.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each worker.
• Effective Date: Workday requires this field.
• Worker: The spreadsheet requires this
section. Update the reference in row 4 from
Contingent_Worker_ID to Employee_ID.
• WID: If the first column for your custom object
has a field with format WID, don’t populate it.
This field displays for multi-instance custom
objects where there was no reference ID when
you created the custom object. The WID makes
the custom object unique. However, the web
service will populate it and maintain it.
• To update existing custom object values, you
might want to create a custom report, and use

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 445

it to help you populate the EIB input file. When


you generate the EIB template, it includes
all effective-dated Worker custom objects
configured in your tenant. However, you need to
populate only the fields for custom objects that
you wish to load.
• Ensure that the Edit Worker Additional Data
Event business process definition contains
a step for any custom objects that the EIB is
updating. If the business process definition
contains steps for custom objects that the
EIB isn’t uploading, remove the steps or add
a condition rule to prevent step execution.
(Example: External Load is blank).

Common Issues and Errors

Issue Cause and Solution


Workday displays this error: Validation error • If populating an employee ID, verify that the
occurred. reference ID type, specified in cell D4, is
Employee_ID instead of Contingent_Worker_ID.
• If populating amount or number fields, verify
that they contain no special characters such as
commas.

There’s no option to select the EIB when launching This issue occurs if you don’t have the proper
the integration. access to theEdit Worker Additional Data Event
business process security policy. Ensure that you
have access to the Initiating Action for Edit Worker
Additional Data (Web Service).
After the EIB loads data to a multi-instance custom When you update custom objects that enable
object, the EIB removed some of the previous multiple instances, you must include data for
entries. existing instances in the EIB input file. Otherwise,
the EIB removes the instances. If this issue occurs,
use the Mass Rescind Business Processes
task to rescind the business process events, and
then reload all entries. You might want to create a
custom report to help identify the existing entries.
The EIB completes successfully but you don’t find This issue can occur if the business process events
the custom object you loaded. are still in progress as one of the steps didn’t
complete. This issue occurs when:
• The EIB input file and business process
definition don't align.
• Processing instructions don't have the proper
settings in the EIB input file.
You can run the Mass Cancel Business
Processes task to cancel the in progress business
process events, and rerun the EIB after you
address the problem.
Also, this issue can occur if you don't load the
custom objects in chronological order.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 446

Issue Cause and Solution


EIB issues an error similar to this message: This issue occurs if you don’t have access to the
Validation error occurred. Current System User domain security policy that secures the custom
does not have permission to edit 7574$4 for 247$1 object. Use View Custom Object to check which
domain secures your custom object. Then give
the appropriate security groups Put access to that
domain.

EIB issues this error: The entered information This issue occurs when you don’t have sufficient
does not meet the restrictions defined for this field. access to the Edit Worker Additional Data Event
(Worker_Reference) business process security policy. Ensure you
have unconstrained access to Initiating Action for
Edit Worker Additional Data (Web Service). If you
have constrained access instead of unconstrained
access, then you might not be able to update
custom objects for all workers.
EIB issues an error similar to this message, If you assigned a reference ID when you created
when updating a multi-instance custom object: the custom object, Workday uses the reference
Processing error occurred. The 9613$184 business ID to determine whether each instance is unique.
object has custom data with duplicate value: ABC, Ensure that each entry in the input file (for a given
for reference ID field: xxx. worker) has a unique value for the field that you
configured as the reference ID. You can’t remove
or change the reference ID after you activate the
custom object. If the configuration of the custom
object doesn't work for you, create a new custom
object.
EIB issues error Validation error occurred. One 1. Ensure that you aren’t using a rule-based
or more of the custom objects submitted is not business process definition for the Edit Worker
configured in the business process definition. Additional Data. The web service doesn’t
support rule-based business process definitions.
2. Ensure that you configured a step in the Edit
Worker Additional Data Event business process
definition for the custom object you’re loading.
Example: To load information for the custom
object Drug Tested, you need to have this step
in the business process definition:
• Type: Edit Additional Data
• Specify: Drug Tested

The EIB is adding extra decimal places to numbers This issue can occur due to an Excel limitation with
and causing an error such as this: storing decimals when using xml files. See Numeric
Validation error occurred. value precision issue in Excel 2007 when saving as XML
1121.8499999999999 must be limited to 3 decimal to learn why it happens and why it occurs only for
places certain decimals.
We recommend that you generate the template
using xlsx instead of xml to avoid these problems.
If you wish to use an XML input file, you can work
around this issue by converting the numbers to text
before adding to the EIB input file:
1. Place the numbers in an Excel file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 447

Issue Cause and Solution


2. Then use a formula to convert them. Ex:
=text(a1,"0.00").
3. Paste Special from Excel to the EIB input file

The EIB issues an error similar to this message: Ensure that you aren’t placing a value in the
Invalid instance with ID: 247$8 for field xxxxx field with Reference appended to the end.
(7576$30) Example: in the attached sample EIB input file, field
petsAllowedInOfficeReference should remain blank.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB enables you to add new entries or update existing entries. You can’t delete entries. If you have
inadvertently uploaded incorrect entries, use the Mass Rescind Business Processes or Mass Cancel
Business Processes tasks. Select the applicable task depending on whether the business process event
completes or is still in progress. Then, select Business Processes Loaded by EIB to find the integration
event that you wish to cancel or rescind. Alternately, you can enter Edit Worker Additional Data Event at
the Business Process Types prompt.
You can’t delete entries with this EIB. To delete a large number of instances for an effective dated custom
object, you have these options:
• Rescind the business process events that you originally used to add the custom object data. You might
be able to use the Mass Rescind Business Process Events task, if you’re able to identify the events
to rescind, based on a date range. You can also use the Rescind Business Process EIB.
• If you can risk removing the historical custom object data, and want to ensure that the current data as of
today is correct, reload the data. Use an effective date that is newer than previous data that you loaded,
and populate the EIB with the current information. If the worker should no longer have any custom
object information assigned, you can load a blank custom object entry. You can load a blank entry only
if the custom object has no reference ID assigned. Also, you must configure the custom object fields as
optional.
• As a last resort, create a new custom object and load all relevant information to that custom object.
Then retire the old custom object.

Sample EIB Input Files


Edit_Worker_Additional_Data-WD31-Example1-SingleInstance
Edit_Worker_Additional_Data-WD31-Example2-MultiInstance

Concept: Hire Employee EIB

Background
You can use this EIB to hire a pre-hire (new or existing) into an employee position.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Hire Employee.
There are also similar EIBs that you can use for hiring employees. You can use the Import Hire Employee
EIB to load large volumes of new hires (Example: 1000 or more). If you need to load large volumes of new
hires, consider testing in your sandbox tenant to determine which EIB performs better for your use case.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 448

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Hire business
process type in the Time Off and Leave
functional area to run this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
You might find it helpful to enter data manually and
make note of all the information when you hire an
employee. You’ll then know what information you
need to populate in the EIB input file.
Make certain that the steps in the Hire business
process align with what you populate in the input
file. Example: if the Hire business process has an
Assign Pay Group step, then you need to populate
the pay group information in the EIB input file.
Alternately, add a condition rule to skip the step in
the Hire business process. Example: Add condition
rule External Load = N.
As you populate the EIB input file, consider:
• Spreadsheet Key: Use a unique value for each
employee.
• Applicant: This field equates to specifying an
existing pre-hire when hiring in Workday. Leave
this field blank if you want to create the pre-hire
within the Hire EIB.

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully, but you don’t find The business process events are still in progress
the hires you loaded. due to the misalignment of the EIB input file and the
business process definition. Use the Mass Cancel

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 449

Issue Cause and Solution


task to cancel the in-progress hire events, and start
over.

When you include an existing applicant ID (that is, If you populate an applicant ID (pre-hire ID) or a
pre-hire) or former worker ID in the EIB input file, former worker ID, you can’t populate any other
the EIB fails with one of these errors: data associated with the applicant or former
worker. Examples: name, country, email, phone,
• Validation error occurred. Multiple Element
addresses. This information is redundant, and the
Contents, including Hire Employee Business
EIB issues an error so that you don't overwrite
Process Data/a1/Applicant/CL] contain data
existing applicant information. To resolve this error,
where only one is allowed by mutex Hire
remove all applicant information from the input
Employee Business Process Data.
file, including any sections in the EIB input file with
• Validation error occurred. Multiple Element description containing applicant data. Then specify
Contents, including Hire Employee Business only the applicant ID or former worker ID.
Process Data/a2/Former Worker [CL], contain
data where only one is allowed by mutex Hire If there’s information that you need to update for
Employee Business Process Data the applicant or former worker that you’re hiring, the
options are:
1) Update it within a subprocess of the hire EIB
(that is, Change Personal Information)
2) Or run another integration after the hire to
update applicant information (that is, Change Home
Contact Information, Put Applicant, and so on).

The EIB issues this error: Validation error occurred. If you hire employees but rescind their offers, the
Enter a unique Employee ID. The ID is already in input file can contain an employee ID that you
use by xxx. already used. To resolve the issue, you could:
• Change the reference IDs for the hires you
previously loaded through the Put Reference
EIB. See the tips and tricks for the Put
Reference EIB for an example.
• Use different employee IDs.
• Reload the hire and specify the pre-hire ID (the
applicant ID) in the input file. You'll also need to
remove all information for the pre-hire from the
input file, including their name.

The EIB issues errors stating that localized These fields support specific countries and the web
information is missing. Example: Gender isn’t service can't find the country to check against. To
tracked or Marital status doesn’t exist. resolve this issue:
1. Bring up the location associated with the
position of the worker.
2. Go to the Contact Information tab and click Edit.
3. Change the effective date to an earlier date
such as 01/01/1900.

The EIB issues the error: Validation error This issue occurs when you populate both the
occurred. Multiple Element Contents, including position and job requisition.
Hire Employee Business Process Data/d1/Job
Requisition for Fill WWS Events Secured by
Transactions [WS]*ST, contain data where only

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 450

Issue Cause and Solution


one is allowed by mutex Hire Employee Business
Process Data.

Even though the Create Workday Account section There are two different Create Workday Account
gets completed in the EIB input file, the EIB doesn’t steps that can get configured in the Hire business
use the User Name populated in the template. process. One has a type of Service and the other
has a type of Action:
• If using Service step: The Hire event
automatically launches the step and creates
the Workday account. It creates the account
based on the naming conventions configured on
the Maintain User Name Rules and Maintain
Password Rules tasks. The EIB ignores any
Workday account information populated in the
EIB input file.
• If using Action step: The event uses the
information supplied in the EIB input file to
create the Workday account.
To address this issue, check the Hire business
process definition and verify that the Workday
Account step is type Action.

Even though you entered personal information, This issue typically occurs if the row ID field is
such as gender and birth date, in the EIB input file, blank. For information such as gender, verify that
it isn’t loading. you populated a row ID in sections:
• Personal Information
• Personal Information for Country Data, and
• Country Personal Information Data.
Also, verify that you have Put access to the domain
security policies for pre-hire personal data.

Business Processes
Hire.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add only. You can’t change, correct, or delete the hire through the EIB.
• If you have inadvertently uploaded incorrect entries, run the mass rescind or mass cancel, depending
on whether the business process event completes or is still in progress. You can then select Business
Processes Loaded by EIB to find the integration event that you wish to cancel or rescind.
For reference documentation for all web services including Hire Employee, see Operation Directory.

Sample EIB Input File


Hire_Employee-WD35_0_1

Concept: Import Assign Matrix Organization EIB

Background
You can use this EIB to assign members to matrix organizations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 451

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on the type of organization that you’re creating or updating.
Examples of equivalent Workday tasks include:
• Assign Matrix Member.
• Assign Matrix Organization.
• On the related actions menu of the worker profile, select Organization > Assign Matrix Organization.
• On the related actions menu of the matrix organization, select Organization > Assign
Matrix Member.
If you want to remove members from a matrix organization, you can use an Import Remove Matrix
Organization EIB.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Assign Matrix
Organization business process type in the
Organizations and Roles functional area to
run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Worksheet#1 for Import Assign Matrix
Organization. As you populate this worksheet,
consider:
• You would typically have just 1 entry in this
worksheet with Header Key value set to 1.
The only exception to this rule would be if
you have a very large volume of assignments
(Example: 10,000+), in which case you might
test in a nonproduction tenant to see if the
integration runs more efficiently if breaking
the assignments into multiple header key
values.
• Header Key: Enter a value of 1.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 452

• Worksheet#2 for Assign Matrix Organization


Info. As you populate this worksheet, consider:
• Header Key: Enter a value of 1.
• Line Key: Enter a unique value for each
assignment.
• Autocomplete: Set to Y to skip approval
steps, to do steps and notifications.
• Worker: The EIB requires this value
(in column N). Most likely you’ll need to
change the reference id, in row 4, from
Contingent_Worker_ID to Employee_ID.
• Position: Workday requires this field.
• Effective Date: Effective Date of the
Assignment.
• Matrix Organization: To find the matrix
organization values, run the View Reference
ID report and enter Matrix Organization at the
Business Object prompt

Common Issues and Errors

Issue Cause and Solution

There’s no option to launch the EIB. This issue can occur if you don’t have proper
access to the Assign Matrix Organization
business process security policy. To resolve this
issue:
1. Edit the business process security policy for
Assign Matrix Organization.
2. Go to the Initiating Action section for Import
Assign Matrix Organization (WS Background
Process).
3. Add a security group that you’re a member of.
4. Activate the change.

The EIB issues error Invalid ID value. ‘xxxx' is not a This issue can occur when the reference ID type
valid ID value for type = 'Contingent_Worker_ID' is Contingent Worker instead of Employee ID. If
you’re attempting to assign employees to the matrix
organization, then check the value in cell N4 and
verify that it’s Employee_ID

The EIB issues an error like this message: The 1. Make certain that the worker isn’t already a
position isn't valid for this Worker as of the effective member of the matrix organization
date. Worker: xxx Position xxx: MM/DD/YYYY 2. Make certain that you entered the correct
position for the worker in the EIB input file

Business Processes
Assign Matrix Organization.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 453

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to assign members only. To remove members, use the Import Remove
Matrix Organization web service.
If you have inadvertently uploaded incorrect entries, you can use these tasks to remove the entries:
• Mass Rescind Business Processes
• Mass Cancel Business Processes (if the events are still in progress).
There's no Business Processes Loaded by EIB option when using the mass cancel or mass rescind tasks.
Instead, go to the Business Process Types prompt and enter Assign Matrix Organization. Then select the
date range in which the EIB ran to find the events you need to cancel or rescind.
For reference documentation for all web services including Import Assign Matrix Organization, see
Operation Directory.

Sample EIB Input File


Import_Assign_Matrix_Organization-WD32

Concept: Import Remove Matrix Organization EIB

Background
You can use this EIB to remove members from matrix organizations.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Remove Matrix Member.
• Remove from Matrix Organization.
• On the related actions menu of the worker profile, select Organization > Remove from Matrix
Organization.
• On the related actions menu of the matrix organization, select Organization > Remove
Matrix Member.
If you want to assign members to a matrix organization, you can use an Import Assign Matrix
Organization EIB.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 454

• Verify you have the correct security


configuration:
• You must have access to the Remove from
Matrix Organization business process type
in the Organizations and Roles functional
area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider
• Worksheet#1 for Import Remove Matrix
Organization: As you populate this worksheet,
consider:
• You would typically have just 1 entry in this
worksheet with Header Key value 1: the only
exception to this rule would be if you have
a very large volume of assignments you are
removing (Example: 10,000+), in which case
you might want to test in a nonproduction
tenant to see if the integration runs more
efficiently if breaking the removals into
multiple header key values.
• Header Key: Enter a value of 1
• Worksheet#2 for Remove Matrix Organization
Info. As you populate the worksheet, consider:
• Header Key: Enter a value of 1
• Line Key: Enter a unique value for each
removal
• Autocomplete: Set to Y to skip approval
steps, to do steps and notifications
• Worker: The EIB requires this value
(in column N). Most likely you’ll need to
change the reference id, in row 4, from
Contingent_Worker_ID to Employee_ID
• Position: Workday requires this field
• Effective Date: Effective Date of the
Removal from the Matrix Organization
• Matrix Organization: To find the matrix
organization values, run the View Reference
ID report and enter Matrix Organization at the
Business Object prompt
• You might find it helpful to create a custom
report to help you populate the EIB input file.
Add a filter to check Matrix Organizations is not
empty along with any other appropriate filters for
your use case.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 455

Common Issues and Errors

Issue Cause and Solution

There’s no option to launch the EIB This error will occur if you don’t have proper
access to the Remove from Matrix Organization
business process security policy. To resolve this
issue:
• Edit the business process security policy for
Remove from Matrix Organization
• Go to the Initiating Action section for Import
Remove Matrix Organization (WS Background
Process)
• Add a security group that you’re a member of
• Activate the change

The EIB issues the error: This issue can occur when the reference id type
is Contingent Worker instead of Employee ID. If
Invalid ID value. ‘xxxx' is not a valid ID value for
you’re attempting to remove employees from the
type = 'Contingent_Worker_ID'
matrix organization, then check value in cell N4 and
verify that its' Employee_ID

The EIB issues an error like this: Check to make certain that:
The position isn't valid for this Worker as of the 1. The worker displays as assigned to the matrix
effective date. Worker: xxx Position xxx: 01/25/2019 organization
2. You entered the correct position for the worker
in the EIB input file

Business Processes
Remove from Matrix Organization.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to remove members only. If you need to assign members, use web service
Import Assign Matrix Organization.
If you've inadvertently uploaded incorrect entries and the events are still in progress, you might want to use
task Mass Rescind Business Processes or Mass Cancel Business Processes to remove the entries.
There’s no Business Processes Loaded by EIB option when using the mass cancel or mass rescind tasks.
Instead, you can:
1. Go to the Business Process Types prompt and select Remove from Matrix Organization.
2. Select the date range of the EIB and find the events you need to cancel or rescind.
For reference documentation for all web services including Import Remove Matrix Organization, see
Operation Directory.

Sample EIB Input File


Import_Remove_Matrix_Organization-WD32

Concept: Put Worker Document EIB

Background
You can use this EIB to add or update a worker document. This EIB doesn't support reviewed documents.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 456

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.
We recommend using this EIB to change the document category for an existing worker document.
Note: If you want to add or update the contents of a worker document using this EIB, the attachment files
must be base-64 encoded. This is extremely challenging to do in the input file for this EIB. For this reason,
consider creating a custom Studio integration instead.

Equivalent Workday Task


Task: Maintain Worker Documents.
You can use the Delete Worker Document EIB to delete worker documents.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Worker Data:
Add Worker Documents domain in the
Personal Data functional area to run this EIB.

Populating File Attachments for the EIB It can be a bit tricky loading documents using EIB,
for 2 reasons:
1. You need to base-64 encode the documents and
then populate the base-64 value in the EIB input
file
2. Excel has a limitation of 32,767 characters per
cell. After encoding the document, it needs to be
fewer than 32,767 characters.
For the above reasons, customers often opt to use
a custom integration when it's necessary to load
attachments. If you need to upload file attachments,
you might want to check these Community Posts
for alternatives to loading worker documents to your
tenant:
• Here’s a solution to mass upload
Worker Documents using Studio: https://
collaborate.workday.com/t5/-/-/m-p/1248315
• Here’s a solution to mass upload Worker
Documents using Microsoft.NET: https://
collaborate.workday.com/t5/-/-/m-p/1252983

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 457

If you wish to go forward with using the EIB, below


are some suggestions for populating attachments:
• You'll need a tool to base 64 encode your file.
There are many free tools available to base 64
encode files. (Such as Notepad++ for which
you'll need to install the MIME Tools plug-in).
• After you encode the document, the size needs
to be under 32,767 characters to be able to
paste it into Excel. If it's larger, there are a
couple options:
• If the document is an image, you could
make it smaller using a third-party tool
such as Image Optimizer available at
www.imageoptimizer.net. Note that this tool
isn’t Workday endorsed. Proceed at your own
risk.
• You could edit the EIB input file with a text
editor such as Notepad++ (instead of opening
it with Excel) and paste in the encoded value.
This action removes the restriction of 32,767
characters.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Proceed with great caution when updating
existing documents using this EIB as you can't
easily recover the original documents after you
update them.
• There's an option to generate the spreadsheet
with data. However, we don’t advise using this
functionality for this particular EIB, for these
reasons:
1. The template generation includes the content
of the worker document files (base 64-
encoded), which results in a very large
template file that you might have issues
opening using Excel.
2. Even if you're able to open the spreadsheet
template generated by the EIB, be aware that
Excel has a limitation of 32,767 characters
per cell. For this reason, when you open the
template using Excel, the document contents
might be truncated. If you attempt to reload
the generated template (with truncated file
contents), it could corrupt the documents.
• If you plan on updating or adding file content,
see the Populating File Attachments for the EIB
section.
• If you're updating existing entries, consider:
• If you aren't updating the file content, then
it's not necessary to include the existing

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 458

file content in the EIB input file. Example: If


you merely need to update the document
category, then you don't need to include the
existing file content of the document in the
EIB input file. However, do note that at a
minimum, you must populate these fields:
Spreadsheet Key, ID, File Name, Worker,
and Document Category.
• You might find it useful to create a custom
report to help you populate the EIB input file.
• As you populate these fields in the input file,
consider:
• Spreadsheet Key: Specify a unique value for
each document.
• ID: The reference id for the document.
• Filename: Name of file. Workday requires
this field even if updating an existing
document.
• File: Provide the base-64 encoded file
content. See Populating File Attachments for
the EIB section for details on how to populate
this field. Note that if you're updating an
existing entry, you need to populate this field
only if you want to replace the existing file
content.
• Document Category: If you aren’t
specifying a Workday owned document
category, you’ll need to change the
reference id type in Row#4, from
Document_Category__Workday_Owned__ID
to Document_Category_ID. To get a list of all
reference id’s, run the Integration IDs report
and search business objects Document
Category and Document Category (Workday
Owned)
• Worker: If adding or updating documents
for employees, you’ll need to change
the reference id type, in Row #4, from
Contingent_Worker_ID to Employee_ID. If
you need to update worker documents for
both employees and contingent workers,
you might find it helpful to split the columns
using the Separate Type Column option as
described in Customize EIB Spreadsheet
Template. By splitting the columns you can
populate document information for both
employees and contingent workers in the
same EIB input file.
• Content Type:An optional field. To find
reference id values, run the Integration IDs
report and search for business object Mime
Type.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 459

Common Issues and Errors

Issue Cause and Solution

Unable to view files that uploaded using the EIB. Most likely there was an issue with the base 64
You receive an error such as unable to load or encoding or the encoded file was larger than
failed to load or string length must be a multiple of 4 Excel's limit of 32,767 characters.
or not a supported file.
SeePopulating File Attachments for the EIB section
Or the document loads, but doesn't properly for details on how to encode the file.
display.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add or update Worker Documents. If you need to remove documents, use
Delete Worker Document.
This EIB doesn't use a business process event. If you made mistakes when adding or updating
documents, it might be difficult to recover, since you can't rescind. Consider these options:
• If you added new documents, and need to remove them, use Delete Worker Document.
• If you didn't change the contents of the document but rather made errors changing an attribute such
as document category, then you should be able to update the existing documents using the EIB (after
correcting information in the EIB input file).
• If you changed the contents of the documents and there were errors, then an option would be to check
if the documents are still available from another tenant such as Sandbox and retrieve them from that
tenant and reupload to Production. But note that this isn’t something you could easily do using the EIB
due to limitations on the size of files that EIB can upload.
For reference documentation for all web services including Put Worker Document, see Operation Directory.

Sample EIB Input File


Put_Worker_Document-WD32

Concept: Terminate Employee EIB

Background
You can use this EIB to terminate employees.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Terminate Employee.
You can also perform mass termination changes through the Mass Operation Management task. See
Steps: Automate Initiation of Termination for more information.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 460

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Terminate
Employee business process in the Staffing
functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• You might find it helpful to start by manually
terminating an employee and entering the same
type of information you want to load using the
EIB. By doing this, you can verify which fields
are required fields.
• Make certain that the steps in the Termination
business process definition are align to what you
are populating in the EIB input file. Example:
If the Termination business process definition
includes a Review COBRA Eligibility step, then
you need to do one of the following:
• If you wish to provide COBRA information,
then populate the COBRA eligibility
information in the EIB input file. Also, in
the Overview tab of the EIB input file, set
the processing instructions to Automatic
Processing for Review COBRA Eligibility.
• If you don't want to provide COBRA
information, then you can add a condition rule
to skip the step in the Termination business
process definition. Example: add condition
rule of “External Load = N”.
• Or modify the Termination business process
definition and mark the step as optional.
Then in the EIB input file, set the processing
instructions to Skip Processing when Step is
marked optional.
• If you're populating a subprocess within the
EIB input file, you need to make certain that
the Termination business process definition

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 461

has a step for this process. Example: If you're


populating Service Dates in the EIB input file,
then the Termination business process definition
needs to include the Edit Service Dates step.
• You'll need to go through the above checks for
each step in the Termination business process
definition. If the business process definition and
the EIB input file aren’t aligned, then you’ll run
into situations where information isn't loaded and
the Termination event is still in progress, after
the EIB load completes.
• As you populate these fields in the input file,
consider:
• Spreadsheet Key: Specify a unique value for
each employee.
• Primary Reason: To find the Reference
ID values for this field, use the Integration
IDs report and search business object
Termination Subcategory

Common Issues and Errors

Issue Cause and Solution

The EIB completes successfully with some of the Most likely the business process definition has
changes but others are missing. condition rules causing Workday to skip some of
the steps. Even if you supply information in the
input file, Workday will ignore it if the business
process step has a condition rule that evaluates
to false (or if the business process definition is
missing the step). To check for these types of
issues, view the full process record of the business
process event and look for steps marked as not
required. Change the condition rules on these
steps, if needed. After making corrections, you can
run task Mass Cancel Business Processes (or
Mass Rescind Business Processes if the event
completed). Then you can rerun the EIB.

The EIB completes successfully but the changes This issue typically occurs because the business
weren’t made process events are still in progress as one of the
steps didn’t complete due to the EIB input file and
business process definition being out of alignment.
See Additional Input File Guidelines section on
how to get the business process definition and
input file aligned. If this issue occurs, you can run
Mass Cancel Business Processes to cancel the
in progress termination events. Then correct the
problem, and rerun the EIB.
Also, note that there’s a Business Processes tab
that displays in the EIB integration event, after the
EIB successfully completes. This tab enables you
to quickly view all loaded business process events.
From here, you can determine whether the events

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 462

Issue Cause and Solution


are still in progress or if they completed. If you
want to take a closer look at any of the termination
events, you can view the full process record from
the related action of the event.

When attempting to use this EIB to update You can’t use this EIB to update or correct existing
Regrettable Status field for previously terminated terminations: you can only use this EIB to terminate
employees, it fails with these errors: employees who you haven't yet terminated.
• The date entered must be on or after the day the If you want to go back and add the "regrettable
position was last updated. status" for previously terminated employees, the
• The worker cannot be terminated because there only options are to:
are future approved staffing actions for this • Manually correct the termination event for each
worker. terminated employee, and add the regrettable
status.
• Mass rescind the termination events. Then
reload the terminations and include the
regrettable status in the EIB input file. (If using
this option, test in Sandbox first).

Even though the Regrettable field value is present Make certain you’re using the latest web service
in the EIB input file, it isn’t being loaded version as there were recent changes made to
the regrettable field. If you aren’t certain what web
service version you’re using, create a new EIB and
it will pick up the latest web service version.

Business Processes
Termination.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to create new termination events. You can’t modify or delete an existing
termination event.
If you've inadvertently uploaded incorrect entries, use task Mass Cancel Business Processes (or
Mass Rescind Business Processes if the business process event is in progress). You can then select
Business Processes Loaded by EIB to find the integration event that you wish to cancel or rescind. Or the
other method is to enter Termination at the Business Process Types prompt, then enter the date range that
you ran the EIB.
For reference documentation for all web services including Terminate Employee, see Operation Directory.

Sample EIB Input Files


Terminate_Employee-WD31-Example1-Initiation-Step-Only
Terminate_Employee-WD31-Example2-Include-Cobra

Student Finance EIBs


Concept: Import Charges for Students EIB

Background
You can use this EIB to apply a charge to a student or adjust an existing charge.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 463

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


• For a new charge: Apply Student Charge.
• For adjusting an existing charge: On the student's profile, access the Account Transactions in the
Student Financials section. On the related actions menu of the transaction, select Student Charge >
Adjust.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Student Charge
Event business process type in the Student
Financials functional area to run this EIB.

Guidelines for Adding Worktags to the EIB You can specify more than 1 worktag for any of the
Template student charges.
1. From the related actions of your EIB, select
Template Model > View.
2. On the left, click Apply Student Change Data
+. On the right, locate Worktags.
3. From the related actions on the magnifying
glass next to Worktags, select Template Model
Column > Maintain Additional Columns.
4. Enter all worktags that you need to assign to the
template.
5. After you’ve completed the previous steps,
regenerate the spreadsheet template and add
newly added worktags to the spreadsheet
template.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 464

populating EIB files. Additionally, as you


populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each student charge.
• ID: If adjusting an existing charge, enter the
reference ID value of the original charge. You
can create a custom report with data source
Student Charges to find reference ID value.
Refer to the example below:
• Section for Apply Student Charge:
Populate this section if creating a new
student charge.
• Row ID: Typically a value of 1 for each
entry.
• Student: Reference ID value of the
Student. Note that the reference ID type
populates as Academic_Person_ID. If
you wish to use a different reference ID
type such as Student_ID, change it in cell
E4.
• Institution Academic Unit: To find
reference ID values, run the View
Reference IDs report and search business
object Academic Unit.
• Transaction Date: Student Charge
Transaction Date. Enter date using format
YYYY-MM-DD.
• Due Date: Student Charge Due Date.
Enter date using format YYYY-MM-DD.
• Academic Period: To find reference ID
values, run the View Reference IDs report
and search business object Academic
Period.
• Student Charge Item: To find reference
ID values, run the View Reference IDs
report and search business object Student
Charge Item.
• Worktags: If adding worktags, modify
the template and select worktag types
that you need to populate. See the
Guidelines for Adding Worktags to the
EIB Template section above.
• Section for Adjust Student Charge:
Populate this section if adjusting an existing
student charge:
• Row ID: Typically a value of 1 for each
entry.
Amount: The new adjusted charge
amount. Enter $0 to back out charge.
• Student Charge Adjustment Reason:
To find reference ID values, run the
Integration IDs report and search

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 465

business object Student Charge


Adjustment Reason.

Common Issues and Errors

Issue Cause and Solution

Performance is slow. This web service runs background jobs to process


accounting information for student charges. The
background processes can run slowly if using an
older version of the web service and populating
multiple header key values. If performance is slow:
1. Verify you're using the latest web service
version of Import Charges for Students. If
you're using an EIB input file that includes a
Header Key column, this column indicates
that you're using an older web service version.
Performance can be slow.
2. To prevent further performance issues, create
a new EIB to uptake the latest web service
version.

My EIB input template doesn’t match sample Workday made major changes to this spreadsheet
attachment: it has extra worksheets. with WWS v36.0. Create a new EIB if you're using
an older web service version.

Unable to launch the EIB This issue is most likely security-related. See the
Performance is slow issue.

Business Processes
Student Charge Event.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new student charges or adjust existing student charges. You can't
delete or cancel charges.
• If you've inadvertently uploaded incorrect entries, there are options to correct the entries:
• If the business process is still in progress, use task Mass Cancel Business Processes to cancel
the student charge events.
• You can't rescind this business process. If the student charge events complete, you can either:
• Rerun the EIB and adjust the student charges with correct amount/due date.
• Cancel the entries using the EIB for web service Import Mass Cancel Student Charges.. Then
reload the correct entries.
For reference documentation for all web services including Import Charges for Students, see Operation
Directory.

Sample EIB Input File


Import_Charges_for_Students-WD36

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 466

Talent EIBs
Concept: Manage Certifications EIB

Background
You can use this EIB to add, update, or delete certifications for a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Career > Certifications from the related actions of the worker's profile.

EIB Input File Guidelines


Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Manage
Certifications business process type in the
Worker Profile and Skills functional area to
run this EIB.

Guidelines for Creating a Custom Report for the This web service does a replace all when updating
EIB Input File existing worker certifications. Therefore it’s very
important to populate the EIB input file with all
existing information that you need to retain. You
can create a custom report to help populate the EIB
input file with existing data. You can also use the
Skill Reference ID field in the custom report to get
the reference ID value that you'll need if removing
worker certifications.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 467

• As you populate the EIB input file, consider:


• Spreadsheet Key: Specify a unique value for
each person that you’re loading certifications
for.
• Role: Enter the reference ID of the
person assigned to the certification. It will
likely be a value for Employee_ID. If entering
a value other than employee ID, change the
reference ID type in cell C4 accordingly.
Row ID (column E): Workday requires this
field. The value should always be 1 unless
you’re loading more than 1 certification for a
given person.
• Certification: (column F): If updating or
deleting a worker’s existing certification,
supply the reference ID value here. Use the
report from the Guidelines for Creating a
Custom Report for the EIB Input File section
to determine the value to use (use the Skill
Reference ID value from the report).
• Row ID (column G): Enter value 1.
• Certification ID (column H): This field is
optional. You can assign a value if you’re
adding a new certification and wish to assign
the reference ID value. (If left blank, the
web service will autoassign the reference ID
value)
• Remove Certification: Enter Y to remove an
existing worker certification.
• Certification (column J): The worker's
assigned certification. For a list of reference
ID values, run the View Reference IDs report
for business object Certification.
• Worker Document Data: Although you
can add attachments using this EIB, we
don't recommended it, as there are some
challenges in loading document content
through EIB. If you need to add attachments
through an integration, see the EIB Input
File Guidelines section in Future: Concept:
Put Worker Document EIB . It's a different
web service, but the same information
applies to this EIB in regard to the method
for populating attachments. If you're
updating existing certifications with existing
attachments, include the attachments in the
EIB input file, or the EIB removes them.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 468

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, the data This issue might be a result of a missing row ID
didn't load. value. Edit the EIB input file:
• Spreadsheet Key value must have a unique
value for each person that you’re loading
certifications for.
• The row ID, in column E, must contain a value.

When updating existing certifications, the EIB This web service does a replace all when updating
successfully completes the update, however existing worker certifications. Therefore, you must
some of the existing certification information gets make certain you populate the EIB input file with all
removed, including any attachments. information you wish to keep. Use the report from
the Guidelines for Creating a Custom Report for the
EIB Input File section above to help identify existing
information.

EIB issues an error like this: This issue will occur if you don’t populate the row ID
in the Certification Data section. Verify that the Row
Element Content 'Certification_Data' is required, on
ID value is present in column G.
internal element 'Certification Achievement'.

EIB issues an error like this: Check:


Validation error occurred. This certification is • If you’re updating existing certifications, make
already in use. sure you've specified the correct reference ID in
column F.
• If adding new certifications, column F should be
empty.
• The spreadsheet key is unique for each worker
listed in the EIB input file.

EIB issues an error like this: Review EIB input file and verify that cell
C4 specifies the correct reference ID type
Validation error occurred. Invalid ID value. '22666'
for the people you’re assigning certificates
isn’t a valid ID value for type = 'Employee_ID'.
to. Example: For a contingent worker, use
Contingent_Worker_ID. For an employee, use
Employee_ID.

Unable to launch the EIB. This issue is most likely security-related. See the
EIB Input File Guidelines section above for details
on how to configure security.

I want to remove fields from existing certifications Since the EIB does a replace all, you can do just
such as Expiration Date. leave the field blank in the EIB input file.

Business Processes
Manage Certifications.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, or delete certifications.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 469

• If you’ve inadvertently uploaded incorrect entries, use task Mass Cancel Business Processes or
Mass Rescind Business Processes. What you use depends on whether the business process
event is complete or in progress. You can then select Business Processes Loaded by EIB to find the
integration event that you wish to cancel or rescind. Your other option is to enter Manage Certifications
at the Business Process Types prompt and enter a date range that you ran the EIB.
For reference documentation for all web services including Manage Certifications, see Operation Directory.

Sample EIB Input File


Manage_Certifications-WD35

Concept: Manage Professional Affiliations EIB

Background
You can use this EIB to add, update, and delete professional affiliations for a role, such as employee,
contingent worker, or student.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Careers > Professional Affiliations from the related actions of the worker's profile.

EIB Input File Guidelines

Web Service Version and Security Configuration • It's important that your EIB uses the most recent
Guidelines web service version, so that you have all the
latest enhancements and fixes. If you aren't
certain what version you're using, follow these
steps:
• From related actions of the EIB, select
Template Model > View.
• You can view the version on this page. Verify
you’re using a newer version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version
• Verify you have the correct security
configuration.
• You must have access to the Manage
Professional Affiliations business process
in the Worker Profile and Skills functional
area.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• When updating existing affiliation assignments,
populate all existing fields in the EIB input file,
as the web service doesn’t support incremental
updates. Therefore, if existing fields remain

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 470

blank the web service removes the field in the


EIB input file
• As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: Specify a unique value for
each Person.
• Role: Enter the reference ID of the person
that you’re assigning the professional
affiliation to. Most likely, you’ll want to
change the reference ID, in cell C4, from
Academic_Affiliate_ID to Employee_ID
• Row ID (column E): Enter a unique row ID for
each person
• Row ID (column G): Enter a unique row ID
for each professional affiliation assigned to a
given person
• Professional Affiliation ID(column H):
• If updating or removing an existing
professional affiliation assignment, enter
the reference ID value in this field. You
can use a custom report such as the
example below, to find the reference ID
value.
• If adding a new professional affiliation
assignment, you can leave the field blank
and the web service will automatically
assign a value. Or you can populate a
value that you haven't used yet.
• Remove: Enter Y to remove a professional
affiliation
• Professional Affiliation (column J):
Enter the reference ID of the professional
affiliation. To find values, run the View
Reference IDs report and specify business
object Professional Affiliation. If you want
to populate a professional affiliation that
you haven't yet set up in your tenant using
Maintain Professional Affiliations task,
then leave this column blank and populate
Professional Affiliation field in column K.
• Professional Affiliation (column K): If
assigning a new professional affiliation in the
tenant using Maintain Professional Affiliations
task, enter value here. This action is the
same as checking the box labeled If you
can’t find affiliation, click here when manually
assigning an affiliation.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 471

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it displays 1. Confirm that you’ve populated the row ids in
that the data wasn’t loaded columns E and G.
2. Confirm that the business process completed
successfully: it might still be in progress. If it's
still in progress, mass cancel the events. Then
change processing instructions to automatic
processing and relaunch EIB.

EIB issues an error like this: Check the Role column and confirm that you’re
specifying the correct reference ID type based on
Validation error occurred. Invalid ID value.
the type of person you’re assigning the professional
'21001' is not a valid ID value for type =
affiliation to. Example: If assigning to an employee,
'Academic_Affiliate_ID'
change cell C4 from Academic_Affiliate_ID to
Employee_ID.

EIB issues an error like this: Verify that you've specified the correct
reference ID type for the Affiliation value
Validation error occurred. Invalid ID value.
in row J. Most likely, cell J4 needs to
'PROFESSIONAL_AFFILIATION_xxxx' is not a
change from Job_History_Company_ID to
valid ID value for type = 'Job_History_Company_ID'
Professional_Affiliation_ID.

Unable to launch the EIB This issue is most likely security-related. Refer to
the EIB Input File Guidelines section above.

Business Processes
Manage Professional Affiliations.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, and remove professional affiliation assignments.
• If you’ve inadvertently uploaded incorrect entries, use task Mass Cancel Business Processes or
Mass Rescind Business Processes. What you use depends on whether the business process event
is complete or in progress. You can select Business Processes Loaded by EIB to find the integration
event that you wish to cancel or rescind. Your other option is to enter Manage Professional Affiliations
at the Business Process Types prompt and enter a date range that you ran the EIB.
For reference documentation for all web services including Manage Professional Affiliations, see Operation
Directory.

Sample EIB Input File


Manage_Professional_Affiliations-WD37_0

Concept: Put Talent Pool EIB

Background
You can use this EIB to add or update talent pools and membership information.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 472

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Create Talent Pool
• Create Private Talent Pool
• Edit Talent Pool
• On the Find Workers report, you can use the Add to Pool button.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Set Up: Talent
domain in the Talent Pipeline functional area
to run this EIB

Configure the EIB to Generate with Data This EIB has a Generate Spreadsheet with Data
option. To use it:
• From the related actions of your EIB, select
Template Model > View.
• Click Edit Template with Data Options.
• Select Condition Rule Filter in the Filter
section.
• Build the rule conditions. Example: if you want to
return all data, select a rule such as Name is not
blank.
• Generate a spreadsheet template and select the
Generate Spreadsheet with Data check box.
• You can now view the template populated with
all the existing talent pools.
• See Customize EIB Spreadsheet Template
for more details on generating spreadsheet
templates:

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 473

• It’s very important to test in a non-Production


tenant before running the EIB in Production for
these reasons:
• This EIB doesn’t use a business process
event. Thus, you can't cancel or rescind you
make an error.
• If you don't properly populate the EIB input
file, it might create a talent pool for each
entry. And you can't remove the talent pools.
• Note that there’s currently a 5,000-member limit
for static talent pools. So, if you have more than
5,000 members, you will need to break it up into
two or more talent pools.
• As you populate these fields in the EIB input file,
consider:
• Spreadsheet Key: The best practice is to
use the same value for all entries for a given
pool, as it will provide optimum performance.
However, if you're troubleshooting an error,
you might want to assign a separate value
to each spreadsheet key as this will help
you identify the specific entry that is causing
the error. Refer to the sample spreadsheets
as there’s an example for using a single
spreadsheet key value compared to multiple
spreadsheet key values for a talent pool.
• Add Only: If you're only adding new entries,
you can set this value to Y.
• Static Talent Pool: Don’t populate this field.
• Replace All: Set to Y if you want to remove
all the existing memberships and replace with
the memberships in the EIB input file.
• ID: If you're making modifications to an
existing Talent Pool, then use this field to
populate the reference id of the talent pool.
To find the reference id, you can run the
Talent Pools report and then from related
actions of the talent pool, select Integration
IDs > View IDs. Note that if you're creating a
new talent pool, you can either leave this field
blank, or enter an unused value.
• Name: Name of the Talent Pool. Workday
requires this field.
• Row ID: Specify a unique row id value for
each worker that you're assigning to the pool.
• Delete: Enter Y to remove a worker from the
pool.
• Worker: Enter the employee id. If you're
updating contingent workers, change cell
N4 to Contingent_Worker_ID. If you're
loading both employees and contingent
workers, you might want to configure the
Separate Type Column option so you
can load both types of workers using the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 474

same EIB input file. See Future: Concept:


Change Emergency Contacts EIB for more
details about configuration the separate type
column. Note: it's for another EIB but still
applicable.

Common Issues and Errors

Issue Cause and Solution

The EIB successfully completes, however it has This issue will occur if you didn’t populate the
created a separate talent pool for each entry in the reference id of the talent pool, in column F. To
EIB input file resolve this issue:
• Bring up the talent pool that you're attempting to
update.
• From related actions, select Integration IDs >
View IDs to get the reference id value.
• Place the value from the above step in column F
• Note that there isn't a way to delete the talent
pools that the EIB inadvertently created. But you
can inactivate and rename them. Refer to the
section below, on how to recover from a bad
load, for instructions.

The EIB successfully completes however it didn't Check to ensure:


load the employees to the talent pool.
• Make certain you didn't run the EIB in validation
mode.
• Chances are that the EIB did add the members,
but it might have created another talent pool and
added the members there. This will happen if
you don't have the correct reference id value in
column F. Check Talent Pools report to see if
the EIB added a duplicate Talent Pool. If this is
what happened, see the above issue for details
on how to address the issue.
• Make certain you're updating a static pool. This
EIB won't load members to pools with dynamic
membership.

Unable to launch the EIB When running report View Security for Securable
Items, you'll see that you need Put access to
domain security policy Set Up: Talent to run
this EIB for Put Talent Pool. Add the access and
activate the change. Then retest.

EIB fails with an error such as: Validate that the employee_id is correct. Also, if
it's a continent worker, the EIB input file needs to
Validation error occurred. Invalid ID value. '21081'
specify Contingent_Worker_ID in cell N4
is not a valid ID value for type = 'Employee_ID'.

Poor performance You might experience slow performance if using a


different spreadsheet key value for each entry in
the EIB input file. Use the same spreadsheet key
value for all entries for a given talent pool.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 475

Issue Cause and Solution

EIB fails with error: Be sure to populate a name value in column G


Validation error occurred. Element Content 'Name'
is required, on internal element 'Talent Pool Data'.

EIB fails with error: This issue is a security-related error. Make certain
you have unconstrained security access to the
Validation error occurred. The entered information
EIB. Also, verify you have access to the worker
does not meet the restrictions defined for this field.
(they might be in an organization that has restricted
(Worker_Reference).
access). If the above doesn’t help, try manually
assigning the worker to a pool: this might result in
an error that yields more clues as to the cause of
the problem.

Use Cases and Guidelines for Recovering from a Bad Load


• This EIB enables you to create and update talent pool and membership information. You can’t remove
talent pools.
• Since the EIB doesn't use a business process, there's no option to rescind or cancel. There are a few
options to review in the event that you've inadvertently loaded incorrect data
• If you inadvertently created talent pools that you're not going to use, there's no option to delete them.
However, you can inactivate the pools as follows:
• Use the Generate Spreadsheet with Data option to populate the existing talent pools in the EIB
input file.
• Edit the EIB file created by the above step and remove all the entries for all talent pools except
the ones you want to inactivate.
• Set the Inactive flag to Y for the entries in the EIB input file.
• You might also want to add z_DNU to the beginning of the Pool Name so that it's obvious not to
use the entries and they display at the bottom of the list when viewing talent pool reports.
• Now run the EIB.
• If you've inadvertently assigned the wrong members to the pool, you can:
• Edit the EIB input file and set Replace All to Y.
• Then add the members who you want to assign to the Pool.
• Note that if you want to get the pool members back to what they were before the EIB load, you
can go to another tenant where the proper memberships are still intact and use the Generate
Spreadsheet with Data option to build the EIB file. You can then use that EIB file to reload the
previous memberships to production.
• For reference documentation for all web services including Put Talent Pool, see Operation Directory.

Sample EIB Input Files


Put_Talent_Pool-WD33-Example1
Put_Talent_Pool-WD33-Example2

Tenant Data Translation EIBs


Concept: Put Translatable Tenant Data Public EIB

Background
You can use this EIB to add or update translatable data.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 476

This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Business Object Translations.
• Translations Hub. See Concept: Translations for more information.
• See Translation > Translate Instance on the related actions of the object that you want to translate.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Data
Translation domain in the System functional
area to run this EIB.

Guidelines for Modifying the EIB Template • From the related actions of your EIB, select
Template Model > View.
• On the left, click Translated Value for
Instance....
• On the right, locate the row with Instance* label
and click the magnifying glass.
• From the related actions of the Instance* row,
select Template Model Column > Edit Details.
• Remove the value WID from the Reference ID
Type field and select the Reference ID Type as
Separate Column check box.

Configure the EIB to Generate with Data • From the related actions of your EIB, select
Template Model > View.
• Click Edit Template with Data Options.
• Select Reference ID Filter in the Filter section.
• Enter the Workday ID(also known as WID)
values of 1 or more classes that you want to
translate. You can get these values from the
custom report. Note: Currently there aren't
any other filtering options, other than classes.
Therefore, you can't select just 1 targe language
for example.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 477

• Regenerate the EIB and select the Generate


Spreadsheet with Data check box.
• The spreadsheet that generates display data
first by User Language, then by other attributes.
There isn't a way to control how the information
gets sorted.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• We suggest you create a custom report, using
All Translatable Tenant Data report data
source to help identify the class and Workday
ID (also known as WID) needed to populate the
EIB input file. This custom report will also help in
configuring the EIB to generate with data.
• To prevent data loss, we recommend that you
generate your spreadsheet with data for the Put
Translatable Tenant Data Public EIB. See:
Example: Generate EIB Spreadsheet Template
with Data on page 62.
• As you populate the EIB input file, consider:
• Spreadsheet Key: Specify a unique value for
each combination of User Language, Class
Name, and Name.
• Row ID (column C): Set value to 1.
• User Language: Enter the reference
ID for the Target language that you’re
translating to. You can identify the value by
manually initiating a translation (Example:
use Business Object Translations). Then
from related actions of the language, select
Integration IDs -> View IDs.
• Class Name: If you generate the
spreadsheet with data, the Class Name
values will populate in the EIB input file. You
can also check the report in the Guidelines
for Creating a Custom Report for the EIB
Input File section above to identify the values
for this field.
• Name: If you generate the spreadsheet with
data, the values will populate in the EIB input
file. Another way to identify the values is to
manually initiate a translation. (Example: Use
Business Object Translations). Then check
the Attribute column for values that are you
wish to use.
• Namespace URI: Leave this field blank.
• Row ID: (Column H): Increment the value for
each entry for a given spreadsheet key value.
• Instance: See the Guidelines for Modifying
the EIB Template section above for
information on splitting the column so that

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 478

there’s column for ID Type and ID Value.


Then enter the reference ID type and
value for the object that you're translating.
Example: For job profile, the ID Type would
be Job_Profile_ID and ID Value would be the
reference ID value of the job profile you’re
translating. To populate these values, you
can use the reference ids report and enter
the business object (Example: Job Profile)
that you’re translating.
• Parent ID: There’s typically no need to
populate this field.
• Base Value: The base value for a plain text
field. The field is display only and the web
service ignores it. (If you need to add or
update base values, you need to edit the
actual object. Example: Edit Job Profile).
• Translated Value: if you’re translating a plain
text value, enter it here.
• Rich Base: The base value for a rich text
field. The field is display only and the web
service ignores this field. If you need to add
or update base values, you need to edit the
actual object. Example: Edit Job Profile.
• Translated Rich Value if you’re translating
a rich text value, place the value here. Note:
the web service performs some high-level
validation checks of any html tags used within
the value. However, it doesn’t perform a
complete validation as there are many ways
to construct html. There would be significant
overhead in attempting to validate that the
html markup abides by what the Workday
rich text editor permits. For this reason, it’s
very important to ensure that you’re using
proper html markup in the EIB input file. In
addition, note that when you load an invalid
html markup, Workday won't detect it until
you edit the instance where the markup is
present. At that time, Workday’s rich text
editor will identify the issue and might alter
the text when attempting to correct the html
markup. So, after editing the instance for the
first time, the appearance of the field might
change.
• Effective Date Enter the effective date of the
translation.

Common Issues and Errors

Issue Cause and Solution

Even though the EIB completes successfully, A few different scenarios can cause this situation:
Workday didn't update some of the data.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 479

Issue Cause and Solution


1. The base values in the EIB input file don’t get
loaded as they’re display-only fields. If you want
to update the base values, you must do it in the
object. Example: For job profiles, you need to
update the job profile.
2. This situation will also occur if you’re loading a
translated value for an item that currently has
no base value. Example: If a job profile has no
value for Job Description, then you can’t add a
translated value for the Job Description.
3. Make certain that you’re specifying an effective
date in the EIB input file that is after the effective
date of the item you’re translating. Example: If
a job profile has an effective date of 1/1/2020,
load the translation with an effective date after
1/1/2020.
If the above doesn’t explain why the data remained
unchanged, try manually adding a translation
for 1 of the values that the EIB didn’t update to
determine if it’s allowed. This task might provide
some clues as to what is going wrong.

This error displays when you attempt to generate This issue will occur if you don’t have the security
the spreadsheet with data: needed to access the translation data. You can:
Integration Failed. 1. Edit the domain security policy for Data
com.capeclear.mediation.MediationException: Translation.
application=assemblyGenerateSpreadsheetE2 - 2. Make certain you're in a security group that has
Error code: 1 The following error occurred when Put access.
getting data for the template: Processing error 3. Activate the Security Change.
occurred. The task submitted isn’t authorized. See
the consolidated report for further details.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new translation values or update existing translation values. You
can’t delete entries.
• If you have inadvertently uploaded incorrect entries, there isn’t an option to remove them. Instead, you
should run the EIB again with the corrected translation values. If you’ve accidentally added a translation
for a language that you didn’t intend to translate, you could edit the EIB input file and copy and paste
the value of the base language into the translation value.
For reference documentation for all web services including Put Translatable Data, see Operation Directory.

Sample EIB Input File


Put_Translatable_Tenant_Data_Public-WD34

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 480

Time Tracking EIBs


Concept: Assign Work Schedule EIB

Background
You can use this EIB to assign work schedule assignments to workers. You can assign predefined work
schedule calendars or create work schedule calendar assignments based on patterns specific to a worker.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


The equivalent task in Workday depends on your configuration. Examples of equivalent Workday tasks
include:
• Assign Work Schedule
• Assign Custom Work Schedule
You can also use the Import Ad Hoc Schedules web service to load large batches of schedule blocks
(Example: 1000 or more) on an infrequent basis. Example: you could use it to import schedules from a
third-party scheduling vendor into Workday Time Tracking.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Assign
Work Schedule business process type in
the Time off and Leave, Time Tracking and
Workday Scheduling functional areas to run
this EIB.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files. Additionally, as you populate the EIB input
file, consider:
• Spreadsheet Key: Specify a unique value for
each worker’s assignment.
• Worker: Specify the reference ID of the person.
Change the reference ID type value in cell C4
from Contingent_Worker_ID to Employee_ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 481

if you want to enter employees instead of


contingent workers.
• Start Date and End Date: Use format YYYY-
MM-DD.
• Work Schedule Calendar: If you want to assign
a predefined work schedule calendar, specify it
here. You can find a list of reference ID values
by running the View Reference IDs report and
searching for the Work Schedule Calendar
business object.
• Only populate these fields if you want to create a
worker-specific pattern schedule:
• Number of Weeks: Specify the number of
weeks for the work schedule calendar.
• Row ID: (Column H): You can use this field
to group days of the week together as a
schedule pattern and assign them a row
ID value. Example: if the worker’s start
and end time is 8am-5pm for Monday to
Thursday, then group the Monday, Tuesday,
Wednesday, and Thursday entries together
under row ID 1. If the worker starts and ends
at 9am-12pm on Friday, add another entry
with row ID 2.
• Week Number: Specify the relevant week
number.
• Day of the Week: You can find a list
of reference ID values by running the
Integration IDs report and searching for the
Day of the Week business object.
• Start Time and End Time: Use
format HH:MM.
• Row ID: (Column O): Specify a unique value
for each lunch break for a given start and end
time.
• Meal In and Meal Out: Use format HH:MM.

Common Issues and Errors

Issue Cause and Solution

Although the EIB completes successfully, it seems Check and address these issues:
that the data wasn’t loaded.
• Check the status of the business process event.
If it’s still in progress, consider mass canceling
all in-progress events, making any needed
changes to the EIB and rerunning it.
• Check if a worker has multiple work schedules
that affect the same date. Workday prioritizes

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 482

Issue Cause and Solution


the changes in this order to determine the
schedule for that date:
1. Changes that the worker's manager makes
using the My Team's Schedule report.
2. One-time changes that the worker makes.
3. Recurring changes that the worker makes.
4. New work schedule calendar assignments.
5. Workers' default work schedule calendar
assignments and any changes an
administrator makes to those calendars.
Refer to the work schedule calendar assignment
precedence .
If multiple assignments contain overlapping
dates, Workday prioritizes the most recent
assignment. If the most recent assignment has
an end date, Workday prioritizes the most recent
assignment without an end date.

EIB fails with this message: Verify that the reference ID type in cell C4 is
correct. Change the reference ID type value in cell
Validation error occurred. Invalid ID value.
C4 from Contingent_Worker_ID to Employee_ID if
'21289' isn’t a valid ID value for type =
you want to enter employees instead of contingent
'Contingent_Worker_ID'
workers.

EIB issues with this error: Check these issues:


The entered information doesn’t meet • Verify that the worker isn’t terminated.
the restrictions defined for this field. • Verify that you have unconstrained access to
(Worker_Reference). the Assign Work Schedule business process
type in the Time off and Leave, Time Tracking
and Workday Scheduling functional areas.

Unable to launch the EIB This is most likely security-related.


Verify you have the correct security
configuration. Ensure that you are in the relevant
security group and have access to the Assign
Work Schedule business process type in the
Time off and Leave, Time Tracking and Workday
Scheduling functional areas.

Business Processes
Assign Work Schedule.

Use Cases and Guidelines for Recovering from a Bad Load


This EIB only enables you to add new work schedules.
If you’ve uploaded incorrect entries, you can use either the Mass Cancel Business Processes task (if the
event is still in progress) or Mass Rescind Business Processes task (if the event is complete). Both of
these tasks are secured to the Business Process Administrator domain in the System functional area. You
can then select Business Processes Loaded by EIB to find the integration event that you want to cancel

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 483

or rescind. Alternatively, you can enter Assign Work Schedule in the Business Process Types prompt
and enter the date range that corresponds to when you ran the EIB.
For reference documentation for all web services including Assign Work Schedule, see Operation
Directory.

Sample EIB Input File


Assign_Work_Schedule-v38

Concept: Import Ad Hoc Schedules EIB

Background
You can use this EIB to load large batches of schedule blocks on an infrequent basis. For more details,
see: Concept: Importing Work Schedules.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


My Team’s Schedule

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Worker Data:
Work Schedule domain in the Time Tracking
functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files.
• Header Key: This web service is an Import
web service, which means it batches the
schedule entries into jobs and processes the
jobs asynchronously. The header key tells the
web service which entries to batch together in
each job. All entries with the same header key
value will batch into 1 job. We recommend you
batch together 1,000 schedule entries per job
(tip: test in your nonproduction tenant first). In

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 484

this case, the first 1,000 entries would have a


header key value 1, the next 1,000 entries would
have header key value 2, and so on.
• The first tab of the input file lists the header
key values that you're using. If you have
<1,000 entries, there will be 1 entry with
value 1. If you have ~2,000 entries, you’ll
have 2 entries. See screenshot below for
reference.
• Line Key: This value should be unique for each
schedule entry (within a header key).
• Ad Hoc Schedule ID: Populate this field even if
you're adding new entries. Each schedule entry
needs to have a unique value. To make each
value unique, consider appending the employee
ID, date, and an incremental number.
• Employee: Enter the value for the employee
or contingent worker ID. If populating values
for employee IDs, change the reference ID
type (located in row 4 of the input file) from
Contingent_Worker_ID toEmployee_ID. If you're
updating schedules for both employees and
contingent workers, split the columns using
the Separate Type Column field (as described
in Customize EIB Spreadsheet Template).
By splitting the columns, you can list both
employees and contingent workers in the same
input file.
• Position ID: If an employee has multiple
positions, populate the position ID. Otherwise,
you can leave this field blank.
• Schedule Start Date Time and Schedule End
Date Time: base these dates and times on the
worker's local time zone.
• Meal ID: If supplying a meal ID, the value needs
to be unique.

Common Issues and Errors

Issue Cause and Solution

The EIB issues the Time Entry Code cannot be Check the default time entry code for the time entry
Hours Only error. template that the employee is using. The code
should bein/out only instead of hours only.

The EIB issues the xxxx: Worker xxxx(99999) must There are 2 causes for this error:
be active on the Schedule Start Date error.
• The employee isn’t active on the start date that
you specified in the input file.
• Worker isn’t Time Tracking Eligible or you don't
have the Time Tracking SKU. Time Tracking
Eligible requires these conditions, which you can

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 485

Issue Cause and Solution


check in the View Worker's Time Eligibility
report:
• Work Schedule Calendar
• Period Schedule
• Time Entry Template

After running the EIB, you’re unable to edit or Workday doesn't enable you to perform this action.
add new events using the user interface. When Imported schedules take precedence over any
attempting to add events for a date that the EIB other schedule in Workday. After you update the
updated, Workday returns this error: schedule using the EIB, you have read-only access
to that information in the user interface. If you try to
You cannot update your work schedule for YYYY-
add or edit events for a date that the EIB updated,
MM-DD because there is an existing imported
you’ll receive the error.
schedule change. Please review the dates for your
schedule change. To resolve this issue, either:
• Use the EIB to make your adjustments.
• Rerun the EIB and delete the entries that you
previously updated. After deleting the entries,
you can make the adjustments in the Workday
user interface.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to add, update, or delete schedule entries.
If you have inadvertently uploaded incorrect entries, you can reload the same EIB input file. Set the Delete
flag to Y to undo the entries and revert back to the original schedule.
For reference documentation for all web services including Import Ad Hoc Schedules, see Operation
Directory.

Sample EIB Input File


Import_Ad_Hoc_Schedules-WD31

Concept: Import Reported Time Blocks EIB

Background
You can use this EIB to load large batches of time blocks. Example: Holiday time blocks.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Enter Time for Worker.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 486

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Process: Import
Time Blocks domain in the Time Tracking
and Time Tracking Hub functional areas to
run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider
• Spreadsheet Key: Specify a unique value for
each time block
• Worker: The EIB requires this value. Most likely
you’ll need to change the reference ID in row 4
from Contingent_Worker_ID to Employee_ID
• Worker Time Block: Enter a value here only
if you’re updating or deleting an existing time
block. To identify the reference ID value, you
might find it helpful to make a copy of standard
report Time Block Audit, then add field
Reference ID (the field you need to populate in
the Worker Time Block field). You might also
want to add field Is Deleted to the report.
• ID: Enter a value here if adding a new time block
and you want to assign the reference ID value.
If you leave it blank, Workday will autoassign a
reference ID value.
• Delete Time Block: Enter Y if you need to
delete an existing time block. Note that you’ll
also need to specify a Worker Time Block
value for the time block you wish to delete.
• In Date Time and Out Date Time: Keep in mind
that when populating In Date Time and Out
Date Time, Workday is assuming the times are
in PT. You might find it preferable to populate

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 487

the input file using a UTC offset to correctly load


the time zone for each time block.
Examples showing the UTC format:
• Oct 25 at 8:00am CET is
2021-10-25T08:00:00+02:00
• Oct 25 at 8:15am EST is:
2021-10-25T08:15:00-05:00
• Oct 25 at 8:15am EDT is
2021-10-25T08:15:00-04:00

Common Issues and Errors

Issue Cause and Solution

Even though the EIB successfully finishes, some This error can occur for multiple reasons.
time block entries are missing.
1. This EIB is an import web service that processes
the data asynchronously. Therefore, even
though the EIB Integration Event has completed,
the background job might still be running. So
you might need to give it more time to complete.
This error could occur if you haven't configured
the EIB business process in your tenant.
a. Use task Create Business Process Definition
b. Search for business process type Reported
Time Batch Event. If it comes up, it indicates
that you haven't yet configured it in your
tenant so go ahead and create it. You’ll also
need to configure the business process
security policy with the appropriate security
groups then activate the changes
2. Lastly, note that if you submit the same request
multiple times, the EIB ignores it: that is, if the
time block already exists, the EIB won’t reload it.

My EIB input file looks different than the attached This web service underwent major changes starting
sample: it has 2 worksheets. with v36.2. Create a new EIB to make certain
you’re using v36.2 or higher.

The Time Block Entries are taking hours to display This error will occur if you’re using an EIB older
up in the tenant. than v36.2 and you’ve assigned a separate header
key value to each time block entry.
Example: You upload 1,000 time blocks and assign
each time block a different header key value. The
result is that Workday creates 1,000 background
jobs, thus they queue up and take a long time to
process. There’s no easy way to recover from this
scenario, other than wait for all the jobs to complete
their processing.

EIB issues the error: . This issue can occur when the reference id type
is Contingent Worker instead of Employee ID. If
you’re attempting to add time blocks for employees,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 488

Issue Cause and Solution


Invalid ID value. 'xxxxx' isn’t a valid ID value for check the value in cell D4 and make certain it’s
type = 'Contingent_Worker_ID' Employee_ID.

The Worker Time Block and Delete Time Block Workday introduced these fields in Workday 32. If
fields aren’t in the EIB input file. you don’t see the fields, create a new EIB (which
will use the latest web service version available in
your tenant), then regenerate your template.

EIB issues an error such as: This web service doesn’t automatically pull in
related worktags; you must specify the related
These related worktag types are required: ABC
worktags in the EIB input file.

EIB issues an error like this when updating an When updating a time block that specifies in and
existing time block: out times, also populate the Out Reason in the EIB
input file.
Out type is not valid for the ~worker~, Logan
McNeil (Mgr 4000), for the date 2020 05 08.

EIB issues an error like this when attempting to You need to enter a time entry code ID and a
import project time for a worker: project task ID ONLY. Don't add the project code as
well.
[worker] cannot use the project, [project], to report
the time on [date].

The time blocks load with a Not Submitted status. This result is expected behavior. If you need to
mass submit the unsubmitted time blocks loaded
using the web service, you can use the Mass
Submit Time Task. (If the Enter Time business
process includes an approval step, then the tasks
also need approved).
You can also use the Auto Submit Time task to
create schedules to submit time automatically when
you don’t want to create separate schedules to
mass submit time for each period.

Business Processes
Reported Time Batch Event.

Use Cases and Guidelines for Recovering from a Bad Load


This web service enables you to Add, Update, and Delete time blocks. Note that Workday added the
Delete and Edit features with Workday 32. If you need to edit or delete, make certain your EIB integration
is using version v32, or higher (tip: create a new EIB to pick up the latest web service version).
If you have inadvertently uploaded incorrect entries, 1 option would be to use the Mass Rescind task.
You’ll find the entries you uploaded by searching for business process Reported Time Batch Event for the
period of time the EIB entries. To view the batch event associated with a worker, make a copy of the report
Time Block Audit, then add the field Batch Events.
For reference documentation for all web services including Import Reported Time Blocks, see Operation
Directory.

Sample EIB Input File


Import_Reported_Time_Blocks-v39

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 489

Concept: Import Time Clock Events EIB

Background
You can use this EIB to load large batches of time clock events (Example: 1,000 or more) on an infrequent
basis.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Time and Leave > Add Time Clock Event from the related actions of the worker's profile.
If you want to load smaller batches of time clock events (Example: less than 150) on a frequent basis,
consider using the Put Time Clock Events EIB.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by:
1. From the related actions of the EIB, select
Template Model > View.
2. On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
3. If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Process:
Time Clock Integration domain in the Time
Tracking functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• Header Key: The time clock events load
in batches and the header key indicates
the batch number. We suggest adding at
least 1,000 time clocks per batch (test in
a nonproduction tenant to determine what
works best for you). The first 1,000+ rows
in your EIB input file would use header key
value 1. The next 1,000+ entries would use
spreadsheet key value 2, and so on.
• Line Key: if there are multiple time clock
events for the same worker, then the line key

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 490

needs to be unique for each of those time


clock events.
• Time Clock Event ID: Workday assigns this
unique ID to each time clock event. When
adding new time clocks, you can leave the
field blank (or assign another unique value). If
updating or deleting an existing time clock, be
sure to populate the time clock event ID for
the existing time clock.
• There’s a report definition below, that you
can use to identify the Time Clock Event IDs:
See section Details about Add/Update/Delete
Capabilities for this EIB and how to recover
from Bad Load.
• Time Clock Event Date Time: See FAQ:
Time Entry for details on how Workday
handles time zones.
• Time Entry Code: The out punch doesn't
have a time entry code associated with it.
When you load the out punch, the value
doesn’t need populated.

Common Issues and Errors

Issue Cause and Solution

The EIB has completed successfully, however, the If you see this behavior, remember that Workday
time clocks aren’t visible initially loads and saves the time clocks with a
status of Unprocessed.
Although the EIB completed, it might not have
processed all the entries. Normally, the EIB
immediately processes the first batch of time clock
events when the EIB loads the time clocks. The
first batch would be the time clock entries with
header key value 1. There’s a background job
called TCE Sweeper that runs every 15 minutes
to look for unprocessed entries. This sweeper
processes just 1 batch at a time. If you have
multiple header key values in the input file, the
sweeper immediately processes the entries
with header key value 1 .The TCE Sweeper job
processes the entries with value 2 when it runs
15 minutes later. The TCE Sweeper runs again
in 15 minutes and processes the entries with
spreadsheet key value 3, and so on.
This delay is why it’s important to load at least
1,000 time clocks per batch (or header key value).
If you have a separate header key assigned to each
time clock event, then it will take a very long time
for the processing to complete. Below are some
tools that you can use to monitor the loading of the
time clock events:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 491

Issue Cause and Solution


• Report Unprocessed Time Clock Events: If
you see the entries here, it tells us they loaded
but haven’t processed yet.
• Task Maintain Invalid Time Clock Events: This
task will identify if there are any errors for the
time clock events you loaded.
• You could also create a custom report from data
source All Time Clock Events that checks the
TCE Status and use it to monitor the load.

Some time clock events are loading as unmatched Suggestions to avoid unmatched time clock events:
• Submit the time punches in chronological order
from oldest to newest
• If loading multiple check-ins at the same time
for the same worker, then follow every Check-in
with a Check-Out
• Try to avoid matching IN and OUT timestamps
(example Check-out for worker at 12:34pm and
then Check-in for break at 12:34pm. Instead,
use a check in of 12:34:01 if possible)
• Verify that you're not loading time clock events
to a locked or closed period: if you need to load
time clocks to locked period, EIB user needs Put
access to domain Time Tracking: Exempt from
Lockout.

EIB didn't load Worktags even Be aware that:


though they’re present in the EIB input file.
• Worktag won’t populate for Out time clock
events. This rule applies for both the web
service and the user interface. Both In and Out
events must have the same worktag values.
• If you’re populating Worktag data for an In-
time clock event and it doesn’t load, then check
if the entry process completed or if there was a
validation error. See issue EIB has completed
successfully, however the time clocks aren’t
visible for more information.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, and delete time clocks.
• If you have inadvertently uploaded incorrect entries, you can either:
• Reload the input file and set Delete Time Clock Event to Y. You’ll need to be sure to populate the
Time Clock Event ID values to delete the entries.
• Or you can reload the file and update the existing entries to correct them.You’ll need to be sure to
populate the Time Clock Event ID values to update the entries.
For reference documentation for all web services including Import Time Clock Events, see Operation
Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 492

Sample EIB Input File


Import_Time_Clock_Events-WD32

Concept: Put Time Clock Events EIB

Background
You can use this EIB to add time clock events from a third party vendor.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


See Time and Leave > Add Time Clock Event from the related actions of the worker's profile.
If you want to load batches of more than 1,000 time clock events on an infrequent basis, use the Import
Time Clock Events EIB.

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Process:
Time Clock Integration domain in the Time
Tracking functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. Additionally, as you
populate the EIB input file, consider:
• As you populate the EIB input file, consider:
• Spreadsheet Key: Note that Workday loads
the time clock events in batches and the
spreadsheet key indicates the batch number.
We suggest adding a maximum of 150 time
clocks per batch (test in a nonproduction
tenant to determine what works best for you).
So, the first 150 rows in your input file would
use spreadsheet key value 1. The next 150

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 493

entries would use spreadsheet key value 2,


and so on.
• Row ID: If there are multiple time clock
events for the same worker, then the row ID
must be unique for each of those time clock
events.
• Time Clock Event ID: A unique ID assigned
to each time clock event. If adding new time
clocks, you can leave this field blank, or
assign a unique value. If updating or deleting
an existing time clock, be sure to populate
the time clock event ID for the existing time
clock.
• Time Clock Event Date Time: See FAQ:
Time Entry for details on how Workday
handles time zones.
• Time Entry Code: Note that the out punch
doesn't have a time entry code associated
with it. So, when you load the out punch, the
value doesn’t need populated.

Common Issues and Errors


Web services Put Time Clock Events and Import Time Clock Events are very similar and issue the
same type of error messages. See Concept: Import Time Clock Events EIB on page 489 for information
on the issues and errors for both of the web services.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, and delete time clocks.
• If you have inadvertently uploaded incorrect entries, you can either:
• Reload the input file and set Delete Time Clock Event toY. You'll also need to be sure to populate
the Time Clock Event ID values for the entries you wish to delete.
• Or reload the file and update the existing entries to correct them. You'll also need to be sure to
populate the Time Clock Event ID values for the entries you wish to update.
For reference documentation for all web services including Put Time Clock Events, see Operation
Directory.

Sample EIB Input File


Put_Time_Clock_Events-WD30

Concept: Put Time Requests EIB

Background
You can use this EIB to load large batches of time requests. For more information on time requests, see
Concept: Time Requests.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Click New Request from the Time Requests or My Team's Time Requests report.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 494

EIB Input File Guidelines

Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB:
• From the related actions, select Template
Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Process: Import
Time Requests domain in the Time Tracking
functional area to run this EIB.

Additional Input File Guidelines • We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page
54, which provides a general overview for
populating EIB files. As you populate the EIB
input file, consider:
• Spreadsheet Key: Specify a unique value for
each worker's time request.
• User Time Request Block: Only enter
a value if you’re updating or deleting an
existing time request.
• ID: If you're adding a new time block and
want to assign the reference ID value, enter
a value. If you leave this field blank, Workday
will autoassign a reference ID value.
• Worker: Specify the reference ID of the
person.
• Time Request Code: Specify the time
request code for the request.
• Delete Time Request: Enter Y if you need
to delete an existing time request. Note
that you’ll also need to specify a User Time
Request Block for the time request you want
to delete.
• Start Date and End Date: Use format YYYY-
MM-DD.
• Start Time and End Time: Use format
HH:MM.
• Total Hours: Use positive whole or partial
numbers.
• Comment: Specify a comment to add context
to the time request.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 495

• Additionally, as you populate the EIB input file,


consider:
• IDs are evaluated in the order on the input
file. If the same ID is used in multiple places
in the file, the first instance creates the time
request, and the second updates it.
• Custom IDs aren’t supported for in/out
requests that span multiple days, even
though they're created through 1 submission.
After submission, Workday handles them as
individual time requests.

Common Issues and Errors

Issue Cause and Solution

The EIB issues the Specify a time request code that The worker isn't eligible for the specified time
the worker is eligible for during the specified date request code in the specified date range. Specify a
range error. time request code for which the worker is eligible.

The EIB issues the Specify an end date that is after The end date is before the start date.
or the same as the start date error.

The EIB issues the Specify either the total hours There are values in the Total Hours field, and both
or both the start and end times of the time request the Start Time and End Time fields of the time
error. request. Specify either a number of total hours, or
both start and end times.

The EIB issues an error such as The [Worktag Specify a valid worktag for the specified time
Type] is not available on [name] Time Request request code.
Code .

The EIB issues an error such as The [Worktag Specify a worktag for the specified time request
Type] is required on [name] Time Request Code . code.

The EIB issues an error such as The [name] Time The entry method for the specified time request
Request Code does not support start and end code is Hours Only. Specify a number of total hours
times. instead of start and end times.

The EIB issues an error such as The [name] Time The entry method for the specified time request
Request Code does not support hours. code is In/Out Only. Specify both start and end
times instead of total hours.

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add, update, and delete time requests.
• If you have inadvertently uploaded incorrect entries, you can either:
• Reload the input file and set Delete Time Requests to Y. You'll also need to specify values for the
entries you want to delete in the Time Requests ID field .
• Reload the file and update the existing entries to correct them. You'll also need to specify values for
the entries you want to update in the Time Requests ID field.
For reference documentation for all web services, including Put Time Requests, see Operation Directory.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 496

Sample EIB Input File


Put_Time_Requests-v45

Workday Connect EIBs


Concept: Submit Connect Campaign EIB

Background
You can use this EIB to create or update a campaign and related items and reminders.
This topic provides details on how to fill out the spreadsheet template for this EIB. To use this topic, you
must create this EIB in your tenant, then generate a spreadsheet from that EIB.

Equivalent Workday Task


Task: Create Campaign.

EIB Input File Guidelines


Web Service Version and Security Configuration • Workday recommends using the latest web
Guidelines service version for your EIB. You can check the
version of your EIB by
• From related actions of the EIB, select
Template Model > View.
• On the View Template Model page, check
the Version field to verify you’re using the
latest web service version.
• If you're using an older web service version,
you can create a new EIB to get the latest
version.
• Verify you have the correct security
configuration.
• You must have access to the Submit Connect
Campaign business process in the System
functional area to run this EIB.
• If you're using the Generate Spreadsheet
with Data functionality, you’ll also need Get
access to the Administer Campaigns domain
in the Learning Core functional area.

Guidelines for Modifying the EIB Template This EIB has a Generate Spreadsheet with
Data option, which is helpful if you’re not sure
how to populate the EIB input file. This option is
also handy if editing existing campaigns so that
you can prepopulate all existing data. Before
using the Generate Spreadsheet with Data option,
we suggest you modify the template so that the
template generation properly populates the content
field and audience field:
• From the related actions of your EIB, select
Template Model > View.
• On the left, click Campaign Item Data+.
• Locate the Content row.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 497

• From the related actions of the magnifying


glass next to Content, select Template Model
Column > Edit Details.
• Select the Reference ID Type as Separate
Column check box.
• Click OK.
• View the EIB template again and:
• Click Connect Campaign Data.
• In right pane, locate Audience.
• From the related actions of the magnifying
glass select Template Model Column > Edit
Details.
• Change the reference id type to what is
appropriate for your organization. Most likely
you’ll want to change it from App Audience ID
to Audience ID.

Additional Input File Guidelines We recommend that you review Concept: EIB
Spreadsheet Data Entry Guidelines on page 54,
which provides a general overview for populating
EIB files.
To prevent data loss, we recommend that you
generate your spreadsheet with data for the Submit
Connect Campaign EIB. See: Example: Generate
EIB Spreadsheet Template with Data on page
62.
• There’s a Generate Spreadsheet with
Data option for this EIB, which helps determine
the fields that you need to populate and the
reference ID values that you can use:
• If you’re adding new campaigns, you can
start by manually creating a campaign, like
the campaigns you’re loading. Then complete
the steps in the Guidelines for Modifying the
EIB Template section so you can see how
the EIB input file populates.
• If updating existing campaigns, complete
the guidelines above to get all existing
information for the campaign. Then make any
necessary modifications. Note that the web
service does a Replace All so it's important to
populate all existing information.
• Additional details for some of the fields.
• Spreadsheet Key: Specify a unique value for
each Campaign
• Connect Campaign: If updating existing
campaign, enter the reference ID here. The
Generate with Data tool doesn’t populate
this field. To find the value, you can create a

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 498

custom report from data source campaigns


and include report field Reference ID Value.
• Campaign Title: Enter the desired title for
your campaign
• Campaign Type: To find reference ID value
for campaign type, run the Integration IDs
report and search business object Connect
Campaign Type.
• Campaign Category: If you want to enter a
campaign category, run theIntegration IDs
report and search business objectCampaign
Category (All) to get a list of the campaign
categories and their corresponding reference
ID values.
• Audience: Most likely, you’ll want to
change the reference ID type in cell G4 from
App_Audience_ID to Audience_ID. To find
the ID, run the Integration IDs report and
search business object Connect Audience
(Framework).
• Content Type: To find reference ID value
for Content Type, run the Integration IDs
report and search business object Connect
Campaign Item Type.
• Row ID (Section Campaign Item Data
+): Enter a unique row ID value for each
Campaign Item.
• Campaign Item: If updating existing
campaign item, enter the reference ID
here. To find the reference ID value, run
the Integration IDs report and search
business object Connect Campaign Step.
• Campaign Item Title: Enter desired
Campaign Item Title.
• Content: We recommend that you
configure Reference ID type as a
Separate Column option for this field.
See Guidelines for Modifying the EIB
Template section. After modifying the
template, you’ll have 2 columns in your
EIB input file, for Content. Enter the
reference ID type in the first column and
reference ID value in the second column.
Refer to attached Sample EIB Input file for
examples.
• Channels: To find reference ID value for
channels, run the Integration IDs report
and search business object Notification
Channel Group.
• Message Template: If you want to supply
a message template, run the Integration
IDs report and search for the Message
Template business object to get a list of

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Enterprise Interface Builder (EIB) | 499

the templates and their corresponding


reference ID values.
• Row ID (Section Campaign Item Reminder
Data): Enter a unique row ID value for each
Reminder.

Common Issues and Errors

Issue Cause and Solution

When attempting to generate a spreadsheet with This issue can occur if there are campaigns in your
data, it fails with an error like this: tenant that you've saved but haven't submitted. Add
a condition to your filter to check Campaign Event
Integration Failed.
is Not Empty.
com.capeclear.mediation.MediationException:
application=assemblyGenerateSpreadsheetE2 -
Error code: 1 The following error occurred when
getting data for the template: Validation error
occurred. The entered information does not meet
the restrictions defined for this field.

When attempting to generate spreadsheet with This issue is most likely security-related. See
data, it fails with error: Additional Input File Guidelines section.
Processing error occurred. The task submitted is
not authorized.

Unable to launch the EIB. This issue is most likely security-related. See
Additional Input File Guidelines section.

Even though the EIB completed successfully, it The EIB only submits the campaign event. Launch
didn't assign users the campaign items. the campaign event to assign the items.

EIB fails with error, when loading campaigns with In some situations, such as when configuring
reminders: reminders, you must include text forEmail Subject
and Body fields in the EIB input file. Use the
You must configure Email Configuration Data to
Generate Spreadsheet with Data functionality to
use Email as a channel.
help populate this information.

EIB fails with error: This issue occurs if the audience category doesn’t
match the Campaign Category entered in the EIB
Validation error occurred. Audience is not valid for
input file. Run Edit Audience task to check the
Category and Type
category for Audience. Then verify that the EIB
input file uses the same value.

After updating an existing Campaign, some of the Perform a Replace All when updating campaigns.
campaign items are missing Use the Generate Spreadsheet with Data option
so that EIB input file has all existing data.
If you inadvertently lost information, rescind the
campaign event that the EIB updated to restore
data.

Business Processes
Campaign Event.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 500

Use Cases and Guidelines for Recovering from a Bad Load


• This web service enables you to add new campaigns or update existing campaigns.
• If you’ve inadvertently uploaded incorrect entries, use task Mass Cancel Business Processes or
Mass Rescind Business Processes. What you use depends on whether the business process event
is complete or in progress. This web service doesn’t allow you to specify the EIB event when canceling
or rescinding. Instead, select Campaign Event at the Business Process Types prompt and enter a date
range that you ran the EIB.
For reference documentation for all web services including Submit Connect Campaign, see Operation
Directory.

Sample EIB Input File


Submit_Connect_Campaign-v37_1

Getting Started with Workday Connectors

Browse Connector Templates

Prerequisites
Security: Integration Build and Integration Reports domains in the Integration functional area.

Context
To determine which Connector templates best meet your needs, use the Integration Template Catalog
report. The report displays a complete list of Connector templates delivered by Workday. The report
doesn't display deprecated or retired templates.

Steps
1. Access the Integration Template Catalog report.
2. (Optional) To view details about the services, attributes, and maps associated with a template in the list,
select View Details for that template.

Concept: Workday Connectors


Workday Connectors are prebuilt integration templates that extend Workday functionality to external
endpoints for Human Capital Management (HCM), Payroll, Payroll Interface, Financial Management, and
Student. Workday hosts and maintains all integrations.
Workday provides 2 types of Connectors:
• End-to-end Connectors support a specific named third-party application or service. When you deploy a
Connector, the Connector supports the third-party application with no additional coding required.
• Connectors are prebuilt integrations that address most of the integration effort required to connect to
third-party end points. These integrations import and export data in a Workday-defined file format.
Note: All Connectors require some level of tenant configuration and testing. Each customer can have
specific mapping requirements and different endpoint configurations. Workday integration templates and
mapping capabilities can accommodate these differences in customer configurations.
Each integration template provides a framework for Workday to communicate with an external endpoint.
Each integration template contains a set of integration services, comprised of integration attributes and

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 501

maps, that define specific connection points. To reduce complexity, many integration templates have
factory settings for common definitions and requirements.
Workday Connectors are currently available for:
• Benefits
• HCM
• Workday Payroll
• Third-Party Payroll
• Financials
• Student

Audit Reports and Extracts


Workday commonly attaches audit reports to integration events that provide additional details about the
integration. Audit reports support human use only and can aid in the troubleshooting of failures and data.
Output, format, and accessibility are subject to change at any time. Never use audit files within Integration
processing or logic.

Reference: Benefits Connectors Catalog


Workday supports and maintains the connectors to meet the required file formats and specifications of
each benefit provider. For any worker enrolled in a Workday HCM benefit plan, Workday sends the HCM
indicative data for the benefit provider, as well as any changes in benefit enrollments. Benefits Connectors
enable you to integrate with a wide range of benefit providers in these categories:
• Medical
• Dental
• Vision
• Life and Disability
• Flexible Spending Accounts
• COBRA Administration
• Retirement Savings
The Workday Community lists offerings in each category at https://community-content.workday.com/
content/workday-community/en-us/reference/products/human-capital-management/cloud-connect-for-
benefits/ccb-products.html.
Workday also provides a generic Benefits Connector to enable you to create a benefits integration to
a vendor not supported by our catalog. It gives you the tools to export a benefits-related subset of HR,
compensation, and benefits deduction data to the benefits provider of your choice. Benefits Connector
provides:
• A configurable output file
• A choice of change detection options
• Flexible launch parameters
• Built-in audit reports

Reference: Financials Connectors Catalog


Connector Description
Accounting Journal Connector Imports accounting journal data from external
endpoints into Workday. This integration requires

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 502

Connector Description
transformation of accounting journal data into a
Workday-defined format.
Ad Hoc Bank Transaction Connector Imports ad hoc bank transaction data from external
endpoints into Workday. This integration requires
transformation of bank transaction data into a
Workday-defined format.
AMEX Remittance Generates and exports American Express
Remittance files from the credit card secure
environment.
Bank Fee Statement Connectors Imports bank fee statements from your financial
institutions for analysis and reporting purposes in
these formats:
• ASC X12 EDI 822
• ISO 20022 camt.86 V1
• ISO 20022 camt.86 V2
• Workday-defined XML format.

Bank Statement Load Integrations Imports bank statements of any type into Workday.
For formats other than BAI2, BTRS, ISO 20022,
and MT940/942, requires transformation of bank
statement files into a Workday-defined format.
Currency Exchange Rate Connector This integration can import currency exchange
rates into Workday. Files must be in a Workday-
defined file format.
Customer Credit Card Payments Connects Workday to CyberSource for
authorization and processing of payments for
customer credit cards.
Customer Payment Lockbox Imports Bank Administration Institute (BAI)
lockbox data files into Workday. Files must be in a
Workday-defined file format.
DAS2 Integration Generates DAS2 audit files from accounting entries
to present to French tax authorities.
EDI Supplier Integrations Exchanges data with external suppliers in American
Standards Committee (ASC) EDI X12 810, 850,
855, and 856 formats.
Electronic Payments Connects Workday to the financial institution that
your company uses for inbound and outbound
payment processing.
Electronic Invoice Connector Exports electronic invoicing data in XML format.
Expense Credit Card Transactions Imports credit card data into Workday for use in
expense reports. Workday provides integration
templates for these formats:
• American Express
• Citibank Commercial Format (CCF for VISA and
MasterCard)
• Bank of America VISA credit card transactions

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 503

Connector Description
• MasterCard Common Data Format 3 (CDF3
Release 15_01_00_00) credit cards and credit
card transactions
• Visa Commercial Data Format 4.4 R1 (VCF4.4)
credit cards and credit card transactions.

FEC Integration Generates FEC audit files from accounting entries


to present to French tax authorities.
Financial Management Connector for Salesforce Exchanges sales data between Salesforce.com
and Workday. Download this app from the
Salesforce.com AppExchange.
GoBD Integration Generates audit files that you can submit to
German tax authorities in compliance with GoBD
tax regulations.
Inventory Label Data Integrations These integrations export inventory label data in a
Workday-defined file format for use by an external
label printing service or application.
Payment Acknowledgment This integration can import payment
acknowledgment files in ISO 20022 format so that
you can:
• View payment status.
• Complete successful payments.
• Cancel or reprocess rejected payments.

SAF-T Integrations Generates audit files that you can submit to tax
authorities in compliance with OECD SAF-T
requirements.
Supplier Punchout Connects Workday to external suppliers for
procurement.
Tax ID Integration Checks the validity of tax IDs using the European
VAT Information Exchange System (VIES) external
service.
Third-Party Payments Integration Generates audit files containing information about
payments and payees. This integration enables you
to create declarations of payments to third parties
and submit them to tax authorities.
Travel Booking Inbound Connector Imports travel booking records from your third-
party travel providers into Workday. This integration
gives you a unified view of corporate travel booking
records from your third-party travel providers
against your actual expense report.

Reference: HCM Connectors Catalog


Connector Description
Account Provisioning Integration Sends worker profiles and provisioning group
assignments to an account provisioning application.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 504

Connector Description
This integration exports data in System for Cross-
domain Identity Management (SCIM) file format.
Account Provisioning Connector Sends worker profiles and provisioning group
assignments to an account provisioning application.
This integration exports data in Workday XML
format.
Affordable Care Act (ACA) Connectors Connects Workday to the Internal Revenue Service
(IRS). Enables you to submit IRS Form 1094-C and
1095-C data for the Affordable Care Act.
AngelPoints Connects Workday to AngelPoints. Enables you to
create, modify, and delete accounts in AngelPoints
as worker status changes in Workday.
Assign Organizations Inbound Connector Imports organization assignment data from an
external server into Workday.
Core Connector: Background Check Order Inbound Imports information for background checks on a
person from an external server.
Core Connector: Background Check Order Exports requests for background checks on a
Outbound person to an external server.
Core Connector: Competency Model Detects new and changed competency model data
and produces a configurable output file in XML
format.
Core Connector: Job Postings Detects new and changed job postings produces a
configurable output file in XML format.
Core Connector: Job Profile and Job Family Detects new and changed job profile and job family
data and produces a configurable output file in XML
format.
Core Connector: Job Requisitions Detects new and changed job requisitions and job
requisition data and produces a configurable output
file in XML format.
Core Connector: Location Detects new and changed location data and
produces a configurable output file in XML format.
Core Connector: Organization Detects new and changed organization data and
produces a configurable output file in XML format.
Core Connector: Positions Detects new and changed position data and
produces a configurable output file in XML format.
Core Connector: Worker Detects changes to a worker and produces
a configurable output file in XML format or a
nonconfigurable file in CSV (Comma-Separated
Value) format.
Core Connector: Worker for LMS Outbound Detects new and changed worker, job, location,
Integration organization, and talent data. Produces a
configurable output file in XML format for export to
a Learning Management System (LMS).
Directory Service Connects Workday to LDAP and Active Directory
servers.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 505

Connector Description
E-Verify Integration Connects Workday to the E-Verify service
provided by the United States Citizenship and
Immigration Services (USCIS). Enables you to
verify employment eligibility for your employees and
applicants.
Inline Assessment Connects Workday to third-party assessment
vendors for registering candidates that have applied
for a job using an external career site.
Kenexa Connector Exports organization, location, job profile, and job
family data from Workday to Kenexa. Requires that
you use Job Management staffing model.
Kronos Workforce Timekeeper Outbound Exports worker data from Workday to Kronos
Workforce Timekeeper.
Medicare Integrations Sends and receives coordination of benefits
request and response files from the Centers for
Medicare & Medicaid Services (CMS). Files can
include data for active and retired employees and
their dependents.
Okta Integration Sends event-based notifications of employee
changes directly to your Okta tenant.
Organization Inbound Connector Imports new, changed, and inactivated organization
data from an external application.
Salesforce.com Chatter Integration Posts events from Workday to Salesforce.com
Chatter.
Salesforce.com Worker Sync Connects Workday to Salesforce.com for account
provisioning.
Skillsoft Integration Imports licensed courseware from Skillsoft into
your learning catalog in Workday as external digital
courses.
Social Security Number Verification Service Generates data file for upload to Social Security
Integration Number Verification Service. Enables you to
verify that your employee names and Social
Security numbers (SSN) match Social Security
Administration records.
Talent Profile Inbound Connector Imports updates to certifications, competencies,
and completed trainings for one or more workers.
Unistaff Connectors Exchanges data between Workday and Unistaff,
enabling your organization to align with data privacy
requirements for the Russian Federation. Supports:
• Export of Workday foundation data.
• Import of new hires and personal information
updates for workers.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 506

Reference: Student Connectors Catalog


Connector Description
Education Test Result Inbound Connector Imports test results in a Workday-defined XML
format. Use this connector to import results for
See Student Admissions Connectors.
education tests not supported by other Student
Admissions connectors.
National Student Clearinghouse Connectors Sends enrollment, degree, and graduation data to
the National Student Clearinghouse (NSC).
SPEEDE External Transcript Inbound Imports student transcripts from the NSC
Standardization of Postsecondary Education
See Student Admissions Connectors.
Electronic Data Exchange (SPEEDE) service.
Student Admissions Connectors Imports test results for these education tests:
• ACT (formerly American College Testing)
• Advanced Placement (AP).
• Graduate Management Admission Test (GMAT).
• Graduate Record Examination (GRE).
• Postsecondary Education Readiness Test
(PERT).
• SAT (formerly Scholastic Assessment Test).
• Test of English as a Foreign Language
(TOEFL).
Note: Workday provides a separate integration
template for each test. Each template supports only
1 test.

Student Financial Aid Connectors Imports and exports transaction data for these
formats:
• Alternative Loan Applications.
• Common Origination and Disbursement (COD).
• Institutional Student Information Reports (ISIRs).
• Transfer Student Monitoring (TSM) and
Financial Aid History (FAH).

Student Financials Connectors Sends payment and refund data to cashnet


merchants.
Student Outbound Connector Exports data for students with changes in their
status and profile information in a Workday-defined
XML format.
Student Records Connectors Exports transcript data in a Workday-defined XML
format.
Student Recruiting Connectors Imports student prospects from the ACT Enroll
student search service.
Student Transaction Log Outbound Connector Monitors your tenant for Student-related
transactions that meet specified transaction type,
effective date, and entry date criteria. Exports

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 507

Connector Description
an XML file with transaction records for these
transactions from Workday.
The Common Application Inbound Integration Imports a subset of first-year student applicant data
from The Common Application.

Reference: Third-Party Payroll Connectors Catalog


Connector Description
Payroll Effective Change Interface Exports payroll-related subset of HR,
compensation, and benefits deduction data. The
connector exports the data in XML format with
effective dates in the sequence that they occurred.
You can transform the XML into a format supported
by your payroll provider.
Worker Effective Change Interface Captures a full stack of worker data changes within
an effective range. The connector exports the
data in an XML format text file and includes data
changes related to corrections, rescinds, indirect,
retroactive, and future-dated transactions.
Payroll Interface Exports payroll-related subset of HR,
compensation, and benefits deduction data. The
connector exports the data in XML format. You can
transform the XML into a format supported by your
payroll provider.
External Payroll Results Inbound Imports data generated by an external payroll
endpoint to payroll results.
Import External Payslips Imports employee payslips from an external payroll
endpoint.
External Payroll Documents Imports external payslips, external tax documents,
and other external payroll documents into Workday.

Reference: Workday Payroll Connectors Catalog


Connector Description
ADP Check Print Exports Workday payroll and payslip data to ADP,
enabling you to outsource printing of checks and
pay advices.
Ceridian Check Print Service Exports Workday payroll and payslip data to
Ceridian, enabling you to outsource printing of
checks and pay advices, or to outsource full
banking services.
Check Printing Connector Connects Workday to regional banks that don't
use the Ceridian check printing format. The Check

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Getting Started with Workday Connectors | 508

Connector Description
Printing Connector enables you to customize output
for the requirements of a specific bank.
Electronic Income Withholding Order Integrations Connects Workday to the Federal Office of Child
Support Enforcement (OCSE) web portal for
exchange of Electronic Income Withholding Order
records and acknowledgments.
Electronic Payments Connects Workday to your company bank or
financial institution for inbound and outbound
payment processing.
HM Revenue & Customs Incoming Notifications Connects Workday to HM Revenue & Customs
Data Provisioning Service (DPS) to receive:
• P6/P6B and P9 tax notifications
• SL1 and SL2 student loan notifications

HM Revenue & Customs RTI Integration Connects Workday to HM Revenue & Customs
Real Time Information (RTI) to send Full Payment
Submission (FPS) files.
HM Revenue & Customs RTI Employer Payment Connects Workday to HM Revenue & Customs
Summary Integration Real Time Information (RTI) to send Employer
Payment Summary (EPS) files.
Payment Acknowledgment Imports payment acknowledgments in ISO 20022
format so that you can view payment status,
complete successful payments, and cancel or
reprocess rejected payments.
Payment Connector Connects Workday to your company bank
or financial institution for outbound payment
processing.
Payroll Journal Outbound Connector Exports journal entries, include payroll accounting
details, from Workday to an external endpoint.
Service Canada ROE Generates ROE (Record of Employment) files
for manual upload to Employment and Social
Development Canada (ESDC), and imports ROE
status files generated by Service Canada into
Workday.
Tax Filing (Canada T4, T4A, RL-1, RL-2) Generates T4, T4A, RL-1, or RL-2 files for manual
upload to the Canadian Revenue Agency or the
Revenue Quebec Agency.
Tax Filing (USA) Exports periodic, quarterly, and annual tax data
from Workday Payroll to ADP or Ceridian.
Time Off Inbound and Payroll Input Connectors Connects Workday to external time and attendance
tracking applications, such as Kronos Workforce
Timekeeper.
UK Civil Service Pension Files Generates data files for manual upload to the Civil
Service pension scheme administrator.
Worker Time Block Inbound Connector Imports time block data generated by an external
time and attendance application into Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 509

Connector Description
Worksite Reporting Generates MWR (Multiple Worksite Record) files
for upload to the Bureau of Labor Statistics, United
States Department of Labor.

Benefits Connectors

Setup Considerations: Cloud Connect for Benefits


You can use this topic to help make decisions when planning your configuration and use of Cloud Connect
for Benefits (CCB). It explains:
• Why to set it up.
• How it fits into the rest of Workday.
• Downstream impacts and cross-product interactions.
• Security requirements and business process configurations.
• Questions and limitations to consider before implementation.
Refer to detailed task instructions for full configuration details.

What It Is
Cloud Connect for Benefits is a collection of prebuilt integrations to benefit providers across a range of
categories, including:
• Medical, Dental, Vision.
• Life and Disability.
• Flexible Spending Accounts and Health Savings Accounts.
• COBRA Administration.
• Retirement Savings (Outbound and Inbound).
• Medical Underwriting Decisions (inbound).
Cloud Connect for Benefits also supports integrations for additional benefit plans. Examples: Employee
assistance programs, commuter benefits, or long-term care.

Business Benefits
Cloud Connect for Benefits enables you to exchange benefits-related data between Workday and benefit
providers.

Use Cases
With Cloud Connect for Benefits, you can:
• Select an integration template specific to your vendor and product.
• Configure integration service attributes to control integration behavior.
• Map data from Workday to the format that the vendor supports.
• Define a schedule for integration runs.
• Exchange data securely with vendors using different network transport protocols.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 510

Questions to Consider

Question Considerations
Does Workday provide a Cloud Connect for • To see if Workday supports your vendor/product
Benefits integration template that supports your combination, search the CCB Providers or CCB
vendor/product combination? Products pages on Workday Community.
• If your provider supports the ANSI X12N 834
file format, use the generic ANSI X12 834 V2
template.

Are your vendors based in the US? Most CCB integrations are for US-based vendors.
Workday supports these Canadian providers:
• Great West.
• ManuLife.
• Standard Life Assurance.
• Sun Life.

Recommendations
• Consider engaging with professional services when implementing Cloud Connect for Benefits
integrations.
• Start your implementation well in advance of your open enrollment period. For many CCB providers,
Workday might not hear about changes to vendor file formats until you start your implementation. Try to
test early so that Workday can make necessary changes to a template in time for your go-live date.
• Before setting up your integration test environment, work with your benefits functional partner to ensure
that integrations can support your plan setup.
• Plan out the number and type of test cycles that the benefits provider requires before certifying your
integration. Work with your benefits provider to determine how many test cycles they require.
• Consider using the generic Benefits Connector integration if these conditions are true:
• Workday doesn't provide a template that supports your vendor/product combination.
• Workday doesn't plan to develop a template that supports your vendor/product combination.

Requirements
Subscribe to the Cloud Connect for Benefits SKU.

Limitations
Actual contribution amounts are only available to Cloud Connect for Benefits integrations from Workday
Payroll. If you use a third-party payroll provider, benefit integrations send estimated amounts based on the
benefit plan setup.

Tenant Setup
No impact.

Security
Enable security for these domains to configure Cloud Connect for Benefits integrations.
• Integration Build
• Integration Configure
Enable security for these domains for Cloud Connect for Benefits integrations to access Workday data:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 511

Security Domain Required for Products


Change Retirement Savings (Business Process) Retirement Savings Inbound.
Integration Event • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Person Data: Citizenship Status Outbound.


Person Data: Date of Birth Outbound.
Person Data: Date of Death Outbound.
Person Data: Gender Outbound.
Person Data: ID Information • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Person Data: Marital Status Outbound.


Reports: Pay Calculation Results for Worker Outbound.
(Results)
Worker Data: Beneficiaries and Dependents Outbound only.
Worker Data: Benefit Elections • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Worker Data: Benefits • Evidence of Insurability (EOI) Inbound.


• Retirement Savings Inbound.

Worker Data: Compensation by Organization Outbound.


Worker Data: Court Order Details Outbound.
Worker Data: Current Staffing Information Outbound.
Worker Data: Payroll (Payroll Input) Retirement Savings Inbound.
Worker Data: Payroll Interface (Payroll Input by Retirement Savings Inbound.
Worker)
Worker Data: Public Worker Reports • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Business Processes
You can use the Integration Process Event business process to manage how your integrations run.

Reporting

Report Description
All Integration Systems View all integrations that you've created.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 512

Report Description
View Integration System View an integration that you've created. You can
then edit a specific integration that you locate with
this report.
Integration Events Displays:
• A summary of integration events that are in
process or completed.
• Details about the status for each integration
event.

Connections and Touchpoints

Features Considerations
Benefits Cloud Connect for Benefits integrations send and
receive benefits data to and from vendors.
HCM Core Cloud Connect for Benefits integrations send
worker data to vendors.
Payroll If you use Workday Payroll, outbound Cloud
Connect for Benefits integrations send actual
contribution amounts.

Workday offers a Touchpoints Kit with resources to help you understand configuration relationships in your
tenant. Learn more about the Workday Touchpoints Kit on Workday Community.

Getting Started with Cloud Connect for Benefits

Concept: Cloud Connect for Benefits


Cloud Connect for Benefits (CCB) is a collection of prebuilt integrations to benefit providers across a
range of categories. You can configure an integration using attributes, maps, and overrides. Data then
flows to your benefit providers based on a predefined schedule that incorporates benefit life events. You
can use any CCB provider-specific integration, or the Benefits Connector, an integration template with a
configurable set of HCM data across a range of categories.
Workday delivers information to providers in their preferred format by supporting:
• Industry standards such as ANSI ASC X12N 834 (version 5010) and LIMRA Data Exchange (LDEx)
formats.
• Proprietary file formats.
• Text file with comma-delimited fields.
• Text file with pipe-delimited fields.
• Text file with fixed-width fields.
• XML.
Text files are UTF-8 encoded rather than using ANSI encoding.
Workday maintains data security throughout the transmission process by using data encryption and secure
transport protocols. If provider specifications change, Workday updates the integration to meet the new
requirements.
View the current Cloud Connect for Benefits catalog: https://community.workday.com/node/141741.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 513

Each integration has a template associated with it that contains services, attributes, maps, and overrides.
You create an integration system using the specific integration template. You’re then able to configure:
• Optional services.
• Field attributes to select specific data elements to be reported on the file for these templates: BC, ANSI,
and LDEx.
• Integration attributes for data that are the same for everyone reported on the file
• Maps to translate Workday tenanted values to what the provider needs to see
• Overrides for items that might not be stored in discrete fields in Workday or for accessing calculated
fields
The integration takes care of all data fields that are the same for all customers and implementations. The
integration hides attributes with a default value because it shouldn't override the value.

Sent and Retrieved Data


The information that Workday passes to or receives from benefit providers depends on:
• The type of benefits available to workers.
• The requirements for each provider.
Examples:

Medical, Dental, Vision • Subscriber data.


• Enrollment data.
• Dependent information.
• Eligibility data.

Life and Disability • Subscriber data.


• Enrollment data.
• Compensation data.
• Coverage information.
• Beneficiary information.

Flexible Spending Accounts and Health Savings • Subscriber data.


Accounts • Enrollment data.
• Contribution amounts.
• Goal amounts.

COBRA Administration • Subscriber data.


• Termination data.
• Data for persons newly enrolled in COBRA-
eligible plan.

Retirement Savings (outbound) • Subscriber data.


• Enrollment data.
• Contribution amounts.

Retirement Savings (inbound) • Changes to contribution elections.


• Loan data. Workday Payroll uses data from
inbound integrations to maintain deductions.

Medical Underwriting Decisions (inbound) Statuses (approved or denied) and the decision
date.
Additional Benefit Plans
• Employee assistance programs.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 514

• Commuter benefits.
• Long-term care.

Contribution Amounts
Workday Payroll can send contribution amounts to providers of defined contribution plans and flexible
spending account plans (HSA, spending accounts, commuter, and retirement savings).

Goal Amounts
Workday sends goal amounts to flexible spending account plan administrators to ensure that claims don’t
exceed annual plan contributions.
The integration uses values from benefit elections for the workers and the effective date used to launch the
integration. The integration relies on what is in the Benefits data and performs no calculations.
Related Information
Tasks
Include Payroll Balances in Benefits Integration on page 521
Reference
The Next Level: Benefits Integrations

Concept: Planning a Benefit Provider Integration


Each Cloud Connect for Benefits integration requires initial configuration to tailor the way that it maps and
delivers data to a benefit provider. You can arrange configuration through Workday Professional Services
or any certified Workday Services Partner.
Note: Schedule plenty of time before your next open enrollment for configuring and testing your
integrations. If you change benefit providers, your timeline is longer. The timeline varies depending on
whether your benefit provider is already in the Cloud Connect for Benefits catalog or a new addition.
These sections describe the prerequisites and implementation process to help you plan a new benefit
provider integration. Most of these activities happen in parallel with your Workday HCM implementation.

Before You Begin


Verify the quality of your data to shorten your implementation cycle. If you start with clean data, you
encounter fewer problems.

Implementation Process
Workday provides a set of templates as the starting point for all Cloud Connect for Benefits integrations.
To simplify initial configuration as well as ongoing maintenance, the templates have some delivered values
and prompts for data in Workday.
Related Information
Tasks
Set Up Test Environment for Benefits Integration on page 520

Concept: Cloud Connect for Benefits Integration Templates


Workday provides a template for each Cloud Connect for Benefits integration to enable configuration of
customer-specific values.
• Attributes are available for data elements that pertain to everyone on the file.
• Maps are used to translate internal Workday values to external vendor values. Workday provides
enumerations in a drop-down list, where possible. Drop-down lists streamline implementation, reduce
configuration errors, and simplify ongoing maintenance.
• Overrides provide an even more powerful way to configure what Workday sends to your provider.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 515

Related Information
Tasks
Change Benefit Provider Integration Maps on page 522

Concept: Cloud Connect for Benefits Field Overrides


Field overrides are a flexible tool to customize integration systems that use a Workday integration
template. Each Workday template provides a standard framework for integration system creation and
configuration. Field overrides give you an additional way to control data sent on the file, including use of
custom or calculated fields.
Overrides give you the ability to use report fields or calculated fields to supply the values that your benefit
provider requires. Example: To match a class structure or division in your provider environment, you can
create calculated fields to concatenate multiple values in Workday. You can use overrides along with
attributes and maps.

Concept: Inbound Cloud Connect for Benefits Integrations


Cloud Connect for Benefits supports 2 types of inbound integrations:
• Retirement Savings
• Evidence of Insurability (EOI) Underwriting Decisions
Depending on the inbound data and product, the integration updates data in Workday in different ways:
• Retirement Savings, Loans: Workday creates new payroll input records.
• Retirement Savings, Deferrals: Workday creates retirement savings benefits change events.
• EOI Underwriting Decisions:
• Workday updates decision status and date of decision.
• Workday supports Approved and Denied statuses only.
• You can configure the integration to leave open or close EOI Underwriting Decisions with a status
that Workday doesn't support. Future updates to closed EOI Underwriting Decisions require manual
processing.

Processing for Third-Party Payroll


Workday creates payroll input records for loan changes.
Workday doesn't process deferral changes as direct payroll input. Workday updates elections with benefit
events.
You can view payroll inputs for third-party payroll in the External Payroll Input Finder report. You can
view inputs for a specific worker in the Maintain External Payroll Input for Worker task. You can also
use the related action off a worker under Pay to view inputs.
There's no indicator on the payroll input for ongoing deductions for third-party payroll. Workday displays
these deductions without an end date.
Related Information
Concepts
FAQ: Benefit Provider Integration Common Issues on page 530
Tasks
Manage External Payroll Input for Worker on page 1350

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 516

Create Benefit Provider Integration

Steps: Set Up Benefit Provider Integration

Prerequisites
Request a file specification from your benefit provider so that you can familiarize yourself with their data
requirements.

Context
Set up an integration system using a template in the Cloud Connect for Benefits Template Category that
sends employee benefits data to a benefit provider.

Steps
1. Create Integration System on page 1854.
In the New Using Template prompt, select the Cloud Connect for Benefits category, then select
the template for your benefit provider. Some benefit providers have multiple integration templates
for different products. Make sure that you select the correct template. The template names have this
format: WBN - [Provider Name]: [Product].
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to the applicable
domains:

Security Domain Required for Products


Change Retirement Savings (Business Process) Retirement Savings Inbound.
Integration Event • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Person Data: Citizenship Status Outbound.


Person Data: Date of Birth Outbound.
Person Data: Date of Death Outbound.
Person Data: Gender Outbound.
Person Data: ID Information • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Person Data: Marital Status Outbound.


Reports: Pay Calculation Results for Worker Outbound.
(Results)
Worker Data: Beneficiaries and Dependents Outbound.
Worker Data: Benefit Elections • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Worker Data: Benefits • Evidence of Insurability (EOI) Inbound.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 517

Security Domain Required for Products


• Retirement Savings Inbound.

Worker Data: Compensation by Organization Outbound.


Worker Data: Court Order Details Outbound.
Worker Data: Current Staffing Information Outbound.
Worker Data: Dependent National IDs Outbound (Dental, Medical, Vision only).
Worker Data: Payroll (Payroll Input) Retirement Savings Inbound.
Worker Data: Payroll Interface (Payroll Input by Retirement Savings Inbound.
Worker)
Worker Data: Public Worker Reports • Evidence of Insurability (EOI) Inbound.
• Outbound.
• Retirement Savings Inbound.

Worker Data: Workers Outbound. Use for contextual security only. See
the Get_Workers Contextual Security section
of Concept: Get Workers SOAP Web Service
Guidelines and Troubleshooting.

See: Steps: Grant Integration or External Endpoint Access to Workday.


3. Set Up Attributes and Maps in Benefits Integration on page 517.
4. Set Up Integration Field Overrides for a Connector on page 1860.
Related Information
Concepts
Concept: Cloud Connect for Benefits Integration Templates on page 514
Concept: Planning a Benefit Provider Integration on page 514

Set Up Attributes and Maps in Benefits Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
After you create a benefit provider integration, configure the integration attributes and maps to specify
values for the output file.
• Integration attributes identify what benefit plans to include in the integration. Integration attributes also
provide customer-specific values for data elements.
• Integration maps define relationships between values in Workday and codes in the external endpoint.

Steps
1. Access the View Integration System report.
2. As a related action on the integration system, select Integration System > Configure Integration
Attributes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 518

3. Specify values for the attributes in the Integration Attributes grid:


• For attributes without automatically populated values, add a row and specify a Value.
• For attributes whose automatically populated values you want to change, or attributes that have a
comment in the Value field, select the Override Template Values check box. Then specify a new
Value.
• Optionally specify that a value applies to a particular environment using the Restricted to
Environment field.
Look at each attribute Description for guidance on how to configure the appropriate values. If
necessary, request the correct values from your benefit provider.
4. Save your changes, then as a related action on the integration system, select Integration System >
Configure Integration Maps.
5. In the Integration Maps grid, specify how to map Workday data to the output file:
a) Add a row for each value from your tenant, select an Internal Value at the prompt, then select the
corresponding External Value.
You can map more than 1 Internal Value to each External Value, but you can’t map the same
Internal Value to more than 1 External Value. The External Value prompt displays the valid values
for your provider based on their file specification. You can view a description of each value from its
related actions menu.
b) (Optional) Provide a Default Value for any data element that doesn't have mapped values.
Each map Description identifies the corresponding position in the file. Workday requires every map;
don’t leave any map blank or Workday sends data from your tenant data to the output file, which results
in an error.
6. Click OK to save your changes.

Example
These tables display sample values for the attributes and maps in the WBN - HIPAA 834 Health Insurance
(v2) integration service:

Attribute Value
Carrier Output HIPAA 834 EDI Yes
Interchange Sender ID 76-0689535
Application Sender Code 472243
Master Policy Number 98675
Plan Sponsor Name Global Modern Services, Inc.
Sponsor ID 2458538
Provider Entity Relationship Code 25

Map Automatically Internal Value External Value


Populated Value
Coverage Level Code IND EE+1 Dependent ECH
EE+Family FAM
EE Employee Only EMP
Enrollment Relationship 53 Child 03
Domestic Partner 04
Spouse 01

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 519

Map Automatically Internal Value External Value


Populated Value
Gender U Female F
Male M
Health Care PDG HMO HLT
Classification
Indemnity HLT
PPO HLT
Position Time Type Full-time FT
Part-time PT

Next Steps
If the integration system has a field override service, configure the override values.

Set Up Field Overrides in Benefits Integration

Prerequisites
Determine if your integration system has field overrides. Access the View Integration System
report and look for either of these field override documents for Version 1 of the ANSI X12 834 template:
• WBN - HIPAA 834: Medical, Dental, Vision, Insurance - Field Override
• WBN - HIPAA 834: Medical, Dental, Vision, Insurance - Coverage Level Field Override
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
A field override service gives you greater flexibility to map data to 834 elements. Each benefit provider has
a unique set of fields that enable override values based on the provider implementation of the 834 format.
You can use calculated fields or report fields to provide values for these fields, which often require a class
structure or division. Cloud Connect for Benefits uses the Data Initialization Service (DIS) to manage field
overrides. See Steps: Set Up Data Initialization Service (DIS) Integration on page 563.
With some integration services you can create parameters at multiple levels, depending on what you
need to send to your benefits provider. The integration uses parameters to extract data from Workday,
optionally with calculated fields, and store data for later use. Where you create these parameters dictates
how you can use them downstream. You can create parameters globally (for the entire integration event)
or at the document level (worker, dependent, or benefit election, or benefit plan). You can use parameters
downstream in other parameters or in calculated fields.
Consider:
• Dated field overrides only accept values with a date data type. The DIS framework validates the values
and an error is produced if there is a non-date value or null.
• Loop 2300 in the 834 is for plan-level data. You can now create a calculated field to return different
values based on plan rather than based on worker (non-DIS).

Steps
1. Access the View Integration System report and select your integration system from the Cloud
Connect for Benefits prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 520

2. As a related action on the integration system, select Integration System > Configure Integration
Field Overrides.
The Configure Integration Field Overrides grid displays the integration service and the field
overrides. Depending on the service that you select, you might see Parameters, which you can expand
to view the field overrides.
3. To understand what values your provider expects, review the list of fields against the file specification
for your provider.
4. For each field, click the Override External Field prompt to select a calculated field or report field that
provides the appropriate value.
The selection list only contains fields related to the business object shown in uses Business Object as
Class.
5. If any fields have a Prompt - Text override, specify the Value Type and Value for the field.
6. When you’re finished, click OK to save your changes.
Related Information
Concepts
Concept: Calculated Fields

Test and Manage Benefit Provider Integration

Set Up Test Environment for Benefits Integration

Prerequisites
Before setting up your integration test environment, make sure that you configured the benefits part of
your Workday test environment correctly. Your integration won't cause some errors that you can encounter
when testing your integration, especially benefits elections not appearing on the output file. Instead, not
configuring electronic signatures correctly, or by not finalizing benefits open enrollment before running the
integration causes errors.
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
You can test our tenant sandbox integrations by associating different attribute values with your sandbox
and production environments. Example: You can test an integration to validate data after you modify
benefit plans or you modify integration maps. Testing is also useful during open enrollment.
Another option is to switch to test mode, which limits each integration event to 500 records. By working
with a subset of data, you can view the integration results faster to validate your mappings and setup.
Workday recreates tenant sandboxes with each update. If you configure integration attributes in your
sandbox environment, copy these values to your production environment to ensure that they aren't
overwritten in the next update.

Steps
1. Access the View Integration System report.
2. Select an integration system at the prompt.
3. As a related action on the integration system, click Integration System > Configure Integration
Attributes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 521

4. For each attribute that you want to configure:


a) Add a row in the Attribute Value(s) column.
b) In the Value field, specify the value that you want to use for testing.
c) In the Restricted To Environment field, select Sandbox.
Note: Leave the Restricted To field blank to specify a value that applies to all environments except
the one with a restricted value. Example: To use ABCPROD.TXT as the output filename for your
production environment and ABCTEST.TXT for all other environments. Restrict ABCPROD.TXT to
your production environment. Leave the Restricted To field blank for ABCTEST.TXT. When the
integration runs in the production environment, it creates an output file named ABCPROD.TXT.
When it runs in any other environment, it creates a file named ABCTEST.TXT.
5. If you want to test the integration with a subset of data, set the Enable Test Mode attribute to true in the
WBN outbound integration service.
As a best practice, restrict this value to your sandbox environment to ensure that integrations in your
production environment always include a full set of data.

Example
• Send sandbox data to your own FTP site. Then, specify a sandbox value for the Endpoint attribute.
• Send your benefit provider a test value by specifying a sandbox value for the Output Filename attribute.

Next Steps
When you finish testing or if you want to test with a full set of data, set the Enable Test Mode attribute
to false. Using this option, the integration events include all applicable records. Always make sure that
Enable Test Mode is set to false when you go into production.
Related Information
Concepts
Concept: Planning a Benefit Provider Integration on page 514
Tasks
Set Up Benefit Electronic Signatures
Finalize Open Enrollment Elections

Include Payroll Balances in Benefits Integration

Prerequisites
Actual contribution amounts are only available to Cloud Connect for Benefits integrations from Workday
Payroll. If you use a third-party payroll provider, benefit integrations send estimated amounts based on the
benefit plan setup.
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Send actual contribution amounts from Workday Payroll to benefit providers who manage defined
contribution plans and flexible spending accounts. Benefit providers can receive the subscriber data,
enrollment data, and actual contribution amounts in a single integration file.
For defined contribution plans, the payroll amounts include both the employee and employer contributions,
as well as any loan repayments by an employee.

Steps
1. Access the View Integration System report.
2. Select an integration system at the prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 522

3. As a related action on the integration system, click Integration System > Configure Integration
Services.
4. In the Integration Services grid, select the Enabled check box for the WBN - Include Payroll Balances
service.
5. As a related action on the integration system, click Integration System > Configure Integration
Attributes.
6. In the Integration Attributes grid, edit the attributes for the WBN - Include Payroll Balances service:
a) Find the Employee Deduction Codes and Employer Deduction Codes attributes in the grid.
b) Add a row for each attribute.
c) In the Value column, enter the deduction code values in a comma-delimited list. These values are
the deduction codes that you defined in Workday for the associated benefit plan.

Next Steps
Integrations that include payroll results have 2 additional launch parameters, Payroll Start Date and
Payroll End Date. Edit the integration schedule so that it corresponds to your pay periods by using the
Launch / Schedule Integration task.
Related Information
Concepts
Concept: Cloud Connect for Benefits on page 512
Tasks
Steps: Schedule, Launch, and Troubleshoot Benefit Provider Integration on page 523

Change Benefit Provider Integration Maps

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Integration maps specify how values in Workday map to values in an external endpoint. Benefit provider
integrations have 2 map types:
• Simple maps have a one-to-one correlation between Workday values and external values.
• Configurable maps concatenate multiple values in Workday to match a class structure or division in a
benefit provider endpoint.
You configure maps during initial configuration, but if your benefit programs change, you can modify the
maps to accommodate these changes. Typically, you update integration maps when you add or change
benefit plans, benefit options, coverage codes, or deduction codes. You can also modify integration maps
due to:
• Organizational changes, such as adding a division.
• Data discrepancies between Workday and your benefit providers.

Steps
1. Access the View Integration System report.
2. At the Integration System prompt, select the integration system that you want to edit.
3. As a related action on the integration system, select Integration System > Configure Integration
Maps.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 523

4. Edit maps by adding, removing, or changing entries in the Map Values columns:
• To add an entry, insert a row in the grid and specify the Internal Value and External Value.
• To delete an entry, remove the current row from the grid.
• To change an entry, edit the values in the Internal Value and External Value columns.
Note: Use caution when you edit integration maps. If you enter values in an incorrect format, errors
can occur when the integration runs. Values are both case sensitive and space sensitive.

Launch and Troubleshoot Benefit Provider Integration

Steps: Schedule, Launch, and Troubleshoot Benefit Provider Integration

Context
Schedule a benefit provider integration that runs either one-time in the future or on a recurring basis. Select
the integration frequency, define the schedule, and specify dates for the launch criteria. In scheduled
integrations, Workday typically determines the appropriate values for date parameters when the integration
runs.
In manual integrations, specify values for date parameters instead of having Workday calculate the values
when the integration runs.
Security: Integration Build and Integration Configure in Integration functional area.

Steps
1. Launch an Integration on page 23.
2. (Optional) View status reports for the integration.
See: Reference: Integration Status Reports on page 530
3. (Optional) Audit Integration Events on page 29.
4. (Optional) FAQ: Benefit Provider Integration Common Issues on page 530.
Related Information
Tasks
Create Integration Notifications on page 30
Manage Scheduled Future Processes

Concept: Benefits Integration Launch Parameters

Scheduled Integration Launch Parameter Examples

Example 1: Full File, Run Weekly To schedule a weekly full file integration, specify
these values for the Effective Date and Last
Update launch parameters:

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime
Last Update Determine Current
Value at Moment
Runtime (DateTime)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 524

Each time the integration runs, it sends a full file


with all benefit enrollment data that is:
• Current as of the Last Update
• Effective as of the Effective Date
Based on the date and time at launch.

Example 2: Full File, Include Ended Coverage To schedule a weekly full file that includes ended
Once, Run Now coverages, specify these parameter values:

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime
Last Update Determine Current
Value at Moment
Runtime (DateTime)
From Effective Determine As Of Effective
Date Value at Date of Last
Runtime Completed
Integration
Event
From Last Determine As Of Entry
Update Value at DateTime
Runtime of Last
Completed
Integration
Event

(WBN - Full File - Include Ended Coverage Once


integration service enabled).
Each time the integration runs, it sends a file that
contains:
• All current enrollment data as of the Last
Update and effective as of the Effective Date.
• Terminations entered between the From Last
Update and the Last Update with an effective
date no later than the Effective Date.
• Terminations that have an effective date
between the From Effective Date and the
Effective Date.

Example 3: Change File, Run Weekly To schedule a weekly change file integration,
specify these parameter values:

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 525

Field Value Type Value


Last Update Determine Current
Value at Moment
Runtime (DateTime)
From Effective Determine As Of Effective
Date Value at Date of Last
Runtime Completed
Integration
Event
From Last Determine As Of Entry
Update Value at DateTime
Runtime of Last
Completed
Integration
Event

(WBN - Launch Change File - Event Based


integration service enabled.)
Each time the integration runs, it sends a file that
contains:
• Enrollment changes that occurred between the
last integration run (From Last Update) and the
current date and time (Last Update).
• Changes that are effective between the From
Effective Date and the Effective Date.

Example 4: Payroll Contributions, Run Semi- Schedule a semimonthly integration that includes
Monthly payroll contribution data for a flexible spending
account or a retirement savings plan:

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime
Last Update Determine Current
Value at Moment
Runtime (DateTime)
From Effective Determine As Of Effective
Date Value at Date of Last
Runtime Completed
Integration
Event
From Last Determine As Of Entry
Update Value at DateTime
Runtime of Last
Completed
Integration
Event

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 526

Field Value Type Value


Payroll Start Determine As Of Entry
Date Value at DateTime
Runtime of Last
Completed
Integration
Event
Payroll End Determine Current
Date Value at Moment
Runtime (DateTime)

(WBN - Include Payroll Balances integration service


enabled. WBN - Launch Change File - Event Based
integration service required for change file in this
example. WBN - Full File - Include Ended Coverage
Once integration service required for full file in this
example.)
Each time the integration runs, it sends a file that
contains:
• Enrollment changes that occurred between the
last integration run (From Last Update) and the
current date and time (Last Update).
• Changes that are effective between the From
Effective Date and the Effective Date.
• Payroll contributions made between the last
integration run (Payroll Start Date) and the
current date and time (Payroll End Date).

Manual Integration Launch Parameter Examples

Example 1: Open Enrollment, Run Now Send open enrollment data for the upcoming plan
year. Specify the Effective Date of the benefit plan
and enable the Last Update to populate the current
date automatically. In this example, the Effective
Date is 1/1/2012 and the Last Update automatically
populates with 11/30/2011:

Field Value Type Value


Effective Date Specify Value 01/01/2012
Last Update Specify Value 11/30/2011
05:57:37 PM

This integration runs once on 11/30/2011. The


integration creates an output file that contains all
open enrollment data for the 2012 plan year.

Example 2: Full File, Run Now To send a full enrollment file, use the default
parameters. The Effective Date automatically
populates with the current date. The Last Update
automatically populates with the current date and
the time at launch:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 527

Field Value Type Value


Effective Date Specify Value 07/08/2011
Last Update Specify Value 07/08/2011
03:55:45.515
PM

In this example, the integration runs once on


7/8/2011. The integration creates an output file
that contains all current enrollment data as of the
Last Update (7/8/2011 at 3:55:45.515). The file is
effective as of the Effective Date (7/8/2011).

Example 3: Full File, Include Ended Coverage To send a full file that includes ended coverages,
Once, Run Now keep the default Effective Date and Last Update
values. Change the From Effective Date and From
Last Update to specify the date range for ended
coverages:

Field Value Type Value


Effective Date Specify Value 07/08/2011
Last Update Specify Value 07/08/2011
03:57:06.956
PM
From Effective Specify Value 07/01/2011
Date
From Last Specify Value 07/01/2011
Update 02:57:06 PM

(WBN - Full File - Include Ended Coverage Once


integration service enabled).
If you enabled the WBN - Include Payroll Balances
service, specify the Payroll Start Date and Payroll
End Date. These values enable you to report
payroll contributions.
In this example, the integration runs once on
7/8/2011 and creates an output file that contains:
• All current enrollment data as of the Last
Update (7/8/2011 at 3:57:06.956) and effective
as of the Effective Date (7/8/2011).
• Terminations with these constraints:
• Entered between the From Last Update
(7/1/2011 at 2:57:06) and the Last Update
(7/8/2011 at 3:57:06:956)
• With an effective date no later than the
Effective Date (7/8/2011)
• Any terminations that have an effective date
between the From Effective Date (7/1/2011)
and the Effective Date (7/8/2011).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 528

This integration would include a termination entered


on 7/5 with an effective date of 6/15. The integration
wouldn’t include a termination entered on 7/5 with
an effective date of 7/15.

Example 4: Change File, Run Now To send a change file, keep the default Effective
Date and Last Update. Change the From Effective
Date and From Last Update to specify the date
range for changes:

Field Value Type Value


Effective Date Specify Value 07/08/2011
Last Update Specify Value 07/08/2011
04:52:00.55
PM
From Effective Specify Value 07/01/2011
Date
From Last Specify Value 07/01/2011
Update 03:52:00 PM

(WBN - Launch Change File - Event Based


integration service enabled.)
If the integration has the WBN - Include Payroll
Balances integration service, specify the Payroll
Start Date and Payroll End Date. These values
enable you to report payroll contributions.
In this example, the integration runs once on
7/8/2011 and creates an output file that contains:
• Changes that were:
• Entered between the From Last Update
(7/1/2011 at 3:52:00) and the Last Update
(7/8/2011 at 4:52:00.55)
• With an effective date no later than the
Effective Date (7/8/2011)
• Any changes that have an effective date
between the From Effective Date (7/1/2011)
and the Effective Date (7/8/2011).
This integration would include a change entered on
7/5 with an effective date of 6/30. The integration
wouldn’t include a change entered on 7/5 with an
effective date of 7/15.
COBRA integrations are an exception: they always
include future dates for ending of coverage that are
past the Effective Date at the time of launch.

Example 5: FSA, Run Now To send an FSA file, use the Payroll Start Date and
Payroll End Date parameters. The Payroll Start
Date and Payroll End Date parameters select
data from any pay period that ends during the date
range.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 529

Field Value Type Value


Payroll Start Specify Value 07/05/2011
Date
Payroll End Specify Value 07/15/2011
Date 11:59:00 PM

In this example, the integration runs once. The


integration creates an output file that contains all
FSA data for any pay period that ends during the
range. The integration would include a pay period
that runs from 07/01/2011 and ends on 07/14/2011.
The integration includes this pay period even
though the pay period starts before the Payroll
Start Date value.

Concept: Benefit Integration Error Reporting

How Workday Reports Errors


Error messages identify the context of a problem, along with any missing map values and missing or
invalid fields, such as the name of a worker or dependent. Example: the name of the worker or dependent.
When an integration file contains errors, Workday doesn't transmit data but fully processes the file to
produce a comprehensive error report. If field truncation occurs, Workday reports the issue as a warning,
processing continues, and Workday transmits data if the integration encounters no other errors. Integration
events can generate up to 500 error messages before processing stops and up to 500 warnings before
Workday issues a final warning.
Enhanced error messages are available in all integrations that support the ANSI ASC X12N 834 (834)
format, as well as these integrations with proprietary output formats:

A-D E-L M-Z


ADP COBRA EideBailly FSA MetLife Voluntary Products
ADP FSA Fidelity Investments 401K SunLife Life and AD&D
AST Equity Solutions ESPP Hartford Life and Disability SunLife Health
CBIZ FSA Innovative Care Systems STD United HealthCare FSA
LTD
Ceridian COBRA ING Compsych UNUM Life and AD&D
CIGNA Starbridge Medical Lincoln Financial Life and AD&D UNUM Telephonic Output
Conexis COBRA WageWorks FSA

Message Examples
Common integration errors include missing fields or attributes, empty map values, and field truncation.

Message Resolution
John Doe has missing or invalid data. "Employee To add the missing data, access the Edit IDs task.
SSN" is required and is missing a value. In the National IDs grid, select the National ID
Type and enter the Identification #.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 530

Message Resolution
Ann Smith has missing or invalid data. The value To avoid field truncation warnings in the future,
123-456-78910 is too long for "Phone Number" access the Contact Information report. As a
and will be truncated in the output. Phone Number related action on the worker, select Personal Data
should have length equal to or shorter than 12. > Maintain Contact Information. Correct the
phone number to fit the required length.
"Client Id" is required and is missing a value. To specify the attribute value, access the View
Please check the value in the integration attribute Integration System report. As a related action
"Originator ID." on the integration system, select Integration
System > Configure Integration Attributes. Find
Originator ID in the grid, add a row, and specify the
appropriate value.
The value 6 isn't valid for "Plan Identifier." "Plan To map the correct data, access the View
Identifier" is mapped from the group number on Integration System report. As a related action on
the benefit plan in Workday. Please check the the integration system, select Integration System
integration map "Plan Identifier" to verify the value > Configure Integration Maps. Find Plan Identifier
has been mapped. in the grid and specify the correct internal value.

Reference: Integration Status Reports


You can monitor the status of an integration with these Workday reports:

Process Monitor View integrations that are currently running or have


already run.

Scheduled Future Processes View integrations that you scheduled but haven’t
yet launched. You can also edit, delete, suspend, or
activate a scheduled request, or transfer integration
ownership.

Integration Events View a summary of all integration activities that are


in process or completed.

Related Information
Concepts
Concept: Workday Scheduled Processes
Tasks
View Integration Events on page 27
Manage Scheduled Future Processes

FAQ: Benefit Provider Integration Common Issues

Transmission Errors

What if my integration event has a status of If the response message indicates that Workday
Completed with errors? couldn't find the destination address, try to relaunch
the integration. The destination site might be
temporarily down.
If the response message indicates that a mapping
error occurred, check with your provider for more
specific information. If you can identify the point of
failure, you can modify the integration map.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 531

How do I resolve a transaction failure for an A transaction failure status indicates that a service
integration event? wasn't available. Try to launch the integration again.

Data Errors
Benefit providers use different methods to communicate data errors, including reports and online tools.
No matter how you receive error reports, note that if you fix data directly with your provider, you must also
update Workday. Otherwise the next integration event will overwrite the corrected data with your provider.

What if my provider reports a discrepancy in First check eligibility and enrollment data for the
enrollment data? employee in Workday. If the data is incorrect
or missing, update the employee information in
Workday. Workday retransmits the corrected data
with the next scheduled integration.
If the employee data is correct in Workday, contact
your provider to verify the issue or contact Workday
support.

What if my provider reports that data is If auditing is enabled in your integration, access the
missing? Integration Events report to look for missing data
in the output file. You might need to relaunch the
integration using different parameters.
Also, make sure that your integration mapping
supplies values for all fields required by your
provider. Some providers have mandatory data
requirements that don't match fields required by
Workday.

Why are new hires missing from the integration Check your benefit plan configuration in Workday.
file? Your enrollment event rules and benefit eligibility
rules might specify a waiting period or certain
eligibility criteria.
Ensure that you launched the integration with
the correct date parameters. In most cases, the
Effective Date and Last Update fields should
be the integration run date. Using this date
ensures that the integration file captures all current
enrollment data.

How do I resolve data mismatches? Name, address, or Social Security number


mismatches are often due to poor data quality.
Review employee data in Workday to find and
resolve these issues.
Data mismatches can occur when policy effective
dates differ from event occurrence dates. Plan or
dependent mismatches can result when the plan
accepted enrollment information under a different
plan.
Other data discrepancies might be due to coding
differences. Verify that your integration map
specifies the correct values for provider codes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 532

What if an employee reports an issue? First check the eligibility and enrollment data for
the employee in Workday. If the data is incorrect
or missing, update the employee information in
Workday. Workday retransmits the corrected data
with the next scheduled integration.
If the employee data is correct in Workday,
compare the change dates for the employee data
with the integration launch date. If you made
changes after the last launch, then Workday
includes the information the next time the
integration runs.

What happens if an employee moves to a Workday has added support for foreign addresses
foreign country? to all integrations that use the 834 format.
Integration templates have factory settings to
match foreign address requirements for each
provider. Integrations that report ended coverage
or COBRA qualifying events complete successfully
for employees who relocate outside of the U.S. or
Canada.

If an error occurs during creation of the HTML No, this error doesn't affect the integration.
audit file, does it affect the integration? Workday logs a warning, but the integration
processing continues.

What happens if the date range for the The integration always sends data applicable to
integration spans 2 plan years? the Plan Year in which the Effective Date falls.
Workday uses the integration launch parameters
to determine the Plan Year. Example: assume that
you schedule your integration to run on the 10th day
of each month. Also assume that you specify the
Effective Date as the first day of the next month. If
your Plan Year is the same as the calendar year,
the integration sends data for the current Plan
Year. The integration sends data for the 10 January
through 10 November integration events. However,
the 10 December integration event sends data
applicable for the next Plan Year. In this case, the
Effective Date would be 01 January, thus in the next
Plan Year.
To avoid this issue, Workday recommends that
you create and configure a separate integration
schedule for December. This schedule should use
the last day of the current month as the Effective
Date.

Related Information
Tasks
View Integration Events on page 27
Reference
Reference: Integration Message Components and Error Handling on page 34

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 533

Open Enrollment Integration Tasks

Concept: Open Enrollment Integration Checklist


Careful planning is essential during open enrollment to ensure proper configuration and testing of
benefit provider integrations. Use these guidelines when planing your open enrollment activities so that
integrations are ready for production when benefits become effective for the new plan year.
Not all benefit plan years are identical to a calendar year. Common other plan years span calendar years.
Examples: Apr 1st through March 31, July 1st through June 30th, November 1st through October 31.
Additional open enrollment planning tools are available in the Open Enrollment Checklist on the Workday
Community.

Plan Integrations with New Providers If you’re introducing a new benefit provider, first
check the Cloud Connect for Benefits catalog. The
new provider might be in the network.
Next, ensure that you understand the time line and
responsibilities. The time line and responsibilities
vary based on whether:
• The provider is already in the network.
• The provider is new to the Cloud Connect for
Benefits catalog.

Establish Benefit Plans for the New Plan Year Create new benefit plans or update existing plans
for the new plan year. Be sure to request benefit
rates from your providers early so that you can
complete your benefit plan definitions.
Don’t change the name of an existing benefit
plan or provider as a shortcut to creating new
plans or providers. These changes impact current
integrations and benefit enrollment history.
Ask your providers if benefit plan codes change
for the new plan year so that you can update your
integration maps. Coordinate the timing of map
changes with your providers based on how you
manage current year enrollment data during and
after open enrollment. Also, take this opportunity
to review the overall configuration of your benefit
plans to see if consolidation is possible. The ideal
configuration is a one-to-one relationship between
a Workday benefit plan and a third-party provider
benefit plan.

Link Benefit Plans to Integration Systems When you offer a new benefit plan with the same
provider, link the plan to your existing integration.
Likewise, if you discontinue a plan, remove the
integration link.
If you’re establishing relationships with new
benefit providers, you'll configure links from
the benefit plans to the new integrations during
implementation.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 534

Manage Integrations During Open Enrollment During open enrollment, you gather benefit
elections for the new plan year. You still manage
enrollment data for new hires, terminations, and
life events in the current plan year. Check with
your benefit providers and find out how to manage
integration schedules while open enrollment is in
progress. Some providers prefer to receive existing
enrollment data as scheduled, while others can
suspend or stop the current integration schedule.

Submit Final Enrollment Data to Benefit When open enrollment concludes, send final
Providers enrollment data to your providers. Schedule a one-
time integration with an effective date that matches
the start of the new plan year. Example: specify an
Effective Date of 1/1/2012 if the benefit plan year
is the same as the calendar year. The integration
sends benefit elections for the new plan year only.
Be sure to arrange the timing of this integration with
your provider. It’s also important to finalize the open
enrollment event in Workday. The integration file
then contain all enrollments for your employees.
Otherwise, if an employee record is missing from
the file, some benefit providers could end coverage.

Reset Integration Schedules You can schedule integrations on a plan-year


basis. Before the new plan year starts, reset the
integration schedules with your existing benefit
providers.

Send Final Elections for the Current Year When the current plan year ends, send your
provider the final file as of the last day of the year.
Example: if the benefit plan year is the same as
the calendar year, specify an Effective Date of
12/31/2011. This integration event is likely an ad
hoc launch rather than a scheduled event. The
final file notifies the provider of ended coverage
for employees who change benefit providers
during open enrollment. The final file also includes
elections, terminations, and other changes for the
current plan year only.

Related Information
Concepts
Concept: Cloud Connect for Benefits on page 512
Concept: Planning a Benefit Provider Integration on page 514
Tasks
Start Open Enrollment
Manage Scheduled Future Processes
Steps: Schedule, Launch, and Troubleshoot Benefit Provider Integration on page 523
Reference
The Next Level: Benefits Integrations

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 535

Link Benefit Plans to Integration Systems

Prerequisites
You've already set up Benefit plans in Workday for the upcoming plan year.
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Update the links between benefit plans and provider integrations so that they reflect changes for the new
plan year. Link new benefit plans to a current integration if the plans are with the same provider, or remove
links for any discontinued plans.
Integration attributes establish links between benefit plans and integrations.

Steps
1. Access the View Integration System report.
2. Select the Integration System and click OK.
3. As a related action on the integration system, click Integration System > Configure Integration
Attributes.
4. In the Integration Attributes grid, configure the Benefit Plans attribute in the WBN outbound
integration service:
• To add benefit plans to the integration system, click the Value prompt to select the new plans that
are associated with this benefit provider.
• To remove benefit plans from the integration system, select the discontinued plans.

Next Steps
After you add a benefit plan to an existing integration system, modify the integration map to include any
new parameters that the plan requires.
Related Information
Concepts
Concept: Planning a Benefit Provider Integration on page 514

COBRA Integration

Set Up Event-Based Change Files

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Configure a COBRA integration so that it subscribes to life events, so that the integration sends event-
based change files rather than full file extracts.
You usually configure change files during initial implementation. If you didn't configure change files, or if
you need to edit the integration subscriptions, follow this procedure.

Steps
1. Access the View Integration System report.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 536

2. Select the integration system at the prompt and click OK.


3. In the Integration Services grid, check to see if these services are configured correctly:
• WBN - Launch Change File - Event Based: Enable
• Transaction Log Service Enable
If not, follow these steps to enable the services:
a) As a related action on the integration system, select Integration System > Configure Integration
Services.
b) Select the Enabled check box for each service.
c) Click OK to save your changes.
4. As a related action on the integration system, click Integration System > Configure Integration
Transaction Log.
5. Click Subscribe to specific Transaction Types and then select these transaction types at the prompt:
• For a COBRA new hire integration, select Benefit Election - Event Lite Type.
• For a COBRA qualifying event integration, select COBRA Record - Event Lite Type
• If your provider receives new hire and qualifying event information in a single integration, select both
Benefit Election - Event Lite Type and COBRA Record - Event Lite Type.

Result
When launched, the COBRA integration makes web service calls to obtain the event history for the
transactions that you’ve configured and sends a change file to the provider.

Concept: COBRA Integration


Workday tracks employee COBRA eligibility; Workday is not a COBRA administrator. To enable COBRA
administration, you create an integration with a third-party COBRA service provider. When qualifying
events occur, Workday sends employee COBRA eligibility data to the service provider. Your service
provider can then manage the COBRA administration and notifications.

Planning
Some COBRA administrators require 2 integration files, each with its own integration system:
• An initial enrollment file that identifies new members of COBRA-eligible benefit plans.
• A qualifying events file that identifies COBRA qualified beneficiaries
Other COBRA administrators only need the qualified beneficiary data as they receive initial enrollments
outside of Workday. Work with your COBRA administrator and Workday Professional Services to
determine the appropriate configuration for your organization.

Prerequisites
Before you configure a COBRA integration, define how Workday designates COBRA eligibility.

Configuration
Map the COBRA eligibility reasons in Workday to the corresponding event codes for the COBRA
administrator. COBRA administrators have different requirements so configuration can vary by integration.
Contact Professional Services for assistance.
Configure your COBRA Qualifying Events integration to support plan activity that bridges the current plan
year. Enable the integration service Get Prior Plan Year Benefit Plans Data Initialization Service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 537

Launch Options
Use the Launch / Schedule Integration task to launch a COBRA integration. You can schedule the
integration to run now, in the future, or on a recurring basis.
COBRA integrations require date parameters to search for qualifying events. You can specify values
for these parameters at launch time or, in scheduled integrations, you can have Workday determine the
values.

Maintenance
Notify your COBRA administrator when you change existing benefit plans or rates, or when you add new
plans eligible for COBRA. These changes often occur during open enrollment.
After manually coordinating these changes with your COBRA administrator, review and modify your
integration attributes and map to reflect the changes.

COBRA Dates
COBRA integrations capture 3 dates from the Grant COBRA Eligibility task:

Date Definition
COBRA Eligible Date The date that a worker or dependent is eligible for COBRA coverage. Typically,
this date is the day after the loss of coverage, which isn’t necessarily the same
as the event date.
Qualifying Event Date The date of the event that caused a worker or dependent to lose regular benefit
coverage.
COBRA Coverage End The last date of benefit coverage for a worker or dependent. Example: Coverage
Date might end on the last day of the month in which the qualifying event happened.
Note: This date is the end of COBRA coverage (the continuation), not the end
of regular coverage. The length of coverage is typically 18 months, but it can be
longer in certain circumstances.

Example: You terminate an employee on September 9 and regular benefit coverage is in effect through
September 30. The Grant COBRA Eligibility task would have these dates:
• COBRA Eligible Date = October 1
• Qualifying Event Date = September 9
• COBRA Coverage End Date = April 1 (18 months after COBRA Eligible Date)
Example: A dependent loses coverage at age 25. If the birthday of the dependent is July 31, the COBRA
dates would be:
• COBRA Eligible Date = August 1
• Qualifying Event Date = July 31
• COBRA Coverage End Date = February 1 (18 months after COBRA Eligible Date)
Related Information
Tasks
Grant COBRA Eligibility
Steps: Schedule, Launch, and Troubleshoot Benefit Provider Integration on page 523
Steps: Set Up Passive Events

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 538

Ended Coverage Reporting

Steps: Report Ended Coverage Once

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Configure a benefit provider integration to report ended coverages one-time and then drop subscribers
from subsequent integration output files. This setting only applies to full files. The setting works with the
End Coverage Configuration attribute to determine when ended coverages are reported.

Steps
1. Access the View Integration System report and select the integration at the prompt.
2. In the Integration Services grid, check to see if the Full File - Include Ended Coverage Once service is
enabled. If not, follow these steps to enable the service:
a) As a related action on the integration system, select Integration System > Configure Integration
Services.
b) Select the Enabled check box.
3. Configure the ended coverage attributes in the WBN - Enrollment Transform integration service:
a) As a related action on the integration system, select Integration System > Configure Integration
Attributes.
b) For End Coverage Configuration, specify ALWAYS, COVERAGE, or CARRIER based on your
benefit provider requirements. Don't specify NEVER. Don’t leave this attribute blank.
Note: The End Coverage Configuration attribute has a preset setting in newer integration templates.
If Workday doesn't display this attribute in your integration system, then the integration template
includes the appropriate setting automatically.
c) For End Coverage History, leave the value blank. This option isn't applicable for integrations that
report ended coverage once.
4. Create an Integration System User (ISU) and grant the ISU Get and Put access to the
Human_Resources web service.
See: Steps: Grant Integration or External Endpoint Access to Workday.
5. Set up integration subscriptions:
a) As a related action on the integration system at the top of the page, select Integration System >
Configure Integration Transaction Log.
b) Click Subscribe to specific Transaction Types and at the prompt, select Benefit Election - Event
Lite Type.

Result
When you launch or schedule the integration, specify values for 2 additional integration parameters: From
Effective Date and From Last Update. Output files then report ended coverages for workers based on
enrollment events that occurred between the specified dates. To have Workday determine these values
when a scheduled integration runs, use these settings:

Field Value Type Value


Effective Date Determine Value at Runtime Current Date
Last Update Determine Value at Runtime Current Moment (DateTime)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 539

Field Value Type Value


From Effective Date Determine Value at Runtime As Of Effective Date of Last
Completed Integration Event
From Last Update Determine Value at Runtime As Of Entry DateTime Date of
Last Completed Integration Event

The integration reports future-dated ended coverages when the ended coverage becomes effective, not
when you entered the change. Example: Workday records a benefit change for a worker on November
25 that results in ended coverage effective December 15. When the integration runs on November 30, it
doesn’t report the ended coverage for the worker. However, when the integration runs on December 15,
the integration reports ended coverage and then drops the record.
COBRA integrations are an exception. They always include future-dated ended coverages. The WBN -
Enrollment (v2) integration service includes an Include Future Coverage End Dates attribute set to Yes in
all COBRA integrations. Since it’s preconfigured, Workday doesn't display this attribute.
Related Information
Concepts
Concept: Cloud Connect for Benefits Integration templates on page 514
Tasks
Steps: Grant Integration or External Endpoint Access to Workday

Concept: Ended Coverage Options


Each benefit provider has specific requirements regarding when and how you report ended coverage
in integration files. Workday accommodates these requirements through a combination of integration
configuration options.
Note: Workday doesn’t report future dated ended coverage, except in COBRA integrations. All other
benefit provider integrations report ended coverage when the change takes effect.

When Ended Coverage Is Reported


Workday provides 4 options for reporting ended coverages. If your integration uses a vendor-specific
integration template, ended coverage has a factory default setting based on your provider requirements.
Otherwise, this setting is configured in the End Coverage Configuration attribute in the WBN - Enrollment
Transform integration service. The ended coverage setting applies to both full extracts and change files.
Workday provides these ended coverage options:

ALWAYS Ended coverages are always in output files. This


option is the default.

NEVER Ended coverages are never in output files. If all


coverage ends for a subscriber, the integration
drops the subscriber information from the output
file.

COVERAGE Ended coverages are in output files only when


all coverage in a plan type ends. The integration
includes only the latest ended coverage.

CARRIER Ended coverages are in output files only when all


coverage with a carrier ends.

Example: An organization has 2 health care providers:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 540

• Provider A offers PPO and EPO medical plans and a dental plan
• Provider B offers an HMO medical plan
This table displays how the integration reports ended coverages when the same option applies to both
providers:

Event Always Never Coverage Carrier

Subscriber Enrolls in Provider PPO Provider PPO Provider PPO Provider PPO
PPO and Dental Plans A A A A
with Provider A Dental Dental Dental Dental

Subscriber Changes to Provider PPO Provider EPO Provider EPO Provider EPO
EPO Plan with Provider A A A A
End
A Dental Dental Dental
EPO
Dental

Subscriber Changes to
Provider PPO Provider Dental Provider EPO Provider Dental
HMO Plan with Provider
A End A A End A
B
EPO Provider HMO Dental Provider HMO
End B B
Provider HMO
Dental B
Provider HMO
B

Subscriber Ends Dental Provider PPO Provider No Provider Dental Provider EPO
Coverage with Provider A
A End SubscriberA End A End
A Data
EPO Provider HMO Dental
End Provider HMO B End
Dental B
Provider HMO
End B
Provider HMO
B

Subscriber Ends Medical Provider PPO Provider No Provider No Provider No


Coverage with Provider A A SubscriberA SubscriberA Subscriber
End
B Data Data Data
EPO
End Provider No Provider HMO Provider HMO
B SubscriberB End B End
Dental
Data
End

Provider HMO
B End

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 541

How Long Ended Coverage Is Reported


You can report ended coverage once or for a given period. These options are mutually exclusive and apply
only to full files, not change files.

Include Ended Coverage Once The WBN - Full File - Include Ended Coverage
Once integration service specifies that ended
coverages are reported only once. The integration
drops ended coverages from subsequent
integration output files. This option requires
integration subscriptions to particular benefit
enrollment events.
Integrations that report ended coverages once have
2 additional launch parameters: From Effective Date
and From Last Update. Output files include ended
coverages for workers who completed benefit
enrollment events between the given dates.

Ended Coverage History The Ended Coverage History attribute in the WBN -
Enrollment Transform service specifies how long to
include ended coverages in output files.
The attribute value indicates the number of days
to include ended coverages in full extracts. The
number of days is based on the Effective Date
that you use to launch the integration. Example:
you specify a value of 30 for the Ended Coverage
History attribute. In this case, the integration
includes ended coverages within the last 30 days
of the Effective Date. If you launch an integration
with an Effective Date of 1/31/10, the output file
includes subscribers and dependents with ended
coverages on or after 1/1/10.
If you set this attribute to zero or leave it blank, the
integration includes all ended coverages in output
files.

Ended Coverage for Dependents


You can report ended coverage for dependents differently than for participants by using the Dependent
End Coverage Configuration attribute in the WBN - Enrollment Transform integration service. Specify a
value of ALWAYS, NEVER, COVERAGE, or CARRIER. ALWAYS is the default option.
Leave this attribute blank to have dependents inherit the employee configuration that the End Coverage
Configuration attribute specifies.
Related Information
Concepts
Concept: Cloud Connect for Benefits Integration Templates on page 514
Concept: Planning a Benefit Provider Integration on page 514

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 542

Workday Benefits Connector

Concept: Workday Benefits Connector


With Workday Benefits Connector, you can manage benefits-related HR data and send it to a third-party
benefits provider of your choice. Benefits Connector can capture changes to employee data and configure
a benefits extract. You can then transform the file to meet the requirements of your external benefits
provider.
Benefits processing needs can vary based on:
• Organization size.
• Data complexity.
• External vendor requirements.
To support different processing needs, Workday Benefits Connector offers a choice of implementation
options.
All Benefits Connector integrations extract data using Workday Web Services or Data Initialization Service
(DIS). Benefits Connector integrations then create benefits extract files in a Workday-defined XML format.
There are 2 versions of the Workday Benefits Connector:
• V1 is the original connector that uses web services to extract data but doesn't support all benefit plan
types.
• V2 (Recommended) is the latest connector that provides DIS extraction and supports all benefit plan
types.
Your benefits provider might require you to transform the file into the format that they support using one of
these options:
• Transformation step on the business process. You configure the business process definition to
transform the Benefits Connector output file into the format required by your benefits provider.
• Workday Studio integration. You configure the business process definition to launch a Workday Studio
integration. The Studio integration transforms the Benefits Connector output file into the format required
by your benefits provider.
Note: If your benefits provider is able to transform Benefits Connector output files, you don’t need to use
either option.
Benefits Connector is an integration template with a configurable set of HCM data across a range of
categories. Benefits providers only need a subset of the employee data in Workday. Benefits Connector
enables you to specify which data elements to include in benefits output files. You can also specify how
to detect changes based on Workday transactions. When launched, the integration captures changes to
employee data and creates an output file in XML format based on your specifications.
You can also create full extracts of employee data with integrations that use the Benefits Connector
template. This option is helpful during initial implementation, supports vendors who require full files, and
also enables you to synchronize data when necessary. Full extracts include all data for active employees,
plus data for terminated employees.

Supported Plan Types


Benefits Connector enables you to export data relevant to these types of benefits plans:

Supported Plan Type v1 v2


Additional Benefits Yes
Flexible Spending Account (FSA) Yes Yes

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 543

Supported Plan Type v1 v2


Health Plans (Medical, Dental, Yes Yes
Vision, Drug)
Health Savings Plans (HSA) Yes
Life and Disability Yes Yes
Retirement Savings Account Yes Yes

Benefits Connector Launch Parameters


Benefits Connector provides these launch parameters:

Parameter Value Type Description

Effective Date Specify Value or The date when enrollments are valid. Workday populates the
Determine Value at current date automatically. In most cases, specify the launch
Runtime date unless you’re sending enrollment data for the next plan
year.

Last Update Specify Value or The launch date. Workday populates the current date and time
Determine Value at automatically. To ensure that the integration uses the current
Runtime snapshot of Workday, don't change this value.

From Effective Specify Value or The effective date for enrollment changes to include in the
Date Determine Value at file. Workday populates the current date automatically. Only
Runtime applies to change files.

From Last Update Specify Value or The date and time of the last successful change file
Determine Value at integration. Workday populates the current date and 1 hour
Runtime before the current time automatically. Only applies to change
files.

Change Detection Specify Value (v1 only) Specify how to search for changes to benefits data:
• All Effective. Selects changes to employee data with an
effective date between these launch parameters: Effective
Date and From Effective Date. This option selects changes
regardless of when you entered them.
• Incremental. Selects changes to employee data that you
entered between the Last Update and From Last Update
launch parameters. This option selects changes with an
effective date on or before the Effective Date parameter.

Payroll Start Date Specify Value or The start date and time for payroll contributions reported by
Determine Value at the integration. Only applies to flexible spending accounts and
Runtime retirement savings plans. The Use Payment Date integration
attribute determines whether amounts are based on period
dates or payment dates.
Payroll End Date Specify Value or The end date and time for payroll contributions reported by
Determine Value at the integration. Only applies to flexible spending accounts and
Runtime retirement savings plans. The Use Payment Date integration
attribute determines whether amounts are based on period
dates or payment dates.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 544

Related Information
Concepts
Concept: Planning a Benefit Provider Integration on page 514
Concept: Workday Benefits Connector
Set Up Benefits Connector V2 Integration Services on page 545
Set Up Benefits Connector V2 Attributes and Maps on page 546
Reference: Benefits Connector Data Sections on page 550
Concept: Benefits Connector V2 Change Detection on page 549
Reference: Benefits Connector V2 Audit Files on page 552

Steps: Set Up the Workday Benefits Connector V2 Integration

Prerequisites
• Request the file specification from your benefit provider so that you can familiarize yourself with their
data requirements.
• Compare the data requirements for your benefit provider with the output options provided by Benefits
Connector.
• Determine an approach for transforming integration output into the benefit provider format. Example: a
Document Transformation integration or Workday Studio integration.
• Plan out the number and type of test cycles that the benefits provider requires before certifying your
integration. Work with your benefits provider to determine how many test cycles they require.

Context
You can create an integration that sends employee benefits data to a benefits provider. Workday simplifies
the configuration process with the Benefits Connector integration template. The template provides
predefined categories of data that you can select and customize for output.

Steps
1. Create Integration System on page 1854.
Enter Benefits Connector at the New Using Template prompt.
2. Set Up Benefits Connector V2 Integration Services on page 545.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Build
• Integration Event
• Integration Process
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select and Set Up Connector Output Fields on page 1864.
5. Set Up Benefits Connector V2 Attributes and Maps on page 546.
6. (Optional) Set Up Integration Sequence Generators on page 1856.
Set up the Workday sequence generator to create unique filenames for integration output files. To
perform this step, enable the BC Filename integration service.
7. (Optional) Add Custom Fields to Connector Output on page 1865.
If the output file requires additional data elements beyond elements offered in the predefined data
sections, create a field override service and configure custom fields.
8. (Optional) For the Changes Only file, you can override the translation logs as a related action on the
integration systemIntegration System > Configure Integration Transaction Log.
9. (Optional) Steps: Set Up Document Transformation Connector on page 571.
10.Launch an Integration on page 23.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 545

11.Test the integration by running the number of test cycles requested by the benefits provider.
12.Perform a full load and validate the results.
Related Information
Concepts
Create Integration System on page 1854
Tasks
Set Up Benefits Connector V1 Attributes and Maps on page 557
Reference
FAQ: Benefit Provider Integration Common Issues on page 530
Steps: Set Up the Workday Benefits Connector V2 Integration
Set Up Benefits Connector V2 Integration Services on page 545
Set Up Benefits Connector V2 Attributes and Maps on page 546
Reference: Benefits Connector Data Sections on page 550
Concept: Benefits Connector V2 Change Detection on page 549
Reference: Benefits Connector V2 Audit Files on page 552

Set Up Benefits Connector V2 Integration Services

Prerequisites
Security: Integration Configure domain in the Integration functional area.

Context
Specify the categories of data or configuration options for the output file.

Steps
1. As a related action on the integration, select Integration > Configure Integration Services.
2. In the Integration Services grid, select the Enabled check box for each integration service that you
want to activate.
Note: Workday requires the Benefits Connector integration service and enables it automatically.
Workday also automatically enables the Transaction Log Service for change detection processing when
you enable the Changes Only integration services.

Option Description
CCB - Benefit Connector v2 Enabled by default. A service that indicates
processing.
CCB Benefits Connector v2 Full File Reports the most recent data in Workday as of
these Effective Date and Last Update launch
parameters:
• Effective Date
• Last Update
• From Effective Date
• From Last Update

CCB - Benefit Connector v2 Changes Only Report changes with an effective date or entry
date within a date range:
• Effective Date
• Last Update
• From Effective Date

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 546

Option Description
• From Last Update

Transaction Log Service Conditionally enabled when you enable the CCB
Benefits Connector V2 Changes Only service.
Workday configures a subset of transaction types
by default. Modify as needed for your integration.

CCB Benefit Connector v2 Payroll Results Provides these additional launch parameters
to the Launch/Schedule Integration task for
reporting payroll contribution start and end dates:
• Payroll Start Date
• Payroll End Update
• Payroll Date Selection Based on:
• Based on Payment Date
• Based on Period End Date

CCB - Sequence Generator Specifies unique output filenames.


CCB - Delivery Service Specifies file transport and encryption options for
the output file.
Integration Document Retention Specifies the duration (in days) that the
integration output is available for viewing.
CCB - Additional Filters Specifies the organizations that you want to
include in the integration.
CCB - Debug Service Provides the ability to filter output by workers as
well as scrub files using these parameters:
• Exclude Members or Only Include Members
• Employees
• Mask Workday Support Files

Next Steps
Select the individual fields to include in each data section, then configure the output file and map Workday
values to the external endpoint. See Reference: Benefits Connector Data Sections on page 550.
Related Information
Steps: Set Up the Workday Benefits Connector V1 Integration
Set Up Benefits Connector V1 Integration Services on page 555
Steps: Set Up the Workday Benefits Connector V2 Integration
Steps: Set Up the Workday Benefits Connector V2 Integration on page 544
Concept: Benefits Connector Workflow on page 548
Concept: Workday Benefits Connector on page 542

Set Up Benefits Connector V2 Attributes and Maps

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 547

Context
After you create a Benefits Connector integration system and select output fields, configure the integration
attributes and maps for the output file.
You can configure required and optional attributes for your integration system, enabling you to customize
how the integration reports the data changes. The integration map enables you to map an internal value to
a different external value in the output file. Workday maps data according to these rules:
• In the Integration Maps grid, add a row for each tenant value. Select the Internal Value and enter the
External Value for the output file.
• (Optional) Provide a Default Value for data elements for values that you haven't mapped.

Steps
1. Access the View Integration System report.
2. As a related action on the integration system, select Integration System > Configure Integration
Attributes.
3. Specify values for the attributes in the Integration Attributes grid:
• For attributes without automatically populated values, add a row and specify a Value.
• For attributes whose automatically populated values you want to change, select the Override
Default Values check box and specify a new Value.
• Optionally specify that a value applies to a particular environment using the Restricted to
Environment field.

Attribute Description
Benefits Plans Add a row for each benefit plan that the
integration system supports. The benefit plan
must exist in Workday; if necessary, use the
Create Benefit Plan task to add a benefit plan.
Document Retention Policy Specify the duration, in days, that the integration
output is available for viewing.
Enable Test Mode Select to limit the number of subscribers in the
output file to 100 and to prevent delivering the file
to the vendor
Include Benefit Eligible Employees Include employees in the population selection
who are eligible but not enrolled.
Include Prior Values Select to include thePriorValueattribute that
contains the previous value for a field.
Organization Type for Organization One, Two, Specify which type of organization to include in
Three, Four, and Five the output file (Example: Cost Center or Region).
When you configure the integration maps, you
map a Workday value for this organization type.
Perform Character Translation Enable translation of UTF-8 accented characters
to nonaccented equivalents.
4. Save your changes, then as a related action on the integration system, select Integration System >
Configure Integration Maps.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 548

5. In the Integration Maps grid, specify output file values for Workday data:
a) Add a row for each Workday value, select the Internal Value, and enter the External Value for the
output file.
b) (Optional) Provide a Default Value for any data elements whose values you haven't mapped.
The contingent worker organization has Regular and Contingent types. In the Worker Type map, define
external values for the Regular and Contingent types. Then create a Default Value of Other for any
unmapped worker types.
You only define mappings for the data elements that you include in the output file. Example: if the
Personal Data Section only includes Gender and Marital Status, specify values in those 2 maps and
leave the other maps in the section empty.
Related Information
Steps: Set Up the Workday Benefits Connector V1 Integration
Set Up Benefits Connector V1 Attributes and Maps on page 557
Steps: Set Up the Workday Benefits Connector V2 Integration
Steps: Set Up the Workday Benefits Connector V2 Integration on page 544
Concept: Benefits Connector Workflow on page 548
Concept: Workday Benefits Connector on page 542

Concept: Benefits Connector Workflow


Workday manages the benefits data extract process by requesting 2 pieces of information: what changes
to look for, and when to look for those changes. When you launch an integration built with Benefits
Connector, you specify:
• The Effective Date when enrollments are valid.
• The Last Update date and time; always use the current moment for this value.
If you enabled the CCB Benefits Connector V2 Changes Only integration service, you must specify:
• The From Effective Date, the effective date for enrollment changes to include in the file.
• The From Last Update date and time, the date of the last successful change file integration.
Workday looks for field-level changes to employee data and generates a benefits extract that reflects
the changes you’re interested in. The transaction log drives the change detection process by tracking
event-based changes to employee data. Through a subscription to transaction log events, the integration
identifies employees whose changes it reports to your payroll provider.
Note: Workday automatically enables the transaction log service for the Changes Only output files. If you
configure this service in your integration, Workday filters employees based on their transaction log entries
within the specified time period. Otherwise, the integration skips this step and all employees pass to the
next stage of processing.
Workday uses this logic to create a benefits output file:
• Find employees eligible for the plan that you specified in the Benefit Plan attribute.
• Filter employees based on subscriptions to transaction log events (if you configured the transaction log
service):
• Select employees who have transaction log events that are effective before or during the defined
date range.
• Exclude events with effective dates forward (future to) the defined date range.
• Compare data for the selected employees at the beginning and end of the date range for which you
launched the integration.
• Identify field-level data changes.
• Determine if the integration includes the changed data in the integration output.
• Include employees who have changes to data in the integration.
• Exclude employees who have no data changes or whose changes don’t affect data in the integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 549

Related Information
Reference
Reference: Integration Status Reports on page 530
Concept: Benefits Connector Workflow
Set Up Benefits Connector V2 Integration Services on page 545
Set Up Benefits Connector V2 Attributes and Maps on page 546
Reference: Benefits Connector Data Sections on page 550
Concept: Benefits Connector V2 Change Detection on page 549
Reference: Benefits Connector V2 Audit Files on page 552

Concept: Benefits Connector V2 Change Detection


Benefits Connector integrations support 2 change detection methods. Using the Change Only or Full
File integration services, you can select the appropriate method depending on the requirements of your
benefits provider. The methods are:
Full File To send a full file to the benefits provider, select this
integration service. The benefits extract includes
employee data that is effective in the defined
date range. When Workday has future-dated
transactions, it excludes them from the extract file.
(Optional) You can also include previous values
for data fields when you enable the Include Prior
Values integration attribute.

Changes Only To send a changes-only file to your benefits


provider, select this method. The benefits extract
includes only changes that:
• You entered in Workday after the date of the last
successful run.
• Are effective before or during the defined date
range.

How Dates Affect Benefits Extracts


Dates are important to understanding the changes that Benefits Connector integrations pick up. If you
discover that events are missing from an extract, look at the relationship between:
• The last successful run date.
• The period start date.
• The event entry date.
• The event effective date.
Example: Events might be missing from an extract if these conditions are true:
• The event entry date is after the last successful run.
• The event effective date isn’t in the current or prior period.
Related Information
Steps: Set Up the Workday Benefits Connector V1 Integration
Concept: Benefits Connector V1 Change Detection on page 559
Steps: Set Up the Workday Benefits Connector V2 Integration
Steps: Set Up the Workday Benefits Connector V2 Integration on page 544
Concept: Benefits Connector Workflow on page 548
Concept: Workday Benefits Connector on page 542

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 550

Concept: Benefits Connector V2 Data Validation and Error Handling


Benefits Connector applies a number of validation rules to employee data based on how you configure
your benefits integration.
View integration messages by accessing one of these reports:

Report Description
Process Monitor View integrations that are currently running or have
already run. To view message details, drill-down on
the numbers in the Errors & Warnings column.
Integration Events Lists integration events and displays the launch
date and time, the name of the person who
launched the integration, its status, and the event
response message.
Integration Messages Provides a status summary and message details for
integration events.

Reference: Benefits Connector Data Sections


Before you build an integration with the Benefits Connector template, familiarize yourself with each section
of the benefits extract. Understand which fields are available for output and how the configuration options
affect integration behavior.
During integration configuration, you enable integration field attributes for each data section that you want
to include in benefits extracts. The integration system has an integration attribute that specifies whether to
create a full extract file, or a file that includes only changes:
• Full extract: the integration includes all data for all employees, regardless of changes.
• Changes only: the integration includes data for employees who had at least 1 change. If an employee
had 1 change, the integration includes all data for all sections for that employee.

Section Description
Header • Every output file has a header section.
• Always includes:
• Effective Date.
• Last Update.
• From Effective Date.
• From Last Update.
• Workday includes these fields only if you enable the Payroll
Results integration service:
• Payroll Start Date.
• Payroll End Date.
• Transmission Type: Changes File or Full File.
• IncludesEmployee Count.

Personal Data • This section has a single record.


• Name fields are based on the legal name.
• Map: Gender and Marital Status values using the integration
maps provided for these values.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 551

Section Description
Status Data • This section has a single record.
• Map Worker Type, Termination Reason, and Leave Type using
the integration maps provided for these values.
• Employee Status codes are: Active, On Leave, On Leave with
Benefits, On Leave with Pay, and Terminated.

Position Data • This section has a single record.


• Reports employee's primary position.
• An employee can belong to several different organizations.
You can include up to 3 organization references in the output
file. Configure the integration attributes to specify which
organization type is valid for each field.
• Map Organization type using the integration map provided for
this value.

Coverage: Health Plan • This section can have multiple records.


• Operation codes are ADD, REMOVE, MODIFY, and NONE
when you enable the Changes Only service.
• Map Plan Type using the integration map provided for this
value.

Coverage: FSA Plan Data • This section can have multiple records.
• Operation codes are ADD, REMOVE, MODIFY, and NONE.
• Map Plan Type using the integration map provided for this
value.

Coverage: Retirement Savings Plan • This section can have multiple records.
Data • Operation codes are ADD, REMOVE, MODIFY, and NONE
when you enable the Changes Only service.
• Map Plan Type using the integration maps provided for these
values.

Coverage: Life and Disability Data • This section can have multiple records.
• The Coverage Target field applies to employees or
dependents.
• Operation codes are ADD, REMOVE, MODIFY, and NONE
when you enable the Changes Only service.
• Map Plan Type using the integration maps provided for these
values.

Coverage: HSA Plan • This section can have multiple records.


• Operation codes are ADD, REMOVE, MODIFY, and NONE
when you enable the Changes Only service.
• Map Plan Type using the integration maps provided for these
values.

Coverage: Additional Benefits Plan • This section can have multiple records.
• Operation codes are ADD, REMOVE, MODIFY, and NONE
when you enable the Changes Only service.
• Map Plan Type using the integration maps provided for these
values.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 552

Section Description
Dependent Data • This section can have multiple records.
• Name fields are based on legal name.
• Map Relationship using the integration maps provided for these
values.

Beneficiary Data • This section can have multiple records.


• Name fields are based on legal name.
• Map Relationship using the integration maps provided for these
values.

Plan Eligibility Data This section can have multiple records.


Payroll Results Data • This section can have multiple records.
• Map Deduction Codes and Accumulation Codes using the
integration maps provided for these values.
Note: This map is required to output payroll data.

Additional Information Create extensible field overrides to add data not included in the
previous sections to the output file.

Related Information
Steps: Set Up the Workday Benefits Connector V1 Integration
Set Up Benefits Connector V1 Attributes and Maps on page 557
Steps: Set Up the Workday Benefits Connector V2 Integration
Steps: Set Up the Workday Benefits Connector V2 Integration on page 544
Concept: Benefits Connector Workflow on page 548
Concept: Workday Benefits Connector on page 542

Reference: Benefits Connector V2 Audit Files


Workday attaches 4 audit reports to each Benefits Connector integration event. After an integration runs,
access the Integration Events report to view the audit files. Select the event that you’re interested in to
open the View Background Process page and then click the Output Files tab. Audit files expire 90 days
after Workday creates them. Workday automatically deletes the files after they expire.

Data Changes Audit


The Data Changes Audit is a readable version of the integration output file. This report has 2 components:

Extract Summary Displays the change detection method and date


range specifications.

Worker Details Provides summarized and detailed views of


employee data changes, and displays the worker
count. The summarized view displays employee
names, IDs, and the categories of changed data.
The detailed view displays current field values.
If the data has changed, the detailed view also
displays prior values. Workday highlights new
records in green, modified records in gray, and
highlights deleted records in red.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 553

To toggle between views for all employees, or


select an employee in the summary list to view
details, select Show or Hide.

Partition Audit Report


The Partition Audit report includes details on all employees that the integration processed when creating
the benefits output file. The employee records identify in what audit file that you can find the employee
record for troubleshooting.

Exception Log Report


The Exception Log report helps you troubleshoot integration errors. The report includes employee details
that generate a warning or error when the integration creates the benefits output file. You can view these
details for each employee to determine why the benefits extract included or excluded the employees:
• Processing details
• Validation messages
• Current properties
• Transaction log details
In some cases, employees had transactions that didn’t affect the set of data configured in the benefits
extract. In other cases, the integration encountered an error while processing these employees.

XML Output File


The output file contains the actual data that the Benefits Connector integration created. This file is in XML
format.

Messages Audit
The Messages Audit is a zip file that contains a summary of web service requests and responses in XML
format. Workday generates this audit report for troubleshooting purposes.
Related Information
Steps: Set Up the Workday Benefits Connector V1 Integration
Concept: Benefits Connector V1 Data Validation and Error Handling on page 560
Steps: Set Up the Workday Benefits Connector V2 Integration
Steps: Set Up the Workday Benefits Connector V2 Integration on page 544
Concept: Benefits Connector Workflow on page 548
Concept: Workday Benefits Connector on page 542

FAQ: Benefits Connector


Does Benefits Connector support changing The Benefits Connector template itself doesn't
output field values to uppercase? include the ability to change the case of field values.
Example: from Logan Mcneil to LOGAN MCNEIL.
The Benefits Connector output file can require a
transformation into the file format that your benefits
provider uses. To the file format, use a Document
Transformation integration or a Studio-based
integration. You could change the case of field
values using that subsequent transformation.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 554

Workday Benefits Connector (V1)


Steps: Set Up the Workday Benefits Connector V1 Integration

Prerequisites
• Request the file specification from your benefit provider so that you can familiarize yourself with their
data requirements.
• Compare the data requirements for your benefit provider with the output options provided by Benefits
Connector.
• Determine an approach for transforming integration output into the benefit provider format. Example: a
Document Transformation integration or Workday Studio integration.
• Plan out the number and type of test cycles that the benefits provider requires before certifying your
integration. Work with your benefits provider to determine how many test cycles they require.

Context
You can create an integration that sends employee benefits data to a benefits provider. Workday simplifies
the configuration process with the Benefits Connector integration template. The template provides
predefined categories of data that you can select and customize for output.

Steps
1. Create Integration System on page 1854.
Enter Benefits Connector at the New Using Template prompt.
2. Set Up Benefits Connector V1 Integration Services on page 555.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Person Data: Birth Place
• Person Data: Citizenship Status
• Person Data: Date of Birth
• Person Data: Date of Death
• Person Data: Disabilities
• Person Data: Gender
• Person Data: Home Contact Information
• Person Data: ID Information
• Person Data: Marital Status
• Person Data: Military Status
• Person Data: Nationalities
• Person Data: Personal Data
• Reports: Pay Calculation Results for Worker (Results)
• Worker Data: Beneficiaries and Dependents
• Worker Data: Benefit Elections
• Worker Data: Compensation By Organization
• Worker Data: Public Worker Reports
• Worker Data: Work Contact Information
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select and Set Up Connector Output Fields on page 1864.
5. Set Up Benefits Connector V1 Attributes and Maps on page 557.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 555

6. (Optional) Set Up Integration Sequence Generators on page 1856.


Set up the Workday sequence generator to create unique filenames for integration output files. To
perform this step, enable the BC Filename integration service.
7. (Optional) Add Custom Fields to Connector Output on page 1865.
If the output file requires additional data elements beyond elements offered in the predefined data
sections, create a field override service and configure custom fields.
8. As a related action on the integration system, select Integration System > Configure Integration
Transaction Log.
Select Subscribe to all Transaction Types except and select the transactions to exclude from
benefits processing.
9. (Optional) Steps: Set Up Document Transformation Connector on page 571.
10.Launch an Integration on page 23.
11.Test the integration by running the number of test cycles requested by the benefits provider.
12.Perform a full load and validate the results.
Related Information
Steps: Set Up the Workday Benefits Connector V1 Integration
Set Up Benefits Connector V1 Integration Services on page 555
Set Up Benefits Connector V1 Attributes and Maps on page 557
Concept: Benefits Connector V1 Change Detection on page 559
Concept: Benefits Connector V1 Data Validation and Error Handling on page 560
Reference: Benefits Connector V1 Audit Files on page 561

Set Up Benefits Connector V1 Integration Services

Prerequisites
Security: Integration Configure domain in the Integration functional area.

Context
Specify which categories of data to include in the output file and select output file options.

Steps
1. As a related action on the integration, select Integration > Configure Integration Services.
2. In the Integration Services grid, select the Enabled check box for each integration service that you
want to activate. These integration services provide categories of data or configuration options for the
output file.
Note: The Benefits Connector integration service is required and enabled automatically. The
Transaction Log Service isn’t enabled automatically, but is required for change detection processing.

Option Description
BC Change File Launch Parameters Provides an additional Change Detection launch
parameter to the Launch/Schedule Integration
task when generating change files. The launch
parameter includes these options:
• All_Effective
• Incremental

BC Workday Payroll Service Provides these additional launch parameters


to the Launch/Schedule Integration task for
reporting payroll contribution start and end dates:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 556

Option Description
• Payroll Start Date
• Payroll End Update

BC Personal Data Section Fields Provides employee personal data and contact
information.
BC Status Data Section Fields Provides employment status and service dates.
BC Position Data Section Fields Provides:
• Job profile data.
• Salary and base compensation elements.
• Organization membership data.

BC FSA Plan Data Section Fields Provides FSA (Flexible Spending Account) plan
data, including:
• Enrollment and coverage dates.
• Employee and employer goal amounts.
• Period and Year-To-Date (YTD) contribution
amounts.

BC Retirement Savings Data Section Fields Provides data for retirement savings plans,
including:
• Plan identification data.
• Coverage dates.
• Payroll dates.
• Payment dates.
• Loan data.
• To-date amounts.

BC Life and Disability Data Section Fields Provides life and disability plan data, including:
• Plan identification data.
• Enrollment period and coverage dates.
• Approved coverage level details.
• Beneficiary IDs.

BC Dependent Data Section Fields Provides personal data and contact information
for dependents of employees.
BC Eligibility Data Section Fields Provides Benefit Plans and plan eligibility dates
for the employee. Use for Retirement Savings
Plans only.
Transaction Log Service Provides a record of event-based changes to
employee data that are relevant to benefits
integrations. Don’t enable this service in
integrations that generate full extracts.
BC Delivery Service Provides file transport and encryption options for
the output file.
BC Filename Provides unique output filenames by using the
Workday sequence generator.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 557

Option Description
CCB - Debug Service Generates a Messages Audit file each time the
integration runs.
For best performance, Workday recommends
that you disable this integration service for any
integration that runs in Production.

Next Steps
Select the individual fields to include in each data section, then configure the output file and map Workday
values to the external endpoint.
Related Information
Steps: Set Up the Workday Benefits Connector V2 Integration
Set Up Benefits Connector V2 Integration Services on page 545
Steps: Set Up the Workday Benefits Connector V1 Integration
Steps: Set Up the Workday Benefits Connector V1 Integration on page 554

Set Up Benefits Connector V1 Attributes and Maps

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
After you create a Benefits Connector integration system and select output fields, configure the integration
attributes and maps for the output file.
Integration attributes define various processing options for the output file, such as:
• The retention period for audit files.
• Data validation rules.
• Whether Workday always includes data or only when changes occur.
Integration maps control how Workday maps values to the external benefits provider. Only a subset of data
elements requires an integration map. Workday maps data according to these rules:
• If an integration map has rows of data, Workday uses the map to convert Workday values to external
values. If you don't define a Workday value in the map, Workday uses the automatically populated
value for the map. If the automatically populated value is blank, Workday issues an error or a warning
message and the external value is empty.
• If an integration map is empty, Workday uses reference IDs in the output file. In the View Integration
System report, click the Integration Maps tab to see which reference ID corresponds to each map.
The only exception is the Region map, which uses the Workday region name instead of a reference ID.
If a Workday value has no reference ID, Workday issues an error or warning and the external value is
empty.

Steps
1. Access the View Integration System report.
2. As a related action on the integration system, select Integration System > Configure Integration
Attributes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 558

3. Specify values for the attributes in the Integration Attributes grid:


• For attributes without automatically populated values, add a row and specify a Value.
• For attributes whose automatically populated values you want to change, select the Override
Default Values check box and specify a new Value.
• Optionally specify that a value applies to a particular environment using the Restricted to
Environment field.

Attribute Description
Benefits Plans Add a row for each benefit plan that the
integration system supports. The benefit plan
must exist in Workday; if necessary, use the
Create Benefit Plan task to add a benefit plan.
Client Name Enter your organization name. The integration
includes this value in the benefits extract header.
Client Number Unique number that identifies you to your benefits
provider.
Country Code Specifies the country code used in addresses
in the benefits extract. If you don't override
this attribute, the integration uses ISO 3166-1
Alpha 2 codes. If you want to provide 3-
digit codes instead, add a row and select
ISO_3166-1_Alpha-3_Code.
Document Retention Policy If you don't override this attribute, sets to 30 days.
You can change the retention period to 60, 90,
120, or 180 days.
Employee Deduction Codes Select payroll deductions to include in the output
file.
Full Extract Generates a full file of employee data, including
all data sections and fields that you configure
in the integration, rather than a changes-only
file. If you select this option, don’t enable the
Transaction Log Service.
Identifier Type for Alternative Identifier Select the type of identifier for employees and
dependents.
Include Prior Values Includes the prior values of data elements that
have changed.
Organization Type for Organization One, Two, Specify which type of organization to include in
Three, Four, and Five the output file (Example: Cost Center or Region).
When you configure the integration maps, you
map a Workday value for this organization type.
Remove Accented Characters Replaces accented characters in employee data
with the unaccented equivalent characters in the
output file.
Use Payment Date Specifies that Workday use the payment date for
employee payroll when generating the output file.
Use Preferred Name when present If you don't override this attribute, the output
file uses Legal Name. To use Preferred Name
instead of Legal Name, select the check box.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 559

Attribute Description
Version Select the version number of the output file.
The initial version number matches the current
Workday version number. In future releases, you
upgrade to a later version only if you need new
functionality.
Worker Data Validation Select how Workday resolves processing errors
for employee data, such as when a mapped field
contains a value that you didn't define in the
corresponding map:
• abort: Workday doesn’t create an integration
output file.
• include: Workday includes the affected
employee data and returns a warning on the
associated integration process event.
• omit: Workday doesn’t include the affected
employee data on the integration output file.

Output Document Tags Applies selected tags to the integration output file.
4. Save your changes, then as a related action on the integration system, select Integration System >
Configure Integration Maps.
5. In the Integration Maps grid, specify output file values for Workday data:
a) Add a row for each Workday value, select the Internal Value, and enter the External Value for the
output file.
b) (Optional) Provide a Default Value for any data elements whose values you haven't mapped.
Example: your organization has Hourly and Salary pay rate types. In the Pay Rate Type map, define
external values for the Hourly and Salary rate types. Then create a Default Value of Other for any
unmapped pay rate types.
You only define mappings for the data elements that you include in the output file. Example: if the
Personal Data Section only includes Gender and Marital Status, specify values in those 2 maps and
leave the other maps in the section empty.
Related Information
Steps: Set Up the Workday Benefits Connector V2 Integration
Set Up Benefits Connector V2 Attributes and Maps on page 546
Reference: Benefits Connector Data Sections on page 550
Steps: Set Up the Workday Benefits Connector V1 Integration
Steps: Set Up the Workday Benefits Connector V1 Integration on page 554

Concept: Benefits Connector V1 Change Detection


Benefits Connector integrations support 2 change detection methods. Using the Change Detection launch
parameter, you select the appropriate method depending on the requirements of your benefits provider.
The methods are:

Include all changes effective in the defined time To send a full file to the benefits provider, select this
period method. The benefits extract includes all changes
to employee data that are effective in the defined
date range. The extract includes these changes
regardless of when you entered the changes
into Workday. When Workday has future-dated
transactions, Workday excludes them from the
extract file. Workday includes these transactions

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 560

when their effective date is in the defined date


range processed by the integration.

Include only changes entered since the last To send a changes-only file to your benefits
successful run provider, select this method. The benefits extract
includes only changes that:
• You entered in Workday after the date of the last
successful run.
• Are effective before or during the defined date
range.

How Dates Affect Benefits Extracts


Dates are important to understanding the changes that Benefits Connector integrations pick up. If you
discover that events are missing from an extract, look at the relationship between:
• The last successful run date.
• The period start date.
• The event entry date.
• The event effective date.
Example: Events might be missing from an extract if:
• The event entry date is after the last successful run, but the event effective date isn’t in the current or
prior period.
• The event entry date isn’t after the last successful run and change detection isn’t set to All Effective.
• The event entry date isn’t after the last successful run and change detection is set to All Effective, but
the event effective date isn’t in a specified date range.
Related Information
Steps: Set Up the Workday Benefits Connector V2 Integration
Concept: Benefits Connector V2 Change Detection on page 549
Steps: Set Up the Workday Benefits Connector V1 Integration
Steps: Set Up the Workday Benefits Connector V1 Integration on page 554

Concept: Benefits Connector V1 Data Validation and Error Handling


Benefits Connector applies a number of validation rules to employee data based on how you configure
your benefits integration. An integration attribute called Worker Data Validation gives you control over
integration processing when employees fail these validation checks. Workday provides 3 options that can
accommodate the needs of your benefits provider:

Include Includes an employee in a benefits output file even


if validation errors occur. Integration processing
continues and Workday reports the errors as
warnings on the integration event.
Select this option if your benefits provider can
accept benefits output files that contain some
invalid data. The benefits provider can fix the
imported data and you can apply the same changes
to the data in Workday later.

Omit Excludes data for an employee from a benefits


output file when validation errors occur. Integration
processing continues, Workday reports the errors,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Benefits Connectors | 561

and the benefits output file contains data for the rest
of the employees.
Select this option if your benefits provider rejects
benefits files that contain invalid data. In this case,
the invalid or missing data for 1 employee doesn’t
hold up benefits processing for other employees.
You can update the employee data in Workday later
and generate a supplemental benefits output file.

Abort Stops all integration processing when data


validation fails for any employee. This option is
useful when a benefits provider can only process a
single benefits output file per period. In this case,
you can fix the employee data in Workday and
recreate the benefits extract. The integration reports
this action with critical severity message.

View integration messages by accessing one of these reports:

Report Description
Process Monitor View integrations that are currently running or have
already run. To view message details, drill-down on
the numbers in the Errors & Warnings column.
Integration Events Lists integration events and displays the launch
date and time, the name of the person who
launched the integration, its status, and the event
response message.
Integration Messages Provides a status summary and message details for
integration events.

Related Information
Steps: Set Up the Workday Benefits Connector V2 Integration
Reference: Benefits Connector V2 Audit Files on page 552
Steps: Set Up the Workday Benefits Connector V1 Integration
Steps: Set Up the Workday Benefits Connector V1 Integration on page 554

Reference: Benefits Connector V1 Audit Files


Workday attaches 4 audit reports to each Benefits Connector integration event. After an integration runs,
access the Integration Events report to view the audit files. Select the event that you’re interested in to
open the View Background Process page and then click the Output Files tab. Audit files expire 90 days
after Workday creates them. Workday automatically deletes the files after they expire.

Data Changes Audit


The Data Changes Audit is a readable version of the integration output file. This report has 2 components:

Extract Summary Displays the change detection method and date


range specifications.

Worker Details Provides summarized and detailed views of


employee data changes, and displays the worker
count. The summarized view displays employee
names, IDs, and the categories of changed data.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 562

The detailed view displays current field values.


If the data has changed, the detailed view also
displays prior values. Workday highlights new
records in green, modified records in gray, and
deleted records in red.
To toggle between views for all employees, or
select an employee in the summary list to view
details, select Show or Hide.

Diagnostic Audit
The Diagnostic Audit is designed to help you troubleshoot integration errors. The report includes details
on all employees that the integration processed when creating the benefits output file. You can view these
details for each employee to determine why the benefits extract included or excluded the employees:
• Processing details
• Validation messages
• Current properties
• Transaction log details
In some cases, employees have transactions that don’t affect the set of data configured in the benefits
extract. In other cases, the integration encounters an error while processing these employees.
You can also use the Diagnostic Audit to tune the performance of a Benefits Connector integration. The
audit lists the transaction log entries that the integration processed for each employee. If many employees
in the diagnostic audit file don’t have relevant data changes, reconfigure the transaction log service to
exclude certain transaction types.

Benefits Extract
The benefits extract contains the actual data that the Benefits Connector integration created. This file is in
XML format.

Messages Audit
The Messages Audit is a zip file that contains a summary of web service requests and responses in XML
format. Workday generates this audit report for troubleshooting purposes. Workday generates this file only
if you enable the CCB - Debug Service integration service.
Note: For best performance, Workday recommends that you disable this integration service for any
integration that runs in Production.
Related Information
Steps: Set Up the Workday Benefits Connector V1 Integration
Steps: Set Up the Workday Benefits Connector V1 Integration on page 554

Data Initialization Service (DIS) Integration

Concept: Data Initialization Service (DIS)


Custom integrations can use a Data Initialization Service (DIS) to gather data using report fields in
Workday. The Data Initialization Service is an integration service that you create, configure, and associate
with an integration based on the Cloud Integration Template. This service provides these benefits:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 563

• DIS provides flexible configuration options for navigating to as many related business objects as your
integration requires, using Document Builders. Example: you can navigate from Worker, to Dependents,
to Benefit Elections, to Beneficiaries.
• You can configure these custom integrations to extract only the data fields that you need. DIS improves
performance by eliminating processing time spent retrieving, filtering, and joining data.
• DIS provides data extract parallelization, improving performance and reducing complexity.
• DIS doesn’t make API calls. Your integration is more resilient to network fluctuations and more
performant. Using DIS eliminates time spent waiting for data over the network.
• Time spent gathering data in DIS doesn’t count toward the Studio processing time limit. Using DIS
reduces the failure rate of your integrations and improving the number of integrations you can run
overall.
• You can assign a DIS to more than 1 custom integration. You can associate more than 1 DIS with a
Cloud Integration Template-based integration.
• You can nest multiple sublevels of data. Using Document Builders, you can group related data together,
then add that data to integration output. DIS currently doesn't support file data types. Grouping related
data together improves performance.

Overview
DIS is an integration service that you add (as a custom integration service) to an integration based on the
Cloud Integration Template. This service enables you to define:
• How to extract data from Workday.
• How to format the data in XML.
Because DIS works with template-based integrations, you can schedule the integration, and specify
delivery options.
Related Information
Reference
Workday 33 What's New Post: Data Initialization Service for Custom Integrations

Steps: Set Up Data Initialization Service (DIS) Integration

Prerequisites
• Evaluate your integration processing needs before setting up this integration.
• (Optional) Write a Studio integration to retrieve and process DIS documents.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
You can build a custom integration that exports only the data that your integration needs, in a format that
you define. You can select report fields and calculated fields

Steps
1. Create Integration System on page 1854.
Enter Cloud Integration Template at the New using Template prompt.
2. From the related actions menu of the integration, select Integration System > Configure Integration
Services.
3. In the Integration Service prompt, select Create Integration Data Initialization Service.
4. Set Up Integration Data Initialization Service on page 564.
5. (Optional) Set Up Sub-Document for Data Initialization Service (DIS) on page 569.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 564

6. (Optional) To write a Studio integration to retrieve and process DIS documents, select Integration
System > Add Cloud Collection as a related action on the integration.
Use the parallel Studio component to process files in parallel, which doesn’t increase load on tenants
and remote servers.
7. (Optional)Create Integration Business Process on page 1838.
8. (Optional) Set Up Integration Delivery on page 1839.
9. Grant the account under which the integration runs access to these domains:
• Integration Event
• View access to any domain that secures the report fields and calculated fields that your Data
Initialization Service uses.
See: Steps: Grant Integration or External Endpoint Access to Workday.
10.Launch an Integration on page 23.
11.(Optional) Use the Integration Event > Retrieve Technical Files related action to view DIS Partial
Documents, DIS Performance Log, Exception Log, and schemas for these logs.
Use the Exception Log to view diagnostic information about all exceptions thrown when Workday uses
these configured items to build the DIS output files:
• Population.
• Report fields.
• Calculated fields.
12.(Optional) Use the Integration Event > Generate DIS Performance Summary related action after the
integration completes to generate 1 HTML summary report per DIS output file.
The report provides a summary of the longest running fields and instances. Workday doesn't track fields
that take less than 5 milliseconds. Workday doesn't collect performance data once the raw performance
log exceeds 4 megabytes.

Set Up Integration Data Initialization Service

Prerequisites
Security: Integration Build Custom Services domain in the Integration functional area.

Context
You can create a Data Initialization Service and define how the service extracts data from Workday.
You can define file formatting and field attributes. You can then add the service to a Cloud Integration
Template-based integration system.

Steps
1. Access the Create Integration Data Initialization Service task.
2. As you complete the Output Document section, consider:
Option Description
Document Filename Workday applies this name to the partial and final
integration output files. Workday appends partial
files with a - character and number of the partition.
Example: HelloWorldDIS-23.xml.
Wrapper Element Name Workday applies this value as the root XML
element in the integration output file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 565

3. As you complete the Population section, consider:


Option Description
Population using Select a custom advanced report that defines
the data set to populate the integration. The
integration uses this report and the report filters to
define the population only. The integration doesn't
use any of the report fields in the custom report or
the namespaces of the report. The custom report
must be an advanced report.

Returned Business Object Workday displays the primary business object for
the data source of the custom report.
Order using (Optional). To specify the sort order for data
fields, select a Text report field or calculated field.
If you don't select a report field or calculated field:
• The integration uses the order of the custom
report from the Population using field.
• The integration doesn't use the sort order of
the custom report.

Partition Size (Optional). You can select the maximum


number of instances of the population per
partial integration output file. To reduce out of
memory or time risks with downstream processing
optimization, Workday recommends that you
specify 25, or the minimum possible size. The
maximum size is 2000. Each partition has a 2-
hour process limit.
4. As you complete the Schema and Build section, consider:
Option Description
Web Service Alias Specify the name of the XML node element for 1
object of the population.
Do Not Merge Documents Workday recommends that you select this check
box. If selected, the integration doesn't merge
partial documents. Example: If the integration
returns 45 workers, and you set the Partition
Size to 25, Workday generates 2 output files.
If you select this check box, create a downstream
integration (such as a Studio integration) to
process and merge the partial documents in
parallel. Using this approach doesn't increase the
load on tenants and remote servers.

Field Details • To create a single field, select Data Type.


Then, specify the data type that matches the
report field or calculated field that you want to
use. You can override the datatype returned by
the report or calculated field.
Instances (plural) datatype serializes using
Reference IDs. For Instances (plural) cast
to text, Workday uses the display ID in

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 566

Option Description
the integration output. Reference ID Type:
Applies only to fields that return Instances
(plural). Select a reference ID to include in
the integration output. If you don't select a
reference ID type, the integration includes all
reference IDs in the integration output.
• To create a subdocument with related data
fields (Example: Address fields for a worker
home address), select Sub-Document.

Build content using • For a single field, select the report field from
the Value prompt. Or, select a Document
Parameter created and saved in Step 7.
Workday displays report fields associated with
the Returned Business Object.
• For a subdocument, select or create
a Document Builder that defines the
subdocument.

Loop on instances Select a report field to loop on the instances for


the document builder. The return type of the field
must match the context business object of the
document builder.
Workday doesn't display report fields with
required prompts.

Value Select a report field or calculated field based on


the business object of the document. This prompt
displays only:
• Report fields and calculated fields with a data
type that matches the Data Type value.
• All fields if the Data Type field is empty.

Value Type (External Parameter Select how you want to provide values for
Assignment(s)) prompts that the report field or calculated field
uses.
Value (External Parameter Assignment(s)) Enter a value depending on the Value Type:
• Determine Value at Runtime: select a report
field or calculated field.
• Document Parameter: select a parameter
that you defined in the previous step.
Workday requires that you save the document
parameter before you can use it here.
• Specify a Value: select or enter a value based
on the prompt.

5. (Optional) In the Field Attribute Service Options section, consider:


Option Description
Field Attribute Service? Enables you to configure formatting options for
fields that you select in the Schema and Build
grid.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 567

Option Description
Show "Required" Option Adds a Required flag to the DIS schema. This
option doesn't affect whether the integration
includes data in the output file.
Show "Maximum Length" Option Enables you to define maximum lengths for fields
in the output file.
6. As you complete the Parameters section, consider:
Option Description
Value Type Select how you want to provide values in the
Value field.
Value Enter a value depending on the Value Type:
• Determine Value at Runtime: select a report
field or calculated field based on the business
object of the document. This prompt displays
only:
• Report fields and calculated fields with a
data type that matches the Value Type
value.
• All fields if the Value Type field is empty.
• Specify a Value: select or enter a value based
on the prompt.
• Integration Attribute: Select an integration
attribute of the integration system. Available for
Global Parameters only.
• Launch Parameter: Select a launch parameter
of the integration system. Available for Global
Parameters only.

Value Type (External Parameter Select how you want to provide values for
Assignments(s)) prompts that the report field or calculated field
uses.
Value (External Parameter Assignments(s)) Enter a value depending on the Value Type:
• Determine Value at Runtime: select a report
field or calculated field.
• Specify a Value: select or enter a value based
on the prompt.

7. As you complete the Report Criteria section, consider:


Option Description
Value Type Select how you want to provide values for the
prompts.
Value Value: Enter a value depending on the Value
Type:
• Determine Value at Runtime: select a report
field or calculated field.
• Document Parameter: select a parameter that
you defined in the previous step. Save the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 568

Option Description
document parameter before you can use it
here.
• Specify a Value: select or enter a value based
on the prompt.

8. (Optional) As you complete the Integration Attributes section, consider:


Option Description
Attribute Type Select the type of attribute:
• Enumeration: Select an integration
enumeration from the prompt. To create a new
integration enumeration, access the Create
Integration Enumeration Definition task.
• Data Type: Select a datatype to apply.

Multi-Select Enables you to enter multiple values for the


attribute.
Option(s) Select additional attribute configuration options:
• Display As Password: Displays the entered
text as asterisks.
• Required for Launch: Prevents the integration
from launching if the attribute has no value.

You can set separate values for each integration that uses the Data Initialization Service. You can also
use attributes as report filters or output them as fields using doc parameters.
9. (Optional) As you complete the Integration Maps section, consider:
Option Description
Internal Value Type • Enumeration: Select an integration
enumeration from the prompt. To create a new
integration enumeration, access the Create
Integration Enumeration Definition task.
• Data Type: Select a datatype to apply.
• Option(s): To display the entered text as
asterisks, select Display As Password.

External Value Type • Enumeration: Select an integration


enumeration from the prompt. To create a new
integration enumeration, access the Create
Integration Enumeration Definition task.
• Data Type: Select a datatype to apply.
• Option(s): To display the entered text as
asterisks, select Display As Password.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 569

Option Description
Exception Rule(s) Select exception rules to apply to the map.
Workday prevents the integration from running if
the integration triggers the exception rules.

• Use the Integration Document Field > Configure Integration Map related action to add the map
to a field you selected in the Schema and Build grid. The Internal Value Type of the map must
match the Build content Using field value.
• The External Value Type of the map must match the data type of the report field or calculated field.
• Configure a default value for the map that the integration uses when there's no default value for the
integration.
10.As you complete the Launch Parameters section, consider:
Option Description
Launch Parameter Type • Enumeration: Select an integration
enumeration from the prompt. To create a new
integration enumeration, access the Create
Integration Enumeration Definition task.
• Data Type: Select a datatype to apply.

Option(s) Select additional options for the launch


parameter.
Default Processing Default values when the integration launches.

Each integration that uses DIS displays the DIS launch parameters, as well as the launch parameters
of its other services. You can use launch parameters to configure variable fields used to populate DIS
output dynamically.

Set Up Sub-Document for Data Initialization Service (DIS)

Prerequisites
Security: Integration Build Custom Services domain in the Integration functional area.

Context
You can use the Create Document Builder task to define a discrete set of related data fields. You can
then use the Document Builder in:
• A Data Initialization Service.
• Another Document Builder.
The Document Builder specifies a group of fields for an integration output document.

Steps
1. Access the Create Document Builder task.
2. Specify a Document Builder Name and Context Business Object.
The Context Business Object field enables you to access fields related to a different Primary
Business Object than the object that the parent subdocument uses.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Data Initialization Service (DIS) Integration | 570

3. As you complete the Schema and Build section, consider:


Option Description
Field Details • To create a single field, select Data Type.
Then, specify the data type that matches the
report field or calculated field that you want to
use. You can override the data type returned
by the report or calculated field.
Instances (plural) data type serializes using
Reference IDs. For Instances (plural) cast
to text, Workday uses the display ID in
the integration output. Reference ID Type:
Applies only to fields that return Instances
(plural). Select a reference ID to include
in the integration output. You must select
a Reference ID Type. If you don't select a
Reference ID Type, Workday won't include any
reference IDs in the integration output.
• To create a subdocument with related data
fields (Example: Address fields for a worker
home address), select Sub-Document.

Build content using • For a single field, select the report field from
the Value prompt. Or, select an existing
Document Parameter. Workday displays report
fields associated with the Returned Business
Object.
• For a subdocument, select or create
a Document Builder that defines the
subdocument.

Loop on instances Select a report field to loop on the instances for


the document builder. The return type of the field
must match the Context Business Object of the
document builder.
Value Type (External Parameter Select how you want to provide values for
Assignment(s)) prompts that the report field or calculated field
uses.
Value (External Parameter Assignment(s)) Enter a value depending on the Value Type:
• Determine Value at Runtime: select a report
field or calculated field.
• Document Parameter: select a parameter
that you defined in the previous step.
Workday requires that you save the document
parameter before you can use it here.
• Specify a Value: select or enter a value based
on the prompt.

Result
You can select this Document Builder from the Document Builder prompt in:
• The Create Integration Data Initialization task.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 571

• The Create Document Builder task, if you want to add this Document Builder as a subdocument under
another Document Builder.

Document Transformation Connector

Steps: Set Up Document Transformation Connector

Prerequisites
Before setting up this integration, you must:
• Create an integration system that generates the file in the original format.
• Determine what format the recipient of the output file requires.
• Review the available options for Element Transformation and Validation (ETV) and XML To Text (XTT)
formatting.
• Create an Extensible Stylesheet Language Transformation (XSLT) file that defines the transformation
from Workday XML format to the recipient format.

Context
Create a Document Transformation integration to take the output file generated by a Connector and
transform the file based on instructions in an XSLT file. Document transformation supports only Connector
integrations such as Benefits Connector, Payroll Interface, or Core Connector: Worker. Since these
integrations don't support a specific endpoint, their XML output documents require transformation before
the integration sends them to the endpoint.

Steps
1. Access the Create Integration System task and at the Integration Template prompt, enter Document
Transformation.
Security: Integration Build in the Integration functional area.
2. As a related action on your Document Transformation, select Workday Integration System >
Configure Integration Attributes, then add a row for each attribute and specify a value:
Option Description
Transformation Select tags to use to find tagged documents and
to apply to output documents:
• Input Document Tags. Select the tags that
the Document Transformation integration
should search for. The integration system will
process the first document that it finds with a
tag matching what you specify. If empty, the
integration searches for documents tagged
Deliverable.
• Output Document Tags. Select the tags
that the Document Transformation integration
should apply to a document after transforming
it. A subsequent Document Delivery Service
step can use the tag to identify a document for
delivery to a specific endpoint. If empty, the
integration applies a Deliverable tag.

Output Encoding Select the encoding of the output file. Examples:


US-ASCII, ISO-8859-1, UTF-8, UTF-16. This

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 572

Option Description
value overrides any encoding that you specify in
the XSLT transformation file.
Audit Validation Messages Attaches complete validation messages for each
event in the Messages Audit. If not selected,
the integration generates a single message for
all events and doesn’t include full details for all
events.
Multiple Input Documents Processes all input documents with tags that
match all of the tags specified on the Input
Document Tags attribute.
The tags enable the integration to process
multiple input documents on a single XSLT file.
Attaches complete validation messages for each
event in the Messages Audit. If not selected, the
integration generates a single message for all
events and doesn’t include full details.

Carry Forward Input Tags Adds tags to the output document from the
corresponding input document and the Output
Document Tags attribute.
The tags enable you to identify transformed
output documents uniquely.

Integration Document Retention Enter the number of days that Workday should
preserve output files.

Security: Integration Configure in the Integration functional area.


3. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
security domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Set Up Integration Sequence Generators on page 1856.
5. As a related action on your integration system, select Integration System > Configure Integration
Attachment Service and add the XSLT file that defines how the integration system transforms output
documents.
Security: Integration Configure in the Integration functional area.
6. Create Integration (Step).
Add the integration system as a subprocess on the business process for the outbound integration
system that generates the Workday XML output file.
Related Information
Concepts
Concept: Integration Business Processes on page 1836

Reference: Arithmetic Attributes for Document Transformation

Overview
These attributes enable you to:
• Count the number of times an element occurs in a document.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 573

• Calculate the sum of the values in a number of elements.


You can place the resulting number into another element. This action is a common requirement for text
formats that require a footer to contain such totals. Each of these attributes contains the name of a variable
or a comma-separated list of variable names.
Note: Element Transformation and Validation (ETV) and XML To Text (XTT) variables share scope
as internal variables used by the Document Transformation Connector. The Document Transformation
Connector prefixes its variables with dt. To avoid conflicts, don't name your variables with a prefix of dt.
• addNumber – Adds the value of the element to the existing value of the variable.
• incrementNumber – Increments the value of the variable by one.
• number – Replaces the value of the element with the value of the variable.
• setBoolean – Sets the variable to a Boolean value.
• setNumber – Sets the variable to the value of the element.
• setProperty – Sets the variable to a string value.

addNumber

Summary Adds the numeric value of the current element to a


variable.
Valid Values A comma-separated list of variable names.
Scope Element only.

The addNumber attribute adds the numeric value of the current element to the variable named in the
attribute. Typically, this action updates a single variable. You can update multiple variables by providing a
comma-separated list of variable names.
Calculate the total of 2 record elements:

<Sample>
<record etv:addNumber="aNumber">3.56</record>
<record etv:addNumber="aNumber">1.01</record>
<result etv:number="aNumber"/>
</Sample>

This example produces:

<Sample>
<record>3.56</record>
<record>1.01</record>
<result>4.57</result>
</Sample>

incrementNumber

Summary Counts the number of occurrences of an element.


Valid Values A comma-separated list of variable names.
Scope Element only.

Increment the value of a variable or variables named in the attribute. To increment multiple variables,
included a comma-separated list of variable names. The attribute usually is attached to each occurrence
of the element that you want to count. The number attribute can then be used to place the value of the
variable into the results produced. Workday assumes that all number variables have a value of zero when
first used or retrieved.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 574

Count the occurrence of elements:

<Sample>
<record etv:incrementNumber="aNumber">3.56</record>
<record etv:incrementNumber="aNumber">1.01</record>
<result etv:number="aNumber"/>
</Sample>

This example produces:

<Sample>
<record>3.56</record>
<record>1.01</record>
<result>2</result>
</Sample>

number
The count element is populated with the number of incrementNumber attributes that have been found in
the document up to this point. Because the execution of the incrementNumber attribute updates the value
of a mediation context property, it's possible to access or modify this property across ETV invocations.
Example: when processing a large XML input set the assembly can split and apply ETV attributes to the
XML in chunks. Using the same property with incrementNumber across all ETV invocations enables the
developer to share a running count across the entire input.

Summary Workday replaces the value of the element with the


value of the variable.
Valid Values A variable name.
Scope Element only.

Place the value of a variable into an element. Use this attribute with setNumber, incrementNumber, and
addNumber to provide counts and totals in the footers of documents. All number variables are assumed
to have a value of zero when first used or retrieved. They're not scoped and can be reassigned with the
setNumber attribute.
Populate the value of the result element:

<Sample>
<record etv:addNumber="aNumber">3.56</record>
<record etv:addNumber="aNumber">1.01</record>
<result etv:number="aNumber"/>
</Sample>

This example produces:

<Sample>
<record>3.56</record>
<record>1.01</record>
<result>4.57</result>
</Sample>

setBoolean

Summary Sets the value for a variable to a Boolean value.


Valid Values A property name.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 575

Scope Element only.

Define the property of a variable. Use assembly, XSLT, or other programming constructs like any other
property in the mediation context. Workday generates the Boolean value using Java rules for determining
true/false values.
Set the value of a property in the mediation context:

<record etv:setBoolean="error.indicator">true</record>

This XML populates the mediation context property error.indicator with the Boolean TRUE:

setNumber

Summary Sets the value for a variable to the value in the


element.
Valid Values A variable name.
Scope Element only.

Place the value of an element into a variable. Use this attribute with incrementNumber, addNumber, and
number to provide counts and totals in the footers of documents.
Initialize a variable that you'll increment later and use to populate the count element:

<Sample>
<initial etv:setNumber="aNumber">5</initial>
<records>
<record etv:incrementNumber="aNumber">3.56</record>
<record etv:incrementNumber="aNumber">1.01</record>
</records>
<result etv:number="aNumber"/>
</Sample>

This example produces:

<Sample>
<initial>5</initial>
<records>
<record>3.56</record>
<record>1.01</record>
</records>
<count>7</count>
</Sample>

setProperty

Summary Sets the value for a variable to a string value.


Valid Values A string name.
Scope Element only.

Place a string value into a variable. Access the value using assembly, XSLT, or other programming
constructs like any other property in the mediation context.
Set the value of a property in the mediation context:

<Sample>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 576

<ssnetv:setProperty="employee.ssn">123-45-6789</record>
</Sample>

The mediation context property employee.ssn is populated with the value 123-45-6789.

Reference: Comma-Separated Value (CSV) Attributes for Document


Transformation

Overview
These attributes provide support for formatting documents in CSV format. Workday can use the separator
and quotes attributes together to indicate whether to add separators. You can create both comma and
pipe-delimited formats using a combination of the separator and quotes attributes. If other delimiters are
required, the quotesWhenMatches attribute can be used to specify a regular expression that is used to
determine if a value is quoted.
• quotes – Specify the rules governing when an element value is placed in quotes – possible values are
csv, pipe-delimited, always and never.
• quoteStyle – Specify the type of quotation mark to use.
• quoteWhenMatches – Specify a regular expression to determine if the element values are included in
quotes.
• separator – Display a character in the results between each of the child elements that this attribute is
attached to.

quotes

Summary Indicates whether Workday includes the values


from elements in quotes when displayed in the
results.
Valid Values Either always, never, csv, or pipe-delimited. If you
don't specify a value, Workday never includes the
values from elements in quotes.
Scope Element and all child elements.

The quotes attribute indicates whether the values from elements are included in quotes. If the value is
always, then Workday always uses quotes. If the value is csv, then the rules commonly associated with
the use of quotes in CSV files are applied. In this case, Workday applies quotes to a value if it contains a
comma, newline, or quote character. If the value it starts or ends with white space, Workday applies quotes
to the value. Workday replaces a quote character in the value with 2 quote characters.
Apply the CSV rules for quotes:

<Sample xtt:separator="," xtt:quotes="csv">


<item>Simple</item>
<item>Includes a ,</item>
<item> Starts with space</item>
<item>Ends with space </item>
<item>Contains a " character</item>
<item>Contains a newline character</item>
</Sample>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 577

This example produces:

<Simple,"Includes a ,"," Starts with space","Ends with space ","Contains a


"" character","Contains a newline character"

quoteStyle

Summary Indicates whether to use single or double quotes


when the results are quoted using the quotes
attribute.
Valid Values Either single or double. If you don't specify a value,
Workday uses double quotes.
Scope Element and all child elements.

When you use the quotes attribute, use the quoteStyle attribute to define whether to use single (') or
double (") quotation marks.
Using the quoteStyle attribute to apply CSV rules:

<Sample xtt:separator="," xtt:quotes="csv" xtt:quoteStyle="single">


<item>Simple</item>
<item>Includes a ,</item>
<item> Starts with space</item>
<item>Ends with space </item>
</Sample>

This example produces:

Simple,’Includes a,’,’Startswith space’,’Ends with space ‘

quoteWhenMatches

Summary Quotes values when Workday uses unusual


separator characters in CSV style files.
Valid Values A regular expression.
Scope Element and all child elements.

Specify a regular expression that, when matched, places the value within quotes.
Using the quoteWhenMatches attribute to apply CSV rules:

<Sample xtt:separator="X" xtt:quoteWhenMatches=".*X.*">


<item>Simple</item>
<item>Includes an X character</item>
<item>Simple</item>
</Sample>

This example produces:

SimpleX"Includes an X character"XSimple

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 578

separator

Summary Workday places an attribute value between the


text contained in each of the child elements of the
element that the attribute is attached to.
Valid Values Any text.
Scope Element only.

Place the value of the separator attribute separator.

<Sample xtt:separator=",">
<item>One</item>
<item>Two</item>
<item>Three</item>
</Sample>

This example produces:

One,Two,Three

Reference: Date/Time Attributes for Document Transformation

Overview
These attributes enable you to specify a date or dateTime format. Format the element values provided
as input to the steps as defined by the XML Schema specification. Workday converts these values to the
format specified in the attributes.
• dateFormat – The date format pattern, such as yyyyMMdd.
• dateTimeFormat – The date/time format pattern, such as yyMMdd:HH:mm:ss.
• timezone – The time zone to be used when creating the value for the returned document, such as PST.

dateFormat

Summary Specifies the date format pattern that Workday


converts dates to.
Valid Values A date format pattern as used in Java.
Scope Element only.

Convert the value of an element to the format specified in the attribute.


Use the dateFormat attribute to specify a date format.

<Birth_Date etv:dateFormat="dd/MM/yyyy">1960-03-24</Birth_Date>

This example produces:

<Birth_Date>24/03/1960</Birth_Date>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 579

dateTimeFormat

Summary Specifies the dateTime format pattern that Workday


converts dateTime values to.
Valid Values A date format pattern as used in Java.
Scope Element only.

Specify a date and time format. Workday processes the value of the element as a dateTime and converts
the original value to the format specified in this attribute.
Specify a date and time format:

<Last_Update etv:dateFormat="dd/MM/yyyy:hh/mm/ss" >2010-10-13T07:30:45</


Last_Update>

This example produces:

<Last_Update>13/10/2010:07/30/45</Last_Update>

timezone

Summary Specifies the time zone that Workday uses for


dateTime values in the results.
Valid Values The name of a time zone as used by the Java class
java.util.TimeZone.
Scope Element and all child elements.

Specify the time zone for values formatted using the dateTimeFormat attribute. Values formatted using the
dateFormat attribute are unaffected by the timezone attribute.
Convert a dateTime value using a timezone offset of -08:00:

<Last_Update etv:timezone="EST" etv:dateTimeFormat="dd/MM/yyyy:hh|mm|


ss">2010-11-18T02:57:22.019-08:00</Last_Update>

Workday changes the hour value from 02 to 05:

<Last_Update>18/11/2010:05|57|22</Last_Update>

Workday doesn't convert a dateTime value because the dateTime value has no timezone offset.

<Last_Update etv:timezone="EST" etv:dateTimeFormat="dd/MM/yyyy:hh|mm|


ss">2010-11-18T02:57:22.019</Last_Update>

This example produces:

<Last_Update>18/11/2010:02|57|22</Last_Update>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 580

Reference: Fixed-Length Formatting Attributes for Document


Transformation

Overview
These attributes enable the integration to create fixed width format documents. The fixed length of each
element is specified using the fixedLength attribute. Workday pads values shorter than the length specified
by the attribute using the paddingCharacter. Workday truncates values that are longer than the attribute
value.
• align – Indicates whether values are aligned to the left or to the right when padding is added.
• fixedLength – The number of characters in this fixed-length field.
• paddingCharacter – The padding character to use for a value shorter than the fixed length.

align

Summary Indicates whether Workday aligns fixed-length


values that require padding to the left or the right.
Valid Values Either left or right. If you don't specify a value,
Workday applies left padding.
Scope Element and all child elements.

Control whether Workday aligns fixed-length values that require padding to the left or the right.
Right-align content of a fixed length:

<Sample xtt:align="right">
<item xtt:fixedLength="10">Short</item>
<item xtt:fixedLength="10">Much Too Long</item>
<item xtt:fixedLength="10">Just Right</item>
</Sample>

This example produces:

ShortMuch Too LJust Right

fixedLength

Summary Indicates the length of a fixed-width field.


Valid Values A positive integer.
Scope Element only.

Control display of the element values in a fixed-width field. Values shorter than this length are padded with
the space character to the length specified. To specify an alternative character, use thepaddingCharacter
attribute.
Workday truncates values longer than the length without any error or warning messages. To display an
error or warning message, use the maxLength attribute.
Truncate values to a fixed length:

<Sample>
<item xtt:fixedLength="10">Short</item>
<item xtt:fixedLength="10">Much Too Long</item>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 581

<item xtt:fixedLength="10">Just Right</item>


</Sample>

This example produces:

Short Much Too LJust Right

paddingCharacter

Summary Indicates the character that Workday uses for


padding fixed-length values.
Valid Values Any character. If you don't specify a value, Workday
uses the space character.
Scope Element and all child elements.

Specify the padding character that Workday applies when fixed-length values require padding.
Pad fixed-length characters if less than a specified length:

<Sample xtt:paddingCharacter="-">
<item xtt:fixedLength="10">Short</item>
<item xtt:fixedLength="10">Much Too Long</item>
<item xtt:fixedLength="10">Just Right</item>
</Sample>

This example produces:

Short-----Much Too LJust Right

Reference: Grouped Attributes for Document Transformation

Overview
Workday provides a single class attribute to apply 1 or more Element Transformation and Validation (ETV)
attributes to an element.

class

Summary Applies a number of ETV attributes to an element.


Valid Values String – the name of a class defined using the class
element.
Scope Element only.

The class element enables you to define 1 or more attributes as part of a class. You can then use the class
attribute as a convenient way to apply all of those attributes. Workday applies the attributes included in the
class element only to the element that the class attribute is attached to. Workday ignores the scoping rules
for the original attribute. You can use the class attribute with other attributes. An attribute placed directly on
an element takes precedence over the same within the class.
This example displays 2 ways to group attributes:
<!-- 1. Creating simple class. Using XTT here-->
<xtt:class xtt:name="detailClass" xtt:fixedLength="30" xtt:align="left"
xtt:paddingCharacter="*"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 582

<!-- 2. Create and build classes off one another. Using ETV here to show
either works but you
should use one or the other in your xsl depending on your output needs
(XML or text).-->

<etv:class etv:name="detailClass1" etv:fixedLength="30"/> <!-- Initial


class -->
<etv:class etv:name="detailClass2" etv:class="detailClass1"
etv:align="left"/> <!-- Class extending another class -->
<etv:class etv:name="detailClass3" etv:class="detailClass2"
etv:paddingCharacter="*"/>
<!-- Class extending again. -->

<!-- Using your classes -->


<Employee xtt:separator=",">
<!-- 2. Using the class and adding more attributes -->
<FirstName etv:class="detailClass3" etv:startTag="DETAIL:" etv:endTag=":END">
<xsl:value-of select="wd:First_Name"/> </FirstName>
<!-- 1. Using the simple class only -->
<Last_Name xtt:class="detailClass">
<xsl:value-of select="wd:Last_Name"/> </Last_Name>
</Employee>
This XSLT produces:
First Name Last Name
DETAIL:Abby**************************:END,Brennan***********************,
DETAIL:Adam**************************:END,Carlton***********************,

Reference: Integration Value Attributes for Document Transformation

Overview
These attributes replace the value of an element with a value from the integration system. You can
define Integration attributes, launch parameters, or integration maps using report fields that can
contain references to objects as opposed to simple types. If Workday finds a reference, the Element
Transformation and Validation (ETV) step places a Reference ID in the output file.
• attribute – The name of an integration attribute. Workday replaces the element value with the value
from the integration attribute.
• direction – The direction that the integration map is applied in. This attribute controls whether the map
attribute converts an internal Workday value to an external value or the other way around.
• launchParameter – The name of a launch parameter. Workday replaces the element value with the
value from the launch parameter.
• map – The name of an integration map. Workday replaces the element value with the equivalent value
as specified in the integration map.
• mapAlternateValue – Applies this value to the map attribute value. Use if the integration map named
by the map attribute is empty.
• mapAppliedOnEmptyInput – If this attribute is set to true, then the integration map is applied even
when there’s no input value.
• mapReferenceID – If the integration map named by the map attribute is empty, Workday uses the
value of this Reference ID.
• sequencedValue - The name of a sequenced value. Workday replaces the element value with the
value from the sequenced value.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 583

attribute

Summary Specifies the name of an integration attribute


whose value Workday places into the element.
Valid Values The name of an integration attribute.
Scope Element only.

You can use this attribute to replace the value of an element with the value of an integration attribute. If
the attribute contains multiple values, then the Element Transformation and Validation (ETV) step returns
the element multiple times, once for each value. The XML To Text (XTT) step returns the values as text,
concatenated together.
Replace the value of an element with the value of an integration attribute.

<Cost_Center etv:attribute="Cost Center" />

This example produces:

<Cost_Center>CC46</Cost_Center>

Define the integration attribute as a Reference ID and create a wd:ID element:

<Organization_Reference etv:attribute="Cost Center"/>

This example produces:

<wd:Organization_Reference wd:Descriptor="Cost Center 46">


<wd:ID wd:type="WID">cda8ef556ddf425ebed3bc40f4016ccb</wd:ID>
</wd:Organization_Reference>

If the attribute contains multiple values, the ETV step outputs the element multiple times, once for each
value. The XTT step outputs the values as text, concatenated together.
If the attribute value is part of XSLT logic, use the xsl:param element to retrieve an integration attribute
value. To define the xsl:param name, prefix the integration attribute name with attr_ and replace any
spaces with an underscore. Example:

<xsl:param name="attr_Root_Organization"/>

The element contains the text value of any integration attribute value. Multivalued attributes are output as a
comma-separated list.

direction

Summary Specifies the direction that Workday uses when


applying an integration map
Valid Values Either out or in. If you don't specify a value,
Workday maps internal values to external values.
When the value is in, Workday maps external
values to internal values.
Scope Element and all child elements.

Integration maps contain 2 sets of values: the internal values and the external values. If you don't specify
a value for map, the map attribute converts an internal value to an external value. The direction attribute
enables an integration map to be used to convert external values to internal ones.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 584

If the direction is in and the map contains multiple internal values and multiple values for the mapped
value, the ETV step returns the element multiple times. The ETV step performs this action once for each
value. The XTT step returns the values as text, concatenated together.
Add the direction attribute to the element containing the map attribute or to a parent element.

<Bank_Account_Type etv:direction="in" etv:map="AccountType">Checking</


Bank_Account_Type>

Workday replaces the value of the element with the internal value from the integration map. This example
produces:

<Bank_Account_Type>C</Bank_Account_Type>

You can also use Reference IDs as the internal values in an integration map. If the map contains
Reference IDs, then Workday creates a wd:ID element.

<wd:Worker_Type_Reference etv:direction="in" etv:Map="Employee


Type">SEASONAL</wd:Worker_Type_Reference>

This example produces:

<wd:Worker_Type_Reference wd:Descriptor="Seasonal">
<wd:ID wd:type="WID">cda8ef556ddf425ebed3bc40f4016ccb</wd:ID>
</wd:Worker_Type_Reference>

If the value of direction is in and the map contains multiple internal values for the mapped value, ETV
processing returns the element multiple times. ETV returns the element once for each value. XTT
processing returns the values as text, concatenated together.

launchParameter

Summary Specifies the name of a sequenced value that


Workday places into the element.
Valid Values The name of a launch parameter for the integration
system.
Scope Element only.

Use the launchParameter attribute to replace the value of an element with the value of a launch parameter.
If the launch parameter contains multiple values, then the ETV processing returns the element multiple
times, once for each value. XTT processing returns the values as text, concatenated together.
Replace the value of an element with the value of a launch parameter:

<Cost_Center etv:launchParameter="Cost Center" />

The ETV processing replaces the value of this element with the value of the launch parameter:

<Cost_Center>CC46</Cost_Center>

You can also use Reference IDs as the launch parameter value in an integration system. If the launch
parameter contains Reference IDs, then Workday creates a wd:ID element.

<Organization_Reference etv:launchParameter=”Cost Center” />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 585

The ETV processing replaces the value of this element with the value of the launch parameter:

<wd:Organization_Reference wd:Descriptor="Cost Center 46">


<wd:ID wd:type="WID">cda8ef556ddf425ebed3bc40f4016ccb</wd:ID>
</wd:Organization_Reference>

If the launchParameter contains multiple internal values, then ETV processing returns the element multiple
times, once for each value. XTT processing returns the values as text, concatenated together.

map

Summary Applies an integration map to the contents of the


element.
Valid Values The name of an integration map on the integration
system for the integration.
Scope Element only.

Use the map attribute to apply integration maps to values. The values can be simple types or Reference
IDs as required by the integration map. Workday reports unmapped values as messages. The severity
attribute dictates the severity of these messages.
Replace the value of an element with the value of a launch parameter:

<Bank_Account_Type etv:map="Account Type">C</Bank_Account_Type>

The value of the map attribute is replaced with the value from the integration map.

<Bank_Account_Type etv:map="Account Type">Checking</Bank_Account_Type>

You can also use Reference IDs as the map attribute value in an integration map. If the map parameter
contains Reference IDs, then Workday creates a wd:ID element is created.

<Employee_Type etv:map="Employee Type">


<wd:Worker_Type_Reference wd:Descriptor="Seasonal">
<wd:ID wd:type="WID">cda8ef556ddf425ebed3bc40f4016ccb</wd:ID>
<wd:ID wd:type="Employee_Type_ID">EMPLOYEE_TYPE-10</wd:ID>
</wd:Worker_Type_Reference>
</Employee_Type>

This example produces:

<Employee_Type>SEASONAL</Employee_Type>

The name of the first child element (Worker_Type_Reference in the preceding example) isn't important.
The Workday Web Service return Reference IDs using a variety of names. This approach enables
Workday to copy these elements directly from the Web service responses.
Apply an integration map named Marital Status to a marital status Reference ID:

<Marital_Status etv:map="Marital Status">


<xsl:copy-of select="wd:Payee_Personal_Data/wd:Marital_Status_Reference"/>
</Marital_Status>

If you don't provide a value for the name of an integration map and you didn't specify a default value,
Workday displays a message.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 586

mapAlternateValue

Summary Identifies an alternate value to use in the case


where the integration map is empty.
Valid Values The alternate value.
Scope Element only.

If the integration map named by the map attribute is empty, use the mapAlternateValue attribute to
populate the results with an alternate value. This option enables you to provide integration maps in the
integration that you don't have to populate. If the integration map is configured with at least 1 value, then
the mapAlternateValue attribute is ignored.
Map an empty attribute to an alternate value:

<Employee_Type etv:map="Employee Type" etv:mapAlternateValue="Full


Time">Regular</Employee_Type>

This example produces:

<Employee_Type>Full Time</Employee_Type>

Map an empty attribute of Employee_Type_ID to a nonexistent reference ID:

<Employee_Type etv:map="Employee Type" etv:mapAlternaveValue="alternate"


etv:mapReferenceID="Employee_Type_ID">
<wd:Worker_Type_Reference wd:Descriptor="Seasonal">
<wd:ID wd:type="WID">cda8ef556ddf425ebed3bc40f4016ccb</wd:ID>
</wd:Worker_Type_Reference>
</Employee_Type>

The mapping fails because the reference ID doesn't exist. This example produces:

<Employee_Type>alternate</Employee_Type>

mapAppliedOnEmptyInput

Summary Maps an empty input value to a default value.


Valid Values Boolean, either true or false. When set to true, an
empty input value is mapped to a default value.
Scope Element only.

If a field doesn't have an input value, you can set the value of mapAppliedOnEmptyInput to true, which sets
the empty field value to a default value.
Attempting to apply a map without a default value to an empty input value generates an ETV message.
The ETV message returns No value output from applying integration map (unless the integration map is
empty and etv:mapAlternateValue is set). This message is the typical response when applying a map that
doesn't produce an output value.

mapReferenceID

Summary Identifies a Reference ID or Reference descriptor


value used in the case where the integration map is
empty.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 587

Valid Values The name of a Reference ID.


Scope Element only.

If the integration map named in the map attribute is empty, use the mapReferenceID attribute to populate
the value returned with a Reference ID or reference descriptor. This option enables you to provide
integration maps on the integration that an implementer can decide not to populate. If the integration map
is configured with at least 1 value, then the mapReferenceID attribute is ignored.
Map reference IDs to populate values when you don't configure the integration map with values:

<Employee_Type etv:map="Employee Type"


etv:mapReferenceID="Employee_Type_ID">
<wd:Worker_Type_Reference wd:Descriptor="Seasonal">
<wd:ID wd:type="WID">cda8ef556ddf425ebed3bc40f4016ccb</wd:ID>
<wd:ID wd:type="Employee_Type_ID">EMPLOYEE_TYPE-10</wd:ID>
</wd:Worker_Type_Reference>
</Employee_Type>

This example produces:

<Employee_Type>EMPLOYEE_TYPE-10</Employee_Type>

If the integration map isn't configured with any values, map Descriptor to the value of the mapReferenceID
attribute.

<Employee_Type etv:map="Employee Type" etv:mapReferenceID="Descriptor">


<wd:Worker_Type_Reference wd:Descriptor="Seasonal">
<wd:ID wd:type="WID">cda8ef556ddf425ebed3bc40f4016ccb</wd:ID>
<wd:ID wd:type="Employee_Type_ID">EMPLOYEE_TYPE-10</wd:ID>
</wd:Worker_Type_Reference>
</Employee_Type>

This example produces:

<Employee_Type>Seasonal</Employee_Type>

sequencedValue

Summary Specifies the name of a sequenced value that


Workday places into the element
Valid Values String, the name of a sequenced value.
Scope Element only.

Sequence Generators defined on an integration system generate unique values for use within integrations.
These values can be placed into an element using the sequencedValue attribute.
Replace the contents of an element with a value:

<Document_Number etv:sequencedValue="Document Number" />

This example produces:

<Document_Number>57</Document_Number>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 588

Reference: Number Formatting Attributes for Document Transformation

Overview
These attributes enable you to specify a number format. Format the element values provided as input
to the steps as defined by the XML Schema specification. Workday converts the values to the format
specified in the attributes.
• decimalSeparator – The decimal separator character.
• groupingSeparator – The grouping separator character.
• numberFormat – The number format pattern. Example: #,###.00.
• scale – The position of an implied decimal place in the formatted value.

decimalSeparator

Summary Specifies the decimal separator that Workday uses


when reformatting numbers.
Valid Values Any character.
Scope Element and all child elements.

Specify the symbol used as the decimal separator when Workday reformats numbers. If you don't specify a
value, Workday uses the current locale.
Specify a decimal separator:

<Salary etv:numberFormat="##,###.00" etv:decimalSeparator=","


etv:groupingSeparator=".">10000</Salary>

This example produces:

<Salary>10.000,00</Salary>

groupingSeparator

Summary Specifies the grouping separator that Workday uses


when reformatting numbers.
Valid Values Any character.
Scope Element and all child elements.

Specify the symbol to use as a separator when Workday reformats numbers. If you don't specify a value,
Workday uses the current locale if not specified.
Specify a grouping separator:

<Salary etv:numberFormat="##,###.00" etv:decimalSeparator=","


etv:groupingSeparator=".">10000</Salary>

This example produces:

<Salary>10.000,00</Salary>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 589

numberFormat

Summary Specifies the number format pattern that Workday


converts numbers to.
Valid Values String, a number format pattern as used in Java.
Scope Element only.

Specify a number format. Workday processes the value of the element as a number and converts the
number to the format specified in this attribute.
Specify a number format:

<Salary etv:numberFormat="##,###.00">10000</Salary>

This example produces:

<Salary>10,000.00</Salary>

scale

Summary Specifies the position of an implied decimal place


that Workday uses when reformatting numbers.
Valid Values A positive integer.
Scope Element and all child elements.

Specify the position of an implied decimal place used when Workday reformats numbers.
Specify the position of an implied decimal place:

<Salary etv:numberFormat="0000000000" etv:scale="2">12345.67</Salary>

This example produces:

<Salary>0001234567</Salary>

Reference: Text Insertion and Removal Attributes for Document


Transformation

Overview
These attributes enable you to add additional text before or after an element when it's converted to a
text document. These attributes also enable you to remove the content of an element. These attributes
can be useful when creating documents that use more complex text file formats such as Electronic Data
Interchange (EDI).
• endTag – Place the contents of the attribute after the value of the element in the output document.
• omit – Don't copy the contents of the element to the output message.
• startTag – Place the contents of the attribute before the value of the element in the output document.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 590

endTag

Summary Place that attribute value after the value of the


element in the output message.
Valid Values Any text.
Scope Element only.

Place the endTag attribute value in the output message after the value of the attached element.
Place a value before the element it's attached to:

<Sample xtt:endTag=":END">Hello World</Sample>

This example produces:

Hello World:END

omit

Summary Don't copy the contents of the element to the output


message.
Valid Values true or false.
Scope Element and all child elements.

Specify that Workday doesn't copy the contents of an element to the output document. Use omit with
XML To Text (XTT) processing in an XML document created by an Extensible Stylesheet Language
Transformation (XSLT) to produce different results during conversion. Example: Apply an alternative
stylesheet to your XML to generate an audit file that contains additional information that you later omit from
the final document.
You can use the omit attribute with setNumber. Example: Introduce an additional element into the XML
document containing a setNumber attribute to reset a variable to zero.
When the omit attribute contains the value true on an element, the values are processed but results aren't
sent to the output. You can use this option when summing or incrementing number values that Workday
doesn't use directly, but from which Workday derives information. The attribute inherits its value. In some
instances, you can set the omit attribute to false to include a required child element in the output.
Exclude contents of an element from the output:

<Sample>
<item>One</item>
<item etv:omit="true">Two</item>
<item>Three</item>
</Sample>

This example produces:

<Sample>
<item>One</item>
<item>Three</item>
</Sample>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 591

startTag

Summary Workday places an attribute value in the output file


before the value of the element.
Valid Values Any text.
Scope Element only.

Place the value of the attribute value in the output message before the value of the attached element.
Place a value before the element it's attached to:

<Sample xtt:startTag="START:">Hello World</Sample>

This example produces:

START:Hello World

Reference: Truncation Attributes for Document Transformation

Overview
The maxLength attribute specifies the maximum number of characters that an element can have. Unless
otherwise stated, Workday returns an error message for any element that exceeds this length. These
attributes enable you to state that Workday truncates these values.
• fieldLengthCalculation – Specifies whether the integration measures the length in characters or bytes.
• reportTruncation – Controls whether the integration reports truncation of a value:
• In a validation message.
• By adding an attribute to the XML document itself indicating that Workday truncates the value.
• truncate – A boolean value indicating if the integration truncates elements longer than their maximum
length.

fieldLengthCalculation

Summary Controls how the integration calculates the length of


a value for use with the maxLength attribute.
Valid Values Either characters or bytes, followed by the
character encoding. If you don't specify a value,
Workday calculates the length in characters.
Scope Element only.

Indicate whether Workday calculates the length of a field in characters or in bytes. If Workday calculates
the length in bytes, then Workday provides the character encoding in the attribute.
Count the length of a field set by the maxLength attribute:

<Sample etv:truncate="true" etv:fieldLengthCalculation="bytes:utf-8"


etv:maxLength="6">Straße</Sample>

This example produces:

<Sample>Straß</Sample>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 592

reportTruncation

Summary Specifies how Workday reports the truncation of a


value.
Valid Values A comma-separated list containing one or more of
these values: none, attribute, critical, error, warning,
or info. If you don't specify a value, Workday
doesn't report truncated values.
Scope Element and all child elements.

If you set the truncate attribute to true, the integration truncates any value that exceeds the maximum
length specified by maxLength. The reportTruncation attribute controls how the integration reports
truncation of a value, if at all. Workday can report the truncation as a validation message, or Workday can
add an attribute to the message itself.
When reportTruncation is none, Workday truncates the values without reporting them. When the value is
attribute, Workday adds a truncated=”true” attribute to any elements whose values Workday truncated.
You can use this option in later processing steps to identify truncated values.
Truncate an element and apply the attribute value to later elements:

<City etv:truncate="true" etv:reportTruncation="attribute"

etv:maxLength="30">Llanfairpwllgwyngyllgogerychwyrndrobwyllllantysiliogogogoch</
City>

This example produces:

<City etv:truncated="true">Llanfairpwllgwyngyllgogerychwy</City>

Truncate an element to a maximum length of 30 and display a warning:

<City etv:truncate="true" etv:maxLength="30"


etv:reportTruncation="warning">Llanfairpwllgwyngyllgogerychwyrndrobwyllllantysiliogogog
City>

This example produces:

<City>Llanfairpwllgwyngyllgogerychwy</City>

Workday also produces a warning message:

<wdext:Integration_Message>
<wdext:Severity>WARNING</wdext:Severity>
<wdext:Summary> The value of City exceeds the maximum length of 30. The
value has been truncated.</wdext:Summary>
</wdext:Integration_Message>

truncate

Summary If a value exceeds the length specified in the


maxLength attribute, controls whether the
integration truncates the value.
Valid Values Boolean; when true, the integration truncates
values.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 593

Scope Element and all child elements.

Truncate a value when you add the maxLength attribute to the parent element. The integration truncates a
value only if truncate (set to true) is attached to that element or a parent element.
Truncate an element to a maximum length of 30:

<City etv:truncate="true"
etv:maxLength="30">Llanfairpwllgwyngyllgogerychwyrndrobwyllllantysiliogogogoch</
City>

This example produces:

<City>Llanfairpwllgwyngyllgogerychwy</City>

Reference: Validation Attributes for Document Transformation

Overview
Workday provides attributes to apply validation rules to the contents of the element they're attached to for
Element Transformation and Validation (ETV) or XML To Text (XTT) processing. These attributes provide
control over the message that Workday reports when an element fails a validation rule, and create custom
messages.
The messages use the name of the element, with underscores replaced with space, to refer to the value
that failed the validation check. This convention is useful where you can give the elements meaningful
names.
• enumeration – A comma-separated list of values. The element must contain one of the values listed.
• maxLength – The maximum length of the value in the element.
• message – Text of a message to be output in the same way as a message resulting from a validation.
You can require other validation rules not supported by these existing sets of attributes. You can
implement such validation rules in an Extensible Stylesheet Language Transformation (XSLT). You
can use the message attribute to add your message to the list of messages generated by ETV or XTT
processing.
• minLength – The minimum length of the value in the element.
• name – Use this attribute to provide a name to be used in validation messages instead of the element
name.
• nameAttribute – This attribute contains the qualified name of another attribute that contains the name
to be used in validation messages.
• required – The element much contain at least 1 character.
• severity – The severity of the message. One of these severity levels: info, warning, error, or critical.
• target – The target of the validation message. Example: when processing employee data, this target
can be the employee name.
• targetWID – The Workday ID of the target. Workday uses the target to provide a hyperlink in the
message.

enumeration

Summary Validates that an element contains one of a specific


list of values.
Valid Values A comma-separated list of values.
Scope Element only.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 594

Set a list of values to validate the contents of the element. The enumeration attribute doesn't alter the
contents of the element.
Validate the contents of an element using specific values:

<Sample>
<A etv:enumeration="this,that">this</A>
<B etv:enumeration="this,that">other</B>
</Sample>

This example produces:

<Sample>
<A>this</A>
<B>other</B>
</Sample>

Workday also produces a warning message:

<wdext:Integration_Message>
<wdext:Summary>The value of B is invalid</wdext:Summary>
</wdext:Integration_Message>

maxLength

Summary Specifies the maximum length for the value of an


element.
Valid Values A numeric value indicating the maximum length.
Scope Element only.

Workday acts on this attribute based on the truncate attribute. If truncate is true, then any value
that exceeds maxLength is truncated. If truncate is false, a message reports that the value exceeds
maxLength.

message

Summary Provides the text of a message.


Valid Values Any text value.
Scope Element only.

Display a message for a custom validation rule applied during the XSL Transformation. The presence of
this attribute always causes a validation message to display.
Display a message for a custom validation rule:

<Social_Security_Number etv:message="The Social Security Number is invalid"


etv:severity="error">1234123412345</Social_Security_Number>

This example produces:

<wdext:Integration_Message>
<wdext:Severity>ERROR</wdext:Severity>
<wdext:Summary>The Social Security Number is invalid.</wdext:Summary>
</wdext:Integration_Message>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 595

minLength

Summary Specifies the minimum length for the value of an


element.
Valid Values A numeric value indicating the minimum length.
Scope Element only.

If the value of the element is less than the length specified in this attribute, Workday returns a message
stating that the value is too short.

name

Summary Provides the name that Workday uses in validation


messages.
Valid Values Any text.
Scope Element only.

Supply a field name that validation messages use. If you don't specify a value, Workday uses the element
name in the validation message.
Display an error message using the original element name:

<SSN etv:required="true"></SSN>

This example produces:

<wdext:Integration_Message>
<wdext:Summary>No SSN was found. This is a required field for the output
document.</wdext:Summary>
</wdext:Integration_Message>

Display an error message containing a custom element name:

<SSN etv:name="Social Security Number" etv:required="true"></SSN>

This example produces:

<wdext:Integration_Message>
<wdext:Summary>No Social Security Number was found. This is a required
field for the output document.</wdext:Summary>
</wdext:Integration_Message>

nameAttribute

Summary Provides a reference to an attribute containing the


name of the field used in validation messages.
Valid Values A name identifying another attribute.
Scope Element and all child elements.

Refer to another attribute that contains the name of the field required for a validation message.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 596

Use the nameAttribute attribute to identify the attribute and the associated field to be displayed in a
validation message.

<Sample xtt:nameAttribute="ID">
<item ID="Z453" etv:required="true">One</item>
<item ID="Z454" etv:required="true"> </item>
<item ID="Z455" etv:required="true">Three</item>
</Sample>

This example produces:

<wdext:Integration_Message>
<wdext:Summary>No Z454 was found. This is a required field for the output
document.</wdext:Summary>
</wdext:Integration_Message>

required

Summary Indicates that the element must contain a value.


Valid Values true or false.
Scope Element only.

Require the Social Security Number element to contain a value and display a message if it's empty:

<Social_Security_Number etv:required="true">1234123412345</
Social_Security_Number>

This example produces:

<Social_Security_Number etv:required="true"></Social_Security_Number>

Workday also produces a warning message:

<wdext:Integration_Message>
<wdext:Summary>No Social Security Number was found for John Smith. This is
a required field for the output document.</wdext:Summary>
</wdext:Integration_Message

severity

Summary Sets the severity of messages.


Valid Values Either info, warning, error, or critical. Workday uses
the default value used if you don't set this attribute
to error.
Scope Element and all child elements.

The severity attribute is used to control the severity of messages. This attribute applies to messages
created by the validation attributes as well as the message attribute.
Set a severity level on a required attribute and produce the related validation message:

<Social_Security_Number etv:required="true" etv:severity="ERROR"></


Social_Security_Number>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 597

This example produces:

<wdext:Integration_Message>
<wdext:Severity>ERROR</wdext:Severity>
<wdext:Summary> No value was found for Social Security Number. This is a
required field for the output document.</wdext:Summary>
</wdext:Integration_Message>

target

Summary Provides the name of the target, which is typically a


worker.
Valid Values Any text value.
Scope Element and all child elements.

When required is true, create messages that add information to the error message describing a failed
validation.
Add text to a validation message.

<Social_Security_Number etv:required="true" etv:target="John Smith"></


Social_Security_Number>

This example produces:

<wdext:Integration_Message>
<wdext:Summary>No Social Security Number was found for John Smith. This is
a required field for the output document.</wdext:Summary>
</wdext:Integration_Message>

targetWID

Summary Provides the Workday ID of the target.


Valid Values A Workday ID. You can provide multiple Workday
IDs as a comma-separated list.
Scope Element and all child elements

When required is true, create messages that add the Workday ID (WID) of the target object. If the message
is attached to an Integration Event, the message includes a hyperlink to the target object.
Add the Workday ID to a message:

<Social_Security_Number etv:required="true" etv:target="John Smith"


etv:targetWID="2af9579a2bde48d49bfc16ce5bcda138"></Social_Security_Number>

This example produces:

<wdext:Integration_Message>
<wdext:Target>2af9579a2bde48d49bfc16ce5bcda138</wdext:Target>
<wdext:Summary>No Social Security Number was found for John Smith. This is
a required field for the output document.</wdext:Summary>
</wdext:Integration_Message>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 598

Reference: Document Transformation Sample Use Case


This example displays how you can use the XML To Text (XTT) step with an XSLT transformation to
generate a CSV file containing employee data. The XTT step produces a file that contains these values for
an employee:
• Name.
• Social Security Number.
• Postal address.
• Date of birth.
• Gender.
Use an XSLT stylesheet to loop through employee data and copy only the data needed for the CSV file.

<?xml version="1.0" encoding="UTF-8"?>


<xsl:stylesheet
xmlns:wd="urn:com.workday/bsvc" version="2.0"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xtt="urn:com.workday/xtt">
<xsl:output indent="yes" method="xml" />
<xsl:template match="/*">
<Employees xtt:truncate="true" xtt:severity="error">
<xtt:class xtt:name="date" xtt:dateFormat="dd/MM/yyyy" />
<xsl:for-each select="wd:Worker">
<!-- Variable declarations have been omitted. -->
<Employee xtt:target="{$EmployeeName}"
xtt:targetWID="{$EmployeeWID}"
xtt:quotes="csv"
xtt:endTag="&#xD;&#xA;">
<Personal_Data xtt:separator=",">
<First_Name xtt:required="true">
<xsl:value-of select="$NameData/wd:First_Name" />
</First_Name>
<Last_Name xtt:required="true">
<xsl:value-of select="$NameData/wd:Last_Name" />
</Last_Name>
<Social_Security_Number xtt:required="true">
<xsl:value-of select="$SSN" />
</Social_Security_Number>
<Address_Line_1 xtt:required="true" xtt:maxLength="10">
<xsl:value-of select="$Address/wd:Address_Line_Data[1]" />
</Address_Line_1>
<Address_Line_2 xtt:maxLength="50">
<xsl:value-of select="$Address/wd:Address_Line_Data[2]" />
</Address_Line_2>
<City xtt:required="true" xtt:maxLength="20">
<xsl:value-of select="$Address/wd:Municipality" />
</City>
<State>
<xsl:value-of select="$State" />
</State>
<Zip>
<xsl:value-of select="$Address/wd:Postal_Code"/>
</Zip>
<BirthDate xtt:class="date">
<xsl:value-of select="$PersonalData/wd:Birth_Date" />
</BirthDate>
<Gender xtt:map="Gender">
<xsl:copy-of select="$PersonalData/wd:Gender_Reference" />
</Gender>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 599

</Personal_Data>
</Employee>
</xsl:for-each>
</Employees>
</xsl:template>
</xsl:stylesheet>

In the preceding example, the target and targetWID attributes are set at the employee level. Any error
messages produced by the XSLT include the current employee name. The XSLT parses through all of the
fields, whether or not an employee record contains the field. The xtt:class element defines a dateformat
pattern. The BirthDate element refers to this class attribute.
The XSLT produces:

<Employees
xmlns:xtt="urn:com.workday/xtt"
xmlns:wd="urn:com.workday/bsvc"
xtt:truncate="true"
xtt:severity="error">
<xtt:class xtt:name="date" xtt:dateFormat="yyyy/MM/dd" />
<Employee
xtt:target="Logan McNeil"
xtt:targetWID="66a65677834f0a9b586dd5645e9004"
xtt:quotes="csv"
xtt:endTag="&#xD;&#xA;">
<Personal_Data xtt:separator=",">
<First_Name xtt:required="true">Logan</First_Name>
<Last_Name xtt:required="true">McNeil</Last_Name>
<Social_Security_Number xtt:required="true"></
Social_Security_Number>
<Address_Line_1 xtt:required="true" xtt:maxLength="10">3870
Pacific Avenue</Address_Line_1>
<Address_Line_2 xtt:maxLength="50" />
<City xtt:required="true" xtt:maxLength="20">San Francisco</
City>
<State>CA</State>
<Zip>94111</Zip>
<BirthDate xtt:class="date">1972-05-25-08:00</BirthDate>
<Gender xtt:map="Gender">
<wd:Gender_Reference wd:Descriptor="Female">
<wd:ID wd:type="WID">77da47525a434e98894dd95c641a68d4</
wd:ID>
<wd:ID wd:type="Gender_Code">245.1</wd:ID>
</wd:Gender_Reference>
</Gender>
</Personal_Data>
</Employee>
</Employees>

Next, when you apply the XTT step, Workday produces these results:

Logan,McNeil,,3870 Pacif,,San Francisco,CA,94111,1972/05/25,F

The Social Security Number for the employee is missing from the example. The XTT step also produces
this error message:

No Social Security Number available for Logan McNeil. Social Security Number
is a required
field.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 600

Concept: Document Transformation Connector


Element Transformation and Validation (ETV) and XML To Text (XTT) provide a number of different ways
to transform and validate elements in an XML document.
Workday provides several categories of attributes that enable you to process elements:
• Arithmetic elements: count and sum element values; optionally write calculation results to another
element.
• Comma-separated Value (CSV) formatting: format output documents in CSV.
• Date/Time formatting: Apply date, date-time, and time zone formatting.
• Element Text Addition and Removal: apply additional fixed text to the start or end of an element, or
leave element content out of the output document.
• Fixed-length formatting: define formatting rules to make all output values the same length, using
truncation and padding characters.
• Grouped attributes: define groups of attributes and apply them to an element as a single action.
• Integration System: insert integration attribute, launch parameter, and map values into elements.
• Number Formatting: specify number formatting, including decimals, grouping, and scale.
• Truncation: truncate element length (in characters or bytes) and specify error reporting.
• Validation: apply validation rules to elements and define messages that Workday returns when
elements fail these rules.

XML Validity
The ETV and XTT processing instructions require that the XML output by the XSLT transformation is valid
XML.

Scope Rules
You can attach many attributes (such as dateFormat or maxLength) to elements of simple types and only
apply these attributes to the elements to which they're attached. Others (such as target or truncate) can be
attached to any element and child elements inherit their value.

Reusing Attributes
ETV and XTT enable you to define groups of attributes as reusable classes. You can define these groups
using an element called class. You can refer to the group later using the attribute class.
Example: Define a reusable number or date format:

<etv:class etv:name="decimal" etv:numberFormat="##,##.00"


etv:decimalSeparator="," etv:groupingSeparator="." />
<Salary etv:class="decimal">10000</Salary>

This XML produces:

<Salary>10.000,00</Salary>

Precedence of Multiple Attributes


You can use different attributes together on the same elements. Example: you can extract the value of
a launch parameter, map it using an integration map, and place it in the output file. If you use multiple
attributes together, Workday applies these attributes in this order:
1. Data extraction: Example: attribute, launchParameter, sequencedValue, or number.
2. Apply Integration Map.
3. Formatting. Example: numberFormat or dateFormat.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 601

4. Number addition. Example, addNumber.


5. Truncation.
6. Validation.
Note: If you use one or more of the attributes launchParameter, sequencedValue, or number on a single
element, the behavior is undefined.

Concept: Document Transformation and Validation

Add Workday-Specific Instructions and Validate XML Documents


Element Transformation and Validation (ETV) and XML To Text (XTT) enable you to add processing
instructions to an XSLT transformation using attributes. The Document Transformation Connector enables
you to specify an XSLT transformation that generates XML with embedded ETV and XTT attributes. These
attributes transform and validate the output documents for the integration.
The XTT step supports instructions that convert XML documents to text. It converts documents from
XML to text formats such as comma-separated values (CSV), fixed width, or other text formats. XTT also
supports many of the transformation and validation instructions supported by ETV. You can use the XTT
step standalone or with the ETV step. You control the process by using the namespace attribute. The
ETV step processes attributes in the urn:com.workday/etv namespace. Workday passes attributes in the
urn:com.workday/xtt namespace through the ETV step. The XTT step then processes these attributes.

Transform and Validate XML Documents


Element Transformation and Validation (ETV) transforms and validates the elements within an XML
document. ETV uses the instructions provided by attributes attached to the elements.
Specify that the maximum length for City is 30 and that longer values are truncated.

<?xml version="1.0" encoding="utf-8"?>


<Sample xmlns:etv="urn:com.workday/etv">
<City etv:truncate="true"
etv:maxLength="30">Llanfairpwllgwyngyllgogerychwyrndrobwyllllantysiliogogogoch</
City>
</Sample>

This example produces:

?xml version="1.0" encoding="utf-8"?>


<Sample>
<City>Llanfairpwllgwyngyllgogerychwy</City>
</Sample>

Workday truncates the value to 30 characters and removes the ETV attributes.
Require that the Social_Security_Number element contain a value:

<?xml version="1.0" encoding="utf-8"?>


<Sample xmlns:etv="urn:com.workday/etv">
<Social_Security_Number etv:required="true"></Social_Security_Number>
</Sample>

This example produces:

<?xml version="1.0" encoding="utf-8"?>


<Sample>
<Social_Security_Number></Social_Security_Number>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Document Transformation Connector | 602

</Sample>

Workday also produces a warning message:

No value is available for Social Security Number. Social Security Number is


a required field.

Convert XML Documents to Text


XML To Text (XTT) converts documents from XML to text formats like comma-separated values (CSV),
fixed width, or other text formats.
Separate each row with a newline, each item by a comma, and quote each value based on the rules for
CSV files:

<?xml version="1.0" encoding="utf-8"?>


<Document xmlns:xtt="urn:com.workday/xtt" xtt:separator="&#xD;&#xA;"
xtt:quotes="csv">
<Row xtt:separator=",">
<Item>A1</Item>
<Item>B1</Item>
<Item>C1</Item>
</Row>
<Row xtt:separator=",">
<Item>A2</Item>
<Item>B2</Item>
<Item>C2</Item>
</Row>
<Row xtt:separator=",">
<Item>A3</Item>
<Item>B3</Item>
<Item>C3</Item>
</Row>
</Document>

This example produces:

A1,B1,C1
A2,B2,C2
A3,B3,C3

Use ETV and XTT with XSLT


You can use the ETV and XTT steps with XSLT. Use the XSLT stylesheet to create the XML document
that Workday processes by these 2 steps.
Apply an XSLT stylesheet to generate an error message for a missing Social Security Number. Add the
etv:required attribute to the Social Security Number element:

<?xml version="1.0" encoding="UTF-8"?>


<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:etv="urn:com.workday/etv">
<xsl:template match="/*">
<Sample>
<Social_Security_Number etv:required="true">
<xsl:value-of select="Worker/PersonalData/SSN" />
</Social_Security_Number>
</Sample>
</xsl:template>
</xsl:stylesheet>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 603

Use this approach to add simple xsl:value-of statements to the XSLT that copy values from the input
document to the output document. The attributes control the processing applied to the elements.
Related Information
Reference
Reference: Accounting Journal Connector CSV File Format on page 606

Financials Connectors

Accounting Journal Connector

Steps: Set Up Accounting Journal Connector

Prerequisites
• Access to an SFTP server that contains the accounting journal files.
• Accounting journal data files must be in the Workday-defined XML or Comma-Separated Value (CSV)
format.
• Create ledger accounts and worktags for all Workday accounts.

Context
You can create an integration that imports accounting journal data files into Workday from an external
SFTP endpoint.

Steps
1. Access the Create Source System task and create 1 source for each external endpoint.
Security: Set Up: Map Worktags domain in the Worktags functional area.
2. Access the Create Integration Worktag Mapping task and map each external code to corresponding
Ledger Account and worktags, Ledger Accounts, and worktags.
Security: Set Up: Map Worktags domain in the Worktags functional area.
3. Access the Create Integration System task and enter Core Connector: Accounting Journal Inbound at
the New Using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
4. (Optional) Enable integration services. As you complete this section, consider:
Option Description
Maintain Journal Sources Configuration – DIS Enable this service if you configured Suspense
Accounting with Journal Sources. If you
enable this service, the integration displays a
Warning message instead of an Error Message
for each journal with missing code mappings. The
integration continues to process the journal.
Financials Document Delivery Service Select the Configure Files for External Delivery
integration attribute to enable this service to
deliver these output files to external endpoints:
• CSV Audit Diagnostic File
• Errors Only File

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 604

Option Description
To deliver these files, you must select the
associated integration attributes:
• Create Audit File in CSV Format
• Create Errors Only File
To deliver files to external endpoints, configure a
document delivery step on a business process in
the integration system.
We don't support backslashes on these fields
when you generate an audit file on a CSV import
file:
• Journal Entry Memo
• Journal External Reference ID
• Journal Line External Reference ID
• Journal Line Memo

5. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Accounting Journal Event (business process)
• Integration Event
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
6. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
7. Select Integration System > Configure Integration Maps as a related action on the integration
system. Map values between Workday and the accounting journal data files.
Use the Worktag Mapping Definition for External Code integration map to associate the integration
worktag mappings that you created in Step 3 with the integration system. Workday uses the External
Value configured for this Integration Map in the input file to reference the map. Example: <ExternalCode
jc:name="RegionMap">West</ExternalCode>.
Security: Integration Build and Integration Configure domains in the Integration functional area.
8. Set Up Integration Retrieval on page 1845.
9. Launch an Integration on page 23.
To return journals with any status update or within a specific date range:
• Select Payroll Journal Outbound Request as your provider.
• Use the Journal Date Query Option field.
Related Information
Reference
Workday 31 What's New Post: Audit Report Files in CSV Format

Concept: Accounting Journal Connector


Import accounting journal data into Workday from an external endpoint with the Accounting Journal
Connector. This integration (and related Workday tasks) translates data between:
• External chart of account structures
• Your Workday worktag and account structures
The integration imports data in a Workday-defined XML or Comma-Separated Value (CSV) format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 605

Accounting Journal Connector Integration and Supporting Tasks


The Accounting Journal Connector consists of these components and supporting tasks:

Component Description
Create Source System This task enables you to define external source
endpoints.
Create Integration Worktag Mapping This task enables you to map between:
• External codes for source accounts
• Ledger accounts or worktags in Workday.

Core Connector: Accounting Journal Inbound This integration template enables you to create an
integration system that:
• Retrieves an XML or CSV file from an external
SFTP endpoint that contains accounting journal
data.
• Translates data by applying the mapping rules
that you define with the Create Integration
Worktag Mapping task.
• Maps rules that you define directly in the
integration as part of integration maps.
• Loads the data into Workday.
• Supports reporting and error handling at the
Journal and Journal Line levels.

Launch/Schedule Options
Workday provides these launch schedule options for the Accounting Journal Connector:
• Launch on schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration retrieves any files from the endpoint.
• Launch immediately. You can launch the integration manually.

Processing Notes
If the LedgerAccountingReferenceID element exists in the Accounting Journal Connector input file,
Workday ignores the external code values that map to ledger accounts. You can override integration
attribute values by populating them in the input file.

Error Handling
The Accounting Journal Connector enables you to generate an errors-only file for faster error resolution:
• To enable this optional feature, enable the Create Errors Only File integration attribute.
• When the integration loads an accounting journal file, it creates an errors-only file if there are errors in
the original file. The integration attached the errors-only file to the output files section of the integration
event.
• The errors-only file is in the same format (XML or CSV) as the original accounting journal file. It
contains only the journals that are in error. Example: you load 25 journals into Workday, and 2 journals
fail to load. Workday generates an errors-only file that contains the 2 failed journals.
• After you resolve any errors in the errors-only file, you load the file into Workday using the Accounting
Journal Connector.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 606

Reference: Accounting Journal Connector CSV File Format


The CSV import file format has 2 types of rows:
• Header row. The first row in the CSV file is a fixed header row. The header row describes the columns
that the journal data rows populate. There can be only 1 header row in a file, and it must be the first
row of the file. You can skip the optional columns in the input file by removing the column or leaving it
empty.
• Journal Data rows. These rows consist of journal header and journal lines details. The integration
loads all journal lines with the same JournalKey value as a single journal entry in Workday.
Boolean values are 1 (true) and 0 (false). Date value format is YYYY-MM-DD.
When you enter a value for a ReferenceID field, you must also provide a reference ID type. Example:
The header field is titled AccountingJournalReferenceID. Enter an acceptable value for the
AccountingJournalReferenceIDType header field.
Workday considers a field required unless otherwise stated.
Download the Accounting Journal Connector CSV import file template to view a full list of available fields.
You can include these columns for the journal header:

Journal Header Fields Type Description


JournalKey Text Aggregates journal lines
belonging to the same journal.
Workday loads all journal lines
with the same JournalKey as a
single journal entry.
AccountingJournalID Text For this field, you can:
• Create an accounting journal
with the value provided in this
field. If you leave the field
empty, Workday generates a
unique accounting journal ID.
• Update an accounting journal
by providing a reference to an
existing accounting journal ID.
• Change the accounting
journal ID for an existing
journal by entering a new
value in this field. Enter
the reference for the old
accounting journal ID in the
AccountingJournalReferenceID
field.

AccountingJournalReferenceIDType
Text Required if you
provide a value on
AccountingJournalReferenceID.
Enter either:
• Account_Set_ID
• WID

AccountingJournalReferenceID Text Optional field. Identifies an


existing accounting journal.
Enter a reference to an existing

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 607

Journal Header Fields Type Description


journal in Workday or leave the
field empty. If this field is empty,
Workday generates a unique ID.
Submit Boolean Optional field. Determines if you
save the journal in draft mode or
submit it. Enter:
• 0 to save the journal in draft
mode with a status of Created.
• 1 to submit the journal with a
status of Posted.
If the field is empty, Workday
automatically enters 0.
DisableOptionalWorktagBalancing
Boolean Optional field. Disables worktag
balancing for the given journal.
Enter:
• 0 to enable worktag balancing.
• 1 to disable worktag
balancing.
If the field is empty, Workday
automatically enters 1.
LockedinWorkday Boolean Optional field. Determines if you
can edit the journal in Workday.
Enter a value of 1 to lock the
journal. You can't edit, cancel,
or change a locked journal.
If the field is empty, Workday
automatically enters 0.
AddOnlyJournal Boolean Optional field. Determines if
Workday updates an existing
journal or creates a new journal.
Enter:
• 0 to update an existing journal.
• 1 to create a new journal.
If you update an existing
journal, you must enter
the reference on the
AccountingJournalReferenceID
field.
CreateJournalwithErrors Boolean Optional field. Determines if
Workday creates a journal in
Created status for a ledger
company with alternate account
sets, even if the alternate ledger
account isn’t mapped.
RoundLedgerAmounts Boolean Optional field. Determines how
Workday balances the rounding
differences for the ledger
amounts on a multicurrency

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 608

Journal Header Fields Type Description


journal entry. Enter a value of
1 to enable rounding of ledger
amounts. Don’t set this value if
your journal is intercompany.
JournalNumber Text Optional field. Workday
automatically generates a value
using the sequencing number
configuration when you create a
new journal. If you reference an
existing journal entry, leave this
field empty.
CompanyReferenceIDType Text Provide a value for
this field based on the
CompanyReferenceID field.
Enter:
• Company_Reference_ID
• Organization_Reference_ID
• WID

CompanyReferenceID Text Provide a reference ID to an


existing company in Workday for
the accounting journal.
Currency Text Provide references to the
company currency. The
currencies you reference must
match company currencies.
JournalforAllLedgers Boolean Determines if Workday creates
a single ledger journal or both
primary and alternate ledger
journals.
LedgerType Text Provide the value for an existing
ledger type in Workday.
If you configured the ledger type
map in your integration system,
you can enter an external value
from the map. Workday then links
the value to a Workday ledger
type.

BookCode Text Optional field. Provide the value


for an existing book code ID in
Workday.
If you configured the book code
map in your integration system,
you can enter an external value
from the map. Workday then links
the value to a Workday book
code.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 609

Journal Header Fields Type Description


AccountingDate Date Provide the accounting date of
the journal.
JournalSource Text Provide the value for an existing
accounting journal source in
Workday.
BalancingWorktagReferenceIDType
Text Required field if you
provide a value on
BalancingWorktagReferenceID.
The fields you can enter include:
• Business_Unit_ID
• Cost_Center_Reference_ID
• Custom_Organization_Reference_ID
• Fund_ID
• Organization_Reference_ID
• Region_Reference_ID
• WID

BalancingWorktagReferenceID Text Optional field. Provide the


reference ID for the anchor
balancing worktag for the journal.
If you enter a reference ID, you
must enable worktag balancing.
You can’t enter a reference
ID if you specify a value for
RoundLedgerAmounts.
BalancingWorktag_ExternalCodeMapName
Text Optional field. Provide the name
of the balancing worktag external
code map. After configuring an
external code map using the
Create Integration Worktag
Mapping task, enter the external
value for the map.
BalancingWorktag_ExternalCodeMapValue
Text Optional field. Provide the value
that Workday needs to look
up from the balancing worktag
external code map.
OptionalBalancingWorktags_WorktagType1
Text Optional field. You can add 1 or
more optional balancing worktags
to the journal header. You must
prefix the worktag type with
OptionalBalancingWorktags_.
Example: A cost center
worktag should display as
OptionalBalancingWorktags_Cost_Center.
If you enter a value for this
field, you must enable optional
balancing worktag for the
company.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 610

Journal Header Fields Type Description


OptionalBalancingWorktagsExternalCode_ExternalCodeMapName1
Text Optional field. You can provide
1 or more optional balancing
worktag external codes to the
journal header. When you
configure an optional balancing
worktag external code map using
the Create Integration Worktag
Mapping task, prefix the External
Value of Map Name with
OptionalBalancingWorktagsExternalCode_.
Example: An external code
map called RegionMap
should display as
OptionalBalancingWorktagsExternalCode_Regio

RecordQuantity Boolean Optional field. Enter 1 if you enter


values for both Quantity and
Unit of Measure on a journal
line. If you don't provide a value,
Workday automatically enters 0.
JournalEntryMemo Text Optional field. Free text comment
regarding the journal entry.
JournalExternalReferenceID Text Optional field. Enables you to
maintain references to your
external endpoints at the journal
header level. You can use this
free text field in reports.
DocumentLink Text Optional field. Enables you
to provide a link to additional
information regarding your
journal.
AdjustmentJournal Boolean Optional field. Determines if the
journal entry is an adjustment.
Enter a value of 1 to treat this
journal entry as an adjustment.
If you don't provide a value,
Workday automatically enters 0.
IncludeTaxLines Boolean Optional field. Determines if the
journal includes tax detail data.
Enter a value of 1 to indicate if
you enter tax detail data in the
journal lines. If you don't provide
a value, Workday automatically
enters 0.
CreateReversal Boolean Optional field. Determines if
Workday should create a reversal
journal for the original journal.
Enter a value of 1 if you wish
to create a reversal. If you

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 611

Journal Header Fields Type Description


don't provide a value, Workday
automatically enters 0.
ReversalDate Date Optional field. If you create a
reversal journal, you can enter an
accounting date for that reversal.
If you leave this field empty,
Workday uses the first day of
the next open period to post
the reversal journal. If there’s
no open period, then Workday
generates the journal in Created
status.
ControlTotalAmount Decimal Optional field. Provide a value
that equals the sum of all journal
lines. Workday validates the total
value of all journal lines is equal
to the amount you specify for the
control amount. You can enter up
to 26 total digits, including up to 6
fractional digits.
CurrencyRateType Text Optional field. Provide the value
for an existing currency rate type
in Workday.
If you configured a currency rate
type map in your integration
system, you can enter the
external value from the map.
Workday then links the value to a
Workday currency rate type.

AlternateLedgerCurrencyRateType
Text Optional field. Provide the value
for an alternate currency rate
type.
DisplayAccountSetID Text Optional field. Provide the value
for an existing account set in
Workday. If you leave this field
empty, Workday derives this field
from the ledger account for the
journal.
If you configured a display
account set map in your
integration system, you can enter
the external value from the map.
Workday then links the value to a
Workday account set.

You can include these columns for the journal lines:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 612

Journal Line Fields Type Description


JournalLineOrder Text Optional field. Provide an ordered
set of values that Workday can
use to sort and display journal
lines in the application. Workday
also uses these values to sort
your journal lines when you print
invoices. Example: 1a, 1b, 1c.
LineCompanyReferenceIDType Text Required if you provide a value
on LineCompanyReferenceID.
You can enter:
• Company_Reference_ID
• Organization_Reference_ID
• WID

LineCompanyReferenceID Text Optional field. Uniquely identifies


the company on the line for
intercompany journals. If
this field is empty in your
input file, Workday uses the
CompanyReferenceID value
you provided. For journals that
aren't intercompany, leave
this field blank or use your
CompanyReferenceID value.
LedgerAccountReferenceID_ParentIDType
Text Required if you
provide a value on
LedgerAccountReferenceID_ParentID.
You can enter:
• Account_Set_ID
• WID

LedgerAccountReferenceID_ParentID
Text Optional field. Uniquely identifies
an existing parent ledger account.
You can provide the ID to the
parent ledger account of the
ledger account you enter for
LedgerAccountReferenceID.
LedgerAccountReferenceIDType Text Required if you provide a value
on LedgerAccountReferenceID.
You can enter:
• Ledger_Account_ID
• WID

LedgerAccountReferenceID Text Optional field. Uniquely identifies


an existing ledger account.
You can provide a reference to
an existing ledger account in
Workday. You can leave this
field empty and enter a reference
to the ledger account on the
ExternalCode_ExternalCodeMapName

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 613

Journal Line Fields Type Description


field. Workday then matches the
external code you enter to the
ledger account you mapped in
the Create Integration Worktag
Mapping task.
AlternateLedgerAccountReferenceID_ParentIDType
Text Required if you
provide a value for
AlternateLedgerAccountReferenceID_Parent
You can enter:
• Account_Set_ID
• WID
Workday only uses this field if
you’ve selected an alternate
account set on the Edit
Company Accounting Details
task.
AlternateLedgerAccountReferenceID_Parent
Text Optional field. Uniquely identifies
ID an existing alternate parent
ledger account. You can
provide the ID to the alternate
parent ledger account of the
ledger account you enter in the
AlternateLedgerAccountReferenceID
field.
AlternateLedgerAccountReferenceIDType
Text Required if you
provide a value for
AlternateLedgerAccountReferenceID.
You can enter:
• Ledger_Account_ID
• WID

AlternateLedgerAccountReferenceID
Text Optional field. Uniquely identifies
an existing alternate ledger
account (ALA). You can provide
a reference to an existing ALA
in Workday. You can create
ALA mapping using the Create
Alternate Account Set Mapping
task.
Workday only uses this field if you
configured an alternate account
set for the company you specified
on CompanyReferenceID.
You can configure an alternate
account set for a company using
the Edit Company Accounting
Details task.

DebitAmount Decimal Enter either a debit amount or a


credit amount, but not both. You
can enter up to 26 digits before

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 614

Journal Line Fields Type Description


the decimal point and 2 digits
after.
CreditAmount Decimal Enter either a debit amount or a
credit amount, but not both. You
can enter up to 26 digits before
the decimal point and 2 digits
after.
LineCurrency Text Optional field. Provide the 3-digit
ISO code for the currency you
use on the journal line.
LineCurrencyRate Decimal Optional field. Provide the
currency exchange rate for the
line currency you specify.
LedgerDebitAmount Decimal Enter either a ledger debit
amount or a ledger credit amount,
but not both. You can enter up to
26 digits before the decimal point
and 2 digits after.
LedgerCreditAmount Decimal Enter either a ledger debit
amount or a ledger credit amount,
but not both. You can enter up to
26 digits before the decimal point
and 2 digits after.
AlternateLedgerCurrency Text References an existing alternate
ledger currency for the company.
AlternateLedgerCurrencyRate Decimal Optional. Provide the positive
numeric currency rate value that
overrides the current alternate
ledger currency rate value.
AlternateLedgerDebitAmount Decimal Enter the currency value that
overrides the debit amount for the
alternate ledger currency journal
line.
AlternateLedgerCreditAmount Decimal Enter the currency value that
overrides the credit amount for
the alternate ledger currency
journal line.
Quantity Decimal Optional field. Use with Unit of
Measure.
UnitOfMeasure Text Optional field. Use with Quantity.
Quantity2 Decimal Optional field. Use with Unit
of Measure 2. Only use if you
entered Quantity and Unit of
Measure.
UnitOfMeasure2 Text Optional field. Use with Quantity
2. Only use if you entered
Quantity and Unit of Measure.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 615

Journal Line Fields Type Description


LineMemo Text Optional field. Use this as a
freeform text field on the journal
line.
JournalLineExternalReferenceID Text Optional field. Enables you to
maintain references to your
external endpoints at the journal
line level. You can use this free
text field in reports.
BudgetDate Date Optional field. Provide the budget
date for the journal line. Required
if you selected the View Budget
Date check box when you
created the ledger.
BalancingWorktagAffiliateIDTypeText Required if you
provide a value on
BalancingWorktagAffiliateID.
You can enter:
• Business_Unit_ID
• Cost _Center_Reference_ID
• Custom_Organization_Reference_ID
• Fund_ID
• Organization_Reference_ID
• Region_Reference_ID
• WID

BalancingWorktagAffiliateID Text Optional field. Provide a


reference to a balancing
worktag affiliate. Enable worktag
balancing to define a balancing
worktag affiliate.
ExcludefromSpendReport Boolean Optional field. For expense
reports and supplier invoice
transactions tied to a capital
project worktag, Workday creates
special accounting to debit
the Work in Progress account.
Workday also records the amount
as a debit into the spend account.
This action is necessary to reflect
correct amounts for the purposes
of budget checking and reporting,
and any other custom spend
reports.
Worktag_WorktagType1 Text Optional field. Enter 1 or more
worktags at the end of each
row. Each worktag column has a
Worktag_ prefix. The field name
identifies the worktag type.
Example: If your worktag
type is Cost_Center, then

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 616

Journal Line Fields Type Description


the name of the field is
Worktag_Cost_Center_Reference_ID.

ExternalCode_ExternalCodeMapName1
Text Optional field. If you map your
external chart of accounts
information with the Create
Integration Worktag Map task,
provide the external codes to
the journal connector for lookup.
Enter 1 or more external codes
at the end of each row. Each
external code column has an
ExternalCode_ prefix followed
by the map name created by
Workday.
Example: If your integration
worktag map is Region,
then the name of the field is
ExternalCode_Region.

You can include these columns for the tax lines:

Tax Line Fields Type Description


TaxTransactionDate Date Required if you add any values to
Tax Details on a journal line.
TaxTypeReferenceIDType Text Required if you provide a value
on TaxTypeReferenceID. You
can enter:
• Tax_Type_ID
• WID

TaxTypeReferenceID Text Required if you add any values


to Tax Details on a journal line.
Provide a reference ID to an
existing tax type in Workday.
TaxableAmount Decimal Optional field. Provide the taxable
amount of the transaction line,
based on the journal line debit
and credit amounts.
TaxCodeReferenceIDType Text Required if you provide a value
on TaxCodeReferenceID. You
can enter:
• Tax_Code_ID
• WID
• Withholding_Tax_Code_ID

TaxCodeReferenceID Text Required if you add any values


to Tax Details on a journal line.
Provide a reference ID to an
existing tax code in Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 617

Tax Line Fields Type Description


TaxRateReferenceIDType Text Required if you provide a value
on TaxRateReferenceID. You
can enter:
• Tax_Rate_ID
• WID
• Withholding_Tax_Rate_ID

TaxRateReferenceID Text Required if you add any values


to Tax Details on a journal line.
Provide the reference ID to an
existing tax rate in Workday.
TaxApplicabilityReferenceIDTypeText Required if you
provide a value on
TaxApplicabilityReferenceID.
You can enter:
• Tax_Applicability_ID
• WID

TaxApplicabilityReferenceID Text Required if you provide a value


for TaxCodeReferenceIDType.
Provide a reference ID of your
tax applicability or leave the field
empty.
TaxRecoverabilityReferenceIDType
Text Required if you
provide a value on
TaxRecoverabilityReferenceID.
You can enter:
• Tax_Recoverability_Object_ID
• WID

TaxRecoverabilityReferenceID Text Optional field. If you have a


transaction tax rate on a journal
line, provide a reference ID to
your tax recoverability.
To find the reference IDs to
your tax recoverability, access
the Integration IDs report and
select Tax Recoverability on the
Business Object prompt.

TaxRecoverabilityTypeReferenceIDType
Text Required if you
provide a value on
TaxRecoverabilityTypeReferenceID.
You can enter:
• Tax_Recoverability_Type_ID
• WID

TaxRecoverabilityTypeReferenceID
Text Required if you add any values
to Tax Details on a journal line.
Provide a reference ID to a tax
recoverability type in Workday

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 618

Tax Line Fields Type Description


for your manual journals. You
can enter references to these tax
recoverability types:
• Fully Recoverable
• Non Recoverable

TaxPointDateTypeReferenceID Text Required if you add any values


to Tax Details on a journal line.
Provide a reference ID to a tax
point date type on your manual
journals. You can enter:
• Accounting Date
• Expense Report Date
• Goods/Service Delivery Date
• Invoice/Adjustment Date
• Invoice/Adjustment Received
Date
• Payment Date
• Transaction Date

TaxSupplierReferenceIDType Text Required if you provide a value


on TaxSupplierReferenceID.
You can enter:
• Supplier_ID
• Supplier_Reference_ID
• WID

TaxSupplierReferenceID Text Optional field. Uniquely identifies


an existing supplier. You can
provide the reference ID of the
supplier.
TaxCustomerReferenceIDType Text Required if you provide a value
on TaxCustomerReferenceID.
You can enter:
• Customer_ID
• Customer_Reference_ID
• WID

TaxCustomerReferenceID Text Optional field. Uniquely identifies


an existing customer. You can
provide the reference ID of the
customer.
TaxExternalBusinessEntityName Text Optional field. The name of the
customer or supplier if you don't
define them within Workday.
TaxExternalBusinessEntityAddress
Text Optional field. The address for the
customer or supplier if you don't
define them within Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 619

Tax Line Fields Type Description


TaxExternalBusinessEntityTaxID Text Optional field. The tax ID for the
customer or supplier if you don't
define them within Workday.
TaxableEventLineReferenceLineOrder
Text Optional field. Enter the line order
of the journal line to which the tax
line relates. Workday uses the
line order to relate the tax line to
the taxable event journal line.
Separate each taxable event
journal line reference on the
TaxableEventLineReferenceLineOrder
field with a semicolon

You can include these columns for the business processes:

Business Process Fields Type Description


BP_AutoComplete Boolean Optional field. Determines how
Workday handles business
process steps. When you enter a
value of 1, Workday automatically
completes business processes.
Completion includes:
• Automatically completing
approvals.
• Bypassing reviews and To
Dos.
• Suppressing notifications.
Enter a value of 0 to disable
automatic completion of business
processes. If you leave this field
empty, Workday automatically
enters 0.

BP_Comment Text Optional field. Free text comment


regarding the business process.
BP_WorkerReferenceIDType Text Required if you provide a value
on BP_WorkerReferenceID. You
can enter:
• Contingent_Worker_ID
• Employee_ID
• WID

BP_WorkerReferenceID Text Optional field. Provide the


reference ID of the person adding
the comment.

You can include these columns for the intercompany business processes:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 620

Inter-Company Business Type Description


Subprocess Fields
InterCompanyBP_AutoComplete Boolean Optional field. Determines
how Workday handles the
intercompany business process
steps. When you enter a value
of 1, Workday automatically
completes business processes.
Completion includes:
• Automatically completing
approvals.
• Bypassing reviews and to dos.
• Suppressing notifications.
Enter a value of 0 to disable
automatic completion of
intercompany business
processes. If you leave this field
empty, Workday automatically
enters 0. You can't enable
InterCompanyBP_AutoComplete
if you enable
InterCompanyBP_Skip.

InterCompanyBP_Skip Boolean Optional field. Determines if


Workday skips the intercompany
business process. Workday can
only skip the business process if
the definition allows skips. When
you enter a value of 1, Workday
automatically skips the business
process.
Enter a value of 0 to disable
automatic skipping of
intercompany business
processes. If you leave this field
empty, Workday automatically
enters 0. You can't enable
InterCompanyBP_Skip
if you enable
InterCompanyBP_AutoComplete.

InterCompanyBP_Comment Text Optional field. Free text comment


regarding the intercompany
business process.
InterCompanyBP_WorkerReferenceIDType
Text Required if you
provide a value for
InterCompanyBP_WorkerReferenceID.
You can enter:
• Contingent_Worker_ID
• Employee_ID
• WID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 621

Inter-Company Business Type Description


Subprocess Fields
InterCompanyBP_WorkerReferenceID
Text Optional field. Uniquely identifies
an intercompany business
process worker. You can provide
the reference ID of an existing
intercompany business process
worker or leave this field blank.
IntercompanyBP_Attachment_FileName
Text Required if you provide a value
on any fields that begin with
InterCompanyBP_Attachment_.
Enter the filename for the
intercompany business process
attachment.
IntercompanyBP_Attachment_EventDescription
Text Optional field. Free text comment
regarding the intercompany
business process attachment.
IntercompanyBP_Attachment_EventCategoryReferenceIDType
Text Required if you
provide a value on the
IntercompanyBP_Attachment_EventCategory
field. You can enter:
• Document_Category_ID
• Document_Category__Workday_Owned__ID
• WID

IntercompanyBP_Attachment_EventCategoryReferenceID
Text Optional field. Provide the
category of the attachment.
IntercompanyBP_Attachment_FileBase64 Optional field. Convert your
intercompany business process
file attachment to Base64Binary
format. After conversion, provide
the attachment file contents.
IntercompanyBP_Attachment_ContentType
Text Optional field. Provide the file
format of the intercompany
business process attachment.

You can include these columns for the attachments:

Attachment Information Fields Type Description


Attachment_FileName Text Optional field. Provide the name
of the attachment file. Maximum
length is 255 characters.
Attachment_FileType Text Optional field. Provide the file
format of the attachment.
Attachment_FileEncoding Text Optional field. Provide the name
of the encoding used for the
attachment.
Attachment_Compressed Boolean Optional field. Specifies if the
attachment is compressed at

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 622

Attachment Information Fields Type Description


the external endpoint. Enter a
value of 1 to indicate that the
attachment is compressed.
Attachment_CompaniesWithoutAccessReferenceIDType
Text Required if you
provide a value on the
Attachment_CompaniesWithoutAccessRefer
field. You can enter:
• Company_Reference_ID
• Organization_Reference_ID
• WID

Attachment_CompaniesWithoutAccessReferenceID
Text Optional field. Specifies
companies that can't view files
attached to the intercompany
child journal. You can provide
reference IDs of existing
companies or leave the field
blank.
Provide the associated
reference IDs for
Attachment_CompaniesWithoutAccessRefer
and
Attachment_CompaniesWithoutAccessRefer
on a separate column for each
company you wish to restrict.

Attachment_FileComment Text Optional field. Free text comment


regarding the attachment file.

Reference: Accounting Journal Connector XML Schema


<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="urn:com.workday/JournalConnector" elementFormDefault="qualified"
attributeFormDefault="qualified" targetNamespace="urn:com.workday/
JournalConnector">
<xsd:element name="JournalConnectorFileData"
type="JournalConnectorRequestType" />
<xsd:simpleType name="WorkerReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Contingent_Worker_ID" />
<xsd:enumeration value="Employee_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="LedgerAccountReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Ledger_Account_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="AccountingJournalReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Accounting_Journal_ID" />
</xsd:restriction>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 623

</xsd:simpleType>
<xsd:simpleType name="CompanyReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Company_Reference_ID" />
<xsd:enumeration value="Organization_Reference_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="AccountingWorktagReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Academic_Level_ID" />
<xsd:enumeration value="Academic_Period_ID" />
<xsd:enumeration value="Academic_Person_ID" />
<xsd:enumeration value="Academic_Unit_ID" />
<xsd:enumeration value="Ad_hoc_Payee_ID" />
<xsd:enumeration value="Applicant_ID" />
<xsd:enumeration value="Asset_Adjustment_Reason_Reference_ID" />
<xsd:enumeration value="Asset_Impairment_Reason_ID" />
<xsd:enumeration value="Bank_Account_ID" />
<xsd:enumeration value="Business_Unit_ID" />
<xsd:enumeration value="Calculation_Compensation_Basis_ID" />
<xsd:enumeration value="Cash_Activity_Category_ID" />
<xsd:enumeration value="Catalog_Item_ID" />
<xsd:enumeration value="Company_Reference_ID" />
<xsd:enumeration value="Compensation_Basis_ID" />
<xsd:enumeration value="Compensation_Grade_ID" />
<xsd:enumeration value="Contingent_Worker_ID" />
<xsd:enumeration value="Contingent_Worker_Type_ID" />
<xsd:enumeration value="Corporate_Credit_Card_Account_ID" />
<xsd:enumeration value="Cost_Center_Reference_ID" />
<xsd:enumeration value="Custom_Organization_Reference_ID" />
<xsd:enumeration value="Custom_Worktag_06_ID" />
<xsd:enumeration value="Custom_Worktag_07_ID" />
<xsd:enumeration value="Custom_Worktag_08_ID" />
<xsd:enumeration value="Custom_Worktag_09_ID" />
<xsd:enumeration value="Custom_Worktag_1_ID" />
<xsd:enumeration value="Custom_Worktag_10_ID" />
<xsd:enumeration value="Custom_Worktag_11_ID" />
<xsd:enumeration value="Custom_Worktag_12_ID" />
<xsd:enumeration value="Custom_Worktag_13_ID" />
<xsd:enumeration value="Custom_Worktag_14_ID" />
<xsd:enumeration value="Custom_Worktag_15_ID" />
<xsd:enumeration value="Custom_Worktag_2_ID" />
<xsd:enumeration value="Custom_Worktag_3_ID" />
<xsd:enumeration value="Custom_Worktag_4_ID" />
<xsd:enumeration value="Custom_Worktag_5_ID" />
<xsd:enumeration value="Customer_Category_ID" />
<xsd:enumeration
value="Customer_Contract_Alternate_Reference_ID" />
<xsd:enumeration value="Customer_Contract_Reference_ID" />
<xsd:enumeration value="Customer_ID" />
<xsd:enumeration value="Customer_Reference_ID" />
<xsd:enumeration value="Deduction_Code" />
<xsd:enumeration value="Deduction_Recipient_ID" />
<xsd:enumeration value="Donor_ID" />
<xsd:enumeration value="Earning_Code" />
<xsd:enumeration value="Employee_ID" />
<xsd:enumeration value="Employee_Type_ID" />
<xsd:enumeration value="Ethnicity_ID" />
<xsd:enumeration value="Expense_Item_ID" />
<xsd:enumeration value="External_Committee_Member_ID" />
<xsd:enumeration value="Financial_Aid_Award_Year_ID" />
<xsd:enumeration value="Financial_Institution_ID" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 624

<xsd:enumeration value="Financial_Institution_Reference_ID" />


<xsd:enumeration value="Fund_ID" />
<xsd:enumeration value="Funding_Source_Name" />
<xsd:enumeration value="Gender_Code" />
<xsd:enumeration value="Gift_Reference_ID" />
<xsd:enumeration value="Grant_ID" />
<xsd:enumeration value="Internal_Service_Provider_ID" />
<xsd:enumeration value="Internal_Service_Provider_Reference_ID" />
<xsd:enumeration value="Investment_Pool_ID" />
<xsd:enumeration value="Investment_Profile_ID" />
<xsd:enumeration value="Investor_ID" />
<xsd:enumeration value="Is_Manager_ID" />
<xsd:enumeration value="Is_People_Manager" />
<xsd:enumeration value="ISO_3166-1_Alpha-2_Code" />
<xsd:enumeration value="ISO_3166-1_Alpha-3_Code" />
<xsd:enumeration value="ISO_3166-1_Numeric-3_Code" />
<xsd:enumeration value="Job_Category_ID" />
<xsd:enumeration value="Job_Level_ID" />
<xsd:enumeration value="Job_Profile_ID" />
<xsd:enumeration value="Job_Requisition_ID" />
<xsd:enumeration value="Loan_ID" />
<xsd:enumeration value="Location_ID" />
<xsd:enumeration value="Management_Level_ID" />
<xsd:enumeration value="NI_Category_Letter" />
<xsd:enumeration value="Object_Class_ID" />
<xsd:enumeration value="Opportunity_Reference_ID" />
<xsd:enumeration value="Organization_Reference_ID" />
<xsd:enumeration value="Pay_Rate_Type_ID" />
<xsd:enumeration value="Payroll_Federal_Authority_Tax_Code" />
<xsd:enumeration value="Payroll_Local_City_Authority_Tax_Code" />
<xsd:enumeration value="Payroll_Local_County_Authority_Tax_Code" /
>
<xsd:enumeration value="Payroll_Local_Other_Authority_Tax_Code" />
<xsd:enumeration
value="Payroll_Local_School_District_Authority_Tax_Code" />
<xsd:enumeration value="Payroll_State_Authority_Tax_Code" />
<xsd:enumeration value="Petty_Cash_Account_ID" />
<xsd:enumeration value="Position_ID" />
<xsd:enumeration value="Position_Time_Type_ID" />
<xsd:enumeration value="Program_ID" />
<xsd:enumeration value="Program_of_Study_ID" />
<xsd:enumeration value="Project_ID" />
<xsd:enumeration value="Project_Plan_ID" />
<xsd:enumeration value="Proposal_Grant_ID" />
<xsd:enumeration value="Prospect_ID" />
<xsd:enumeration value="Prospect_Reference_ID" />
<xsd:enumeration value="Purchase_Item_ID" />
<xsd:enumeration value="Receivable_Writeoff_Reason_ID" />
<xsd:enumeration value="Region_Reference_ID" />
<xsd:enumeration value="Revenue_Category_ID" />
<xsd:enumeration value="Rubric_Value_ID" />
<xsd:enumeration value="Run_Category_ID" />
<xsd:enumeration value="Salary_Over_The_Cap_Type_ID" />
<xsd:enumeration value="Sales_Item_ID" />
<xsd:enumeration value="Spend_Category_ID" />
<xsd:enumeration value="Sponsor_ID" />
<xsd:enumeration value="Sponsor_Reference_ID" />
<xsd:enumeration value="Student_Application_Residency_Status_ID" /
>
<xsd:enumeration value="Student_Award_Item_ID" />
<xsd:enumeration value="Student_Charge_Item_ID" />
<xsd:enumeration value="Student_Course_ID" />
<xsd:enumeration value="Student_Course_Section_ID" />
<xsd:enumeration value="Student_ID" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 625

<xsd:enumeration value="Student_Recruiting_Campaign_ID" />


<xsd:enumeration value="Student_Recruiting_Event_ID" />
<xsd:enumeration value="Student_Sponsor_Contract_ID" />
<xsd:enumeration value="Student_Waiver_Item_ID" />
<xsd:enumeration value="Supplier_Category_ID" />
<xsd:enumeration value="Supplier_Contract_ID" />
<xsd:enumeration value="Supplier_ID" />
<xsd:enumeration value="Supplier_Reference_ID" />
<xsd:enumeration value="Tax_Applicability_ID" />
<xsd:enumeration value="Tax_Authority_ID" />
<xsd:enumeration value="Tax_Authority_Reference_ID" />
<xsd:enumeration value="Tax_Category_ID" />
<xsd:enumeration value="Tax_Code_ID" />
<xsd:enumeration value="Tax_Point_Date_Type_ID" />
<xsd:enumeration value="Tax_Rate_ID" />
<xsd:enumeration value="Tax_Recoverability_Object_ID" />
<xsd:enumeration value="Third_Party_ID" />
<xsd:enumeration value="Withholding_Order_Case_ID" />
<xsd:enumeration value="Withholding_Tax_Code_ID" />
<xsd:enumeration value="Withholding_Tax_Rate_ID" />
<xsd:enumeration value="Work_Function_ID" />
<xsd:enumeration value="Work_Shift_ID" />
<xsd:enumeration value="Workday_Deduction_Code" />
<xsd:enumeration value="Workday_Earning_Code" />
<xsd:enumeration value="Worker_Type_ID" />
<xsd:enumeration value="Appropriation_ID" />
<xsd:enumeration value="Allocation_Pool_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="BalancingWorktagReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Business_Unit_ID" />
<xsd:enumeration value="Cost_Center_Reference_ID" />
<xsd:enumeration value="Custom_Organization_Reference_ID" />
<xsd:enumeration value="Fund_ID" />
<xsd:enumeration value="Organization_Reference_ID" />
<xsd:enumeration value="Region_Reference_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="EventAttachmentCategoryReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Document_Category__Workday_Owned__ID" />
<xsd:enumeration value="Document_Category_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="AuditedAccountingWorktagReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Academic_Level_ID" />
<xsd:enumeration value="Academic_Period_ID" />
<xsd:enumeration value="Academic_Person_ID" />
<xsd:enumeration value="Academic_Unit_ID" />
<xsd:enumeration value="Ad_hoc_Payee_ID" />
<xsd:enumeration value="Applicant_ID" />
<xsd:enumeration value="Asset_Adjustment_Reason_Reference_ID" />
<xsd:enumeration value="Asset_Impairment_Reason_ID" />
<xsd:enumeration value="Bank_Account_ID" />
<xsd:enumeration value="Business_Unit_ID" />
<xsd:enumeration value="Cash_Activity_Category_ID" />
<xsd:enumeration value="Catalog_Item_ID" />
<xsd:enumeration value="Company_Reference_ID" />
<xsd:enumeration value="Compensation_Grade_ID" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 626

<xsd:enumeration value="Contingent_Worker_ID" />


<xsd:enumeration value="Contingent_Worker_Type_ID" />
<xsd:enumeration value="Corporate_Credit_Card_Account_ID" />
<xsd:enumeration value="Cost_Center_Reference_ID" />
<xsd:enumeration value="Custom_Organization_Reference_ID" />
<xsd:enumeration value="Custom_Worktag_06_ID" />
<xsd:enumeration value="Custom_Worktag_07_ID" />
<xsd:enumeration value="Custom_Worktag_08_ID" />
<xsd:enumeration value="Custom_Worktag_09_ID" />
<xsd:enumeration value="Custom_Worktag_1_ID" />
<xsd:enumeration value="Custom_Worktag_10_ID" />
<xsd:enumeration value="Custom_Worktag_11_ID" />
<xsd:enumeration value="Custom_Worktag_12_ID" />
<xsd:enumeration value="Custom_Worktag_13_ID" />
<xsd:enumeration value="Custom_Worktag_14_ID" />
<xsd:enumeration value="Custom_Worktag_15_ID" />
<xsd:enumeration value="Custom_Worktag_2_ID" />
<xsd:enumeration value="Custom_Worktag_3_ID" />
<xsd:enumeration value="Custom_Worktag_4_ID" />
<xsd:enumeration value="Custom_Worktag_5_ID" />
<xsd:enumeration value="Customer_Category_ID" />
<xsd:enumeration
value="Customer_Contract_Alternate_Reference_ID" />
<xsd:enumeration value="Customer_Contract_Reference_ID" />
<xsd:enumeration value="Customer_ID" />
<xsd:enumeration value="Customer_Reference_ID" />
<xsd:enumeration value="Deduction_Recipient_ID" />
<xsd:enumeration value="Donor_ID" />
<xsd:enumeration value="Employee_ID" />
<xsd:enumeration value="Employee_Type_ID" />
<xsd:enumeration value="Ethnicity_ID" />
<xsd:enumeration value="Expense_Item_ID" />
<xsd:enumeration value="External_Committee_Member_ID" />
<xsd:enumeration value="Financial_Institution_ID" />
<xsd:enumeration value="Financial_Institution_Reference_ID" />
<xsd:enumeration value="Fund_ID" />
<xsd:enumeration value="Funding_Source_Name" />
<xsd:enumeration value="Gender_Code" />
<xsd:enumeration value="Gift_Reference_ID" />
<xsd:enumeration value="Grant_ID" />
<xsd:enumeration value="Internal_Service_Provider_ID" />
<xsd:enumeration value="Internal_Service_Provider_Reference_ID" />
<xsd:enumeration value="Investment_Pool_ID" />
<xsd:enumeration value="Investment_Profile_ID" />
<xsd:enumeration value="Investor_ID" />
<xsd:enumeration value="Job_Category_ID" />
<xsd:enumeration value="Job_Level_ID" />
<xsd:enumeration value="Job_Profile_ID" />
<xsd:enumeration value="Job_Requisition_ID" />
<xsd:enumeration value="Loan_ID" />
<xsd:enumeration value="Location_ID" />
<xsd:enumeration value="Management_Level_ID" />
<xsd:enumeration value="Object_Class_ID" />
<xsd:enumeration value="Opportunity_Reference_ID" />
<xsd:enumeration value="Organization_Reference_ID" />
<xsd:enumeration value="Pay_Rate_Type_ID" />
<xsd:enumeration value="Petty_Cash_Account_ID" />
<xsd:enumeration value="Position_ID" />
<xsd:enumeration value="Position_Time_Type_ID" />
<xsd:enumeration value="Program_ID" />
<xsd:enumeration value="Program_of_Study_ID" />
<xsd:enumeration value="Project_ID" />
<xsd:enumeration value="Project_Plan_ID" />
<xsd:enumeration value="Proposal_Grant_ID" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 627

<xsd:enumeration value="Prospect_ID" />


<xsd:enumeration value="Prospect_Reference_ID" />
<xsd:enumeration value="Purchase_Item_ID" />
<xsd:enumeration value="Receivable_Writeoff_Reason_ID" />
<xsd:enumeration value="Region_Reference_ID" />
<xsd:enumeration value="Revenue_Category_ID" />
<xsd:enumeration value="Run_Category_ID" />
<xsd:enumeration value="Salary_Over_The_Cap_Type_ID" />
<xsd:enumeration value="Sales_Item_ID" />
<xsd:enumeration value="Spend_Category_ID" />
<xsd:enumeration value="Sponsor_ID" />
<xsd:enumeration value="Sponsor_Reference_ID" />
<xsd:enumeration value="Student_Award_Item_ID" />
<xsd:enumeration value="Student_Charge_Item_ID" />
<xsd:enumeration value="Student_Course_ID" />
<xsd:enumeration value="Student_Course_Section_ID" />
<xsd:enumeration value="Student_ID" />
<xsd:enumeration value="Student_Recruiting_Campaign_ID" />
<xsd:enumeration value="Student_Recruiting_Event_ID" />
<xsd:enumeration value="Student_Sponsor_Contract_ID" />
<xsd:enumeration value="Student_Waiver_Item_ID" />
<xsd:enumeration value="Supplier_Category_ID" />
<xsd:enumeration value="Supplier_Contract_ID" />
<xsd:enumeration value="Supplier_ID" />
<xsd:enumeration value="Supplier_Reference_ID" />
<xsd:enumeration value="Tax_Applicability_ID" />
<xsd:enumeration value="Tax_Authority_ID" />
<xsd:enumeration value="Tax_Authority_Reference_ID" />
<xsd:enumeration value="Tax_Category_ID" />
<xsd:enumeration value="Tax_Code_ID" />
<xsd:enumeration value="Tax_Rate_ID" />
<xsd:enumeration value="Tax_Recoverability_Object_ID" />
<xsd:enumeration value="Third_Party_ID" />
<xsd:enumeration value="Withholding_Order_Case_ID" />
<xsd:enumeration value="Withholding_Tax_Code_ID" />
<xsd:enumeration value="Withholding_Tax_Rate_ID" />
<xsd:enumeration value="Work_Function_ID" />
<xsd:enumeration value="Work_Shift_ID" />
<xsd:enumeration value="Appropriation_ID" />
<xsd:enumeration value="Allocation_Pool_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxTypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Tax_Type_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxCodeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Tax_Code_ID" />
<xsd:enumeration value="Withholding_Tax_Code_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxRateReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Tax_Rate_ID" />
<xsd:enumeration value="Withholding_Tax_Rate_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxApplicabilityReferenceEnumeration">
<xsd:restriction base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 628

<xsd:enumeration value="WID" />


<xsd:enumeration value="Tax_Applicability_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxRecoverabilityReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Tax_Recoverability_Object_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxRecoverabilityReferenceTypeEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Tax_Recoverability_Type_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxPointDateTypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Tax_Point_Date_Type_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxSupplierReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Supplier_ID" />
<xsd:enumeration value="Supplier_Reference_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TaxCustomerReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="WID" />
<xsd:enumeration value="Customer_ID" />
<xsd:enumeration value="Customer_Reference_ID" />
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="FinancialsAttachmentDataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing all Business
Document Attachment
data.</xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>If a file name is specified for a
Financial Attachment,
File Content and Content Type are required.</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="fileContent" type="xsd:base64Binary"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>File content in binary format.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CompaniesWithoutAccessReferenceID"
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Reference to companies with access to
attachment.</xsd:documentation>
<xsd:appinfo>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 629

<xsd:Validation>
<xsd:Validation_Message>
A company you entered on the Companies Without
Access field is not a company on the Journal Line column.
To restrict an attached file, you must enter a
company that is also on the Journal Line column.
</xsd:Validation_Message>
</xsd:Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="CompanyReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Comment</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="contentType">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Content Type of
the
Attachment.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="80" />
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
<xsd:attribute name="fileName">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Filename of the
Attachment.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="255" />
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
<xsd:attribute name="encoding" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Encoding of the
Attachment.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="compressed" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>Boolean attribute identifying whether the
Attachment is
compressed.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="BusinessProcessCommentDataType">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 630

<xsd:annotation>
<xsd:documentation>Captures a comment for the Business Process.</
xsd:documentation>
</xsd:annotation>
<xsd:sequence />
</xsd:complexType>
<xsd:complexType name="BusinessSubProcessParametersType">
<xsd:annotation>
<xsd:documentation>Container for the processing options for sub-
business processes
within a business process. If no options are submitted (or the
options are submitted
as 'false') then the sub-business process is simply initiated
as if it where
submitted on-line with approvals, reviews, notifications and
to-do's in
place.</xsd:documentation>
</xsd:annotation>
<xsd:sequence />
</xsd:complexType>
<xsd:complexType name="FinancialsBusinessProcessParametersType">
<xsd:annotation>
<xsd:documentation>Contains data for business processing</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AutoComplete" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the business
process is
automatically processed. This means that all approvals
will be automatically
approved in the system, all reviews and to-do's will
be automatically
by-passed, and all notifications will be automatically
suppressed.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:appinfo>
<Validation>
<ValidationMessage>This Business Process has been
configured to
disable comment. Please remove the comment or
change the setting in
the Business Process Policy or tenant setup.</
ValidationMessage>
</Validation>
</xsd:appinfo>
<xsd:documentation>Free form comment regarding the
business
process.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WorkerReferenceID" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>ReferenceId of the person adding the
comment</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 631

<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="WorkerReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="AccountingJournalIntercompanySubProcessType">
<xsd:annotation>
<xsd:documentation>Wrapper for the Accounting Journal Intercompany
Sub Process. It
allows you to specify parameters for the sub process.</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:choice>
<xsd:element name="AutoComplete" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the
business process is
automatically processed. This means that all
approvals will be
automatically approved in the system, all reviews
and to-do's will be
automatically by-passed, and all notifications
will be automatically
suppressed.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Skip" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the
business process is
automatically skipped (if it is defined as
"skippable" within the
business process definition).</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:choice>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form comment regarding the
business
process.</xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>This Business Process has been
configured to
disable comment. Please remove the comment or
change the setting in
the Business Process Policy or tenant setup.</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="WorkerReferenceID" minOccurs="0" maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 632

<xsd:documentation>Default the Person making the comment


to the processing
person if not submitted via journal connector</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="WorkerReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BusinessProcessAttachmentData"
type="BusinessProcessAttachmentDataType" minOccurs="0"
maxOccurs="unbounded" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="BusinessProcessAttachmentDataType">
<xsd:annotation>
<xsd:documentation>Element for the attachments pertaining to a
Event entered through a
web service.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="FileName" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Filename for the attachment.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="255" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="EventAttachmentDescription" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form text comment about the
attachment.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="EventAttachmentCategoryReferenceID"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Category of attachment.</
xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>This Business Process Type has
been configured to
not accept Attachment Categories.</
Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="EventAttachmentCategoryReferenceEnumeration" use="required">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 633

<xsd:documentation>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".</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="File" type="xsd:base64Binary" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Binary file contents.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ContentType" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Content Type
of the
Attachment.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="80" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="JournalEntryLineDataType">
<xsd:annotation>
<xsd:documentation>Element containing all Journal Entry Line
data</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>The Credit and Debit Amount both have
values.</xsd:documentation>
<ValidationMessage>The Credit and Debit Amount both have
values.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>The Credit and Debit Amounts are both
zero.</xsd:documentation>
<ValidationMessage>The Credit and Debit Amounts are both
zero.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Only one worktag for each type is
allowed for each document
line.</xsd:documentation>
<ValidationMessage>Only one worktag for each type is
allowed for each
document line.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Cannot have an Employee Worktag along
with a Contingent
Worker Worktag for the same line.</ValidationMessage>
</Validation>
<Validation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 634

<xsd:documentation>Can not have any combination of


Project, Project Phase or
Project Task worktags for the same line.</
xsd:documentation>
<ValidationMessage>Can not have any combination of
Project, Project Phase or
Project Task worktags for the same line.</
ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>If the View Budget Date flag is not set
on the Ledger,
Journal Line Budget Date cannot be submitted.</
ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Transaction credits or debits must be
populated if the
line companies have different ledger currencies.</
ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>If the Display Account set is defined,
then the Ledger
Accounts must come from that account set.</
ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>You are attempting to import a journal
for [company]
which does not have a resulting ledger account mapped
or specified.[cjwe
false message] [submit true message]</
ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Line Company Reference must match the
header company when
Round Ledger Amounts is specified.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Ledger Debit Amount and Ledger Credit
Amount must be zero
when Round Ledger Amounts is specified.</
ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>The following worktag type(s) are
required:
[missing]</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="LineOrder" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Optional line order. If specified,
lines will be sorted by
this value when displayed and when invoice is
printed.</xsd:documentation>
</xsd:annotation>
</xsd:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 635

<xsd:element name="LineCompanyReferenceID" minOccurs="0"


maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The company for the line for
intercompany journals.If field
is left blank, it will default to the same company as
the header company.
For non-intercompany journals this field should be
left blank or have the
same value as the header company. For beginning
balance journal loads, this
field should always be blank or the same as the header
company. For journals
that are intercompany beginning balances, the other
company should only be
referenced as an intercompany affiliate worktag.</
xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>The company is not configured
for intercompany
transactions with the company specified</
xsd:documentation>
<ValidationMessage>[2] is not configured to allow
intercompany
transactions with [1]</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>The company specified has a
ledger period with an
invalid status.</xsd:documentation>
<ValidationMessage>Update the status of the ledger
period for
journal entries of the company [company] using
one of the Update
Ledger Period Status tasks.</
ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Journal must be an Adjustment
Journal to be submitted
in an Adjustment Period.</xsd:documentation>
<ValidationMessage>Journal must be an Adjustment
Journal to be
submitted in an Adjustment Period for
[company].</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>The date selected does not have
a valid ledger period
associated with it.</xsd:documentation>
<ValidationMessage>The date selected does not have
a valid ledger
period associated with it.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Reversal cannot be created
because the ledger period
for the reversal date and the affiliate
company does not exist.
Please use one of the Ledger/Ledger Period
tasks for the company to
create the period.</xsd:documentation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 636

<ValidationMessage>Reversal cannot be created


because the ledger
period for the reversal date and the affiliate
company does not
exist. Please use one of the Ledger/Ledger
Period tasks for the
company to create the period.</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="CompanyReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="LedgerAccountReferenceID"
type="LedgerAccountObjectIDType" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Ledger
Account. The Ledger Account
reference is a 2 part reference ID, composed of the
Ledger Account ID and
the Reference ID for the Ledger Account Set it is
organized
into.</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>At least one of the Ledger
Accounts entered is
retired. Only non retired accounts are
allowed.</xsd:documentation>
<ValidationMessage>At least one of the Ledger
Accounts entered is
retired. Only non retired accounts are
allowed.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>At least one of the ledger
accounts entered is a
control account.</xsd:documentation>
<ValidationMessage>At least one of the ledger
accounts entered is a
control account.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Ledger Account is not valid for
the Company Account
Set</xsd:documentation>
<ValidationMessage>Ledger Account: [ledger
account] is not valid for
company [company]'s account set.</
ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Ledger accounts must be from
Ledger Account
Security Segments to which the user has
access.</ValidationMessage>
</Validation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 637

</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="AlternateLedgerAccountReferenceID"
type="LedgerAccountObjectIDType" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Alternate Ledger Account (ALA) provides
the ability, when
Alternate Account Set is enabled for the header
company, to override the
account to which the Ledger Account is mapped by the
Alternate Account Set
Mapping rules.I.E. - if the Ledger Account is 1000
Cash, and the mapping
rules map the journal to the 1100 Alternate Cash
account, setting the ALA to
1200: Other Cash Account will cause the journal to use
Other Cash rather
than Alternate Cash.</xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>At least one of the Ledger
Accounts entered is
retired. Only non retired accounts are
allowed.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>At least one of the ledger
accounts entered is a
control account.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Alternate Ledger Account: [ala]
is not a member
of [company]'s Primary or Alternate Account
Sets.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Ledger accounts must be from
Ledger Account
Security Segments to which the user has
access.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:choice>
<xsd:element name="DebitAmount" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Debit Amount</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26" />
<xsd:fractionDigits value="6" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="CreditAmount" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Credit Amount</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 638

<xsd:totalDigits value="26" />


<xsd:fractionDigits value="6" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:choice>
<xsd:element name="Currency" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to the currency of the
company. If entered, this
field is not processed on inbound Workday Journal
Connector
requests.</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Currency Conversion Rates
between the currency on the
Journal Line and company's default currency
must be defined for the
selected Currency Rate Type, effective as of
the Accounting Date for
the Journal. This validation only applies to
Accounting
Journals.</xsd:documentation>
<ValidationMessage>Currency Conversion Rates
between currency and
company's default currency are not defined.</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="CurrencyRate" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Currency Rate for line</
xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>The Currency Rate cannot be
negative.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>If the base currency is equal
to the transaction
currency, the currency rate cannot be
entered.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="6" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:choice>
<xsd:element name="LedgerDebitAmount" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Ledger Debit Amount</
xsd:documentation>
<xsd:appinfo>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 639

<Validation>
<xsd:documentation>If the base currency and
the transaction currency are
equal, the transaction amount must equal the
ledger
amount.</xsd:documentation>
<ValidationMessage>If the base currency and
the transaction currency
are equal, the transaction amount must equal
the ledger
amount.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>The Debit Amount precision
cannot exceed the
precision of the Company currency.</
xsd:documentation>
<ValidationMessage>Decimal precision of
[precision] for [currency]
exceeded for Debit Amount: [amount]</
ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>If the base currency is not
equal to the transaction
currency, the ledger amount must also be
entered.</xsd:documentation>
<ValidationMessage>If the base currency is not
equal to the
transaction currency, the ledger amount must
also be
entered.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="3" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="LedgerCreditAmount" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Ledger Credit Amount</
xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>If the base currency and
the transaction currency are
equal, the transaction amount must equal the
ledger
amount.</xsd:documentation>
<ValidationMessage>If the base currency and
the transaction currency
are equal, the transaction amount must equal
the ledger
amount.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>The Credit Amount precision
cannot exceed the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 640

precision of the Company currency.</


xsd:documentation>
<ValidationMessage>Decimal precision of
[precision] for [currency]
exceeded for Credit Amount: [amount]</
ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>If the base currency is not
equal to the transaction
currency, the ledger amount must also be
entered.</xsd:documentation>
<ValidationMessage>If the base currency is not
equal to the
transaction currency, the ledger amount must
also be
entered.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="3" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:choice>
<xsd:element name="Quantity" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Quantity. To be used in conjunction
with Unit of
Measure.</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Select Record Quantity if you
want to enter Unit
of Measure and Quantity.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="6" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="UnitOfMeasure" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Unit of Measure. To be used in
conjunction with
Quantity.</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Select Record Quantity if you
want to enter Unit
of Measure and Quantity.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="Quantity2" minOccurs="0" maxOccurs="1">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 641

<xsd:annotation>
<xsd:documentation>Quantity 2. To be used in conjunction
with Unit of Measure 2.
Only use if Quantity and Unit of Measure have been
entered.</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Select Record Quantity and
enter Unit of Measure
and Quantity if you want to enter Quantity 2
and Unit of Measure
2.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="6" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="UnitOfMeasure2" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Unit of Measure 2. To be used in
conjunction with Quantity 2.
Only use if Quantity and Unit of Measure have been
entered.</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Select Record Quantity and
enter Unit of Measure
and Quantity if you want to enter Quantity 2
and Unit of Measure
2.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="Memo" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Memo for the line</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalLineExternalReferenceID"
type="xsd:string" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Journal reference Id from external
systems to maintain references and reconcilation</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="BudgetDate" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Budget Date for the Journal Line. It is
required if the View
Budget Date flag is set to true for the Ledger.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WorktagsReferenceID" minOccurs="0"
maxOccurs="unbounded">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 642

<xsd:annotation>
<xsd:documentation>Reference to existing worktags.
Worktags are a way to mark
tasks and business objects to make them easier to
access and summarize. Each
transaction can include one value for each worktag
type and is subject to
configurable validation when submitted for approval.</
xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>The Worktags provided are not
valid for this
transaction</xsd:documentation>
<ValidationMessage>[list of worktag types] not
valid for this
transaction.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>You have chosen an invalid
combination of header
company, line company, and intercompany
affiliate.</xsd:documentation>
<ValidationMessage>The intercompany affiliate
[worktag] may not be
chosen when specifying header company [header
company] and line
company [line company].</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>A balancing worktag is required
if worktag balancing
has been enabled for the tenant.</
xsd:documentation>
<ValidationMessage>Select a balancing worktag for
Worktags of the
following type: [type]</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="AccountingWorktagReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BalancingWorktagAffiliateID" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Balancing worktag affiliate for journal
line.</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>You must have Worktag Balancing
enabled in order to
define a Worktag Balancing Affiliate.</
xsd:documentation>
<ValidationMessage>You must have Worktag Balancing
enabled in order
to define a Worktag Balancing Affiliate.</
ValidationMessage>
</Validation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 643

<Validation>
<xsd:documentation>The Balancing Worktag Affiliate
Type must be of the
same type as defined for Balancing Worktags at
the tenant
level.</xsd:documentation>
<ValidationMessage>Enter a Balancing Worktag
Affiliate that is the
type [tenant type].</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>The Balancing Worktag in the
Worktags field is
not allowed to be the same as the Balancing
Worktag
Affiliate.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>When an Intercompany Affiliate
is present in the
Worktags field you are not allowed to have a
Balancing Worktag
Affiliate.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="BalancingWorktagReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ExternalCode" minOccurs="0"
maxOccurs="unbounded">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="name" type="xsd:string" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ExcludefromSpendReport" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>For expense report and supplier invoice
transactions tied to
a capital project worktag, Workday creates special
accounting to
appropriately debit the Work in Progress account,
while also recording the
amount as a debit into the Spend account. This is
necessary to reflect
correct amounts for the purposes of Budget Checking/
Reporting, and any other
custom spend reports.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AlternateLedgerCurrencyLineData"
type="ALCLineData" minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 644

<xsd:documentation>Contains the alternate ledger currency


line data and rate
override data.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxDetailData"
type="JournalLineTaxDetailDataType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax
Details
data</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ALCLineData">
<xsd:annotation>
<xsd:documentation>Contains the alternate ledger currency line
data and rate override
data.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AlternateLedgerCurrency" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Contains references to an existing
alternate ledger currency
for the company.</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Specify an Alternate Ledger
Currency that matches an
alternate ledger currency for [company].</
Validation_Message>
</Validation>
<Validation>
<Validation_Message>The journal line ledger
amounts must match Alternate
Ledger Currency Line Data amounts when the
affiliate and alternate
ledger currencies match.</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>To specify Alternate Ledger
Currency Line Data,
select Create Journals for Alternate Ledger
Currency.</xsd:documentation>
<Validation_Message>To specify Alternate Ledger
Currency Line Data,
select Create Journals for Alternate Ledger
Currency.</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Remove the Alternate Ledger
Currency Details. You
can't enter Alternate Ledger Currency Details
for a Commitment or
Obligation Ledger Type.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="AlternateLedgerCurrencyRate" minOccurs="0"
maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 645

<xsd:documentation>Contains the positive numeric currency


rate value that
overrides the current alternate ledger currency rate
value.</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Enter a Currency Rate value
that's positive.</xsd:documentation>
<Validation_Message>Enter a Currency Rate value
that's positive.</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Don't enter a Currency Rate if
the alternate ledger
currency matches the transaction currency.</
xsd:documentation>
<Validation_Message>Don't enter a Currency Rate if
the alternate ledger
currency matches the transaction currency.</
Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="24" />
<xsd:fractionDigits value="12" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="AlternateLedgerDebitAmount" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Contains the currency value that
overrides the debt amount
for the alternate ledger currency journal line.</
xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>If the alternate ledger
currency and the transaction
currency are equal, the transaction amount
must equal the alternate
ledger currency override amount.</
xsd:documentation>
<Validation_Message>If the alternate ledger
currency and the transaction
currency are equal, the transaction amount
must equal the alternate
ledger currency override amount.</
Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="3" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="AlternateLedgerCreditAmount" minOccurs="0"
maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 646

<xsd:documentation>Contains the currency value that


overrides the credit amount
for the alternate ledger currency journal line.</
xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>If the alternate ledger
currency and the transaction
currency are equal, the transaction amount
must equal the alternate
ledger currency override amount.</
xsd:documentation>
<Validation_Message>If the alternate ledger
currency and the transaction
currency are equal, the transaction amount
must equal the alternate
ledger currency override amount.</
Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="3" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="JournalLineTaxDetailDataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax Details
data</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Both Customer and Supplier cannot be
entered together. Choose
one to keep and remove the other.</xsd:documentation>
<Validation_Message>Both Customer and Supplier cannot be
entered together.
Choose one to keep and remove the other.</
Validation_Message>
</Validation>
<Validation>
<xsd:documentation>External business parameters cannot be
entered when a
Customer or Supplier has been entered. Remove either
the external business
parameters or the customer or supplier selected.</
xsd:documentation>
<Validation_Message>External business parameters cannot be
entered when a
Customer or Supplier has been entered. Remove either
the external business
parameters or the customer or supplier selected.</
Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Include Tax Lines should be selected to
add Journal Line Tax
Detail Data.</xsd:documentation>
<Validation_Message>Include Tax Lines should be selected
to add Journal Line

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 647

Tax Detail Data.</Validation_Message>


</Validation>
<Validation>
<xsd:documentation>The field Tax Applicability is required
and must have a
value.</xsd:documentation>
<Validation_Message>The field Tax Applicability is
required and must have a
value.</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>You can’t enter Tax Recoverability for
a Tax Type of Tax
Collected.</xsd:documentation>
<Validation_Message>You can’t enter Tax Recoverability for
a Tax Type of Tax
Collected.</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>You must enter a Tax Recoverability
Type when the Tax
Recoverability is partially recoverable.</
xsd:documentation>
<Validation_Message>You must enter a Tax Recoverability
Type when the Tax
Recoverability is partially recoverable.</
Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Enter a Tax Recoverability Type or
select a Tax
Applicability that has a default Tax Recoverability.</
xsd:documentation>
<Validation_Message>Enter a Tax Recoverability Type or
select a Tax
Applicability that has a default Tax Recoverability.</
Validation_Message>
</Validation>
<Validation>
<xsd:documentation>The Tax Recoverability Type must be
Nonrecoverable when the
Tax Recoverability is nonrecoverable.</
xsd:documentation>
<Validation_Message>The Tax Recoverability Type must be
Nonrecoverable when
the Tax Recoverability is nonrecoverable.</
Validation_Message>
</Validation>
<Validation>
<xsd:documentation>You can’t enter Tax Recoverability for
a Withholding Tax
Code.</xsd:documentation>
<Validation_Message>You can’t enter Tax Recoverability for
a Withholding Tax
Code.</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>The Tax Recoverability Type must be
Fully Recoverable when
the Tax Recoverability is fully recoverable.</
xsd:documentation>
<Validation_Message>The Tax Recoverability Type must be
Fully Recoverable

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 648

when the Tax Recoverability is fully recoverable.</


Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Enter a Tax Recoverability or select a
Tax Applicability
that has a default Tax Recoverability.</
xsd:documentation>
<Validation_Message>Enter a Tax Recoverability or select a
Tax Applicability
that has a default Tax Recoverability.</
Validation_Message>
</Validation>
<Validation>
<xsd:documentation>You can’t enter a Tax Applicability for
a Withholding Tax
Code.</xsd:documentation>
<Validation_Message>You can’t enter a Tax Applicability
for a Withholding
Tax Code.</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>You can’t enter a Tax Recoverability
Type for a Withholding
Tax Code.</xsd:documentation>
<Validation_Message>You can’t enter a Tax Recoverability
Type for a
Withholding Tax Code.</Validation_Message>
</Validation>
<Validation>
<Validation_Message>When you enter a Tax Point Date Type,
you must specify a
Transaction Tax Code.</Validation_Message>
</Validation>
<Validation>
<Validation_Message>You can only enter the Tax Point Date
Type when you
select the Enable Tax Point Date Configuration check
box on the Edit Tenant
Setup - Financials task.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxTransactionDate" type="xsd:date"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The date the transaction occurred for
the manual journal with
direct tax.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxTypeReferenceID" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The reference id value for the tax
type.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxTypeReferenceEnumeration" use="required">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 649

<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxableAmount" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The transaction taxable amount basis
for the tax amount
entered in the debit/credit amount of the journal line
with
tax.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:fractionDigits value="3" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TaxCodeReferenceID" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The reference id value for the tax
code.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxCodeReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRateReferenceID" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The reference id value for the tax
rate.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxRateReferenceEnumeration" use="required">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 650

<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxApplicabilityReferenceID" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The reference id value of the tax
applicability.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxApplicabilityReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverabilityReferenceID" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The reference id value for the tax
recoverability.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxRecoverabilityReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverabilityTypeReferenceID"
minOccurs="0">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 651

<xsd:documentation>The reference id value for the tax


recoverability.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxRecoverabilityReferenceTypeEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxPointDateTypeReferenceID" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Tax Point Date Type</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxPointDateTypeReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxSupplierReferenceID" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The reference id value for the
supplier.</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>The [type] is/are not
available for use with the
company/s: [partitionable] [company]</
Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxSupplierReferenceEnumeration" use="required">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 652

<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxCustomerReferenceID" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The reference id value for the
customer.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxCustomerReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxExternalBusinessEntityName"
type="xsd:string" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The name of the customer or supplier if
not defined within
Workday.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxExternalBusinessEntityAddress"
type="xsd:string" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The address for the customer or
supplier if not defined
within Workday.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxExternalBusinessEntityTaxID"
type="xsd:string" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The tax id for the customer or supplier
if not defined within
Workday.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxableEventLineReference"
type="TaxableEventLineReferenceType" minOccurs="0" maxOccurs="unbounded" />
</xsd:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 653

</xsd:complexType>
<xsd:complexType name="TaxableEventLineReferenceType">
<xsd:annotation>
<xsd:documentation>Taxable Event Line Reference</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="LineOrder" type="xsd:string" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Enter the line order of the journal
line to which this tax line is
related. Workday uses the line order to relate the
tax line to the
taxable event journal line</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="JournalConnectorRequestType">
<xsd:annotation>
<xsd:documentation>Contains data for creating a Accounting Journal
and submitting for
business processing</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>The Accounting Journal is posted or
canceled or is an
intercompany or reversal journal and cannot be
submitted.</xsd:documentation>
<ValidationMessage>The Accounting Journal is posted or
canceled or is an
intercompany or reversal journal and cannot be
submitted.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>The Journal Connector is set to Add
Only; documents cannot be
resubmitted.</xsd:documentation>
<ValidationMessage>The Journal Connector is set to Add
Only; documents cannot be
resubmitted.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Journals with a status of "Correct In
Progress" are not
supported in the Journal Connector. Please finish
correcting by using the business
process Correct task.</xsd:documentation>
<ValidationMessage>Journals with a status of "Correct In
Progress" are not
supported in the Journal Connector. Please finish
correcting by using the business
process Correct task.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AccountingJournalData"
type="AccountingJournalDataType" minOccurs="1" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Contains data for creating a Accounting
Journal and
submitting for business processing</xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 654

</xsd:element>
</xsd:sequence>
<xsd:attribute name="addOnly" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>Add Only Flag. Indicates that the
processing is in an add only mode and not an
update.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="createJournalwithErrors" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>The boolean Create Journal With Errors is
supplied to indicate to
the processing whether a journal for a ledger company with
Alternate Account
Sets enabled should be created even if there is no mapping
to a proper Alternate
Ledger Account.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="AccountingJournalDataType">
<xsd:annotation>
<xsd:documentation>Accounting Journal Data</xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>The ledger period status for the
journal is not
valid.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>A Book Code can only be selected if the
Ledger Type is
Actuals.</xsd:documentation>
<ValidationMessage>A Book Code can only be selected if the
Ledger Type is
Actuals.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Reversal date must be greater than or
equal to the accounting
date.</xsd:documentation>
<ValidationMessage>Reversal date must be greater than or
equal to the
accounting date.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>If "create reversal" is not requested,
then Reversal date
must not contain a value.</xsd:documentation>
<ValidationMessage>If "create reversal" is not requested,
then Reversal date
must not contain a value.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>The date selected does not have a valid
ledger period
associated with it.</ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Reversal cannot be created because the
ledger period for the
reversal date does not exist or is not in a valid
status for journal

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 655

reversals. Please use one of the Ledger/Ledger Period


tasks to create the
period.</xsd:documentation>
<ValidationMessage>Reversal cannot be created because the
ledger period for
the reversal date does not exist or is not in a valid
status for journal
reversals. Please use one of the Ledger/Ledger Period
tasks to create the
period.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>The following ledger period after the
selected ledger
period must be in valid status in order to create this
reversing
journal.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AccountingJournalReferenceID" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Accounting
Journal</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="AccountingJournalReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BusinessProcessParameters"
type="FinancialsBusinessProcessParametersType" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Business Process Parameters provide the
ability to
auto-submit to the business process.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AccountingJournalID" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Accounting Journal Reference ID. This
is the Accounting
Journal unique identifier</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Submit" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Submit for Approval is a boolean flag
indicating if the
transaction is to be submitted or saved in draft mode.
If this flag is set,
the transaction will be submitted, otherwise the
transaction is saved in
draft.</xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 656

</xsd:element>
<xsd:element name="DisableOptionalWorktagBalancing"
type="xsd:boolean" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Disables Optional Worktag balancing for
the given
journal.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="LockedinWorkday" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Locked in Workday is a boolean flag
controlling user ability
to edit the transaction. If the flag is set the user
can't edit, cancel or
change the transaction inside the Workday application,
however the user can
submit a draft transaction. The transaction can only
be updated from the web
service.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RoundLedgerAmounts" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Round Ledger Amounts allows for
automatically balancing
rounding differences for the ledger amounts for a
multi-currency Journal
Entry as long as the following criteria are met:*All
Line Company References
must match the Company Reference for the Accounting
Journal*No Ledger Debit
or Ledger Credit Amounts are populated*All journal
lines use the same
currency rate*All journal lines use the same
transaction currency*A
Balancing Worktag Reference is not specified for the
Accounting
Journal</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalforAllLedgers" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>If true, indicates if the journal is an
all ledgers journal
and Workday creates a primary journal. If the company
has an alternate
ledger currency configured, Workday also creates the
alternate ledger. If
false or blank, indicates the journal is a single
ledger
journal.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalNumber" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Journal Number. The Journal Number will
be automatically
generated through the sequencing number
configuration.</xsd:documentation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 657

</xsd:annotation>
</xsd:element>
<xsd:element name="CompanyReferenceID" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Company which
holds the
asset</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>If the currency is specified,
it must match the
default currency for the company.</
xsd:documentation>
<ValidationMessage>If the currency is specified,
it must match the
default currency for the company.</
ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>Journal must be an Adjustment
Journal to be submitted
in an Adjustment Period.</xsd:documentation>
<ValidationMessage>Use an adjustment journal when
submitting in an
adjustment period for the company [company].</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="CompanyReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Currency" type="xsd:string" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to the currency of the
company. If entered, this
field is not processed on inbound Workday Journal
Connector
requests.</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>If the currency is specified,
it must match the
default currency for the company.</
xsd:documentation>
<ValidationMessage>If the currency is specified,
it must match the
default currency for the company.</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="LedgerType" type="xsd:string" minOccurs="1"
maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 658

<xsd:documentation>Reference ID to an existing Ledger


Type</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="BookCode" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to the Book Code the Journal
is booked
to</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AccountingDate" type="xsd:date" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Accounting Date</xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>You can't change the accounting
date outside of
the current period if the journal or
intercompany child journals
have a journal sequence number. Change the
accounting date to a date
within [period].</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalSource" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Journal
Source</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Journal Source must be an
Accounting Journal
Source.</xsd:documentation>
<ValidationMessage>Journal Source must be an
Accounting Journal
Source.</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>You can’t change the Journal
Source when a
journal or intercompany child journal has a
journal sequence
number.</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:choice>
<xsd:element name="BalancingWorktagReferenceID" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Anchor balancing worktag for
journal.</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>You must have worktag
balancing enabled in order to

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 659

define a Balancing Worktag Reference.</


xsd:documentation>
<ValidationMessage>Balancing worktag reference
cannot be entered if
worktag balancing is not enabled.</
ValidationMessage>
</Validation>
<Validation>
<xsd:documentation>The Balancing Worktag
Reference must be of the same
type as defined for Balancing Worktags at
the tenant
level.</xsd:documentation>
<ValidationMessage>Balancing worktag reference
must be of the type:
"[type]"</ValidationMessage>
</Validation>
<Validation>
<ValidationMessage>Balancing worktag reference
cannot be entered
when Round Ledger Amounts is specified.</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="BalancingWorktagReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BalancingWorktagExternalCode" minOccurs="0"
maxOccurs="1">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="name" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:choice>
<xsd:element name="OptionalBalancingWorktagsReferenceID"
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Optional Anchor Balancing Worktags for
the
Journal.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="AuditedAccountingWorktagReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 660

"type".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="OptionalBalancingWorktagsExternalCode"
minOccurs="0" maxOccurs="unbounded">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="name" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="RecordQuantity" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Record Quantity - set to True (1) if
setting Quantity and
Unit of Measure on a journal line.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalEntryMemo" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This transaction header memo will print
on the delivered
transaction. It is optional freeform text</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalExternalReferenceID" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Journal reference Id from external
systems to maintain references and reconcilation</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DocumentLink" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Link to supporting documents</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AdjustmentJournal" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Boolean flag indicating if the journal
entry is an
adjustment.</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Journal must be an Adjustment
Journal to be submitted
in an Adjustment Period.</xsd:documentation>
<ValidationMessage>Journal must be an Adjustment
Journal to be
submitted in an Adjustment Period.</
ValidationMessage>
</Validation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 661

</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="IncludeTaxLines" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Boolean to enable Journal Line Tax
Detail
Data.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CreateReversal" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Boolean attribute indicating if the
journal entry should
create a reversal</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ReversalDate" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Date for which the reversal journal is
to be
posted.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ControlTotalAmount" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Control Total Amount</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26" />
<xsd:fractionDigits value="6" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="CurrencyRateType" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference ID to an existing instance of
Currency Rate
Type</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AlternateLedgerCurrencyRateType"
type="xsd:string" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Contains reference to the currency rate
type applied to an
alternate ledger when you create a journal entry.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DisplayAccountSetID" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The Display Account Set (DAS) optional
EC allows the caller
to specify the Account Set of which Account Set the
Ledger Account is a

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 662

member.This content is provided as a courtesy and


clarification; if not
provided, the DAS will be derived from the Ledger
Account.</xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>Display Account Set must be the
Primary or
Alternate Account Set for [company].</
ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalEntryLineReplacementData"
type="JournalEntryLineDataType" minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Journal Entry Line Data</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AttachmentData"
type="FinancialsAttachmentDataType" minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Attachment Data</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="IntercompanySubProcessBPParameters"
type="AccountingJournalIntercompanySubProcessType" minOccurs="0"
maxOccurs="1" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="LedgerAccountObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="LedgerAccountReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an
instance of a parent
object</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>The unique identifier type of a
parent
object</xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 663

<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<xsd:enumeration value="WID" />
<xsd:enumeration value="Account_Set_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:schema>

Ad Hoc Bank Transaction Connector

Steps: Set Up Ad Hoc Bank Transaction Connector

Prerequisites
• Access to an SFTP server that contains the ad hoc bank transaction files.
• The ad hoc bank transaction files must be in the Workday-defined XML or Comma-Separated Value
(CSV) format.
• Create ledger accounts and worktags for all Workday accounts.

Context
You can create an integration to load ad hoc bank transactions from an external endpoint into Workday.

Steps
1. Access the Create Source System task and create 1 source for each external endpoint.
Security: Set Up: Map Worktags domain in Worktags functional area.
2. Access the Create Integration Worktag Mapping task and map each external code to a
corresponding ledger account and worktag in Workday.
Security: Set Up: Map Worktags domain in Worktags functional area.
3. Access the Create Integration System task and enter Core Connector: Ad Hoc Bank Transactions
Inbound (Enhanced Performance) at the New Using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
4. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
5. Select Integration System > Configure Integration Maps as a related action on the integration
system and map external values to internal Workday values.
Security: Integration Build and Integration Configure domains in the Integration functional area.
6. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves ad hoc bank transaction files from your external endpoint.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 664

7. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Process: Ad hoc Bank Transaction - Core
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
8. Launch an Integration on page 23.
Schedule how often the integration system runs.
9. Create Integration Notifications on page 30.
Configure your integration to send notification messages to specified groups for integration events.

Concept: Ad Hoc Bank Transaction Connector


The Core Connector: Ad Hoc Bank Transactions Inbound (Enhanced Performance) integration template
enables you to import ad hoc bank transactions into Workday from an external endpoint. The integration
template supports import of ad hoc bank transactions in Workday-defined XML and Comma-Separated
Value (CSV) formats.

Ad Hoc Bank Transaction Connector Integration and Supporting Tasks


The Connector consists of these components and supporting tasks:

Component Description
Create Source System This task enables you to define external source
endpoints.
Create Integration Worktag Mapping Define mapping between:
• External codes for source accounts.
• Corresponding ledger accounts or worktags in
Workday.

Core Connector: Ad Hoc Bank Transactions This integration template enables you to create an
Inbound (Enhanced Performance) integration system that:
• Retrieves an XML or CSV file from an external
SFTP endpoint that contains ad hoc bank
transaction data.
• Translates data by applying the mapping rules
that you define with the Create Integration
Worktag Mapping task. Applies mapping rules
that you define directly in the integration as part
of integration maps.
• Loads the data into Workday.
• Supports reporting and error handling at the ad
hoc bank transaction and line levels for ad hoc
bank transactions.

Launch/Schedule Options
Workday provides these launch schedule options for the integration:
• Launch by an Integration step on a business process.
• Launch on schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration retrieves any files from the endpoint.
• Launch immediately. You can launch the integration manually.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 665

Processing Notes
If the LedgerAccountingReferenceID element exists in the Connector input file, Workday ignores the
external code values that map to ledger accounts. You can override integration attribute values by
populating them in the input file.

Reference: Ad Hoc Bank Transaction Connector XML Schema


<?xml version='1.0' encoding='UTF-8'?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified" attributeFormDefault="qualified"
xmlns="urn:com.workday/AdHocBankTransactionConnector"
targetNamespace="urn:com.workday/AdHocBankTransactionConnector">
<xsd:element name="AdhocBankTransactionRequest"
type="AdhocBankTransactionRequestType"/>
<xsd:complexType name="AdhocBankTransactionRequestType">
<xsd:annotation>
<xsd:documentation>Contains data for creating or updating an ad hoc
bank transaction and
submitting for business processing
</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>The Ad hoc Bank Transaction cannot be
edited.
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>The Web Service is set to Add Only; documents
cannot be
resubmitted.
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AdhocBankTransactionData"
type="AdhocBankTransactionDataType"
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Ad hoc Bank Transaction Data</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="AdhocBankTransactionDataType">
<xsd:annotation>
<xsd:documentation>Element containing all Ad hoc Bank Transaction
data</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AdhocBankTransactionReferenceID"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Ad hoc Bank Transaction
for update
only purposes.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 666

<xsd:attribute name="type"
type="AdHocBankTransactionReferenceEnumeration" use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BusinessProcessParameters"
type="FinancialsBusinessProcessParametersType" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Business Process Parameters provide the ability
to
auto-submit to the business process.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AdhocBankTransactionID" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Ad hoc Bank Transaction ID. This is the unique
identfier for
the Ad hoc Bank Transaction. If no ID is specified, the system will
generate
one automatically.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Submit" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Submit for Approval is a boolean flag indicating
if the
transaction is to be submitted or saved in draft mode. If this flag is
set,
the transaction will be submitted, otherwise the transaction is
saved in
draft.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="LockedinWorkday" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Locked in Workday is a boolean flag controlling
user ability
to edit the transaction. If the flag is set the user can't edit,
cancel or
change the transaction inside the Workday application, however the
user
can
submit a draft transaction. The transaction can only be updated from
the
web
service.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TransactionDate" type="xsd:date"
minOccurs="1" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Ad hoc Bank Transaction Date</xsd:documentation>
</xsd:annotation>
</xsd:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 667

<xsd:element name="TransactionMemo" type="xsd:string"


minOccurs="1" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form text field foran Ad hoc Bank
Transaction
memo
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CompanyReferenceID" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Company which holds the
asset
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" type="CompanyReferenceEnumeration"
use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Currency" type="xsd:string" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to the currency of the company. If
entered, this
field is not processed on inbound Workday Web Services
requests.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Transaction Currency not accepted by selected
Bank
Account.
</xsd:documentation>
<Validation_Message>Transaction Currency not accepted by selected
Bank Account.
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="BankAccountReferenceID" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Bank Account
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Bank Account is not valid for
Company.
</xsd:documentation>
<Validation_Message>Bank Account is not valid for
Company.
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 668

<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="FinancialAccountReferenceEnumeration" use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="CurrencyRateType" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference ID to an existing instance of Currency
Rate
Type
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CurrencyRateOverride" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Transaction to Bank Account Currency Conversion
Rate
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Currency Conversion Rate not valid on
non-foreign
currency transaction.
</xsd:documentation>
<Validation_Message>Currency Conversion Rate not valid on
non-foreign
currency transaction.
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="24" />
<xsd:fractionDigits value="12" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TransactionAmount" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Transaction Amount</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18" />
<xsd:minInclusive value="0" />
<xsd:fractionDigits value="3" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:choice>
<xsd:element name="DepositOrWithdrawal"
type="DepositOrWithdrawalEnumeration"
minOccurs="1" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Field that indicates if the Ad hoc Bank
Transaction is
deposit or withdrawal
</xsd:documentation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 669

</xsd:annotation>
</xsd:element>
</xsd:choice>
<xsd:element name="AdhocBankTransactionPurposeReferenceID"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Ad hoc Bank Transaction
Purpose
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="AdHocBankTransactionPurposeReferenceEnumeration"
use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TransactionID" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free-form Text for any reference notes
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ExternalReference" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>External Reference for the Ad Hoc Bank
Transaction</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="JournalSource" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Enter Journal Source to record Ad Hoc Bank
Transaction.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RemoveBankAccountWorktagonOffset"
type="xsd:boolean" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When this attribute is yes, it excludes the Bank
Account
worktag on Offset journal entries
</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Please enter a Valid Value for Remove Bank
Account Worktag on Offset field.
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="EliminateFXGainLoss" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When this attribute is yes, the foreign exchange
gain/loss is
eliminated from the transaction

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 670

</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Please enter a Valid Value for Eliminate FX
Gain/Loss field
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="TransactionLineReplacementData"
type="TransactionLineReplacementDataType"
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Ad hoc Bank Transaction Transaction Lines
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxCodeData" type="TaxableCodeApplicationDataType"
minOccurs="0" maxOccurs="unbounded"/>
<xsd:element name="AttachmentData" type="FinancialsAttachmentDataType"
minOccurs="0" maxOccurs="unbounded" />
<xsd:element name="AdhocBankTransactionIntercompanySubProcess"
type="AdhocBankTransactionIntercompanySubProcessType" minOccurs="0"
maxOccurs="1" />
</xsd:sequence>
<xsd:attribute name="AddOnly" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>Add Only Flag. Indicates that the service is an
add only, not an
update.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>

<xsd:complexType name="FinancialsBusinessProcessParametersType">
<xsd:annotation>
<xsd:documentation>Contains data for business processing
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AutoComplete" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the business process
is
automatically processed. This means that all approvals will be
automatically
approved in the system, all reviews and to-do's will be
automatically
by-passed, and all notifications will be automatically
suppressed.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:appinfo>
<Validation>
<Validation_Message>This Business Process has been configured to
disable comment. Please remove the comment or change the setting
in

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 671

the Business Process Policy or tenant setup.


</Validation_Message>
</Validation>
</xsd:appinfo>
<xsd:documentation>Free form comment regarding the business
process.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WorkerReferenceID" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Default the Person making the comment to the
processing
person if not submitted via the web service.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" type="WorkerReferenceEnumeration"
use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="TransactionLineReplacementDataType">
<xsd:annotation>
<xsd:documentation>Contains data for an Ad hoc Bank Transaction Line
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>The Amount for an Ad hoc Bank Transaction Line
cannot be
zero.
</xsd:documentation>
<Validation_Message>The Amount for an Ad hoc Bank Transaction Line
cannot be
zero.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Please specify either a Ledger Account or an
accounting
category (Spend Category or Revenue Category). You cannot specify
both.
</xsd:documentation>
<Validation_Message>Please specify either a Ledger Account or an
accounting
category (Spend Category or Revenue Category). You cannot specify
both.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Only one worktag for each type is allowed for
each document
line.
</xsd:documentation>
<Validation_Message>Only one worktag for each type is allowed for
each

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 672

document line.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Cannot have an Employee Worktag along with a
Contingent
Worker Worktag for the same line.
</xsd:documentation>
<Validation_Message>Cannot have an Employee Worktag along with a
Contingent
Worker Worktag for the same line.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Can not have any combination of Project, Project
Phase or
Project Task worktags for the same line.
</xsd:documentation>
<Validation_Message>Can not have any combination of Project,
Project Phase or
Project Task worktags for the same line.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>The worktag selected is a Position for a
Supervisory
Organization whose staffing model is Position Management. Please
select a
Position Restriction or a Position for a Headcount or Job
Management
staffing model.
</xsd:documentation>
<Validation_Message>The worktag selected is a Position for a
Supervisory
Organization whose staffing model is Position Management. Please
select a
Position Restriction or a Position for a Headcount or Job
Management
staffing model.
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Grant Worktag selected: [grant] does not match
Company:
[company] on an Award Line in effect
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>The following worktag type(s) are required:
[missing]
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>The following worktag(s) are invalid:
[invalid]
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="LineOrder" type="xsd:string"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Optional line order. If specified, lines will be

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 673

sorted by
this value when displayed and when invoice is printed.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="IntercompanyAffiliateReferenceID"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the Company.If
this is
blank, Workday will default the company from the invoice header. If a
value
is provided that is different from the invoice header, workday
validates
that there is an appropriate intercompany relationship
configured.
</xsd:documentation>
<xsd:appinfo>
<Common_Reference_ID_Type>Company_Reference_ID
</Common_Reference_ID_Type>
<Validation>
<xsd:documentation>The company is not configured for intercompany
transactions with the company specified
</xsd:documentation>
<Validation_Message>[2] is not configured to allow intercompany
transactions with [1]
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" type="CompanyReferenceEnumeration"
use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ResourceCategoryReferenceID"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the spend
category. A spend
category is a classification of items and services that drive the
accounting. All expense items are associated with a Spend Category
and sales
items are associated with a Revenue Category.If a value is provided
for
sales item, revenue category will default so it is recommended to
provide a
value for either sales item or revenue category but not both. It is
required
if sales item is blank.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="SpendCategoryReferenceEnumeration" use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 674

</xsd:element>
<xsd:element name="RevenueCategoryReferenceID" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Spend Category. A Spend
Category is
a classification of items and services that drive the accounting.
All sales
items are associated with a Revenue Category and expense items are
associated with a Spend Category.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="RevenueCategoryReferenceEnumeration" use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="LedgerAccountReferenceID"
type="LedgerAccountObjectIDType"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Ledger Account. The
Ledger Account
reference is a 2 part reference ID, composed of the Ledger Account ID
and
the Reference ID for the Ledger Account Set it is organized
into.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>Ledger Account is not valid for the Company
Account
Set
</xsd:documentation>
<Validation_Message>Ledger Account: [ledger account] is not valid
for
company [company]'s account set.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>At least one of the Ledger Accounts entered is
retired. Only non retired accounts are allowed.
</xsd:documentation>
<Validation_Message>At least one of the Ledger Accounts entered
is
retired. Only non retired accounts are
allowed.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>The Ledger Account has a restriction that does
not
allow it to be used by the Company specified.
</xsd:documentation>
<Validation_Message>The [type] is/are not available for use with
the
company/s: [partitionable] [company]
</Validation_Message>
</Validation>
</xsd:appinfo>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 675

</xsd:annotation>
</xsd:element>
<xsd:element name="AlternateLedgerAccountReferenceID"
type="LedgerAccountObjectIDType" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Alternate Ledger Account (ALA) provides the
ability, when
Alternate Account Set is enabled for the header company, to override
the
account to which the Ledger Account is mapped by the Alternate
Account Set
Mapping rules.I.E. - if the Ledger Account is 1000 Cash, and the
mapping
rules map the journal to the 1100 Alternate Cash account, setting
the ALA to
1200: Other Cash Account will cause the journal to use Other Cash
rather
than Alternate Cash.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>You are attempting to set an alternate ledger
account
for a company which does not have an alternate account
set.
</xsd:documentation>
<Validation_Message>You are attempting to set an alternate ledger
account for a company which does not have an alternate account
set.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Ledger Account is not valid for the Company
Account
Set
</xsd:documentation>
<Validation_Message>Ledger Account: [ledger account] is not valid
for
company [company]'s account set.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>At least one of the Ledger Accounts entered is
retired. Only non retired accounts are allowed.
</xsd:documentation>
<Validation_Message>At least one of the Ledger Accounts entered
is
retired. Only non retired accounts are
allowed.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>The Ledger Account has a restriction that does
not
allow it to be used by the Company specified.
</xsd:documentation>
<Validation_Message>The [type] is/are not available for use with
the
company/s: [partitionable] [company]
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 676

<xsd:element name="LineAmount" minOccurs="1" maxOccurs="1">


<xsd:annotation>
<xsd:documentation>Line Amount</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26" />
<xsd:fractionDigits value="6" />
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TaxApplicabilityReferenceID"
type="TaxApplicabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the tax
applicability. If
the transaction line has a tax code then tax
applicability is
required.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxCodeReferenceID" type="TaxCodeObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the tax code.
If the
transaction line has a tax applicability value, Workday will
validate that
the transaction line also has a tax code.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRateOptionsData" type="TaxRateOptionsDataType"
minOccurs="0" /> f

<xsd:element name="LineMemo" type="xsd:string" minOccurs="0"


maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Memo for the line</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WorktagsReferenceID" minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Reference to existing worktags. Worktags are a
way to mark
tasks and business objects to make them easier to access and
summarize.
Each
transaction can include one value for each worktag type and is subject
to
configurable validation when submitted for approval.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>The Worktags provided are not valid for this
transaction
</xsd:documentation>
<Validation_Message>[list of worktag types] not valid for this
transaction.
</Validation_Message>
</Validation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 677

<Validation>
<xsd:documentation>A Revenue Category cannot be selected as a
Worktag if
one is already selected in the line.
</xsd:documentation>
<Validation_Message>A Revenue Category cannot be selected as a
Worktag if one is already selected in the
line.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>A Spend Category cannot be selected as a
Worktag if
one is already selected in the line.
</xsd:documentation>
<Validation_Message>A Spend Category cannot be selected as a
Worktag
if one is already selected in the line.
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>You have chosen an invalid combination of
header
company, line company, and intercompany
affiliate.
</xsd:documentation>
<Validation_Message>The intercompany affiliate [worktag] may not
be
chosen when specifying header company [header company] and line
company [line company].
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>When Worktag Balancing is enabled at the
tenant
level, this transaction must have a balancing worktag
specified.
</xsd:documentation>
<Validation_Message>Select a balancing worktag for Worktags of
the
following type: [type]
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>[missing worktags message web
services]
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>[missing worktags message web
services]
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>[worktag value] is not permitted as an
allowed
value for worktag type: [worktag type], because it is
inactive.
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>The [type] is/are not available for use with
the
company/s: [partitionable] [company]

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 678

</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="AccountingWorktagReferenceEnumeration" use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BalancingWorktagAffiliateReferenceID"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Used to define a Balancing Worktag Affiliate
when Balancing
Worktags is enabled.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<xsd:documentation>The Balancing Worktag Affiliate Type must be
of the
same type as defined for Balancing Worktags at the tenant
level.
</xsd:documentation>
<Validation_Message>Enter a Balancing Worktag Affiliate that is
the
type [tenant type].
</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>You must have Worktag Balancing enabled in
order to
define a Worktag Balancing Affiliate.
</xsd:documentation>
<Validation_Message>You must have Worktag Balancing enabled in
order
to define a Worktag Balancing Affiliate.
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>The Balancing Worktag in the Worktags field
is
not allowed to be the same as the Balancing Worktag
Affiliate.
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>When an Intercompany Affiliate is present in
the
Worktags field you are not allowed to have a Balancing Worktag
Affiliate.
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>The [type] is/are not available for use with
the
company/s: [partitionable] [company]
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 679

<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="BalancingWorktagReferenceEnumeration" use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ExternalCode" minOccurs="0" maxOccurs="unbounded">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="name" type="xsd:string" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="LedgerAccountObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of an
object.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="LedgerAccountReferenceEnumeration" use="required">
<xsd:annotation>
<xsd:documentation>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".
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parent_id" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
a parent
object
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parent_type">
<xsd:annotation>
<xsd:documentation>The unique identifier type of a parent
object
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Account_Set_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 680

</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>

<xsd:complexType name="FinancialsAttachmentDataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing all Business
Document Attachment
data.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>If a file name is specified for a Financial
Attachment,
File Content and Content Type are required.
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="FileContent" type="xsd:base64Binary"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>File content in binary format.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Comment</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="contentType">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Content Type of the
Attachment.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="80" />
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
<xsd:attribute name="fileName">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Filename of the
Attachment.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="255" />
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
<xsd:attribute name="encoding" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Encoding of the
Attachment.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 681

</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="compressed" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>Boolean attribute identifying whether the
Attachment is
compressed.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>

<xsd:complexType name="AdhocBankTransactionIntercompanySubProcessType">
<xsd:annotation>
<xsd:documentation>Wrapper for the Ad Hoc Bank Transaction
Intercompany Sub Process. It
allows you to specify parameters for the sub process.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:choice>
<xsd:element name="AutoComplete" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the business process
is
automatically processed. This means that all approvals will be
automatically approved in the system, all reviews and to-do's will be
automatically by-passed, and all notifications will be
automatically
suppressed.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Skip" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the business process
is
automatically skipped (if it is defined as "skippable" within the
business process definition).
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:choice>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form comment regarding the business
process.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<ValidationMessage>This Business Process has been configured to
disable comment. Please remove the comment or change the setting
in
the Business Process Policy or tenant setup.
</ValidationMessage>
</Validation>
</xsd:appinfo>
</xsd:annotation>
</xsd:element>
<xsd:element name="WorkerReferenceID" minOccurs="0"

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 682

maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Default the Person making the comment to the
processing
person if not submitted via journal connector
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" type="WorkerReferenceEnumeration" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:simpleType name="AdHocBankTransactionReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Ad_hoc_Bank_Transaction_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="WorkerReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Contingent_Worker_ID" />
<enumeration value="Employee_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="CompanyReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Company_Reference_ID" />
<enumeration value="Organization_Reference_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="FinancialAccountReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Bank_Account_ID" />
<enumeration value="Petty_Cash_Account_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 683

<xsd:simpleType name="AdHocBankTransactionPurposeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Ad_hoc_Bank_Transaction_Purpose_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="SpendCategoryReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Spend_Category_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="RevenueCategoryReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Revenue_Category_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="LedgerAccountReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Ledger_Account_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="AccountingWorktagReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Academic_Period_ID" />
<enumeration value="Academic_Person_ID" />
<enumeration value="Academic_Unit_ID" />
<enumeration value="Ad_hoc_Payee_ID" />
<enumeration value="Applicant_ID" />
<enumeration value="Asset_Impairment_Reason_ID" />
<enumeration value="Bank_Account_ID" />
<enumeration value="Business_Unit_ID" />
<enumeration value="Catalog_Item_ID" />
<enumeration value="Company_Reference_ID" />
<enumeration value="Contingent_Worker_ID" />
<enumeration value="Contingent_Worker_Type_ID" />
<enumeration value="Corporate_Credit_Card_Account_ID" />
<enumeration value="Cost_Center_Reference_ID" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 684

<enumeration value="Custom_Organization_Reference_ID" />


<enumeration value="Custom_Worktag_06_ID" />
<enumeration value="Custom_Worktag_07_ID" />
<enumeration value="Custom_Worktag_08_ID" />
<enumeration value="Custom_Worktag_09_ID" />
<enumeration value="Custom_Worktag_1_ID" />
<enumeration value="Custom_Worktag_10_ID" />
<enumeration value="Custom_Worktag_11_ID" />
<enumeration value="Custom_Worktag_12_ID" />
<enumeration value="Custom_Worktag_13_ID" />
<enumeration value="Custom_Worktag_14_ID" />
<enumeration value="Custom_Worktag_15_ID" />
<enumeration value="Custom_Worktag_2_ID" />
<enumeration value="Custom_Worktag_3_ID" />
<enumeration value="Custom_Worktag_4_ID" />
<enumeration value="Custom_Worktag_5_ID" />
<enumeration value="Customer_Category_ID" />
<enumeration value="Customer_Contract_Reference_ID" />
<enumeration value="Customer_ID" />
<enumeration value="Customer_Reference_ID" />
<enumeration value="Deduction_Code" />
<enumeration value="Deduction_Recipient_ID" />
<enumeration value="Donor_ID" />
<enumeration value="Earning_Code" />
<enumeration value="Employee_ID" />
<enumeration value="Employee_Type_ID" />
<enumeration value="Expense_Item_ID" />
<enumeration value="External_Committee_Member_ID" />
<enumeration value="Financial_Institution_ID" />
<enumeration value="Financial_Institution_Reference_ID" />
<enumeration value="Fund_ID" />
<enumeration value="Funding_Source_Name" />
<enumeration value="Gift_Reference_ID" />
<enumeration value="Grant_ID" />
<enumeration value="Internal_Service_Provider_Reference_ID" />
<enumeration value="Investment_Pool_ID" />
<enumeration value="Investment_Profile_ID" />
<enumeration value="Investor_ID" />
<enumeration value="Is_Manager_ID" />
<enumeration value="Is_People_Manager" />
<enumeration value="ISO_3166-1_Alpha-2_Code" />
<enumeration value="ISO_3166-1_Alpha-3_Code" />
<enumeration value="ISO_3166-1_Numeric-3_Code" />
<enumeration value="Job_Category_ID" />
<enumeration value="Job_Level_ID" />
<enumeration value="Job_Profile_ID" />
<enumeration value="Loan_ID" />
<enumeration value="Location_ID" />
<enumeration value="Management_Level_ID" />
<enumeration value="NI_Category_Letter" />
<enumeration value="Object_Class_ID" />
<enumeration value="Opportunity_Reference_ID" />
<enumeration value="Organization_Reference_ID" />
<enumeration value="Pay_Rate_Type_ID" />
<enumeration value="Payroll_Federal_Authority_Tax_Code" />
<enumeration value="Payroll_Local_City_Authority_Tax_Code" />
<enumeration value="Payroll_Local_County_Authority_Tax_Code" />
<enumeration value="Payroll_Local_Other_Authority_Tax_Code" />
<enumeration value="Payroll_Local_School_District_Authority_Tax_Code" /
>
<enumeration value="Payroll_State_Authority_Tax_Code" />
<enumeration value="Petty_Cash_Account_ID" />
<enumeration value="Position_ID" />
<enumeration value="Program_ID" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 685

<enumeration value="Program_of_Study_ID" />


<enumeration value="Project_ID" />
<enumeration value="Project_Plan_ID" />
<enumeration value="Proposal_Grant_ID" />
<enumeration value="Prospect_ID" />
<enumeration value="Prospect_Reference_ID" />
<enumeration value="Purchase_Item_ID" />
<enumeration value="Receivable_Writeoff_Reason_ID" />
<enumeration value="Region_Reference_ID" />
<enumeration value="Revenue_Category_ID" />
<enumeration value="Rubric_Value_ID" />
<enumeration value="Run_Category_ID" />
<enumeration value="Sales_Item_ID" />
<enumeration value="Spend_Category_ID" />
<enumeration value="Sponsor_ID" />
<enumeration value="Sponsor_Reference_ID" />
<enumeration value="Student_Assignment_Line_Item_ID" />
<enumeration value="Student_Charge_Item_ID" />
<enumeration value="Student_ID" />
<enumeration value="Student_Recruiting_Campaign_ID" />
<enumeration value="Student_Recruiting_Event_ID" />
<enumeration value="Supplier_Category_ID" />
<enumeration value="Supplier_ID" />
<enumeration value="Supplier_Reference_ID" />
<enumeration value="Tax_Applicability_ID" />
<enumeration value="Tax_Authority_ID" />
<enumeration value="Tax_Authority_Reference_ID" />
<enumeration value="Tax_Category_ID" />
<enumeration value="Tax_Code_ID" />
<enumeration value="Tax_Rate_ID" />
<enumeration value="Third_Party_ID" />
<enumeration value="Withholding_Order_Case_ID" />
<enumeration value="Work_Function_ID" />
<enumeration value="Work_Shift_ID" />
<enumeration value="Workday_Deduction_Code" />
<enumeration value="Workday_Earning_Code" />
<enumeration value="Worker_Type_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="BalancingWorktagReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Business_Unit_ID" />
<enumeration value="Cost_Center_Reference_ID" />
<enumeration value="Custom_Organization_Reference_ID" />
<enumeration value="Fund_ID" />
<enumeration value="Organization_Reference_ID" />
<enumeration value="Region_Reference_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="DepositOrWithdrawalEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="Deposit" />
<enumeration value="Withdrawal" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 686

</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="TaxApplicabilityObjectIDType">
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxApplicabilityReferenceEnumeration" use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:simpleType name="TaxApplicabilityReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Tax_Applicability_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="TaxCodeObjectIDType">
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" type="TaxCodeReferenceEnumeration"
use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:simpleType name="TaxCodeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Tax_Code_ID" />
<enumeration value="Withholding_Tax_Code_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="TaxRateOptionsDataType">
<xsd:annotation>
<xsd:documentation>Element containing Tax Rate Recoverabilities data
for Tax
Code.
</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Provide Tax Rates that match the Tax
Code
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Cannot select Recoverable Recoverabilities when
using a
Non-Taxable Applicability, [applicability]. [SUBJECT TO
CHANGE]
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Tax recoverability doesn't apply on a
transaction tax
rule for items when Revenue is the Tax Item Rule

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 687

Type.
</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Must select a Tax Recoverability for each Tax
Rate in the
selected Tax Code
</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxRate1ReferenceID" type="TaxRateObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRecoverability1ReferenceID"
type="TaxRecoverabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax Rate.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRate2ReferenceID" type="TaxRateObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRecoverability2ReferenceID"
type="TaxRecoverabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax Rate.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRate3ReferenceID" type="TaxRateObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRecoverability3ReferenceID"
type="TaxRecoverabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax Rate.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRate4ReferenceID" type="TaxRateObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.
</xsd:documentation>
</xsd:annotation>
</xsd:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 688

<xsd:element name="TaxRecoverability4ReferenceID"
type="TaxRecoverabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax Rate.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRate5ReferenceID" type="TaxRateObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRecoverability5ReferenceID"
type="TaxRecoverabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax Rate.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRate6ReferenceID" type="TaxRateObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxRecoverability6ReferenceID"
type="TaxRecoverabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax Rate.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="TaxRateObjectIDType">
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" type="TaxRateReferenceEnumeration"
use="required" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:simpleType name="TaxRateReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Tax_Rate_ID" />
<enumeration value="Withholding_Tax_Rate_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="TaxRecoverabilityObjectIDType">
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="TaxRecoverabilityReferenceEnumeration" use="required" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 689

</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:simpleType name="TaxRecoverabilityReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID" />
<enumeration value="Tax_Recoverability_Object_ID" />
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

<xsd:complexType name="TaxableCodeApplicationDataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax Details
data</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Tax Applicablilty from Tax Code Data is
not included on
any data input line.</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Tax Code from Tax Code Data is not
included on any data
input line.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxApplicabilityReferenceID"
type="TaxApplicabilityObjectIDType">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the
tax applicability.If
this is blank and there invoice line has a sales item,
Workday will default
tax applicability from the sales item. If the invoice
line has a tax code
then tax applicability is required.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxCodeReferenceID" type="TaxCodeObjectIDType">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the
tax code.If this is
blank, Workday will default in the default tax code
from the invoice header
if there is one. If the invoice line has a tax
applicability value, Workday
will validate that the invoice line also has a tax
code.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxAmount" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Total Tax Amount for Tax Code and Tax
Applicability</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 690

<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TaxRateData" type="TaxRateApplicationDataType"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax
Rate
data.</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="TaxRateApplicationDataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax Rate
data.</xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Provide a default tax recoverability
for the tax
applicability</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Cannot select a Tax Recoverability for
Customer
Invoices.</Validation_Message>
</Validation>
<Validation>
<Validation_Message>Cannot select Recoverable
Recoverabilities when using a
Non-Taxable Applicability, [applicability]. [SUBJECT TO
CHANGE]</Validation_Message>
</Validation>
<Validation>
<Validation_Message>You can’t enter Tax Recoverability for
a Withholding Tax
Code.</Validation_Message>
</Validation>
</xsd:appinfo>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxRateReferenceID" type="TaxRateObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to an existing Tax Rate</
xsd:documentation>
<xsd:appinfo>
<Validation>
<Validation_Message>Tax Rate: [taxrate] is not
valid for Tax Code:
[taxcode]</Validation_Message>
</Validation>
<Validation>
<xsd:documentation>Tax Rate Reference is required
if Tax Code is
provided.</xsd:documentation>
<Validation_Message>Tax Rate Reference is required
if Tax Code is
provided.</Validation_Message>
</Validation>
</xsd:appinfo>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 691

</xsd:annotation>
</xsd:element>
<xsd:element name="TaxAmount" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Total Tax Amount for Tax Rate</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TaxRecoverabilityReferenceID"
type="TaxRecoverabilityObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to an existing Tax
Recoverability</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

Reference: Ad Hoc Bank Transaction Connector CSV File Format


The CSV import file format has 2 record types:
• Transaction Header. The first record in the CSV file is a fixed header record. The header record
describes the fields that the transaction type populates. There can be multiple transaction headers in
a single file. Each transaction header describes a different transaction. If a transaction has multiple
transaction lines, then the header-level information only needs to be on the first transaction record. You
don't need to repeat header-level information for subsequent transaction lines.
• Transaction Line. This record type consists of transaction line details. If a transaction has multiple
transaction lines, the records for the transaction lines should display consecutively in the file. Example:
You can't include lines of transaction A, followed by lines of transaction B, followed by additional lines of
transaction A.
Boolean values are 1 (true) and 0 (false). Date value format is YYYY-MM-DD.

Transaction Header Fields

Field Name Type Required? Description/Notes


AdHocBankTransactionKey Text Yes The integration loads all
transaction lines with the same
AdHocBankTransactionKey into
Workday as a single ad hoc
bank transaction. Transaction
lines that belong to the same
transaction should display
consecutively within the file.
AdHocBankTransactionID Text No This field uniquely identifies the
transaction. If this field is empty,
Workday generates a unique ID.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 692

Field Name Type Required? Description/Notes


AdHocBankTransactionReferenceIDType
Text Varies Required if
AdHocBankTransactionReferenceID
is present. Valid values:
• Workday ID
• Ad_hoc_Bank_Transaction_ID

AdHocBankTransactionReferenceID Text No Reference to an existing ad hoc


bank transaction for update-only
purposes.
Submit Boolean No Indicates if you're submitting the
transaction or saving it in draft
mode. If you set this flag to True,
you're indicating that you're
submitting the transaction.
LockedinWorkday Boolean No Controls if you can edit the
transaction in Workday. If
you set the flag to True, you
can't edit, cancel, or change
the transaction in Workday.
However, you can submit a draft
transaction. You can update the
transaction only from the web
service.
AddOnly Boolean No Indicates that the processing
is in add-only mode and not an
update.
TransactionDate Date Yes Ad hoc bank transaction date.
TransactionMemo Text Yes Free form text field for ad hoc
bank transaction memo.
CompanyReferenceIDType Text Yes Valid values:
• Workday_ID
• Company_Reference_ID
• Organization_Reference_ID

CompanyReferenceID Text Yes Reference to an existing


Company that holds the asset.
Currency Text Yes Reference to the currency of
the company. If you specify
the currency, it must match
the default currency for the
company.
BankAccountReferenceIDType Text Yes Valid values:
• Workday_ID
• Bank_Account_ID
• Petty_Cash_Account_ID

BankAccountReferenceID Text Yes Reference to an existing Bank


Account.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 693

Field Name Type Required? Description/Notes


CurrencyRateType Text No Reference ID to an existing
instance of Currency Rate Type.
CurrencyRateOverride Decimal(18, 6) No Transaction to Bank Account
Currency Conversion Rate.
TransactionAmount Decimal(18, 3) Yes Transaction amount.
DepositOrWithdrawal Text Yes Deposit or Withdrawal.
AdhocBankTransactionPurposeReferenceIDType
Text Varies Required if
AdhocBankTransactionPurposeReferenceID
is present. Valid values:
• WID
• Ad_hoc_Bank_Transaction_Purpose_ID

AdhocBankTransactionPurposeReferenceID
Text No Reference to an existing ad hoc
bank transaction purpose.
TransactionID Text No Free-form text for any reference
notes.
ExternalReference Text No Free-form text for external
reference field.
JournalSource Text No Enter the Journal Source
to record the ad hoc bank
transaction.
RemoveBankAccountWorktagonOffsetBoolean No If set to True, the integration
excludes the Bank Account
worktag on Offset journal
entries.
EliminateFXGainLoss Boolean No If set to True, Workday
eliminates the foreign exchange
gains and losses from the
transaction.

Transaction Line Fields

Transaction
Type
Required?
Description/Notes
Line
Fields
LineOrder
Text
No
Optional line order. If specified, the value sorts the lines in Workday and displays when you print the
invoice.
IntercompanyAffiliateReferenceIDType
Text
Varies
Required if IntercompanyAffiliateReferenceID is present. Valid values:
• WID
• Company_Reference_ID
• Organization_Reference_ID

IntercompanyAffiliateReferenceID
Text
No
Reference ID value of the Company. If this value is empty, Workday automatically populates the
company from the invoice header. Workday validates that an appropriate intercompany relationship
exists when you provide a different value from the invoice header.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 694

Transaction
Type
Required?
Description/Notes
Line
Fields
ResourceCategoryReferenceIDType
Text
Varies
Required if ResourceCategoryReferenceID is present. Valid values:
• WID
• Spend_Category_ID

ResourceCategoryReferenceID
Text
No
Reference ID value of the spend category. A spend category is a classification of items and services
that drive the accounting. All expense items are associated with a Spend Category and sales items
are associated with a Revenue Category. If you provide a value for a sales item, the revenue category
automatically populates. Workday recommends that you provide a value for either sales item or revenue
category but not both. Workday requires this field if the sales item is blank.
RevenueCategoryReferenceIDType
Text
Varies
Required if RevenueCategoryReferenceID is present. Valid values:
• WID
• Revenue_Category_ID

RevenueCategoryReferenceID
Text
No
Reference to an existing Spend Category. A Spend Category is a classification of items and services that
drive the accounting. All sales items are associated with a Revenue Category and expense items are
associated with a Spend Category.
LedgerAccountReferenceID_ParentIDType
Text
No
Valid values:
• WID
• Account_Set_ID

LedgerAccountReferenceID_ParentID
Text
No
Contains a unique identifier for an instance of a parent object
LedgerAccountReferenceIDType
Text
Varies
Required if LedgerAccountReferenceID is present. Valid values:
• WID
• Ledger_Account_ID

LedgerAccountReferenceID
Text
No
Reference to an existing Ledger Account. The Ledger Account reference is a 2-part Reference ID,
composed of:
• The Ledger Account ID.
• The Reference ID for the Ledger Account Set that it's a part of.

AlternateLedgerAccountReferenceID_ParentIDType
Text
No
Valid values:
• Workday ID
• Ledger_Account_ID

AlternateLedgerAccountReferenceID_ParentID
Text
No
Contains a unique identifier for an instance of a parent object
AlternateLedgerAccountReferenceIDType
Text
Yes
Required if AlternateLedgerAccountReferenceID is present. Valid values:
• Workday ID
• Ledger_Account_ID

AlternateLedgerAccountReferenceID
Text
No
Alternate Ledger Account (ALA) provides the ability to override the account to which you mapped
the Ledger Account by the Alternate Account Set Mapping rules. Use this field only when you enable
Alternate Account Set for the header company. Example: if the Ledger Account is 1000 Cash, and the
mapping rules map the journal to the 1100 Alternate Cash account, setting the ALA to1200: Other Cash
Account causes the journal to use Other Cash rather than Alternate Cash.
LineAmount
Decimal
Yes
Line Amount
(26,
6)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 695

Transaction
Type
Required?
Description/Notes
Line
Fields
TaxApplicabilityReferenceIDType
Text
Varies
Required if TaxApplicabilityReferenceID is present. Valid values:
• WID
• Tax_Applicability_ID

TaxApplicabilityReferenceID
Text
No
The reference ID value of the tax applicability. If the transaction line has a tax code, then Workday
requires the tax applicability.
TaxCodeReferenceIDType
Text
Varies
Required if TaxCodeReferenceID is present. Valid values:
• WID
• Tax_Code_ID
• Withholding_Tax_Code_ID

TaxCodeReferenceID
Text
No
The reference ID value of the tax code. If the transaction line has a tax applicability value, Workday will
validate that the transaction line also has a tax code.
TaxRate1ReferenceIDType
Text
Varies
Required if TaxRate1ReferenceID is present. Valid values:
• WID
• Tax_Rate_ID
• Withholding_Tax_Rate_ID

TaxRate1ReferenceID
Text
No
Reference to Tax Rate for Tax Code.
TaxRecoverability1ReferenceIDType
Text
Varies
Required if TaxRecoverability1ReferenceID is present. Valid values:
• WID
• Tax_Recoverability_Object_ID

TaxRecoverability1ReferenceID
Text
No
Reference for Tax Recoverability for Tax Rate.
TaxRate2ReferenceIDType
Text
Varies
Required if TaxRate2ReferenceID is present. Valid values:
• WID
• Tax_Rate_ID
• Withholding_Tax_Rate_ID

TaxRate2ReferenceID
Text
No
Reference to Tax Rate for Tax Code.
TaxRecoverability2ReferenceIDType
Text
Varies
Required if TaxRecoverability2ReferenceID is present. Valid values:
• WID
• Tax_Recoverability_Object_ID

TaxRecoverability2ReferenceID
Text
No
Reference for Tax Recoverability for Tax Rate.
TaxRate3ReferenceIDType
Text
Varies
Required if TaxRate3ReferenceID is present. Valid values:
• WID
• Tax_Rate_ID
• Withholding_Tax_Rate_ID

TaxRate3ReferenceID
Text
No
Reference to Tax Rate for Tax Code.
TaxRecoverability3ReferenceIDType
Text
Varies
Required if TaxRecoverability3ReferenceID is present. Valid values:
• WID
• Tax_Recoverability_Object_ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 696

Transaction
Type
Required?
Description/Notes
Line
Fields
TaxRecoverability3ReferenceID
Text
No
Reference for Tax Recoverability for Tax Rate.
TaxRate4ReferenceIDType
Text
Varies
Required if TaxRate4ReferenceID is present. Valid values:
• WID
• Tax_Rate_ID
• Withholding_Tax_Rate_ID

TaxRate4ReferenceID
Text
No
Reference to Tax Rate for Tax Code.
TaxRecoverability4ReferenceIDType
Text
Varies
Required if TaxRecoverability4ReferenceID is present. Valid values:
• WID
• Tax_Recoverability_Object_ID

TaxRecoverability4ReferenceID
Text
No
Reference for Tax Recoverability for Tax Rate.
TaxRate5ReferenceIDType
Text
Varies
Required if TaxRate5ReferenceID is present. Valid values:
• WID
• Tax_Rate_ID
• Withholding_Tax_Rate_ID

TaxRate5ReferenceID
Text
No
Reference to Tax Rate for Tax Code.
TaxRecoverability5ReferenceIDType
Text
Varies
Required if TaxRecoverability5ReferenceID is present. Valid values:
• WID
• Tax_Recoverability_Object_ID

TaxRecoverability5ReferenceID
Text
No
Reference for Tax Recoverability for Tax Rate.
TaxRate6ReferenceIDType
Text
Varies
Required if TaxRate6ReferenceID is present. Valid values:
• WID
• Tax_Rate_ID
• Withholding_Tax_Rate_ID

TaxRate6ReferenceID
Text
No
Reference to Tax Rate for Tax Code.
TaxRecoverability6ReferenceIDType
Text
Varies
Required if TaxRecoverability6ReferenceID is present. Valid values:
• WID
• Tax_Recoverability_Object_ID

TaxRecoverability6ReferenceID
Text
No
Reference for Tax Recoverability for Tax Rate.
LineMemo
Text
No
Memo for the line
BalancingWorktagAffiliateReferenceIDType
Text
Varies
Required if BalancingWorktagAffiliateReferenceID is present. Valid values:
• Business_Unit_ID
• Cost_Center_Reference_ID
• Custom_Organization_Reference_ID
• Fund_ID
• Organization_Reference_ID
• Region_Reference_ID
• Workday ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 697

Transaction
Type
Required?
Description/Notes
Line
Fields
BalancingWorktagAffiliateReferenceID
Text
No
Defines a Balancing Worktag Affiliate when you enable balancing worktag.

Worktag_Type_1
Text
No
You can add one or more worktags at the end of each row as additional columns. The field name
identifies the worktag type. Example: Worktag_.
Cost_Center_Reference_ID, Worktag_Project_ID).

Worktag_Type_2
Text
No
None.
Worktag_Type_n
Text
No
None
ExternalCode_Name_1
Text
No
You can add one or more External Codes to the end of each row as additional columns. Each code
must have a prefix of ExternalCode. The field name identifies the name of the internal reference to
the Integration worktag Mapping created in Workday. Example: ExternalCode_Region. Configure the
Worktag Mapping Definition for External Code integration map to map this internal reference (Example:
Region) to the actual integration worktag mapping defined in the application.
ExternalCode_Name_2
Text
No
None.
ExternalCode_Name_n
Text
No
None.

Business Process Parameters (for Each Transaction)

Business
Type
Required
Description/Notes
Process
Parameter
Field
BP_AutoComplete
Boolean
No
When set to True:
• Workday processes the business process automatically.
• Workday approves all approvals.
• Workday bypasses all reviews and To Dos automatically.
• Workday suppresses all notifications automatically.

BP_Comment
Text
No
Free form comment regarding the business process.
BP_WorkerReferenceIDType
Text
Yes
Required if BP_WorkerReferenceID is present. Valid values:
• Workday ID
• Contingent_Worker_ID
• Employee_ID

BP_WorkerReferenceID
Text
No
Reference ID of the person adding the comment.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 698

Inter-Company Business Subprocess Parameters (for Each Transaction)

Business
Type
Required?
Description/Notes
Subprocess
Parameter
InterCompanyBP_AutoComplete
Boolean
No
When set to True:
• Workday processes the business process automatically.
• Workday approves all approvals.
• Workday bypasses all reviews and To Dos automatically.
• Workday suppresses all notifications automatically.

InterCompanyBP_Skip
Boolean
No
When set to True, Workday skips the business process automatically if you enable step skipping for the
step.
InterCompanyBP_Comment
Text
No
Free form comment regarding the business process.
InterCompanyBP_WorkerReferenceIDType
Text
Yes
Required if there's a InterCompanyBP_WorkerReferenceID value. Valid values:
• Workday ID
• Contingent_Worker_ID
• Employee_ID

InterCompanyBP_WorkerReferenceID
Text
No
Reference ID of the person adding the comment.

Attachment Information (for Each Transaction)

Attachment
Type
Required?
Description/Notes
Information
Field
Attachment_FileName
Text
No
Name of the attachment file. Maximum length is 255 characters.
Attachment_FileContent
Base64
No
File content in binary format.
Attachment_FileType
Text
No
Identifies the content type of the attachment.
Attachment_FileEncoding
Text
No
Identifies the encoding of the attachment
Attachment_FileComment
Text
No
Add any comment for the attachment information.
Attachment_Compressed
Boolean
No
Boolean attribute identifying whether you compressed the attachment.

Bank Fee Analysis Connectors

Steps: Set Up Bank Fee Statement Connectors

Prerequisites
Know the file format that the bank uses for bank fee statements.

Context
You can create an integration to import bank fee statements in 1 of these formats:
• ASC X12 EDI 822
• ISO 20022 camt.86 V1
• ISO 20022 camt.86 V2
• Workday-defined XML format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 699

Steps
1. Access the Create Integration System task and enter the template name for the format that you want
to import: at the New Using Template prompt:
Option Description
ASC X12 EDI 822 Import EDI 822 Bank Fee Statements
ISO 20022 camt.86 V1 Import ISO 20022 V1 Bank Fee Statements
ISO 20022 camt.86 V2 Import ISO 20022 V2 Bank Fee Statements
Workday-defined XML format. Core Connector: Bank Fee Statements Inbound

Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves bank fee statements from an external endpoint.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
4. Select Integration System > Configure Integration Maps as a related action on the integration
system. Map values between Workday and the external file format.
Security: Integration Build and Integration Configure domains in the Integration functional area.
5. Launch an Integration on page 23.
Schedule how often the integration system runs.
6. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Process: Bank Fee Statements
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
7. Create Integration Notifications on page 30.
Configure your integration to send notification messages to specified groups for integration events.

Concept: Bank Fee Statement Connectors


Bank Fee Statement Connectors enable you to import bank fee statements from your financial institutions
for analysis and reporting purposes:
Workday provides these integration templates to support different file formats for bank fee statements:
• Import EDI 822 Bank Fee Statements. This template supports import of bank fee statements in the ASC
X12 EDI 822 format.
• Import ISO 20022 V1 Bank Fee Statements. This format supports import of bank fee statements in the
ISO 20022 camt.86 V1 format.
• Import ISO 20022 V2 Bank Fee Statements. This format supports import of bank fee statements in the
ISO 20022 camt.86 V2 format.
• Core Connector: Bank Fee Statements Inbound. This template supports import of bank fee statements
in a Workday-defined format. Use this template if your bank uses a file format other than EDI 822 or
ISO 20022 camt.86 V1 or camt.86 V2.
Note: This template requires that you create a custom transformation to convert bank fee statements
into the Workday-defined format.

Launch/Schedule Options
Workday provides these launch schedule options for the Bank Fee Statement Connectors:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 700

• Launch with an Integration step on a business process.


• Launch by schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration sends or retrieves any files to or from the endpoint.
• Launch immediately. You can launch the integration manually.

Reference: Bank Fee Statement Connectors XML Schema

<?xml version="1.0" encoding="UTF-8"?>


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="urn:com.workday.custom/bankfeeconnector"
xmlns:bfc="urn:com.workday.custom/bankfeeconnector"
elementFormDefault="qualified" bfc:eofStrip="&amp;#10;"
bfc:numberFormat="#,###.#" bfc:rootElement="bfc:BankFeeStatementFileData">
<xsd:element name="BankFeeStatementFileData">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="SenderIdentification" maxOccurs="1"
minOccurs="0" type="xsd:string" />
<xsd:element name="ReceiverIdentification" maxOccurs="1"
minOccurs="0" type="xsd:string" />
<xsd:element name="FileCreationDate" maxOccurs="1"
minOccurs="0" type="xsd:string" />
<xsd:element name="FileCreationTime" maxOccurs="1"
minOccurs="0" type="xsd:string" />
<xsd:element name="FileIdentificationNumber"
maxOccurs="1" minOccurs="0" type="xsd:string" />
<xsd:element name="BankFeeStatementData"
maxOccurs="unbounded" minOccurs="1"
type="bfc:BankFeeStatementDataType" />
</xsd:sequence>
<xsd:attribute name="codeFormat" use="required">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:minLength value="3"></xsd:minLength>
<xsd:enumeration value="EDI"></xsd:enumeration>
<xsd:maxLength value="5"></xsd:maxLength>
<xsd:enumeration value="ISO"></xsd:enumeration>
<xsd:enumeration value="TWIST"></xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="BankFeeStatementDataType">
<xsd:sequence>
<xsd:element name="BankFeeStatementHeaderData"
type="bfc:StatementHeaderDataType" minOccurs="1" maxOccurs="1">
</xsd:element>
<xsd:element name="BankFeeStatementRateData" minOccurs="0"
maxOccurs="1">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Rate" type="bfc:RateDataType"
minOccurs="1" maxOccurs="unbounded">
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="BankFeeStatementExchangeRateData"
minOccurs="0" maxOccurs="1">
<xsd:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 701

<xsd:sequence>
<xsd:element name="ExchangeRate"
type="bfc:ExchangeRateDataType" minOccurs="1"
maxOccurs="unbounded">
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="BankFeeStatementBalanceData"
minOccurs="0" maxOccurs="1">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Balance"
type="bfc:BalanceDataType" maxOccurs="unbounded"
minOccurs="0">
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="BankFeeStatementCompensationData"
minOccurs="0" maxOccurs="1">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Compensation"
type="bfc:CompensationDataType"
maxOccurs="unbounded"
minOccurs="0">
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="BankFeeStatementServiceData"
minOccurs="0" maxOccurs="1">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Service"
type="bfc:ServiceDataType" maxOccurs="unbounded"
minOccurs="0">
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="StatementHeaderDataType">
<xsd:sequence>
<xsd:element name="StatementID" type="bfc:NonEmptyString"
minOccurs="1" maxOccurs="1" nillable="false"></xsd:element>
<!-- StatementReferenceID is used for Updating a existing bank
statement.
Not Used currently -->
<xsd:element name="StatementReferenceID" type="xsd:string"
minOccurs="0">
</xsd:element>
<xsd:element name="StatementDate" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false">
</xsd:element>
<xsd:element name="StatementStartDate" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="StatementEndDate" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false">
</xsd:element>
<!-- Either CustomerAccountNumber or IBAN needs to be sent -->

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 702

<xsd:element name="CustomerAccountNumber" type="xsd:string"


maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="IBAN" type="xsd:string" maxOccurs="1"
minOccurs="0">
</xsd:element>
<xsd:element name="CustomerAccountName" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<!-- Either RoutingNumber or BIC needs to be sent -->
<xsd:element name="RoutingNumber" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="BIC" type="xsd:string" maxOccurs="1"
minOccurs="0">
</xsd:element>
<xsd:element name="TaxMethod" type="xsd:string"
minOccurs="0" maxOccurs="1"></xsd:element>
<xsd:element name="TaxRegion" type="xsd:string"
minOccurs="0" maxOccurs="1"></xsd:element>
<xsd:element name="TaxRegionNumber" type="xsd:string"
minOccurs="0" maxOccurs="1"></xsd:element>
<xsd:element name="AccountCurrency" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="SettlementCurrency" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="HostCurrency" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="RateDataType">
<xsd:sequence>
<xsd:element name="RateCode" type="bfc:NonEmptyString"
maxOccurs="1"
minOccurs="1" nillable="false"></xsd:element>
<xsd:element name="RateMultiplier" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false">
</xsd:element>
<xsd:element name="RateDaysInPeriod" type="xsd:int" maxOccurs="1"
minOccurs="0"></xsd:element>
<xsd:element name="RateDaysInYear" type="xsd:int" maxOccurs="1"
minOccurs="0"></xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ExchangeRateDataType">
<xsd:sequence>
<xsd:element name="SourceCurrency" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false"></xsd:element>
<xsd:element name="TargetCurrency" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false"></xsd:element>
<xsd:element name="UnitCurrency" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ExchangeRate" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false"></xsd:element>
<xsd:element name="QuotationDate" type="xsd:string"
maxOccurs="1" minOccurs="0"></xsd:element>
<xsd:element name="Comments" type="xsd:string" maxOccurs="1"
minOccurs="0"></xsd:element>
<xsd:element name="Description" type="xsd:string"

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 703

maxOccurs="1" minOccurs="0"></xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="BalanceDataType">
<xsd:sequence>
<xsd:element name="BalanceCode" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false">
</xsd:element>
<xsd:element name="BalanceAmount" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false"></xsd:element>
<xsd:element name="BalanceCurrency" type="xsd:string"
maxOccurs="1" minOccurs="0"></xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="CompensationDataType">
<xsd:sequence>
<xsd:element name="CompensationCode" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false">
</xsd:element>
<xsd:element name="CompensationAmount" type="bfc:NonEmptyString"
maxOccurs="1" minOccurs="1" nillable="false">
</xsd:element>
<xsd:element name="CompensationCurrency" type="xsd:string"
maxOccurs="1" minOccurs="0"></xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="ServiceDataType">
<xsd:sequence>
<xsd:element name="BankServiceCode" type="xsd:string"
maxOccurs="1" minOccurs="1">
</xsd:element>
<xsd:element name="CommonServiceCode" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceDescription" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="CommonCodeServiceDescription"
type="xsd:string" maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceVolume" maxOccurs="1"
minOccurs="0" type="xsd:string">
</xsd:element>
<xsd:element name="ServicePricingCurrency" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceUnitPrice" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServicePricingMethod" type="xsd:string"
maxOccurs="1" minOccurs="1">
</xsd:element>
<xsd:element name="ServicePricingTierLevel" type="xsd:string"
maxOccurs="1" minOccurs="0"></xsd:element>
<xsd:element name="ServicePaymentMethod" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceChargePrice" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceTaxCode" type="xsd:string"
maxOccurs="1" minOccurs="0">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 704

</xsd:element>
<xsd:element name="ServiceTaxRegion" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceTaxMethod" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceTaxAmount" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
<xsd:element name="ServiceTotalAmount" type="xsd:string"
maxOccurs="1" minOccurs="0">
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="NonEmptyString">
<xsd:restriction base="xsd:string">
<xsd:pattern value="[\s\S]*[^ ][\s\S]*" />
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 705

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 706

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 707

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 708

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 709

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 710

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 711

Bank Statement Import Integrations

Steps: Set Up Bank Statement Load Integration

Prerequisites
Security: Integration Build domain in the Integration functional area.

Context
Implement an integration to import prior-day and intraday bank statement files into Workday from an
external endpoint.

Steps
1. Access the Create Integration System task and enter the applicable template name at the New Using
Template prompt.
Option Description
Core Connector Inbound - Bank Statements Integration accepts any format. If file isn’t in
Workday Bank Statement Connector format, the
integration requires a Document Transformation
integration to convert the file into the Workday
format.
Import ISO 20022 V2 Bank Statements Integration accepts files in ISO 20022 V2 format.
The integration supports these subformats:
• camt.053.001.02 for prior day statements.
• camt.052.001.02 for intraday statements.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 712

Option Description
Import BAI2 Bank Statement Integration accepts files in BAI2 format.
Import BTRS Bank Statement Integration accepts files in BTRS format.
Import MT940/942 Bank Statements Integration accepts files in either MT940 or
MT942 formats.

Security: Integration Build domain in Integration functional area.


2. Enable one or more of the optional integration services:
Option Description
Bank Statements Connector Common Workday recommends that you enable this
Configurations service.
Document Attachment Service Available for Core Connector Inbound - Bank
Statements only. Attaches an XSLT file for
performing custom document transformation for
the inbound file.
Enable Message Auditing Workday recommends that you enable this
service only when:
• You first implement the integration.
• You diagnose an issue with the integration.

The Configure Integration Services task displays all integration services, including required services.
Required integration services aren’t editable.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Process: Banking
• Process: Bank Reconciliation
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Configure domain in Integration functional area.
5. Select Integration System > Configure Integration Maps as a related action on the integration
system. Map values between Workday and the external file format.
Security: Integration Configure domain in Integration functional area.
6. Set Up Integration Retrieval on page 1845.
7. Launch an Integration on page 23.
8. Create a transformation that converts bank statement files into the format required by the Bank
Statement Connector.
This isn't required for BAI2, BTRS, ISO20022, MT940, or MT942.
See: Steps: Set Up Document Transformation Connector on page 571.

Concept: Bank Statement Load Integrations


Bank statement integrations import bank statement files into Workday from an external endpoint. Workday
provides these integration templates to support different file formats for bank statements:
• Import ISO 20022 V2 Bank Statements. This template supports the camt.053.001.02 file format for prior
day statements and camt.052.001.02 file format for intraday statements.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 713

• Import BAI2 Bank Statement. This template supports the BAI2 file format.
• Import BTRS Bank Statement. This template supports the BTRS file format.
• Import MT940/942 Bank Statement Load Integration. This template supports MT940 or MT942 file
formats.
• Core Connector Inbound - Bank Statements. This template can import files in a Workday-defined bank
statement format. You define a conversion (Document Transformation) to convert bank statement
files from native format into the Workday-defined format. This template enables you to import bank
statement data from banks that don’t support the standard bank statement formats.

Integration Services
The Bank Statement Load integration templates include these configurable integration services:

Integration Service Available Description


for
Template
Bank Statements Connector Common All Provides these services:
Configurations
• Enable/disable file uniqueness validations.
• Integration maps for domestic bank codes and
bank account numbers.
• (Core Connector Inbound - Bank Statements
only) File-level schema validations on the
bank statement file. Enables you to reject an
entire bank statement file or reject only invalid
statements.

Document Attachment Service Core Enables you to attach an XSLT file to the
Connector integration system. The integration system uses
Inbound the XSLT to convert inbound files into the format
- Bank supported by the integration.
Statements
only.
Enable Message Auditing All Records and stores additional audit messages.

Launch/Schedule Options
Workday provides these launch schedule options for the Bank Statement Load integrations:
• Launch with an Integration step on a business process.
• Launch by schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration retrieves any files from the endpoint.
• Launch immediately. You can launch the integration manually.

Reference: Bank Statements Connector XML Schema


The Bank Statements Connector requires all bank statement files to be in this XML format:

Element Level Details and Validations


BankStatementFileData 1 Top-level element of document.
SenderIdentification 2 Must be in string format.
ReceiverIdentification 2 Must be in string format.
FileCreationDate 2 Must be in date format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 714

Element Level Details and Validations


FileCreationTime 2 Must be in string format.
FileIdentificationNumber 2 Must be in string format. Required field.
BankStatementData 2 Container for following level 3 elements. Minimum 1 element
required; you can add more than 1 element.
BankStatementId 3 Must be in string format.
SameDayBankStatementIndicator 3 Must be in boolean format.
StatementBeginDate 3 Must be in date format.
StatementEndDate 3 Must be in date format.
DomesticBankCode 3 Must be in string format. If empty, BankIdentificationCode
must have a valid value.
BankIdentificationCode 3 Must be in string format. If empty, DomesticBankCode must
have a valid value.
BankAccountNumber 3 Must be in string format. If empty, IBAN must have a valid
value.
IBAN 3 Must be in string format. If empty, BankAccountNumber must
have a value.
BankAccountCurrency 3 Must be in string format.
BankStatementBalanceData 3 Container for following level 4 elements. Schema permits
zero, 1, or more instances of this element.
BalanceTypeCode 4 Required field. Must be in string format.
AlternateBalanceTypeCode 4 Must be in string format.
BalanceTypeSubCode1 4 Must be in string format.
BalanceTypeSubCode2 4 Must be in string format.
BalanceAmount 4 Must be in decimal format. Maximum 18 digits total.
Maximum 17 digits to right of decimal.
BalanceDebitIndicator 4 Must be in boolean format. Boolean true indicates a Debit.
Boolean false indicates a Credit.
BalanceItemCount 4 Must be in string format. Maximum 18 characters, limited to
positive numbers 0-9. This field doesn't permit decimals.
BalanceFundsAvailabilityData 4 Container for following level 4 elements. Schema permits
zero, 1, or more instances of this element.
FundsAvailabilityAmount 5 Required field. Must be in decimal format. Maximum 18 digits
total. Maximum 17 digits to right of decimal.
FundsAvailabilityDate 5 Must be in date format. If empty,
NumberOfDaysUntilAvailable field must have a valid value.
NumberOfDaysUntilAvailable 5 Must be in decimal format, positive value. Maximum
18 digits total. No digits to right of decimal. If empty,
FundsAvailabilityDate field must have a valid value.
UnknownNumberOfDaysIndicator 5 Must be in boolean format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 715

Element Level Details and Validations


BankStatementTransactionData 3 Container for following level 4 elements. Schema permits
zero, 1, or more instances of this element.
TransactionTypeCode 4 Required field. Must be in string format.
AlternateTransactionTypeCode 4 Must be in string format.
TransactionTypeSubCode1 4 Must be in string format.
TransactionTypeSubCode2 4 Must be in string format.
TransactionAmountInAccountCurrency4 Must be in decimal format. Maximum 18 digits total.
Maximum 17 digits to right of decimal.
TransactionAmountInOriginatingCurrency
4 Must be in decimal format. Maximum 18 digits total.
Maximum 17 digits to right of decimal.
OriginatingCurrency 4 Must be in string format.
CurrencyExchangeRate 4 Must be in decimal format.
TransactionDebitIndicator 4 Must be in boolean format. Boolean true indicates a Debit.
Boolean false indicates a Credit.
TransactionDate 4 Required field. Must be in date format.
TransactionValueDate 4 Must be in date format.
Addenda 4 Must be in string format.
ReversalIndicator 4 Must be in boolean format.
BankReferenceNumber 4 Must be in string format.
CustomerReferenceNumber 4 Must be in string format.
AdditionalReference1 4 Must be in string format.
AdditionalReference2 4 Must be in string format.
AdditionalReference3 4 Must be in string format.
AdditionalReference4 4 Must be in string format.
AdditionalReference5 4 Must be in string format.
TransactionFundsAvailabilityData 4 Container for following level 5 elements. Schema permits
zero, 1, or more instances of this element.
FundsAvailabilityAmount 5 Required field. Must be in decimal format. Maximum 18 digits
total. Maximum 17 digits to right of decimal.
FundsAvailabilityDate 5 Must be in date format. If empty,
NumberOfDaysUntilAvailable field must have a valid value.
NumberOfDaysUntilAvailable 5 Must be in decimal format. Maximum 18 digits total. No digits
to right of decimal. If empty, FundsAvailabilityDate field must
have a valid value.
UnknownNumberOfDaysIndicator 5 Must be in boolean format.

<?xml version="1.0" encoding="UTF-8"?>


<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified"

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 716

targetNamespace="urn:com.workday.custom/BankStatementConnector"
xmlns:bsc="urn:com.workday.custom/BankStatementConnector">
<xs:element name="BankStatementFileData">
<xs:complexType>
<xs:sequence>
<xs:element name="SenderIdentification" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="ReceiverIdentification" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="FileCreationDate" maxOccurs="1" minOccurs="0"
type="xs:date" />
<xs:element name="FileCreationTime" maxOccurs="1" minOccurs="0"
type="xs:time" />
<xs:element name="FileIdentificationNumber" maxOccurs="1" minOccurs="1"
type="bsc:Text" />
<xs:element name="BankStatementData" maxOccurs="unbounded" minOccurs="1"
type="bsc:BankStatementData" />
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:complexType name="BankStatementData">
<xs:sequence>
<xs:element name="BankStatementId" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="SameDayBankStatementIndicator" maxOccurs="1"
minOccurs="0" type="xs:boolean" />
<xs:element name="StatementBeginDate" maxOccurs="1" minOccurs="0"
type="xs:date" />
<xs:element name="StatementEndDate" maxOccurs="1" minOccurs="0"
type="xs:date" />
<xs:element name="DomesticBankCode" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="BankIdentificationCode" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="BankAccountNumber" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="IBAN" maxOccurs="1" minOccurs="0" type="bsc:Text" />
<xs:element name="BankAccountCurrency" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="BankStatementBalanceData" maxOccurs="unbounded"
minOccurs="0" type="bsc:BankStatementBalanceData" />
<xs:element name="BankStatementTransactionData" maxOccurs="unbounded"
minOccurs="0" type="bsc:BankStatementTransactionData"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="BankStatementBalanceData">
<xs:sequence>
<xs:element name="BalanceTypeCode" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="AlternateBalanceTypeCode" maxOccurs="1"
minOccurs="0" type="bsc:Text" />
<xs:element name="BalanceTypeSubCode1" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="BalanceTypeSubCode2" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="BalanceAmount" maxOccurs="1" minOccurs="0"
type="bsc:DecimalNumber" />
<xs:element name="BalanceDebitIndicator" maxOccurs="1" minOccurs="0"
type="xs:boolean" />
<xs:element name="BalanceItemCount" maxOccurs="1" minOccurs="0"
type="bsc:Number" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 717

<xs:element name="BalanceFundsAvailabilityData" maxOccurs="unbounded"


minOccurs="0" type="bsc:FundsAvailabilityData"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="BankStatementTransactionData">
<xs:sequence>
<xs:element name="TransactionTypeCode" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="AlternateTransactionTypeCode" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="TransactionTypeSubCode1" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="TransactionTypeSubCode2" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="TransactionAmountInAccountCurrency" maxOccurs="1"
minOccurs="0" type="bsc:DecimalNumber" />
<xs:element name="TransactionAmountInOriginatingCurrency" maxOccurs="1"
minOccurs="0" type="bsc:DecimalNumber" />
<xs:element name="OriginatingCurrency" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="CurrencyExchangeRate" maxOccurs="1" minOccurs="0"
type="xs:decimal" />
<xs:element name="TransactionDebitIndicator" maxOccurs="1" minOccurs="0"
type="xs:boolean" />
<xs:element name="TransactionDate" maxOccurs="1" minOccurs="0"
type="xs:date" />
<xs:element name="TransactionValueDate" maxOccurs="1" minOccurs="0"
type="xs:date" />
<xs:element name="Addenda" maxOccurs="1" minOccurs="0" type="xs:string" />
<xs:element name="ReversalIndicator" maxOccurs="1" minOccurs="0"
type="xs:boolean" />
<xs:element name="BankReferenceNumber" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="CustomerReferenceNumber" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="AdditionalReference1" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="AdditionalReference2" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="AdditionalReference3" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="AdditionalReference4" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="AdditionalReference5" maxOccurs="1" minOccurs="0"
type="bsc:Text" />
<xs:element name="TransactionFundsAvailabilityData" maxOccurs="unbounded"
minOccurs="0" type="bsc:FundsAvailabilityData"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="FundsAvailabilityData">
<xs:sequence>
<xs:element name="FundsAvailabilityAmount" maxOccurs="1" minOccurs="0"
type="bsc:DecimalNumber" />
<xs:element name="FundsAvailabilityDate" maxOccurs="1" minOccurs="0"
type="xs:date" />
<xs:element name="NumberOfDaysUntilAvailable" maxOccurs="1" minOccurs="0"
type="bsc:Number" />
<xs:element name="UnknownNumberOfDaysIndicator" maxOccurs="1" minOccurs="0"
type="xs:boolean" />
</xs:sequence>
</xs:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 718

<xs:simpleType name="Text">
<xs:restriction base="xs:string"></xs:restriction>
</xs:simpleType>

<xs:simpleType name="Number">
<xs:restriction base="xs:decimal">
<xs:fractionDigits value="0" />
<xs:totalDigits value="18" />
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="DecimalNumber">
<xs:restriction base="xs:decimal">
<xs:fractionDigits value="17" />
<xs:totalDigits value="18" />
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="PositiveDecimalNumber">
<xs:restriction base="xs:decimal">
<xs:minInclusive value="0"/>
<xs:fractionDigits value="17" />
<xs:totalDigits value="18" />
</xs:restriction>
</xs:simpleType>

</xs:schema>

Credit Card Integrations

Steps: Set Up Integration for Credit Cards and Transactions

Prerequisites
To ensure accurate matches from integration files, establish merchant codes, names, and alternate names
in:
• Maintain Airlines
• Maintain Car Rental Agencies
• Maintain Class of Service
• Maintain Credit Card Expense Code Mapping
• Maintain Hotels
• Maintain Travel Cities

Context
You can create an integration system to import credit cards and card transaction data into Workday. You
can then process the transactions in Workday Expenses.

Steps
1. Access the Create Integration System task and enter the template name:
Option Description
Import MasterCard CDF3File Masked Imports masked MasterCard Common Data
Format 3 (CDF3) credit card transaction
data. Workday supports Level 1, Level 2, and
Level 3 information for expense credit card

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 719

Option Description
transactions. Workday only supports Air fare and
Hotel Folio data for Level 3 enhanced data.
Import Visa VCF4 Scrubbed Imports scrubbed Visa Commercial Format
(VCF) 4.4 credit card and credit card transaction
data. Workday supports Level 1, Level 2, and
Level 3 information for expense credit card
transaction data. Workday only supports Air fare
data for Level 3 enhanced data.
Import Credit Cardholder File (AMEX GL1205 - Imports masked files directly into your tenant.
MASKED)
For files imported in this format, the integration
checks the Plastic Indicator field. If the value is
N and there's no worker associated with the card,
Workday filters it out.

Import Credit Card Transaction File (AMEX Imports masked GL1025 transaction files.
GL1025 - MASKED
Import AMEX Central Travel Data File Imports masked central travel card transactions
(Masked) from AMEX.
Global Remittance for AMEX Generate remittance files with alternate account
identifiers for AMEX in a Global Remit Layout file
format.
2. (Optional for integrations for credit card transaction only) To enable mapping of data from the
transaction file to Workday, enable one or more of these integration services:
Option Description
Dynamic Map Service - Cities Enables Workday to link a city on the inbound
card transaction file to the corresponding city in
Workday.
Dynamic Map Service - Airlines Enables Workday to link an airline on the inbound
card transaction file to the corresponding airline in
Workday.
Dynamic Map Service - Hotels Enables Workday to link a hotel on the inbound
card transaction file to the corresponding hotel in
Workday.
Dynamic Map Service - Car Rental Enables Workday to link a car rental agency
on the inbound card transaction file to the
corresponding car rental agency in Workday.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Process: Credit
Card and Integration Event security domains.
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select Integration System > Configure Integration Attributes as a related action on your integration
system.
Security: Integration Configure domain in the Integration functional area.
When implementing this integration, accept the default settings for all Dynamic Map Service integration
attributes. You can modify the Dynamic Map Service settings only if instructed to do so by Workday
Support.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 720

5. (Optional) To withhold specific transaction types from self-service users or track service classes for
airlines, select Integration System > Configure Integration Maps and configure integration maps:
Option Description
Class of Service Specify which category codes for airline classes
correspond to your internal service classes. Use
the Maintain Class of Service task to define
the service classes that are of interest to your
organization for reporting purposes.
Example: You want to classify all airline
transactions with the code R or Y as Economy.

Transaction Types Select which financial institution-specific


transaction codes correspond to internal
transaction codes in Workday.
Work with your financial institution during
implementation to list and map all transaction
types initiated by the financial institution.
Example: Credit card annual fee, late payment
fee, finance charge. Visa has a standard list of
codes for financial institution initiated transaction
type codes.

Transaction Status Codes Select the status codes of transactions that you
don't want to display to employees for expense
reports.
Credit card administrators see all transactions.
This map only limits the transactions that are
available to self-service users.

6. Set Up Integration Sequence Generators on page 1856.


Set up the sequence generator for the credit card and credit card transaction filenames.
7. Set Up Integration Retrieval on page 1845.
Configure retrieval of transaction files.

Next Steps
If you import a file with an invalid employee ID, the integration loads the transactions but doesn't
assign them to a credit card. If you then load another file with the correct employee ID, Workday links
any unassigned transactions to the card automatically. If you create the card manually, assign the
unassociated transactions to the employee. Click Credit Card Transaction File Load in the Target
Instance column on the Integration Details tab. Then click Fix Errors to assign transactions to the correct
worker credit card.
Related Information
Reference
The Next Level: Expense Credit Card Integrations

Concept: Credit Card and Card Transaction Integrations


Workday provides integrations that enable you to:
• Import credit cards and credit card transactions.
• Export AMEX remittance files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 721

AMEX Cardholder Listings Integration


You can implement an integration to accept cardholder listing files with masked or tokenized credit card
numbers.
• Masked. American Express provides cardholder listing files with all but the last 4 digits replaced by X.
Using masked files, you can only load transaction files for a single card for each worker per corporate
account.
• Tokenized. American Express provides cardholder listing files with all digits tokenized. Workday
recommends you bring in tokenized credit card numbers if you plan on using Global Remittance.
This integration enables you to use AMEX data as the source-of-truth for credit card records in Workday,
eliminating the need for manual updates.

AMEX Global Remittance (GL1205)


Workday provides an integration that can generate and export remittance file data in a global file format to
AMEX.

AMEX Global Expense Credit Card Transactions (GL1025)


You can create an integration system to import American Express (AMEX) global credit card expenses
into Workday so that you can process the transactions in Workday Expenses. Workday supports electronic
load for AMEX file format GL1025 Global Daily Unbilled Transactions.
You can implement your integration to accept transaction files with masked or tokenized credit card
numbers.
Along with transaction summaries, Workday imports travel expense details for airline, hotel, and car rental
transactions. Workday maps the data automatically to expense items. Workday bases the mapping on the
expense code mappings for your credit cards.
Workday supports both masked and tokenized credit card numbers.

Concept: MasterCard CDF3 15.01 Credit Card Transaction Integration


You can create an integration system to import masked MasterCard Common Data Format 3 (CDF3) credit
card transaction data into Workday. MasterCard provides credit card and card transaction files with all
but the last 4 digits replaced by X or with all but the first 6 digits replaced by X. You can then process the
transactions in Workday Expenses. Workday:
• Supports Level 1, Level 2, and Level 3 information for expense credit card transactions.
Note: Workday only supports Air fare and Hotel Folio data for Level 3 enhanced data.
• Supports electronic load for the MasterCard CDF3 15.01 format.
• Identifies transactions using the Employee ID field on the integration input file.
Along with transactions summaries, Workday:
• Imports travel expense details for airline, hotel, and car rental transactions.
• Maps the data automatically to expense items. Configure Merchant Category Code mapping to expense
items to support this.
Note: If your organization uses more than one network, you can map both Visa and MasterCard
product codes to the same expense item.
You can access the View Credit Card Transaction task to view MasterCard CDF3 credit card transaction
data.

Level 3 Enhanced Data


You can view and report on level 3 hotel data from MasterCard credit card transactions. To determine if
your card program is eligible for Level 3 Enhanced Data, customers using MasterCard Commercial cards

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 722

issued by Smart Data participating banks, can reach out to their issuer to confirm if they are enrolled in
Enhanced Data for Passenger Transport (Airline) and Lodging (Hotel). If you’re not enrolled, you can
request enrollment.
For customers already receiving MasterCard Commercial data through another system or Smart Data, you
can verify if a Match Date is associated with the hotel transaction in your CDF3 file.
Workday supports the United States region.
Workday supports these hotel chains and their brands:

Hotel Chain Brand


Carlson/Radisson Hotels Park Plaza, Park Inn, Radisson, Regent
International, Country Inn
Hyatt Hotels Park Hyatt, Andaz, Grand Hyatt, Hyatt Regency,
Hyatt Place, Hyatt Summerfield Suites, Hyatt
Resorts, Hyatt Vacation Club
Intercontinental Hotel Group Intercontinental, Crowne Plaza, Hotel Indigo,
Holiday Inn, Holiday Inn Express, Staybridge
Suites, Candlewood Suites
Marriot/Starwood Marriot, JW Marriot, Renaissance, Courtyard by
Marriot, Residence Inn, Fairfield Inn, TownePlace
Suites, Spring Hill Suites, Ritz Carlton, Westin,
Sheraton, Four Points by Sheraton, W Hotels, Le
Meridien, St.Regis, Aloft Hotels

Hotel Information
You can view enhanced level 3 data associated with a hotel stay in the Hotel Information section in the
View Credit Card Transaction task. This section includes:
• Audio Visual Charges
• Banquet Charges
• Business Center Charges
• Cash Disbursements Amounts
• Conference Room Charges
• Customer VAT Number
• Folio Number
• Gift Shop Charges
• Gratuity Charges
• Guest Name
• Health Club Charges
• Internet Access Charges Amount
• Laundry Dry Clean Amount
• Lounge Bar Charges
• Mini Bar Charges
• Movie Charges
• No Show
• Other Service Amount
• Other Service Code
• Other Service Type
• Prepaid Expenses Amount
• Room Service Charges Amount

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 723

• Tax Exempt
• Total Amount Charged on Credit Card
• Total Charges Amount
• Total Non Room Charges Amount
• Total Room Tax
• Total Tax Amount
• Transportation Charges
• Valet Charges
You can also create custom reports based on these fields to analyze your organization’s spend.

Tax Information
You can view tax information associated with credit card transactions in the Tax Information section in the
View Credit Card Transaction task. This section includes:
• Additional Tax Charged
• Tax Amount
• Tax Type Code
You can also create custom reports based on these fields.
Related Information
Concepts
Concept: Expense Credit Card Transaction Data Mapping
Tasks
Steps: Review and Correct Credit Card Transactions

Concept: Visa Commercial Format 4.4 (VCF 4) Credit Card Transaction Integration
You can create an integration system to import scrubbed Visa Commercial Format (VCF) 4.4 credit card
transaction data into Workday. Visa replaces each actual credit card number with a new, unique, scrubbed
16-digit number on the VCF4.4 file. Workday identifies the credit card account using this number. Since the
unique number isn't the actual credit card number, the actual credit card number is secure. You can then
process the transactions in Workday Expenses. Workday:
• Supports Level 1, Level 2, and Level 3 information for expense credit card transactions.
Note: Workday only supports Airfare and Hotel Folio data for Level 3 enhanced data.
• Supports electronic load for the Visa Commercial Format (VCF) 4.4.
• Identifies transactions using a combination of:
• Account Number
• Posting Date
• Sequence Number
• Transaction Reference
Along with transaction summaries, Workday:
• Imports travel expense details for airline, hotel, and car rental transactions.
• Mapping is based on the expense code mappings for your credit cards.
• Maps the data automatically to expense items.
Note: Note: If your organization uses more than one network, you can map both Visa and MasterCard
product codes to the same expense item.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 724

Level 3 Enhanced Data


You can view and report on level 3 hotel data from Visa credit card transactions. Visa Commercial Data
Solutions provides enhanced data procured through several sources such as acquirers, GDS, TMCs
and Hotels. If you’re not already enrolled, ensure the financial institution you work with subscribes your
corporate card program for enhanced data through Visa Commercial Solutions Experience portal.

Hotel Information
You can view enhanced level 3 data associated with a hotel stay in the Hotel Information section in the
View Credit Card Transaction task. This includes:
• Charge Date
• Check In Date
• Checkout Date
• Commodity Code
• Daily Room Rate
• Health Club Charges
• If Purchase ID
• Line Item Subtotal
• Merchant Service Description
• No Show Indicator
• Prepaid Expenses Amount
• Sequence Number
• Source Amount
• Total Business Center Charges
• Total Charges Amount
• Total Folio Cash Advances
• Total Food/Beverages Charges
• Total Gift Shop Purchases
• Total Laundry Charges
• Total Mini-Bar Charges
• Total Movie Charges
• Total Non-Room Charges
• Total Room Tax Amount
• Total Telephone Charges
• Total Valet Parking Charges
You can also create custom reports based on these fields to analyze your organization’s spend.
Related Information
Concepts
Concept: Expense Credit Card Transaction Data Mapping
Tasks
Steps: Review and Correct Credit Card Transactions
Examples
2025R1 Feature Release Note: Visa Level 3 Hotel Data for Expense Credit Cards

Reference: Credit Card Formats Supported for Expense Integrations


Workday supports these various credit card formats for inbound integrations:

File Type Primary Account Number (PAN)


AMEX GL1205 Cardholder Listing Files Workday supports masked.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 725

File Type Primary Account Number (PAN)


AMEX GL1025 Global Daily Unbilled Transactions Workday supports masked.
AMEX Central Travel Data File Workday supports masked.
AMEX Global Remittance Workday supports masked.
MasterCard CDF3 15.01 Mask all but the last 4 digits.
Visa VCF4 (VCF4.4) Replaces the actual credit card number.
Bank of America SBF (Visa and Mastercard) (Do Mask all but the last 4 digits. Workday recommends
Not Use) you use MasterCard CDF3 or Visa VCF4.4 instead.
Citibank VISA (Do Not Use) Mask all but the last 4 digits. Workday recommends
you use MasterCard CDF3 or Visa VCF4.4 instead.

Related Information
Tasks
Steps: Set Up Expense Credit Cards

Currency Exchange Rate Connector

Steps: Set Up Integration to Import Currency Exchange Rates into Workday

Prerequisites
Set up an external endpoint that stores the currency exchange rates.

Context
You can create an integration to load currency exchange rates from an external endpoint into Workday.

Steps
1. Access the Create Integration System task and enter Core Connector: Currency Rates at the New
Using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. (Optional) Enable the Enable Message Auditing integration service.
The Configure Integration Services task displays all integration services, including required services.
Required integration services aren’t editable.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
4. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves files with currency exchange rates from your external
endpoint.
5. Launch an Integration on page 23.
Schedule how often the integration system runs.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 726

6. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Set Up: Currency Rates
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
7. Create Integration Notifications on page 30.
Configure your integration to send notification messages to specified groups for integration events.

Concept: Currency Exchange Rate Connector


The Currency Exchange Rate Connector enables you to import currency exchange rates into Workday
from an external endpoint. Workday provides the Core Connector: Currency Rates integration template.
The integration template supports import of currency exchange rates in Workday-defined XML and
Comma-Separated Value (CSV) formats.
Optionally, the integration can calculate and load the inverse rate for each currency pair. Example: if you
load a USD/EUR exchange rate of 1 USD = 0.94 EUR, the integration can calculate and load the inverse
rate 1 EUR = 1.07 USD.

Integration Services
The Core Connector: Currency Rates integration template includes these integration services:

Integration Service Required/ Description


Optional
Core Connector: Currency Rates - Required Launches the integration.
Deployed Service
Core Connector: Currency Rates Required. Processes incoming currency rates file. Optionally,
Service calculates inverse exchange rates.
Financials Document Retrieval Required. Retrieves currency rates file from external endpoint.
Service
Integration Document Retention Required. Retains copy of each integration file.
Enable Message Auditing Optional Records and stores additional audit messages.
Core Connector: Currency Rates Required Performs additional processing after the integration
Post-Processing Service loads the input file into Workday.

Launch/Schedule Options
Workday provides these launch schedule options for the Currency Exchange Rate Connector integration:
• Launch with an Integration step on a business process.
• Launch by schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration retrieves any files from the endpoint.
• Launch immediately. You can launch the integration manually.

Reference: Currency Exchange Rate Connector File Schema


The Currency Exchange Rate Connector supports 2 Workday-defined file formats, Comma-Separated
Value (CSV), and XML.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 727

CSV File Format

Column Name Column Type Description


CalculateInverseRate Boolean Select to calculate the inverse
rates for the currency pairs
included in the input file. This
calculation enables you to reduce
the cost of retrieving additional
exchange rate data. You can
also configure this value in the
integration attributes.
CalculateCrossRates Boolean Select to calculate the cross rates
between 2 currencies when you
know the exchange rates of a
common third currency. This
calculation enables you to reduce
the cost of retrieving exchange
rate data. This value applies
to the currency pairs you’ve
included in the input file. You can
also configure this value in the
integration attributes.
CrossRatesAnchorCurrency String Select the currency you want to
use as a reference when you
calculate cross rates. You can
also configure this value in the
integration attribute.
EffectiveTimestamp DateTime or Date Effective time stamp of the
currency rate. Examples:
• 2011-01-01T00:00:00
(DateTime)
• 2011-01-01 (Date)

FromCurrency String Source currency name in ISO


4217 code format.
TargetCurrency String Target currency name in ISO
4217 code format.
CurrencyRateType String Currency rate type for the
currency rate. Valid values:
• Average
• Budget
• Current
• Financial Budget
• Historic Equity
• Quarterly Average

CurrencyRate Decimal Currency rate value. Field


supports up to 12 decimal
precision.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 728

XML File Schema


<?xml version='1.0' encoding='UTF-8'?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wd="urn:com.workday/CurrencyConnector"
elementFormDefault="qualified"
attributeFormDefault="qualified"
targetNamespace="urn:com.workday/CurrencyConnector">
<xsd:element name="CurrencyConnectorRequest"
type="wd:CurrencyConnectorRequestType"/>

<xsd:complexType name="CurrencyConnectorRequestType">
<xsd:annotation>
<xsd:documentation>Wrapper element to allow bulk currency
conversion rates to be
added.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="CalculateInverseRate" type="xsd:boolean"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>Specifies whether the inverse rate of
this rate should be derived from this rate.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CalculateCrossRates" type="xsd:boolean"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>When enabled, Workday derives cross
rates using the anchor currency.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CrossRatesAnchorCurrency" type="xsd:string"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>The currency Workday uses to derive the
cross rate.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CurrencyConversionRateData"
type="wd:CurrencyConversionRateDataType"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Currency Conversion Rates Data</
xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="CurrencyConversionRateDataType">
<xsd:annotation>
<xsd:documentation>Element containing all Currency Conversion Rate
data items.</xsd:documentation>
<xsd:appinfo>
<wd:Validation>
<xsd:documentation>The Effective Date Time must be in the
form HH:MM. It cannot
include seconds.</xsd:documentation>
<wd:Validation_Message>The Effective Date Time must be in
the form HH:MM. It
cannot include seconds.</wd:Validation_Message>
</wd:Validation>
</xsd:appinfo>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 729

</xsd:annotation>
<xsd:sequence>
<xsd:element name="EffectiveTimestamp" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Effective Timestamp of the Currency
Rate, example format:
2011-01-01T00:00:00
2011-01-01</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:union memberTypes="xsd:date xsd:dateTime"></
xsd:union>
</xsd:simpleType>
</xsd:element>
<xsd:element name="FromCurrency" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Provide the From Currency</
xsd:documentation>

</xsd:annotation>
</xsd:element>
<xsd:element name="TargetCurrency" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Provide the Target Currency</
xsd:documentation>

</xsd:annotation>
</xsd:element>
<xsd:element name="CurrencyRateType" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Reference to an existing Currency Rate
Type - Average,Budget,Current (Default),Financial
Budget,Historic Equity,Quarterly Average</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CurrencyRate" type="xsd:decimal" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Numeric attribute specifying the
Currency
Rate</xsd:documentation>
</xsd:annotation>
</xsd:element>

</xsd:sequence>
</xsd:complexType>

</xsd:schema>

Customer Lockbox Integration

Steps: Set Up Customer Payment Lockbox Integration

Prerequisites
Your bank must be able to generate lockbox files for customer payments. The payments must be in the
format that Workday defines for this integration.

Context
Implement an integration to import lockbox files for customer payments into Workday from an external
endpoint.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 730

Steps
1. Access the Create Integration System task and enter Import Customer Payments Lockbox at the New
Using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Enable one or more of the optional integration services:
Option Description
Enable Message Auditing Workday recommends that you enable this
service only when you first implement the
integration, or when you diagnose an issue.
Integration Document Retention Specify the number of days that the integration
should retain integration files.

The Configure Integration Services task displays all integration services, including required services.
Required integration services aren’t editable.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Customer Deposit Event (business process)
• Integration Event
• Process: Customer Deposit
• Process: Customer Invoice
• Process: Customer Invoice Payment
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Workday displays attributes for each enabled integration service. if you enable additional integration
services, more attributes display in the Configure Integration Attributes task.
Security: Integration Build and Integration Configure domains in the Integration functional area.
5. Select Integration System > Configure Integration Maps as a related action on the integration
system and map values between Workday and the external file format.
Security: Integration Build and Integration Configure domains in the Integration functional area.
6. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves bank statement files from your external endpoint.
7. Launch an Integration on page 23.
Schedule how often the integration system runs.
Related Information
Reference
The Next Level: Customer Lockbox Overview

Concept: Customer Payment Lockbox Integration


A lockbox is a post office box (PO box) that is accessible by a bank. A company’s customers send their
payments to the PO box or the Lockbox. The bank collects and processes the payments, and deposits to
the company’s bank account.
The Customer Payment Lockbox is an inbound integration that imports Bank Administration Institute (BAI2)
lockbox data into Workday from an external endpoint.
• Workday provides a single Import Customer Payments Lockbox integration template. This template
enables you to import lockbox data from any bank that can generate lockbox files in the Workday
defined file format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 731

• You can schedule the Lockbox integration to pick up the Lockbox file on a desired frequency, and
create deposits and payments in Workday.
• The deposits and payments have the lockbox details automatically populated in the memo section to
help you track payment origin.
• You can run the lockbox process in combination with the Auto-Application Payment process to further
automate the cash receipt process. The lockbox integration uses the customer invoice number from the
inbound lockbox file to match against the invoice number in Workday. When the numbers match, the
Remit-From/Bill-To Customer is populated on the customer invoice payment and the auto-apply flag is
set to true.
• To enable importing payments for multiple bank accounts for a given bank, ensure to select the
Lockbox Bank Account checkbox in your integration system. This results in multiple lockboxes in 1
file.
• When you have multiple lockboxes, within each lockbox group, remittances are sub-grouped into 1
or more batches with item and dollar totals at the batch level.
• To enable a bank for a lockbox, edit the desired bank account for a company and add 1 or more
lockboxes on the Lockbox Setup tab. The Lockbox consists of a name, effective date,country,
address, and usage. Once configured, you can view the lockbox on theSettlementtab of the bank
account.
• You can then configure the Lockbox for the company in the Remit-To Lockbox section on the Banking
Information tab of a customer.
Lockbox processing behavior:
• Each Lockbox file is booked to 1 currency and 1 bank account. There can be many deposits in each
Lockbox file and each deposit can contain many payments.
• Each payment can refer to none, 1 or many invoices.
• The Lockbox connector doesn’t generate any customer payments or deposits when there is a null file.
• When there is no match, the customer invoice payment has an Unapplied status.
• When the payment only covers a portion of the invoice being paid, the customer invoice has a payment
status of Partially Paid. Ensure to enable the Unpaid Customer Invoices and Adjustments DIS to
retrieve a list of unpaid or partially paid customer invoices.
• Lockbox integration supports check payment format. To use for wires and ACH payment types,
ensure that the bank can put the data in the required lockbox format for the fields that support the Put
Customer Payment and Submit Customer Deposit APIs.

Web Services
• Put Customer Paymentto load payments.
• Submit Customer Depositto load deposits.
• Get Customer Depositsto match duplicate deposit.

Integration Attributes
The Import Customer Payments Lockbox integration template includes these configurable integration
attributes:

Integration Attribute Description


Currency The currency associated with each payment. It's required.
Enable Deposit Control Total Check this box to include the control total (Batch Total
Amount) on the Deposit. When the Deposit Control Total
is included the Payment totals within the Deposit will be
validated against this amount.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 732

Integration Attribute Description


Enable Duplicate Depost Checking Check this box to prevent duplicate deposits from being
loaded in Workday. A duplicate deposit is one that has the
same Reference ID as another deposit.
Enable Invoice Currency on Payment Enabling this attribute sends the invoice currency
information to Workday given all the selected invoices in
the payment are in Workday and have the same currency.
Lockbox Bank Account Select this check box to use Processing Destination to
support multiple Lockbox Bank Accounts. Otherwise this
integration uses Destination.
Payment Date Check this box to use Processing Date. Otherwise, this
integration uses the Check Date.
Payment Locked in Workday To disable editing and canceling the customer payment
inside the Workday Application, set toTrue. When set to
true, you can update the customer payment only from the
web service.
Payment Type The payment type associated with each payment. It's
required.
Submit Deposit for Approval Select this check box to submit the transaction. If this
attribute is not checked the transaction is always saved in
draft status.
Use Remit-From Customer on Customer With this option, if the Bill-To customers of all the invoices
Profile in a payment are different, then Workday uses the Remit-
From Customer field data on the customer profile to
populate this field on the payment. If Workday is unable to
identify a unique Remit-From Customer on the customer
profile, then this field on the payment is blank.

Integration Maps
The Import Customer Payments Lockbox integration template includes these configurable integration
maps:

Integration Map Description


Account to Company Map Lockbox Bank Account Number to a Workday
Company.
Account to Bank Account Map Lockbox Bank Account Number to a Workday Bank
Account.

You can map the lockbox to a company and a bank account and can have multiple values for each map.

Integration Services
The Import Customer Payments Lockbox integration template includes these configurable integration
services:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 733

Integration Service Description


Enable Message Auditing Records and stores additional audit messages. Workday
recommends that you enable this service only when you
first implement the integration, or when you diagnose an
issue.
Integration Document Retention Retains integration files for audit and troubleshooting
purposes.

Customer Payment Lockbox File Format

Records Nesting in the Lockbox File


The Customer Payment Lockbox integration imports lockbox files in a Workday-defined format.
• The file is ASCII text.
• Each line consists of 1 data record. See character length limits in the table.
• Each record has multiple fields. Each field occupies a specific positions on the line. The field must
occupy all positions defined for it. Example: a field has 10 positions and your data for that field is fewer
than 10 characters. You must pad the remaining positions as defined in the file format.
• The file includes multiple types of records. Some records include subrecords. For successful
processing, all these records including payment information are required. When there is an empty or
missing record, then the file has errors and you will need to contact your bank.

Record Description
Type 1 Record Immediate address header record.
Marks the beginning of a file and identifies both the source bank and the destination
(your company) of the data. Maximum 1 record per file. Each data record must be
exactly 300 characters wide.

Type 2 Service record.


Identifies the purpose, content, and physical characteristics of the data. Immediately
follows type 1 record. Maximum 1 record per file.
Each data record must be exactly 300 characters wide.

Type 5 Lockbox header record.


Provides information that is common to all items for the lockbox. Maximum 1 record per
lockbox. Each data record must be exactly 300 characters wide.

Type 6 Check detail record.


Contains the data associated with a check. There’s 1 detail record per remittance.
Each data record must be exactly 300 characters wide.

Type 4 Overflow record.


Contains invoice information related to the check.
Each data record must be exactly 300 characters wide.

Type 7 Batch total record.


Marks the end of a batch. Used for balance and control purposes.
Each data record must be exactly 300 characters wide.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 734

Record Description
Type 8 Service total record.
Marks the end of all batches for a lockbox. Used for balance and control purposes.
Maximum 1 record per lockbox.
Each data record must be exactly 80 characters wide.

Type 9 Destination trailer record.


Marks the end of a file and includes the total number of records transmitted. Maximum
1 record per file.
Each data record must be exactly 80 characters wide.

Each file has this format:


• A: Begins with a type 1 and type 2 record and ends with a type 9 record.
• B: Each lockbox reported in the file begins with a type 5 record and ends with a type 8 record. When
you have multiple lockboxes, section 5 through 8 will repeat for each lockbox. Each section must have
records to avoid errors.
• C: Each lockbox section contains one or more batches of payments. A type 7 record marks the end of
each batch.
• D: Information for each check and remittance is contained in a type 6 record and one or more type 4
records.

a Type 1
a Type 2
a b Type 5
a b c d Type 6
a b c d Type 4
a b c Type 7
a b Type 8
a Type 9

Launch/Schedule Options
Workday provides these launch schedule options for the Customer Payment Lockbox integration:
• Launch with an Integration step on a business process.
• Launch by schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration retrieves any files from the endpoint.
• Launch immediately. You can launch the integration manually.

Accounting
The accounting will debit the cash account posting rule and credit the undeposited receipts posting rule.
Manual or auto application of the payments will then debit undeposited receipts and credit receivables or
unapplied payments.

Action Debit Credit


Run Lockbox Process Cash Unapplied Payments
Apply Payments Unapplied Payments Receivables

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 735

Action Debit Credit


Place Payment On Account Unapplied Payments Unapplied On Account Payments

Related Information
Reference
The Next Level: Customer Lockbox Overview

Reference: Customer Payment Lockbox Integration File Format

Type 1 Record – Immediate Address Header


This record is always the first record in the file.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 1.
Priority code 2-3 2 (Numeric) Always 00 (2 zeros).
Destination 4-13 10 (Alpha-numeric) Number identifying you as the receiver of
the file. Typically that value is your lockbox DDA account
number. Left justified, space-filled.
Origin 14-23 10 (Alpha-numeric). Bank routing/transit number. Left
justified, space-filled.
Date 24-29 6 (Numeric) Processing date (date that you entered the
data into the external application). Format YYMMDD.
Time 30-33 4 (Numeric) Processing time (time that you entered the
data into the external application). Military time (24-hour
format) in format HHMM.
Reserved 34-300 267 (Alpha-numeric) Space-filled.

Type 2 Record – Service


This record always follows the type 1 record.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 2.
Ultimate network 2-11 10 (Alpha-numeric) Same value as Destination field in the
address type 1 record. Left justified, space-filled.
Ultimate network 12-21 10 (Alpha-numeric) Same value as Origin field in the type 1
origin record. Left justified, space-filled.
Reference code 22-31 10 (Numeric) Zero-filled.
Service type 32-34 3 (Numeric) Always 400.
Record size 35-37 3 (Numeric) Always 300.
Blocking factor 38-41 4 (Numeric) Indicates the number of characters in a block
of data. Always 0300.
Format code 42 1 (Numeric) Always 1.
Reserved 43-300 258 (Alpha-numeric) Space-filled.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 736

Type 5 Record – Lockbox Header


The file includes 1 type 5 record per lockbox. For the first lockbox in the file, the type 5 record follows the
type 2 (service) record. For all other lockboxes, the type 5 record follows a type 8 (service total) record.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 5.
Reserved 2-7 6 (Numeric) Zero-filled.
Lockbox number 8-14 7 (Numeric) Right-justified, zero-filled.
Date 15-20 6 (Numeric) Processing date. Format YYMMDD.
Processing 21-30 10 (Alpha-numeric) Same value as Destination field in the
destination type 1 record. Left justified, space-filled.
Processing origin 31-40 10 (Alpha-numeric) Same value as Origin field in the type 1
record. Left justified, space-filled.
Reserved 41-300 260 (Alpha-numeric) Space-filled.

Type 6 Record – Detail


The file includes 1 type 6 record per transaction.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 6.
Batch number 2-4 3 (Numeric) Unique batch number. Right-justified, zero-
filled.
Item number 5-7 3 (Numeric) Sequential number that identifies each
remittance within the batch. Right-justified, zero-filled.
Remittance amount 8-17 10 (Numeric) Format $$$$$$$$¢¢. Right-justified, zero-filled,
implied decimal. Required field.
Remittance RTN 18-26 9 (Alpha-numeric) Routing/transit number from the MICR
line of the check. If none, space-filled.
Remittance account 27-36 10 (Alpha-numeric) Account number from the MICR line of
number the check, excluding any embedded spaces or dashes.
Left justified, space-filled. If none, space-filled
Check number 37-46 10 (Alpha-numeric) Left justified, space-filled. Truncate this
value if the original check number exceeds 10 characters.
Check level user- 47-76 30 (Alpha-numeric) Left justified, space-filled. If none, space-
defined field 1. filled.
Filler 77-80 4 (Alpha-numeric) Space-filled.
Vicor TID 81-87 7 (Numeric) Assigned for scanning/image research
purposes. Right-justified. If none, zero-filled.
Check date 88-93 6 (Alpha-numeric) Format YYMMDD. Required field.
Check level remitter 94-123 30 (Alpha-numeric) Left justified, space-filled. If none, space-
name. filled.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 737

Field Name Position Size Description


Check level remitter 124-153 30 (Alpha-numeric) Customer number or other identifier
account number. you use to identify the party submitting the check. Left
justified, space-filled. If none, space-filled.
Postmark date 154-159 6 (Alpha-numeric) Format YYMMDD. Required field.
Remitter zip code 160-168 9 (Alpha-numeric) Left justified. If none, space-filled.
Envelope sequence 169-171 3 (Numeric) Right-justified. If none, zero-filled.
number
Check level user- 172-201 30 (Alpha-numeric) Left justified, space-filled. If none, space-
defined field 2. filled.
Check level user- 202-231 30 (Alpha-numeric) Left justified, space-filled. If none, space-
defined field 3. filled.
Check level user- 232-242 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
defined dollar field 1. filled, implied decimal.
Reserved 243-300 58 (Alpha-numeric) Space-filled.

Type 4 Record – Overflow


The integration supports 1 or more type 4 records per transaction for invoice information related to the
check. Type 4 records follow their associated type 6 (detail) records.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 4.
Batch number 2-4 3 (Numeric) Same value as the batch number for the
associated type 6 record. Right-justified, zero-filled.
Item number 5-7 3 (Numeric) Same value as the item number for the
associated type 6 record. Sequential number that
identifies a given remittance within the batch. Right-
justified, zero-filled.
Overflow type 8 1 (Numeric) Always 6.
Overflow sequence 9-10 2 (Numeric) Sequence number of this record within all type
number 4 records for a transaction. Right-justified, zero-filled.
Last indicator 11 1 (Numeric) Valid values:
• 0: There are one or more additional type 4 records
following this record.
• 9: There are no more type 4 records for the
transaction.

Invoice number 12-26 15 (Alpha-numeric) Left justified, space-filled. If none, send


N/A.
Invoice amount 27-36 10 (Numeric) Format $$$$$$$$¢¢. Right-justified, zero-filled,
implied decimal.
Invoice level user- 37-66 30 (Alpha-numeric) Left justified, space-filled. If none, space-
defined field 1 filled. You can use this field to submit Purchase Order
Number values.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 738

Field Name Position Size Description


Filler 67-80 14 (Alpha-numeric) Space-filled.
Invoice date 81-86 6 (Alpha-numeric) Format YYMMDD. If none, send 111111.
Gross invoice amount 87-97 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
filled, implied decimal.
Discount invoice 98-108 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
amount filled, implied decimal.
Invoice remitter 109-138 30 (Alpha-numeric) Customer number or other identifier
account number with you use to identify a customer in addition to the check
lockbox customer remitter identified in the associated 6 record. Used when
you use a single check for payments to multiple customer
accounts. Left justified, space-filled. If none, space-filled.
Envelope sequence 139-141 3 (Numeric) Same value as the envelope sequence number
number in the associated type 6 record. Right-justified. If none,
zero-filled.
Invoice amount due 142-152 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
filled, implied decimal.
Invoice level user- 153-182 30 (Alpha-numeric) Left justified, space-filled. If none, space-
defined field 2 filled. You can use this field to submit Purchase Order
Number values.
Invoice level user- 183-212 30 (Alpha-numeric) Left justified, space-filled. If none, space-
defined field 3 filled. You can use this field to submit Purchase Order
Number values.
Invoice level user- 213-242 30 (Alpha-numeric) Left justified, space-filled. If none, space-
defined field 4 filled. You can use this field to submit Purchase Order
Number values.
Invoice level user- 243-253 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
defined dollar field filled, implied decimal.
Invoice level user- 254-264 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
defined dollar field 2 filled, implied decimal.
Invoice level user- 265-275 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
defined dollar field 3 filled, implied decimal.
Invoice level user- 276-286 11 (Numeric) Format $$$$$$$$$¢¢. Right-justified, zero-
defined dollar field 4 filled, implied decimal.
Invoice level user- 287-292 6 (Alpha-numeric) Format YYMMDD. If none, send 111111.
defined date field
Reserved 293-300 8 (Alpha-numeric) Space-filled.

Type 7 Record – Batch Total


A type 7 record marks the end of a batch. You use this record for balance and control purposes. A type 7
record follows the last type 6 (detail) or type 4 (overflow) record in the batch.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 7.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 739

Field Name Position Size Description


Batch number 2-4 3 (Numeric) Same as the batch number used in the type
6 records and type 4 records within the batch. Right-
justified, zero-filled.
Last item number 5-7 3 (Numeric) Right-justified, zero-filled.
Lockbox number 8-14 7 (Alpha-numeric) Same as the lockbox number in the
associated type 5 record. Right-justified, zero-filled.
Processing date 15-20 6 (Numeric) Format YYMMDD. Required field.
Item count 21-23 3 (Numeric) Number of remittances in the batch, which
equals the number of type 6 records in the batch. Right-
justified, zero-filled.
Batch total amount 24-33 10 (Numeric) Remittance USD total of the batch. Format $$$
$$$$$¢¢. Right-justified, zero-filled, implied decimal.
Batch summary data 34-300 267 (Alpha-numeric) Space-filled.

Type 8 Record – Service Total


A type 8 record follows the last type 7 (batch total) record for a lockbox.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 8.
Last batch number 2-4 3 (Numeric) Right-justified, zero-filled.
Last item number 5-7 3 (Numeric) Right-justified, zero-filled.
Lockbox number 8-14 7 (Alpha-numeric) Same value as the lockbox number in
the associated type 5 record. Right-justified, zero-filled.
Processing date 15-20 6 (Numeric) Format YYMMDD.
Item count 21-23 3 (Numeric) Number of remittances for this lockbox. Equals
the number of type 6 records in the lockbox. Right-
justified, zero-filled.
Lockbox total amount 24-33 10 (Numeric) Remittance dollar total for the lockbox. Format
$$$$$$$$¢¢. Right-justified, zero-filled, implied decimal.
Filler 34 1 (Alpha-numeric) Space-filled.
Batch count 35-37 3 (Numeric) Number of batches for the lockbox. Right-
justified, zero-filled.
Reserved 38-80 43 (Alpha-numeric) Space-filled.

Type 9 Record – Destination Trailer


The type 9 record is the last record in the file.

Field Name Position Size Description


Record type 1 1 (Numeric) Always 9.
Record count 2-7 6 (Numeric) Total number of records in the file, including
this type 9 record. Right-justified, zero-filled.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 740

Field Name Position Size Description


Reserved 8-80 73 (Alpha-numeric) Space-filled.

Sample File
1001234567890121000248 0611101648
21234567890121000248 000000000040008000801
500000077777770611101234567890121000248
6001001000000111112100024812345678902433440001Check User Defined Field 1
0000VID060401Remitter Name Account Number
060804012345678001Check User Defined Field 2 Check User Defined Field 3
00000000000
400100160194873201 0000001111Invoice User Defined Field 1
0611010000000111100000001111 00000001111Invoice User
Defined Field 2 Invoice User Defined Field 3 Invoice User Defined Field 4
00000000000000000000000000000000000000000000111111
6001002000000222212100024812345678902433440002Check User Defined Field 1
0000VID060401Remitter Name Account Number
060804012345678002Check User Defined Field 2 Check User Defined Field 3
00000000000
400100260104873202 0000001111
0611010000000111100000001111 00000001111Invoice User
Defined Field 2 Invoice User Defined Field 3 Invoice User Defined Field 4
00000000000000000000000000000000000000000000111111
400100260294873202 0000001111
0611010000000111100000001111 00000001111Invoice User
Defined Field 2 Invoice User Defined Field 3 Invoice User Defined Field 4
00000000000000000000000000000000000000000000111111
6001003000000333312100024812345678902433440003Check User Defined Field 1
0000VID060401Remitter Name Account Number
060804012345678003Check User Defined Field 2 Check User Defined Field 3
00000000000
700100377777770611100030000006666
800100377777770611100030000036666 001
9000012

DAS2 Integration

Steps: Set Up DAS2 Integration

Prerequisites
• Set up these details on your company:
• A company address with a street number extension of Bis, Ter, Quater, or Quinquies and a numeric
postcode that doesn't begin with 00.
• The SIREN number, SIRET number, and APE code tax IDs.
• Set up these details on payees you want to report on:
• An address.
• A payee category.
• The DAS2 tax authority form type.
• For payees that are based in France, also set up these details:
• The SIRET number tax ID.
• A street number extension of Bis, Ter, Quater, or Quinquies and a numeric postcode that doesn't
begin with 00.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 741

Context
You can create an integration to generate electronic TD/Bilatéral files from transaction entries to present
to French tax authorities. DAS2 is a declaration of payments made to third parties that exceed a specified
threshold.

Steps
1. Access the Maintain Third-Party Payments Configuration task.
Select Aggregate Category Mapping, then map the DAS2 payment categories to Workday spend
categories or spend category hierarchies.
After you map the payment categories, add all payment categories to 1 row and enter the threshold
specified by the tax authority.
Security: Set Up: Tax domain in the Common Financial Management functional area.
See also:
• Concept: Third-Party Payments Integration
• Steps: Set Up Third-Party Payments Integration
2. (Optional) Access the Maintain Supplier Classifications task.
You can add a supplier classification to differentiate between companies and individuals as suppliers.
As you complete the task, consider:

Classification Name Enter a name for your supplier classification.


Example: Individual.
Field Title Create field titles for your suppliers' first and last
names, and professions. Example:
• First Name
• Last Name
• Profession

Simple Classificaiton Type Select Text or Multiple Choice - Single Select


for your fields.
3. (Optional) Access the Change Supplier Classification task.
Select a supplier and add your supplier classification to the Supplier Classification field, then populate
the names and profession.
4. Create Integration System.
Select DAS2 in the New Using Template prompt.
5. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
6. Select Integration System > Configure Integration Attributes from the related actions menu of the
integration system.
Enter integration service attributes. When you're using individual supplier classifications, ensure you
select your supplier classification for the Individual Supplier Classification attribute.
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 742

7. (Optional) Select Integration System > Configure Integration Field Overrides from the related
actions menu of the integration system.
Select the IndividualAsSupplier subdocument.
As you complete the task, consider:

Field Details Select Supplier Classification Field.


Value Map each row in the Field(s) column to your
supplier classification fields.
8. Launch an Integration on page 23.

Next Steps
Submit your DAS2 file to the tax authority.

Concept: DAS2 Integration


You can use the DAS2 integration template to generate DAS2 audit files in the electronic TD/Bilatéral
format specified by the French tax authority. The integration exports the totals of these payments for a
company when the total amount paid to a payee exceeds the threshold set by the tax authority:
• Supplier invoice payments, including supplier invoice adjustments.
• Ad hoc payments.
• Miscellaneous payments.
The integration also includes corrections made through accounting adjustments.
You can include payees by assigning the DAS2 tax authority form type to:
• Ad hoc payees on the Edit Ad Hoc Payee task.
• Contingent workers on the Assign Tax Authority Form Type to Contingent Worker task.
• Miscellaneous payees on the Edit Miscellaneous Payee task.
• Suppliers on the Create Supplier Change task.

Source Data
Since DAS2 requires that all fields have values, the integration populates a zero or space in the output
when a field in Workday has no value. To avoid problems, enter values for all fields required for DAS2 in
your company and payee details.
Additionally, ensure that you set up these details for any French companies or payees:
• A full address with a street number extension of Bis, Ter, Quater, or Quinquies. Workday converts the
extension to the appropriate format in the output.
• A numeric postcode that doesn't begin with 00.
• The APE code.
• The SIREN number.
• The SIRET number.
You can't enter a SIRET number for ad hoc payees and contingent workers. Workday recommends that
you use these payee types only for payees outside of France.

Mapping Payment Categories


Before setting up the integration, you can access the Maintain Third-Party Payments Configuration task
to map the payment categories on the DAS2 form to Workday spend categories.
You can use the Aggregate Category Mapping option to set up the payment threshold specified by the
tax authority. When you select this option, you can group the payment categories and set a threshold for

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 743

the total value of all payments. The integration output then includes payees only when you've paid them
more than the threshold amount.

Output Files
When the integration runs, Workday generates a ZIP file containing the DAS2 text file. You can find the file
on the Output Files tab of the integration event.
Related Information
Concepts
Concept: Third-Party Payments Integration on page 986

EBICS Integrations

Steps: Set Up EBICS

Context
You can set up the Electronic Banking Internet Communication Standard (EBICS) transmission protocol to
transact securely with financial institutions. To use EBICS, add the EBICS contract to the business process
of either:
• Payment integration to transfer payment files.
• Bank statement integration to import bank statements.
• Payment acknowledgment integration to import payment acknowledgments.
Note: When you set up EBICS in your Implementation tenant, your setup doesn't transfer to your
Production tenant. You must set up EBICS again in your Production tenant. Before Workday can re-
initialize you in the Production tenant, you must first contact your bank to reset your EBICS credentials.

Steps
1. Create EBICS Contract on page 744.
Security: Set Up: Bank Entity domain in the Banking and Settlement functional area.
2. Select State > Initialize from the related actions menu of the user on the contract.
Once the status of the user is Pending Activation, Workday generates an initialization letter for you to
send to your financial institution.
3. Select State > Activate or Deactivate from the related actions menu of the user on the contract.
Activate the user in Workday.
4. Select State > Cancel or Initialize from the related actions menu of the contract.
Initialize the contract when your financial institution provides you with the keys.
5. Create an integration system user (ISU) and integration system security group for EBICS.
Configure the ISU with integration system security groups and domain security policies.
Grant the ISU Get and Put access to these domains:
• Configuration Set: Integrations domain in the System functional area.
• Set Up: Bank Entity domain in the Banking and Settlement functional area.
See ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 744

6. Edit Business Processes.


On the business process for the integration system that you want to use the contract for, add the EBICS
step:
• For payment integrations, replace the document delivery step with the EBICS step.
When you set up EBICS for a payment integration, Workday recommends that you add the EBICS
users as approvers on the Settlement Run Event business process.
• For bank statement and payment acknowledgment integrations, replace the document retrieval step
with the EBICS step.
Select:
• Service in the Type prompt.
• EBICS in the Specify prompt.
7. Access the business process definition for the integration system that you configured for EBICS.
To configure EBICS, select an order type that you configured for the user on the contract. The order
type must also be compatible with the integration you configured for EBICS.
When you run the integration, Workday recommends that you select the ISU that you configured for
EBICS.

Next Steps
If you set up EBICS for a payment integration, create a settlement run to send payment files to your
financial institution using the EBICS transmission. Workday recommends that you test your EBICS
configuration by transferring a test payment file.
To check if your payment file delivery is successful, view your settlement run:
1. In the Payment Groups grid in the Payment Groups tab, click the payment message for the payment
group that you want to verify.
2. In the Business Process grid in the Business Process tab, click Integration Process: EBICS
Configuration and Transmission - For EBICS Configuration.
3. Click the integration event in the Initial Integration Event section. The status says Completed when
your payment file delivery is successful.
Related Information
Tasks
Steps: Set Up Bank Integrations for Settlement Processing on page 826
Reference
2022R1 What's New Post: EBICS Version 2.5

Create EBICS Contract

Prerequisites
• Obtain Electronic Banking Internet Communication Standard (EBICS) information from your financial
institution.
• Security: Set Up: Bank Entity domain in the Banking and Settlement functional area.

Context
You can create an EBICS contract to record information in Workday that you obtained from your financial
institution. You can add the contract to your integrations to transact securely with your financial institution
using the EBICS transmission protocol.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 745

Steps
1. Access the Create EBICS Contract task.
2. As you complete the EBICS Connectivity Information section, consider:
Option Description
EBICS Id Enter a unique ID for the EBICS contract in
Workday.
Partner Id Enter the EBICS customer ID that your financial
institution provides.
Country This prompt is only for reporting purposes and
doesn't affect how the EBICS contract interacts
with your financial institution.
Financial Institution This prompt is only for reporting purposes and
doesn't affect how the EBICS contract interacts
with your financial institution.
3. As you complete the EBICS Users grid, consider:
Option Description
User Id Enter the user ID that your financial institution
provides. The EBICS user authorizes sending the
payment file.
User Name Enter the name of the EBICS user in Workday.
Signature Select the electronic signature types for the
EBICS users.
EBICS contracts require either:
• A user with an E signature.
• A user with an A signature and a second user
with either an A or B signature.
EBICS T contracts require a user with a T
signature.
When there are users with different signature
types in the EBICS contract, Workday prioritizes
the signatures based on the order that you list the
users in the contract.
Example: The contract has 3 users with different
signature types. Ordered from first to last, the
users have signature types A, B, and E. Workday
uses signature types A and B for the contract.

Order Types Select the EBICS order type that specifies the
file format and other requirements your financial
institution uses for processing the payment file.

Next Steps
• Activate the EBICS users and the contract.
• Add the contract to the business process of the integration that you want to use for EBICS.
• Use the Find EBICS Contracts report to view the contracts that you've created.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 746

Related Information
Tasks
Steps: Set Up Settlement

EDI Supplier Integrations

Steps: Set Up Integration to Import EDI 810 Supplier Invoices

Prerequisites
• Know the IP address for the external vendor endpoint.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
You can create an integration to import supplier invoices in the American Standards Committee (ASC) X12
810 EDI format from a supplier.
When you expect suppliers to send credit memos as invoice adjustments through an EDI 810 integration:
• Ask suppliers not to populate the BIG04 segment with a purchase order (PO) number, or else build a
preprocessor to remove the PO number.
• Consider whether your Return to Supplier Event business process configuration creates an invoice
adjustment when you create a return.
When the Return to Supplier Event business process creates invoice adjustments, the EDI 810 integration
might result in duplicate credit memos: one created through the business process, and another when you
receive an invoice adjustment through EDI.

Steps
1. Access the Maintain Units of Measure task.
Enter the units of measure that you want to use for EDI 810 transactions in the EDI Code field.
Note: To avoid processing errors, enter all units of measure in the EDI Code column, even when
they’re the same as the UN CEFACT Common Code.
Security: Set Up: Unit of Measure domain in the Common Financial Management functional area.
2. Create Integration System on page 1854.
From the New Using Template prompt, select Supplier Invoice EDI 810 Inbound.
You can enable the optional EDI 810 Additional opt-in Configurations Service integration service to
create supplier invoices that might cause errors in Draft status instead of causing the integration to fail.
3. Create Integration Business Process on page 1838.
4. Set Up Integration Retrieval on page 1845.
Configure document retrieval to import EDI 810 files.
5. Select Integration System > Configure Integration Attributes from the related actions menu on the
integration system.
Enter integration service attributes. As you complete the task, consider:

Integration Attribute Description


Interchange Sender ID Enter the ID provided by the supplier.
Default Company/Supplier From PO Enable this attribute to populate the company
and supplier on the supplier invoice from the PO
referenced in the EDI 810 file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 747

Integration Attribute Description


When the values in the EDI 810 file differ from
the values on the PO in Workday, the values in
Workday take precedence.

Skip Control Total Amount Verification Enable this attribute to deactivate errors that
occur when the control total amount in the TDS01
segment doesn’t match the total of the lines for
the invoice.
Enable Pre-Processing Enable this attribute to deactivate certain
validations and create supplier invoices that would
otherwise cause errors in Draft status.
When you enable this attribute, Workday creates
supplier invoices in Draft status when the:
• Supplier invoice contains both valid and invalid
line numbers for the referenced PO.
• ITM01 segment on the inbound file is missing
a line number value.
• Referenced PO number doesn’t exist for the
company.
• EDI 810 file references a PO with a change
order in progress where the invoice also
contains an invalid PO line reference.
Before you enable this attribute, consider:
• This feature works with the Supplier Invoice
Work Area.
• You must configure a supplier reference ID for
any suppliers that send EDI 810 invoices.
• The integration uses the Submit Supplier
Invoice Request web service.

EDI 810 Work Area Enhancement Displays when you enable the optional EDI
810 Additional opt-in Configurations Service
integration service on your integration.
Enable this attribute to:
• Process more of the EDI 810 data that you
import into Workday.
• Correct EDI 810 transaction errors in the
Supplier Invoice Work Area.

Security: Integration Build and Integration Configure domains in the Integration functional area.
6. Select Integration System > Configure Integration Maps from the related actions menu on the
integration system.
You can map values between Workday and the EDI 810 file. This mapping is useful in cases when
values from your suppliers are ZZ (Mutually Defined), or a supplier sends an invoice without a PO.
As you complete the task, consider:

Map Description
Company Mapping EDI File Map this value to avoid processing errors.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 748

Map Description
The External Value that you specify for the
selected company must match the GS03 and
ISA08 segments in the EDI 810 file.

Supplier Mapping EDI File Map this value when the selected supplier in
Workday doesn't have a DUNS number that
matches the GS02 segment on the EDI 810 file.
When you haven't configured a DUNS number on
the supplier profile, update the supplier to add it or
enter the DUNS number in the External Value.

Security: Integration Build and Integration Configure domains in the Integration functional area.
7. (Optional) Access the Maintain Supplier Invoice System Validation task.
Select which validation errors to ignore when you create supplier invoices using the EDI 810 integration.
When applicable, Workday creates a supplier invoice in Draft status and directs it to the Supplier
Invoice Work Area report, where you can change and correct the invoice to complete processing.
Security: Set Up: Supplier Accounts domain in the Supplier Accounts functional area.
8. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
9. (Optional) Create Integration Notifications on page 30.
10.Launch an Integration on page 23.
Related Information
Tasks
Steps: Set Up Supplier Invoices
Steps: Set Up Supplier Invoice Work Area
Reference
Reference: Valid Element Codes for Inbound EDI 810 Files on page 760
Reference: Supplier Invoice Work Area

Steps: Set Up Integration to Export EDI 850 Purchase Orders

Prerequisites
Know the IP address for the external vendor endpoint.

Context
You can create an integration to export purchase orders (POs) in the American Standards Committee
(ASC) X12 850 EDI format to a supplier.
Workday trims these ASC X12-supported delimiters from the 850 outbound file: ~ ^ : * |
Example: Workday processes 123~ABC as 123ABC.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 749

Steps
1. Change Supplier Information.
For suppliers that you plan to use EDI with:
• Configure DUNS numbers in the supplier details.
• Select EDI or EDI Auto as the issue option for purchase orders.
When a supplier uses a different ID, configure an alternate value to populate in the GS03 segment.
Specify an Alternate Name Usage of EDI Integration Name.
2. (Optional) Access the Edit Company Industry Codes task.
We recommend that you use this task to configure DUNS numbers for companies that send EDI 850
purchase orders. Workday populates the DUNS number in the GS03 segment in EDI 850 files.
From the Industry Code Type prompt, select DUNS NUMBER, and enter the company DUNS number
in the Industry Code field.
Security: Set Up: Company General in the Common Financial Management functional area.
3. (Optional) Access the Maintain Companies as Customers or Suppliers task.
When your companies are also set up as customers, ensure that the DUNS number on the customer
profile matches the DUNS number on the company.
Access the related actions menu of the company in the Operates as Customer column and check the
DUNS number.
When you don't configure a DUNS number on the Edit Company Industry Codes task, Workday uses
the DUNS number from the customer profile in EDI 850 files.
Security: Set Up: Company Accounting domain in the Common Financial Management functional area.
4. Maintain Customer Account Number Rules.
To process EDI 850 files correctly, configure customer account numbers. Customer account numbers
can populate on EDI 850 files through the deliver-to or ship-to customer account number on purchase
orders at the header or line level.
Security: Set Up: Procurement domain in the Procurement functional area.
5. Access the Maintain Units of Measure task.
Enter the units of measure (UOM) that you want to use for EDI 850 transactions in the EDI Code field.
To issue service lines on POs, configure a UOM row with this information:

Column
EDI Code HR
Unit of Measure Dimension Time
Unit of Measure Name Hours

Note: To avoid processing errors, enter all UOMs in the EDI Code column, even when they’re the
same as the UN CEFACT Common Code.
Security: Set Up: Unit of Measure domain in the Common Financial Management functional area.
6. (Optional) Maintain Purchase Order Types.
In the EDI Code column, specify the qualifier code to send in the BEG02 segment of EDI 850 files that
use a particular purchase order type.
By default, Workday sends:
• CN when the purchase order type is Bill Only, Consignment, or both.
• SA for other purchase order types.
Example: If you want to configure rush orders as a purchase order type, you would set the required
BEG02 identifier to RO to meet EDI standards.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 750

7. (Optional) Set Up Shipping Information.


In the EDI Code field, enter the shipping method that you want to send to suppliers for EDI 850
transactions.
Commonly accepted shipping methods that you can configure include:
• ON for STANDARD NEXT DAY
• NM for NEXT DAY 8:00 AM
• PA for NEXT DAY 10:30 AM
• SE for SECOND DAY
• 3D for THIRD DAY
• SP for SATURDAY
8. Create Integration System on page 1854.
From the New Using Template prompt, select Purchase Order EDI 850 Outbound.
Enable the optional EDI 850 Filename Sequence Generator integration service.
You can create multiple EDI 850 integration systems when different companies or suppliers require
different configurations.
9. Select Integration System > Configure Integration Attributes from the related actions menu on the
integration system.
Enter integration service attributes. As you complete the task, consider:

Integration Attribute Description


MSG segment for PO header Enable this attribute to send multiple MSG
segments when the Memo on the header of a
purchase order is longer than the character limit
for a single MSG segment. Workday splits the
memo across multiple MSG segments.
When you don't enable this attribute, Workday
truncates the memo.

Change Ship to Contact Code from AR to RQ Enable this attribute when a supplier requests
that you populate the PER^01 segment with RQ
instead of the default value AR.
Receiver ID Enter the supplier ID to populate in the ISA08
segment in the EDI 850 file.
N9 Before N1 Segment Enable this attribute when an interchange partner
requests that you send the N9 segment before the
N1 segment.
When you don't enable this attribute, Workday
generates the file with the N1 segment first.

Disable Unit Cost Rounding Enable this attribute to allow item unit costs to
have up to 6 decimal places. This setting helps
reduce pricing errors caused by rounding when
you submit purchase orders.
Sender ID Enter a value when you have multiple companies
that use the same code when sending orders to
suppliers.
ISA07 Qualifier Enter a 2-character value to override the default
ZZ when the interchange provider requires ISA07
to have a different value.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 751

Integration Attribute Description


Interchange Usage Indicator Select an option to indicate in the ISA15 segment
whether you sent the message from a test
environment or production environment.
By default, the integration populates the ISA15
segment with P (production).

Security: Integration Build and Integration Configure domains in the Integration functional area.
10.(Optional) Select Integration System > Configure Integration Field Attributes from the related
actions menu of the integration system.
Include the supplier part auxiliary ID when:
• A PO originates from a supplier punchout requisition.
• The supplier requires this field.
When the supplier provided the ID on their response to the requisition, the field populates on the PO1
segment with a VO qualifier.
Select the Purchase_Order_Goods_Line folder.
In the Field Configuration grid, select the Include in Output check box for the
Supplier_Part_Auxiliary_ID field.
Security: Integration Build and Integration Configure domains in the Integration functional area.
11.Set Up Integration Sequence Generators on page 1856.
Configure 2 sequence generators to enable the integration services and ensure that each EDI 850 file is
unique:
• EDI 850 Batch ID Sequence Generator
• EDI 850 Filename Sequence Generator
Workday uses these values in the ISA13 (Interchange Control Number) assigned on your EDI 850
outbound files.
Note: To avoid errors, ensure that the sequences are 9 digits in length.
12.Create Integration Business Process on page 1838.
13.Set Up Integration Delivery on page 1839.
Specify how the integration system delivers EDI 850 files to the external vendor endpoint.
In the Document(s) section, select From this Integration Process.
In the Transport Type section, select the SFTP transport type and enter the SFTP details.
14.Create an Integration System User (ISU) and grant it Get and Put access to the Integration Event
domain.
See Steps: Grant Integration or External Endpoint Access to Workday.
15.(Optional) Create Integration Notifications on page 30.
Workday recommends that you configure notifications to inform users or security groups when
integrations complete with warnings or errors.
16.Edit Business Processes.
Configure your Purchase Order Issue Event business process to launch the integration when you issue
POs.
We recommend that you trigger the integration using the Launch EDI 850 Outbound Integration service
step. When you have more than 1 EDI 850 integration, access the Maintain Supplier Links task to
specify which integration system to use for which purchase orders.
Alternatively, you can add an integration step and configure your EDI 850 integration. From the Value
Type prompt, select Determine Value at Runtime. From the Value prompt, select Purchase Order.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 752

When you have more than 1 EDI 850 integration, add multiple integration steps and configure entry
conditions to specify which integration system to use for which purchase orders.
17.(Optional) Access the Maintain Supplier Links task.
Specify which integration systems to use when you
• Trigger integrations with the Launch EDI 850 Outbound Integration service step.
• Have different EDI 850 configurations for certain companies or suppliers.
On the Supplier Links for EDI PO Issue tab, add rows to the grid to specify which integration systems
to use for certain companies or suppliers.
Security: Set Up: Procurement domain in the Procurement functional area.
18.(Optional) Launch an Integration on page 23.
You can launch the integration manually when you need to reprocess errors.

Result
When you issue multiple POs by EDI at the same time, we consolidate the files by supplier and
acknowledgment status for the issued purchase orders. Example:

Purchase Order Supplier Acknowledgment EDI File


Expected
PO-1000 Independent Technology Yes File001.edi
Solutions
PO-1001 Independent Technology No File002.edi
Solutions
PO-1002 Independent Technology Yes File001.edi
Solutions
PO-1003 Global Catering Services Yes File003.edi

Related Information
Tasks
Issue Purchase Orders
Create Suppliers
The Next Level: Spend Management EDI Integrations: A Comprehensive Mini Series
Reference
Reference: Valid Element Codes for Outbound EDI 850 Files on page 765

Steps: Set Up Integration to Import EDI 855 Purchase Order Acknowledgments

Prerequisites
• Know the IP address for the external vendor endpoint.
• Retrieve the ISA06 Interchange Sender ID code from the external vendor.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
You can create an integration to import purchase order acknowledgments (POAs) in the American
Standards Committee (ASC) X12 855 EDI format.
When you import a POA, Workday:
• Appends the EDI status code in the Memo field for each purchase order line.
• Matches the purchase order line number sent by the supplier for the POA.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 753

• Maps MF qualifiers for manufacturers to the free-text Manufacturer Name alternate item identifier.
You can't process suppliers sending multiple acknowledgment lines for the same purchase order line in
Workday within the same file.

Steps
1. Access the Edit Tenant Setup - Financials task.
In the Business Document Sequence IDs section, create or select an ID generator from the ID
Generator for Purchase Order Acknowledgement prompt.
In the Procurement Options section, select the Enable Purchase Order Acknowledgements check
box.
Security: Set Up: Tenant Setup - Financials domain in the System functional area.
2. Steps: Automate Changes from Purchase Order Acknowledgments
Workday recommends automating changes from Purchase Order Acknowledgments to ensure data
accuracy after you import.
3. Access the Maintain Units of Measure task.
Set up units of measure for EDI using the X12 standards. Enter the units of measure that you want to
use for EDI 855 transactions in the EDI Code column.
Note: To avoid processing errors, enter all units of measure in the EDI Code column, even when
they’re the same as the UN CEFACT Common Code.
Security: Set Up: Unit of Measure domain in the Common Financial Management functional area.
4. Change Supplier Information.
For suppliers that you expect to receive EDI 855 files from, select the Acknowledgement Expected
check box in the Procurement Options.
With this configuration, Workday sets the ISA14 segment to 1 when you issue EDI 850 files. This
informs suppliers that you expect an acknowledgment.
5. Create Integration System on page 1854.
From the New Using Template prompt, select Purchase Order Acknowledgment EDI 855 Inbound.
6. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
As you configure the attributes, consider:

Integration Attribute Description


Interchange Sender ID You don't need to specify a value when suppliers
pass the customer DUNS information in the
ISA06.
When you do need to map this value, ensure that
your supplier sets the ISA05 qualifier to ZZ in the
EDI 855 file.

Validate Receiver ID Select to validate that the DUNS number for


the customer in the EDI file matches the DUNS
number on a company in Workday.
When you enable this attribute, Workday
compares the ISA06 value on the EDI 855 file
with DUNS numbers maintained on:
• The Edit Company Industry Codes task.
• Customer profiles, when you've configured
companies as customers.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 754

Integration Attribute Description


Validate Sender ID Select to validate that the DUNS number for the
supplier in the EDI file matches the DUNS number
on a supplier in Workday.
When you enable this attribute, Workday
compares the GS02 value on the EDI 855 file with
the DUNS number of suppliers.
Note: When you enable both Validate Sender ID
and Validate Receiver ID and 1 of the validations
fails, Workday displays an error even when the
purchase order matches a valid number in your
tenant.

Security: Integration Build and Integration Configure domains in the Integration functional area.
7. (Optional) Select Integration System > Configure Integration Maps as a related action on the
integration system.
Map values that you expect in the EDI 855 file to the equivalent data in Workday.
In the External Value column, enter the values you expect to receive in the ACK segment for each
purchase order line.
In the Internal Value column, enter the display name of the Universal Item Identifier without the spaces.
Access the Maintain Item Identifier Types task to configure more item identifiers if the supplier
expects it. For each alternate item identifier you configure, the Internal Value on the integration map
must match the name of the Universal Identifier Item Type on the Maintain Item Identifier Types
task. When you map these values, they display on the POA.
8. Create Integration Business Process on page 1838.
9. Set Up Integration Retrieval on page 1845.
Configure document retrieval to import EDI 855 files.
10.Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
Access the related actions menu of the system user created and select Security Profile > Assign
Integration System Groups
See Steps: Grant Integration or External Endpoint Access to Workday.
11.(Optional) Create Integration Notifications on page 30.
Workday recommends that you set up notifications to inform appropriate security groups or users when
your integration completes with these statuses:
• Completed With Warnings
• Completed With Errors
12.Launch an Integration on page 23.
Related Information
Reference
Reference: Valid Element Codes for EDI 855 Purchase Order Acknowledgment Files on page 774

Steps: Set Up Integration to Import EDI 856 Advance Ship Notices

Prerequisites
• Know the IP address for the external vendor endpoint.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 755

Context
You can create an integration to import advance ship notices (ASNs) in the American Standards
Committee (ASC) X12 856 EDI format.

Steps
1. Access the Edit Tenant Setup - Financials task.
In the Business Document Sequence IDs section, create or select an ID generator from the ID
Generator for Advanced Ship Notice prompt.
In the Procurement Options section, select the Enable Advanced Ship Notices check box.
Security: Set Up: Tenant Setup - Financials domain in the System functional area.
2. Access the Maintain Units of Measure task.
Set up units of measure for EDI using the X12 standards. Enter the units of measure that you want to
use for EDI 856 transactions in the EDI Code column.
Note: To avoid processing errors, enter all units of measure in the EDI Code column, even when
they’re the same as the UN CEFACT Common Code.
Security: Set Up: Unit of Measure domain in the Common Financial Management functional area.
3. Change Supplier Information.
For suppliers you expect to receive ASNs from, select the Enable ASN check box in the Procurement
Options. You can also enter when you expect to receive ASNs in the ASN Due in Days field.
4. Create Integration System on page 1854.
From the New Using Template prompt, select Advance Ship Notice EDI 856 Inbound.
5. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Enter the Interchange Sender ID provided by the supplier to import ASNs successfully. Workday
passes this value in the ISA06 segment of EDI 856 files. To ensure Workday maps this value
successfully, ensure that your suppliers set the ISA05 qualifier to ZZ in your EDI 856 file.
Security: Integration Build and Integration Configure domains in the Integration functional area.
6. Select Integration System > Configure Integration Maps as a related action on the integration
system.
Map values that you expect in the EDI 856 file to the equivalent data in Workday. As you configure the
mappings, consider:

Map Description
Company Mapping EDI File Map this value to avoid processing errors.
The External Value that you specify for the
selected company must match the GS03 and
ISA08 segments in the EDI 856 file.

Supplier Mapping EDI File Map this value when the selected supplier in
Workday doesn't have a DUNS number that
matches the GS02 segment on the EDI 856 file.
When you haven't added a DUNS number on the
supplier profile, update the supplier to add it or
enter the DUNS number in the External Value.

7. Create Integration Business Process on page 1838.


8. Set Up Integration Retrieval on page 1845.
Configure document retrieval to import EDI 856 files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 756

9. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
From the related actions menu of the ISU, select Security Profile > Assign Integration System
Groups.
See: Steps: Grant Integration or External Endpoint Access to Workday
10.(Optional) Edit Business Processes.
Configure the Advanced Ship Notice Event business process. To create receipts automatically when
you receive ASNs, add the Initiate Receipt Events from Advanced Ship Notice service step.
11.(Optional) Create Integration Notifications on page 30.
Workday recommends that you set up notifications to inform appropriate security groups or users when
your integration completes with these statuses:
• Completed With Warnings
• Completed With Errors
12.Launch an Integration on page 23.

Result
When suppliers send ASNs, Workday imports the file and records the data. When you've configured the
Advanced Ship Notice Event business process, Workday can create receipts automatically to reduce
workload on the dock.
When suppliers send ASNs with a zero quantity for the purchase order line, Workday doesn't create
receipts associated with the purchase order. For just-in-time requisition types, you can access the
Schedule Purchase Order Close Lines for Receiving task and select the Restrict to PO Lines with
zero shipped quantities check box. When you select this option, Workday only includes purchase order
lines that have zero quantity ASNs in the close for receiving updates.
Related Information
Reference
Reference: Valid Element Codes for Inbound EDI 856 Files on page 778

Steps: Configure the Procure-to-Pay Integrations Work Area

Prerequisites
Set up inbound integrations in Workday for:
• EDI 810 (Supplier Invoices)
• EDI 855 (Purchase Order Acknowledgements)
• EDI 856 (Advance Shipment Notices)

Context
You can configure an integrations work area for workers to view all integration errors in 1 place. This
provides visibility on inbound EDI integration errors for purchase order acknowledgements (POAs),
advance shipment notices (ASNs), and supplier invoices.

Steps
1. Access the Process: Procurement Integration Work Area - View domain and configure the security
policy.
Add user groups to give workers access to the Procurement Integrations Work Area task.
2. Access the Procure to Pay Integrations Work Area task.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 757

3. Access the Overview tab to view the status and error log of failed EDI 810, 855, and 856 integration
events.
As you review the tab, consider:

Column Description
Request Displays the integration request Workday object.
Files with Error Displays the number of files that contain errors
and aren't processed.
Log File Displays a link to the HTML integration error log
file.
4. Access the Work Area tab to view each integration error with the document details of the integration
runs:
The Work Area tab information is currently only available for EDI 855 and 856 integration events.

Column Descriptions
Request The integration event. Displays integration run
details such as process history and run time.
Interchange Control Number The control number assigned by the interchange
sender from the ISA13 segment in the EDI file.
Supplier Acknowledgement Number (POA The acknowledgement number that the supplier
only) sends from the BAK08 segment in the EDI file.
EDI Purchase Order The purchase order number in the EDI file.
Purchase Order The matched Workday purchase order.
Buyer The buyer on the matched Workday purchase
order.
EDI Supplier The supplier reference from the supplier in the
EDI file.
Supplier The supplier on the matched Workday purchase
order.
Reference ID (POA Only) The order number reference from the REF02
segment in the 855 EDI file.
Shipment ID (ASN Only) The shipment identification from the BSN02
segment in the 856 EDI file.
Shipment Date (ASN Only) The shipment date value from the BSN03
segment in the 856 EDI file.
Error Message The Workday application error triggered during file
processing.
Lines The number of purchase order lines associated
with the failed integration event. Displays the
matched purchase order line details and errors
associated with the line.
File Names The names of the EDI files processed by the
integration event.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 758

Concept: EDI Supplier Integrations


EDI supplier integrations send and receive EDI 810, 850, 855, and 856 files to and from Workday.
Workday provides these integration templates to support different EDI file formats:

Integration Template Description


Purchase Order EDI 850 Outbound Exports purchase orders in the American Standards
Committee (ASC) X12 850 EDI format.
Supplier Invoice EDI 810 Inbound Imports supplier invoices in the American
Standards Committee (ASC) X12 810 EDI format.
Advance Ship Notice EDI 856 Inbound Imports advance ship notices in the American
Standards Committee (ASC) X12 856 EDI format.
Purchase Order Acknowledgment EDI 855 Inbound Imports purchase order acknowledgements in the
American Standards Committee (ASC) X12 855
EDI format.

Launch/Schedule Options
Workday provides these launch schedule options for the Bank Statement Load integrations:
• Launch with an Integration step on a business process.
• Launch by schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration sends or retrieves any files to or from the endpoint.
• Launch immediately. You can launch the integration manually.
Related Information
Tasks
The Next Level: Spend Management EDI Integrations: A Comprehensive Mini Series

Concept: EDI Connector Pre and Postprocessor Common Use Cases


Workday delivers standards-based EDI connectors for these transaction sets:
• Purchase Order - 850
• Purchase Order Acknowledgment - 855
• Advance Ship Notice - 856
• Supplier Invoice - 810
While they're based on published standards, Workday EDI connectors can't anticipate all possible data
variations transmitted in EDI documents:
• Customers sometimes have unique EDI requirements that don't strictly adhere to EDI standards.
• Suppliers sometimes transmit segment data that Workday EDI connectors are unable to process.
• Workday might need to enhance or remove data as a result of the customers tenant configuration.
When inbound or outbound document data deviates from Workday EDI connector standards, customers
should ask these questions:
• Is this deviation specific to a single supplier?
• Does the requirement adhere to EDI standards?
• Is there an alternative way to consume or produce the inbound or outbound data?
Working directly with the supplier on potential changes is often the fastest, most effective solution
to proper EDI processing. If the supplier is unable to assist, you should work with their EDI partner.
Research potential solutions you need to provide to alter the raw data before transmitting it to its final
destination. When working with the supplier and the EDI partner can't provide a solution, a custom pre and
postprocessor integration must be build in Workday Studio.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 759

Reference: EDI Connector Pre and Postprocessor Common Use Cases


Common use cases found in deployments that result in the need for a custom pre or postprocessor
integration:

Purchase Order - 850

Pre Post
Update the N102 segment where N101 is BT to
provide a single company name on orders.
Update the GS values to support additional values
such as with GHX Metatrade.
Suppress ^LT^ in the PO1 line on Consignment
POs if the next segment is blank.
Suppress the spaces in the PER^SR^ ~ and
PER^1F^ ~ on Consignment POs when the
Procedure Information is blank.
Update additional fields to support shipment
methods.

Purchase Order Acknowledgment - 855

Pre Post
All BAK01 codes received from a supplier, except:
• 01
• 04
• 06
• 44

Supplier sends in multiple ACK segments for a


single line on a Purchase Order in the same file.
Validate the Supplier GS ID on the 855 with the
Supplier GS ID on the Purchase Order.

Advance Ship Notice - 856

Pre Post
Close lines for receiving that are short-shipped from
the supplier and won't be fulfilled.

Supplier Invoice - 810

Pre Post
Purchase Order Line number validation. Process 810 files that the preprocessor has
updated.
Credit Memo Support - Removal of Purchase Order Ensure that the correct tax option is in use and, if
reference (BIG04) and replacing negative amounts applicable, correct taxable amount.
(TDS01) with absolute value.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 760

Pre Post
Remove the ITD Line to enable payment terms to
populate from purchase order.
Validation of the Supplier Catalog Number from the
IT1 matching the associated purchase order line
value.
Validate the Supplier on the invoice matches the
Supplier on the purchase order.
Remove ^91^Customer Acct Number when
included after N1^ST.
Populate Spend Category and, if applicable, Item
on:
• Non-Purchase Order Invoices.
• Purchase Order Invoices that include a line that
isn't on the Purchase Order.
Map these to a valid instance in Workday from the
810 Integration Mapping setup.

Reference: Valid Element Codes for Inbound EDI 810 Files


Integrations based on the Supplier Invoice EDI 810 Inbound integration template can import files in the
EDI 810 file format. The EDI 810 integration supports these codes for the corresponding segment/element
pairs:

Segment Names Segment Codes/ Code/Qualifiers Workday Fields or


Element Names (Definitions) Comments
ISA Interchange Control ISA05 Interchange ID ZZ (Mutually Defined) Not applicable.
Header Qualifier
ISA Interchange Control ISA06 Interchange Sender ID Not applicable.
Header Sender
ISA Interchange Control ISA07 Interchange ID 01 (Company DUNS Not applicable.
Header Qualifier Number)
ZZ (Mutually Defined)

ISA Interchange Control ISA08 Interchange Provider DUNS Company


Header Receiver ID
ISA Interchange Control ISA13 Interchange Batch Counter Not applicable.
Header Control Number
GS Functional Group GS01 Functional IN (Supplier Invoice 810) Not applicable.
Header Identifier Code
GS Functional Group GS02 Application Supplier Alternate Supplier
Header Senders Code Name with Usage EDI
Integration Name, or
Supplier Alternate Name
with Usage Connection
Integration Name, or
Supplier DUNS Number.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 761

Segment Names Segment Codes/ Code/Qualifiers Workday Fields or


Element Names (Definitions) Comments
GS Functional Group GS03 Application Provider DUNS Number Company
Header Receivers Code
ST Transaction Set ST01 Transaction Set 810 (Invoice) Not applicable.
Header Header
NTE Note/ Special NTE01 Note Reference INV (Invoice Instruction) Not applicable.
Instruction Code
NTE Note/ Special NTE02 Description Free form text. Use this field for the
Instruction Memo. If your memo
is greater than 80
characters, you can
have multiple NTE
segments which
Workday will combine
into the memo field.
BIG Beginning Segment BIG01 Invoice Date Derived from file or Invoice Date
for Invoice automatically populates
the current Date.
BIG Beginning Segment BIG02 Invoice Number Not applicable. External Supplier
for Invoice Reference
If you use the Invoice
number in Workday as
a unique sequence, the
number will get stored
in External Supplier
Reference.

BIG Beginning Segment BIG04 Purchase Order Not applicable. Purchase Order Number
for Invoice Number
BIG Beginning Segment BIG07 Transaction Type Use DI, PR, or CI for Not applicable.
for Invoice Code standard invoices.
DM (Debit Memo)
CR (Credit Memo)

REF Reference REF01 Reference OI (Original Invoice Not applicable.


Numbers Number Qualifier Number)

REF Reference REF02 Reference Not applicable. Reference Invoice


Numbers Number
REF Reference REF01 Description CT (Buyer Contract Not applicable.
Numbers Number)
REF Reference REF02 Reference Not applicable. Supplier Contract
Numbers Number
REF Reference REF01 Reference ZZ (Mutually Defined. Not applicable.
Numbers Number Qualifier Used for Adjustment
Reason)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 762

Segment Names Segment Codes/ Code/Qualifiers Workday Fields or


Element Names (Definitions) Comments
REF Reference REF02 Reference Not applicable. Adjustment Reason
Numbers Number
REF Reference REF01 Reference CA (Cost Allocation Not applicable.
Numbers Number Qualifier Reference)
REF Reference REF03 Description Not applicable. Worktags
Numbers
REF Reference REF01 Reference CAT (Category Identifier) Not applicable.
Numbers Number Qualifier
ZZ (Mutually Defined)

REF Reference REF02 Description Not applicable. Spend Category


Numbers
N1 Selling Party N101 Early Identifier SE (Selling Party) Not applicable.
Code
VN (Selling Party -
Vendor)
SU (Selling Party -
Supplier)
II (Selling Party - Issuer
of Invoice)

N1 Selling Party N103 Identification Code 1 (Duns Number) Not applicable.


Qualifier
91 (Customer Account
Number)
ZZ (Mutually Defined)

N1 Selling Party N104 Identification Code Not applicable. Supplier


N1 Buying Party N101 Early Identifier BY (Buying Party) Not applicable.
Code
SO (Sold to)

N1 Buying Party N103 Identification Code 01 (DUNS Number) Not applicable.


Qualifier
ZZ (Mutually Defined)

N1 Buying Party N104 Identification Code Not applicable. Company


N1 Ship To N101 Early Identifier ST (Ship to) Not applicable.
Code
BT (Bill to)

N1 Ship To N103 Identification Code 91 (Assigned by Seller) Not applicable.


Qualifier
UN (GLN)
ZZ (Mutually Defined)

N1 Ship To N104 Identification Code Not applicable. Ship To


N1 Remit to Connection N101 Early Identifier RI (Remit To) Not applicable.
Code
RE (Party Receiving
Remittance)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 763

Segment Names Segment Codes/ Code/Qualifiers Workday Fields or


Element Names (Definitions) Comments
N1 Remit to Connection N103 Identification Code ZZ (Mutually Defined) Not applicable.
Qualifier
N1 Remit to Connection N104 Identification Code Not applicable. Remit-To-Connection
ITD Terms of Sale / ITD03 Terms Discount Early payment discount Not applicable.
Deferred Terms of Sale Percentage percentage.
ITD Terms of Sale / ITD05 Terms Discount Number of days in Not applicable.
Deferred Terms of Sale Days Terms Discount Period
until payment is due.
Use the number of days
if the party earns the
discount (up to 30 days).
ITD Terms of Sale / ITD07 Terms Net Days Number of days until Not applicable.
Deferred Terms of Sale total invoice amount
is due (discount not
applicable) from Invoice
Received date.
CUR Currency CUR01 Early Identifier SE (Selling Party) Not applicable.
Code
CUR Currency CUR02 Name Not applicable. Currency
N9 Extended Reference N901 Qualifier URL URL (Qualifier) N9 loop contains N9 and
Information MSG segment.
MSG Message Text MSG01 Free-Form URL MSG segment with URL
Message Text contained in N9 loop.
N9 Extended Reference N902 Reference Value for image. Document Link
Information Identification
IT1 Invoice Baseline IT101 Assigned PO Line Number PO Line Number
Item Data Identification
IT1 Invoice Baseline IT102 Quantity Invoiced Any positive number. Quantity
Item Data
IT1 Invoice Baseline IT103 Unit of Not applicable. Unit of Measure
Item Data Measurement Code
IT1 Invoice Baseline IT104 Unit Price Any positive number. Unit Price
Item Data
PID Product Item/ PID01 Item Description F (Free Form) Not applicable.
Description Type
PID Product Item/ PID05 Description Not applicable. Item Description
Description
TDS Total Monetary TDS01 Total Amount of Value of Invoice Total Invoice Amount
Value Summary Invoice
TXI Tax Information TXI01 Tax Information TX (All Taxes) Not applicable.
TXI Tax Information TX102 Monetary Not applicable. Tax amount

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 764

Segment Names Segment Codes/ Code/Qualifiers Workday Fields or


Element Names (Definitions) Comments
SAC Service, Promotion, SAC01 Allowance C (Charge) Not applicable.
Allowance, or Change Change Indicator
Information
SAC Service, Promotion, SAC02 Service Freight: Not applicable.
Allowance, or Change Promotion Allowance or
• C030
Information Charge Information
• D240
• D540
• F050
• G740
• G830
• I250
Other Charges:
• A010
• B090
• C040
• C310
• C510
• D270
• D500
• F155
• F800
• G821
• G970
• H090
• H550
• H850
• I590
• AFEE
ZZZZ (Mutually Defined)

SAC Service, Promotion, SAC05 Total Amount of Freight: Freight Amount


Allowance, or Change Allowance or Change
• C030 Other Charges
Information
• D240
• D540
• F050
• G740
• G830
• I250
Other Charges:
• A010
• B090
• C040
• C310
• C510
• D270

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 765

Segment Names Segment Codes/ Code/Qualifiers Workday Fields or


Element Names (Definitions) Comments
• D500
• F155
• F800
• G821
• G970
• H090
• H550
• H850
• I590
• AFEE
ZZZZ (Mutually Defined)

Reference: Valid Element Codes for Outbound EDI 850 Files


The outbound EDI 850 file supports these codes for the corresponding segment/element pairs:

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
ISA Interchange Control ISA01 Authorization Not applicable. Not applicable.
Header Information Qualifier
ISA Interchange Control ISA02 Authorization If ISA01 is 00, Workday Not applicable.
Header Information leaves this code blank
(10 Spaces).
ISA Interchange Control ISA03 Security Not applicable. Not applicable.
Header Information Qualifier
ISA Interchange Control ISA04 Security If ISA01 is 00, leave this Not applicable.
Header Information code blank (10 Spaces).
ISA Interchange Control ISA05 Interchange ID ZZ (Mutually Defined) Not applicable.
Header Qualifier
ISA Interchange Control ISA06 Interchange Company DUNS number Company Identifier
Header Sender ID
ISA Interchange Control ISA07 Interchange ID 01 (Company DUNS Not applicable.
Header Qualifier Number)
ZZ (Mutually Defined)

ISA Interchange Control ISA08 Interchange Configured as an Not applicable.


Header Receiver ID integration attribute on
integration system.
Company DUNS
Number.

ISA Interchange Control ISA09 Interchange Date Definition Transmission Date


Header
ISA Interchange Control ISA10 Interchange Time 24 Hours Transmission Time
Header

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 766

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
ISA Interchange Control ISA11 Repetition U Not applicable.
Header Separator
ISA Interchange Control ISA12 Interchange 401 Not applicable.
Header Control Reference
Number
ISA Interchange Control ISA13 Interchange Counter. Not applicable.
Header Control Number
ISA Interchange Control ISA14 Acknowledgment 0 (False) Not applicable.
Header Requested
1 (True)

ISA Interchange Control ISA15 Interchange Use P (Prod) Environment


Header Indicator
T (Test)
I (Info)

ISA Interchange Control ISA16 Component Not applicable. |


Header Element Separator
GS Functional Group GS01 Functional PO (Purchase Order) Not applicable.
Header Identifier Code
GS Functional Group GS02 Application Configured as an Sender Trading Partner
Header Senders Code integration attribute on ID can come from these
INTSYS configurations:
Company DUNS
Number when you
set up Company as a
customer account.
Sender_ID from
INTSYS.

GS Functional Group GS03 Application Configured as an Receiver Trading


Header Receivers Code integration attribute on Partner ID can
INTSYS come from these
configurations:
Order from Connection
Alternate Name with
Connection Integration
Name usage.
Supplier Alternate
Name with EDI
Integration Name
usage.
Supplier DUNS
number.
Receiver_ID from
INTSYS.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 767

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
GS Functional Group GS04 Date CCYYMMDD Transmission Date
Header
GS Functional Group GS05 Time Not applicable. Transmission Time
Header
GS Functional Group GS06 Group Control Not applicable. Counter
Header Header
GS Functional Group GS07 Responsible Not applicable. X
Header Agency Code
GS Functional Group GS08 Version/ Release/ Not applicable. 401
Header Industry Identifier Code
ST Transaction Set ST01 Transaction Set Not applicable. 850
Header Identifier Code
ST Transaction Set ST02 Transaction Set Counter Increment of the Counter
Header Control Number ST-SE groups.
BEG Beginning Segment BEG01 Transaction Set 00 (New Order) Not applicable.
for Purchase Order Purpose Code
BEG Beginning Segment BEG02 Purchase Order SA (Stand-alone Order) Not applicable.
for Purchase Order Type Code
BEG Beginning Segment BEG03 Purchase Order Not applicable. Purchase Order
for Purchase Order Number
BEG Beginning Segment BEG04 Release Number Zero (We don't change PO Version
for Purchase Order order in this document.)
BEG Beginning Segment BEG05 Date Date format is PO Date
for Purchase Order CCYYMMDD.
BEG Beginning Segment BEG06 Contact Number Not applicable. Contract Number
for Purchase Order
CUR Currency CUR01 Early Identifier Not applicable. VN
Code
CUR Currency CUR02 Currency Code VN (Vendor) Currency
CUR Currency CUR03 Exchange Rate The exchange rate is a 0001
1:1 ratio, and there's no
current rate field in the
purchase order.
REF Reference REF01 Reference If this code isn't The field depends on
Numbers Identification Qualifier available, don't print the the code sent to the
segment. supplier; contract CT
or RFQ is greater than
RFQ KT.
REF Reference REF02 Reference Not applicable. Workday Contract/
Numbers Identification Request
PER Administrative PER01 BD None
Communication Contact
RQ

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 768

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
PER Administrative PER02 Buyer Name BD is Bill-To Contact
Communication Contact
Requestor RQ Ship-To Contact

DTM Date/Time DTM01 Date/Time Not applicable. 004


Reference Qualifier
DTM Date/Time DTM02 Date Not applicable. Document Date
Reference
N1 Selling Party N101 Entity Identifier ST (Ship To) ST
Code
N1 Selling Party N102 Name Not applicable. Company Location
Name
N1 Selling Party N103 Identification Code Use PO header ship-to Use qualifier 91 if
Qualifier location information Location Customer
Account exists.
Otherwise, don't use it.
N1 Selling Party N104 Identification Code Populate only if data is If N103 is 91, then
available. N104 is the Location
Customer Account
Number or Customer
Account Number from
the supplier profile.
Otherwise, don't use it.
N9 Reference N901 Reference L1 (Letters or Notes) L1
Identification Identification Qualifier
N9 Reference N902 Reference Not applicable. Not applicable.
Identification Identification
N9 Reference N903 Free-Form This segment is a Add a header comment.
Identification Description mandatory part of the If empty, use the ID of
generic EDI file compiler. the Purchase Order.
N9 Reference N904 Date Not applicable. Not applicable.
Identification
N9 Reference N905 Time Not applicable. Not applicable.
Identification
PO1 Baseline Item Data PO101 Assigned Not applicable. Line Number
Identification
PO1 Baseline Item Data PO102 Quantity Ordered Not applicable. Quantity Ordered

PO1 Baseline Item Data PO103 Unit or Basis for Unit Of Measurement Unit of Measure
Measurement Code
PO1 Baseline Item Data PO104 Unit Price Not applicable. Unit Cost

PO1 Baseline Item Data PO105 Product/Service AB (Pay) Not applicable.


ID Qualifier

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 769

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
PO1 Baseline Item Data PO106 Product/Service VC (Vendor Catalog Not applicable.
ID Number)
Item Number

PO1 Baseline Item Data PO107 Product/Service PID Workday uses Spend
ID Qualifier Category if the Goods
and Services field isn't
available.
Purchase Order Line
Supplier Item Identifier
Purchase Item
Identifier
Purchase Item Name

PO1 Baseline Item Data PO108 Product/Service GTS Item Attribute


ID Configured
PO1 Loop Baseline Item PO1: CO (CAS Number) Workday won't send this
Data segment if it doesn't find
• 10 UK (GTIN)
data.
• 12 HC (HCPS)
• 14 The Item Identifier
• 16 MF (Manufacturer) Type name must match
the Universal Item
• 18 MG (Manufacturer #)
Identifier.
PO1: MN (Model Number)
Item Attribute
• 20 UX (UPN) Configured
• 22 LT (Lot Number)
• 24
SN (Serial Number)
Product/Service ID
Qualifier IN (Item Identifier)

PO1 Loop Baseline Item PO113 Product/Service Not applicable. Purchase Item
Data ID Identifier
PO1 Loop Baseline Item PO109 Not applicable. Item Attribute Value
Data
PO1:
• 15
• 17
• 19
PO1:
• 21
• 23
• 25
Produce/Service ID

PID Product Item/ PID01 Item Description F (Free Form) Not applicable.
Description Type

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 770

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
PID Product Item/ PID05 Description Use Spend Category Not applicable.
Description for items without a
description.
SDQ Destination SDQ01 WD Not applicable.
Quantity
SDQ Destination SDQ02 Identification GL Not applicable.
Quantity Code Qualifier
Workday uses qualifier
UL if location GLN
exists. If not, Workday
uses qualifier 92 for
Customer Account
number.

SDQ Destination SDQ03 Identification GLN If SDQ02 is 92, then


Quantity Code SDQ03 is the Location
If SDQ02 is UL, then
SDQ03 is GLN. Customer Account
Number if found;
otherwise use Customer
Account Number from
the supplier profile.

SDQ Destination SDQ Not applicable. For SDQ04, use


Quantity Quantity.
• 04
• 06
• 08
• 10
• 12
• 14
• 16
• 18
• 20
• 22
Quantity

SDQ Destination SDQ Not applicable. Workday won't send this


Quantity segment if it doesn't find
• 05
data.
• 07
• 09
• 11
• 13
• 15
• 17
• 19
• 21
Identification Code

TD5 Carrier Details TD502 Identification Not applicable. Not applicable.


Code Qualifier

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 771

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
TD5 Carrier Details TD503 Identification Not applicable. Not applicable.
Code
TD5 Carrier Details TD505 Routing Not applicable. Not applicable.
MSG Message Text MSG01 Free Form Text Not applicable. Only use Line Memo.
Message
N1 Selling Party N101 Entity Identifier You can loop these ST
Code segments as ST (Ship
To) or BT (Bill To).

N1 Selling Party N102 Name Not applicable. Company Location


Name
N1 Selling Party N103 Identification Code Use PO line location Use qualifier 91 if
Qualifier information Location Customer
Account exists.
Otherwise, don't use it.
N1 Selling Party N104 Identification Code Populate only if data is If N103 is 91, then
available. N104 is the Location
Customer Account
Number or Customer
Account Number from
the supplier profile.
Otherwise don't use it.
N2 Additional Name N201 Name Use this field as a 35+ Name Continuation
Information continuation of name 1. of Ship to Contact Detail.
N2 Additional Name N202 Name Use this field as a Continuation of N1.
Information continuation of name 1.
N3 Address Information N301 Address Ship To Address - Copy Ship To Street Address
Information the information from the
Purchase Order.
N3 Address Information N302 Address Ship To Address - Copy Continuation Street
Information the information from the Address
Purchase Order.
N4 Geographic Location N401 City Name Ship To Address - Copy Ship
the information from the
Purchase Order.
N4 Geographic Location N402 State or Province Ship To Address - Copy Ship To Province/State
Code the information from the
Purchase Order.
N4 Geographic Location N403 Postal Code Ship To Address - Copy Ship to Postal Code
the information from the
Purchase Order.
N4 Geographic Location N404 Country Code 3 character country code Ship to Country Code
PER Administrative PER01 Contact Function Not applicable. AR
Communications Code
Contact

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 772

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
PER Administrative PER02 Name Not applicable. Ship to Contact Detail
Communications
Contact
PER Administrative PER03 Communication We use the email first, EM
Communications Number Qualifier it can also be fax or
Contact telephone.
PER Administrative PER04 Communication Workday contact Work email of ship to
Communications Number information. contact.
Contact
If the contact information
for Workday isn't
available, use the
work phone number of
the buyer. If that isn't
available, use the phone
number of the company.

PER Administrative PER05 Communication Not applicable. TE


Communications Number Qualifier
Contact
PER Administrative PER06 Communication Workday contact Work phone of ship
Communications Number information. to contact on Worker
Contact Profile.
If the contact information
for Workday isn't
available, use the work
phone number of the
buyer. If that's not
available, use the phone
number of the company.

CTT Transaction Totals CTT01 Number of Line Not applicable. Number of Items
Items
CTT Transaction Totals CTT02 Hash Total PO Line Number Number of Quantities
AMT Monetary Amount AMT01 Amount Qualifier Any positive number. 1
Code
AMT Monetary Amount AMT02 Monetary Code 1 (Line Total Line Total Amount
Amount Amount).
SE Transaction Set SE01 Number of Not applicable. The count of Segments
Trailer Included Segments from ST to SE.
SE Transaction Set SE02 Transaction Set Segment Counter Use the Transaction
Trailer Control Number Control Number, the
number must be the
same as ST02.
GE Functional Group GE01 Number of Not applicable. The count of ST
Trailer Transaction Sets segments in GE.
Included

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 773

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
GE Functional Group GE02 Group Control Not applicable. Control Numbers of
Trailer Number GE.
IEA Interchange IEA01 Number of Not applicable. The count of GS
Controller Trailer Included Functional segments in ISA.
Groups
IEA Interchange IEA02 Interchange Not applicable. Control Number of IST.
Controller Trailer Control Number

Bill-Only Purchase Orders

Segment Name Segment Code and Value Comments or Workday Field


Element Name Codes
BEG Beginning Segment BEG02 Purchase Order CN (Consignment) Purchase Order Type
for Purchase Order Type Code
PO1 Loop Baseline Item PO1X Not applicable. Item Attribute
Data Configured
Product/Service ID
Qualifier

N9 Reference N901 CX (Consignment Not applicable.


Identification Classification ID)
N9 Reference N902 BO (Bill Only) Not applicable.
Identification
PO1 Loop Baseline Item PO1 LT (Lot) Lot Number
Data
Product/Service ID
Qualifier

PO1 Loop Baseline Item PO1 SN (Serial Number) Serial Number


Data
Product/Service ID
Qualifier

PO1 Loop Baseline Item DTM 456 Procedure Date


Data
Date/Time Qualifier

PO1 Loop Baseline Item PER01 1F Physician


Data
Qualifier

PO1 Loop Baseline Item REF01 EA Medical Record


Data Number
Qualifier

PO1 Loop Baseline Item PER01 SR Supplier


Data Representative
Qualifier

PO1 Loop Baseline Item REF01 3H Procedure Date


Data
Qualifier

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 774

Reference: Valid Element Codes for EDI 855 Purchase Order Acknowledgment Files
Integrations based on the Purchase Order Acknowledgment EDI 855 Inbound integration template can
import files in the EDI 855 file format. The EDI 855 integration supports these codes for the corresponding
segment / element pairs:

Segment Name Segment Code and Code (Definition) Workday Field


Element Name
ST Transaction Set ST01 Transaction Set 855 Not applicable.
Header Identifier Code
BAK Beginning of POA BAK01 Transaction Set 01 (Cancellation) Not applicable.
Purpose Code
06 (Confirmation)

BAK Beginning of POA BAK02 Acknowledgment The normalized element Acknowledgment Type
Type Code status follows these
code definitions:
AC (Acknowledge - With
Detail and Change) -
Partially Acknowledged
AD (Acknowledge - With
Detail, No Change) -
Accepted
AE (Acknowledge -
Hold Status) - Partially
Acknowledged
AH (Acknowledge - With
Exception Detail Only) -
Partially Acknowledged
AK (Acknowledge -
No Detail or Change) -
Accepted
AP (Acknowledge -
Product Replenishment)
- Accepted
AT (Accepted) -
Accepted
NA (No
Acknowledgment
Needed)
RD (Rejected with
Detail) - Rejected
RF (Reject with
exception only) -
Rejected
RJ (Rejected - No Detail)
- Rejected
RN (Rejected - Not as
Agreed) - Rejected

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 775

Segment Name Segment Code and Code (Definition) Workday Field


Element Name
RO (Rejected with Offer)
- Rejected
RV (Rejected - Violates
Industry Practices) -
Rejected
ZZ (Mutually Defined)
BAK Beginning of POA BAK03 Purchase Order Not applicable. PO Number
Number
BAK Beginning of POA BAK08 Reference Seller order number Supplier
Identification Acknowledgment
Number
Each POA must have a
unique number.

BAK Beginning of POA BAK09 Date Not applicable. POA Document Date
MSG Message Text MSG01 Free-Form Not applicable. Memo
Message Text
PO1 Baseline Item Data PO101 Assigned Not applicable. Line Number
Identification
PO1 Baseline Item Data PO102 Quantity Ordered Number Quantity Ordered
PO1 Baseline Item Data PO103 Unit or Basis for Not applicable. Unit of Measure
Measurement Code
PO1 Baseline Item Data PO104 Unit Price Not applicable. Not Applicable
PO1 Baseline Item Data PO106 Product/Service CO (CAS Number) AIID Type
ID Qualifier
HC (HCPCS)
MF (Manufacturer)
MG (Part Number of
Manufacturer)
MN (Model Number)
UK (GTIN-14)
UX (UPN)
VN (Item Number of
Vendor)
VP (Part Number of
Vendor) (Supplier
Identifier in Workday)

PO1 Baseline Item Data PO107 Produce Service Not applicable. AIID
ID
PID Product/Item PID05 Description Not applicable. Item Description
Description

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 776

Segment Name Segment Code and Code (Definition) Workday Field


Element Name
ACK Line Item ACK01 Line Item Status The normalized element Acknowledgment
Acknowledgment Code status follows these Status
code definitions and
uses the stored PO101
value:
AA (Item Accepted
- Order Forwarded
to Alternate Supplier
Location) - Accepted
AC (Item Accepted and
Shipped) - Accepted
AR (Item Accepted and
Released for Shipment) -
Accepted
BP (Item Accepted
- Partial Shipment,
Balance Backordered)
- Partial Quantity
Backordered
DR (Item Accepted -
Date Rescheduled) -
Accepted with Changes
IA (Item Accepted) -
Accepted
IB (Item Backordered) -
Fully Backordered
IC (Item Accepted
- Changes Made) -
Accepted with Changed
ID (Item Deleted) -
Rejected
IE (Item Accepted - Price
Pending) - Accepted with
Changes
IF (Item on Hold -
Incomplete Description) -
Rejected
IH (Item on Hold) -
Rejected
IP (Item Accepted - Price
Changed) Accepted with
Changes
IQ (Item Accepted -
Quantity Changed)
Accepted with Changes

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 777

Segment Name Segment Code and Code (Definition) Workday Field


Element Name
IR (Item Rejected) -
Rejected
IS (Item Accepted -
Substitution Made) -
Accepted with Changes
IW (Item on Hold -
Waiver Required) -
Rejected
R1 (Item Rejected -
Not a Contract Item) -
Rejected
R2 (Item Rejected -
Invalid Item Product
Number) - Rejected
R3 (Item Rejected -
Invalid Unit Issue) -
Rejected
R4 (Item Rejected
- Contract Item Not
Available) - Rejected
R5 (Item Rejected -
Reorder Item as a Just
In Time (JIT) Order) -
Rejected
R6 (Item Rejected -
Reorder Item as an
Extended Delivery
Order)(EDO) - Rejected
R7 (Item Rejected -
Reorder Item as a Drop
Shipment) - Rejected
R8 (Item Rejected -
Reorder Item as a Surge
Order) - Rejected
SP (Item Accepted -
Schedule Date Pending)
- Accepted

ACK Line Item MSG01 Free-Form Workday appends the Memo


Acknowledgment Message Text supplier status code
to the Memo value on
the purchase order
acknowledgment line in
the format EDI Status
Code: ACK01 Code.
ACK Line Item ACK02 Quantity The difference between Quantity
Acknowledgment this value and the value

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 778

Segment Name Segment Code and Code (Definition) Workday Field


Element Name
for PO102 determine
the acceptance status.
Applicable statuses are:
accepted, accepted
with changes, or fully or
partially backordered.

ACK Line Item ACK03 Unit or Basis for UOM Codes UOM
Acknowledgment Measurement Code
ACK Line Item ACK05 Date Not applicable. Date
Acknowledgment
ACK Line Item ACK07 Product / Service CO (CAS Number) AIID Type
Acknowledgment ID Qualifier
HC (HCPCS)
MF (Manufacturer)
MG (Part Number of
Manufacturer)
MN (Model Number)
UK (GTIN-14)
UX (UPN)
VC (Catalog Number of
Vendor)
VN (Item Number of
Vendor)
VP (Part Number of
Vendor) (Supplier Item
Identifier in Workday)

ACK Line Item ACK08 Product / Service AIID Code AIID


Acknowledgment ID

Reference: Valid Element Codes for Inbound EDI 856 Files


Integrations based on the Create Supplier Invoice from EDI File Template integration template can import
files in the EDI 856 file format. The EDI 856 integration supports these codes for the corresponding
segment/element pairs:

Segment Name Segment Code and Codes (Definition) or Workday Field


Element Name Derived Comments
ISA Interchange Control ISA01 Authorization 00 Not applicable.
Header Information Qualifier
Description
ISA Interchange Control ISA02 Authorization If ISA01 is 00, leave the Not applicable.
Header Information code blank (10 Spaces).
ISA Interchange Control ISA03 Security Not applicable. Not applicable.
Header Information Qualifier

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 779

Segment Name Segment Code and Codes (Definition) or Workday Field


Element Name Derived Comments
ISA Interchange Control ISA04 Security If ISA01 is 00, leave the Not applicable.
Header Information blank (10 Spaces).

ISA Interchange Control ISA05 Interchange ID ZZ (Mutually Defined) Not applicable.


Header Qualifier
ISA Interchange Control ISA06 Interchange Sender ID Trading Partner ID
Header Sender ID
ISA Interchange Control ISA07 Interchange ID 01 (Sender ID) Not applicable.
Header Qualifier
ZZ (Mutually Defined)

ISA Interchange Control ISA08 Interchange Not applicable. Not applicable.


Header Receiver ID
ISA Interchange Control ISA09 Interchange Date Not applicable. Not applicable.
Header
ISA Interchange Control ISA10 Interchange Time 24H Transmission Time
Header
ISA Interchange Control ISA11 Repetition Not applicable. Not applicable.
Header Separator
ISA Interchange Control ISA12 Interchange Not applicable. Not applicable.
Header Control Reference
Number
ISA Interchange Control ISA13 Interchange Not applicable. Not applicable.
Header Control Number
ISA Interchange Control ISA14 Acknowledgment 1 (True) Not applicable.
Header Requested
ISA Interchange Control ISA15 Interchange Use P (Production) Not applicable.
Header Indicator
T (Test Data)

ISA Interchange Control ISA16 Component Not applicable. Not applicable.


Header Element Separator
ST Transaction Set ST01 Transaction Set 856 Not applicable.
Header Identifier Code
ST Transaction Set ST02 Transaction Set Not applicable. Not applicable.
Header Identifier Code
BSN Beginning Segment BSN01 Transaction Set 00 Not applicable.
for Ship Notice Purpose Code
BSN Beginning Segment BSN02 Shipment Not applicable. Shipment Number
for Ship Notice Identification
BSN Beginning Segment BSN03 Date CCYYMMDD Shipping Date
for Ship Notice
BSN Beginning Segment BSN04 Time Not applicable. Shipping Time
for Ship Notice

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 780

Segment Name Segment Code and Codes (Definition) or Workday Field


Element Name Derived Comments
HL Hierarchical Level HL01 Hierarchical ID Not applicable. Not applicable.
Number
HL Hierarchical Level HL02 Hierarchical Not applicable. Not applicable.
Parent ID Number
HL Hierarchical Level HL03 Hierarchical Level S Not applicable.
Code
O
I

HL Hierarchical Level HL04 Hierarchical Child Not applicable. Not applicable.


Code
GS Functional Group GS01 Functional PO (Purchase Order) Purchase Order
Header Identifier Code
GS Functional Group GS02 Application Sender ID Sender Trading Partner
Header Senders Code ID
GS Functional Group GS03 Application Currently Same as Receiver Trading
Header Receivers Code ISA08 Partner ID
GS Functional Group GS04 Date CCYYMMDD Transmission Date
Header
GS Functional Group GS05 Time Not applicable. Transmission Time
Header
GS Functional Group GS06 Group Control Not applicable. Counter
Header Header
GS Functional Group GS07 Responsible Not applicable. X
Header Agency Code
GS Functional Group GS08 Version/ Release/ Not applicable. 401
Header Industry Identifier Code
PRF Purchase Order PRF01 Purchase Order Not applicable. Purchase Order
Reference Number Number
PRF Purchase Order PRF02 Release Number Not applicable. Change Order
Reference Reference
PRF Purchase Order PRF03 Date Not applicable. Not applicable.
Reference
SN1 Item Detail SN101 Assigned Customer Line Number Purchase Order Line
Identification
SN1 Item Detail SN102 Number of Units Line item Quantity Shipped Quantity
Shipped
SN1 Item Detail SN103 Unit or Basis for All codes valid. Shipped Unit of
Measurement Code Measure
SN1 Item Detail SN104 Quantity Shipped Not applicable. Not applicable.
to Date
SN1 Item Detail SN105 Quantity Ordered Not applicable. Not applicable.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 781

Segment Name Segment Code and Codes (Definition) or Workday Field


Element Name Derived Comments
SN1 Item Detail SN106 Unit or Basis Not applicable. Shipped Unit of
Measure
SN1 Item Detail SN108 Line Item Status IB (Item) - Backordered Not applicable.
Code
IC (Item Accepted) -
Changes Made
IS (Item Accepted) -
Substitutions Made

SLN Subline Item Detail SLN01 Assigned Not applicable. Not applicable.
Identification
SLN Subline Item Detail SLN03 Relationship Not applicable. Not applicable.
Code
SLN Subline Item Detail SLN04 Quantity Not applicable. Lot Quantity
SLN Subline Item Detail SLN05 Composite Unit Not applicable. Conversion Factor
of Measure
SLN Subline Item Detail SLN09 Product/ Service Not applicable. Not applicable.
ID Qualifier
SLN Subline Item Detail SLN010 Product/Service Not applicable. Lot Identifier
ID
TD4 Carrier Details TD401 Special Handling Not applicable. Not applicable.
(Special Handling or Code
Hazardous material)
CTT Transaction Totals CTT02 Hash Total Purchase Order Line Not applicable.
Number
CTT Transaction Totals CTT01 Number of Line Not applicable. Not applicable.
Items
TD5 Carrier Details TD503 Identification Not applicable. Not applicable.
Code
TD5 Carrier Details TD505 Routing Not applicable. Not applicable.
TD5 Carrier Details TD502 Identification Not applicable. Not applicable.
Code Qualifier
TD512 Carrier Details Service Level Code Not applicable. Not applicable.
SE Transaction Set SE02 Transaction Set Segment Counter Transaction Control
Trailer Control Number Number (Has to be the
same as ST02)
SE Transaction Set SE01 Number of Not applicable. Number of Segments
Trailer Included Segments from ST to SE
IEA Interchange IEA02 Interchange Not applicable. Control Number - IST
Controller Trailer Control Number
IEA Interchange IEA01 Number of Not applicable. How many GS are in
Controller Trailer Included Functional ISA
Groups

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 782

Segments with Relational Changes


The elements listed in this section map to different Workday fields based on the selected code:

DTM Date/Time DTM01 Date/Time 011 Not applicable.


Reference (Ship Date) Qualifier
DTM Date/Time DTM02 Date Not applicable. Shipment Date
Reference (Ship Date)
DTM Date/Time DTM01 Date/Time 094 Not applicable.
Reference (Manufacture Qualifier
Date)
DTM Date/Time DTM02 Date Not applicable. Manufacture Date
Reference (Manufacture
Date)
DTM Date/Time DTM01 Date/Time 046 Not applicable.
Reference (Expiration Qualifier
Date)
DTM Date/Time DTM02 Date Not applicable. Expiration Date
Reference (Expiration
Date)
N1 Selling Party N101 Identification Code ST Not applicable.
Qualifier
N1 Selling Party N103 Identification Code UL Not applicable.
Qualifier
N1 Selling Party N104 Identification Code Not applicable. Ship To Address
N1 Selling Party N101 Early Identifier DQ Not applicable.
Code
N1 Selling Party N103 Identification Code UL Not applicable.
Qualifier
N1 Selling Party N104 Identification Code Not applicable. Deliver To Address
N1 Selling Party N101 Early Identifier ST (Ship To) Not applicable.
Code
N1 Selling Party N103 Identification Code 91 Not applicable.
Qualifier
N1 Selling Party N104 Identification Code Not applicable. Customer Account
Number: Ship To
Address
N1 Selling Party N101 Early Identifier DQ (Deliver To) Not applicable.
Code
N1 Selling Party N103 Identification Code 91 Not applicable.
Qualifier
N1 Selling Party N104 Identification Code Not applicable. Customer Account
Number: Deliver To
Address
LIN Item Identification LIN01 Assigned Not applicable. Not applicable.
Identification

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 783

LIN Item Identification LIN02 Product/Service VN or VC Not applicable.


ID Qualifier
LIN Item Identification LIN03 Product/Service Not applicable. Supplier Part ID
ID
LIN Item Identification LIN04 Product/ Service VN or VC Not applicable.
ID Qualifier
LIN Item Identification LIN05 Produce/Service Not applicable. Supplier Part ID
ID
LIN Item Identification LIN06 Product/Service VN or VC Not applicable.
ID Qualifier
LIN Item Identification LIN07 Product/Service Not applicable. Supplier Part ID
ID
LIN Item Identification LIN01 Assigned Not applicable. Not applicable.
Identification
LIN Item Identification LIN02 Product/Service MF Not applicable.
ID Qualifier
LIN Item Identification LIN03 Product/Service Not applicable. Manufacturer
ID
LIN Item Identification LIN04 Product/ Service MF Not applicable.
ID Qualifier
LIN Item Identification LIN05 Produce/Service Not applicable. Manufacturer
ID
LIN Item Identification LIN06 Product/Service MF Not applicable.
ID Qualifier
LIN Item Identification LIN07 Product/Service Not applicable. Manufacturer
ID
REF Reference REF01 Reference BM Not applicable.
Numbers Identification Qualifier
REF Reference REF02 Reference Not applicable. Bill of Loading
Numbers Identification
REF Reference REF01 Reference CN Not applicable.
Numbers Identification Qualifier
REF Reference REF02 Reference Not applicable. Carrier Tracking
Numbers Identification Number
REF Reference REF01 Reference VN Not applicable.
Numbers Identification Qualifier
REF Reference REF02 Reference Not applicable. Supplier Order
Numbers Identification Reference
REF Reference REF01 Reference LV Not applicable.
Numbers Identification Qualifier
REF Reference REF02 Reference Not applicable. License Plate
Numbers Identification

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 784

REF Reference REF01 Reference PR Not applicable.


Numbers Identification Qualifier
REF Reference REF02 Reference Not applicable. Shipped Unit Cost
Numbers Identification
REF Reference REF01 Reference BN Not applicable.
Numbers Identification Qualifier
REF Reference REF02 Reference Not applicable. Purchase Order Line
Numbers Identification

Reference: Purchase Order Invoice cXML Schema


<?xml version="1.0" encoding="utf-8"?>
<cXML payloadID="0.81120190705093016624093016624.05@staples.com"
timestamp="2019-07-05T10:30:16-04:00">
<Header>XXXXX</Header>
<Request>
<InvoiceDetailRequest>
<InvoiceDetailRequestHeader invoiceID="3005027189"
purpose="standard"
operation="new"
invoiceDate="2019-07-05T09:30:16-04:00">
<InvoiceDetailHeaderIndicator/>
<InvoiceDetailLineIndicator isTaxInLine="yes" isShippingInLine="yes"
isAccountingInLine="yes"/>
<InvoicePartner>
<Contact role="remitTo" addressID="">
<Name xml:lang="en">Staples Business Advantage</Name>
<PostalAddress>
<Street>PO Box 111111</Street>
<City>Dallas</City>
<State>TX</State>
<PostalCode>75111</PostalCode>
<Country isoCountryCode="US">United States</Country>
</PostalAddress>
</Contact>
</InvoicePartner>
<InvoicePartner>
<Contact role="billTo">
<Name xml:lang="en">ABC INC</Name>
<PostalAddress>
<Street>1151 ENTERPRISE DR</Street>
<City>DALLAS</City>
<State>TX</State>
<PostalCode>75111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoicePartner>
<InvoicePartner>
<Contact role="from">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoicePartner>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 785

<InvoicePartner>
<Contact role="billFrom">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoicePartner>
<InvoicePartner>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en">ABC Resource</Name>
<PostalAddress>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoicePartner>
<InvoicePartner>
<Contact role="soldTo" addressID="ABCINC">
<Name xml:lang="en">ABC INC</Name>
<PostalAddress>
<Street>1151 ENTERPRISE DR</Street>
<City>DALLAS</City>
<State>TX</State>
<PostalCode>75111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoicePartner>
<InvoiceDetailPaymentTerm payInNumberOfDays="060"
percentageRate="0.0"/>
</InvoiceDetailRequestHeader>
<InvoiceDetailOrder>
<InvoiceDetailOrderInfo>
<OrderReference orderID="PO-00000267"/>
<OrderIDInfo orderID="PO-00000267"/>
</InvoiceDetailOrderInfo>
<InvoiceDetailItem invoiceLineNumber="1" quantity="0000004">
<UnitOfMeasure>CT</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">42.71</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="00001">
<ItemID>
<SupplierPartID>370145</SupplierPartID>
</ItemID>
<Description xml:lang="en">PURELL ADVANCED GREEN CERTIFIE</
Description>
</InvoiceDetailItemReference>
<SubtotalAmount>
<Money currency="USD">170.84</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">14.74</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="8.62">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 786

<TaxableAmount>
<Money currency="USD">170.84</Money>
</TaxableAmount>
<TaxAmount>
<Money currency="USD">14.74</Money>
</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>
</TaxDetail>
</Tax>
<InvoiceDetailLineShipping>
<InvoiceDetailShipping>
<Contact role="shipFrom" addressID="SPLS">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en-US">ABC INC</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoiceDetailShipping>
<Money currency="USD">0.0</Money>
</InvoiceDetailLineShipping>
<GrossAmount>
<Money currency="USD">185.58</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">185.58</Money>
</NetAmount>
</InvoiceDetailItem>
<InvoiceDetailItem invoiceLineNumber="2" quantity="0000005">
<UnitOfMeasure>CT</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">61.74</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="00002">
<ItemID>
<SupplierPartID>815614</SupplierPartID>
</ItemID>
<Description xml:lang="en">SCOTT ESSENTIAL HARDWOUND PAPE</
Description>
</InvoiceDetailItemReference>
<SubtotalAmount>
<Money currency="USD">308.70</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">26.62</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="8.62">
<TaxableAmount>
<Money currency="USD">308.70</Money>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 787

</TaxableAmount>
<TaxAmount>
<Money currency="USD">26.62</Money>
</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>
</TaxDetail>
</Tax>
<InvoiceDetailLineShipping>
<InvoiceDetailShipping>
<Contact role="shipFrom" addressID="SPLS">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</Contact>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en-US">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoiceDetailShipping>
<Money currency="USD">0.0</Money>
</InvoiceDetailLineShipping>
<GrossAmount>
<Money currency="USD">335.32</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">335.32</Money>
</NetAmount>
</InvoiceDetailItem>
<InvoiceDetailItem invoiceLineNumber="3" quantity="0000005">
<UnitOfMeasure>EA</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">2.32</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="00005">
<ItemID>
<SupplierPartID>395575</SupplierPartID>
</ItemID>
<Description xml:lang="en">CLOROX TOILET BOWL CLEANER WIT</
Description>
</InvoiceDetailItemReference>
<SubtotalAmount>
<Money currency="USD">11.60</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">1.00</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="8.62">
<TaxableAmount>
<Money currency="USD">11.60</Money>
</TaxableAmount>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 788

<TaxAmount>
<Money currency="USD">1.00</Money>
</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>
</TaxDetail>
</Tax>
<InvoiceDetailLineShipping>
<InvoiceDetailShipping>
<Contact role="shipFrom" addressID="SPLS">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</Contact>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en-US">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoiceDetailShipping>
<Money currency="USD">0.0</Money>
</InvoiceDetailLineShipping>
<GrossAmount>
<Money currency="USD">12.6</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">12.6</Money>
</NetAmount>
</InvoiceDetailItem>
<InvoiceDetailItem invoiceLineNumber="4" quantity="0000010">
<UnitOfMeasure>CT</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">19.18</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="00006">
<ItemID>
<SupplierPartID>365374</SupplierPartID>
</ItemID>
<Description xml:lang="en">BRIGHTON PROFESSIONAL MULTIFOL</
Description>
</InvoiceDetailItemReference>
<SubtotalAmount>
<Money currency="USD">191.80</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">16.54</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="8.62">
<TaxableAmount>
<Money currency="USD">191.80</Money>
</TaxableAmount>
<TaxAmount>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 789

<Money currency="USD">16.54</Money>
</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>
</TaxDetail>
</Tax>
<InvoiceDetailLineShipping>
<InvoiceDetailShipping>
<Contact role="shipFrom" addressID="SPLS">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</Contact>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en-US">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoiceDetailShipping>
<Money currency="USD">0.0</Money>
</InvoiceDetailLineShipping>
<GrossAmount>
<Money currency="USD">208.34</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">208.34</Money>
</NetAmount>
</InvoiceDetailItem>
<InvoiceDetailItem invoiceLineNumber="5" quantity="0000015">
<UnitOfMeasure>PK</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">5.24</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="00007">
<ItemID>
<SupplierPartID>787360</SupplierPartID>
</ItemID>
<Description xml:lang="en">GREEN WORKS COMPOSTABLE CLEANI</
Description>
</InvoiceDetailItemReference>
<SubtotalAmount>
<Money currency="USD">78.60</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">6.78</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="8.62">
<TaxableAmount>
<Money currency="USD">78.60</Money>
</TaxableAmount>
<TaxAmount>
<Money currency="USD">6.78</Money>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 790

</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>
</TaxDetail>
</Tax>
<InvoiceDetailLineShipping>
<InvoiceDetailShipping>
<Contact role="shipFrom" addressID="SPLS">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</Contact>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en-US">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</InvoiceDetailShipping>
<Money currency="USD">0.0</Money>
</InvoiceDetailLineShipping>
<GrossAmount>
<Money currency="USD">85.38</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">85.38</Money>
</NetAmount>
</InvoiceDetailItem>
<InvoiceDetailItem invoiceLineNumber="6" quantity="0000005">
<UnitOfMeasure>CT</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">20.14</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="00008">
<ItemID>
<SupplierPartID>920364</SupplierPartID>
</ItemID>
<Description xml:lang="en">BRIGHTON PROFESSIONAL PINK LOT</
Description>
</InvoiceDetailItemReference>
<SubtotalAmount>
<Money currency="USD">100.70</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">8.68</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="8.62">
<TaxableAmount>
<Money currency="USD">100.70</Money>
</TaxableAmount>
<TaxAmount>
<Money currency="USD">8.68</Money>
</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 791

</TaxDetail>
</Tax>
<InvoiceDetailLineShipping>
<InvoiceDetailShipping>
<Contact role="shipFrom" addressID="SPLS">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Framingham</City>
<State>MA</State>
<PostalCode>01702</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en-US">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoiceDetailShipping>
<Money currency="USD">0.0</Money>
</InvoiceDetailLineShipping>
<GrossAmount>
<Money currency="USD">109.38</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">109.38</Money>
</NetAmount>
</InvoiceDetailItem>
<InvoiceDetailItem invoiceLineNumber="7" quantity="0000010">
<UnitOfMeasure>CT</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">36.19</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="00010">
<ItemID>
<SupplierPartID>364374</SupplierPartID>
</ItemID>
<Description xml:lang="en">SCOTT ESSENTIAL 2-PLY JUMBO TO</
Description>
</InvoiceDetailItemReference>
<SubtotalAmount>
<Money currency="USD">361.90</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">31.22</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="8.62">
<TaxableAmount>
<Money currency="USD">361.90</Money>
</TaxableAmount>
<TaxAmount>
<Money currency="USD">31.22</Money>
</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>
</TaxDetail>
</Tax>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 792

<InvoiceDetailLineShipping>
<InvoiceDetailShipping>
<Contact role="shipFrom" addressID="SPLS">
<Name xml:lang="en">Staples Inc.</Name>
<PostalAddress>
<Street>500 Staples Dr</Street>
<City>Staples</City>
<State>MA</State>
<PostalCode>01111</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</Contact>
<Contact role="shipTo" addressID="20DFD4F7D239C11">
<Name xml:lang="en-US">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">USA</Country>
</PostalAddress>
</Contact>
</InvoiceDetailShipping>
<Money currency="USD">0.0</Money>
</InvoiceDetailLineShipping>
<GrossAmount>
<Money currency="USD">393.12</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">393.12</Money>
</NetAmount>
</InvoiceDetailItem>
</InvoiceDetailOrder>
<InvoiceDetailSummary>
<SubtotalAmount>
<Money currency="USD">1329.72</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">105.58</Money>
<Description xml:lang="en">Total Tax Invoice</Description>
<TaxDetail purpose="Local Sales Tax" category="Sales"
percentageRate="8.62">
<TaxableAmount>
<Money currency="USD">1224.14</Money>
</TaxableAmount>
<TaxAmount>
<Money currency="USD">105.58</Money>
</TaxAmount>
<TaxLocation xml:lang="en">OK</TaxLocation>
</TaxDetail>
</Tax>
<ShippingAmount>
<Money currency="USD">0.0</Money>
</ShippingAmount>
<GrossAmount>
<Money currency="USD">1329.72</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">1329.72</Money>
</NetAmount>
<DueAmount>
<Money currency="USD">1329.72</Money>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 793

</DueAmount>
</InvoiceDetailSummary>
</InvoiceDetailRequest>
</Request>
</cXML>

Reference: Purchase Order Invoice with Negative Amounts cXML Schema


<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd">
<cXML payloadID="wd-response_2020-11-12T12:30:17-0800"
xml:lang="en"
timestamp="2020-11-12T12:30:17-0800"
version="1.2.021">
<Header>
<From>
<Credential domain="NetworkID">
<Identity>STAPLESADVT</Identity>
</Credential>
<Credential domain="PrivateID">
<Identity>ISU_Staples_PO_Invoice_User@gms</Identity>
</Credential>
</From>
<To>
<Credential domain="NetworkID">
<Identity>GMS_US_501</Identity>
</Credential>
</To>
<Sender>
<Credential domain="NetworkID">
<Identity>ISU_Staples_PO_Invoice_User</Identity>
<SharedSecret>itssecret</SharedSecret>
</Credential>
<UserAgent>CatalogManager</UserAgent>
</Sender>
</Header>
<!-- Credentials -->
<Request deploymentMode="test">
<InvoiceDetailRequest>
<InvoiceDetailRequestHeader invoiceDate="2021-07-30T08:22:49-08:00"
invoiceID="INV-SN-9022"
invoiceOrigin="supplier" operation="new" purpose="standard">
<InvoiceDetailHeaderIndicator/>
<InvoiceDetailLineIndicator isTaxInLine="yes"/>
<InvoiceDetailPaymentTerm payInNumberOfDays="030"
percentageRate="0.01"/>
</InvoiceDetailRequestHeader>
<InvoiceDetailOrder>
<InvoiceDetailOrderInfo>
<OrderReference orderID="PO-3356"/>
<MasterAgreementReference/>
<OrderIDInfo orderID="PO-3356"/>
</InvoiceDetailOrderInfo>
<InvoiceDetailItem invoiceLineNumber="1" quantity="0000100">
<UnitOfMeasure>EA</UnitOfMeasure>
<UnitPrice>
<Money currency="USD">-5.39</Money>
</UnitPrice>
<InvoiceDetailItemReference lineNumber="1">
<ItemID>
<SupplierPartID>WRT039856</SupplierPartID>
</ItemID>
<Description xml:lang="en">Bagels</Description>
</InvoiceDetailItemReference>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 794

<SubtotalAmount>
<Money currency="USD">-539.00</Money>
</SubtotalAmount>
<Tax>
<Money currency="USD">-53.90</Money>
<Description xml:lang="en">Total Item Tax</Description>
<TaxDetail purpose="Local Sales Tax" category="sales"
percentageRate="10.0">
<TaxableAmount>
<Money currency="USD">-539.00</Money>
</TaxableAmount>
<TaxAmount>
<Money currency="USD">-53.90</Money>
</TaxAmount>
<TaxLocation xml:lang="en">IL</TaxLocation>
</TaxDetail>
</Tax>
<GrossAmount>
<Money currency="USD">-592.9</Money>
</GrossAmount>
<InvoiceDetailDiscount percentageRate="0.0">
<Money currency="USD">0.0</Money>
</InvoiceDetailDiscount>
<NetAmount>
<Money currency="USD">-592.9</Money>
</NetAmount>
</InvoiceDetailItem>
</InvoiceDetailOrder>
<InvoiceDetailSummary>
<SubtotalAmount>
<Money currency="USD">-592.90</Money>
</SubtotalAmount>
<ShippingAmount>
<Money currency="USD">0.0</Money>
</ShippingAmount>
<GrossAmount>
<Money currency="USD">-592.90</Money>
</GrossAmount>
<NetAmount>
<Money currency="USD">-592.90</Money>
</NetAmount>
<DueAmount>
<Money currency="USD">-592.90</Money>
</DueAmount>
</InvoiceDetailSummary>
</InvoiceDetailRequest>
</Request>
</cXML>

Reference: Purchase Order Issue cXML Schema


<?xml version="1.0" encoding="utf-8"?>
<cXML xml:lang="en"
timestamp="2019-07-25T15:11:41-07:00"
payloadID="030be92d12c201f8c40e18018b1b6ed8">
<Header>XXXXX</Header>
<Request deploymentMode="test">
<OrderRequest>
<OrderRequestHeader orderID="PO-00000531"
type="new"
orderDate="2019-07-25-07:00"
orderVersion="1">
<Total>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 795

<Money currency="USD">39329.2</Money>
</Total>
<ShipTo>
<Address addressID="5cca633ac6f7018622b2df6f62343613">
<Name xml:lang="en">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">United States of America</
Country>
</PostalAddress>
<Email/>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Phone>
<Fax>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Fax>
</Address>
<CarrierIdentifier domain="companyName"/>
<TransportInformation>
<ShippingInstructions>
<Description xml:lang="en"/>
</ShippingInstructions>
</TransportInformation>
</ShipTo>
<BillTo>
<Address addressID="183a30dc70380154c5698fff400eeb17">
<Name xml:lang="en">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>Joe Smith</DeliverTo>
<Street>P.O. Box 111111</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">United States of America</
Country>
</PostalAddress>
<Email/>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Phone>
<Fax>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Fax>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 796

</Address>
</BillTo>
<Contact addressID="5cca633ac6f7018622b2df6f62343613">
<Name xml:lang="en">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">United States of America</
Country>
</PostalAddress>
<Email/>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Phone>
<Fax>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Fax>
</Contact>
<Comments xml:lang="en"/>
<Extrinsic name="Document Retention Policy">180</Extrinsic>
</OrderRequestHeader>
<ItemOut quantity="10" lineNumber="1">
<ItemID>
<SupplierPartID>201318</SupplierPartID>
<SupplierPartAuxiliaryID/>
</ItemID>
<ItemDetail>
<UnitPrice>
<Money currency="USD">450.63</Money>
</UnitPrice>
<Description xml:lang="en">Flash Furniture Plush 42"H Leather
Rocker Recliner, Brown</Description>
<UnitOfMeasure>EA</UnitOfMeasure>
<Classification domain="UNSPSC">56112105</Classification>
<ManufacturerPartID>MENDSC01078BRN</ManufacturerPartID>
<ManufacturerName>Belnick, Inc.</ManufacturerName>
</ItemDetail>
<SupplierID domain="SupplierName">STAPLES BUS ADV DALL 2664</
SupplierID>
<SupplierID domain="SupplierID">SUP-001804</SupplierID>
<ShipTo>
<Address addressID="5cca633ac6f7018622b2df6f62343613">
<Name xml:lang="en">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<DeliverTo>LOC1001</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">United States of America</
Country>
</PostalAddress>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 797

<Email/>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Phone>
<Fax>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Fax>
</Address>
</ShipTo>
</ItemOut>
<ItemOut quantity="10" lineNumber="2">
<ItemID>
<SupplierPartID>126705</SupplierPartID>
<SupplierPartAuxiliaryID/>
</ItemID>
<ItemDetail>
<UnitPrice>
<Money currency="USD">509.28</Money>
</UnitPrice>
<Description xml:lang="en">Space Seating 63 Series Mesh Computer
&amp; Desk Big &amp; Tall Chair, Black (63-37A773HM)</Description>
<UnitOfMeasure>EA</UnitOfMeasure>
<Classification domain="UNSPSC">56112102</Classification>
<ManufacturerPartID>6337A773HM</ManufacturerPartID>
<ManufacturerName>OFFICE STAR PRODUCTS (NSP)</ManufacturerName>
</ItemDetail>
<SupplierID domain="SupplierName">STAPLES BUS ADV DALL 2664</
SupplierID>
<SupplierID domain="SupplierID">SUP-001804</SupplierID>
<ShipTo>
<Address addressID="5cca633ac6f7018622b2df6f62343613">
<Name xml:lang="en">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<DeliverTo>LOC1001</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">United States of America</
Country>
</PostalAddress>
<Email/>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Phone>
<Fax>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 798

</Fax>
</Address>
</ShipTo>
</ItemOut>
<ItemOut quantity="10" lineNumber="3">
<ItemID>
<SupplierPartID>1672881</SupplierPartID>
<SupplierPartAuxiliaryID/>
</ItemID>
<ItemDetail>
<UnitPrice>
<Money currency="USD">1767.19</Money>
</UnitPrice>
<Description xml:lang="en">Bush Business Furniture Westfield
Elite 72W L Shaped Desk with Hutch, Return and Storage, Hansen Cherry,
Installed(SRE130HCSUFA)</Description>
<UnitOfMeasure>EA</UnitOfMeasure>
<Classification domain="UNSPSC">56101703</Classification>
<ManufacturerPartID>SRE130HCSUFA</ManufacturerPartID>
<ManufacturerName>Bush Industries (White Glove)</
ManufacturerName>
</ItemDetail>
<SupplierID domain="SupplierName">STAPLES BUS ADV DALL 2664</
SupplierID>
<SupplierID domain="SupplierID">SUP-001804</SupplierID>
<ShipTo>
<Address addressID="5cca633ac6f7018622b2df6f62343613">
<Name xml:lang="en">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<DeliverTo>LOC1001</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">United States of America</
Country>
</PostalAddress>
<Email/>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Phone>
<Fax>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Fax>
</Address>
</ShipTo>
</ItemOut>
<ItemOut quantity="10" lineNumber="4">
<ItemID>
<SupplierPartID>1180059</SupplierPartID>
<SupplierPartAuxiliaryID/>
</ItemID>
<ItemDetail>
<UnitPrice>
<Money currency="USD">1205.82</Money>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 799

</UnitPrice>
<Description xml:lang="en">Flash Furniture Leather 4-Seat Home
Theater Recliner With Storage Consoles, Black</Description>
<UnitOfMeasure>EA</UnitOfMeasure>
<Classification domain="UNSPSC">56112105</Classification>
<ManufacturerPartID>BT702734BK</ManufacturerPartID>
<ManufacturerName>Belnick, Inc.</ManufacturerName>
</ItemDetail>
<SupplierID domain="SupplierName">STAPLES BUS ADV DALL 2664</
SupplierID>
<SupplierID domain="SupplierID">SUP-001804</SupplierID>
<ShipTo>
<Address addressID="5cca633ac6f7018622b2df6f62343613">
<Name xml:lang="en">ABC, Inc.</Name>
<PostalAddress>
<DeliverTo>ABC Resource</DeliverTo>
<DeliverTo>LOC1001</DeliverTo>
<Street>1111 Main Street</Street>
<City>Chicago</City>
<State>IL</State>
<PostalCode>60601</PostalCode>
<Country isoCountryCode="US">United States of America</
Country>
</PostalAddress>
<Email/>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Phone>
<Fax>
<TelephoneNumber>
<CountryCode isoCountryCode=""/>
<AreaOrCityCode/>
<Number/>
</TelephoneNumber>
</Fax>
</Address>
</ShipTo>
</ItemOut>
</OrderRequest>
</Request>
</cXML>

Troubleshooting: EDI Integrations Complete with Warnings or Errors


An EDI integration completes with warnings or errors and the integration fails to create the transaction in
Workday.
Cause: The EDI file contains incorrect data.
You can resolve this issue in 1 of 3 ways. Alternatively, for inbound EDI files, you can ask the sender to
correct the errors and resend the file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 800

Solution: Correct the EDI file manually, upload it to the relevant location, and run the integration again.

Steps
1. Access the Process Monitor report.
From the Process Type prompt, select Integration.
From the Process prompt, select your EDI integration system.
From the Status prompt, select:
• Completed With Errors
• Completed with Warnings
Security: My Reports domain in the System functional area.
2. In the Background Processes grid, locate the integration run.
3. In the Request column, drill down on the integration event.
4. On the View Background Process report, access the Messages tab and review the warnings and
errors.
Make a note of any problems to correct.
Security: Background Process Management in the Tenant Non-Configurable functional area.
5. On the Integration Details tab, drill down on the Parent Event.
Review the files processed during this integration event. For inbound EDI 810 files, Workday displays
the modified file. For inbound EDI 855 and 856 files, Workday displays the raw file.
Download the EDI files that have warnings or errors.
Note: Workday stores the files for the number of days you configured on the integration system. You
can't download the files after this period.
6. Open the EDI files in a text editor and correct the problems.
7. Upload the corrected files to the SFTP location configured on your EDI integration.
8. Launch an Integration on page 23.
Run the integration again.
Solution: Create a copy of your EDI integration on which you can add files as attachments, then:
• Correct the EDI file manually.
• Run the duplicate integration.
• Attach the corrected file.

Steps
1. Access the Process Monitor report.
From the Process Type prompt, select Integration.
From the Process prompt, select your EDI integration system.
From the Status prompt, select:
• Completed With Errors
• Completed with Warnings
Security: My Reports domain in the System functional area.
2. In the Background Processes grid, locate the integration run.
3. In the Request column, drill down on the integration event.
4. On the View Background Process report, access the Messages tab and review the warnings and
errors.
Make a note of any problems to correct.
Security: Background Process Management in the Tenant Non-Configurable functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 801

5. On the Integration Details tab, drill down on the Parent Event.


Review the files processed during this integration event. For inbound EDI 810 files, Workday displays
the modified file. For inbound EDI 855 and 856 files, Workday displays the raw file.
Download the EDI files that have warnings or errors.
Note: Workday stores the files for the number of days you configured on the integration system. You
can't download the files after this period.
6. From the related actions menu of your integration system, select Integration System > Clone.
Create a duplicate of your original EDI integration.
Security: Integration Build domain in the Integration functional area.
7. Create a business process definition for the cloned integration.
See Create Integration Business Process on page 1838.
8. Configure a document retrieval step on the business process to manually add attachments.
Select user groups from the Group to Manually Attach File(s) prompt.
See Set Up Integration Retrieval on page 1845.
9. Launch an Integration on page 23.
Run the duplicate integration and attach the corrected EDI file.
Solution: For inbound EDI files, manually create the transaction in Workday.

Steps
1. Access the Process Monitor report.
From the Process Type prompt, select Integration.
From the Process prompt, select your EDI integration system.
From the Status prompt, select:
• Completed With Errors
• Completed with Warnings
Security: My Reports domain in the System functional area.
2. In the Background Processes grid, locate the integration run.
3. In the Request column, drill down on the integration event.
4. On the View Background Process report, access the Messages tab and review the warnings and
errors.
Make a note of any problems to correct.
Security: Background Process Management in the Tenant Non-Configurable functional area.
5. On the Integration Details tab, drill down on the Parent Event.
Review the files processed during this integration event. For inbound EDI 810 files, Workday displays
the modified file. For inbound EDI 855 and 856 files, Workday displays the raw file.
Download the EDI files that have warnings or errors.
Note: Workday stores the files for the number of days you configured on the integration system. You
can't download the files after this period.
6. Manually create the EDI transactions in Workday.
See:
• Create Advanced Ship Notices.
• Steps: Create Purchase Order Acknowledgments.
• Create Supplier Invoices.
Related Information
Tasks
The Next Level: Spend Management EDI Integrations: A Comprehensive Mini Series

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 802

Electronic Invoice Connector

Steps: Set Up Electronic Invoice Connector

Context
You can create an integration to export custom electronic invoices to a vendor or payment portals in XML
format.

Steps
1. Access the Create Integration System task and enter Core Connector: Electronic Invoice Connector at
the New Using Template prompt.
• To configure to common European data model for transmitting electronic invoices from business to
government, set the New Using Template prompt to UBL 2.1 Electronic Customer Invoice.
• To transmit electronic invoices through cXML for automating the procurement process, set the New
Using Template prompt to cXML Electronic Customer Invoice.
• Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Select Integration System > Configure Integration Attributes as a related action on the integration
system and configure the integration attributes that you want to deliver.
To include the binary invoice PDF along with its supporting data, enable the FileContent on the
InvoicePDF field attribute. To restrict the size of the PDF, configure the Max PDF Size in Kilobytes
attribute.
3. Select Integration System > Configure Integration Field Attributes as a related action on the
integration system and configure the fields you would like to include in the output.
Disable any field attributes that you don’t want included in the xml output file.
4. (Optional) Access the Configure Integration Field Overrides task from the related actions menu of
the desired integration system.
• Add custom fields, calculated fields, and Workday delivered report fields that aren't part of the
delivered field attributes to the Extended Fields section for a given level. This enables you to
include customer specific fields in the XML output file.
• To avoid performance issues, Workday doesn't sort the invoice lines when you generate electronic
invoices. Therefore, the order of electronic invoice lines can be different from the order that the lines
display on the standard customer invoice.
5. (Optional) Steps: Configure UBL Version 2.1 Electronic Customer Invoice Integration Service Map on
page 803.
When you use the UBL 2.1 Electronic Customer Invoice template, configure any field overrides as
needed.
6. (Optional) Steps: Configure cXML Electronic Customer Invoice Template on page 808.
When you use the cXML Electronic Customer Invoice template, configure any field overrides or field
attributes as needed.
7. Set Up Integration Delivery on page 1839.
Configure the Integration Process Event business process and add a Service step for document
delivery to an external entity.
8. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Process: Electronic Invoices
See: Steps: Grant Integration or External Endpoint Access to Workday.
9. Set Up Integration Sequence Generators on page 1856.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 803

10.Launch an Integration on page 23.


• To limit the invoices to include in the XML output, define filters such as Company, Customer, Invoice
Number, Invoice Status before launching the integration.
• For UBL 2.1 integration, we recommend that you launch it from the Customer Invoice Event
business process. Add a new Service type step and set the Specify to Integration in the business
process to launch the new integration after the appropriate person approves the invoice.
• Add condition rules on the Integration step to ensure that the electronic invoice integration launches
only:
•When Workday generates an invoice PDF after the last printing run. Set the report field to Does
PDF Exist for Last Printing Run and the relational operator to Is not blank.
• For specific customer invoices within a given company. Use the Customer Invoice or
Adjustment launch parameter to define a unique customer invoice or adjustment instance.
11.(Optional) Create Integration Notifications on page 30.
Related Information
Concepts
Concept: Electronic Invoicing
Tasks
Create Customer Invoices
Create Integration Business Process on page 1838
Reference
2021R2 What's New Post: Automatic Invoice Printing and E-Invoice Integration Initiation
2022R2 What's New Post: Electronic Invoice Field Overrides

Steps: Configure UBL Version 2.1 Electronic Customer Invoice Integration Service Map

Prerequisites
• Security: Integration Build and Integration Configure domains in the Integration functional area.
• Security: Process: Electronic Invoices domain in the Customer Accounts functional area.

Context
After you create an electronic invoice integration system and define the integration attributes, configure
the integration maps to map values in Workday to corresponding external values for invoice type, payment
type, tax codes, and unit of measure. You only need to define mappings for the data elements that you
want to include in the output file.
When an integration map has at least 1 row of data:
• Workday uses the map values to convert your tenant values to external values.
• When you don't define a tenant value in the map, Workday uses the default value of the map.
When the default value is blank, Workday issues an error or a warning message and the external value is
empty.

Steps
1. From the related actions menu on the integration system, select Integration System > Configure
Integration Maps.
2. In the Integration Maps grid, add a row for each tenant value. Select the Internal Value and enter the
External Value for the output file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 804

3. As you complete the task, consider:

Integration Maps Description Internal Value External Value EU Code List


Invoice Type to Associates Example: Credit Example: 381 Use the
InvoiceTypeCode Workday Invoice Invoice UNTDID1001-inv
Types to the EU list to conform
external value for with the EN-16931
InvoiceTypeCode semantic data
or model.
CreditNoteTypeCode.
Configure this map
only when you set
the Use Invoice
Type or Statutory
Invoice Type for
InvoiceTypeCode
attribute to Invoice
Type.

Statutory Associates Example: Example: 380 Use the


Invoice Type to Workday Statutory Type UNTDID1001-cn
InvoiceTypeCode Statutory Invoice EU list to conform
Types to the with the EN-16931
external value for semantic data
InvoiceTypeCode model.
or
CreditNoteTypeCode.
Configure this map
only when you set
the Use Invoice
Type or Statutory
Invoice Type for
InvoiceTypeCode
attribute to
Statutory Invoice
Type

Payment Type to Associates Example: Cash Example: 10 Use the


PaymentMeansCodeWorkday Payment UNCL4461 EU
Types to the list to conform
external value for with the EN-16931
PaymentMeansCode. semantic data
model.
Tax Code to Associates Example: FR VAT Example: S Use the
TaxCategory ID Workday Output (10%) UNCL5305 EU
Transaction list to conform
Tax Codes to with the EN-16931
the external semantic data
value in the UBL model.
invoice output for
TaxCategory ID.
Tax Code to Associates Example: FR VAT Example: VAT- Use the Vatex
TaxExemptionReasonCode
Workday Output (0%) EU-G EU list to conform
Transaction Tax with the EN-16931

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 805

Integration Maps Description Internal Value External Value EU Code List


Codes to the semantic data
external value for model.
TaxExemptionReasonCode.
Configure this
map only when
you set the Use
Tax Code or Tax
Applicability for
TaxExemptionReasonCode
attribute to Tax
Code.

Unit of Measure to Associates Example: Box Example: XBX Use the UMCode
InvoicedQuantity Workday Unit of List to conform
Measures value to with the EN-16931
the external value semantic data
for the attribute model.
unitCode on
InvoicedQuantity.
Company Tax Associates the Example:FRA - Example: Use the PEPPOL-
ID Type to UBL company Tax IDs SIREN AccountingSupplierParty
COMMON-R045
/
Target Field to an external Party / to conform with
value in a specific PartyTaxScheme / the EN-16931
XML target output CompanyID semantic data
field in the UBL model.
file.
All Company
Tax IDs and non
Transaction Tax
ID Types are
persisted on the
customer invoice
are included in the
AccountingSupplierParty /
Party /
PartyIdentification /
ID target field as a
default.

Customer Tax Associates the Example:FRA - Example: NA


ID Type to UBL customer Tax IDs SIREN AccountingCustomerParty /
Target Field to an external Party /
value in a specific PartyTaxScheme /
XML target output CompanyID
field in the UBL
file.
Ensure to
configure buyer
and seller
Company and
Customer
Tax IDs for
customer invoices

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 806

Integration Maps Description Internal Value External Value EU Code List


usingMaintain
Transaction Tax
CodesandMaintain
Tax ID
Groupingtasks.

Company Tax ID Associates Example:FRA - Example:0009 Use the ISO 6523


Type to schemeID the company SIREN ICD list to conform
Tax IDs to an with the EN-16931
external value as semantic data
schemeIDs in an model.
output field in the
UBL file.
Customer Tax ID Associates Example:FRA - Example: 0009 Use the ISO 6523
Type to schemeID the customer SIREN ICD list to conform
Tax IDs to an with the EN-16931
external value as semantic data
schemeIDs in an model.
output field in the
UBL file.

See the UBL Field Mapping Output Samples PDF file for examples of the output XML file for
AccountingSupplierParty sections when you:
• Define an integration map.
• Define field overrides.
• Do not configure an integration map or field override.
See the UBL Field Mapping to Workday Customer Invoice Fields Excel file for detailed mapping of UBL
fields to Workday Customer Invoice fields.
Ensure to observe these additional configuration behaviors to include the invoice data:
• Billable Project Name is included in output file only when there’s 1 unique project reference across
all customer invoice lines.
• Contract Number is included in output file only when there’s 1 unique contract reference across all
customer invoice lines.
• We use the original invoice number for the rebill and adjustments in the output file.
• The company and customer TaxID integration maps output to the PartyLegalEntity / CompanyID
target field and they override the GovernmentIssuedCompanyID field in case you have any prior
mappings.
Note: The EU lists includes code values from third-party websites. Workday isn’t affiliated with and
doesn't manage or update the information in these third-party sites. These lists are for reference only
and you should validate your XML files.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 807

4. (Optional) From the related actions menu on the integration system, select Integration System >
Configure Integration Field Attributes.
• Select the Include all in Output check box to include all the invoice fields .
• We provide these configurable field attributes:
• Company
• CompanyAddress
• BillToCustomer
• BillToCustomerAddress
• ShipToCustomer
• ShipToCustomerAddress
• SoldToCustomer
• InvoiceDetail
• AdditionalDetail
• AmountSummary
• TaxSummary
• PaymentDetail
• InvoicePDF
• InvoiceLine
• Certain fields might contain additional parameters that you can configure to include in the output field
for meeting the electronic invoicing requirements.
• To include the tax exemption reason description from the external tax mapping list in Workday into
the XML output file, enable these attributes under TaxSumary for both grouped and ungrouped tax
codes mapTax Code to Tax Exemption Reason Code:
• TransactionTaxCodeData/ExternalTaxCodeSubclassificationDescription
• GroupedTransactionTaxCodeData/TaxExemptionReasonDescription
• To include the additional mandatory fields for supporting Tier-1 country specific invoicing
requirements, after you configure the Company and Customer Tax ID integration maps, you can
include these additional TaxID fields in the output file:
• NationalTaxIDCode
• Number
• Type
• You can also include fields for:
• Additional Details such as DocumentLink, DueDate, FromDate, ToDate. Ensure to enable the
Customer Invoice Document Link by using the Maintain External Link Validation task.
• Payment Details such as BankAccountNumber, IBAN, BankID. When you enable the Payment
Account identifiers:
• The Bank Account Number takes precedence over the IBAN.
• The Bank Identification Code takes precedence over the Bank ID.
5. (Optional) From the related actions menu on the integration system, select Integration System >
Configure Integration Field Overrides.
Configure field overrides to change the Workday data to your custom data for the desired fields.

Result
Workday saves the attribute map service on the integration.

Example
You need to provide a value for the electronic invoice that is part of the invoice type code EU list
(UNCL1001) to meet the requirements of the European Union. Since Workday doesn't store these values,

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 808

use the Statutory Invoice Type to InvoiceTypeCode map to associate the Workday instance to the external
EU list value.
To do so, set the Use Invoice Type or Statutory Invoice Type for InvoiceTypeCode integration attribute
to Statutory Invoice Type . For the Statutory Invoice Type to InvoiceTypeCode integration map, set the
Internal Value to Statutory Type and the External Value to code 380 from the UNTDID1001-inv list.

Next Steps
• After the integration system setup is complete, test the xml file against the EU validator https://
ecosio.com/en/peppol-and-xml-document-validator/.
• When you have multiple tax total elements in the file, use this validator https://www.itb.ec.europa.eu/
invoice/upload. This validator goes down for maintenance in the evening PDT.
Note: The validator links are for third-party websites. Workday isn’t affiliated with and doesn't manage
or update the information in these third-party sites. This information is for reference only. Your access
and use of these third party sites are subject to separate terms of use.
• When validating the file:
• Create a calculated field and use a field override to obtain the company ID when the
VatCategoryTax code is O.
• Enable the Transaction Tax IDs.
• Map values for InvoiceType code to include UBL 2.1 credit note.
Related Information
Reference
2021R2 What's New Post: Universal Business Language (UBL) Version 2.1 Electronic Customer Invoice
Template

Steps: Configure cXML Electronic Customer Invoice Template

Prerequisites
Security:
• Integration Build and Integration Configure domains in the Integration functional area.
• Process: Electronic Invoices domain in the Customer Accounts functional area.

Context
The outbound cXML Electronic Customer Invoice template improves your collection cycles and reduces
manual effort and payment processing time. It enables you to:
• Set up an integration system for generating an electronic invoice for third party external suppliers that
accept cXML.
• Attach or automatically post the cXML output file to the supplier portal endpoint.
• Provide a portal response to the customer invoice in Workday.
This template leverages the existing generic Electronic Customer Invoice – Core connector service and
automatically enables all of the integration services, excluding these 2 optional services:
• cXML Electronic Customer Invoice / Electronic Customer Invoice Core Service: Enable to include
additional output tags with the integration file.
• cXML Electronic Customer Invoice / Integration Document Retention: Enable to define the duration for
storing the resulting output file in Workday.
You must configure the connections for posting to a supplier portal endpoint. To launch the integration
automatically, you must define the document delivery rules and the associated document delivery types.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 809

Steps
1. From the related actions menu of the cXML integration system you created, select Integration System
> Configure Integration Maps.
In the Integration Maps grid, add a row for each tenant value. When you don't define a tenant value in
the map, Workday uses the default value of the map. When the default value is blank, Workday issues
an error or a warning message and the external value is empty.

Integration Maps Description Internal Value External Value EU Code List


Unit of Measure to Associates Unit Example: Each Example: EA Use the UNECE
UnitOfMeasure of Measure in code list to
Workday to conform with the
the external cXML list.
UN/CEFACT
Bundle BE
UnitOfMeasure
value for invoice B BX
detail item.

You only need to define mappings for the data elements that you want to include in the output file.
This mapping translates the Workday unit of measure to a different set of external values in the XML
invoice output file. After you set up the integration, for UOM details, we recommend that you refer to a
third-party tool such as https://unece.org/trade/cefact/UNLOCODE-Download.
Note: Workday isn’t affiliated with the third-party sites and doesn't manage or update their information.
These lists are for reference only and you should validate your XML files.
2. (Optional) From the related actions menu on the integration system, select Integration System >
Configure Integration Field Attributes.
Enable the cXML File Delivery attribute to determine the file delivery option of attaching the file or
posting it to an endpoint.
When you attach the file to an event, it's not posted to an endpoint and you will not receive an invoice
acknowledgment.
3. (Optional) From the related actions menu on the integration system, select Integration System >
Configure Integration Field Overrides.
Configure field overrides to change the Workday data to your custom data for the desired fields.
Workday provides a PO Line field attribute and it's enabled by default. To populate this number on
the customer invoice, setup a field override for the Memofield. When creating a customer invoice in
Workday, use the Memo field to add the PO line number .
4. Access the Create Integration System User task.
Create a new separate ISU account for each vendor. Example: Create an account for Ariba_ISU.
Security: Set Up: Integration Security domain in the Integration functional area.
5. Access the Edit Integration System Security Group (Unconstrained) task.
Add the new ISU account to the E-Invoice Unconstrained Integration Security Group.
6. From the related actions menu of the desired integration system, access Workday Account > Edit.
Add the new ISU account to the integration system.

Next Steps
Configure integration connections and document delivery rules to automate the process of posting the
cXML file to the supplier portal endpoint and launching the integration from the business process. See
Steps: Automate Electronic Invoice Document Delivery for cXML.
Related Information
Reference
2023R2 What's New Post: cXML Electronic Customer Invoice

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 810

Steps: Automate Electronic Invoice Document Delivery for cXML

Prerequisites
• Create a cXML integration system.
• Create a separate ISU account and add it to the security group and to the cXML integration system.

Context
You can configure the billing company credentials and document delivery rules to automatically post the
customer invoices through a cXML file to the external supplier portal endpoint.

Steps
1. Access the Maintain Electronic Invoice Integration Connections task.
• For the cXML Configuration Type , enter a connection Name . You can set up multiple
connections to support accounts for each of the third-party supplier portals you plan to have an
integration with.
• For each connection, configure these attributes:

Option Description
From Domain The From Credential Domain in the cXML file.
Example, the Supplier Network ID or DUNS.
From Identity The From Credential Identity in the cXML file.
Example: AN005555.
Sender Domain The Sender Credential Domain in the cXML file.
Example, the Supplier Network ID or DUNS.
Sender Identity The Sender Credential Identity in the cXML file.
Example: AN005555.
Sender Shared Secret Enter the password provided by your supplier
network.
Endpoint Specify the endpoint URL where the cXML file
will be posted.
• Also, grant access to the Security: Process: Electronic Invoices domain in the Customer Accounts
functional area to users or user groups who will define the cXML credentials and endpoint.
• Security: Process: Electronic Customer Invoice - cXML Connection domain in the Customer
Accounts functional area.
2. Access the Maintain Document Delivery Types task.
• Add Integration Delivery Method for the Customer Invoice Document Type.
• Enter a supplier name in the Delivery Type Name field.
• Workday uses the Document Delivery Types that you define here for the external suppliers on the
customer profile, and in the delivery rules to initiate the integration system when creating invoices.
• Security: Set Up: Customer Accounts and Set Up: Sponsor Accounts domains in the Customer
Accounts and Grants Management functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 811

3. Access the Maintain Document Delivery Rules task.


• Add cXML document delivery rules for each supplier to map the document delivery type to
integration connection credentials for the integration system.
• Select Integration from the Document Delivery Type prompt for the cXML Integration System .
Specify the Integration Connection.
• External Tax Codes column is associated with the specified statutory invoices and displays only
when you have configured a statutory invoice type for a given country through the Maintain Invoice
Types by Country task.
• Security: Set Up: Customer Accounts domain in the Customer Accounts functional area.
4. Access the Edit Document Delivery Options task.
• Select Integration from the Delivery Type prompt for the Customer Invoice Document.
• This indicates that the customer is using an integration delivery type for customer invoices.
• Security: Set Up: Customer domain in the Customers functional area.
5. Access the Customer Invoice Event business process and from the related actions menu, select Edit.
• To launch your integration system based on the document delivery rules, add a step and Specify
Electronic Invoicing Via Document Delivery Rules for Service Type .
• To include the printed PDF with the cXML, add the Print Customer Invoice service.

Result
When you submit the customer invoice, Workday initiates theCustomer Invoice Event business process
and launches the cXML integration system to post the invoice in cXML file format to the supplier endpoint.

Next Steps
When the business process completes, you can view:
• The supplier portal integration process details on the Process tab of the invoice.
• The successful response back on the Electronic Invoice Acknowledgement tab.

Concept: Electronic Invoice Connector


The Electronic Invoice Connector integration:
• Sends invoice data electronically to external entities in XML format.
• Enables you to create custom configuration to meet local government requirements, or to integrate with
third-party e-invoice business solutions.
Workday provides these electronic invoice integration templates:

Template Considerations Requires Access to Security


Domain
Core Connector: Electronic Use this Workday defined Process: Electronic Invoices.
Customer Invoices template to generate a generic
XML output file for sending e-
invoicing data out of Workday.
You can configure the integration
field attributes to define the fields
to include in the output file.
You can also add launch
parameters to help narrow the
selection of invoices to include in
the XML output.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 812

Template Considerations Requires Access to Security


Domain
UBL 2.1 Electronic Customer Use this template to configure Process: Electronic Invoices
Invoice invoice data according to the
local authorities that don’t support
standard invoice data formats.
Example: the EN-16931 semantic
data model for business-to-
government transactions in
Europe.
Configure invoice type codes,
tax codes, or tax applicability
attributes to map Workday values
to external values for populating
the data in the UBL invoice output
format. You can also change
the attributes to populate data in
another output format to suit your
business needs.
To change the Workday data
to your custom data for desired
fields, use Field Overrides.
Example: UBL file has a field
for Profile ID that defines the
profile for the customization of
UBL in use. You can use the field
override to include a calculated
field to specify the exact profile.
Workday uses this calculated field
in the UBL output.
To include the binary file in
the XML file output, print the
customer invoice before running
this UBL 2.1 integration.

cXML Electronic Customer Use this template to configure Process: Electronic Invoices
Invoice generation of an electronic
invoice in cXML format and
send it to your end customers
that use third party external
suppliers portals who accept
cXML as a method, and record
their response in the invoice
acknowledgement.
To specify the duration (in days)
that the integration output should
be available for, enable the
cXML Electronic Customer
Invoice / Integration Document
Retention Service and configure
the Document Retention Policy
attribute.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 813

Template Considerations Requires Access to Security


Domain
To add tags associated with
the electronic customer invoice
output file, enable the cXML
Electronic Customer Invoice /
Electronic Customer Invoice Core
Service and configure the Output
Document Tags attribute.

Core Connector: Electronic Customer Invoices


The template includes these configurable integration services:

Integration Service Integration Attribute Description


Customer Invoices for NA Provides all the global launch
Electronic Invoicing DIS parameters.
PDFs for Electronic Invoicing Max PDF Size in Kilobytes Enables you to output the
DIS invoices in PDF format. You can
define the maximum size of the
PDF file to restrict the file size.
When you set the PDF
FileContent to Required and the
PDF file exceeds the limit, then
Workday excludes the PDF from
the final output file.

Electronic Customer Invoice Output Document Tags Associates the tag with the output
Core Service Electronic Customer Invoice file,
to help you easily identify the
specific documents you might
need later.
Integration Document Document Retention Policy Retains integration files for audit
Retention and troubleshooting purposes.
You can specify the duration
(in days) that integration output
should be available.

UBL 2.1 Electronic Customer Invoice


In addition to the integrations services provided with the core connector, this template also includes 1 more
configurable integration service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 814

Integration Service Integration Attribute Description


UBL 2.1 Electronic Customer Codes to Generate UBL 2.1 Specify the invoice codes.
Invoice Service Credit Note Format Workday generates a UBL 2.1
credit note format file when the
values you specify match the
CreditNoteTypeCode external
value defined on the Invoice Type
or Statutory Invoice Type maps.
When the values don't match,
Workday generates a UBL 2.1
invoice format file.
Workday sets the code to a string
of 81,83,381,396,532 that are the
InvoiceTypeCodes for credit note
according to the European Union.

CustomizationID Identifies a user-defined


customization of UBL for a
specific use.
Use Invoice Number or Gapless Select the invoice numbers to
Invoice Number populate the ID field in the output
file.
Workday automatically sets it to
Gapless Invoice Number. When
you aren't using this feature, set
the Workday Invoice Number as
the output option.

Use Invoice Type or Statutory Select a map to populate


Invoice Type for InvoiceTypeCode the InvoiceTypeCode or
CreditNoteTypeCode in the
output file.
Workday automatically sets it to
Statutory Invoice Type. When
you aren't using this feature, set
the Workday Invoice Type as the
output option.

Enable Tax Code Grouping Select the flag to group the


different Workday transaction tax
codes that have the same tax
percentage and map to the same
external tax code value.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 815

Integration Service Integration Attribute Description


Enable Tax Mapping Lists for Select the flag for the desired
Invoices environment to determine the
external TaxCategoryID and
TaxExemptionReasonCode
values in the output file using
the configurations you define
on the Maintain External Tax
Code List Mappings task to .
When you don't enable this
attribute, Workday uses the
integration maps associated
with this integration system to
determine the TaxCategoryID and
TaxExemptionReasonCode.
Note: This is applicable only
when you include an external tax
list in the document delivery rules
for the Integration System.

Use Tax Code or Tax Applicability Select a map to populate the


for TaxExemptReasonCode TaxExemptReasonCode field
in the output file. Workday
automatically sets it to Tax Code.
Concatenate Additional Address Select the Value check box to
Line include additional addresses from
Lines 3 to 9 in a single third line,
separated by spaces, in the UBL
output file.
See the Sample Output of
Concatenate Additional Address
Line PDF file for examples of
XML output.

You can validate the results of your file to see if they conform with the UBL syntax and EN-16931 semantic
data model by testing with any of the third-party tools available. Example: Ecosio Document Validator or
Interoperability Test Bed Validator.
Note: Workday isn’t affiliated with, or manages, or updates the information provided in these third-party
sites. Your access and use of these third-party sites are subject to separate terms of use.

cXML Electronic Customer Invoice


In addition to the integrations services provided with the core connector, this template also includes these
configurable integration services:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 816

Integration Service Integration Attribute Description


cXML Electronic Customer cXML File Delivery Specify the cXML file delivery
Invoice Service option. You can post the cXML
File to an endpoint or attach it.
When you attach the file to an
event, you won't receive an
invoice acknowledgment.
Default value is Post cXML file
Externally.

Use Vendor Issued ID or Specify the source of the


Customer DUNS Number customer data for the To
Credential Identity field
associated with the customer
receiving the invoice.
To Credential Domain for Specify the domain associated
Customer Identifier with the To Credential Domain
value. For example: DUNS,
Network ID. Default value is
Network ID.
Use Invoice Number or Gapless Select the invoice identifier to use
Invoice Number for populating the invoice number
in the output file. Possible option
is: Invoice Number, or Gapless
Invoice Number. Default value is
Invoice Number .
XML Language Specify the language identifier
for text elements that require a
language attribute. Default value
is eng .
Enable Message Auditing NA Optional service that you enables
you to record and store additional
audit messages in the integration
output.
Workday recommends that you
enable this service only when you
first implement the integration, or
when you diagnose an issue.

To configure the third-party supplier portal connections, define credentials on the Maintain Electronic
Invoice Integration Connections task.
The Configure Integration Services task displays all integration services, including required services.
Required integration services aren’t editable.

Launch/Schedule Options
Workday provides these launch schedule options for the Electronic Invoice Connector integration:
• Launch with an Integration step on a business process.
• Run Now. You can launch the integration manually. The integration prompts you to enter launch
parameters.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 817

• Scheduled Run Frequency. You can specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes from the endpoint based on
the launch parameters. You can schedule the integration to run several times per day.
For each launch schedule option:
• You can specify any launch criteria that an integration requires. Example: As Of Entry Moment
enables you to retrieve future-dated data changes. Or Effective Date defines the end of a date range
during which changes became effective. The integration extracts the data with changes made on or
before this date.
• You can also have Workday determine the values when you run the integration by using a report field or
calculated field. The report or calculated field must have a Value Type of Determine Value at Runtime.

Processing Notes
• When you run the integration, Workday generates a separate XML file for each customer invoice.
There’s a maximum limit of 5,000 invoices per integration event. See Reference: Integrations and Web
Service Limits.
• We recommend that you:
• Launch the UBL 2.1 integration from the Customer Invoice Event business process.
• Configure the Customer Invoice Event business process by adding Integration Type as a new
step. Workday launches the new integration after the appropriate person approves the invoice. You
can also add condition rules on the Integration step to ensure that the electronic invoice integration
launches only:
• For specific customer invoices within a given company.
• When Workday generates an invoice PDF after the last printing run.

Integration Audit Files


When you run this integration, Workday generates a Diagnostic Audit file to help you identify invoices not
included in the output file along with the associated error. The audit also enables you to view the invoices
included in the output but with warnings due to missing PDF. Workday provides 1 audit for each run.
You can find the file in the Reports and Other Output Files section. This section displays on the
Integration Event for each integration run.

Electronic Invoicing Acknowledgments


You can also receive acknowledgments sent back by external entities. The acknowledgments provide full
visibility to the invoice status, processing date, and related messages.
Workday provides these web services to process the acknowledgments:
• Get Electronic Invoicing Acknowledgments
• Put Electronic Invoicing Acknowledgment
Related Information
Concepts
Concept: Data Initialization Service (DIS) on page 562
Reference
Reference: Integration Value Attributes for Document Transformation on page 582
Reference: Outbound Integration Transformations on page 81

Reference: Electronic Invoice Connector XML Schema


For the UBL 2.1 Electronic Customer Invoice integration template, refer to the OASIS UBL v2.1 website for
an example of the normative XSD schema:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 818

• Invoices
• Credit Note
Note: Workday isn’t affiliated with, or manages, or updates the information provided in these third-
party sites. It's for reference purposes only. Your access and use of these third-party sites are subject to
separate terms of use.
The Core Connector: Electronic Invoice Connector integration template only supports XML file format.

<?xml version="1.0" encoding="UTF-8"?>


<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:eic="urn:com.workday/
ElectronicCustomerInvoiceConnector"
targetNamespace="urn:com.workday/ElectronicCustomerInvoiceConnector"
elementFormDefault="qualified"
attributeFormDefault="qualified">

<xs:element name="ElectronicCustomerInvoiceConnector" type="eic:ConnectorHeader"/>

<xs:complexType name="ConnectorHeader">
<xs:sequence>
<xs:element name="FileCreatedDate" type="xs:dateTime" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceCount" type="xs:int" minOccurs="1" maxOccurs="1"/>
<xs:element name="Invoice" type="eic:Invoice" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Invoice">
<xs:sequence>
<xs:element name="Company" type="eic:Company" minOccurs="1" maxOccurs="1"/>
<xs:element name="BillToCustomer" type="eic:BillToCustomer" minOccurs="1"
maxOccurs="1"/>
<xs:element name="ShipToCustomer" type="eic:ShipToCustomer" minOccurs="0"
maxOccurs="1"/>
<xs:element name="SoldToCustomer" type="eic:SoldToCustomer" minOccurs="0"
maxOccurs="1"/>
<xs:element name="InvoiceDetail" type="eic:InvoiceDetail" minOccurs="1"
maxOccurs="1"/>
<xs:element name="AdditionalDetail" type="eic:AdditionalDetail" minOccurs="1"
maxOccurs="1"/>
<xs:element name="AmountSummary" type="eic:AmountSummary" minOccurs="1"
maxOccurs="1"/>
<xs:element name="TaxSummary" type="eic:TaxSummary" minOccurs="0" maxOccurs="1"/>
<xs:element name="PaymentDetail" type="eic:PaymentDetail" minOccurs="0"
maxOccurs="1"/>
<xs:element name="InvoicePDF" type="eic:InvoicePDF" minOccurs="0" maxOccurs="1"/>
<xs:element name="InvoiceLine" type="eic:InvoiceLine" minOccurs="0"
maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Company">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="OrganizationCode" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Currency" type="eic:Currency" minOccurs="0" maxOccurs="1"/>
<xs:element name="ElectronicInvoicingAgreementDate" type="xs:date" minOccurs="0"
maxOccurs="1"/>
<xs:element name="TaxID" type="eic:TaxID" minOccurs="0" maxOccurs="1"/>
<xs:element name="AdditionalTaxIDs" type="eic:AdditionalTaxIDs" minOccurs="0"
maxOccurs="1"/>
<xs:element name="Phone" type="eic:Phone" minOccurs="0" maxOccurs="1"/>
<xs:element name="Email" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Address" type="eic:Address" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="BillToCustomer">
<xs:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 819

<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>


<xs:element name="CustomerID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="DUNSNumber" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="AlternateName" type="eic:AlternateName" minOccurs="0"
maxOccurs="unbounded"/>
<xs:element name="ElectronicInvoicing" type="eic:ElectronicInvoicing" minOccurs="0"
maxOccurs="1"/>
<xs:element name="TaxID" type="eic:TaxID" minOccurs="0" maxOccurs="1"/>
<xs:element name="AdditionalTaxIDs" type="eic:AdditionalTaxIDs" minOccurs="0"
maxOccurs="1"/>
<xs:element name="Phone" type="eic:Phone" minOccurs="0" maxOccurs="1"/>
<xs:element name="Email" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Address" type="eic:Address" minOccurs="0" maxOccurs="1"/>
<xs:element name="Contact" type="eic:Contact" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="ShipToCustomer">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="CustomerID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Phone" type="eic:Phone" minOccurs="0" maxOccurs="1"/>
<xs:element name="Email" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Address" type="eic:Address" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="SoldToCustomer">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="CustomerID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="InvoiceDetail">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceReferenceID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceNumber" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="GaplessInvoiceNumber" type="xs:string" minOccurs="0" maxOccurs="1"/
>
<xs:element name="ReferenceNumber" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="InvoiceStatus" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceType" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="StatutoryInvoiceType" type="xs:string" minOccurs="0" maxOccurs="1"/
>
<xs:element name="PONumber" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AdjustmentInvoice" type="xs:boolean" minOccurs="1" maxOccurs="1"/>
<xs:element name="AdjustmentReason" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="RelatedCustomerInvoiceAdjustment" type="eic:RelatedInvoice"
minOccurs="0" maxOccurs="unbounded"/><!--when type is invoice -->
<xs:element name="RelatedCustomerInvoice" type="eic:RelatedInvoice" minOccurs="0"
maxOccurs="1"/><!--when type is adjustment -->
<xs:element name="RebilledCustomerInvoice" type="eic:RelatedInvoice" minOccurs="0"
maxOccurs="1"/>
<xs:element name="CreditedCustomerInvoice" type="eic:RelatedInvoice" minOccurs="0"
maxOccurs="1"/>
<xs:element name="RelatedSupplierInvoice" type="eic:RelatedInvoice" minOccurs="0"
maxOccurs="1"/>
<xs:element name="ConsolidatedCustomerInvoice" type="eic:RelatedConsolidatedInvoice"
minOccurs="0" maxOccurs="1"/>
<xs:element name="BillableProject" type="eic:BillableProject" minOccurs="0"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="AdditionalDetail">
<xs:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 820

<xs:element name="InvoiceDate" type="xs:date" minOccurs="1" maxOccurs="1"/>


<xs:element name="CreatedDate" type="xs:dateTime" minOccurs="1" maxOccurs="1"/>
<xs:element name="DueDate" type="xs:date" minOccurs="1" maxOccurs="1"/>
<xs:element name="FromDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="ToDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="FinalizedDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="AccountingDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="CancelAccountingDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="DiscountDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="PreNotificationSentDate" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="DirectIntercompany" type="xs:boolean" minOccurs="0" maxOccurs="1"/>
<xs:element name="Memo" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="RetentionMemo" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="DocumentLink" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="AmountSummary">
<xs:sequence>
<xs:element name="Currency" type="eic:Currency" minOccurs="1" maxOccurs="1"/>
<xs:element name="NetInvoiceAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="AmountRetained" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="TaxAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="TotalInvoiceAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="WithholdingAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="AmountDue" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="DefaultTaxCode" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="DefaultTaxCodePercent" type="xs:decimal" minOccurs="0"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="InvoicePDF">
<xs:sequence>
<xs:element name="DocumentID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="FileName" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Size" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="PrintedDate" type="xs:dateTime" minOccurs="1" maxOccurs="1"/>
<xs:element name="PrintRunType" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="AttachmentsIncluded" type="xs:boolean" minOccurs="1"
maxOccurs="1"/>
<xs:element name="DeliveryMethod" type="xs:string" minOccurs="0"
maxOccurs="unbounded"/> <!--multi select-->
<xs:element name="FileContent" type="xs:base64Binary" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="InvoiceLine">
<xs:sequence>
<xs:element name="Company" type="eic:LineCompany" minOccurs="1" maxOccurs="1"/>
<xs:element name="ShipToCustomer" type="eic:LineShipToCustomer" minOccurs="0"
maxOccurs="1"/>
<xs:element name="LineDetail" type="eic:LineDetail" minOccurs="1" maxOccurs="1"/>
<xs:element name="AdditionalDetail" type="eic:LineAdditionalDetail" minOccurs="0"
maxOccurs="1"/>
<xs:element name="AmountDetail" type="eic:LineAmount" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxDetail" type="eic:LineTaxDetail" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineCompany">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="OrganizationCode" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineShipToCustomer">
<xs:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 821

<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>


<xs:element name="CustomerID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Address" type="eic:Address" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineDetail">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="LineReferenceID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="LineNumber" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Order" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="SalesItem" type="eic:SalesItem" minOccurs="0" maxOccurs="1"/>
<xs:element name="RevenueCategory" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="ItemDescription" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BillableProject" type="eic:BillableProject" minOccurs="0"
maxOccurs="1"/>
<xs:element name="RelatedContractLine" type="eic:RelatedContractLine" minOccurs="0"
maxOccurs="1"/>
<xs:element name="ReleaseForCustomerInvoiceLine" type="eic:RelatedInvoiceLine"
minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineAdditionalDetail">
<xs:sequence>
<xs:element name="TransactionDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="FromDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="ToDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="LineOrigin" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="GeneratedByFinanceCharge" type="xs:boolean" minOccurs="0"
maxOccurs="1"/>
<xs:element name="IntercompanyLine" type="xs:boolean" minOccurs="0" maxOccurs="1"/>
<xs:element name="GeneratedByBillableTransaction" type="xs:boolean" minOccurs="0"
maxOccurs="1"/>
<xs:element name="Memo" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Worktag" type="eic:Worktag" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineAmount">
<xs:sequence>
<xs:element name="Currency" type="eic:Currency" minOccurs="1" maxOccurs="1"/>
<xs:element name="Quantity" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="UnitOfMeasure" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Quantity2" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="UnitOfMeasure2" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="UnitPrice" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="AmountForRetention" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="ExtendedAmount" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="AnalyticalAmount" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="PrepaysAmount" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="AmountRetained" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineTaxDetail">
<xs:sequence>
<xs:element name="Transaction" type="eic:LineTransactionTaxData" minOccurs="0"
maxOccurs="1"/>
<xs:element name="Withholding" type="eic:LineWithholdingTaxData" minOccurs="0"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineTransactionTaxData">
<xs:sequence>
<xs:element name="TaxApplicability" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="TaxCode" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="TaxCodePercent" type="xs:decimal" minOccurs="0" maxOccurs="1"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 822

<xs:element name="TaxPointDate" type="xs:date" minOccurs="0" maxOccurs="1"/>


<xs:element name="TaxPointDateType" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="LineWithholdingTaxData">
<xs:sequence>
<xs:element name="TaxCode" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="RelatedContractLine">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="ContractID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="LineNumber" type="xs:int" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="RelatedInvoice">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceNumber" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="GaplessInvoiceNumber" type="xs:string" minOccurs="0" maxOccurs="1"/
>
<xs:element name="InvoiceDate" type="xs:date" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="RelatedConsolidatedInvoice">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceNumber" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceDate" type="xs:date" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="RelatedInvoiceLine">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="InvoiceLineReferenceID" type="xs:string" minOccurs="1"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="BillableProject">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="SalesItem">
<xs:sequence>
<xs:element name="WorkdayID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Worktag">
<xs:sequence>
<xs:element name="Type" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Value" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="TaxSummary">
<xs:sequence>
<xs:element name="CompanyTaxID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AdditionalCompanyTaxIDs" type="eic:AdditionalCompanyTaxIDs"
minOccurs="0" maxOccurs="unbounded"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 823

<xs:element name="CustomerTaxID" type="xs:string" minOccurs="0" maxOccurs="1"/>


<xs:element name="AdditionalCustomerTaxIDs" type="eic:AdditionalCustomerTaxIDs"
minOccurs="0" maxOccurs="unbounded"/>
<xs:choice>
<xs:element name="NonReportingThirdPartyTax" type="eic:NonReportingThirdPartyTax"
minOccurs="0" maxOccurs="1"/>
<xs:element name="ReportingThirdPartyTaxService" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:sequence>
<xs:element name="TransactionTaxCodeData" type="eic:TransactionTaxCodeData"
minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="WithholdingTaxCodeData" type="eic:WithholdingTaxCodeData"
minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:choice>
</xs:sequence>
</xs:complexType>

<xs:complexType name="TransactionTaxCodeData">
<xs:sequence>
<xs:element name="TaxApplicability" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxCode" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxableAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxRateData" type="eic:TransactionTaxRateData" minOccurs="1"
maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="WithholdingTaxCodeData">
<xs:sequence>
<xs:element name="TaxCode" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxRateData" type="eic:WithholdingTaxRateData" minOccurs="1"
maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="TransactionTaxRateData">
<xs:sequence>
<xs:element name="TaxType" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxRate" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Jurisdiction" type="xs:string" minOccurs="0" maxOccurs="1"/> <!--
from reporting third party tax only -->
<xs:element name="TaxPointDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="TaxPointDateType" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="TaxRatePercent" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="EffectiveTaxRatePercent" type="xs:decimal" minOccurs="0"
maxOccurs="1"/>
<xs:element name="TaxAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="WithholdingTaxRateData">
<xs:sequence>
<xs:element name="TaxType" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxRate" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="TaxBaseType" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="RealizationPoint" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="SubjectToWithholdingAmount" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="TaxRatePercent" type="xs:decimal" minOccurs="0" maxOccurs="1"/>
<xs:element name="TaxAmount" type="xs:decimal" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="NonReportingThirdPartyTax">
<xs:sequence>
<xs:element name="ThirdPartyTaxService" type="xs:string" minOccurs="1" maxOccurs="1"/
>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 824

<xs:element name="TaxCalculationDetails" type="xs:string" minOccurs="0"


maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="AdditionalTaxIDs">
<xs:sequence>
<xs:element name="TaxID" type="eic:TaxID" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="AdditionalCompanyTaxIDs">
<xs:sequence>
<xs:element name="TaxID" type="eic:TaxID" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="AdditionalCustomerTaxIDs">
<xs:sequence>
<xs:element name="TaxID" type="eic:TaxID" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="TaxID">
<xs:sequence>
<xs:element name="Country" type="eic:Country" minOccurs="1" maxOccurs="1"/>
<xs:element name="Type" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Number" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="NationalTaxIDCode" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="PaymentDetail">
<xs:sequence>
<xs:element name="PaymentStatus" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="PaymentTerms" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="PaymentType" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="PayInNumberOfDays" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="PayeeBank" type="eic:PayeeBank" minOccurs="0" maxOccurs="1"/>
<xs:element name="DirectDebitMandate" type="eic:DirectDebitMandate" minOccurs="0"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="PayeeBank">
<xs:sequence>
<xs:element name="BankAccountNumber" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BankIdentificationCode" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="IBAN" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BankID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BranchID" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="DirectDebitMandate">
<xs:sequence>
<xs:element name="Reference" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BankAccountNumber" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BankIdentificationCode" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="IBAN" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BankID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="BranchID" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="AlternateName">
<xs:sequence>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Usage" type="xs:string" minOccurs="1" maxOccurs="unbounded"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 825

</xs:sequence>
</xs:complexType>

<xs:complexType name="ElectronicInvoicing">
<xs:sequence>
<xs:element name="CustomerStartDate" type="xs:date" minOccurs="0" maxOccurs="1"/>
<xs:element name="GovernmentIssuedCustomerID" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="VendorID" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="VendorIssuedCustomerID" type="xs:string" minOccurs="0"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Address">
<xs:sequence>
<xs:element name="AddressID" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Country" type="eic:Country" minOccurs="1" maxOccurs="1"/>
<xs:element name="FormattedAddress" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="AddressLine1" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine1Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine2" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine2Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine3" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine3Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine4" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine4Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine5" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine5Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine6" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine6Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine7" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine7Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine8" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine8Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine9" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="AddressLine9Local" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="City" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="CityLocal" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="CitySubdivision1" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="CitySubdivision1Local" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="CitySubdivision2" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="CitySubdivision2Local" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="CountryCity" type="eic:CountryCity" minOccurs="0" maxOccurs="1"/>
<xs:element name="Region" type="eic:CountryRegion" minOccurs="0" maxOccurs="1"/>
<xs:element name="RegionSubdivision1" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="RegionSubdivision1Local" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="RegionSubdivision2" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="RegionSubdivision2Local" type="xs:string" minOccurs="0"
maxOccurs="1"/>
<xs:element name="PostalCode" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Contact">
<xs:sequence>
<xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="Phone" type="eic:Phone" minOccurs="0" maxOccurs="1"/>
<xs:element name="Email" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Phone">
<xs:sequence>
<xs:element name="Type" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="Number" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 826

<xs:complexType name="Currency">
<xs:sequence>
<xs:element name="ISO-Alpha-3-Code" type="xs:string" minOccurs="1" maxOccurs="1"/
><!-- three digit alpha code -->
<xs:element name="ISO-Numeric-3-Code" type="xs:int" minOccurs="1" maxOccurs="1"/><!--
three digit numeric code -->
</xs:sequence>
</xs:complexType>

<xs:complexType name="Country">
<xs:sequence>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="ISO-Alpha-2-Code" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="ISO-Alpha-3-Code" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="ISO-Numeric-3-Code" type="xs:int" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="CountryRegion">
<xs:sequence>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="ISO-Alpha-2-Code" type="xs:string" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="CountryCity">
<xs:sequence>
<xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="NumericCode" type="xs:string" minOccurs="1" maxOccurs="1"/>
<xs:element name="ParentCountryISO-Alpha-3-Code" type="xs:string" minOccurs="1"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>

</xs:schema

Electronic Payment Integrations

Steps: Set Up Bank Integrations for Settlement Processing

Context
You can integrate Workday with bank accounts for settlement processing and check printing to specify:
• Which payment protocol to use.
• How to format the payment data to meet bank requirements.
• Whether to encrypt the file or generate a unique filename each time the integration runs.
• Where to deliver the payment file.
To generate payment files for settlement processing, you can:
• Create 1 or more integration systems for each combination of bank and electronic payment type.
• Assign multiple integration systems to a single bank account. Example: You want to process payments
that are of the same type but in different categories or countries.
• Use the same integration for each account in the same bank with the same payment type.
Use a Document Transformation integration step to deliver output files in bank-specific protocol formats
or you’ll get errors when sending the output file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 827

Steps
1. Create ID Definitions and Sequence Generators.
Configure the payment sequence generator to format the ID that Workday generates for each payment.
Note:
Your integration can fail unless you always configure:
• ACH payment sequences as numeric.
• Outsourced payment group sequences with at least 1 non-numeric character when you enable
payment acknowledgments for outsourced check payments.
2. Access the Edit Tenant Setup - Financials task.
Select the gapless sequence generator from the ID Generator for Payment External EFT ID prompt.
Security: Set Up: Tenant Setup - Financials domain in the System functional area.
3. Create Integration System on page 1854.
Workday recommends that you use the enhanced performance templates for faster processing.
Workday supports enhanced performance with these templates:
• Core Connector: Payments Outbound V2 (Enhanced Performance)
• WPN – ABA Payment (Enhanced Performance)
• WPN - ACH CCD Payment (Enhanced Performance)
• WPN - ACH CTX Payment (Enhanced Performance)
• WPN - ACH IAT Payment (Enhanced Performance)
• WPN - ACH PPD Payment (Enhanced Performance)
• WPN – BACS Standard 18 Payment (Enhanced Performance)
• WPN - ISO 20022 V2 Direct Debit (Enhanced Performance)
• WPN - ISO 20022 V3 (Enhanced Performance)
• WPN - Zengin (Enhanced Performance)
Workday also provides these templates:
• Core Connector: Payments Outbound
• WPN - ISO 20022 V2 for files in PAIN 001.001.02 format.
• WPN - ISO 20022 V9 Credit Transfer for files in PAIN.001.001.09 format to support global payment
processing.
4. Create an integration system user (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Process: Settlement
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
5. Select Integration System > Configure Integration Attributes from the related actions menu of your
integration system.
Specify a value for the attributes you want to use.
6. (Optional) Set Up Integration Sequence Generators on page 1856.
Workday requires this step when you enable the WPN - Payment File Name Generator integration
service.
7. Create Integration Notifications on page 30.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 828

8. (Optional) From the related actions menu of your integration system, select Integration System >
Configure Integration Maps.
When multiple companies use the same bank, map the companies and bank accounts to a bank-
recognized value on an integration map.
For ISO 20022 payment integrations, some banks and countries require that you include the bank
branch code as a suffix to the Credit Agent ID. To use this map, enable the WPN - ISO 20022
Payment integration service. To add the suffix, add the bank branch code to the Clearing System
Member Identification element on the SuffixBranchCodeToCreditorAgent integration map. To enable
the suffix for a particular country, add a map and enter:
• The country as the internal value.
• Any nonblank value as the external value.
Security: Integration Build domain in the Integration functional area.
9. Set Up Integration Delivery on page 1839.

Next Steps
Assign the integration system to the appropriate payment type in each bank account you want to use for
settlement processing.
Configure integration delivery by adding the Document Delivery step on the integration business process.

Steps: Set Up Electronic Filing 1099 Integration

Prerequisites
• Obtain a transmitter control code from the IRS.
• Review setup considerations for 1099 Reporting.

Context
You can create an integration system for Workday to generate 1099 electronic files, which you then:
• Download from the 1099 Work Area report.
• Manually upload to the US Internal Revenue Service (IRS) FIRE web site.

Steps
1. Create an Electronic Filing 1099 integration system:
• From the New Using Template prompt, select Electronic Filing 1099.
• On the Configure Integration Services page, leave the Electronic Filing 1099 Delivery Service
disabled.
See Create Integration System on page 1854.
Note: The delivery service can’t export files directly to the IRS. You don't need the delivery service to
retrieve 1099 files from the 1099 Work Area report.
2. (Optional) From the related actions menu of the Electronic Filing 1099 integration system, select
Integration System > Configure Integration Attributes.
You can specify how many days Workday retains 1099 files by selecting a retention period of up to 180
days on the Document Retention Policy attribute.
Security: Integration Build and Integration Configure domains in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 829

3. Grant the integration system user Get and Put access to these domains:
• Integration Event in the Integration functional area.
• Reports: Supplier Accounts 1099 in the Supplier Accounts functional area.
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Create an integration business process from the Electronic Filing 1099 integration system.
You don't need a document delivery Service step to download 1099 files from the 1099 Work Area
report.
See Create Integration Business Process on page 1838.
5. Configure the 1099 Electronic Filing Run Event business process.
See Steps: Set Up 1099 Electronic Filing Run Event Business Process on page 829.

Result
When you run the Generate 1099 Electronic Filing task, Workday launches the Electronic Filing 1099
integration system.

Next Steps
• Add your IRS transmitter control code to your tax IDs. See Set Up Company Tax Details for 1099
Reporting.
• Generate 1099 Electronic Files.
Related Information
Tasks
Steps: Set Up 1099 Reporting

Steps: Set Up 1099 Electronic Filing Run Event Business Process

Prerequisites
• Set up an Electronic Filing 1099 integration system.
• Security: These domains in the System functional area:
• Business Process Administration
• Manage: Business Process Definitions
• Configure the 1099 Electronic Filing Run Event business process and security policy in the Supplier
Accounts functional area.

Context
You can configure the 1099 Electronic Filing Run Event business process to launch Electronic Filing 1099
integrations.

Steps
1. Access the Edit Business Process Definition task for the 1099 Electronic Filing Run Event business
process.
See Edit Business Processes.
2. On the Business Process Steps grid, remove the document delivery Service step.
3. On the Business Process Steps grid, locate the Integration step and click Configure Integration
System, then select the Electronic Filing 1099 integration system in the Integration prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 830

4. On the Configure Integration Step page, select these values for the Electronic Filing 1099 ESB
Service:

Field Value Type Value


1099 Electronic Filing Run Determine Value at Runtime By Category > IRS 1099 > 1099
Electronic Filing Run Event

Convert Payment Integrations

Prerequisites
Security: Set Up: Migrate Payment Integration Systems to (Enhanced Performance) domain in Banking
and Settlement functional area.

Context
You can convert your existing payment integrations to use enhanced performance integration templates.
Enhanced performance integration templates use a Data Initialization Service (DIS) that:
• Enables you to customize the output of your payment integrations. You can configure which report
fields Workday uses to add data for fields in the integration.
• Improves performance.

Steps
1. Access the Migrate Payment Integration systems to (Enhanced Performance) task.
2. Select an integration template and the integration systems that you want to convert.
Related Information
Concepts
Concept: Data Initialization Service (DIS) on page 562
Tasks
Set Up Integration Field Overrides for DIS on page 1861

Concept: Electronic Payments


To create bank integrations for electronic payments made from or deposited to a particular bank account,
use an Electronic Payments integration template. You can create more than 1 integration system for each
combination of bank and payment type to support different payment categories or countries. Example: You
could have separate integrations for:
• Direct deposit payroll in the U.S.
• Direct deposit payroll in Canada.
Electronic Payments supports these payment protocols and service providers:
• Automated Clearing House:
• Cash concentration or disbursement with addenda (CCD+).
• Cash concentration or disbursement without addenda (CCD).
• Corporate Trade Exchange (ACH CTX).
• ACH Transactions (ACH IAT).
• Prearranged Payment and Deposit Entry (ACH PPD).
• Bankers' Automated Clearing Services (BACS).
• CyberSource credit card processing.
• International Organization for Standardization (ISO) 20022 (Version 2 and 3)
• Zengin payment file format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 831

Workday also provides electronic payment integration templates with enhanced performance to improve
integration processing times using the Data Initialization Service.
After the initial creation and configuration of a bank integration, the integration routes payments through
the Workday settlement engine. Workday provides these options for configuring payment routing to an
endpoint or endpoints:

Number of Endpoints Business Process for Delivery Configuration


Single Document Delivery Step on 1 of these business
processes:
• Payment Release Event
• Outsourced Payment Release Event

Multiple Document Delivery step on Integration Process


Event business process for each integration.

You base delivery on the bank account used in the settlement run. In addition, you can add one or more
Approval steps to the business process.
Related Information
Tasks
Steps: Set Up Settlement
Create Integration Business Process on page 1838

ELSTER Integrations

Steps: Generate ELSTER Tax Declaration XML

Prerequisites
• Create Tax Declaration Definitions.
• Security:
• Integration build domain in the Integration functional area.
• Set Up: Tax domain in the Common Financial Management functional area.

Context
You can generate an XML file based on a tax declaration run, according to the specifications of the
German tax authority. You can upload the XML file to the ELSTER tax portal, and annually update the
format of the tax declaration definition.

Steps
1. Create Integration System on page 1854.
Select German ELSTER Periodic VAT Return from the New Using Template prompt.
2. Select Integration System > Configure Integration Attributes as a related action on the integration
system and select Steuernummer for the Tax ID Type for Company Tax Registration Number attribute.
Workday uses the Tax ID Type value from the Company Tax Details task to populate the XML file.
3. Access the Edit Tax Declaration Definition Task.
On your tax declaration definition, select the Enable XML Creation check box and the relevant tax
reporting integration system and VAT return year.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 832

4. Select Integration System > Configure Integration Field Overrides as a related action on the
integration system.
a) Access the Umsatzsteuervoranmeldung (Sales Tax Pre-Registration) tab.
b) On the Field Overrides table, select Tax Declaration Result Line Amount from the Override
External Field prompt for each field you want to map.
c) Select tax declaration definition lines in the Value column to map them to the fields on the
integration system.
Workday will populate the values from the tax declaration lines in the corresponding fields on the
XML.
Example: Map the tax declaration line containing base taxable sales standard rate to the Kz81 field.
d) (Optional) You can configure additional fields as required on the Extended Fields table.
Add extended fields to update the integration system with changes to the XML file format.
e) (Optional) You can configure additional field overrides and extended fields on these tabs:
• DatenLieferant (Data Supplier)
• Berater (Consultant)
• Unternehmer (Entrepreneur)
5. (Optional) Select Integration System > Configure Integration Field Attributes as a related action on
the integration system.
Disable fields as required, or set maximum lengths to truncate values when data exceeds the length
permitted. To ignore any maximum lengths specified by Workday, set the maximum length to zero.
6. Access the Create Tax Declaration Run task.
See Create Tax Declarations.
Select a company in the Primary Company field if you're creating a run for a VAT group. Workday
uses the value in the Primary Company field to determine which company in the VAT group is the
primary contact.
Enter a complete calendar month or quarter in the Start Date and End Date fields. Workday won't
translate incomplete months or quarters to XML.
7. To generate the XML file, select Tax Declaration > Create XML File as a related action on the tax
declaration.
Note: Your tax declaration run must be in an approved state to access Create XML File.
You can select or enter these submission parameters to include in the XML:
• Corrected Registration (Box 10)
• Offset Reimbursement (Box 29)
• Revoke SEPA Direct Debit (Box 26)
• Additional Information (Box 23)
• Additional Information on Tax Return (Box 23B)
See Reference: Default Mappings for German ELSTER Periodic VAT Return Integrations on page
832.

Result
Workday generates the XML file for you to view and download under the Output Files tab.

Reference: Default Mappings for German ELSTER Periodic VAT Return Integrations
You can use field override attributes to map your tax declaration definition result line amounts using the
Workday delivered German ELSTER Periodic VAT Return Integration Template.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 833

Element Name English Name Default Mapping


Anmeldungssteuern Registration Taxes
Erstellungsdatum Creation Date Creation date of the xml file.
DatenLieferant DataSupplier
Name Name Full legal name of the user who
created the tax declaration run.
Strasse Street Street address and house
number of the data supplier. Must
be primary and public to include
in the XML file.
PLZ ZIP Postal code of the data supplier.
Must be primary and public to
include in the XML file.
Ort Location City address of the data supplier.
Must be primary and public to
include in the XML file.
Telefon Phone Must be the primary work phone
number of the data supplier to
include in the XML file.
Email Email Must be the primary email of the
data supplier to include in the
XML file.
Steuerfall Control Case
Berater Consultant
Bezeichnung Title Not mapped by default.
Name Name Not mapped by default.
Vorname First Name Not mapped by default.
Namensvorsatz Name Prefix Not mapped by default.
Namenszusatz Name Suffix Not mapped by default.
Str Street Not mapped by default.
Hausnummer House Number Not mapped by default.
HNrZusatz House Number Supplement Not mapped by default.
AnschriftenZusatz Address Supplement Not mapped by default.
Ort Location Not mapped by default.
PLZ PostCode Not mapped by default.
AuslandsPLZ PostCode - if address is abroad Not mapped by default.
Land Country - if address is abroad. Not mapped by default.
PostfachOrt Location PO Box Not mapped by default.
Postfach PO Box Not mapped by default.
PostfachPLZ PO Box Zip Code Not mapped by default.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 834

Element Name English Name Default Mapping


GKPLZ Major Customer Zip Code Not mapped by default.
Telefon Phone Not mapped by default.
Email Email Not mapped by default.
Unternehmer Entrepreneur
Bezeichnung Designation Company name as of the last day
of the tax declaration run.
Str Street Primary public address of the
company, Address Line 1.
Hausnummer House Number Primary public address of the
company, Address Line 3.
AnschriftenZusatz Address Supplement Primary public address of the
company, Address Line 2.
Ort Location City of the primary address of the
company.
PLZ PostCode Postcode of the primary address
of the company.
AuslandsPLZ PostCode - if address is abroad. Company postcode if the address
isn't in Germany.
Land Country - if address is abroad Country of the company address
if the address isn't in Germany.
Postfach PO Box Primary public address of the
company, Address Line 4.
Telefon Phone Primary public phone number of
the company.
Email Email Primary public email address of
the company.
Umsatzsteuervoranmeldung Sales tax pre registration (UStVA)
Jahr Year Year of the tax declaration run
end date.
Zeitraum Period Period based on the start date
and the end date of the tax
declaration run. It must be a full
calendar month (01 for January,
02 for February etc.) or a full
calendar quarter (41 for the first
quarter, 42 for the second etc).
Steuernummer Tax Number Company tax ID based on the
Tax ID Type for Company Tax
Registration Number integration
attribute and the value set for the
Tax ID Type for the company tax
details.
Kz09 Not in use.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 835

Element Name English Name Default Mapping


Kz10 Corrected registration Workday populates this field
when you select the Corrected
Registration (Box 10) check box
when you generate the XML.
Kz22 Documents Not in use.
Kz23 Workday populates this field
when you select the Additional
Information (Box 23) check box
when you generate the XML.
Kz23_Begruendung Workday populates this field
when you enter text in the
Additional Information on Tax
Return (Box 23B) field when you
generate the XML.
Kz26 Workday populates this field
when you select the Revoke
SEPA Direct Debit (Box 26)
check box when you generate the
XML.
Kz29 Workday populates this field
when you select the Offset
Reimbursement (Box 29) check
box when you generate the XML.
Kz21, Kz35-Kz98 Workday populates based on the
tax declaration lines mapped to
the individual fields.

FEC Integration

Steps: Set Up FEC Integration

Prerequisites
Enable journal sequencing for your company as required by the tax authority.

Context
You can create an integration to generate fichier des écritures comptables (FEC) audit files from
accounting entries to present to French tax authorities.

Steps
1. Create Integration System.
Select FEC Template on the New Using Template prompt.
Enable the optional document retrieval service when:
• You want to use a custom XSD to provide additional information on journal lines.
• The tax authority supplies a new XSD.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 836

2. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
3. (Optional) Set Up Integration Retrieval on page 1845.
When you want to use a custom XSD or the tax authority supplies a new one, provide the schema to
use.
4. (Optional) Select Integration System > Configure Integration Attributes as a related action on the
integration system.
Enter integration service attributes. When you provide a different XSD, specify the schema that the XSD
is designed to validate against.
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure
5. Launch an Integration on page 23.
When your company generates more than 5 million journal lines each month, Workday recommends
that you:
• Schedule the integration to run outside normal business hours.
• Run the integration for each month separately.

Next Steps
Submit your FEC file to the tax authority.

Concept: FEC Integration


Workday provides the FEC Template integration template to enable you to generate fichier des écritures
comptables (FEC) audit files. The FEC integration exports accounting entries in the XML format specified
by the French tax authority.

Integration Services
You can use the optional FEC_Schema_Retrieval integration service to configure document retrieval
to provide an updated FEC schema if the tax authority changes its requirements. You can also use it to
provide a custom XSD that includes additional information on journal lines.

Output Files
Every time the integration runs, Workday generates a:
• ZIP file containing the FEC XML file.
• Message log HTML file.
You can use the message log to troubleshoot validation errors. It includes the first 500 errors found during
the integration run.
You can find these files on the Output Files tab of the integration event. These files display for each
integration run.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 837

Financial Journal Lines Outbound Connector

Steps: Set Up Financial Journal Lines Outbound Connector

Context
You can create an integration to export high volumes of journal lines from Workday to a single CSV or
XML file. You can also configure your integration to summarize and group your journal line data for an
aggregated output file.

Steps
1. Access the Create Integration System task.
a. Select Financial Journal Lines Outbound Connector from the New using Template prompt.
b. (Optional) Enable all or some of the integration template services. As you complete the task,
consider:

Option Description
Accounting Date Filter Service Select to configure these integration launch
parameters:
• Accounting Start Date
• Accounting End Date
When you select this service, you can't select
these services:
• Aggregation and Summarization Service
• Eliminations or Translations Filter

Eliminations or Translations Filter Select to enable these additional integration


launch parameters:
• Account Translation Rule Set
• Calculate Translation Gain or Loss
• Eliminations Only
• Perform Intercompany Elimination
• Perform Interworktag Elimination
• Translation Currency

Aggregation and Summarization Service Select to summarize journal line data by Group By
dimensions when you run the integration.
Enable Message Auditing Select to include audit details in the integration
output. Example:
• The user launching the integration.
• The integration launch details.
• The configured launch parameters.

Security: Integration Build domain in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 838

2. (Optional) Select Integration System > Configure Integration Attributes from the related actions
menu of the integration system.
As you complete the task, consider:
Option Description
Output File Format Configure to change the output file format from
CSV to XML.
Compress Output Configure to compress the output file.

Security: These domains in the Integration functional area:


• Integration Build
• Integration Configure
3. Select Integration System > Configure Integration Field Attributes from the related actions menu of
the integration system.
Select the Include in Output check box for the fields to include in the output file.
Only configure Summary Journal Line Data integration attributes when you enable the Aggregation
and Summarization Service integration template service.
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure
4. (Optional) Select Integration System > Configure Integration Field Overrides from the related
actions menu of the integration system.
Add extended fields to include on the output file. Examples: Cost Center instances, Cost Center
Manager calculated fields. When you use the Value as a group by launch parameter, you must specify
a unique Name.
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure
5. Launch an Integration on page 23.
To generate an output file that uses:

Integration Attribute Launch Parameter


Detailed Journal Line Data Leave the Group By prompt blank.
Summary Journal Line Data Select the same dimensions in the Group
By prompt as in your integration attribute
configuration.

Related Information
Reference
2022R2 What’s New Post: Export High-Volume Journal Lines
2022R1 What’s New Post: Export High-Volume Journal Lines

Reference: Financial Journal Lines Outbound Connector XML Schema

<xsd:schema xmlns:xsd=“http://www.w3.org/2001/XMLSchema”
xmlns:wd=“urn:com.workday/bsvc” xmlns:nyw=“urn:com.netyourwork/aod”
elementFormDefault=“qualified” attributeFormDefault=“qualified”
targetNamespace=“urn:com.workday/bsvc”>
<xsd:element name=“JournalLine” type=“wd:JournalLineType” />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 839

<xsd:complexType name=“Journal_Line_DocumentType”>
<xsd:sequence>
<xsd:element name=“Detailed_Journal_Line_Data”
type=“wd:Detailed_Journal_Line_DataType” minOccurs=“0"
maxOccurs=“unbounded” />
<xsd:element name=“Summary_Journal_Line_Data”
type=“wd:Summary_Journal_Line_DataType” minOccurs=“0" maxOccurs=“unbounded” /
>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name=“JournalLineType”>
<xsd:sequence>
<xsd:element name=“Journal_Line_Document”
type=“wd:Journal_Line_DocumentType” minOccurs=“0” maxOccurs=“unbounded” />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name=“Detailed_Journal_Line_DataType”>
<xsd:sequence>
<xsd:element name=“Journal_Line_WID” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“As_Entered_Company” type=“xsd:string”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Journal_Source” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Journal_Number” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Operational_Journal” type=“xsd:boolean”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Period” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Year” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Ledger_Period” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Ledger_Currency” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Transaction_Currency” type=“xsd:string”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Translation_Currency” type=“xsd:string”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Accounting_Date” type=“xsd:date” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Ledger_Account” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Balance_Sheet_Ledger_Account” type=“xsd:string”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Alternate_Account” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Balance_Sheet_Alternate_Account” type=“xsd:string”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Ledger_Debit_Amount” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Ledger_Credit_Amount” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Ledger_Debit_Minus_Credit” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Ledger_Credit_Minus_Debit” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Transaction_Debit_Amount” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Transaction_Credit_Amount” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Transaction_Debit_Minus_Credit” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 840

<xsd:element name=“Transaction_Credit_Minus_Debit” type=“xsd:decimal”


minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Translated_Debit_Amount” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Translated_Credit_Amount” type=“xsd:decimal”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Translated_Debit_Minus_Credit_Amount”
type=“xsd:decimal” minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Translated_Credit_Minus_Debit_Amount”
type=“xsd:decimal” minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Translated_and_Prorated_Debit_Minus_Credit”
type=“xsd:decimal” minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Translated_Amount_for_Natural_Debit_or_Credit”
type=“xsd:decimal” minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Last_Updated_Moment” type=“xsd:dateTime”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Journal_Status” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Operational_Transaction” type=“xsd:string”
minOccurs=“0" maxOccurs=“1” />
<xsd:element name=“Created_By” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Journal” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Memo” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Line_Memo” type=“xsd:string” minOccurs=“0"
maxOccurs=“1” />
<xsd:element name=“Reversed_Journal” type=“xsd:boolean” minOccurs=“0"
maxOccurs=“1” />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name=“Summary_Journal_Line_DataType”>
<xsd:sequence>
<xsd:element name=“Fiscal_Period” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Financial_Period” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Book_Code” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Business_Unit” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Company” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Intercompany_Affiliate” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Cost_Center” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Customer” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Expense_Item” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Fund” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Gift” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Grant” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Ledger_Account” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Balance_Sheet_Ledger_Account” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Investor” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 841

<xsd:element name=“Location” type=“xsd:string” minOccurs=“0”


maxOccurs=“1" />
<xsd:element name=“Opportunity” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Project” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Program” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Prospect” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Region” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Revenue_Category” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Sales_Item” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Spend_Category” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Sponsor” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Supplier” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Organization_01” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_02” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_03” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_04” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_05” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_06” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_07” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_08” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_09” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_10” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_01” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_02” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_03” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_04” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_05” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_06” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_07” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_08” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_09” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_10” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_11” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 842

<xsd:element name=“Custom_Worktag_12” type=“xsd:string” minOccurs=“0”


maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_13” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_14” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_15” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Ledger_Debit_Amount” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Credit_Amount” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Debit_Minus_Credit” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Credit_Minus_Debit” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Amount_for_Natural_Debit_or_Credit”
type=“xsd:decimal” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Transaction_Debit_Amount” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Transaction_Credit_Amount” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Transaction_Debit_Minus_Credit” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Transaction_Credit_Minus_Debit” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Translated_Debit_Amount” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Translated_Credit_Amount” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Translated_Debit_Minus_Credit” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Translated_Credit_Minus_Debit” type=“xsd:decimal”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Translated_Amount_for_Natural_Debit_or_Credit”
type=“xsd:decimal” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Currency” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Transaction_Currency” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Translation_Currency” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Fiscal_Period_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Fiscal_Period_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Financial_Period_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Financial_Period_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Book_Code_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Book_Code_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Business_Unit_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Business_Unit_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Company_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Company_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Intercompany_Affiliate_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 843

<xsd:element name=“Intercompany_Affiliate_WID” type=“xsd:string”


minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Cost_Center_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Cost_Center_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Customer_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Customer_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Expense_Item_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Expense_Item_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Fund_Reference_ID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Fund_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Gift_Reference_ID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Gift_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Grant_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Grant_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Ledger_Account_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Account_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Balance_Sheet_Ledger_Account_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Balance_Sheet_Ledger_Account_WID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Investor_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Investor_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Location_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Location_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Opportunity_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Opportunity_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Project_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Project_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Program_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Program_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Prospect_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Prospect_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Region_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Region_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Revenue_Category_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 844

<xsd:element name=“Revenue_Category_WID” type=“xsd:string”


minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Sales_Item_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Sales_Item_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Spend_Category_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Spend_Category_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Sponsor_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Sponsor_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Supplier_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Supplier_WID” type=“xsd:string” minOccurs=“0”
maxOccurs=“1" />
<xsd:element name=“Custom_Organization_01_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_01_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_02_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_02_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_03_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_03_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_04_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_04_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_05_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_05_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_06_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_06_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_07_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_07_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_08_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_08_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_09_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_09_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_10_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Organization_10_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_01_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_01_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_02_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 845

<xsd:element name=“Custom_Worktag_02_WID” type=“xsd:string”


minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_03_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_03_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_04_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_04_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_05_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_05_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_06_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_06_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_07_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_07_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_08_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_08_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_09_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_09_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_10_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_10_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_11_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_11_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_12_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_12_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_13_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_13_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_14_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_14_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_15_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Custom_Worktag_15_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Currency_Reference_ID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Ledger_Currency_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Transaction_Currency_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Transaction_Currency_WID” type=“xsd:string”
minOccurs=“0” maxOccurs=“1" />
<xsd:element name=“Translation_Currency_Reference_ID”
type=“xsd:string” minOccurs=“0” maxOccurs=“1" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 846

<xsd:element name=“Translation_Currency_WID” type=“xsd:string”


minOccurs=“0” maxOccurs=“1" />
</xsd:sequence>
</xsd:complexType>
</xsd:schema>
Related Information
Reference
2022R2 What’s New Post: Export High-Volume Journal Lines
2022R1 What’s New Post: Export High-Volume Journal Lines

Financial Management Connector for Salesforce

Steps: Set Up Financial Management Connector for Salesforce

Prerequisites
Note: The solutions described in this section are not part of the Workday Service. See Legal Notice for
details.
• The Workday Financial Management Connector app in Salesforce requires separate purchase.
• For configuration details for Salesforce, access the Salesforce administrator documentation.

Context
Implement an integration to sync Salesforce sales data between Workday.

Steps
1. Access the Workday Financial Management Connector page on AppExchange.
2. Download and install the Financial Management Connector for Salesforce app.
On the installation page, select Install For Admins Only.
3. In Salesforce.com, grant access to the permission sets for the applicable workers:
Option Description
Workday System Admin Set Has Read and Edit access for the app. Can
perform Sync Now operation.

Workday Customer Support Set Has Read access for the app. Can perform Sync
Now operation.
Workday Others Set Can perform Sync Now operation.
4. Add a tab for the Workday app in Salesforce.
5. Configure remote site settings in Salesforce. See the applicable data center page for your tenant data
center for URLs and URL formats.

Name to Apply Refers to this URL Name on Data Center page


URL URL for Web Services
ESB URL URL for Cloud Listener for Studio Integrations
6. Create a security certificate in your Salesforce site.
7. Configure page layouts for the account page and other pages in Salesforce.
8. Configure field-level permissions for all fields for Sync Queue Field and Sync Queue Scenario table.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 847

9. Register API Clients.


As you complete the task, consider:
Option Description
Client Grant Type JWT Bearer Grant
x509 Certificate Create an X.509 certificate using the security key
that you created in Salesforce.
Access Token Type Bearer
Allow Integration Messages Yes
Scope (Functional Areas) • Customer Accounts
• Customer Contracts
• Customers
• Integration
• Project Tracking
• Worktags

Record the Client ID, Token Endpoint, and REST API Endpoint values. You use these values when
you configure the integration.
10.Create an Integration System User (ISU) and grant the ISU Get and Put access to these security
domains:
• (Optional) Customer Banking Change Event (business process)
• (Optional) Customer Credit Change Event (business process)
• (Optional) Customer Payment Change Event (business process)
• (Optional) Customer Summary Change Event (business process)
• Customer Event (business process)
• Create Project (business process)
• Integration Event
• Integration Process
• Manage: Related Worktags
• Process: Opportunity
• Reports: Customer Accounts
• Set Up: Customer Maintenance
• View: Customer
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
11.Start the Financial Management Connector for Salesforce, navigate to Integration Settings, and add a
new environment. As you complete the task, consider:
Option Description
Environment Name Examples: Production, Sandbox.
User Select the account that you created in Step 2.
Tenant Enter the Workday tenant name (case-sensitive).
Use the Test button to verify if you configured the
endpoints correctly.
Token Endpoint Value from Step 1.
Integration EndPoint Full Uniform Resource Locator (URL) of your
tenant endpoint for this integration. Access the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 848

Option Description
Workday for Salesforce Connector Settings
task to look up this value.
REST API Endpoint Value from Step 1.
x509 Security Certificate Source Select Salesforce Certificate.
Certificate Name Enter a valid security certificate.
Client ID Value from Step 1.
12.Configure the Salesforce Workday Sync settings in the Integration Settings section of the app.
13.Configure the Workday Salesforce Sync settings in the Integration Settings section of the app.
14.(Optional) Click Test and verify that the endpoints are configured correctly.
15.Access your Salesforce site and add the Workday endpoint to the remote site settings.
16.(Optional) Perform any of these configuration steps in your Salesforce tenant:
• Add and configure custom fields. Examples: Customer Category, Currency, Company, Workday ID.
• Add the Visualforce integration report to source objects.
• Add a Sync Now button.
• Configure the Financial Management Connector for Salesforce app as a tab in Salesforce.
17.Set Up Salesforce Tenant for Financial Management Connector for Salesforce on page 848.

Set Up Salesforce Tenant for Financial Management Connector for Salesforce

Prerequisites
Security: Not applicable.
Download the Financial Management Connector for Salesforce app from the Salesforce AppExchange.

Context
Enter settings required by your Financial Management Connector for Salesforce integration.

Steps
1. Access your Salesforce tenant and start the Financial Management Connector for Salesforce app.
2. Select an existing Scenario template or select + New Scenario to create a new Scenario.
a) Select the object to map.
b) Specify synchronization rules.
c) Add field mappings.
d) Add value mappings.
Tips:
• When configuring a scenario to create a Customer in Workday, include the Workday Customer
Category field in the field mappings. You can add a custom field with field and value mappings, or
specify a standard value.
• State and Country codes might need value mappings.
3. Repeat Step 2 for each additional Scenario.
You can create multiple scenarios sourced from the same Salesforce object that map to different
objects in Workday. The scenario data syncs to Workday in alphabetical order by scenario name.
4. Connect the Financial Management Connector for Salesforce to Workday.
a) Select your Workday environment and select Connect Environment.
b) Select Enable Sync for each Scenario that you want to enable.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 849

Related Information
Reference
2022R2 What's New Post: Customer Connection Map for Salesforce Workday Connector

Concept: Financial Management Connector for Salesforce


Note: The solutions described in this section are not part of the Workday Service. See Legal Notice for
details.
You can use Financial Management Connector for Salesforce to:
• Import selected sales data from your Salesforce.com tenant into Workday.
• Display Workday customer activity data in Salesforce.
The Financial Management Connector for Salesforce is a prebuilt, configurable Salesforce app that
reduces the time and effort necessary to integrate between Salesforce.com and Workday. The Financial
Management Connector for Salesforce enables you to automate your sales processes by connecting an
opportunity management service with Workday Financials processes. The integration enables you to view
these Workday account transactions in Salesforce without a Workday account:
• Invoices
• Payments
• Adjustments
• Writeoffs
• Payment Returns
• Refunds
• Transfers In and Out

About the Financial Management Connector for Salesforce App


Workday doesn't host the Financial Management Connector for Salesforce within your Workday tenant.
The Financial Management Connector for Salesforce is a Salesforce app available on AppExchange. You
install and manage the Financial Management Connector for Salesforce in your Salesforce tenant. The
Financial Management Connector for Salesforce is a two-way integration that sends data back and forth
between Workday and Salesforce. This Connector requires security configuration in your Workday tenant.
You can specify how often the Financial Management Connector for Salesforce sends data to your
Workday tenant. The Financial Management Connector for Salesforce enables to create scenario-specific
synchronization rules. Using Scenarios, you can:
• Define rules to specify when the Financial Management Connector for Salesforce sends data to
Workday.
• Map fields and field values between Salesforce.com and Workday, including entering default values for
fields.

Integration Process
As events occur in Salesforce.com, the Financial Management Connector for Salesforce adds the events
to an internal queue. At the scheduled synchronization time or on demand, the Financial Management
Connector for Salesforce sends data to Workday.
If the synchronization fails, the Financial Management Connector for Salesforce attempts to reconnect
using exponential back off. The Financial Management Connector for Salesforce attempts to reconnect for
24 hours.
The Financial Management Connector for Salesforce provides these reports in the Salesforce app:
• View Current Sync Item Status
• View Integration Logs

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 850

GoBD Integration

Steps: Set Up GoBD Integration

Prerequisites
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure

Context
You can use the GoBD integration template to extract tax-relevant data from Workday. The template
generates audit files that you can give to German tax authorities under category Z3 of GoBD tax
regulations.

Steps
1. Create Integration System.
Select GoBD Template from the New Using Template prompt.
2. (Optional) Set Up Integration Field Overrides for DIS on page 1861.
Specify additional fields to include or values to change in the output. You can only add fields related to:
• Customer invoices.
• Expense reports.
• Journals.
• Supplier invoices.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. Launch an Integration on page 23.
As you prepare to launch the integration, consider:
Option Description
Account Set The set of accounts that provide the source data
for your integration.
Ledger The type of ledger that your integration uses to
generate your audit files.
Book The book of accounting standards that your
integration uses to generate your audit files.
Time Period The period of time that your integration references
in your audit files.
Period A specific interval of time within your Time Period
value.

Result
Your integration generates an output folder containing:
• Tax audit files in CSV format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 851

• An XML index file.


• A DTD validation file.

Next Steps
Download and review your output files before sending them to your tax auditor.

Concept: GoBD Integration


You can use the GoBD integration template to extract tax-relevant data from Workday and generate
audit files to present to German tax authorities. Depending on the source data you provide in the launch
parameters, the GoBD integration generates up to 4 output audit files:
• DEU Audit File Customer Invoices.
• DEU Audit File Expenses.
• DEU Audit File GL Entries.
• DEU Audit File Supplier Invoices.

GoBD Output Files


The GoBD integration template generates CSV output files that display values up to 2 decimal places.
Workday rounds off any values greater than 2 decimal places in your audit files.
The CSV output files of the GoBD integration template use a semicolon as a delimiter.
The GoBD integration template also generates a DTD validation file and an XML index file.

Digital Audits
For digital audits under category Z3 of GoBD tax regulations, you must submit a zip folder containing:
• CSV audit files.
• A DTD validation file.
• An XML index file.

Inventory Label Data Integrations

Steps: Set Up Integrations for Inventory Label Data

Context
You can create integrations that can export inventory label data to a third-party application for easier
printing.
Workday provides several integration templates that support inventory label data. Each template supports
a different type of inventory label data. Perform this procedure once for each integration template.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 852

Steps
1. Access the Create Integration System task and enter the applicable template name at the New using
Template prompt:
• Inventory Label Printing Enabled Locations Template
• Inventory Label Printing Goods Delivery Groups Template
• Inventory Label Printing Goods Delivery Tickets Template
• Inventory Label Printing Inventory Locations Template
• Inventory Label Printing Locations Template
• Inventory Label Printing Par Locations Template
• Inventory Label Printing Receipts Template
Security: Integration Build in the Integration functional area.
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
4. Select Integration System > Configure Integration Field Attributes as a related action on your
integration system and select which fields to include on the integration output file.
5. Set Up Integration Delivery on page 1839.
Specify how Workday delivers integration output files to the external endpoint.
6. Set Up Integration Sequence Generators on page 1856.
7. Create Integration (Step).
Add and configure these Integration steps to the Inventory Label Event business process:

Integration Based on Template Step Integration Criteria


Inventory Label Printing b Value Type: Determine Value at
Locations Template Runtime
Value: Inventory Label Location

Inventory Label Printing Goods c Value Type: Determine Value at


Delivery Groups Template Runtime (both fields).
Value (Requested Goods
Delivery Groups) Inventory
Label Goods Delivery Group for
Inventory Label Event
Value (Requested Number
of Copies): Inventory Label
Number of Copies

Inventory Label Printing Par d Value Type: Determine Value at


Locations Template Runtime (both fields).
Value (Requested Purchase
Item): Inventory Label Par Item
Value (Requested Inventory Par
Location): Inventory Label Par
Location

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 853

Integration Based on Template Step Integration Criteria


Inventory Label Printing Goods e Value Type: Determine Value at
Delivery Tickets Template Runtime
Value: Inventory Label Goods
Delivery Ticket

Inventory Label Printing f Value Type: Determine Value at


Inventory Locations Template Runtime (all 3 fields).
Value (Requested Purchase
Item): Inventory Label Item
Value (Requested Location with
Inventory Usage): Inventory
Label Location
Value (Requested Include
Subordinates): Inventory Label
Include Subordinates

Inventory Label Printing g Value Type: Determine Value at


Receipts Template Runtime
Value (Receipt Line): Inventory
Label Receipt Line

8. Create Integration (Step).


Add the integration based on the Inventory Label Printing Goods Delivery Groups Template integration
template to the Goods Delivery Group business process and configure integration criteria:

Field Value Type Value


Requested Goods Delivery Determine Value at Runtime Inventory Label Goods Delivery
Groups Group for Goods Delivery Group
BP
Requested Number of Copies Specify Value Enter the required number of
labels.
9. Create Integration (Step).
Add the integration based on the Inventory Label Printing Goods Delivery Tickets Template integration
template to the Goods Delivery Event business process. Configure the same integration criteria as Step
8.
Add and configure these steps on the Goods Delivery Event business process:

Type Step Integration Criteria


Service (Create Goods Delivery c N/A
Run From Goods Delivery
Ticket)
Inventory Label Printing Goods d Value Type: Determine Value at
Delivery Tickets Template Runtime
Value:Goods Delivery Ticket
Label

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 854

10.Create Integration (Step)


Add the integration based on the Inventory Label Printing Receipts Template integration template to the
Receipts business process.
Add and configure these steps on the Receipts business process:

Type Step Integration Criteria


Service Varies depending on your Label Printing with Receipt BP
business process configuration.
Integration Varies, but must immediately N/A
follow step in previous row.

Next Steps
Workday provides preconfigured field attributes for your integration system, but you can also configure
field override and extension values for your integration fields on certain template types, enabling you to
add specific data fields to your integration. After completing your integration template, access the View
Integration System task. From the Related Actions menu, select Integration System > Configure
Integration Field Override:
• Access the the fields you want to alter in the Field Overrides section at the header and/or line layer of
your service.
• Use the External Fields section to add XML elements to your integration system.

Concept: Inventory Label Data Integrations


Workday enables you to create integrations that export inventory label data in a Workday-defined file
format. You can use these files with an external label printing service or application. Using configurable
data sections or Workday-delivered report fields and calculated fields that you create, you can specify
which data fields to include in the integration output files.
Workday provides integration templates that support different types of inventory labels:
• Inventory Label Printing Goods Delivery Tickets Template
• Inventory Label Printing Goods Delivery Groups Template
• Inventory Label Printing Inventory Locations Template
• Inventory Label Printing Locations Template
• Inventory Label Printing Par Locations Template
• Inventory Label Printing Receipts Template

Integration Files and Reports


Every time an integration runs, Workday generates these files:
• Data Changes Audit file, which is a readable version of the integration output file.
• Diagnostic Audit file, which helps you troubleshoot integration errors.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because actual data is included in the Data Changes Audit file, you might need to secure this file
separately.

Reference: Inventory Label Data Integration Data Sections


Before you build an integration with one of the Inventory Label Data integration templates, familiarize
yourself with each data section. Understand which fields are available for output and how the configuration
options affect integration behavior.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 855

Inventory Label Printing Goods Delivery Groups Template

Section Description/Notes Fields


Goods Delivery Group Data Workday includes these fields • Group Number
in the integration output file • Description
automatically: • Assigned To
• Number of Copies • Created Date
• Label Printer • Number of Copies
• Label Template • Label Printer
• Label Template

Inventory Label Printing Goods Delivery Tickets Template

Section Description/Notes Fields


Goods Delivery Ticket Data N/A • Goods Delivery Ticket
• Number of Copies
• Label Printer
• Label Template

Goods Delivery Ticket N/A • Just in Time Goods Delivery


• Created Date
• Created by Worker
• Deliver-To
• Deliver-To Address
• Delivery Ticket
• Origin
• Originating Business
Document
• Requester

Inventory Label Printing Inventory Locations Template

Section Description/Notes Fields


Inventory Location Data N/A • Location
• Item Descriptor
• Item Inventory Attributes
• Is Preferred Picking Location
• Is Default Put Away Location
• Label Printer
• Label Template

Location Includes single Inventory Location • Global Location Number -


Attributes subsection. GLN
• Location External Name
• Location Identifier
• Location Name
• Inventory Location Attributes

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 856

Section Description/Notes Fields


Inventory Location Attributes Subsection of Location section. • Inventory Location
• Inventory Location Chain
• Inventory Location Usage
Type
• Inventory Site
• Inventory Zone

Item Descriptor Includes single Manufacturers for • CAS Number


Procurement Item subsection. • CDM Code
• GTIN
• HPCPS Code
• Is Controlled
• Is Energy Star
• Is Green
• Is Hazardous
• Is Latex-Free
• Is Patient Chargeable
• Is Radioactive
• Is Refrigerated
• Is Reusable
• Is Toxin
• Item Description
• Packaging String
• Item Identifier
• Item Name
• Manufacturer String
• Manufacturer Part ID
• Manufacturers for
Procurement Item
• Spend Category for Item
• UNSPSC
• UPN
• Unit Price
• Default Ordering Unit of
Measure

Manufacturers for Procurement Subsection of Item Descriptors Item Manufacturer


Item section.
Item Inventory Attributes N/A • Replenishment Type
• Base Reorder Point Quantity
• Fixed Order Quantity
• Fixed Order Unit of Measure
• Inventory ABC Classification
• Include in Count
• Purchase Item
• Replenishment Unit of
Measure
• Inventory Site

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 857

Section Description/Notes Fields


• Lead Time
• Base Maximum Quantity

Inventory Label Printing Locations Template

Section Description/Notes Fields


Location Data This section includes a • Global_Location_Number-
Manufacturer subsection with a GLN
single field Item Manufacturer. • Location_Attributes
• Location_External_Name
• Location_Hierarchies_included_with_Allowed
• Location_Identifier
• Location_Name
• Superior_Location
• Worksite_ID_Code
• Location Inventory Attributes
• Label Printer
• Label Template

Location Inventory Attributes N/A • Inventory Location


• Inventory Location Chain
• Inventory Site
• Source Inventory Site
• Inventory Zone

Inventory Label Printing Par Locations Template

Section Description/Notes Fields


Par Location Data N/A • Location
• Par Location
• Bin
• Item
• Item_Description
• Item_Identifier
• Par_Company
• Par_Level
• Par_Location
• Just In Time
• Replenishment_Source
• Required
• Par_Unit_Of_Measure
• Item Specific Data
• Label Printer
• Label Template

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 858

Section Description/Notes Fields


Location This section includes a • Global_Location_Number-
Manufacturer subsection with a GLN
single field Item Manufacturer. • Location_Attributes
• Location_External_Name
• Location_Hierarchies_included_with_Allowed
• Location_Identifier
• Location_Name
• Superior_Location
• Worksite_ID_Code

Par Location N/A • Inventory_Stock_Request_Type


• Par_Company
• Par_Count_Option
• Par_Location
• Requisition_Type
• Source_Inventory_Site
• Source_Requisition_Company

Item Specific Data N/A • CAS_Number


• CDM_Code
• GTIN
• HCPCS_Code
• Is_Controlled
• Is_Energy_Star
• Is_Green
• Is_Hazardous
• Is_Latex-Free
• Is_Patient_Chargeable
• Is_Radioactive
• Is_Refrigerated
• Is_Reusable
• Is_Toxin
• Item_Description
• Item_Identifier
• Item_Name
• Packaging String
• Manufacturer_Name
• Manufacturer_Part_Id
• Manufacturer
• Spend_Category_for_Item
• UNSPSC
• UPN
• Unit_Price
• Default_Ordering_Unit_of_Measure

Manufacturer N/A Item Manufacturer

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 859

Inventory Label Printing Receipts Template

Section Description/Notes Fields


Receipt Line Data Includes subsections: • Receipt Date
• Worktags • Purchase Order for Receipt
• Receipt Line
• Item Descriptor • Quantity Shipped
• Item Description
• Spend Category
• Unit Cost
• Delivery Type
• Ship-to address
• Ship-to contact
• Deliver-to (Location)
• Deliver-to (Address)
• Put Away Location
• Worktags
• Receipt
• Item Descriptor
• Number of Copies
• Label Printing Unit of Measure
• Label Printer
• Label Template

Worktags Subsection of Receipt Line Data Worktag


section.
Receipt Subsection of Receipt Line Data • Receipt Number
section. • Company
• Supplier
• Tracking ID
• Received By
• Just In Time Purchase Order

Item Descriptor Subsection of Receipt Line Data • Item Identifier


section. • Packaging String
• Unit Price
• Item Name
• Default Ordering Unit of
Measure
• Item Lead Time
• CAS Number
• UNSPSC
• Manufacturer Name
• Manufacturer Part Id
• Manufacturer URL
• GTIN
• UPC
• NIGP
• Is Toxin
• Is Radioactive

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 860

Section Description/Notes Fields


• Is Radioactive Minor
• Is Hazardous
• Is Select Agent
• Is Controlled
• Is Green Product
• Is Green
• Is Energy Star
• Is Patient Chargeable
• Is Recycled
• Is Reusable
• Is Latex-Free
• Is Refrigerated
• Manufacturers for
Procurement Item
• UPN
• CDM Code
• HCPCS Code

Manufacturers of Procurement Subsection of Item Descriptor Item Manufacturer


Item section.

Payment Connector

Steps: Set Up Payment Connector Integration

Prerequisites
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure

Context
You can export payment data from Workday to an external financial institution using a payment connector
integration.

Steps
1. Create Integration System on page 1854.
From the New Using Template prompt, select Core Connector: Payments Outbound V2 (Enhanced
Performance).
Select the integration services for fields to include in the connector.
The Enable Message Auditing service provides the audit files attached to each integration event.
Note: Ensure that only authorized workers have access to the Integration Event domain because the
audit files include payment data.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 861

2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event in the Integration functional area.
• Process: Settlement in the Banking and Settlement functional area.
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. Select Integration System > Configure Integration Attributes from the related actions menu of your
payment connector integration.
To configure your integration systems to output raw data, use the Output File Format attribute and
select the Raw Output file format.
4. Create Integration Business Process on page 1838.
If you configure your payment connector integrations to use the raw output file format, select Configure
Document Delivery on your business process.
Select:
• Output Documents from the Derived Using prompt in the Document(s) section.
• Payments Data from the Tagged prompt in the Document Filter(s) section.
5. Select Integration System > Configure Integration Maps from the related actions menu of your
payment connector integration.
6. Set Up Integration Sequence Generators on page 1856.
7. Select and Set Up Connector Output Fields on page 1864.
8. (Optional) Set Up Integration Field Overrides for DIS on page 1861.
Available for integrations based on the Core Connector: Payments Outbound V2 (Enhanced
Performance) template.
9. (Optional) Define how Workday transforms integration output documents using XSLT.
See: Steps: Set Up Document Transformation Connector on page 571.
10.Launch an Integration on page 23.

Concept: Payment Connector


Workday provides Payment Connector integration templates. With the templates, you can send electronic
payments data to regional banks that don’t support standard payment data formats. Using this integration
template, you can select from a wide variety of basic data elements that a third-party banking endpoint can
require. You can configure the Connector outputs to select just the fields that the external bank endpoint
requires, and send those fields in XML or CSV format.
Note: The Core Connector: Payments Outbound V2 (Enhanced Performance) integration template only
supports XML.
The integrations include a configurable set of electronic payments-related data. You can select which fields
to include or exclude, which ones require a value, and which ones to truncate.

Launch/Schedule Options
Workday provides these launch schedule options for the Payment Connector integration:
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Payment Connector integration to run several times per day; launching
the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually. The integration prompts you to enter launch
parameters.
For each launch schedule option, you can enter these launch parameters:
• As Of Entry Moment enables you to retrieve future-dated data changes. You can enter a specific date
in the future (using the Specify Value option). Enter the future data using the Run Now launch schedule

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 862

option. When scheduling a recurring integration event, use the Determine Value at Runtime option.
Select a date field from the Value prompt, such as First Day of Next Month.
• Effective Date defines the end of a date range during which changes became effective. The integration
extracts all changes with effective dates on or before this date.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
You can find these files in the Reports and Other Output Files section. This section displays on the
Integration Event for each integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately (Example: if administrators can’t have access to the data).

Raw Output File Format


You can configure your integration systems using the Core Connector: Payments Outbound V2 (Enhanced
Performance) integration template to output raw data without formatting it. Outputting raw data enables you
to disperse funds more quickly for a large number of individual payments.
The raw output file format supports these integration attributes and maps only:
• Bank Account map.
• Bank Routing Number map.
• Company Tax ID map.
• Payee Alternate Name for Remit-To Supplier attribute.
• Receiving Party Email Logic for Remit-To Supplier attribute.

Reference: Payment Connector Integration Data Sections


Before you build a Payment Connector integration, familiarize yourself with the data sections. Understand
which fields are available for output and how the configuration options affect integration behavior.

Section Description Fields


Payment Group Data • This section has 1 record. • Group ID
• The Currency and Currency • Payment Date
Code attributes use the • Payment Type
applicable ISO-4217 code • Payment Method
value. • Payment Category
• Currency
• Currency Code
• Group Payment Count
• Group Payment Sum

Originating Party and Bank Data • This section has 1 record. • Company Name
• The Address Line 1 and • Tax ID
Address Line 2 attributes refer • Contact Name
to the originating party. • Contact Email
• Address Line 1
• Address Line 2
• Address Line 3
• Address Line 4

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 863

Section Description Fields


• City
• Address Line 1 in Local Script
• Address Line 2 in Local Script
• Address Line 3 in Local Script
• Address Line 4 in Local Script
• City in Local Script
• State
• Zip Code
• Country
• Phone Number
• Bank Name
• Account Name
• Account Nickname
• Account Number
• Account Type Code
• Bank Account
• Bank Account Name
• IBAN
• Routing Transit Number
• Bank Identification Code
• Branch Name
• Branch ID Number
• Currency
• Check Digit
• Roll Number
• Bank Address Line 1
• Bank Address Line 2
• Bank Address Line 3
• Bank Address Line 4
• Bank City
• Bank Address Line 1 in Local
Script
• Bank Address Line 2 in Local
Script
• Bank Address Line 3 in Local
Script
• Bank Address Line 4 in Local
Script
• Bank City in Local Script
• Bank State
• Bank Zip Code
• Bank Country

Payment Data • This section has 1 record. • Payment ID


• To configure the Multiple On • Payment Status
Behalf of Companies field • Payment Memo
attribute on the Payment • Payment Amount
Connector Core Connector: • Amount as Text
Payments Outbound
• Discount Taken
integration template, you

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 864

Section Description Fields


must configure the Web • Currency
Service Version attribute to • Currency Code
update the Get Payments • Check or Advice Number
web service for the template • Check Number
to the most recent version.
• EFT Payment ID
For version 31.0 and later, we
automatically apply contextual • Prenote Flag
security to the integration. • Company
• On Behalf of Company
• Multiple On Behalf of
Companies
• Tax Code
• Additional Type Reference

Receiving Party and Bank Data • This section has 1 record. • ID


• You can configure the Web • Name
Service Version attribute • Contact Primary Phone
on the Payment Connector Number
Core Connector: Payments • Contact Phone Number
Outbound integration template • Contact Mobile Number
to update the Get Payments
• Contact Fax Number
web service for the template
to the most recent version. • Contact Pager Number
For version 31.0 and later, we • Contact Email
automatically apply contextual • Address Line 1
security to the integration. You • Address Line 2
• Address Line 3

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 865

Section Description Fields


must configure the attribute to • Address Line 4
configure these field attributes: • City
• Bank Address Line 1 • Address Line 1 in Local Script
• Bank Address Line 2 • Address Line 2 in Local Script
• Bank Address Line 3 • Address Line 3 in Local Script
• Bank Address Line 4 • Address Line 4 in Local Script
• Bank City • City in Local Script
• Bank Address Line 1 in • State
Local Script • Zip Code
• Bank Address Line 2 in • Country
Local Script • Bank Name
• Bank Address Line 3 in • Bank Account Name
Local Script • Account Nickname
• Bank Address Line 4 in • Account Number
Local Script • Masked Account Number
• Bank City in Local Script • Account Type
• Bank State • IBAN
• Bank Zip Code • Routing Transit Number
• Bank Country • Bank Identification Code
• Intermediary Bank Address • Branch Name
Line 1 • Branch ID Number
• Intermediary Bank Address • Currency
Line 2
• Check Digit
• Intermediary Bank Address
• Roll Number
Line 3
• Bank Instructions
• Intermediary Bank Address
Line 4 • Bank Address Line 1
• Intermediary Bank City • Bank Address Line 2
• Intermediary Bank Address • Bank Address Line 3
Line 1 in Local Script • Bank Address Line 4
• Intermediary Bank Address • Bank City
Line 2 in Local Script • Bank Address Line 1 in Local
• Intermediary Bank Address Script
Line 3 in Local Script • Bank Address Line 2 in Local
• Intermediary Bank Address Script
Line 4 in Local Script • Bank Address Line 3 in Local
• Intermediary Bank City in Script
Local Script • Bank Address Line 4 in Local
• Intermediary Bank State Script
• Intermediary Bank Zip • Bank City in Local Script
Code • Bank State
• Bank Zip Code
• Bank Country
• Intermediary Bank Name
• Intermediary Bank Country
• Intermediary Bank Routing
Transit Number
• Intermediary Bank Branch ID
• Intermediary Bank Branch
Name

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 866

Section Description Fields


• Intermediary Bank Account
Number
• Intermediary Bank IBAN
• Intermediary Bank SWIFT BIC
• Intermediary Bank Instructions
• Intermediary Bank Address
Line 1
• Intermediary Bank Address
Line 2
• Intermediary Bank Address
Line 3
• Intermediary Bank Address
Line 4
• Intermediary Bank City
• Intermediary Bank Address
Line 1 in Local Script
• Intermediary Bank Address
Line 2 in Local Script
• Intermediary Bank Address
Line 3 in Local Script
• Intermediary Bank Address
Line 4 in Local Script
• Intermediary Bank City in
Local Script
• Intermediary Bank State
• Intermediary Bank Zip Code
• Tax ID
• Tax ID Type
• Remit Alternate Name

Remittance Data • This section has 1 record. • Document Type


• To configure the Document • Document ID
Company field attribute on • Document Reference
the Payment Connector • Document Date
Core Connector: Payments • Total Payable Amount
Outbound integration
• Amount Paid
template, you must configure
the Web Service Version • Amount Due
attribute to update the Get • Discount Taken
Payments web service for the • Tax Amount
template to the most recent • Worker Related Info
version. For version 31.0 and • Credit Card Transaction
later, we automatically apply Reference
contextual security to the • Additional Info
integration. • Unstructured Addenda Line
• RTI Sub Reference
• Document Memo
• Additional Document
Reference
• Document Company

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 867

Payments Inbound Integrations

Steps: Set Up Integration to Import Payment Status Reports

Context
You can load payment acknowledgments for different types of electronic payments using an integration.
Banks provide payment acknowledgment files in ISO20022 format for most types of electronic payments.
Note: You can enable your bank to receive payment acknowledgments automatically during settlement
with the Cybersource Workday integration. You can configure the automation if you accept credit card
payments for customers in Workday.

Steps
1. Access the Create Integration System task and enter Import Payment Status Report at the New
using Template prompt.
Security: Integration Build in Integration functional area.
2. Enable the ISO20022 Payment Status Report integration service.
3. From the related actions menu of your Import Payment Status Report integration, select Integration
System > Configure Integration Attributes and specify a value for each integration attribute.
Security: Integration Configure domain in the Integration functional area.
4. (Optional) From the related actions menu of your Import Payment Status Report integration, select
Integration System > Configure Integration Maps to specify values for status codes.
Set up external values for the map If your bank has different acceptance codes from these values:

Payment Status Acceptance Code


Accepted • ACSC
• ACWC
• PART

Rejected • ACCR
• RJCT

Received • ACCP
• ACSP
• ACTC
• PNDG
• RCVD

Security: Integration Configure domain in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 868

5. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
security domain.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
In addition, when the integration invokes the Put Payment Acknowledgment Message web service,
grant access to 1 of these security domains based on the payment type:
• Process: Ad Hoc Payment Settlement in the Banking and Settlement functional area.
• Process: Bank Account Transfer for Settlement/Settlement in the Banking and Settlement functional
area.
• Process: Customer Invoice Payment/Settlement in the Customer Accounts functional area.
• Process: Customer Refund Settlement in the Customer Accounts functional area.
• Process: Expense Report Payment/Settlement in the Expenses functional area.
• Process: Intercompany Payment/Settlement in the Financial Accounting functional area.
• Process: Miscellaneous Payment Request Settlement in the Miscellaneous Payments functional
area.
• Process: Payroll Settlement in the Core Payroll functional area.
• Process: Procurement Card Payment/Settlement in the Procurement functional area.
• Process: Student Sponsor Refund/Settlement in the Student Financials functional area.
• Process: Supplier Invoice Payment/Settlement in the Supplier Accounts functional area.
For all payment types, grant access to the Process: Settlement security domain in the Banking and
Settlement functional area.
6. Set Up Integration Retrieval on page 1845.
7. Launch an Integration on page 23.

Next Steps
Launch the integration and upload payment acknowledgments into Workday.

Steps: Set Up Credit Card Payment Integrations

Prerequisites
• Obtain the security key for your CyberSource account so that you can configure the integrations with
your sign-in credentials.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Create 2 integrations with CyberSource to support processing credit card payments:
• An integration that creates and maintains customer profiles and requests payment authorization.
• An integration that sends payment data to CyberSource for transaction processing.

Steps
1. Create Integration System on page 1854.
Enter the template name at the New using Template prompt:

Template Use Case


Workday to CyberSource Customer Profile and Creates and maintains customer profiles and
CC Auth requests payment authorization.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 869

Template Use Case


WPN - CyberSource Credit Card Payment Sends payment data to CyberSource for
Processing transaction processing.
2. In the Configure Integration Services task, enable these services:

Template Services
Workday to CyberSource Customer Profile and • WPN - CyberSource Credit Card Processing.
CC Auth • Integration Event Data - DIS (to configure
integration launch based on event
subscription).

WPN - CyberSource Credit Card Payment Enable Message Auditing (Optional).


Processing
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:

Template Domains
Workday to CyberSource Customer Profile and • Integration Event
CC Auth • Process: Customer Invoice Payment/
Settlement
• Set Up: Customer Settlement

WPN - CyberSource Credit Card Payment • Integration Event


Processing • Process: Payroll Settlement
• Process: Settlement

See: Steps: Grant Integration or External Endpoint Access to Workday.


4. (Workday to CyberSource Customer Profile and CC Auth only) As a related action on the integration
system, select Integration System > Configure Integration Maps.

Map Notes
CBLoginCredentialsMap Specify your CyberSource user name in the
Internal Value column and your password in the
External Value column.
ReasonCodeDescriptionMap Optional map. Change the descriptions of the
reason codes that CyberSource returns.
5. (Workday to CyberSource Customer Profile and CC Auth only) Set Up Integration Subscriptions on
page 1855.
Subscribe to Create Credit Card Authorization - Event Lite Type, Customer Change - Event Lite Type,
and Update Merchant Customer Profile – Event Lite Type.
In the External Endpoints section, select Remove if there’s any existing API Version value for
CyberSource.
To enable launch of the integration by subscription, select Add below Launch Integration and keep
the default values.
Note: Don’t edit any fields under Add External Endpoint.
6. (WPN - CyberSource Credit Card Payment Processing only) Create Integration (Step).
Add the integration to the Payment Release Event business process.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 870

Next Steps
• Assign the payment integration system to the bank account that will receive deposits for credit card
payment.
• Establish a merchant account with CyberSource and create profiles for customer credit cards.

Payroll Journal Line Export Connector

Steps: Set Up Payroll Journal Outbound Connector

Prerequisites
Set up an external endpoint that can receive and transform the integration XML output files.

Context
You can create an integration to export payroll journal entries, including payroll accounting details, from
Workday to an external endpoint.

Steps
1. Access the Create Integration System task and enter Payroll Journal Outbound Connector at the New
Using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. (Optional) Enable optional integration services:
Option Description
Payroll Journal Outbound Filter Service Enables these additional integration launch
parameters:
• Journal Source
• Reversed Journal
• Pay Cycle Type
• Pay Off-cycle Type

Payroll Journal Outbound Pay Period Filter Enables the Payment Period integration launch
Service parameter.
Payroll Journal Outbound Pay Period Date Enables these additional launch parameters:
Filter Service
• Payment Period Date Option
• From
• Start

Payroll Journal Entry DIS Enables you to define additional fields that
Workday adds to integration output in the
Journal_Entry or Journal_Lines data sections.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Note: Enable the Enable Parallel Processing integration attribute to improve integration performance
by generating concurrent output files for larger integration runs. Workday recommends you enable this
if you're exporting 50,000 journal entries or more.
Security: Integration Build and Integration Configure domains in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 871

4. Select Integration System > Configure Integration Field Overrides as a related action on the
integration system and enter integration service attributes.
Define additional fields that Workday adds to integration output in the Journal_Entry or Journal_Lines
data sections.
Security: Integration Build and Integration Configure domains in the Integration functional area.
5. Set Up Integration Delivery on page 1839.
6. Launch an Integration on page 23.
7. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Process: Journals
• Worker Data: Position and Employee Worktag
See: Steps: Grant Integration or External Endpoint Access to Workday.
8. (Optional) Create Integration Notifications on page 30.

Concept: Payroll Journal Outbound Connector


The Payroll Journal Outbound Connector enables you to export payroll journal entries, include payroll
accounting details, from Workday to an external endpoint. Workday provides the Payroll Journal Outbound
Connector integration template. The integration template supports export of journal entries and journal
lines in a Workday-defined XML format.

Integration Services
The Payroll Journal Outbound Connector integration template includes these integration services:

Integration Service Required/ Description


Optional
Payroll Journal Outbound Deployed Required Launches the integration.
Service
Payroll Journal Outbound Request Required Provides standard launch parameters:
• Company
• Journal Date Query Option
• From Date
• To Date
• Pay Group

Payroll Journal Outbound Filter Optional Enables these additional integration launch
Service parameters:
• Journal Source
• Reversed Journal
• Pay Cycle Type
• Pay Off-cycle Type

Payroll Journal Outbound Pay Period Optional Enables the Pay Period integration launch
Filter Service parameter.
Payroll Journal Outbound Pay Period Optional Enables these additional launch parameters:
Date Filter Service
• Pay Period Date Option
• From
• To

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 872

Integration Service Required/ Description


Optional
Filename Sequence Generator Required Enables the integration to generate a unique
filename for each integration output file.

Launch/Schedule Options
Workday provides these launch schedule options for the Payroll Journal Outbound Connector integration:
• Launch using an Integration step on a business process.
• Launch using schedule. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration retrieves any files from the endpoint.
• Launch immediately. You can launch the integration manually.

Reference: Payroll Journal Outbound Connector XML Schema


<?xml version='1.0' encoding='UTF-8'?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified" attributeFormDefault="unqualified"
targetNamespace="http://www.workday.com/payroll/JournalOutbound"
xmlns:tns="http://www.workday.com/payroll/JournalOutbound">
<xsd:element name="PayrollJournalOutboundFile"
type="tns:PayrollJournalOutboundFileType"/>
<xsd:complexType name="PayrollJournalOutboundFileType">
<xsd:sequence>
<xsd:element name="Journal_Entry" type="tns:Journal_EntryType"
minOccurs="0" maxOccurs="unbounded"
/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Journal_EntryType">
<xsd:sequence>
<xsd:element name="WID" type="xsd:string" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Journal_Sequence_Number" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Journal_Status" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Company" type="tns:CompanyType" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Currency" type="xsd:string" minOccurs="0" maxOccurs="1"/
>
<xsd:element name="Book_Code" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Ledger" type="xsd:string" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Ledger_Period" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Accounting_Date" type="xsd:date" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Journal_Source" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Transaction_Date" type="xsd:date" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Operational_Transaction"
type="tns:Operational_TransactionType" minOccurs="0"
maxOccurs="unbounded"/>
<xsd:element name="Originated_by" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Total_Ledger_Debits" type="xsd:decimal" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Total_Ledger_Credits" type="xsd:decimal" minOccurs="0"
maxOccurs="1"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 873

<xsd:element name="Reversed_By_Journal_Entry_Reference" type="xsd:string"


minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Reverses_Journal_Entry_Reference" type="xsd:string"
minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Creation_Date" type="xsd:dateTime" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Payroll_Period_Start_Date" type="xsd:date" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Payroll_Period_End_Date" type="xsd:date" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Payment_Date" type="xsd:date" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Pay_Cycle_Type" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Pay_Group" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Prior_Period" type="xsd:boolean" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Period" type="xsd:string" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Journal_Line" type="tns:Journal_LineType" minOccurs="0"
maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Operational_TransactionType">
<xsd:annotation>
<xsd:documentation>Operational_Transaction</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="EFT_Payment_ID" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Name" type="xsd:string" minOccurs="0" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Journal_LineType">
<xsd:sequence>
<xsd:element name="WID" type="xsd:string" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Company" type="tns:CompanyType" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Ledger_Account" type="xsd:string" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Alternate_Ledger_Account_Reference" type="xsd:string"
minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Debit_Amount" type="xsd:decimal" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Credit_Amount" type="xsd:decimal" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Currency" type="xsd:string" minOccurs="0" maxOccurs="1"/
>
<xsd:element name="Currency_Rate" type="xsd:decimal" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Ledger_Debit_Amount" minOccurs="0" maxOccurs="1">
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Ledger_Credit_Amount" minOccurs="0" maxOccurs="1">
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 874

<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Budget_Date" type="xsd:date" minOccurs="0"
maxOccurs="1"/>
<xsd:element name="Hours" minOccurs="0" maxOccurs="1">
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Worktag" minOccurs="0" maxOccurs="unbounded">
<xsd:complexType mixed="true">
<xsd:attribute name="Type" type="xsd:string"/>
<xsd:attribute name="Code" type="xsd:string"/>
</xsd:complexType>
</xsd:element>
<xsd:element minOccurs="0" name="Balancing_Worktag_Affiliante">
<xsd:complexType mixed="true">
<xsd:attribute name="Type" type="xsd:string"/>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="CompanyType">
<xsd:annotation>
<xsd:documentation>Document with element Company Structure below:
&lt;Company>
&lt;ID>A200_1&lt;/ID> &lt;Code>A200.1&lt;/Code> &lt;/Company></
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="ID" type="xsd:string" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Code" type="xsd:string" minOccurs="0" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

PSA Inbound Connector

Steps: Set Up PSA Inbound Connector Integration

Prerequisites
Set up an external endpoint that your Workday integration can access. Your external endpoint must be
able to generate change data for organization assignments in the defined XML format.
Ensure that the Workday Core Financials solution exists in Workday.
Ensure to configure relevant business processes, countries, locations, job profiles, employee types, time
type, and termination reasons.

Context
You can set up the Professional Services Automation (PSA) Inbound Connector to import worker data from
an external endpoint into Workday. You can create an integration that:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 875

• Accesses an external server.


• Retrieves a data file containing worker data.
• Imports worker data into Workday.

Steps
1. Configure your external endpoint so that it can generate data for organization assignment changes.
The data must be in one of the formats supported by the Professional Services Automation Inbound
Connector.
2. Create Integration System on page 1854.
Enter Core Connector: Professional Services Automation Inbound at the New using Template prompt.
3. Enable one or more optional integration services. The Configure Integration Services task displays all
integration services, including required services that aren't editable.
You can enable the Financials Document Delivery Service to deliver 1 or more integration files to an
external location.
4. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Manage:
Organization Update Integration domain.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita
5. (Optional) Create Integration Business Process on page 1838.
Create an event to manage the workflow of document delivery and retrieval for the Connector.
6. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves data files containing addition or changes to HCM data from
your external server.
7. Launch an Integration on page 23.
Schedule how often the integration system runs.

Set Up PSA Inbound Connector Integration Attributes

Prerequisites
Security: Integration Build and Integration Configure domain in the Integration functional area.

Context
Configure integration attributes for an integration based on the Core Connector: Professional Service
Automation Inbound template.

Steps
1. As a related action on your Professional Service Automation (PSA) Inbound Connector integration,
select Integration System > Configure Integration Attributes.
2. Add a row for each attribute and specify a value:
Option Description
Input File Retrieval Label Specify a value to retrieve the document using
this label instead of the default Retrieved label.
Include Web Service Requests in Message Select the check box to include the web service
Audit requests in the message audit file to help you
debug. When you enable this attribute, the size of
the message audit file can increase significantly.
Create Errors Only File Select the check box to create a file with input
records that failed to load into Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 876

Option Description
Configure Files for External Delivery Select the check box to deliver the Errors Only
File to an external location. To configure this
attribute, you must enable the Create Errors
Only File integration attribute.
Document Retention Policy Specify the number of days that integration output
should be available for viewing. When you don't
override this value, Workday sets the retention
period to 30 days.
3. Enable 1 or more of these integration services:
Option Description
Core Connector: Professional Services Enables your integration system to import
Automation Inbound - Deployed Service certification achievements for 1 or more workers
into their corresponding records in Workday.
Core Connector: Professional Services Launches the integration.
Automation Inbound Connector Service
Professional Services Automation Inbound Imports supervisory organization data for one or
Connector - Supervisory Organizations DIS more workers into Workday.
Professional Services Automation Inbound Imports worker data into Workday.
Connector - Workers DIS
Core Connector: Professional Services Retrieves an integration document from an
Automation Inbound - Document Retrieval external location.
Service
Professional Services Automation Inbound Performs additional processing after the
Post-Processing Service integration loads the integration file into Workday.
Integration Document Retention Stores the copy of each integration file for the
number of days you specify.
Financials Document Delivery Service Delivers 1 or more integration files to an external
location based on the file selection, transport, and
encryption options you specify. This service is
optional.
Enable Message Auditing Records and stores additional audit messages.

Concept: PSA Inbound Connector


Use the PSA Inbound Connector to import worker data from an external endpoint into Workday enabling
you to use and execute PSA applications. You can use a non-Workday application as your source-of-truth
for worker data, then synchronize that data with Workday. The Connector can:
• Create and update Supervisory organizations.
• Assign organizational roles for Supervisory organizations.
• Hire and terminate employees and contingent workers.
• Change worker data for employees and contingent workers.
• Deactivate Workday account.
Note: PSA Inbound Connector works with HCM in Workday. You'll need HCM functional consultant
expertise when you're setting up the integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 877

Feature Prerequisites
• Workday Core Financials solution must exist in Workday.
• Ensure that the listed business processes complete automatically:
• Add Update Supervisory Organization (Default Definition)
• Assign Roles (Default Definition)
• Change Organization Assignments for ~Worker~ (Default Definition)
• Contact Change (Default Definition)
• Contract ~Contingent Worker~ (Default Definition)
• Edit Position (Default Definition)
• End ~Contingent Worker~ Contract (Default Definition)
• Hire (Default Definition)
• Hiring Restrictions (Default Definition)
• Legal Name Change (Default Definition)
• Legal Name Change (Non-Worker)
• Move ~Workers~ (By Organization) (Default Definition)
• Preferred Name Change (Default Definition)
• Preferred Name Change (Non-Worker)
• ~Termination~ (Default Definition)
• Before the first integration run, manually configure and upload the listed HCM data:
• Countries
• Employee Type
• Job Profiles
• Locations
• Reason for terminating employee
• Reason for ending contingent worker contract
• Time Type
• The PSA integration uses specific web services. Make sure you have access to them.
• When there's a change in the data since the last integration run, you must provide that information
before the next run.

Feature Limitations
You can't rescind or correct the business processes with PSA Inbound Connector. Workday requires a
System administrator when you need a correction.

File Format for PSA Inbound Connector Data


The integration imports data in a Workday-defined XML format.

Integration Process Flow


The integration imports HCM data using this process:
1. The external endpoint generates a file (in the Workday-defined XML format) and sends it to a file server
known to the integration.
2. Launches the integration, either by schedule or manually.
3. The integration retrieves the file according to the Document Retrieval configuration on the Integration
Process Event and applies document tags.
When the file isn’t in Workday-defined XML format, configure a Document Transformation integration
to convert the input file.
4. The PSA Inbound Connector calls multiple web services in the given sequence.
5. The integration processes the file, then imports the data into Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 878

PSA Inbound Connector Audits


The PSA Inbound Connector integration generates audit files each time it runs. You can view these audit
files:
• DataChangesAudit.html
• DiagnosticAudit.html: Includes all errors in the integration run in 1 file.
• Errors Only File: Includes error data. You can update this XML input file to resolve the errors and load it
back into the connector.
• MessageAudit.html: Includes information about the previous integration runs in a zip file.

Reference: PSA Inbound Connector File Schema

PSA Inbound Connector XML Schema

<?xml version="1.0" encoding="UTF-8"?>


<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:psa="urn:com.workday/ProfessionalServicesAutomation"
targetNamespace="urn:com.workday/ProfessionalServicesAutomation"
elementFormDefault="qualified"
attributeFormDefault="qualified">

<xs:element name="Professional_Services_Automation_Data"
type="psa:Professional_Services_Automation_Data_Type">
<xs:annotation>
<xs:documentation>Contains information to Create and Update
Supervisory Organizations, Hire Employees, Contract Contingent Workers,
Employee Updates, Contingent Worker Updates, Employee
Terminations, End Contingent Worker Contracts, and Role Assignments.
</xs:documentation>
</xs:annotation>
</xs:element>

<xs:simpleType name="NonEmptyString">
<xs:annotation>
<xs:documentation>Simple Type that defines a non empty string with
no spaces.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="\S+"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="NonEmptyStringOrSpace">
<xs:annotation>
<xs:documentation>Simple Type that defines a non empty string that
allows spaces.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="countryCode">
<xs:annotation>
<xs:documentation>Simple Type that defines a 3 place Alpha
formatted Country Code.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Za-z]{3}" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 879

</xs:restriction>
</xs:simpleType>

<xs:complexType name="Professional_Services_Automation_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains information to Create
and Update Supervisory Organizations, Hire Employees, Contract Contingent
Workers,
Employee Updates, Contingent Worker Updates, Employee
Terminations, End Contingent Worker Contracts, and Role Assignments.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Create_Supervisory_Organization_Data"
type="psa:Create_Supervisory_Organization_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to Create
Supervisory Organizations. If Updating an existing Supervisory Organization,
use the Update_Supervisory_Organization_Data
section.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Update_Supervisory_Organization_Data"
type="psa:Update_Supervisory_Organization_Data_Type" minOccurs="0"
maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to Update
Supervisory Organizations. If Creating a new Supervisory Organization,
use the Create_Supervisory_Organization_Data
section.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Hire_Employee_Data"
type="psa:Hire_Employee_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to Hire
Employees.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Change_Employee_Legal_Name_Data"
type="psa:Change_Employee_Legal_Name_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to update
Employees legal name.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Change_Employee_Preferred_Name_Data"
type="psa:Change_Employee_Preferred_Name_Data_Type" minOccurs="0"
maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to update
Employees preferred name.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Maintain_Employee_Contact_Information_Data"
type="psa:Maintain_Employee_Contact_Information_Data_Type" minOccurs="0"
maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to update
Employees contact information.</xs:documentation>
</xs:annotation>
</xs:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 880

<xs:element name="Change_Employee_Organization_Assignments_Data"
type="psa:Change_Employee_Organization_Assignments_Data_Type" minOccurs="0"
maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to update
Employee organization assignments</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Change_Employee_Position_Data"
type="psa:Change_Employee_Position_Data_Type" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to change
Employees Position</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Move_Employee_Organization_Data"
type="psa:Move_Employee_Organization_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to move
Employees to another organization.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Terminate_Employee_Data"
type="psa:Terminate_Employee_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to
terminate Employees.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Contract_Contingent_Worker_Data"
type="psa:Contract_Contingent_Worker_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Section that contains elements to
contract Contingent Workers.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Change_Contingent_Worker_Legal_Name_Data"
type="psa:Change_Contingent_Worker_Legal_Name_Data_Type" minOccurs="0"
maxOccurs="unbounded" >
<xs:annotation>
<xs:documentation>Section that contains elements to update
Contingent Workers legal name.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Change_Contingent_Worker_Preferred_Name_Data"
type="psa:Change_Contingent_Worker_Preferred_Name_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to update
Contingent Workers preferred name.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element
name="Maintain_Contingent_Worker_Contact_Information_Data"
type="psa:Maintain_Contingent_Worker_Contact_Information_Data_Type"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to update
Contingent Workers contact information.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element
name="Change_Contingent_Worker_Organization_Assignments_Data"

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 881

type="psa:Change_Contingent_Worker_Organization_Assignments_Data_Type"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to update
Contingent Workers organization assignments</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Change_Contingent_Worker_Position_Data"
type="psa:Change_Contingent_Worker_Position_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to change
Contingent Workers position</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Move_Contingent_Worker_Organization_Data"
type="psa:Move_Contingent_Worker_Organization_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to move
Contingent Workers to another organization.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="End_Contingent_Worker_Contract_Data"
type="psa:End_Contingent_Worker_Contract_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to end
Contingent Workers contract.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Add_Employee_Role_Assignment_Data"
type="psa:Add_Employee_Role_Assignment_Data_Type" minOccurs="0" maxOccurs="1"
>
<xs:annotation>
<xs:documentation>Section that contains elements to dd
Employee role assignments</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Remove_Employee_Role_Assignment_Data"
type="psa:Remove_Employee_Role_Assignment_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to remove
Employee role assignments</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Add_Contingent_Worker_Role_Assignment_Data"
type="psa:Add_Contingent_Worker_Role_Assignment_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to add
Contingent Worker role assignments</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Remove_Contingent_Worker_Role_Assignment_Data"
type="psa:Remove_Contingent_Worker_Role_Assignment_Data_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Section that contains elements to remove
Contingent Worker role assignments</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 882

</xs:complexType>

<xs:complexType name="Create_Supervisory_Organization_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Create Supervisory
Organization elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Create_Supervisory_Organization" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains data to create a
Supervisory Organization.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Reference ID to assign to
the Supervisory Organization.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Date for the Supervisory
Organization creation to take effect.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Name"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Name of the Supervisory
Organization.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Include_Manager_In_Name"
type="xs:boolean" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional value as to whether
to include the manager in the Supervisory
Organization name.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Availability_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory Organization
Availability Date.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Primary_Location_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Reference ID of the
Supervisory Organization's primary location.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Subtype_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Reference ID of the
Supervisory Organization's subtype.</xs:documentation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 883

</xs:annotation>
</xs:element>
<xs:element name="Visibility"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Reference ID of the
Supervisory Organization's visibility.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Superior_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional Supervisory
Organization Superior Organization ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Restriction_Availability_Date"
type="xs:date" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory Organization
Restriction Availability Date.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Earliest_Hiring_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory Organization
Earliest Hiring Date.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Update_Supervisory_Organization_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Update Supervisory
Organization elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Update_Supervisory_Organization" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains data to update a
Supervisory Organization.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Reference ID of the
Supervisory Organization to update</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Date for the Supervisory
Organization update to take effect.</xs:documentation>
</xs:annotation>
</xs:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 884

<xs:choice>
<xs:sequence>
<xs:element name="Name"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Supervisory
Organization name.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Include_Manager_In_Name"
type="xs:boolean" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional value as to
whether to include the manager in the Supervisory
Organization name.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Availability_Date"
type="xs:date" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory
Organization Availability Date.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Superior_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional Supervisory
Organization Superior Organization ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Include_Manager_In_Name"
type="xs:boolean" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional value as to
whether to include the manager in the Supervisory
Organization name.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Availability_Date"
type="xs:date" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory
Organization Availability Date.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Superior_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional Supervisory
Organization Superior Organization ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Availability_Date"
type="xs:date" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory
Organization Availability Date.</xs:documentation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 885

</xs:annotation>
</xs:element>
<xs:element name="Superior_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional Supervisory
Organization Superior Organization ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Superior_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional Supervisory
Organization Superior Organization ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Hire_Custom_Organization_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Custom Organization Add
elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Add_Custom_Organization" type="psa:ID_Data_Type"
minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Element that contains IDs of Custom
Organizations to add.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Org_Custom_Organization_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Add and Remove Custom
Organization elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Add_Custom_Organization" type="psa:ID_Data_Type"
minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Element that contains IDs of Custom
Organizations to add.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Remove_Custom_Organization"
type="psa:ID_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Element that contains IDs of Custom
Organizations to remove.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 886

<xs:complexType name="Hire_Employee_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Hire Employee elements.</
xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Hire_Employee" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Hire Employee
data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Employee_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Rehire" type="xs:boolean"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Optional flag that indicates
whether the Employee is a re-hire.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Legal_Name_Data"
type="psa:Full_Name_Data_Type" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Element that contains Legal
Name Data.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Preferred_Name_Data"
type="psa:Full_Name_Data_Type" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Element that contains
Preferred Name Data.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Country_ID" type="psa:countryCode"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Country Reference ID.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Work_Email_Address"
type="psa:NonEmptyString" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Work Email Address.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:group ref="psa:Job_Data_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Employee_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Employee Type Reference
ID.</xs:documentation>
</xs:annotation>
</xs:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 887

<xs:group
ref="psa:Organization_Assignments_Required_Group_Type" minOccurs="0"
maxOccurs="1" >
<xs:annotation>
<xs:documentation>Element that contains
Organization Assignments Data.</xs:documentation>
</xs:annotation>
</xs:group>
<xs:element name="Custom_Organization_Data"
type="psa:Hire_Custom_Organization_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional custom organization
data.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="User_Name" type="psa:NonEmptyString"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Workday Account User Name.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Hire_Date" type="xs:date"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Date of Hire.</
xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Contract_Contingent_Worker_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Contract Contingent Worker
elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Contract_Contingent_Worker" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contract
Contingent Worker data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Contingent_Worker_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Rehire" type="xs:boolean"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Optional flag that indicates
whether the Employee is a re-hire.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Legal_Name_Data"
type="psa:Full_Name_Data_Type" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Element that contains Legal
Name Data.</xs:documentation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 888

</xs:annotation>
</xs:element>
<xs:element name="Preferred_Name_Data"
type="psa:Full_Name_Data_Type" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Element that contains
preferred name data.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Country_ID" type="psa:countryCode"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Country Reference ID.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Work_Email_Address"
type="psa:NonEmptyString" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>work email address.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:group ref="psa:Job_Data_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Contract_Worker_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contract Worker Type
Reference ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:group
ref="psa:Organization_Assignments_Required_Group_Type" minOccurs="0"
maxOccurs="1" />
<xs:element name="Custom_Organization_Data"
type="psa:Hire_Custom_Organization_Data_Type" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Optional Custom Organization
Data</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="User_Name" type="psa:NonEmptyString"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Workday Account User Name.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Contract_Start_Date" type="xs:date"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contract Start Date.</
xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Maintain_Employee_Contact_Information_Data_Type">
<xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 889

<xs:documentation>Type that contains Maintain Employee Contact


Information elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Maintain_Employee_Contact_Information"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee contact
information to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Employee_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Work_Email_Address"
type="psa:NonEmptyString" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Employee's work email
address to update.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType
name="Maintain_Contingent_Worker_Contact_Information_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Maintain Contingent Worker
Contact Information elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Maintain_Contingent_Worker_Contact_Information"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
contact information to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Contingent_Worker_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Work_Email_Address"
type="psa:NonEmptyString" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contingent Worker's work
email address.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Employee_Legal_Name_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Employee Legal Name
elements.</xs:documentation>
</xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 890

<xs:sequence>
<xs:element name="Change_Employee_Legal_Name" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee legal
name data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Employee_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:group ref="psa:Full_Name_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Country_ID" type="psa:countryCode"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Employee's country Reference
ID to update.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Contingent_Worker_Legal_Name_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Contingent Worker
Legal Name elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Change_Contingent_Worker_Legal_Name"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
legal name data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Contingent_Worker_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:group ref="psa:Full_Name_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Country_ID" type="psa:countryCode"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contingent Worker's work
email address to update.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Employee_Preferred_Name_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Employee Preferred
Name elements.</xs:documentation>
</xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 891

<xs:sequence>
<xs:element name="Change_Employee_Preferred_Name" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee preferred
name data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Employee_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The Reference ID of the Employee.
Sets the ID when Hiring an Employee and references the Employee when
performing updates.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:group ref="psa:Full_Name_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Country_ID" type="psa:countryCode"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Employee's country Reference
ID to update.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Contingent_Worker_Preferred_Name_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Contingent Worker
Preferred Name elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Change_Contingent_Worker_Preferred_Name"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
preferred name data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Contingent_Worker_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The Reference ID of the Contingent
Worker. Sets the ID when Contracting a Contingent Worker and references the
Contingent Worker when performing updates.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:group ref="psa:Full_Name_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="Country_ID" type="psa:countryCode"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contingent Worker's country
Reference ID to update.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 892

</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Employee_Organization_Assignments_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Employee Organization
Assignments data.</xs:documentation>
</xs:annotation>
<xs:sequence> <xs:element
name="Change_Employee_Organization_Assignments" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee
organization assignments data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Employee_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:group
ref="psa:Organization_Assignments_Group_Type" minOccurs="1" maxOccurs="1" />
<xs:element name="Custom_Organization_Data"
type="psa:Change_Org_Custom_Organization_Data_Type" minOccurs="0"
maxOccurs="1">
<xs:annotation>
<xs:documentation>Employee's custom
organization data to update.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType
name="Change_Contingent_Worker_Organization_Assignments_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Contingent Worker
Organization Assignments data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element
name="Change_Contingent_Worker_Organization_Assignments" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
organization assignments data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Contingent_Worker_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:group
ref="psa:Organization_Assignments_Group_Type" minOccurs="1" maxOccurs="1" />
<xs:element name="Custom_Organization_Data"
type="psa:Change_Org_Custom_Organization_Data_Type" minOccurs="0"
maxOccurs="1">
<xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 893

<xs:documentation>Contingent Worker's custom


organizations data to update.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Employee_Position_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Employee Position
data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Change_Employee_Position" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee position
data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Employee_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:group
ref="psa:Change_Employee_Job_Data_Group_Type" minOccurs="1" maxOccurs="1" />
<xs:element name="Position_Change_Reason_Reference_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Position change reason
Reference ID for the Employee's position change.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Change_Contingent_Worker_Position_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Change Contingent Worker
Position data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Change_Contingent_Worker_Position" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
position data to update.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Contingent_Worker_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:group
ref="psa:Change_Contingent_Worker_Job_Data_Group_Type" minOccurs="1"
maxOccurs="1" />

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 894

<xs:element name="Position_Change_Reason_Reference_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Position change reason
Reference ID for the Contingent Worker's position change.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Move_Employee_Organization_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Move Employee Organization
data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Move_Employee_Organization" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee move
organization data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Employee_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="To_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Organization Reference ID to
move the Employee to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Move_Contingent_Worker_Organization_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Move Contingent Worker
Organization data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Move_Contingent_Worker_Organization"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
move organization data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:group
ref="psa:Contingent_Worker_ID_With_Effective_Date_Group_Type" minOccurs="1"
maxOccurs="1" />
<xs:element name="To_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 895

<xs:documentation>Organization Reference ID to
move the Contingent Worker to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:group name="Organization_Assignments_Required_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Organization Assignments
data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Company_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Company Reference ID organization
assignment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Cost_Center_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Cost Center Reference ID organization
assignment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Region_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Region Reference ID organization
assignment.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:group>

<xs:group name="Organization_Assignments_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Organization Assignments
Update data.</xs:documentation>
</xs:annotation>
<xs:choice>
<xs:sequence>
<xs:element name="Company_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Company Reference ID organization
assignment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Cost_Center_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Cost Center Reference ID
organization assignment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Region_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="0" maxOccurs="1">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 896

<xs:annotation>
<xs:documentation>Region Reference ID organization
assignment.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Cost_Center_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Cost Center Reference ID
organization assignment.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Region_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Region Reference ID organization
assignment.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Region_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Region Reference ID organization
assignment.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:choice>
</xs:group>

<xs:group name="Job_Data_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Position data.</
xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Organization Reference ID for
position.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Job_Profile_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Job Profile Reference ID for position.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Time_Type_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Time Type Reference ID for position.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Location_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 897

<xs:documentation>Location Reference ID for position.</


xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Scheduled_Weekly_Hours" type="xs:decimal"
minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Scheduled Weekly Hours for position.</
xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:group>

<xs:group name="Change_Employee_Job_Data_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Employee Position Change
data.</xs:documentation>
</xs:annotation>
<xs:choice>
<xs:sequence>
<xs:element name="Job_Profile_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Job Profile Reference ID to change
the Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Time_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Time Type Reference ID to change the
Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Location_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Location Reference ID to change the
Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Employee_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Employee Type Reference ID to change
the Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Time_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Time Type Reference ID to change the
Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Location_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Location Reference ID to change the
Employee's position to.</xs:documentation>
</xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 898

</xs:element>
<xs:element name="Employee_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Employee Type Reference ID to change
the Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Location_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Location Reference ID to change the
Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Employee_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Employee Type Reference ID to change
the Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Employee_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Employee Type Reference ID to change
the Employee's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:choice>
</xs:group>

<xs:group name="Change_Contingent_Worker_Job_Data_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Contingent Worker Position
Change data.</xs:documentation>
</xs:annotation>
<xs:choice>
<xs:sequence>
<xs:element name="Job_Profile_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Job Profile Reference ID to change
the Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Time_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Time Type Reference ID to change the
Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Location_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Location Reference ID to change the
Contingent Worker's position to.</xs:documentation>
</xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 899

</xs:element>
<xs:element name="Contract_Worker_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contract Worker Type Reference ID to
change the Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Time_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Time Type Reference ID to change the
Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Location_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Location Reference ID to change the
Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Contract_Worker_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contract Worker Type Reference ID to
change the Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Location_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Location Reference ID to change the
Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Contract_Worker_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contract Worker Type Reference ID to
change the Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Contract_Worker_Type_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contract Worker Type Reference ID to
change the Contingent Worker's position to.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:choice>
</xs:group>

<xs:group name="Employee_ID_With_Effective_Date_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Employee Reference ID and
Effective Date.</xs:documentation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 900

</xs:annotation>
<xs:sequence>
<xs:element name="Employee_ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The Reference ID of the Employee. Sets
the ID when Hiring an Employee and references the Employee when performing
updates.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date" minOccurs="1"
maxOccurs="1">
<xs:annotation>
<xs:documentation>Effective Date.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:group>

<xs:group name="Contingent_Worker_ID_With_Effective_Date_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Contingent Worker Reference
ID and Effective Date.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Contingent_Worker_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The Reference ID of the Contingent
Worker. Sets the ID when Contracting a Contingent Worker and references the
Contingent Worker when performing updates.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date" minOccurs="1"
maxOccurs="1">
<xs:annotation>
<xs:documentation>The date when changes are effective.</
xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:group>

<xs:complexType name="Full_Name_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Primary and Secondary Name
Data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:group ref="psa:Full_Name_Group_Type" />
</xs:sequence>
</xs:complexType>

<xs:group name="Full_Name_Group_Type">
<xs:annotation>
<xs:documentation>Group that contains Worker Primary and Secondary
Name Data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:choice>
<xs:sequence>
<xs:element name="First_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 901

<xs:documentation>First Name. Required vs optional


depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Middle_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Middle Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Last Name. Required vs optional
depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Secondary_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Secondary Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_First_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local First Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Middle_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Middle Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Secondary_Last_Name"
type="xs:string" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Secondary Last Name.
Required vs optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Middle_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Middle Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 902

<xs:annotation>
<xs:documentation>Last Name. Required vs optional
depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Secondary_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Secondary Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_First_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local First Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Middle_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Middle Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Secondary_Last_Name"
type="xs:string" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Secondary Last Name.
Required vs optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Last_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Last Name. Required vs optional
depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Secondary_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Secondary Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_First_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local First Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 903

<xs:element name="Local_Last_Name" type="xs:string"


minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Secondary_Last_Name"
type="xs:string" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Secondary Last Name.
Required vs optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Secondary_Last_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Secondary Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_First_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local First Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Middle_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Middle Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Secondary_Last_Name"
type="xs:string" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Secondary Last Name.
Required vs optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Local_First_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local First Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Middle_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 904

<xs:documentation>Local Middle Name. Required vs


optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Secondary_Last_Name"
type="xs:string" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Secondary Last Name.
Required vs optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:sequence>
<xs:element name="Local_Middle_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Middle Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Last_Name" type="xs:string"
minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Secondary_Last_Name"
type="xs:string" minOccurs="0" maxOccurs="1" />
</xs:sequence>
<xs:sequence>
<xs:element name="Local_Last_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Last Name. Required vs
optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Local_Secondary_Last_Name"
type="xs:string" minOccurs="0" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Secondary Last Name.
Required vs optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:element name="Local_Secondary_Last_Name" type="xs:string"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Local Secondary Last Name. Required
vs optional depends on Country ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:group>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 905

<xs:complexType name="Terminate_Employee_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Terminate Employee
elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Terminate_Employee" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee
termination data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Employee_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Reference ID of the Employee
to be terminated.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Primary_Reason_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Primary Reason Reference ID
for termination.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Termination_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Termination date.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Last_Day_of_Work" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Last day of work.</
xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="End_Contingent_Worker_Contract_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains End Contingent Worker
Contract elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="End_Contingent_Worker_Contract" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
end contract data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Contingent_Worker_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 906

<xs:annotation>
<xs:documentation>Reference ID of the
Contingent Worker to end contract.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Primary_Reason_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Primary Reason Reference ID
for end contract.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Contract_End_Date" type="xs:date"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Contract end date.</
xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Last_Day_of_Work" type="xs:date"
minOccurs="1" maxOccurs="1" >
<xs:annotation>
<xs:documentation>Last day of work.</
xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Add_Employee_Role_Assignment_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Add Employee Role Assignment
elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Add_Employee_Role_Assignment" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee role
assignment add data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Supervisory_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory Organization
Reference ID that contains the role.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The date the role assignment
addition is effective.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Role_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 907

<xs:documentation>Role Reference ID of the


role to be assigned.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Employee_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Employee Reference ID to add
to the role.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Remove_Employee_Role_Assignment_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Remove Employee Role
Assignment elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Remove_Employee_Role_Assignment" minOccurs="1"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Employee role
assignment removal data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Supervisory_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory Organization
Reference ID that contains the role.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The date the role assignment
removal is effective.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Role_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Role Reference ID of the
role being removed from.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Employee_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Employee Reference ID to
remove from the role.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 908

<xs:complexType name="Add_Contingent_Worker_Role_Assignment_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Add Contingent Worker Role
Assignment elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Add_Contingent_Worker_Role_Assignment"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
role assignment add data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Supervisory_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory Organization
Reference ID that contains the role.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The date the role assignment
addition is effective.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Role_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Role Reference ID of the
role to be assigned.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Contingent_Worker_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Contingent Worker Reference
ID to add to the role.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="Remove_Contingent_Worker_Role_Assignment_Data_Type">
<xs:annotation>
<xs:documentation>Type that contains Remove Contingent Worker Role
Assignment elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Remove_Contingent_Worker_Role_Assignment"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Element that contains Contingent Worker
role assignment removal data.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 909

<xs:element name="Supervisory_Organization_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Supervisory Organization
Reference ID that contains the role.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Effective_Date" type="xs:date"
minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>The date the role assignment
removal is effective.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Role_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Role Reference ID of the
role being removed from.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Contingent_Worker_ID"
type="psa:NonEmptyStringOrSpace" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Contingent Worker Reference
ID to remove from the role.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="ID_Data_Type">
<xs:annotation>
<xs:documentation>Type that represents a Workday Reference ID.</
xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="ID" type="psa:NonEmptyStringOrSpace"
minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Reference ID.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>

</xs:schema>

Punchout Integrations

Setup Considerations: Supplier Punchout Integration


You can use this topic to help make decisions when planning your configuration and use of the supplier
punchout integration. It explains:
• Why to set it up.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 910

• How it fits into the rest of Workday.


• Downstream impacts and cross-product interactions.
• Security requirements and business process configurations.
• Questions and limitations to consider before implementation.
Refer to detailed task instructions for full configuration details.

What It Is
Workday Punchout uses standardized commerce eXtensible Markup Language (cXML) to support
real-time, synchronous cXML communications between supplier eCommerce websites and Workday
Procurement.

Business Benefits
This integration enables your buying organization to:
• Easily access numerous external supplier catalogs on supplier marketplace sites for your eCommerce
integration needs.
• Reduce administration over-head of maintaining hosted catalogs.
• Expand access to a wider range of suppliers.
• Minimize noncomplaint and maverick spend.
• Eliminate the need to key in data for purchase orders (PO), PO acknowledgments, advance shipment
notices, and supplier invoices.

Use Cases
• You enable workers to search the catalogs on external supplier websites and add items to a shopping
cart. Then, they can return to Workday to check out and complete the requisition creation process.
• For requisitions with web items, you can set up automatic sourcing and issuing of cXML purchase
orders. You can also receive cXML invoices from the supplier for fulfilled orders.
• Automatically associate web items to purchase items based on commodity codes and spend categories
to improve your reports on item procurement.

Question to Consider

Questions Considerations
How should my supplier and I prepare for the Confirm that the supplier or marketplace supports
integration? cXML. Then, ensure that you have these values on-
hand:
• (Required for invoicing) Punchout URLs, also
known as the HTTP endpoint value.
• A list of the values from your supplier for these
elements:
• Header.From.Credential@domain
• Header.From.Credential.Identity
• Header.Sender.Credential.Identity
• Header.To.Credential@domain
• Header.To.Credential.Identity
• Signature.KeyInfo.X509Data.X509Certificate
• Header.Sender.Credential.SharedSecret
• (Optional) Associate UN/CEFACT to units of
measure.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 911

Questions Considerations
• (Optional) Associate UN/SPSC supplier product
codes to spend categories.

Does your supplier require additional punchout You can configure these values as cXML extrinsic
element values for identification? elements on the Maintain Launch Parameters
task to fulfill the supplier's requirement:
• Email Address for Current Worker
• Location ID for Current Worker
• Location Name for Current Worker
• Cost Center ID for Current Worker
• Cost Center Name for Current Worker
Work with the supplier on the details needed, such
as the name of the extrinsic element.

Do your Ship To or Workspace (Deliver To) If yes, the cXML purchase order file won’t
locations include address components beyond the automatically include these additional address
following?: components.
• Address Line 1 If your addresses require additional components
• Address Line 2 for Address Line 3 and Address Line 4, ensure that
• City you have configured the Allow Multiple Address
• Region Lines With Max Number integration attribute in
your integration to allow up to 4 address lines.
• Postal Code
See Steps: Set Up Punchout Purchase Order
• Country Integration on page 916.
If your addresses require other additional
components in the cXML purchase order file, a
custom Studio post-processor will be necessary to
modify the outfit file accordingly.

Do you plan to connect to supplier marketplace? Workday recommends that you integrate with a
supplier marketplace to decrease the number of
integrations you must maintain. When you plan to
use a marketplace other than SciQuest or Jaggaer,
we recommend that you fully test the integration.
Does Workday have an integration template for the You can verify all the available supplier punchout
supplier? templates in Workday on the View Integration
Template report in the Cloud Connect for Spend
Management section.
Workday doesn't update these templates with each
release.
When these templates don't meet your business
needs, Workday recommends that you create
supplier-specific templates in Workday instead of
using a custom studio integration.

Do you plan to receive cXML supplier invoices? Before you set up the supplier invoice integration,
you must send the punchout URL (HTTP endpoint
value) for the integration to your supplier. Example:
https://wd5-enterprise-services1.workday.com/ccx/
ProcurementcXMLReceiver

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 912

Questions Considerations
To determine the HTTP endpoint value for your
production or implementation tenant, review the
Workday Community page for your data center.
See https://community.workday.com/articles/29946.
When the cXML invoice has taxes at a line level,
the integration will aggregate the amounts at the
invoice header level.
The connector for supplier invoices supports values
for these elements:
• invoice ID (on InvoiceDetailRequestHeader)
• operation (on InvoiceDetailRequestHeader)
• invoiceDate (on InvoiceDetailRequestHeader)
• ShippingAmount (on InvoiceDetailSummary)
• OrderID (on InvoiceDetailOrderInfo/
OrderReference)
• lineNumber (on InvoiceDetailItemReference)
• quantity (on InvoiceDetailItem)
• Money (on UnitPrice)
• Money (on SubtotalAmount)
• Money (on Tax/TaxDetail/TaxAmount)
• isTaxInLine (on InvoiceDetailLineIndicator)
• Comments

Recommendations
We recommend that you use these templates for each respective integration:
• Supplier Network Connector - Procurement Punchout Purchase Order and Invoicing for the punchout
supplier invoice integration.
• Procurement Supplier Punchout - Custom Supplier for the supplier punchout integration.
• Procurement Punchout Purchase Order - Custom Supplier for the punchout purchase order integration.
Workday recommends that you integrate with a supplier marketplace to decrease the number of
integrations to maintain. When you plan to use a marketplace other than SciQuest or Jaggaer, we
recommend that you fully test the integration.

Requirements
• Sign in with an Implementer role.
• Set up the Integration Process Event business process. When you don't do this, purchase orders with
web items remain in Approved status and can't be issued.
• Associate a UN/CEFACT to each unit of measure available on the supplier website or marketplace.
When you don't do this, you can't submit the requisitions for web items.
• When you don't source purchase orders from requisitions in Workday, ensure that you use spend
categories enabled for UNSPSC codes on purchase orders.

Limitations
When interacting with vendors, the encryption algorithms can cause issues. To troubleshoot, see FAQ:
Encryption, Certificates, and Ciphers for Integrations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 913

Tenant Setup
No impact.

Security
• Set up security permissions for creating supplier links on the Set Up: Procurement domain.
• Sign in with an Implementer role to set up integrations in Workday.
• Requesters must have security permissions to these domains to access the Connect to Supplier
Website task and link on the Create Requisition task:
• Process: Requisition - Create/Edit
• Self-Service: Requisition
• When you associate supplier contracts to supplier links, users must create requisitions for the
companies on the supplier contracts to access the supplier links. (You can associate supplier contracts
to supplier links on the Maintain Supplier Links task).

Business Processes

Business Process Considerations


Integration Process Event Configure this business process or approved
purchase orders don't issue to suppliers.
Purchase Order XML Issue Event Add an integration step that identifies the supplier
integration for the purchase order. This setup
enables the issuing of the cXML purchase order.

Reporting
No impact.

Integrations

Integration Consideration
cXML Purchase Orders When you plan to accept cXML invoices from the
supplier, use the Supplier Network Connector
- Procurement Punchout Purchase Order and
Invoicing template to create the purchase order
integration. When you don't plan to receive cXML
invoices from the supplier, use the Procurement
Punchout Purchase Order - Custom Supplier
template.
cXML Supplier Invoices Your supplier can use the cXML user guide to
understand how their invoice file should look.

Connections and Touchpoints

Connections and Touchpoints Considerations


Requisitions When users create requisitions with only web
items, those requisitions automatically source
to cXML purchase orders after approval. Users
must have security permissions for the Connect
to Supplier Website task to request items from
external supplier sites.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 914

Connections and Touchpoints Considerations


Workday recommends that you instruct users to
select the spend category when it doesn't populate
for web items on requisitions. This enables you
to use the Maintain Web Items to associate web
items to purchase items, which ensures accurate
reports.

Purchase Orders You can automatically source purchase orders from


approved requisitions with only web items. Add
an integration step, which identifies the supplier
integration for purchase orders, to the business
process that issues cXML purchase orders. Also
configure the Integration Process Event business
process.
Web Items Workday automatically generates web items when
users return to Workday with items selected on an
external supplier website.

Workday offers a Touchpoints Kit with resources to help you understand configuration relationships in your
tenant. Learn more about the Workday Touchpoints Kit on Workday Community.
Related Information
Concepts
Concept: Supplier Punchout
Tasks
Steps: Set Up Supplier Punchout

Steps: Set Up Punchout Catalog Integration

Prerequisites
You must have punchout authentication values for the supplier.

Context
Create an integration system that connects Workday to the punchout catalog of a supplier. Workday
provides 2 types of integration templates:

Preconfigured Templates for Suppliers in the Integration templates for suppliers in the Workday
Workday Catalog catalog have factory default values for the
credentials of the supplier. These values simplify
integration configuration. You can configure
the buyer credentials for your organization.
Preconfigured templates are available for CDW,
Dell, Guest Supply, and Staples.

Generic Template for Custom Suppliers A generic integration template gives you the
flexibility to integrate with any supplier that supports
punchout catalogs for procurement. You can
configure the integration system to match the
punchout specifications of your supplier.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 915

Steps
1. Access the Create Integration System task and enter the applicable integration template at the New
using Template prompt:
• Procurement Supplier Punchout - CDW
• Procurement Supplier Punchout - Custom Supplier
• Procurement Supplier Punchout - Dell
• Procurement Supplier Punchout - Guest Supply
• Procurement Supplier Punchout - Staples
Note: Workday recommends that you use the Procurement Supplier Punchout - Custom Supplier
template.
2. Accept the default integration services.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and configure integration attributes.
Integration templates for suppliers in the Workday catalog have factory default values for the supplier
credentials. If the supplier asks you to change one of these values, remove the row with the default
value, then add a row for the new value. If the test and production integrations of a supplier require
separate credentials, enter both values. Then, click the Restricted to Environment prompt in the rows
with production values and select Production.

Attribute Description Corresponding cXML Element


Buyer Domain Represents the credential type of Header.From.Credential@domain
the buyer. and
Header.Sender.Credential@domain
Buyer Identity Represents the credential Header.From.Credential.Identity
identifier of the buyer. and
Header.Sender.Credential.Identity
Service URL Specifies the URL of the (Not applicable)
punchout website of the supplier.
Supplier Domain Represents the credential type of Header.To.Credential@domain
the supplier.
Supplier Identity Represents the credential Header.To.Credential.Identity
identifier of the supplier.
Shared Secret Represents the credential Header.Sender.Credential.SharedSecret
password of the buyer.
Public Key Represents the credential digital Signature.KeyInfo.X509Data.X509Certificate
signature public key of the
supplier.
4. (Optional) Configure unique name types when launching parameters:
a) From the related actions menu of the integration system, select Integration System > Maintain
Launch Parameters.
b) Use 1 of these parameters to configure unique user identification:
• Email
• Employee ID
• Worker Full Name
• Worker WID
5. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
security domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 916

Next Steps
Create an integration system to issue purchase orders for the items that you select from the punchout
catalog of the supplier.
Related Information
Tasks
Steps: Set Up Supplier Punchout

Steps: Set Up Punchout Purchase Order Integration

Prerequisites
• Set up punchout authentication values for the supplier.
• Security: Integration Build domain in the Integration functional area.

Context
To complete a supplier punchout solution, create an integration system to submit purchase orders to a
supplier based on your requisitions. Workday issues purchase orders for the items that you added to your
cart from the punchout catalog of the supplier.
Workday provides preconfigured integration templates for suppliers in the Workday catalog. You can also
use a generic template to create a purchase order integration with any supplier that supports the punchout
standard.

Steps
1. Access the Create Integration System task and enter the applicable integration template at the New
using Template prompt:
• Procurement Punchout Purchase Order - CDW
• Procurement Punchout Purchase Order - Custom Supplier
• Procurement Punchout Purchase Order - Dell
• Procurement Punchout Purchase Order - Guest Supply
• Procurement Punchout Purchase Order - Staples
Note: Workday recommends that you use the Procurement Punchout Purchase Order - Custom
Supplier template.
2. View the default integration services and for all the templates. Accept the default integration services.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and configure integration attributes.
Integration templates for suppliers in the Workday catalog have factory default values for the supplier
credentials. If the supplier asks you to change one of these values, remove the row with the default
value, then add a row for the new value. If the test and production endpoints of a supplier require
separate credentials, enter both values. Then, click the Restricted to Environment prompt in the rows
with production values and select Production.

Attribute Description Corresponding cXML Element


Buyer Domain Represents the credential type Header.From.Credential@domain
of the buyer. and
Header.Sender.Credential@domain
Buyer Identity Represents the credential Header.From.Credential.Identity
identifier of the buyer and
Header.Sender.Credential.Identity

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 917

Attribute Description Corresponding cXML Element


Service URL Specifies the URL of the Not applicable
punchout website of the
supplier.
Supplier Domain Represents the credential type Header.To.Credential@domain
of the supplier.
Supplier Identity Represents the credential Header.To.Credential.Identity
identifier of the supplier.
Shared Secret Represents the credential Header.Sender.Credential.SharedSecret
password of the buyer.
Unique Name Type Represents the credential ItemOut.ItemDetail.Extrinsic.UniqueName
unique name to send to the
supplier from a non-punchout
requisition.
No direct mapping to the cXML.
This value is the line level
extrinsic attribute used to identify
the corresponding user identifier.

Allow Multiple Address Lines By default, Workday Not applicable


With Max Number concatenates Address Line
1 and Address Line 2 into a
single element when creating
the outbound cXML file. To
keep the address lines as
separate elements, populate the
integration attribute with either
the number:
• 1 to only output Address Line
1.
• 2 to output Address Line
1 and Address Line 2 as
separate elements.
• 3 to output Address Line 1,
Address Line 2, and Address
Line 3 as separate elements.
• 4 to output Address Line 1,
Address Line 2, Address Line
3, and Address Line 4 as
separate elements.
If you leave this attribute blank,
by default Workday will provide
a single concatenated element.
The cXML file will only include
Address Line 1 and Address
Line 2 in the output file.
Workday recommends that you:
• Keep all necessary
information required for
address communication

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 918

Attribute Description Corresponding cXML Element


within Address Lines 1, 2, 3,
and 4 to ensure inclusion in
your outbound cXML file.
• Ensure that the number of
address lines aligns with your
punchout purchase order
integration.

Include PO Attachments Includes purchase order Not applicable


attachments marked as external
for the supplier.
Workday sends out cXML
messages in a multipart format:
• The first part contains the
cXML message content.
• Subsequent parts contain 1
or more attachments.

Include Line Ship-To Information Includes this shipping ItemOut.ShipTo


information sent to suppliers:
• Deliver-to location.
• Line ship-to address.
• Line ship-to contact.

Include Service Lines Includes service lines for ItemOut and lineNumber
purchase orders on the section
Purchase Order cXML sent to
Workday populates these cXML
suppliers.
elements for service lines by
setting:
• isAdHoc to yes
• SupplierPartId to Not
Available
• Quantity to 1
• UnitPrice to PO Line.Amount
• Extrinsic StartDate to PO
Line.Start Date
• Extrinsic EndDate to PO
Line.End Date
• Extrinsic DueDate to PO
Line.Due Date

Sender Identity Represents a distinct sender Header.Sender.Credential.Identity


value separate from buyer
identity.
Sender Domain Represents a distinct domain Header.Sender.Credential.Domain
sender value separate from
buyer domain.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 919

Attribute Description Corresponding cXML Element


Override Sender Identity Dynamically sets the company Header.Sender.Credential.Identity
DUNS number as the sender
Identity.
4. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
security domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
Related Information
Tasks
Steps: Set Up Supplier Punchout

Steps: Set Up Supplier Invoicing Integration

Prerequisites
• Set up authentication values for the supplier.
• Security: Integration Build domain in the Integration functional area.

Context
You can process supplier invoicing by creating an integration system using the Supplier Connector
Network integration system template using cXML.

Steps
1. Send the HTTP endpoint value for integration to your supplier.
To determine the HTTP endpoint value for your production or implementation tenant, review the
Workday Community page for your data center. See https://community.workday.com/articles/29946.
Example: https://wd5-enterprise-services1.workday.com/ccx/ProcurementcXMLReceiver.
2. Access the Create Integration System task.
3. Select Supplier Network Connector - Procurement Punchout Purchase Order and Invoicing as the
applicable integration template from the New using Template prompt.
4. View the default integration services. For supplier network connector, select Procurement Punchout
Invoicing to process invoices as part of the punchout integration.
5. Select Integration System > Configure Integration Attributes as a related action on the integration
system and configure integration attributes so that suppliers can submit invoices using cXML.
Implementors must get supplier credentials and configure the integration attributes.
a) If the test and production endpoints of a supplier require separate credentials, enter both values.
b) Click the Restricted to Environment prompt in the rows with production values and select
Production.

Attribute Description Corresponding cXML Element


Buyer Domain Represents the credential type of Header.To.Credential@domain
the buyer. and
Header.Sender.Credential@domain
Buyer Identity Represents the credential Header.To.Credential.Identity
identifier of the buyer. and
Header.Sender.Credential.Identity
Service URL Specifies the URL of the (Not applicable)
punchout website of the supplier.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 920

Attribute Description Corresponding cXML Element


Supplier Domain Represents the credential type of Header.From.Credential@domain
the supplier.
Supplier Identity Represents the credential Header.From.Credential.Identity
identifier of the supplier.
Shared Secret Represents the credential Header.Sender.Credential.SharedSecret
password of the buyer.
6. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
Related Information
Tasks
Steps: Set Up Supplier Punchout

SAF-T Integrations

Steps: Set Up SAF-T Integration

Prerequisites
• Review setup considerations for SAF-T.
• Create SAF-T data in Workday.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
You can create and configure SAF-T integrations to export tax-relevant data from Workday to SAF-T XML
files. You can then submit SAF-T to tax authorities.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 921

Steps
1. Create Integration System.
Select 1 of these templates from the New Using Template prompt:
• SAF-T Core
• SAF-T Norway
Enable the optional SAF-T Schema Retrieval integration service to retrieve a different SAF-T schema
on:
• SAF-T Core integrations when your country uses a schema based on OECD SAF-T v2.0 with
different fields.
• SAF-T Norway integrations to use the latest schema.
On SAF-T Core integrations, enable these optional integration services to include the
SourceDocuments element containing approved accounts payable or accounts receivable transactions:
• SAF-T_SalesInvoices
• SAF-T_PurchaseInvoices
• SAF-T_SupplierPayments
• SAF-T_CustomerPayments
See also:
• Setup Considerations: SAF-T
• Steps: Set Up SAF-T
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Process: Tax Master
See also:
• Steps: Grant Integration or External Endpoint Access to Workday
• Concept: Tax Master Records
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
4. (Optional) Select Integration System > Configure Integration Field Overrides as a related action on
the integration system.
Configure additional fields in valid extension points or override field mappings as required. Workday
only supports fields that comply with the schema used on your integration.
5. (Optional) Select Integration System > Configure Integration Field Attributes as a related action on
the integration system.
Disable fields as required, or set maximum lengths to truncate values when data exceeds the length
permitted by your schema. To ignore any maximum lengths specified by Workday, set the maximum
length to zero.
Example: Set a maximum length for the Name field when your schema permits 70 characters but your
records contain names longer than 70 characters.
6. (Optional) Set Up Integration Retrieval on page 1845.
Provide a different SAF-T schema for the integration to use.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 922

7. (Optional) Create Integration (Step).


When your country uses a schema that doesn’t match the structure of OECD SAF-T v2.0, add a custom
integration on the business process to:
• Transform the structure of the output file to match your schema.
• Change fields as required.
Only applies to integrations that use the SAF-T Core integration template.
8. Launch an Integration on page 23
Related Information
Reference
Workday Community: SAF-T OECD Version 2 - Supported Fields

Concept: SAF-T Integrations


Workday provides 2 integration templates to generate XML output files that comply with Standard Audit
File for Tax (SAF-T) requirements:
• SAF-T Core
• SAF-T Norway
The SAF-T Core integration template generates a SAF-T using the OECD SAF-T v2.0 schema. You can
configure your integration to use another schema once it has the same structure as OECD SAF-T v2.0.
When your schema has a different structure, you can use the default output file as a data source for a
custom integration to:
• Transform the structure to match your schema.
• Change fields as required.
The SAF-T Norway integration template generates a SAF-T for Norway using the Norwegian SAF-T
Financial v1.10 schema. You can configure your integration to use a newer version of the schema.

Integration Services
You can enable these optional integration services on SAF-T integrations:

Integration Service Description


SAF-T_CustomerPayments Include customer invoice payments when you
create SAF-T.
SAF-T_PurchaseInvoices Include approved accounts payable transactions in
the output.
Available on the SAF-T Core integration template
only.

SAF-T_SalesInvoices Include approved accounts receivable transactions


in the output.
Available on the SAF-T Core integration template
only.

SAF-T_Schema_Retrieval Configure document retrieval to provide your own


SAF-T schema.
SAF-T_SupplierPayments Include supplier invoice payments when you create
SAF-T.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 923

Output Files
When the integration runs, Workday generates a ZIP file containing the SAF-T XML file. When the output
triggers any validation errors, Workday generates a message log HTML file to help you troubleshoot them.
The message log includes the first 500 errors only.
You can find these files on the Output Files tab of the integration event.
Related Information
Concepts
Setup Considerations: SAF-T
Tasks
Steps: Set Up SAF-T
Set Up Integration Retrieval on page 1845
Reference
Workday Community: SAF-T OECD Version 2 - Supported Fields

Supplier Accounts Integrations

Set Up Electronic Invoice Inbound Connector for Supplier Accounts

Context
You can create an integration to import custom electronic invoices for Supplier Accounts from a vendor or
payment portals.

Steps
1. Access the Create Integration System task. As you complete the task, consider:
Option Description
System Name Give the integration a meaningful System Name.
Record this name; you use it when you launch the
integration.
Integration Tags Access the Maintain Integration Tags task
(security: Integration Reports domain) and define
any tags that you want to apply to an integration
system.
Contacts Select workers that you want to associate with the
integration system from the prompt.
New Using Template Select the Core Connector: Electronic Supplier
Invoice template.
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
Accounting Journal Event (business process) Integration Event.
3. In Configure Integration Services, four services are enabled by default, and three services are
optional. If you want to enable one of the three optional services, select the check box in the Optional
column or select the Enable All Services check box.
4. In View Integration System use Related Actions to select Integration System > View Integration
Retrieval to complete the configuration of your connector by creating a business process definition that
contains a retrieval step for the Integration Retrieval Service.
5. In View Integration Retrieval, click Create New Business Process Definition to add the retrieval
step to the business process definition.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 924

6. In Create, Copy, or Link Business Process Definition, select the business object that contains the
business process definition with a retrieval step for the Integration Retrieval Service. Then specify
whether you want to copy or link to an existing business process definition.
7. In View Integration System on the Integration Attributes tab, configure the integration attributes to
specify values for the input file.
Integration attributes define various processing options for the input file, such as:
• The retention period for audit files.
• Data validation rules.
• Whether Workday always includes data or only when changes occur.
8. In View Integration System on the Integration Maps tab, specify how to map Workday data to data in
the input file for:
• The Unit of Measure.
• The tax/VAT ID of an external company to that of a Workday company instance.
• The tax/VAT ID of an external supplier to that of a Workday supplier instance.
Maps reconcile internal Workday values with the external attribute values defined on your integration.
9. In View Integration System on the Security tab, use Related Actions to edit security settings for your
integration.
10.In View Integration System use Related Actions to select Integration > Launch/Schedule to launch
the integration now or schedule it to run on a regular basis in the future. See Launch an Integration.

Reference: Electronic Invoice Connector XML Schema for Supplier Accounts


<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified"
attributeFormDefault="qualified" xmlns="urn:com.workday/
SupplierInvoiceConnector"
targetNamespace="urn:com.workday/SupplierInvoiceConnector">
<!-- <xsd:element name="SuppInvFileData" type="SuppInvFileDataType"/> -->
<xsd:element name="SuppInvData" type="SuppInvDataType" />
<xsd:complexType name="SuppInvFileDataType">
<xsd:annotation>
<xsd:documentation>Contains data for creating or updating a supplier
invoice and
submitting for business processing</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="SuppInvData" type="SuppInvDataType" minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Supplier Invoice Data</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="SuppInvDataType">
<xsd:annotation>
<xsd:documentation>Element containing all Supplier Invoice data</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="RefID" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Supplier Invoice
for update only
purposes</xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 925

<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Supplier_InvoiceReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BPParam"
type="FinancialsBusinessProcessParametersType" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Business Process Parameters provide the
ability to
auto-submit to the business process. </
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InvID" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Supplier Invoice ID. This is the Supplier
Invoice unique
identifier.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Submit" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Submit for Approval is a boolean flag
indicating if the
transaction is to be submitted or saved in draft mode.
If this flag is set,
the transaction will be submitted, otherwise the
transaction is saved in
draft.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="LockedinWD" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Set to True to disable editing and
canceling the invoice
inside the Workday application. Invoice can only be
updated from the web
service.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InvNum" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>If adding a new invoice, then make the
Invoice Number the
same value as Reference ID. If updating an existing
invoice, then make it
the same value as the Reference ID of that invoice. If
you do not make the
Invoice Number the same as Reference ID, then duplicate
Invoice Numbers for
different invoices may be created. The Reference ID is
the only value

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 926

checked as a unique identifier. Note that the name of


the Reference ID is
different for each invoice type: e.g. Supplier Invoice
ID, Supplier Invoice
Adjustment ID, Customer Invoice Adjustment ID, and
Customer Invoice
ID.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ExtSuppInvSource" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The External Supplier Invoice Source.
Defaults to E-invoice,
but you can override it.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="External_Transaction_Source__All_ReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Company" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the company that transaction is
for. This is the
reference id value of the company.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="CompanyReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="CompanyTaxID" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The company tax ID or VAT ID used to
identify a company when
a company reference ID isn't provided. If Workday doesn't
find a company or finds
more than one company, Workday returns the tax ID to the
Submit
Supplier Invoice web service.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CompanyTaxCntry" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The company tax country used with company
tax ID to identify
a company when a company reference ID isn't provided.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 927

<xsd:attribute name="type"
type="CountryReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="PmntPractices" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Payment Practice field to flag a Supplier
Invoice for Payment
Practices Reporting</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Ccy" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id of currency of
the transaction If no
currency is specified, Workday will first look to see if
the payer/payee has
a preferred currency and if not, currency will be
populated with the company
base currency. If the company base currency is not
allowed currency for
payer/payee then transaction will not be able to be
submitted for
approval.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Supp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Supplier Reference is the reference to
the Supplier the
invoice is from.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="SupplierReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="SuppTaxID" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The supplier tax ID or VAT ID used to
identify a supplier when
a supplier reference ID isn't provided. If Workday doesn't
find a supplier or finds
more than one supplier, Workday returns the tax ID to the
Submit Supplier Invoice
web service.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SuppTaxCntry" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The supplier tax country used with
supplier tax ID to identify

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 928

a supplier when a supplier reference ID isn't provided.</


xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="CountryReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>

<xsd:element name="ContingentWorker" minOccurs="0" maxOccurs="1">


<xsd:annotation>
<xsd:documentation>Reference to an existing Contingent
Worker</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Contingent_WorkerReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:choice>
<xsd:element name="SuppConnection" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Supplier
Business
Connection.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Remit-
To_Supplier_ConnectionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="UseDfltSuppConnection" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>TRUE or FALSE If this is set to
'TRUE' the default supplier
connection will be derived.</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:choice>
<xsd:element name="DfltTaxOption" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Tax Option. If
left blank, will
default from the Company.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 929

<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_OptionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ShipToAddr" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Ship-To
address.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Unique_IdentifierReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ShipToAddrID" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>We update these web services to enable
you to submit a
ship-to address using the Address Reference ID field: *
Import Supplier
Invoice * Submit Supplier Invoice</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Address_ReferenceReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BillFromAddr" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Bill-From
address.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Address_ReferenceReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ShipFromAddr" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Ship-From
address.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 930

<xsd:attribute name="type"
type="Address_ReferenceReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxCd" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the tax
code. If not
submitted, Workday will use the payee default the tax
code.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_CodeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="DfltWHTaxCd" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the
default withholding tax
code. If not submitted, Workday will use the payee
default the withholding
tax code.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_CodeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="InvDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Format is MM/DD/YYYY. If this is left
blank, Workday will
populate invoice date with the current date.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InvRcvdDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Field to store the Invoice Received Date
value</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InvDeliveryDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Effective date of delivery of goods or
completion of service.</xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 931

</xsd:element>
<xsd:element name="BillingStartDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Invoicing period start date.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="BillingEndDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Invoicing period end date.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DiscountAmntOverride" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Overrides calculated payment discounts.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="DiscountDtOverride" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Overrides default discount date.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DueDtOverride" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Format is MM/DD/YYYY. If a date is
provided, it will override
the due date that Workday automatically determines based
on the invoice date
and payment terms.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AccntDtOverride" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Override date for Accounting.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="BudgetDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Use this field to override the Budget
Date on all supplier
invoice lines and splits.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="OnHold" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 932

<xsd:documentation>TRUE or FALSE If this is set to 'TRUE'


the invoice will be
put on hold.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CtrlAmntTotal" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the expected invoice total
including tax. It is
optional. An invoice cannot be submittted for approval
if it has a non-zero
control total that does not equal the sum of the
extended amount for all
invoice lines plus tax.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TaxAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Tax Amount</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="WHTaxAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Withholding Tax Amount</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18"/>
<xsd:fractionDigits value="3"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="FreightAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Freight Amount</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="OtherCharges" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Other Charges</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 933

</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="WTSplitTemplate" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Worktag Split Allocation Template for
Supplier
Invoice</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Worktag_Split_TemplateReferenceEnumeration" use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxOnly" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Tax Only Boolean to indicate if the
Supplier Invoice is Tax
Only</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DownPmnt" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Down Payment</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DownPmntPurOrder"
type="Purchase_OrderObjectIDType" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The Purchase Order for this Down
Payment</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RefdInv" minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Tax Only invoice Workset for adding
Referenced
Invoices</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Supplier_InvoiceReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="SuppDocRcvd" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Boolean attribute indicating if the
Supplier Paper Document
was received (possibly through mail or fax) . If this is
set then a Supplier

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 934

Reference is required that will provide information for


locating that
document.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SuppInvNum" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form text field to provide a
Supplier's Invoice Number
memo. The Supplier's Invoice Number is not a Workday
Reference ID, but a
text field for providing additional information about
the Supplier
Invoice.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ExtPONum" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form text field for providing
addition information on
the Purchase Order that the Supplier Invoice is for.
This is not a Workday
Purchase Order Reference ID.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SuppContract"
type="Supplier_Contract_BaseObjectIDType" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Supplier
Contract</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DocLink" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Link to a scanned image of the paper
invoice</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="StatutoryInvTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Invoice Type for Supplier Invoice.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Invoice_TypeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Memo" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This transaction header memo will print
on the delivered
transaction. It is optional freeform text</
xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 935

</xsd:element>
<xsd:element name="Approver" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The Approver for Supplier Invoice</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="WorkerReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="PmntTerms" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id of the payment
terms for the
invoice. Payment Terms are the rules for establishing
when a invoice payment
is due and whether discounts are eligible to be taken or
given for early
payment. This is a required field, but if no payment
terms are specified,
Workday will populate this with the customer's default
payment terms if one
is defined. Workday will automatically determine the due
date and discount
date based on the invoice date and payment terms.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Payment_TermsReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="OverridePmntTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>A reference to a Payment Type. If one is
provided, it will be
used in processing the Payment instead of the Supplier's
default payment
type.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Payment_TypeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="AddtlTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 936

<xsd:documentation>The type of reference used to encode key


payment information
on the invoice document.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Additional_Reference_TypeReferenceEnumeration" use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="AddtlRefNum" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The reference number that is encoded with
key payment
information on the invoice document.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="140"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="OrigCntryPmntPurpose" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Originating Country Payment Purpose Code.
This code is used
to identify the purpose of the payment from the
originating
country.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Payment_Purpose_CodeReferenceEnumeration"
use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="RcvdCntryPmntPurpose" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Receiving Country Payment Purpose Code.
This code is used to
identify the purpose of the payment from the receiving
country.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Payment_Purpose_CodeReferenceEnumeration"
use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 937

</xsd:complexType>
</xsd:element>
<xsd:element name="HandlingCd" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference code of the payment
handling
instructions for the supplier invoice or supplier
invoice
adjustment.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Payment_Handling_InstructionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Prepaid" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Set the Prepaid value to true for Prepaid
Invoices where all
lines are Prepaid. If set, the lines cannot be also set
to Prepaid
individually.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="PrepmntRelTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Prepaid
Amortization
Type</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Prepaid_Amortization_TypeReferenceEnumeration" use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="RelDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Prepaid Amortization Date</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Freq" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The Frequency to be used when generating
the next prepaid
accounting entry.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 938

<xsd:attribute name="type"
type="Frequency_BehaviorReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="NumofInstallments" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The Number of Installments to use when
accounting for the
Prepaid Amortization.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="12"/>
<xsd:minInclusive value="0"/>
<xsd:fractionDigits value="0"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="UseInvDt" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Use the Invoice Date as the starting date
for the first
installment.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="FromDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Use the Specified Date as the starting
date for the first
installment.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RetentMemo" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The retention memo.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DownPmntAppData"
type="Down_Payment_Application_DataType"
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Encapsulates Data Pertaining to a Down
Payment being
applied</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CcyRateData" type="CcyRateDataType" minOccurs="0"
maxOccurs="unbounded"/>
<xsd:element name="AddtlFieldsData" type="AddtlFieldsDataType"
minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing
additional fields
data</xsd:documentation>
</xsd:annotation>
</xsd:element>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 939

<xsd:element name="AttchData" type="Financials_Attachment_DataType"


minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Attachment Data</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TaxCdData"
type="Taxable_Code_Application_DataType" minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Tax Data by Tax Authority and Tax Code.
For Customer Invoice
Documents and Cash Sales tax data will always be
calculated from the line
data regardless of what is populated in Tax Rate
Application Data. For
Purchase Orders, Supplier Invoice Documents and Ad hoc
Payments, if data is
in Tax Rate Application Data, then that will be the tax
information that is
saved. Otherwise, the tax will be calculated from the
lines.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WHTaxCdData"
type="Withholding_Tax_Code_Application_DataType"
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Withholding Tax Data by Tax Authority and
Withholding Tax
Code. For Customer Invoice Documents and Cash Sales tax
data will always be
calculated from the line data regardless of what is
populated in Tax Rate
Application Data. For Purchase Orders, Supplier Invoice
Documents and Ad hoc
Payments, if data is in Tax Rate Application Data, then
that will be the tax
information that is saved. Otherwise, the tax will be
calculated from the
lines.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InvLnReplacementData"
type="Supplier_Invoice_Line_Replacement_DataType" minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Supplier Invoice Line Data. A Supplier
Invoice may have
multiple lines.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RetentionRelLnData"
type="Supplier_Invoice_Retention_Release_Line_WWS_DataType"
minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Supplier
Invoice Retention
Release Line data.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SuppInvICSubProcess"

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 940

type="Supplier_Invoice_Intercompany_Sub_ProcessType"
minOccurs="0"/>
<xsd:element name="SuppInvPrepaidAmortSched"

type="Supplier_Invoice_Prepaid_Amortization_Schedule_WWS_DataType"
minOccurs="0"
maxOccurs="unbounded"/>
<xsd:element name="WorkQueueInfoData"
type="Supplier_Invoice_Work_Queue_Information_DataType"
minOccurs="0"
maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Down_Payment_Application_DataType">
<xsd:annotation>
<xsd:documentation>Encapsulates Data Pertaining to a Down Payment
being
applied</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="DownPmntInv" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Down Payment Invoice you
wish to
apply</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Abstract_Down_PaymentReferenceEnumeration"
use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="DownPmntAppldAmnt" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Down Payment Amount to Apply</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:minInclusive value="0"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Supplier_Invoice_Work_Queue_Information_DataType">
<xsd:annotation>
<xsd:documentation>References all the information related to the
Supplier Invoice Work
Queue tab.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Assignee" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Use this field to override the Assignee
in the Supplier

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 941

Invoice Work Queue. Leave blank to default the value


from the Supplier
Invoice Assignment Rules. When there aren't assignment
rules set up, Workday
populates the user submitting the request.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="WorkerReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Tags" minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Use this field to override the Work Queue
Tags in the
Supplier Invoice Work Queue. Leave blank to default the
value from the
Supplier Invoice Work Queue Tag Assignment Rules. When
there aren't
assignment rules set up, Workday leaves the field
blank.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Supplier_Invoice_Work_Queue_TagReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Notes" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Adds notes related to the supplier
invoice in the work
queue.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ExtRef" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>External Reference for Supplier Invoice</
xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType
name="Supplier_Invoice_Prepaid_Amortization_Schedule_WWS_DataType">
<xsd:annotation>
<xsd:documentation>Supplier Invoice Prepaid Spend Amortization
Schedule</xsd:documentation>
</xsd:annotation>
<xsd:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 942

<xsd:element name="ID" type="xsd:string" minOccurs="0"


maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Prepaid Spend Amortization Schedule ID</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Freq" minOccurs="1" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The Frequency to be used when generating
the next prepaid
accounting entry.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Frequency_BehaviorReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="NumOfInstallments" minOccurs="1" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The Number of Installments to use when
accounting for the
Prepaid Amortization.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="12"/>
<xsd:minInclusive value="0"/>
<xsd:fractionDigits value="0"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:choice>
<xsd:element name="UseInvDt" type="xsd:boolean" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Use the Invoice Date as the starting
date for the first
installment</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="FromDt" type="xsd:date" minOccurs="1"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Use the Specified Date as the
starting date for the first
installment</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:choice>
<xsd:choice>
<xsd:element name="IncAllAvailPrepaidLns" type="xsd:boolean"
minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Flag to include all remaining prepaid
Purchase Order
Lines in this schedule</xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 943

</xsd:element>
<xsd:element name="PrepaidSuppInvLns"

type="Supplier_Invoice_Lines_For_Amortization_Schedule_DataType"
minOccurs="0"
maxOccurs="unbounded"/>
</xsd:choice>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType
name="Supplier_Invoice_Lines_For_Amortization_Schedule_DataType">
<xsd:annotation>
<xsd:documentation>Prepaid Supplier Invoice Lines for Amortization
Schedule</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="SuppInvLnID" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Supplier Invoice Line ID for reference in
Schedule
Information</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Supplier_Invoice_Intercompany_Sub_ProcessType">
<xsd:annotation>
<xsd:documentation>Wrapper for the Supplier Invoice Intercompany Sub
Process. It allows
you to specify parameters for the sub process.</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:choice>
<xsd:element name="AutoComplete" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the
business process is
automatically processed. This means that all
approvals will be
automatically approved in the system, all reviews
and to-do's will be
automatically by-passed, and all notifications will
be automatically
suppressed.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Skip" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the
business process is
automatically skipped (if it is defined as
"skippable" within the
business process definition).</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:choice>
<xsd:element name="DiscardOnExitValError" type="xsd:boolean"
minOccurs="0" maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 944

<xsd:documentation>Enforces all critical validation


conditions defined on the
initiation step. When any critical validation condition
is true, the
validation error blocks the step from exiting and we
won't create a business
process event.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form comment regarding the business
process.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Worker" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Default the Person making the comment to
the processing
person if not submitted via the web service.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="WorkerReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BPAttchData"
type="Business_Process_Attachment_DataType"
minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Business_Process_Attachment_DataType">
<xsd:annotation>
<xsd:documentation>Element for the attachments pertaining to a Event
entered through a
web service.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="FileNm" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Filename for the attachment.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="255"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="EventAttchDesc" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form text comment about the
attachment.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="EventAttchCat" minOccurs="0">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 945

<xsd:annotation>
<xsd:documentation>Category of attachment.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Event_Attachment_CategoryReferenceEnumeration" use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="File" type="xsd:base64Binary" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Binary file contents.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ContTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Content Type
of the
Attachment.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="80"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType
name="Supplier_Invoice_Retention_Release_Line_WWS_DataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Supplier Invoice
Retention Release
Line data.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="RetentionRelLnID" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Retention Release Line Reference ID. This
is the Retention
Release Line unique identifier</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="POorContractLnWithRetention"
type="Abstract_Retainable_LineObjectIDType">
<xsd:annotation>
<xsd:documentation>A reference to an existing Supplier
Contract Line or Purchase
Order Line with a retained amount in the Workday system.
This is used to
link the Supplier Invoice Retention Release Line with a
Supplier Contract
Line or Purchase Order Line.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AmntRel" minOccurs="0" maxOccurs="1">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 946

<xsd:annotation>
<xsd:documentation>The Retention Amount to release. Amount
may not exceed the
remaining retention balance for this line.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18"/>
<xsd:minInclusive value="0"/>
<xsd:fractionDigits value="3"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Abstract_Retainable_LineObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Abstract_Retainable_LineReferenceEnumeration"
use="required">
<xsd:annotation>
<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique
identifier type of a parent object.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="Alternate_Supplier_Contract_ID"/>
<enumeration
value="Change_Order_Reference_ID"/>
<enumeration value="Document_Number"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 947

<enumeration
value="Purchase_Order_Reference_ID"/>
<enumeration
value="Supplier_Contract_Amendment_ID"/>
<enumeration
value="Supplier_Contract_History_ID"/>
<enumeration value="Supplier_Contract_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="Supplier_Invoice_Line_Replacement_DataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Supplier Invoice
Line
data.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="SuppInvLnID" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Supplier Invoice Line Reference ID. This
is the Supplier
Invoice Line unique identifier</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="LnOrder" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Optional line order. If specified, lines
will be sorted by
this value when displayed and when invoice is printed.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ICAffiliate" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the
Company.If this is
blank, Workday will default the company from the invoice
header. If a value
is provided that is different from the invoice header,
workday validates
that there is an appropriate intercompany relationship
configured.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="CompanyReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="PurItm" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Purchase Item or
the Supplier's

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 948

Default Purchase Item. Purchase items are goods and


services that are
purchased from suppliers</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Procurement_ItemReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ItmDesc" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>

<xsd:documentation>An optional description of the item, especially useful if


only a Spend Category is selected for this line.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="PurOrderLn"
type="Purchase_Order_LineObjectIDType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>An optional reference to an existing
Purchase Order Line in
the Workday system. This is used to link the Supplier
Invoice Line with a
Purchase Order Line. If the invoice line is for an
external Purchase Order
(not available within Workday), leave this blank.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SuppContractLn"
type="Supplier_Contract_LineObjectIDType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>An optional reference to an existing
Supplier Contract Line
in the Workday system. This is used to link the Supplier
Invoice Line with a
Supplier Contract Line. Is not allowed for Ad Hoc
Requests, Supplier
Contract Adjustments, or Supplier Invoice Contracts
(Recurring Supplier
Invoices).</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CustInvLn" minOccurs="0">
<xsd:annotation>
<xsd:documentation>An optional reference to an existing
Customer Invoice Line in
the Workday system. This is used to link the Supplier
Invoice Line with a
Customer Invoice for Direct Intercompany Invoices.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 949

<xsd:attribute name="type"
type="Customer_Invoice_LineReferenceEnumeration"
use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="SuppInvLnToAdj" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The Supplier Invoice Line to Adjust
Reference for the
adjustment must be for the same company, must be
approved, amounts must be
valid, and the asset cannot have events in progress. The
reference must be
to a supplier invoice line.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Supplier_Invoice_Line_AbstractReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="SpendCat" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to an existing Spend Category</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Spend_CategoryReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="CommodityCd"
type="Commodity_Code_ReferenceObjectIDType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>A reference to the Commodity Code for
this supplier invoice line. If this Supplier Invoice Line is linked to
a Purchase Order Line the Commodity Code will be taken directly from the
Purchase Order Line and is considered read only.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ShipToAddr" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Contains a reference instance or a
Address Reference ID for
an existing address</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Address_ReferenceReferenceEnumeration"

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 950

use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ShipToContact" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to a Worker, who will be the
designated Ship-To
Contact.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="WorkerReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ShipFromAddr" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Ship-From
address.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Address_ReferenceReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxApplicability" minOccurs="0">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the tax
applicability.If
this is blank and there invoice line has a sales item,
Workday will default
tax applicability from the sales item. If the invoice
line has a tax code
then tax applicability is required.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_ApplicabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxCd" minOccurs="0">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the tax
code.If this is
blank, Workday will default in the default tax code from
the invoice header
if there is one. If the invoice line has a tax
applicability value, Workday

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 951

will validate that the invoice line also has a tax


code.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_CodeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="WHTaxCd" minOccurs="0">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the
withholding tax
code.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_CodeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxData" type="Tax_Widget_DataType"
minOccurs="0"/>
<xsd:element name="TaxRateOptionsData"
type="Tax_Rate_Options_DataType" minOccurs="0"/>
<xsd:element name="Qty" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>If this is blank, Workday will
automatically calculate
quantity from unit cost and extended amount. But if the
line references
either a Purchase Order or Contract Line, the quantity
must be blank and
extended amount will not be calculated.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="22"/>
<xsd:fractionDigits value="2"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="UnitOfMeasure" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Unit of Measure for the Supplier Invoice
Line to be created
or modified.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="UnitCost" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the Unit Price. If this is blank,
Workday will
default the unit price from the item if one is
configured. If invoice line

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 952

has a quantity and unit price, then Workday will


automatically calculate
extended amount.. But if the line references either a
Service or
Project-Based Purchase Order or Contract Line, the Unit
Price must be
blank.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="ExtendedAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the invoice line amount. If the
invoice line has a
quantity and unit price, then Workday will automatically
calculate extended
amount.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18"/>
<xsd:fractionDigits value="3"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="RetentionAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The amount to retain from this invoice
line.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18"/>
<xsd:minInclusive value="0"/>
<xsd:fractionDigits value="3"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="BudgetDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Use this field to override the Budget
Date from the supplier
invoice header.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Prepaid" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Prepaid flag at the Line level</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SuppContract"
type="Supplier_ContractObjectIDType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>This field is only enabled for Companies
and Tenants which

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 953

are Opted-In to Consolidate Requisition Lines by


Supplier regardless of
Supplier Contract.Use this field to assign a specific
Supplier Contract to
this Spend Line.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InvLnDeliveryDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Effective date of delivery of goods or
completion of service for the line.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="BillingLnStartDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Invoicing period start date for the
line.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="BillingLnEndDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Invoicing period end date for the line.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Memo" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Memo for the Invoice line. This is free
form
text.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WT" type="Accounting_WorktagObjectIDType"
minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Reference to existing worktags. Worktags
are a way to mark
tasks and business objects to make them easier to access
and summarize. Each
transaction can include one value for each worktag type
and is subject to
configurable validation when submitted for approval.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Billable" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Billable Flag at Invoice Line Level</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WTSplitTemplate" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Worktag Split Allocation Template for
Supplier
Invoice</xsd:documentation>
</xsd:annotation>
<xsd:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 954

<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Worktag_Split_TemplateReferenceEnumeration" use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="SuppInvSplitLnData"
type="Supplier_Invoice_Line_Split_DataType"
minOccurs="0" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Supplier
Invoice Line Split
data.</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Supplier_Invoice_Line_Split_DataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Supplier Invoice
Line Split
data.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="SuppInvLnSplit" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Supplier Invoice Line Split Reference.
Not to be used on
Submit WS, only for reference when using Get WS.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Supplier_Invoice_Line_SplitReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="SuppInvLnSplitID" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference ID</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Qty" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The quantity for the split line. This is
optional and should
be absent when splitting by amount.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="22"/>
<xsd:fractionDigits value="2"/>
</xsd:restriction>
</xsd:simpleType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 955

</xsd:element>
<xsd:element name="ExtendedAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The extended amount for the split line.
This is always
required and must be correct (quantity * unit cost of
parent
line).</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="18"/>
<xsd:fractionDigits value="3"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Memo" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Memo for the Split line. This is free
form
text.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="LnSplitAllocation" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to an existing Purchase Order
line split or
Supplier Invoice Line Split to Adjust</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Business_Document_Line_SplitReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="BudgetDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Use this field to override the Budget
Date from the supplier
invoice header.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WT" type="Accounting_WorktagObjectIDType"
minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Reference to existing worktags. Worktags
are a way to mark
tasks and business objects to make them easier to access
and
summarize.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Billable" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 956

<xsd:documentation>Billable Flag at Invoice Line Split


Level</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Accounting_WorktagObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Accounting_WorktagReferenceEnumeration"
use="required">
<xsd:annotation>
<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique
identifier type of a parent object.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="External_Supplier_Invoice_Source_ID"/>
<enumeration
value="External_Transaction_Source_ID"/>
<enumeration
value="Workday_External_Supplier_Invoice_Source_ID"/>
<enumeration
value="Workday_External_Transaction_Source_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 957

<xsd:complexType name="Supplier_ContractObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Supplier_ContractReferenceEnumeration"
use="required">
<xsd:annotation>
<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique
identifier type of a parent object.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="External_Supplier_Invoice_Source_ID"/>
<enumeration
value="External_Transaction_Source_ID"/>
<enumeration
value="Workday_External_Supplier_Invoice_Source_ID"/>
<enumeration
value="Workday_External_Transaction_Source_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="Supplier_Contract_BaseObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 958

<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Supplier_Contract_BaseReferenceEnumeration"
use="required">
<xsd:annotation>
<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique
identifier type of a parent object.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="External_Supplier_Invoice_Source_ID"/>
<enumeration
value="External_Transaction_Source_ID"/>
<enumeration
value="Workday_External_Supplier_Invoice_Source_ID"/>
<enumeration
value="Workday_External_Transaction_Source_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="Tax_Rate_Options_DataType">
<xsd:annotation>
<xsd:documentation>Element containing Tax Rate Recoverabilities data
for Tax
Code.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxRate1" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.</
xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 959

<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RateReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverability1" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax
Rate.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RecoverabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxOption1" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Option for Tax Rate.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_OptionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRate2" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RateReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverability2" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax
Rate.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 960

<xsd:attribute name="type"
type="Tax_RecoverabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxOption2" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Option for Tax Rate.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_OptionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRate3" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RateReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverability3" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax
Rate.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RecoverabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxOption3" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Option for Tax Rate.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_OptionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 961

</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRate4" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RateReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverability4" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax
Rate.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RecoverabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxOption4" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Option for Tax Rate.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_OptionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRate5" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RateReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverability5" minOccurs="0">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 962

<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax
Rate.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RecoverabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxOption5" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Option for Tax Rate.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_OptionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRate6" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference to Tax Rate for Tax Code.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RateReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxRecoverability6" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Recoverability for Tax
Rate.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RecoverabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxOption6" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Reference for Tax Option for Tax Rate.</
xsd:documentation>
</xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 963

<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_OptionReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Tax_Widget_DataType">
<xsd:annotation>
<xsd:documentation>Element containing Tax Information</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxPntDtTp" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Tax Point Date Type</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_Point_Date_TypeReferenceEnumeration"
use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxPntDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Tax Point Date</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Purchase_OrderObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Purchase_OrderReferenceEnumeration"
use="required">
<xsd:annotation>
<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 964

<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique
identifier type of a parent object.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="Order_Type_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="Purchase_Order_LineObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Purchase_Order_LineReferenceEnumeration"
use="required">
<xsd:annotation>
<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 965

identifier type of a parent object.</


xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="Change_Order_Reference_ID"/>
<enumeration value="Document_Number"/>
<enumeration
value="Purchase_Order_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="Supplier_Contract_LineObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Supplier_Contract_LineReferenceEnumeration"
use="required">
<xsd:annotation>
<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique
identifier type of a parent object.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 966

<enumeration
value="Alternate_Supplier_Contract_ID"/>
<enumeration
value="Supplier_Contract_Amendment_ID"/>
<enumeration
value="Supplier_Contract_History_ID"/>
<enumeration value="Supplier_Contract_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="Withholding_Tax_Code_Application_DataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Withholding Tax
Details
data</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="WHTaxCd" minOccurs="1" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the
withholding tax code.If
this is blank, Workday will default in the default
withholding tax code from
the invoice header if there is one.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_CodeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="WHTaxAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Total Tax Amount for Withholding Tax
Code</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="WHTaxRateData"
type="Tax_Rate_Application_DataType" minOccurs="1"
maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="CcyRateDataType">
<xsd:annotation>
<xsd:documentation>Currency conversion rate data.</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 967

<xsd:element name="LedgerCcy" type="xsd:string" minOccurs="0"


maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Ledger Currency.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DocCcyConvRate" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Supplier refund currency conversion
rate</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="24"/>
<xsd:fractionDigits value="12"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="CcyRateManualOverride" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Currency rate manual override.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="24"/>
<xsd:fractionDigits value="12"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="DfltCcyRate" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Default currency rate.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="32"/>
<xsd:fractionDigits value="12"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="CcyRateTpOverride" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Override rate type for Business
Document.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Currency_Rate_TypeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="DfltRateTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Default rate type reference</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 968

<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Currency_Rate_TypeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="CcyRateDtOverride" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Currency rate date override.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CcyRateLookupOverride" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Currency rate lookup override.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="24"/>
<xsd:fractionDigits value="12"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="RateBasisDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Default rate basis date.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ManualOverridePercent" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Manual override percent.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="21"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="AddtlFieldsDataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Supplier Invoice
Adjustment
Data</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="ConfAttrVal" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Configurable Attribute Value Reference</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 969

<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Supplier_Invoice_Document_Configurable_Attribute_ValueReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="ConfAttr" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to Configurable Attribute</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"

type="Configurable_AttributeReferenceEnumeration" use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="AttrVal" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to Attribute Value</
xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Taxable_Code_Application_DataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax Details
data</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxApplicability" minOccurs="1" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>This is the reference id value of the tax
applicability.If
this is blank and there invoice line has a sales item,
Workday will default
tax applicability from the sales item. If the invoice
line has a tax code
then tax applicability is required.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_ApplicabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxCd" minOccurs="1" maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 970

<xsd:documentation>This is the reference id value of the tax


code.If this is
blank, Workday will default in the default tax code from
the invoice header
if there is one. If the invoice line has a tax
applicability value, Workday
will validate that the invoice line also has a tax
code.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_CodeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Total Tax Amount for Tax Code and Tax
Applicability</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TaxRateData" type="Tax_Rate_Application_DataType"
minOccurs="1"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax Rate
data.</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Tax_Rate_Application_DataType">
<xsd:annotation>
<xsd:documentation>Encapsulating element containing Tax Rate data.</
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TaxRate" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Tax Rate</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RateReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxAmnt" minOccurs="0" maxOccurs="1">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 971

<xsd:documentation>Total Tax Amount for Tax Rate</


xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="26"/>
<xsd:fractionDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="TaxRecoverability" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Tax
Recoverability</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_RecoverabilityReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an Existing Tax Type</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_TypeReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxPntDtTp" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Reference to an existing Tax Point Date
Type</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Tax_Point_Date_TypeReferenceEnumeration"
use="required">
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="TaxPntDt" type="xsd:date" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Tax Point Date for Taxable Document</
xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 972

</xsd:complexType>
<xsd:complexType name="Financials_Attachment_DataType">
<xsd:annotation>

<xsd:documentation>Encapsulating element containing all Business Document


Attachment
data.</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="FileCont" type="xsd:base64Binary" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>File content in binary format.</
xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Comment</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="ContType">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Content Type of
the
Attachment.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="80"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
<xsd:attribute name="Filename">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Filename of the
Attachment.</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="255"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
<xsd:attribute name="Encoding" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Text attribute identifying Encoding of the
Attachment.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="Compressed" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>Boolean attribute identifying whether the
Attachment is
compressed.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:simpleType name="Supplier_InvoiceReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 973

<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Supplier_Invoice_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="FinancialsBusinessProcessParametersType">
<xsd:annotation>
<xsd:documentation>Contains data for business processing </
xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="AutoComplete" type="xsd:boolean" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>When set to "true" or "1", the business
process is
automatically processed. This means that all approvals
will be automatically
approved in the system, all reviews and to-do's will be
automatically
by-passed, and all notifications will be automatically
suppressed.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Comment" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Free form comment regarding the business
process.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="WorkerRef" minOccurs="0" maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Default the Person making the comment to
the processing
person if not submitted via the web service.</
xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="WorkerReferenceEnumeration"
use="required"> </xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Commodity_Code_ReferenceObjectIDType">
<xsd:annotation>
<xsd:documentation>Contains a unique identifier for an instance of
an
object.</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type"
type="Commodity_Code_ReferenceEnumeration"
use="required">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 974

<xsd:documentation>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". Some "types"
require a reference to a parent instance.</
xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentId" type="xsd:string">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, contains a
unique identifier for an instance of a parent
object.</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="parentType">
<xsd:annotation>
<xsd:documentation>For types that require a parent
reference, the unique
identifier type of a parent object.</
xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Commodity_Code_Type_ID"/
>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:simpleType name="WorkerReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Contingent_Worker_ID"/>
<enumeration value="Employee_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType
name="External_Transaction_Source__All_ReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="External_Supplier_Invoice_Source_ID"/>
<enumeration value="External_Transaction_Source_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="CompanyReferenceEnumeration">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 975

<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Company_Reference_ID"/>
<enumeration value="Organization_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="SupplierReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="External_Sourceable_ID"/>
<enumeration value="Supplier_ID"/>
<enumeration value="Supplier_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Contingent_WorkerReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Contingent_Worker_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Remit-To_Supplier_ConnectionReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Supplier_Connection_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Tax_OptionReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Tax_Option_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Unique_IdentifierReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="IID"/>
<enumeration value="WID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Address_ReferenceReferenceEnumeration">
<xsd:restriction base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 976

<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Address_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Tax_CodeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Tax_Code_ID"/>
<enumeration value="Withholding_Tax_Code_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Worktag_Split_TemplateReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Worktag_Allocation_Template_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Purchase_OrderReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Document_Number"/>
<enumeration value="External_PO_Number"/>
<enumeration value="Purchase_Order_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Supplier_Contract_BaseReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Alternate_Supplier_Contract_ID"/>
<enumeration value="Supplier_Contract_Amendment_ID"/>
<enumeration value="Supplier_Contract_History_ID"/>
<enumeration value="Supplier_Contract_ID"/>
<enumeration value="Supplier_Contract_ID_External"/>
<enumeration value="Supplier_Invoice_Contract_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Invoice_TypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Invoice_Type_ID"/>
<enumeration value="Spend_Data_ID"/>
</xsd:appinfo>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 977

</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Payment_TermsReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Payment_Terms_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Payment_TypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Payment_Type_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Additional_Reference_TypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Additional_Reference_Type_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Payment_Purpose_CodeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Payment_Purpose_Code"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Payment_Handling_InstructionReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Handling_Code_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Prepaid_Amortization_TypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Prepayment_Release_Type_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Frequency_BehaviorReferenceEnumeration">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 978

<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Frequency_Behavior_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType

name="Supplier_Invoice_Document_Configurable_Attribute_ValueReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Configurable_Attribute_Value_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Configurable_AttributeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Configurable_Attribute_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Tax_ApplicabilityReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Tax_Applicability_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Tax_RateReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Tax_Rate_ID"/>
<enumeration value="Withholding_Tax_Rate_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Tax_RecoverabilityReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Tax_Recoverability_Object_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Tax_TypeReferenceEnumeration">
<xsd:restriction base="xsd:string">

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 979

<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Tax_Type_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Tax_Point_Date_TypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Tax_Point_Date_Type_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Procurement_ItemReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Catalog_Item_ID"/>
<enumeration value="Purchase_Item_ID"/>
<enumeration value="Supplier_Item_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Purchase_Order_LineReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Line_Number"/>
<enumeration value="Purchase_Order_Line_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Supplier_Contract_LineReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Supplier_Contract_Line_Number"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Customer_Invoice_LineReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Customer_Invoice_Line_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Supplier_Invoice_Line_AbstractReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 980

<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Supplier_Invoice_Line_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Spend_CategoryReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Spend_Category_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Accounting_TreatmentReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Accounting_Treatment_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Unit_of_MeasureReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="UN_CEFACT_Common_Code_ID"/>
<enumeration value="UOM_EDI_Code_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Supplier_ContractReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Supplier_Contract_ID"/>
<enumeration value="Supplier_Contract_ID_External"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Accounting_WorktagReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Academic_Level_ID"/>
<enumeration value="Academic_Period_ID"/>
<enumeration value="Academic_Person_ID"/>
<enumeration value="Academic_Unit_ID"/>
<enumeration value="Ad_hoc_Payee_ID"/>
<enumeration value="Allocation_Pool_ID"/>
<enumeration value="Alternate_Supplier_Contract_ID"/>
<enumeration value="Applicant_ID"/>
<enumeration value="Application_Grouping_ID"/>
<enumeration value="Appropriation_ID"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 981

<enumeration value="Asset_Adjustment_Reason_Reference_ID"/>
<enumeration value="Asset_Adjustment_Type_Reference_ID"/>
<enumeration value="Asset_Impairment_Reason_ID"/>
<enumeration value="Bank_Account_ID"/>
<enumeration
value="Business_Asset_Cost_Adjustment_Reason_ID"/>
<enumeration value="Business_Unit_ID"/>
<enumeration value="Calculation_Compensation_Basis_ID"/>
<enumeration value="Candidate_ID"/>
<enumeration value="Cash_Activity_Category_ID"/>
<enumeration value="Catalog_Item_ID"/>
<enumeration value="Company_Reference_ID"/>
<enumeration value="Compensation_Basis_ID"/>
<enumeration value="Compensation_Grade_ID"/>
<enumeration value="Contingent_Worker_ID"/>
<enumeration value="Contingent_Worker_Type_ID"/>
<enumeration value="Corporate_Credit_Card_Account_ID"/>
<enumeration value="Cost_Center_Reference_ID"/>
<enumeration value="Custom_Organization_Reference_ID"/>
<enumeration value="Custom_Worktag_06_ID"/>
<enumeration value="Custom_Worktag_07_ID"/>
<enumeration value="Custom_Worktag_08_ID"/>
<enumeration value="Custom_Worktag_09_ID"/>
<enumeration value="Custom_Worktag_1_ID"/>
<enumeration value="Custom_Worktag_10_ID"/>
<enumeration value="Custom_Worktag_11_ID"/>
<enumeration value="Custom_Worktag_12_ID"/>
<enumeration value="Custom_Worktag_13_ID"/>
<enumeration value="Custom_Worktag_14_ID"/>
<enumeration value="Custom_Worktag_15_ID"/>
<enumeration value="Custom_Worktag_2_ID"/>
<enumeration value="Custom_Worktag_3_ID"/>
<enumeration value="Custom_Worktag_4_ID"/>
<enumeration value="Custom_Worktag_5_ID"/>
<enumeration value="Customer_Category_ID"/>
<enumeration
value="Customer_Contract_Alternate_Reference_ID"/>
<enumeration value="Customer_Contract_Reference_ID"/>
<enumeration value="Customer_ID"/>
<enumeration value="Customer_Reference_ID"/>
<enumeration value="Deduction_Code"/>
<enumeration value="Deduction_Recipient_ID"/>
<enumeration value="Donor_ID"/>
<enumeration value="Earning_Code"/>
<enumeration value="Employee_ID"/>
<enumeration value="Employee_Type_ID"/>
<enumeration value="Ethnicity_ID"/>
<enumeration value="Exemption_Code"/>
<enumeration value="Expense_Item_ID"/>
<enumeration value="External_Committee_Member_ID"/>
<enumeration value="External_Sourceable_ID"/>
<enumeration value="Financial_Aid_Award_Year_ID"/>
<enumeration value="Financial_Institution_ID"/>
<enumeration value="Financial_Institution_Reference_ID"/>
<enumeration value="Fringe_Basis_ID"/>
<enumeration value="Fund_ID"/>
<enumeration value="Funding_Source_Name"/>
<enumeration value="Gender_Code"/>
<enumeration value="Gift_Reference_ID"/>
<enumeration value="Grant_ID"/>
<enumeration value="Internal_Service_Provider_ID"/>
<enumeration value="Internal_Service_Provider_Reference_ID"/
>
<enumeration value="Investment_Pool_ID"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 982

<enumeration value="Investment_Profile_ID"/>
<enumeration value="Investor_ID"/>
<enumeration value="Is_Manager_ID"/>
<enumeration value="Is_People_Manager"/>
<enumeration value="ISO_3166-1_Alpha-2_Code"/>
<enumeration value="ISO_3166-1_Alpha-3_Code"/>
<enumeration value="ISO_3166-1_Numeric-3_Code"/>
<enumeration value="Job_Category_ID"/>
<enumeration value="Job_Level_ID"/>
<enumeration value="Job_Profile_ID"/>
<enumeration value="Job_Requisition_ID"/>
<enumeration value="Lease_Expense_Recognition_ID"/>
<enumeration value="Loan_ID"/>
<enumeration value="Location_ID"/>
<enumeration value="Management_Level_ID"/>
<enumeration value="Miscellaneous_Payee_ID"/>
<enumeration value="NI_Category_Letter"/>
<enumeration value="Object_Class_ID"/>
<enumeration value="Opportunity_Reference_ID"/>
<enumeration value="Organization_Reference_ID"/>
<enumeration value="Pay_Rate_Type_ID"/>
<enumeration value="Payroll_Contribution_Group_Key_ID"/>
<enumeration value="Payroll_Federal_Authority_Tax_Code"/>
<enumeration value="Payroll_Flat_Rate_Tax_ID"/>
<enumeration value="Payroll_Income_Code"/>
<enumeration value="Payroll_Local_City_Authority_Tax_Code"/>
<enumeration
value="Payroll_Local_County_Authority_Tax_Code"/>
<enumeration value="Payroll_Local_Other_Authority_Tax_Code"/
>
<enumeration
value="Payroll_Local_School_District_Authority_Tax_Code"/>
<enumeration
value="Payroll_Public_Health_Insurance_Company_ID"/>
<enumeration value="Payroll_Religious_Denomination_ID"/>
<enumeration value="Payroll_State_Authority_Tax_Code"/>
<enumeration value="Petty_Cash_Account_ID"/>
<enumeration value="Position_ID"/>
<enumeration value="Position_Time_Type_ID"/>
<enumeration value="Program_ID"/>
<enumeration value="Program_of_Study_ID"/>
<enumeration value="Project_ID"/>
<enumeration value="Project_Plan_ID"/>
<enumeration value="Project_Worker_Role_ID"/>
<enumeration value="Proposal_Grant_ID"/>
<enumeration value="Prospect_ID"/>
<enumeration value="Prospect_Reference_ID"/>
<enumeration value="Purchase_Item_ID"/>
<enumeration value="Receivable_Writeoff_Reason_ID"/>
<enumeration value="Region_Reference_ID"/>
<enumeration value="Revenue_Category_ID"/>
<enumeration value="Rubric_Value_ID"/>
<enumeration value="Run_Category_ID"/>
<enumeration value="Salary_Over_The_Cap_Type_ID"/>
<enumeration value="Sales_Item_ID"/>
<enumeration value="Spend_Category_ID"/>
<enumeration value="Sponsor_ID"/>
<enumeration value="Sponsor_Reference_ID"/>
<enumeration
value="Student_Application_Residency_Status_ID"/>
<enumeration value="Student_Award_Item_ID"/>
<enumeration value="Student_Charge_Item_ID"/>
<enumeration value="Student_Course_ID"/>
<enumeration value="Student_Course_Section_ID"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 983

<enumeration value="Student_ID"/>
<enumeration value="Student_Recruiting_Campaign_ID"/>
<enumeration value="Student_Recruiting_Event_ID"/>
<enumeration value="Student_Sponsor_Contract_ID"/>
<enumeration value="Student_Waiver_Item_ID"/>
<enumeration value="Supplier_Category_ID"/>
<enumeration value="Supplier_Contract_ID"/>
<enumeration value="Supplier_Contract_ID_External"/>
<enumeration value="Supplier_ID"/>
<enumeration value="Supplier_Reference_ID"/>
<enumeration value="Tax_Applicability_ID"/>
<enumeration value="Tax_Authority_ID"/>
<enumeration value="Tax_Authority_Reference_ID"/>
<enumeration value="Tax_Category_ID"/>
<enumeration value="Tax_Code_ID"/>
<enumeration value="Tax_Point_Date_Type_ID"/>
<enumeration value="Tax_Rate_ID"/>
<enumeration value="Tax_Recoverability_Object_ID"/>
<enumeration value="Third_Party_ID"/>
<enumeration value="Universal_Identifier_ID"/>
<enumeration value="Withholding_Order_Case_ID"/>
<enumeration value="Withholding_Tax_Code_ID"/>
<enumeration value="Withholding_Tax_Rate_ID"/>
<enumeration value="Work_Function_ID"/>
<enumeration value="Work_Shift_ID"/>
<enumeration value="Workday_Deduction_Code"/>
<enumeration value="Workday_Earning_Code"/>
<enumeration value="Worker_Type_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Supplier_Invoice_Line_SplitReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Supplier_Invoice_Line_Split_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Business_Document_Line_SplitReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="Internal_Service_Delivery_Line_Split_ID"/>
<enumeration value="Inventory_Stock_Request_Line_Split_ID"/>
<enumeration value="Purchase_Order_Line_Split_ID"/>
<enumeration value="Request_for_Quote_Award_Line_Split_ID"/>
<enumeration value="Request_for_Quote_Line_Split_ID"/>
<enumeration value="Requisition_Line_Split_ID"/>
<enumeration value="Supplier_Invoice_Line_Split_ID"/>
<enumeration value="Supplier_Invoice_Request_Line_Split_ID"/
>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Abstract_Retainable_LineReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 984

<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Line_Number"/>
<enumeration value="Purchase_Order_Line_ID"/>
<enumeration value="Receivable_Contract_Line_Reference_ID"/>
<enumeration value="Student_Sponsor_Contract_Line_ID"/>
<enumeration value="Supplier_Contract_Line_Number"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Event_Attachment_CategoryReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Document_Category__Workday_Owned__ID"/>
<enumeration value="Document_Category_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Supplier_Invoice_Work_Queue_TagReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Work_Queue_Tag_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Abstract_Down_PaymentReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration
value="Supplier_Invoice_Adjustment_Reference_ID"/>
<enumeration value="Supplier_Invoice_Reference_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="Currency_Rate_TypeReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Currency_Rate_Type_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="CountryReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="ISO_3166-1_Alpha-2_Code"/>
<enumeration value="ISO_3166-1_Alpha-3_Code"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 985

<xsd:simpleType name="Commodity_Code_ReferenceEnumeration">
<xsd:restriction base="xsd:string">
<xsd:annotation>
<xsd:appinfo>
<enumeration value="WID"/>
<enumeration value="Commodity_Code_ID"/>
</xsd:appinfo>
</xsd:annotation>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>

Third-Party Payments Integration

Steps: Set Up Third-Party Payments Integration

Context
You can create an integration to generate an XML audit file containing details of payments made to third
parties. You can set threshold values to exclude payments below a specified value.

Steps
1. Access the Create Tax Authority Form Type task.
Set up the payment categories on your tax authority form.
Security: Set Up: Tax domain in the Common Financial Management functional area.
2. Access the Maintain Third-Party Payments Configuration task.
Map the payment categories to Workday spend categories or spend category hierarchies and specify
any required thresholds.
When you select:
• Aggregate Category Mapping, you can group payment categories after mapping and set
thresholds for each group.
• Category Mapping, you can set individual thresholds for each payment category.
Security: Set Up: Tax domain in the Common Financial Management functional area.
3. Create Integration System.
Select Third-Party Payments in the New Using Template prompt.
4. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
5. (Optional) Select Integration System > Configure Integration Attributes from the related actions
menu of the integration system.
Enter integration service attributes.
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure
6. (Optional) Set Up Integration Field Overrides for DIS on page 1861.
Configure additional fields or override field mappings as required.
7. (Optional) Select and Set Up Connector Output Fields on page 1864.
Select fields to include or exclude from the output.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 986

8. Launch an Integration on page 23.

Next Steps
• Create a custom integration to transform the output file into a different format.
• Submit the audit file to a tax authority.
Related Information
Tasks
Steps: Set Up DAS2 Integration on page 740

Concept: Third-Party Payments Integration


Some tax authorities require companies to provide information about payments to third parties. You can
create an integration using the Third-Party Payments integration template to export these details to an XML
file. When the tax authority specifies another format, you can use a custom integration to transform the
XML file as required.
The integration exports the total amounts of these payments for a company, using the company base
currency:
• Supplier invoice payments, including supplier invoice adjustments.
• Ad hoc payments.
• Miscellaneous payments.
The integration also includes corrections made through accounting adjustments.
While you can exclude payment types, you can't exclude payees. Workday includes all payees of these
types that meet the selection criteria:
• Ad hoc payees.
• Contingent workers.
• Miscellaneous payees.
• Suppliers.

Tax Authority Forms


Before setting up the integration, you can use the Create Tax Authority Form Type task to:
• Set up the payment categories on the tax authority form.
• Exclude payment types that aren't relevant.
You can then use the Maintain Third-Party Payments Configuration task to map the payment categories
to Workday spend categories or spend category hierarchies. You can also set payment thresholds to
include payments only when they exceed a specified amount.
You can select:
• Aggregate Category Mapping to group payment categories and set thresholds for each group.
• Category Mapping to set individual thresholds for each payment category.

Example: Setting Thresholds for Grouped Payment Categories


The tax authority requires you to declare payments to third parties under 4 payment categories:
• Accommodation
• Fees
• Food
• Other Payments
The form asks you to include the details of payments in:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 987

• Accommodation and Food when the combined value is greater than 2,000.
• Fees and Other Payments when the combined value is greater than 1,800.
On the Maintain Third-Party Payments Configuration task, you select Aggregate Category Mapping
and map the payment categories to your Workday spend categories.
After you map the categories, you add 2 rows to the grid to set the thresholds:

Payment Categories Threshold


Accommodation 2,000
Food

Fees 1,800
Other Payments

When you run the integration, Workday calculates the amounts. The payments in:
• Accommodation and Food total 2,225.
• Fees and Other Payments total 1,800.
Since both groups are equal to or greater than the thresholds you specified, Workday includes all
payments in the output file.

Example: Setting a Threshold for Each Payee


The tax authority requires details of payments to any payees to whom you've paid more than 1,200 in the
reporting period.
On the Maintain Third-Party Payments Configuration task, you select Aggregate Category Mapping
and map the payment categories to your Workday spend categories.
After you map the categories, you add all payment categories to 1 row and enter the 1,200 threshold.
When you run the integration, Workday includes details about the relevant payees and payments in the
output file.

Output Files
When the integration runs, Workday generates a ZIP file containing the output XML file. You can find the
file on the Output Files tab of the integration event.
Related Information
Concepts
Concept: DAS2 Integration on page 742

Travel Booking Inbound Connector

Steps: Set Up Travel Booking Inbound Connector

Prerequisites
Set up an external server that your external endpoint and your integration system can access.

Context
Set up an integration system to import travel booking data from an external endpoint into Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 988

Steps
1. Access the Create Integration System task and enter Import Travel Booking Records at the New
Using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
Dynamic Map Service - Airlines Enables mapping of airline codes to
corresponding airline records in Workday.
Dynamic Map Service - Car Rentals Enables mapping between:
• Agency codes for car rental agencies.
• Corresponding records for car rental agencies
in Workday.

Dynamic Map Service - Cities Enables mapping of cities to corresponding


records in Workday.
Dynamic Map Service - Hotels Enables mapping of hotel codes to corresponding
hotel records in Workday.

Security: Integration Build and Integration Configure domains in the Integration functional area.
3. Create an Integration System User (ISU) and grant the ISU access to the Process: Travel Booking
security domain.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. As a related action on your integration, select Integration System > Configure Integration Attributes:
Option Description
Default Company Specify Company to use if there's no
corresponding Company for the Employee ID.
ISO Currency Code Type Specify the ISO Currency Code type used in
the inbound integration file. If not overridden,
Workday uses ISO Alphabetic Currency Code.
ISO Country Code Type Specify the ISO Country Code type used in
the inbound integration file. If not overridden,
Workday uses ISO 2-character country code
format.
Dynamic Map Service - Airlines When implementing this integration, accept the
Workday-delivered settings for all attributes of
this service. You can modify these settings only if
instructed to do so by Workday Support.
Dynamic Map Service - Car Rentals When implementing this integration, accept the
Workday-delivered settings for all attributes of
this service. You can modify these settings only if
instructed to do so by Workday Support.
Dynamic Map Service - Cities When implementing this integration, accept the
Workday-delivered settings for all attributes of
this service. You can modify these settings only if
instructed to do so by Workday Support.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 989

Option Description
Dynamic Map Service - Hotels When implementing this integration, accept the
Workday-delivered settings for all attributes of
this service. You can modify these settings only if
instructed to do so by Workday Support.
5. Map Travel Booking Inbound Connector Integration Data on page 989.
Map values between your travel booking provider and internal values in Workday.
6. Set Up Integration Sequence Generators on page 1856.
Define how Workday generates unique filenames for each integration file.
7. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves travel booking data files from your external endpoint.
8. Launch an Integration on page 23.
Schedule how often the integration system runs.
9. Create a Document Transformation integration system to convert the inbound file into the file format
required by the Travel Booking Inbound Connector.
See: Steps: Set Up Document Transformation Connector on page 571.

Map Travel Booking Inbound Connector Integration Data

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Map external values for travel type, booking status, purchase status, and class of service to corresponding
values in Workday.

Steps
1. Access the View Integration System report.
2. At the Integration System prompt, select the Travel Booking Inbound Connector.
3. As a related action on the integration system, select Integration System > Configure Integration
Maps.
4. Edit maps by adding, removing, or changing entries in the Map Values columns:
• To add an entry, insert a row in the grid and specify the Internal Value and External Value.
• To delete an entry, remove the current row from the grid.
• To change an entry, edit the values in the Internal Value and External Value columns.
Note: Use caution when you edit integration maps. If you enter values in an incorrect format, errors
can occur when the integration runs. Values are both case sensitive and space sensitive.

Concept: Travel Booking Inbound Connector


The Travel Booking Inbound Connector integration enables your travel booking providers to load travel
booking data into Workday. This integration provides a unified view of corporate travel booking records
sourced from your third-party travel provider. It compares the data with your actual expense report data for
purposes of supporting accruals, management reporting, and controls. You benefit from reduced data entry
as travel booking records populate details against expense report lines.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 990

Data Imported by Travel Booking Inbound Connector Integration


Travel Booking Inbound Connector imports data about these types of travel bookings:
• Air travel
• Hotel reservations
• Car rentals
Travel Booking Inbound Connector imports data in a defined Workday XML schema format. Unless
your travel booking provider can generate files in the XML format, create a Document Transformation
integration to transform each file. The Travel Booking Inbound Connector retrieves each file before it loads
the file data into Workday.

Integration Process Flow


When configured, the Travel Booking Inbound Connector launches and runs using this process:
1. The Travel Booking Inbound Connector retrieves a file from an external server managed by the travel
booking provider.
2. The associated Document Transformation integration transforms the file into the XML format required
by the Travel Booking Inbound Connector.
3. The Travel Booking Inbound Connector reads the transformed XML file and loads the included data into
Workday.

Reference: Travel Booking Inbound Connector File Schema


This table lists the required and optional fields that comprise the Travel Booking Inbound Connector XML
file schema.

Table 1: File Schema

Element Name Required/Optional Datatype Notes


TravelBookingFile Required TravelBookingFileType
(Top-level element of file.
Contains one or more
Travel_Booking_Record
elements.)
Travel_Booking_Record Required TravelBookingRecordType
(Contains all following
elements.)
Travel_Provider_Booking_Record_ID
Required String
Employee_ID Optional String Nillable (can be null).
Accountholder_Name Optional String Nillable (can be null).
Traveler_Name Optional String Nillable (can be null).
Booking_Date Optional Date Nillable (can be null).
Ticket_Number Optional String Nillable (can be null).
Travel_Provider Required String
Itinerary_Number Optional String Nillable (can be null).
Itinerary_Description Optional String Nillable (can be null).
Reservation_Number Optional String Nillable (can be null).
Travel_Type Optional String Nillable (can be null).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 991

Element Name Required/Optional Datatype Notes


Booking_Status Optional String Nillable (can be null).
Location_Code_DestinationOptional String Nillable (can be null).
Location_Code_Origin Optional String Nillable (can be null).
Air_Routing Optional String Nillable (can be null).
Class_Of_Service Optional String Nillable (can be null).
Purchase_Status Optional String
Source_Ticket_Value Optional TravelAmountType Nillable (can be null).
(Decimal, 6 fraction
digits, 26 total digits)
Transaction_Extended_Amount
Optional TravelAmountType Nillable (can be null).
(Decimal, 6 fraction
digits, 26 total digits)
Source_Currency Optional TravelCurrencyCodeType Nillable (can be null).
(String, [A-Z]{3}|[0-9]{3})
Source_Lowest_Logical_Amount
Optional TravelAmountType Nillable (can be null).
(Decimal, 6 fraction
digits, 26 total digits)
Last_4_Digits_of_Credit_Card_Number
Optional TravelCreditCardLast4TypeNillable (can be null).
(Integer, 4 digits)
Credit_Card_Transaction_Reference
Optional String Nillable (can be null).
Destination_City Optional String Nillable (can be null).
Destination_State Optional String Nillable (can be null).
Destination_Country Optional TravelCountryCodeType Nillable (can be null).
(String, [A-Z]{2,3})
Origination_City Optional String Nillable (can be null).
Origination_State Optional String Nillable (can be null).
Origination_Country Optional TravelCountryCodeType Nillable (can be null).
(String, [A-Z]{2,3})
Merchant_Code Optional String Nillable (can be null).
Merchant_Name Optional String Nillable (can be null).
Travel_Start_Date Optional Date Nillable (can be null).
Travel_End_Date Optional Date Nillable (can be null).
Source_Daily_Amount Optional TravelAmountType Nillable (can be null).
(Decimal, 6 fraction
digits, 26 total digits)
Travel_Policy_Code Optional String Nillable (can be null).
Travel_Policy_Description Optional String Nillable (can be null).

XML Schema

<?xml version="1.0" encoding="UTF-8"?>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 992

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:tc="urn:com.workday/travelbookingconnector"
targetNamespace="urn:com.workday/travelbookingconnector"
elementFormDefault="qualified">
<xs:element name="TravelBookingFile" type="tc:TravelBookingFileType"/>

<xs:simpleType name="TravelAmountType">
<xs:restriction base="xs:decimal">
<xs:fractionDigits value="6"/>
<xs:totalDigits value="26"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="TravelCreditCardLast4Type">
<xs:restriction base="xs:int">
<xs:totalDigits value="4"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="TravelCurrencyCodeType">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z]{3}|[0-9]{3}"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="TravelCountryCodeType">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z]{2,3}"/>
</xs:restriction>
</xs:simpleType>

<xs:complexType name="TravelBookingFileType">
<xs:sequence>
<xs:element name="Travel_Booking_Record"
type="tc:TravelBookingRecordType" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<xs:complexType name="TravelBookingRecordType">
<xs:sequence>
<xs:element name="Travel_Provider_Booking_Record_ID"
type="xs:string" minOccurs="1"/>
<xs:element name="Employee_ID" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Accountholder_Name" type="xs:string"
minOccurs="0" nillable="true"/>
<xs:element name="Traveler_Name" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Booking_Date" type="xs:date" minOccurs="0"
nillable="true"/>
<xs:element name="Ticket_Number" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Travel_Provider" type="xs:string" minOccurs="1"/
>
<xs:element name="Itinerary_Number" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Itinerary_Description" type="xs:string"
minOccurs="0" nillable="true"/>
<xs:element name="Reservation_Number" type="xs:string"
minOccurs="0" nillable="true"/>
<xs:element name="Travel_Type" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Booking_Status" type="xs:string" minOccurs="0"
nillable="true"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 993

<xs:element name="Location_Code_Destination" type="xs:string"


minOccurs="0" nillable="true"/>
<xs:element name="Location_Code_Origin" type="xs:string"
minOccurs="0" nillable="true"/>
<xs:element name="Air_Routing" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Class_Of_Service" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Purchase_Status" type="xs:string"
minOccurs="0" />
<xs:element name="Source_Ticket_Value" type="tc:TravelAmountType"
minOccurs="0" nillable="true"/>
<xs:element name="Transaction_Extended_Amount"
type="tc:TravelAmountType" minOccurs="0" nillable="true"/>
<xs:element name="Source_Currency"
type="tc:TravelCurrencyCodeType" minOccurs="0" nillable="true"/>
<xs:element name="Source_Lowest_Logical_Amount"
type="tc:TravelAmountType" minOccurs="0" nillable="true"/>
<xs:element name="Last_4_Digits_of_Credit_Card_Number"
type="tc:TravelCreditCardLast4Type" minOccurs="0" nillable="true"/>
<xs:element name="Credit_Card_Transaction_Reference"
type="xs:string" minOccurs="0" nillable="true"/>
<xs:element name="Destination_City" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Destination_State" type="xs:string"
minOccurs="0" nillable="true"/>
<xs:element name="Destination_Country"
type="tc:TravelCountryCodeType" minOccurs="0" nillable="true"/>
<xs:element name="Origination_City" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Origination_State" type="xs:string"
minOccurs="0" nillable="true"/>
<xs:element name="Origination_Country"
type="tc:TravelCountryCodeType" minOccurs="0" nillable="true"/>
<xs:element name="Merchant_Code" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Merchant_Name" type="xs:string" minOccurs="0"
nillable="true"/>
<xs:element name="Travel_Start_Date" type="xs:date" minOccurs="0"
nillable="true"/>
<xs:element name="Travel_End_Date" type="xs:date" minOccurs="0"
nillable="true"/>
<xs:element name="Source_Daily_Amount" type="tc:TravelAmountType"
minOccurs="0" nillable="true"/>
<xs:element name="Travel_Policy_Code" type="xs:string"
minOccurs="0" nillable="true"/>
<xs:element name="Travel_Policy_Description" type="xs:string"
minOccurs="0" nillable="true"/>
</xs:sequence>
</xs:complexType>
</xs:schema>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 994

Tax ID Validation Integrations

Steps: Set Up Tax ID Validation Integration

Prerequisites
• Ensure that the format of your tax IDs comply with the format requirements of these validation services:
• European VAT Information Exchange System (VIES)
• The ID format should include the country code, followed by 2-12 characters. Special characters
are only permitted for tax IDs related to the Netherlands.
• HM Revenue & Customs (HMRC) Check a UK VAT number
• The ID format must be either 9 or 12 digits long, without spaces or special characters.
• Security:
• These domains in the Integration functional area:
• Integration Build
• Integration Configure
• Set Up: Tax domain in the Common Financial Management functional area.

Context
You can check the validity of tax IDs in your tenant by submitting them to an external validation service
using a tax ID validation integration.
You can configure the integration as:
• A standalone process.
• A Data Initialization Service (DIS).
• Part of a business process.
When you run this integration, Workday sends the designated tax ID and country to an external validation
service for verification. You can use the verification information received for VAT verification but can't
retransmit, copy, or reproduce it.

Steps
1. Create Integration System on page 1854.
Create an integration system for tax ID validations.
Select the Tax ID Validation integration template to submit the tax IDs you configure in Workday to an
external validation service.
2. Configure the integration using 1 of these methods:
• Set Up Integration Data Initialization Service on page 564.
• To validate high volumes of tax IDs or filter for specific criteria, use a custom report to populate
your integration.
• When you configure your document builder, you must set up these report fields:

Report Field Select


Country Country for Tax ID
ID (case sensitive) Tax ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 995

Report Field Select


Service External Validation Service
• When you launch the DIS integration, we recommend not entering any values for the launch
parameters. Entering launch parameters will send the same tax IDs for validation twice and
increase run time.
• Launch an Integration on page 23.
• Schedule or manually launch an integration to check the validity of your tax IDs. If you're not
scheduling, you can manually enter your tax IDs.
• You can use Entity Type to filter your preconfigured tax IDs by company, customer, and
supplier. You can only use it when you select a value for Tax IDs by Validation Service.
Note: You can specify a value in the Tax IDs prompt only if configuring the integration as a
business process step, and in this instance the Tax IDs by Validation Service and Entity Type
prompts must remain blank.
• Edit Business Processes.
• Add the integration as a step on a business process for any event with a report field that will
return tax IDs.
• You can also add a step on the Supplier Event business process to configure the Tax ID
Numbers for Validation Service report field (on the Supplier Event business object) to return
tax IDs associated with a validation service.
3.

Result
Workday stores:
• Responses for tax IDs with statuses of Valid and Invalid.
• Date and time of the validity check.
• Name and address of the associated entity, when provided in the government data.
You can view the 5 most recent responses from the Validation Status column in the Tax Information tab
on reports.

Next Steps
Use report fields to display the most recent results from the external validation service on the custom
report.
Related Information
Reference
22R1 What's New Post: Integration for Tax ID Validations

Reference: European VAT Information Exchange System Tax ID Types


Workday provides these preconfigured European VAT Information Exchange System (VIES) tax ID types
in your tenant that you can use in your tax ID integrations:

Country Tax ID Type


Austria UID
Belgium No TVA
Bulgaria DDS
Croatia PDV-ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 996

Country Tax ID Type


Cyprus FPA
Czechia DIC
Denmark • Company VAT Registration Number
• CVR

Estonia KMKR
Finland VAT Number (ALV)
France No TVA
Germany USt-IdNr
Greece FPA
Hungary ANUM
Ireland VAT No
Italy • E-filing VAT Registration Number - VAT Group
• Partita IVA

Latvia PVN
Lithuania PVM kodas
Luxembourg No. TVA
Malta VAT Identification Number
Netherlands BTW-nr
Poland • NIP
• VAT Number

Portugal NIPC
Romania CIF
Slovakia IC DPH
Slovenia ID za DDV
Spain IVA
Sweden Momsnr
United Kingdom Vat Reg No (Northern Ireland)

Related Information
Reference
22R1 What's New Post: Integration for Tax ID Validations

Example: Set Up Data Initialization Service for Tax ID Validation


This example illustrates how to create and run a tenanted Data Initialization Service (DIS) to validate Value
Added Tax (VAT) registration numbers using a custom report.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 997

Context
Your company uses suppliers based in Poland. To comply with VAT reporting requirements and reduce the
risk of fraudulent payments, you want to validate these Tax IDs before processing supplier payments. A
DIS is the most efficient way to validate large volumes of IDs.

Prerequisites
Security:
• Custom Report Creation domain in the System functional area.
• Integration Build domain in the Integration functional area.
• Public Reporting Items domain in the Tenant Non-Configurable functional area.

Steps
1. Access the Create Custom Report task.
a) Enter these values:

Option Value
Report Name Enter Polish VAT IDs.
Report Type Select Advanced.
Data Source Select Suppliers.
b) Click OK.
c) Add 3 rows to the grid on the Columns tab and select these values:

Business Object Field


Supplier Supplier Name
Supplier Default Address for Supplier
Supplier Tax IDs Tax ID
d) On the Filter tab, add a row to the Filter conditions for filtering on instances grid and enter these
values:

Option Value
Field Supplier Tax IDs
Operator is not empty
e) On the Subfilter tab, click Add.
f) In the Sub Level Filter section, select Supplier Tax IDs in the Business Object prompt.
g) Add a row to the grid and enter these values:

Option Value
Field Country for Tax ID
Operator in the selection list
Comparison Type Value specified in this filter
Comparison Value Poland
h) Click OK and Done.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 998

2. Access the Create Integration System task.


a) Enter Vat Validation in the System Name field.
b) From the New using Template prompt, select Tax ID Validation.
c) Click OK.
d) From the related actions menu of the Vat Validation integration, select Integration System >
Configure Integration Services.
e) Add a row to the Custom Integration Services grid.
f) From the Integration Service prompt, select Create > Create Integration Data Initialization
Service.
g) Enter these values:

Option Value
Name Polish Vat Validation
Document Filename Polish Vat Validation
Wrapper Element Name Polish Vat Validation
Population Using Polish VAT IDs
Web Service Alias Polish Vat Validation
h) Add a row to the Fields grid.
i) In the Field Details column, enter these values:

Field Value
Name Enter Supplier Tax IDs.
Sub-Document Select.
j) Select Supplier Tax IDs from the Loop on instances prompt.
k) In the Build content using column, select Create Document Builder from the Document Builder
prompt.
l) Enter Tax IDs in the Document Builder Name field.
m) Add 3 rows to the Schema and Build grid.
n) As you complete the grid, consider:

Field Details Build content using


Enter Country in the Name field. Select Country for Tax ID from the Value
prompt.
Enter ID (case sensitive) in the Name field. Select Tax ID from the Value prompt.
Enter Service in the Name field. Select External Validation Service from the
Value prompt.
o) Click OK on each of these pages:
• Create Document Builder
• Create Integration Data Initialization Service
• Configure Integration Services
3. From the related actions menu of the VAT Validation integration, select Integration > Launch /
Schedule.
a) Click OK.
b) Leave the launch parameters blank and click OK.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 999

Result
You can view the validation results on the:
• Output Files tab of the integration event.
• Tax Information profile group of the supplier profile.
You can also create a custom report that includes the validation results.

Workday Bank Connectivity

Concept: Workday Bank Connectivity Integration


Workday Bank Connectivity leverages the Kyriba Bank Connectivity as a Service (BCaaS) system to
provide fast and cost-effective implementations for bank integrations. You can access preconfigured
payment scenarios in the Kyriba BCaaS that meet country and local regulations for banks across the
globe, eliminating the need for further customizations to support local requirements for bank connectivity.

Workday Bank Connectivity Data Process

Refe rential Data (API)

Payment File Repackaged


(DIS) Payment File(s)

Workday SFTP Kyriba SFTP Bank(s)

Bank Statement and Bank Statement and


Pay Acknowledgement Payment Status

You can configure the Workday Bank Connectivity integration system to:
• Generate referential external IDs for Workday data objects that map to the matching referential data
in the Kyriba system. Workday sends the referential data to Kyriba using an initial bulk setup and
ongoing updates using API calls during payment file generation. Kyriba assigns corresponding IDs to
the payments that flow through Kyriba and the banks.
• Send Workday payment files to an SFTP server where Kyriba consumes and processes the payment
data. Kyriba transforms the payments into bank-accepted formats based on customer payment
scenarios. The payment scenarios define how Kyriba processes combinations of payment category,
payment method, and country as well as the format to deliver to the bank. Kyriba then sends the
formatted payment files directly to the bank.
• Receive and process payment acknowledgement inbound files from Kyriba by SFTP in the Workday-
defined format.
• Receive and process bank statement inbound files from Kyriba by SFTP in the Workday-defined format.

Steps: Manage Workday Bank Connectivity

Prerequisites
Note: To use these features, you must purchase the Workday Bank Connectivity SKU. Additionally,
you must subscribe to Innovation Services if you're on the MSA-type (see below) subscription service
agreement. If you haven't subscribed to Innovation Services, contact your account executive to request
the Innovation Services Addendum. For more information, see Workday Innovation Services on Workday
Community.
Note: You might need to take additional steps to enable this feature based on your organization's
subscription service agreement. To determine your subscription service agreement:
1. Select your profile avatar on Workday Community.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1000

2. Select Profile.
3. On your profile page, select your organization's name, which is beneath your name and next to your job
title.
4. View your Subscription Service Agreement value.
If the value is:
• UMSA, you can skip the Innovation Services Opt In step.
• MSA, you must enable this feature through Innovation Services using the Innovation Services Opt In
step.
• Request these items from Kyriba to use for the implementation:
• API credentials
• Referential data workbook
• SFTP details
• Set up settlement. See ../../../financial-management/settlement/settlement-configuration/
dan1370797015404.dita.

Context
You can configure Workday Bank Connectivity to send electronic payments through the Kyriba Bank
Connectivity as a Service (BCaaS) system. Workday Bank Connectivity enables you to process the
payments as well as import bank statements and payment acknowledgements in a unified banking
solution.
For the initial implementation, you manually generate referential external IDs for data objects within
Workday to map to corresponding IDs in Kyriba. Workday sends subsequent updates to referential data
using an API during settlement. Kyriba uses the referential data to build out the payments.

Steps
1. Set up banking.
a) Access the Create Financial Institution task or Edit Financial Institution task.
As you complete the task, consider:

Option Description
Bank Identification Code Enter the 8 to 11-character BIC code used
to identify the bank in payment files for
global transactions.
Address Enter the country and address information for
the primary location of the bank.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1001

Option Description
Email Enter the email address for the primary location
of the bank.

Security: Set Up: Bank Entity domain in the Banking and Settlement functional area.
b) Access the Create Bank Branch task or Edit Bank Branch task.
Define and maintain information about bank or business entity branches. Specify theBranch IDfor
each bank branch.
All financial institutions attached to a bank branch must share the same bank code or BIC code.
Security: Set Up: Bank Entity domain in the Banking and Settlement functional area.
c) Access the Create Bank Account or Edit Bank Account task.
As you complete the Account Information section, consider:

Option Description
Bank Account Type Select Bank Account.
Bank Branch Select the bank branch where the account is
located.
Bank Identification Code Enter the 8 to 11-character BIC code used
to identify the bank in payment files for
global transactions.
Bank Statement Format The bank statement format that the bank uses.
Kyriba supports these file formats:
• BAI2
• CAMT
• MT940

Note that you can't group electronic payments for reconciliation on bank accounts that you're using
with Kyriba.
Security: Set Up: Bank Entity domain in the Banking and Settlement functional area.
See ../../../financial-management/cash/banking-setup/dan1370796812143.dita.
2. Access the Innovation Services Opt In task.
Opt in to Innovation Services to use the Workday Bank Connectivity feature, related tasks, and
templates in your tenant.
On the Available Services tab, select the Workday Bank Connectivity service in the Financials
category.
Security: Manage: Innovation Services domain in the Innovation Services functional area.
3. Access the Enable Bank Connectivity Reference Data task.
Enable the mapping functionality within Workday. This generates the referential external IDs for all
instances of existing data objects and any new data objects that you create in Workday.
Select Confirm and then click OK to automatically navigate to the next task.
Security: Set Up: Bank Connectivity domain.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1002

4. Access the Generate Bank Connectivity Reference Data Files task.


For the initial data load, manually generate the CSV files with the referential external IDs for all
instances of these data object types in Workday:
• Bank Account
• Bank Branch
• Company
• Financial Institution
Refresh the task until the output files are available.
You can regenerate output files at any time to include new eligible items within Workday.
Security: Set Up: Bank Connectivity domain.
5. (Optional) Access the Maintain Bank Connectivity Reference Data Mapping task.
If you’re implementing an existing Kyriba BCaaS customer, you can override the generated referential
external IDs with the codes that are already populated in their Kyriba tenant.
Enter overridden external IDs that meet these length requirements:
• Bank Account: Between 4 and 12 alphanumeric characters.
• Bank Branch: Between 4 and 10 alphanumeric characters.
• Company: Between 4 and 12 alphanumeric characters.
• Financial Institution: Between 4 and 10 alphanumeric characters.
Note that the external IDs can’t contain symbols or special characters.
To update the referential data in bulk, you can use the Put External Payment Reference Detail web
service.
Security: Set Up: Bank Connectivity domain.
6. (Optional) Access the View Bank Connectivity Reference Data Mapping report.
View and confirm that external IDs were generated for particular or all existing instances of data
objects.
Security: Set Up: Bank Connectivity domain.
7. Set up an integration system to process and send the outbound payment and referential data to Kyriba
using the Workday Bank Connectivity - Payments Initiation integration template.
See Steps: Set Up Bank Connectivity - Payments Initiation Integration.
8. Set up an integration system to receive payment acknowledgements from Kyriba using the Workday
Bank Connectivity - Import Payment Status integration template.
See Steps: Set Up Bank Connectivity - Import Payment Status Integration.
9. Set up an integration system to receive bank statements from Kyriba using the Workday Bank
Connectivity - Import Bank Statements integration template.
See Steps: Set Up Bank Connectivity - Import Bank Statements Integration.
10.Access the Edit Bank Routing Rule task.
Review the bank routing rules to ensure you're routing payments through a bank account that sends
payments to an integration system based on the Workday Bank Connectivity - Payments Initiation
template.
Security: Set Up: Settlement domain in the Banking and Settlement functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1003

11.Access the Edit Bank Account task.


For each bank account, select the payments integration system that you configured and
payment acknowledgements option for settlement.
As you complete the Settlement Setup tab, consider:

Option Description
Technical Integration Select the integration system based on the
Workday Bank Connectivity - Payments Initiation
integration template for each applicable payment
type and payment category from the Integration
System prompt.
Receives Acknowledgement Select the check box to receive payment
acknowledgements from the bank.
12.Populate the Kyriba-Core Data Workbook spreadsheet with the Workday CSV file data.
For the initial data load, download the CSV files to add the contents into the Kyriba referential data
workbook. Send the completed workbook to Kyriba professional services to bulk upload into the Kyriba
referential data.
13.(Optional) For banks that use MT940 statements, record the bank ID and BIC details in a separate
spreadsheet.
Send the completed spreadsheet to Kyriba professional services to verify the details and load into the
Kyriba system.
Example: You can enter the values for all bank accounts in these tabs and columns:

Tab Columns
1 • Bank ID
• Bank Account

2 • BIC
• IBAN

14.Create a manual or automatic settlement run to settle your payment category.


You can either:
• ../../../financial-management/settlement/payment-settlement/dan1370797016124.dita.
• ../../../financial-management/settlement/payment-settlement/dan1370797013955.dita.

Result
During settlement processing, Workday generates and sends the payment files to Kyriba. Workday
also sends any incremental updates to the referential data objects using API calls. Workday imports the
payment acknowledgment files and bank statements based on your scheduled integrations.

Next Steps
As you create new referential data objects in Workday, work with Kyriba professional services to assess
whether existing payment scenarios require configurations to support the new objects. You might
need additional payment scenarios created for these Workday dimensions:
• Countries
• Payment categories
• Payment file formats delivered to the bank
• Payment methods

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1004

Note: You can access portions of Workday Bank Connectivity for implementation, configuration and
troubleshooting through a separate browser-based application console from third-party providers (“TPPs”).
You must set up and maintain an account with TPPs to use the features of Workday Bank Connectivity.
Upon expiration or termination of your active subscription to Workday Bank Connectivity, you will lose
access to the associated TPP account, including any right to retrieve Customer Content from the TPP.
Note: To opt out of Workday Bank Connectivity, you must send a discontinue notification through
Workday’s CSM or support channels and complete the subsequent offboarding process (the “Offboarding
Process”). In the event that you don't send a discontinue notification within 60 days of the expiration or
termination of your subscription to Workday Bank Connectivity SKU, Workday may initiate and complete
the Offboarding Process on your behalf. Customers that enabled this feature through Innovation Services
must also opt-out of the Workday Bank Connectivity Innovation Service through IS Enablement.
Related Information
Reference
FAQ: Workday Bank Connectivity Integration on page 1010

Steps: Set Up Bank Connectivity - Payments Initiation Integration

Prerequisites
Configure these business processes and security policies in the Banking and Settlement functional area:
• Payment Release Event
• Outsourced Payment Release Event

Context
You can create the payment initiation integration to process Workday Bank Connectivity payments. When
you settle payments in Workday, the integration generates and delivers the payment files to the Kyriba
system by SFTP. The integration calls APIs to update or create the referential data to include in the
payment files.

Steps
1. Create Integration System on page 1854.
From the New Using Template prompt, select Workday Bank Connectivity - Payments Initiation. Also,
select the Enable All Services check box.
2. Select Integration System > Configure Integration Attributes from the related actions menu of your
payment integration system.
As you complete the task, consider:
Option Description
File Name Tenant Reference Enter the File Name Tenant Reference attribute
provided to you during implementation. This
attribute provides data to the integration system
to enable the correct format when building out the
payment file name.
Example: The tenant reference displays
at the beginning of this file name:
WORKDAYTEST.NC4.IMPORT.3911116.
PY_TRANSFER.WD_FORMAT.NULL.391.XML.

API End Point for Referential Data Updates Enter the URL location of the API call for
referential data updates. Provide the token
endpoint URL from Kyriba.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1005

Option Description
(Optional) Disable Referential Data Updates Workday won't update existing referential data for
for Selected Object Types the selected data object types.
(Optional) Disable the Creation of Referential Workday won't create missing referential data
Data for Selected Object Types for the selected data object types when the data
objects don’t exist.
(Optional) Ignore Referential Data Failures for Workday continues sending the payment file to an
Selected Object Types external banking partner when there's an error for
the selected data objects. The error occurs during
the incremental referential data update or creation
process.

Security: Integration Configure domain in the Integration functional area.


3. Create an integration system user (ISU).
Grant the ISU Get and Put access to these domains:
• Integration Event in the Integration functional area.
• Process: Settlement in the Banking and Settlement functional area.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. Set Up Integration Sequence Generators on page 1856.
The Workday Bank Connectivity - Payments Initiation template only supports outsourced payment
group IDs of:
• A minimum amount of padding and an alphanumeric character.
• Twelve alphanumeric characters.
We recommend that you use the default settings for the payment message ID sequence generator.
5. Create Integration Business Process on page 1838.
Create an integration business process to add a document delivery step to your integration system.
Example: Integration Process Event for Kyriba Payment Outbound business process definition.
6. Set Up Integration Delivery on page 1839.
Specify the SFTP address on the document delivery step of the business process.
7. Access the Register External OAuth Client task.
Enable the payment initiation integration system with security access to Kyriba. The API automatically
updates Kyriba with changes to the referential data object information and processes any new
payments.
Enter values that Kyriba provides you for these fields:
• OAuth 2.0 Client Name
• OAuth 2.0 Client ID
• OAuth 2.0 Client Secret
• Token Endpoint URL
Security: Security Administration domain in the System functional area.

Result
The integration generates a payment DIS file to upload to the Kyriba SFTP server. Example:
WORKDAYTEST.NC4.IMPORT.3911116.PY_TRANSFER.WD_FORMAT.NULL.391.XML.
The API also updates the referential data in Kyriba based on the integration system configurations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1006

Next Steps
If there's an API error, the integration automatically stops the processing and marks the payment release
event as failed. You can either:
• Edit the integration system and select the Ignore Referential Data Failures for Selected Object
Types attribute to override the errors.
• Fix the data issues.
Once you've made the adjustments, relaunch the integration to continue sending the payment file. See
Launch an Integration on page 23.
Related Information
Concepts
Concept: Workday Bank Connectivity Integration on page 999

Steps: Set Up Bank Connectivity - Import Payment Status Integration

Context
You can create this integration to import payment statuses for the Workday Bank Connectivity payments
that your banks receive through Kyriba. Workday retrieves the payment acknowledgement files that Kyriba
generates in the accepted format. The payment acknowledgements include both Kyriba statuses and bank
statuses. As payments flow through Workday, the import payment status integration provides updates on
the statuses.

Steps
1. Create Integration System on page 1854.
From the New Using Template prompt, select Workday Bank Connectivity - Import Payment Status.
Also, select the Enable All Services check box.
2. (Optional) Select Integration System > Configure Integration Attributes from the related actions
menu of your payment status integration system.
Security: Integration Configure domain in the Integration functional area.
3. Create an integration system user (ISU).
Grant the ISU Get and Put access to these domains:
• Integration Event in the Integration functional area.
• Process: Settlement in the Banking and Settlement functional area.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. Create Integration Business Process on page 1838.
Create an integration business process to add a document retrieval step to your integration system.
Example: Integration Process Event for Kyriba Import Payment Status business process definition.
5. Set Up Integration Retrieval on page 1845.
As you configure the document retrieval step on the business process, specify:
• The SFTP address for the payment acknowledgement file retrieval.
• [customer kyriba code].NC4.*WD_PY* on the File Name/Pattern field.
Workday uses this name pattern to search for all the payment acknowledgement files.
6. Launch an Integration on page 23.

Result
Workday imports your payment acknowledgement files from the file retrieval SFTP location.
See Reference: Import Payment Status Files and Statuses.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1007

Related Information
Concepts
Concept: Workday Bank Connectivity Integration on page 999
Tasks
Steps: Manage Workday Bank Connectivity on page 999

Steps: Set Up Bank Connectivity - Import Bank Statements Integration

Context
You can create this integration to import prior day and intraday bank statement files from your financial
institutions.
The integration supports these statement file formats:
• BAI2
• ISO 20022
• camt.053 for prior day statements
• camt.052 for intraday statements
• MT940 for prior day statements
• MT942 for intraday statements
To import statements in other file formats, contact Kyriba professional services.

Steps
1. Create Integration System on page 1854.
From the New Using Template prompt, select Workday Bank Connectivity - Import Bank Statements.
Also, select the Enable All Services check box.
2. Select Integration System > Configure Integration Attributes from the related actions menu of your
import bank statements integration system.
As you complete the task, consider:
Option Description
Disable File Uniqueness Validation Select to allow bank statement files that contain
the same:
• File creation date.
• File identification number.
• Sender identification.
• Receiver identification.

Security: Integration Configure domain in the Integration functional area.


3. (Optional) Select Integration System > Configure Integration Maps from the related actions menu of
your import bank statements integration system.
As you complete the task, consider:
Option Description
Domestic Bank Code Configure this map to associate an incoming
domestic bank code to the relevant value inside
Workday.
Note: The default value on this integration map
doesn’t have any significance. When you don’t
specify a mapping value, Workday uses the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1008

Option Description
incoming value in the bank statement file as the
default value.
Example: You can configure this map when the
domestic bank code within the Kyriba system
doesn’t match with Workday. A bank might have
modified a bank ID before sending it to Kyriba.

Bank Account Number Configure this map to associate an incoming


bank account number to the relevant value inside
Workday.
Note: The default value on this integration map
doesn’t have any significance. When you don’t
specify a mapping value, Workday uses the
incoming value in the bank statement file as the
default value.
Example: You can configure this map when the
bank account number within the Kyriba system
doesn’t match with Workday. A bank might have
modified a bank account number before sending it
to Kyriba.

Security: Integration Configure domain in the Integration functional area.


4. Create an integration system user (ISU).
Grant the ISU Get and Put access to these domains:
• Integration Event in the Integration functional area.
• Process: Banking in the Banking and Settlement functional area.
• Process: Bank Reconciliation in the Banking and Settlement functional area.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
5. Create Integration Business Process on page 1838.
Create an integration business process to add a document retrieval step to your integration system.
Example: Integration Process Event for Kyriba Import Bank Statements business process definition.
6. Set Up Integration Retrieval on page 1845.
Specify the SFTP address on the document retrieval step of the business process.
7. Launch an Integration on page 23.

Result
Workday imports your bank statement files from the file retrieval SFTP location.
Example:
• BAI2: WORKDAYTEST.NC4.EXPORT.2024060414385280734.STAT.WD_BAI_CAMT.XML
• CAMT: WORKDAYTEST.NC4.EXPORT.2024060414385280734.STAT.WD_CAMT_CAMT.XML
• MT940: WORKDAYTEST.NC4.EXPORT.2024060414385280734.STAT.WD_MT940_CAMT.XML
Related Information
Concepts
Concept: Workday Bank Connectivity Integration on page 999
Tasks
Steps: Manage Workday Bank Connectivity on page 999

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1009

Reference
Reference: Bank Statements Connector XML Schema on page 713

Reference: Import Payment Status Files and Statuses


This table describes the inbound payment acknowledgement integration files and their payment statuses.

Payment Acknowledgement File Description


Payments in Draft The payment acknowledgement file contains payments that are
either:
• Missing key data related to the payment profile.
• Not mapped to a payment profile in Kyriba.
The Acknowledgement Status is Rejected.
Example: Kyriba generates the file in this file format:
WORKDAYTEST.NC4.EXPORT.2024011910303716318.
TRANSFER.WD_PY_DRAFT.DRAFT.XML

Payments in Rejection The payment acknowledgement file contains payments with critical
data issues such as:
• Incorrect FX codes.
• Wrong or missing amounts.
The Acknowledgement Status is Rejected.
Example: Kyriba generates the file in this file
format:WORKDAYTEST.NC4.EXPORT.2024061415482394.
TRANSFER.WD_PY_STATUS.REJ.XML

Payments with Kyriba External The payment acknowledgement file contains payments sent to the
IDs bank. The file also contains external codes that the bank statement
files use to map Kyriba IDs to Workday IDs.
This doesn’t update the Acknowledgement Status.
Example: Kyriba generates the file in this file format:
WORKDAYTEST.NC4.EXPORT.2024061415321407.
TRANSFER.WD_PY_STATUS.EXTERNALCD.XML

Payment Statuses from the Bank The payment acknowledgement file contains payments and their
statuses sent from the bank.
The Acknowledgement Status is either Accepted or Rejected.
Example: Kyriba generates the file in this file
format:WORKDAYTEST.NC4.EXPORT.2024061415332062.
TRANSFER.WD_PY_STATUS.ACK.XML

Related Information
Tasks
Steps: Set Up Bank Connectivity - Import Payment Status Integration on page 1006
Steps: Manage Workday Bank Connectivity on page 999

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| Financials Connectors | 1010

FAQ: Workday Bank Connectivity Integration


How does Kyriba ensure data protection for Kyriba provisions a separate database on
each customer? their multi-tenant platform for each customer. Kyriba
uses encryption at rest and TLS 1.2 for data in
transit.
To support large volume requirements from
Workday, the information exchange between
Workday and Kyriba uses SFTP. Workday creates
the payment files in a mutually agreed (payment
connector DIS) format and delivers them to an
SFTP location that's specific to the customer.
Kyriba also delivers the payment acknowledgement
and bank statement files from the bank to a
customer-specific SFTP location for Workday to
upload.

Does Kyriba support bank accounts that use Kyriba has a limit of 2 intermediary bank accounts
intermediary bank accounts? per bank account.
How do I migrate referential data across You can use Object Transporter 2.0 to migrate
multiple Workday tenants? the Bank Connectivity Reference Data
Mapping configuration package between your
primary implementation tenant and secondary
implementation tenants. The primary tenant is
where you generate and store the most up-to-date
referential data used for testing Workday Bank
Connectivity. You can configure secondary tenants
to use only for sending the test data to Kyriba.
For more information on configuring the migration
and how to access the configuration package, see
Steps: Migrate Packages with Object Transporter.

How does Kyriba process files if an SFTP server The document delivery fails in Workday and notifies
is down? you that the files weren't delivered. Once the SFTP
service is restored, you can then resend the files.
Does Workday retry sending files if Kyriba Workday doesn't retry sending files to avoid
doesn’t respond? accidentally paying someone twice. You can check
for any bank-reported statuses in the payment
acknowledgement files.
Related Information
Concepts
Concept: Workday Bank Connectivity Integration on page 999

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1011

HCM Connectors

Absence Third-Party Calendar Integration

Steps: Set Up Absence Third-Party Calendar Integration

Prerequisites
Set up either a:
• Google account with G Suite Basic, G Suite Enterprise, or G Suite Business.
• Microsoft work account through Azure Active Directory and Microsoft Exchange Online only. Workday
doesn't support hybrid deployments of on-premise Microsoft Exchange Server and Microsoft Exchange
Online when setting up the Workday Absence Third-Party Calendar integration with Microsoft Outlook.

Context
You can use the Absence Third-Party Calendar integration to send approved time off events from Workday
to your corporate calendars. When you run the integration, Workday automatically creates, updates,
and removes approved time off entries, corrections, and cancellations in Google Calendar and Microsoft
Outlook.
Note: Workday only processes time off entries when these business process events have a status of
Successfully Completed:
• Correct Time Off
• Request Absence
• Request Time Off

Steps
1. Configure the Absence Third-Party Calendar Integration on page 1012.
2. Register your client for Google Calendar, Microsoft Outlook, or both, and configure permissions for the
Absence Third-Party Calendar integration web API.
See:
• Steps: Register Your Client-Side Service Account for Google on page 1014
• Steps: Register Your Client-Side Application for Microsoft Outlook on page 1016
3. Create a credential store to authorize clients when connecting to third-party calendar applications.
See:
• Steps: Create an External Client CredStore for Google Calendar on page 1016
• Create an External Client CredStore for Microsoft Outlook on page 1019
4. Access the Create Integration System task.
Select Absence Third-Party Calendar from the New Using Template prompt.
As you configure the integration services, enable either of these integrations, or both:
• Google Calendar Integration
• Microsoft Calendar Integration
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1012

5. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
The Enabled integration attribute is required for launch. You need 2 rows of values: 1 for enabled and 1
for disabled. Examples:
• To enable the integration in all environments except for Production, add 2 rows with this
configuration:

Value Restricted to Environment


Clear the check box. Production
Select the check box. Leave this field empty.
• To enable the integration in Production only, add 2 rows with this configuration:

Value Restricted to Environment


Select the check box. Production
Clear the check box. Leave this field empty.

Security: These domains in the Integration functional area:


• Integration Build
• Integration Configure
6. Create an Integration System User (ISU) and grant the ISU Get and Put access on the Integration
Event domain in the Integration functional area to enable event creation and status updates.
See Steps: Grant Integration or External Endpoint Access to Workday.
7. Launch or schedule the Absence Third-Party Calendar integration.
You don't need to select an organization as you already selected it in Step 1. If you select an
organization on the Launch / Schedule Integration task, Workday ignores the value, and uses the
organization that you select on the Configure Absence Third-Party Calendar Integration task.
See Launch an Integration on page 23.
Related Information
Tasks
Create Integration System on page 1854
Reference
2021R2 What’s New Post: Absence Third-Party Calendar Integration

Configure the Absence Third-Party Calendar Integration

Prerequisites
Create time offs and absence tables to include in the integration.
Security: Set Up: Time Off domain in the Time Off and Leave functional area.

Context
You can configure the Absence Third-Party Calendar integration for your organization to enable Workday
to send approved time off events to your Google or Microsoft Outlook calendars.

Steps
1. Access the Configure Absence Third-Party Calendar Integration task.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1013

2. As you complete the task, consider:


Option Description
Time Offs Select the time offs or absence tables to include
in the integration processing.
Calendar Display Select an option to display calendar events in
external calendars for employees, managers, or
both.
Employees and managers can turn off the display
on their calendars at any time by opting out of
Absence Third-Party Calendar Integration events
on the Change Preferences task. This option is
available regardless of whether you've configured
the integration, so employees can opt out before
Workday runs the integration for the first time.

Organizations Select the organizations to include in the


integration.
Select the Include Subordinate Organizations
check box to ensure that both managers and
employees receive calendar events.
Employees and managers must be members of
an organization to both receive calendar events.
Example: Org X, Org Y, and Org Z are
supervisory organizations in Global Modern
Services. Org Y and Org Z are subordinate
organizations to Org X. The organizations have
these manager role assignments:
• Ann is the manager for Org X.
• Barbara is the manager for Org Y.
• Colin is the manager for Org Z.
John is a member of Org Y. He has an approved
time off entry for a time off that you want to
include in the integration.
When you select Org Y and Org Z as the
organizations, Workday sends the calendar event
to John’s third-party calendar, but not to the
Barbara's because Barbara is a member of Org X,
not Org Y.
To send the calendar event to both John and
Barbara’s third-party calendars, select:
• Org X from the Organizations prompt.
• The Include Subordinate Organizations
check box.

Calendar Event You can use the Workday-delivered subject and


body for the calendar event by leaving the default
text, or select the Override Event Text check
box to create custom text. Workday automatically
translates the default text but not custom text.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1014

Option Description
You can tag workers using their preferred name in
custom text.
Although you can copy and paste formatted text
into the Subject and Body fields, Workday sends
the text to your third-party calendars as plain text.

3. Review and click OK to apply your changes.


After you run the integration once, you can return to this task and make additional configuration
changes. In the Review and Apply section, you can reset the integration by selecting the Reset
Integration Processing by 30 Days check box under Options.
When you select this check box, Workday processes:
• Time off requests within the last 30 days and all future time off entries. Workday skips all time
off events stored for retry. When not processed within the 2-hour integration processing limit,
Workday stores time off events without errors for retry until processing is complete. For time offs with
processing errors, such as an HTTP 500 response from Google or Microsoft, Workday performs up
to 3 retries before logging a synchronization failure.
• Any configuration changes. Example: Rachel requests time off in January for February. Workday
runs the integration, but you didn't initially select the time off type she requested for processing.
If you later select the time off for processing and reset the integration, Workday detects the
configuration change on the next integration run.
4. (Optional) Select the Advanced Logging Enabled check box to generate an additional advanced
logging file called sync_detail_log.csv for debugging purposes only.
Note: Workday recommends that you only enable this option when:
• You're trying to set up the integration for the first time and aren't able to find the approved time off
entries in either Microsoft Outlook or Google.
• Your current integration stops working suddenly.
You can enable advanced logging temporarily to help troubleshoot integration errors. This option:
• Helps your IT department understand core issues and assist in resolving integration errors.
• Doesn't impact the original sync log file or stop the integration from processing.
• Logs the first 50,000 records only, except for the Google integration, which stops processing
entries after 10,000 records. Workday adds the remaining records to the retry queue where
they're picked up in the next scheduled run. For Google, this means that the advanced logging file
(sync_detail_log.csv) only contains 10,000 processed entries.

Result
Workday applies your changes to the next integration run.
When users enter time off in Absence without specifying start and end times, calendar events display
differently in each third-party calendar application. Examples:
• Google Calendar displays the event as a single time block. The event details indicate that the event is
for the entire calendar day from 12:00 AM to 11:59 PM. The rest of the day displays as available.
• Microsoft Outlook displays the event as a single time block but the rest of the day displays as busy.

Steps: Register Your Client-Side Service Account for Google

Prerequisites
Set up a Google account with G Suite Basic, G Suite Enterprise, or G Suite Business.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1015

Context
Workday needs access to a Google service account with specific permissions to enable the Absence
Third-Party Calendar integration to make authorized web API calls to Google Calendar endpoints.

Steps
1. Sign in to the Google Cloud Platform.
2. Create a service account or use an existing one.
See Creating and managing service accounts.
a) Enter a project name that you can easily recognize as the client for the Absence Third-Party
Calendar integration. Example: workday-calendar-integration.
b) Select an organization and location.
c) Create a service account for the project.
Use an appropriate first and last name for the account to indicate the origin of the integration events,
in the form firstname.lastname@<your_company_domain>.com. Example: If you enter Absence
Calendar for the first name and last name, when Workday creates time off events, Google Calendar
displays Created by: Absence Calendar.
d) Manage permissions.
• Give the service account editor permissions.
• Ensure that the admin account has permissions to the service account.
• Ensure that the service account for the integration has the Super Admin role with domain-wide
access to enable the integration to perform read and write actions on users’ calendars. The
Super Admin is the only role that Google provides that can edit all users’ calendars without user-
level configuration. You can't create a custom role.
Note: After you assign the Super Admin role to a user, it can take up to 24 hours for the
calendar privileges to be available.
See Pre-built administrator roles.
3. Create a new Google-managed service account key.
See Creating and managing service account keys.
Google generates and automatically downloads a JSON file with the service account key details. Save
this file for use later when you create the external client cred store.
4. Enable system-wide delegation for the domain.
See Delegating domain-wide authority to the service account.
a) Sign in to the Google Admin console as an administrator.
b) Add a new API client and enter these details:

Field Value
Client ID Copy the client ID value from the JSON file.
OAuth scopes (comma-delimited) Enter these permission values:
https://www.googleapis.com/auth/
calendar.events,
https://www.googleapis.com/auth/
calendar

5. Enable access to the Google Calendar API.


a) Navigate to the API & Services Library in the Google Cloud Platform console.
b) Search for and enable Google Calendar.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1016

Steps: Register Your Client-Side Application for Microsoft Outlook

Prerequisites
Set up administrator access to an Azure Active Directory (AD) tenant.

Context
When you register your client application for the Workday Absence Third-Party Calendar integration with
Microsoft Outlook, the Microsoft identity platform can provide authentication and authorization services for
the application and its users.
You can configure permissions to enable the Absence Third-Party Calendar integration web API to access
Microsoft Graph and:
• Read user profiles for all users in your organization.
• Read and write calendars in all mailboxes.

Steps
1. Register the application in the Azure portal and add credentials:
• Enter a display name that you can easily recognize as the client for the Absence Third-Party
Calendar integration. Example: Absence TPCI.
• For Supported account types, select Accounts in this organizational directory only and your Azure
AD tenant.
• You'll need the Application (client) ID value later when you create the external client cred store.
• Add a client secret. Select an expiration option and record the secret value for later use.
See Quickstart: Register an application with the Microsoft identity platform.
2. Add permissions for the application.
Enable the Absence Third-Party Calendar integration web API to access Microsoft Graph:
• Expand the Calendars menu and select Calendars.Read and Calendars.ReadWrite.
• Grant admin consent for your client application.
See Quickstart: Configure a client application to access a web API.
Related Information
Reference
Get an Azure AD tenant

Steps: Create an External Client CredStore for Google Calendar

Prerequisites
Register a Google service account for the Absence Third-Party Calendar integration.
Security: Security Administration domain in the System functional area.

Context
Workday enables you to store the OAuth2 access credentials from the JSON file that you downloaded
when registering your service account for Google. Workday uses these credentials to connect to the
external Google Calendar domain.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1017

Steps
1. Access the Create External Client CredStore task.
As you complete the task, consider:
Option Description
App ID, External Reference ID Enter a value to distinguish these credentials for
your Google service account. The value is for
easy identification only and doesn't need to match
an existing identifier for your application. You
can use the same value for both fields. Example:
Absence-TPCI-Google.
Auth Scheme for External Client Select OAuth 2.0 Jwt Bearer.
Client ID Enter the client_id value from the JSON file.
Subject Enter the email of the user with the Super Admin
role with access to the service account.
Issuer Enter the client_email value from the JSON file.
Audience Enter the token_uri value from the JSON file.
Jwt Bearer Signature Algorithm Select RS256.
Jwt Header Kid Enter the private_key_id value from the JSON file.
Token Endpoint Enter any URL in this mandatory field. Workday
doesn't use this value for the integration, however,
to enable Workday to save the credential store,
you need to enter a URL.
2. Create an X.509 private key pair.
For x509 Private Key Pair, select either:
• Create 3rd Party X509 Key Pair, to create a Google-generated certificate, and store the key pair
values from the JSON file in Workday.
See Create a Third-Party X.509 Key Pair for Google Calendar on page 1017.
• Create x509 Private Key Pair, to generate a Workday certificate, and upload it to Google.
See Create an X.509 Private Key Pair for Google Calendar on page 1018.
Related Information
Concepts
Concept: X.509 Certificates in Workday
Tasks
Steps: Register Your Client-Side Service Account for Google on page 1014
Create a Third-Party X.509 Key Pair

Create a Third-Party X.509 Key Pair for Google Calendar

Prerequisites
Register a Google service account for the Absence Third-Party Calendar integration.

Context
Save X.509 key pairs supplied by Google to Workday to enable the Absence Third-Party Calendar
integration to connect to the external Google Calendar domain.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1018

Steps
1. Access the Create 3rd Party X509 Key Pair task.
2. As you complete the task, consider:
Option Description
Certificate Text Navigate to the URL specified as the
client_x509_cert_url value in the JSON file.
Copy the certificate text that corresponds to the
private_key_id in your JSON file. The text must
start with -----BEGIN CERTIFICATE----- and end
with -----END CERTIFICATE-----.
Paste the certificate text into a text editor and
format to replace every newline (\n) with newline
plus carriage return (\r\n).
Copy and paste the formatted text into this field.

Private Key Navigate to the private_key value in the JSON file


that corresponds to the private_key_id value.
Copy the private key text starting with -----BEGIN
PRIVATE KEY and ending with END PRIVATE
KEY-----.
Paste the private key text into a text editor and
format, replacing every newline (\n) with newline
plus carriage return (\r\n).
Copy and paste the formatted text into this field.

Related Information
Tasks
Create a Third-Party X.509 Key Pair

Create an X.509 Private Key Pair for Google Calendar

Prerequisites
Register a Google service account for the Absence Third-Party Calendar integration.

Context
Generate a Workday certificate to enable the Absence Third-Party Calendar integration to connect to the
external Google Calendar domain.

Steps
1. Access the Create x509 Private Key Pair task generate a public key and corresponding private key.
2. Copy the certificate text from the Public Key field.
3. Navigate to the Google Cloud Console.
4. Select the services accounts for your project and the email associated with the JSON file.
5. Navigate to the keys section and select to add and upload an existing key.
6. Paste the certificate text that you copied from Workday and upload.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1019

Related Information
Tasks
Create an X.509 Private Key Pair

Create an External Client CredStore for Microsoft Outlook

Prerequisites
Register a client for Microsoft Outlook for the Absence Third-Party Calendar integration.
Security: Security Administration domain in the System functional area.

Context
Workday enables you to store OAuth2 access credentials that you recorded when registering your client-
side application for Microsoft Outlook.

Steps
1. Access the Create External Client CredStore task.
2. As you complete the task, consider:
Option Description
App ID, External Reference ID Enter a value to distinguish these credentials
for the application that you registered in the
Microsoft Azure AD portal. This value is for easy
identification only and doesn't need to match
an existing identifier for your application. You
can use the same value for both fields, but the
External Reference ID value must be unique.
Example: Absence-TPCI-Microsoft-Outlook.
Auth Scheme for External Client Select OAuth 2.0 Client Credential.
Client ID Enter the client ID that you recorded.
Client Secret Enter the client secret.
Token Endpoint Enter any URL in this mandatory field. Workday
doesn't use this value for the integration, however,
to enable Workday to save the credential store,
you need to enter a URL.

Related Information
Tasks
Steps: Register Your Client-Side Application for Microsoft Outlook on page 1016

Reference: Absence Third-Party Calendar Integration Output Files


In addition to processing time off entries in Google Calendar and Microsoft Outlook, the Absence Third-
Party Calendar integration generates several informational files associated with the integration events.
Workday retains these files for debugging and troubleshooting purposes.

File Description
Absence Third-Party Calendar Integration Summarizes time off entry processing results.
Summary

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1020

File Description
Retry Time Off Events Partition Store Includes time off entries to retry in the next
integration run.
Retry Time Off Events Partition Tracker Tracks time off entry retries for the next integration
run.
Synchronization Failures Log Logs entries that failed to synchronize. Workday
doesn't store these entries for retry.

FAQ: Absence Third-Party Calendar Integration


• Does the Absence Third-Party Calendar integration support Microsoft national cloud services? on page
1020
• Do I need to specify a redirect URI when registering my app for Microsoft Azure? on page 1020
• Can you configure multiple email domains? on page 1020
• Do I need a Google service account user with the Super Admin role to run the integration with Google
Calendar? on page 1021
• What determines the Created by value on Google Calendar events? on page 1021
• What determines the time zone for the calendar events? on page 1021
• Why is the time zone Coordinated Universal Time (UTC) or Pacific Time - Los Angeles when I edit an
automatically generated event? on page 1021
• How do multiple partial days off display for time offs that don't use time off start and end times? on page
1022
• What happens to a worker’s events in their manager’s calendar after a job change? on page 1022
• If workers opt out of Absence Third-Party Calendar Integration events, will it stop both their own and
their managers' calendars from updating? on page 1022
• If managers opt out, will they also stop getting their direct reports' time off entries? on page 1022
• If workers opt out of Absence Third-Party Calendar Integration events, does that opt them out of all
calendar events such as scheduled interviews? on page 1022
• Can you rescind a time off from the third-party calendar? on page 1022
• If I change organizations in the integration configuration, what happens to events for workers in the
removed organizations? on page 1022
• What is the recommended schedule frequency for the Absence Third-Party Calendar integration? on
page 1023
• How far back and forward does the integration process time offs? on page 1023
• Does the Absence Third-Party Calendar integration support leave of absence? on page 1023

Does the Absence Third-Party Calendar No, the integration supports the Microsoft Graph
integration support Microsoft national cloud global service but not national cloud service
services? endpoints such as Microsoft Cloud for US
Government.

Do I need to specify a redirect URI when No, this is an optional setting for apps that require
registering my app for Microsoft Azure? individual users to authenticate. Our integration
uses an admin account to update the user's
calendars using the Microsoft Graph API.
Can you configure multiple email domains? If your organization has more than 1 corporate
email domain, you can enter multiple domains as a
comma-separated list for the Email Domains value
when you configure integration attributes for the
integration system.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1021

The integration supports multiple domains as


long as all the domains are managed in the same
Google or Microsoft tenant.

Do I need a Google service account user with Yes, you need a service account user with the
the Super Admin role to run the integration with Super Admin role with domain-wide access to
Google Calendar? enable the integration to perform read and write
actions on users’ calendars. The Super Admin is
the only role that Google provides that can edit all
users’ calendars without user-level configuration.
You can't create a custom role.
Workday uses the values that you enter in these
fields on the Create External Client CredStore
task:
• Subject: The email of the user with the Super
Admin role with access to the service account.
• Issuer: The client_email value from the JSON
file that you downloaded for the service account.
Although the Absence Third-Party Calendar
integration uses the service account user with
the Super Admin role, Workday doesn't store the
credentials. The integration only has authorization
to perform read and write actions using the
Calendar API.

What determines the Created by value on The Created by value is based on the email that
Google Calendar events? you enter in the Subject field on the Create
External Client CredStore task. Example: If you
would like Created by to display Absence Calendar,
you could create an Administrator account in the
Google Admin console with this name, and set the
email address as the subject in your credStore.
Example: absence.calendar@mycompany.com.
What determines the time zone for the calendar When workers request time off, the effective date of
events? the entries is in their time zone as set in Workday. If
they don't have a preferred time zone set, Workday
uses the tenant time zone. If you haven't configured
a time zone for your tenant, Workday uses Pacific
Standard Time (PST).
If a worker's manager has a different preferred time
zone set, Workday converts the date and time of
the calendar entry to the manager's time zone for
the manager view.
If users want their third-party calendar application to
match the Workday time zone, they need to set the
time zone in their calendar application accordingly.
Why is the time zone Coordinated Universal The Absence Third-Party Calendar integration
Time (UTC) or Pacific Time - Los Angeles when I standardizes all time off entries to Pacific Standard
edit an automatically generated event? Time (PST) before passing them to Microsoft
Outlook or Google Calendar. When you hover
over an event for a time off entry in Outlook or
Google Calendar, the application displays the
times correctly in your time zone, depending on
its time zone setting. When you edit an event, the

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1022

application displays the start and end times in UTC


or Pacific Time - Los Angeles. These are the correct
times for the event in the time zone as it's stored on
the Microsoft or Google server. Editing the event
without changing the times or time zone maintains
the time off at the correct time in your calendar.
How do multiple partial days off display for time When workers don't enter start and end times on
offs that don't use time off start and end times? time off requests, a half day displays as a full day
in third-party calendar applications. If there are
multiple partial day requests on the same day, the
third-party calendar application displays multiple
full day events for the same day. We recommend
that you use start and end times to enable the
application accurately reflect the worker's time off
and avoid multiple full day events.
What happens to a worker’s events in their Approved time offs that Workday processed before
manager’s calendar after a job change? the worker's job change remain in their former
manager's calendar even if their effective date is
after their job change.
If workers opt out of Absence Third-Party If workers opt out, it will only stop their calendars
Calendar Integration events, will it stop both from updating. Their managers will still see their
their own and their managers' calendars from direct reports' time off requests in their calendars,
updating? provided Enable managers to see their direct
reports' time off events is selected on the
Configure Absence Third-Party Calendar
Integration task.
If managers opt out, will they also stop getting If they opt out, they won't see their direct reports' or
their direct reports' time off entries? their own time off events in their calendars.
If workers opt out of Absence Third-Party The Opt Out of Absence Third-Party Calendar
Calendar Integration events, does that opt them Integration Events preference only prevents
out of all calendar events such as scheduled Workday adding Absence time off requests to
interviews? their external calendars. Other Workday calendar
integrations are unaffected by this preference.
Can you rescind a time off from the third-party Workday doesn't enable you to rescind time off
calendar? entries that you inadvertently uploaded but supports
corrections. Workday removes time off entries
corrected to zero from third-party calendars. You
can use the Adjust Time Off Enterprise Interface
Builder (EIB) to correct entries unless the entries
are in-progress. In that case, you can use the Mass
Cancel business process.
If I change organizations in the integration If you remove an organization on the Configure
configuration, what happens to events for Absence Third-Party Calendar Integration task,
workers in the removed organizations? the integration no longer processes the time offs
for workers in the organization. Workday doesn't
remove previously processed time offs from the
third-party calendar even when you select the
Reset Integration Processing by 30 Days check
box. Worker's will need to manually remove these
events from their calendars.
During implementation, Workday recommends
starting with a small pilot organization to test and

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1023

confirm that events display as expected in workers'


and managers' calendars. For multinational
organizations, you should also test translations
before rolling out to a wider organization.

What is the recommended schedule frequency We recommend that you schedule the Absence
for the Absence Third-Party Calendar Third-Party Calendar integration to run every
integration? 3 hours to avoid conflicts and keep third-party
calendars current with time off requests in Workday.
Only 1 instance of the integration can run at any
time. If the integration takes more than 2 hours to
process and is still running when Workday attempts
a subsequent run, the integration will fail. Workday
will attempt to run the integration again in a further 3
hours.
Running the integration too frequently might cause
several runs to fail, resulting in it taking noticeably
longer for events to display in the third-party
calendar.

How far back and forward does the integration The integration processes all approved time offs
process time offs? entered or corrected since the last run date, with an
effective date either:
• Within the previous 30 days.
• In the future.
Period schedules on time off plans limit how
far in the future workers can enter time off.
We recommend that you build out your period
schedules 2 years in the future.
Does the Absence Third-Party Calendar The integration doesn't currently support leave of
integration support leave of absence? absence calendar-event processing.
Related Information
Tasks
Steps: Register Your Client-Side Service Account for Google on page 1014
Steps: Create an External Client CredStore for Google Canlendar on page 1016
Reference
Delegate domain-wide authority to your service account
Pre-built administrator roles

Troubleshooting: Absence Third-Party Calendar Integration


This topic provides strategies for diagnosing and resolving these Absence Third-Party Calendar integration
issues:
• Integration displays errors when launched or fails to launch. on page 1023
• Approved time offs in Workday in the last 30 days don't display in workers’ third-party calendars. on
page 1025
• Microsoft Azure Service exceeded the maximum retry attempts to retrieve the refresh token. on page
1025
• Managers can't identify which calendar events correspond to specific workers. on page 1026
• Time off for a manager's direct reports doesn't display in their third-party calendar. on page 1026

Integration displays errors when launched or fails to launch.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1024

Cause: Synchronization failures occurred with the Google Calendar integration service.
Solution:

Steps
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure
1. Access the Process Monitor report, and select the Integration process type.
2. As a related action on the Absence Third-Party Calendar integration request, select Background
Process > View Details to view detailed information about the integration.
An integration status of Completed indicates that Workday was able to access the refresh token and
send the request.
3. Select the Output Files tab and download and review synchronization failures in these files:
• Absence Third-Party Calendar Integration Summary: Check whether there are any entries stored for
retry.
• Retry Time Off Events Partition Store: You might find HTTP responses with a 403 error code.
• Synchronization Failures Log: You might find HTTP responses with a 400 or 401 error codes.
To identify the reason for the errors, see the Google Calendar API.
4. On the Integration Details tab, click Retrieve Log Files.
5. Select the Confirm check box.
6. Download the server log file.
Check for error responses from Google such as 403 error codes in HTTP retry exceptions. Example:
You might need to use the Google Developers Console to activate the API for your project.
See Authorizing Requests to the Google Calendar API.
If you fix the issues, Workday reprocesses the time off entries stored for retry on the next integration
run.
If you don’t fix the issues, the integration will fail. After 3 retries, Workday stores those entries in the
Synchronization Failure log and won’t attempt to retry processing the entries.
Cause: The integration service for Google Calendar failed to authenticate. It can't retrieve the refresh
token for the client because the certificate has expired.
Solution:

Steps
1. Sign in to the Google Cloud Platform
2. Check the expiry date on the key for the integration client. If the key has expired, add a new key with an
expiry date later than today.
See Creating and managing service account keys.
3. Access the Edit External Client CredStore task.
Replace the expired x509 Private Key Pair with the service-account key details from the latest JSON
file.
Security: Security Administration domain in the System functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1025

Cause: The integration service for Microsoft Outlook failed to authenticate. It can't retrieve the refresh
token for the client because the client secret has expired.
Solution:

Steps
1. Sign in to the Azure portal.
Check the expiry date on the client secret for the integration client. If the secret has expired, add a new
one.
See Quickstart: Register an application with the Microsoft identity platform.
2. Access the Edit External Client CredStore.
Replace the expired client secret with the new one.
Security: Security Administration domain in the System functional area.

Approved time offs in Workday in the last 30 days don't display in workers’ third-party calendars.
Cause: You configured the email domain incorrectly for the Google Calendar or Microsoft Outlook
integration service.
Solution:

Steps
1. If you need to correct the email domain, access the View Integration System report.
Select the Absence Third-Party Calendar integration system. As a related action, select Integration
System > Configure Integration Attributes and enter the Email Domains integration attribute value.
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure
2. Rerun the Absence Third-Party Calendar integration.
Before resetting the integration, to avoid leaving entries that were corrected to zero in a worker's
calendar, make sure that Workday processes corrected entries since the last run. Example: A worker
requested a time off and then corrected it to zero since the last run. After resetting the last run date,
Workday won't reprocess the request, which results in the original entry remaining in the calendar.
See Launch an Integration on page 23.
3. Access the Configure Absence Third-Party Calendar Integration task.
Reset the integration to reprocess previously processed time offs and all previously skipped time offs.
Otherwise, Workday will only process new events using the correct configuration.
Security: Set Up: Time Off domain in the Time Off and Leave functional area.
4. In the Review and Apply section, select the Reset Integration Processing by 30 Days check box
and click OK.

Microsoft Azure Service exceeded the maximum retry attempts to retrieve the refresh token.
Cause: Workday received a 401 error, which might be because:
• The token has expired or is invalid.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1026

• You're using a delegated access token granted to a personal Microsoft account. If this is the case,
the integration is able to get a new token but the token is invalid when the integration tries to make a
request.
Solution: For more information, see Resolve Microsoft Graph authorization errors.
Solution: Workday recommends that you use a service account rather than a personal Microsoft account
for the integration.

Managers can't identify which calendar events correspond to specific workers.


Cause: The calendar event message doesn't display the worker's name.
Solution:

Steps
Security: Set Up: Time Off domain in the Time Off and Leave functional area.
1. Access the Configure Absence Third-Party Calendar Integration task.
2. Select the Calendar Event tab.
Tag the worker using the Worker's Preferred Name report field in the subject or body of the calendar
event to enable managers to identify which time off belongs to each of their direct reports.

Time off for a manager's direct reports doesn't display in their third-party calendar.
Cause: The manager has a manager role for the configured organization but isn't a member.
Solution:

Steps
Security: Set Up: Time Off domain in the Time Off and Leave functional area.
1. Access the Configure Absence Third-Party Calendar Integration task.
2. Select the Calendar Display tab.
Ensure that you select the Enable managers to see their direct reports' time off events check box.
3. Select the Organizations tab.
The integration only processes managers and workers that are members of the organizations that you
configure for the integration. Ensure that you select both the manager's and worker's organizations.
When a manager and worker are members of different organizations but you only select the worker's
organization, the manager won't receive their time off events for the worker, even when you also select
the Enable managers to see their direct reports' time off events check box.
Related Information
Tasks
Create an External Client CredStore for Microsoft Outlook on page 1019
Steps: Create an External Client CredStore for Google Calendar on page 1016
Reference
Quickstart: Register an application with the Microsoft identity platform
Creating and managing service account keys

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1027

Account Provisioning

Steps: Set Up Account Provisioning Integration

Prerequisites
Before implementing this integration, determine how you want to launch the integration. Configuration
requirements vary depending on which method you select.

Context
You can create an integration based on the Account Provisioning template that sends worker profiles and
provisioning group membership data to an external endpoint.

Steps
1. Create Integration System on page 1854
Enter Account Provisioning at the New using Template prompt.
2. (Optional) In the Configure Integration Services task, enable the Transaction Log Service.
This service enables your integration system to subscribe to events that take place in Workday. Your
integration reports only changed fields for workers, rather than reporting all fields.
If disabled, your integration first extracts all data for eligible records, then evaluates the data for
changes. Using this option can adversely affect performance.
Security: Integration Build in the Integration functional area.
3. (Transaction Log Service) Select Integration System > Configure Integration Transaction Log as a
related action on your integration and select the Workday transactions for monitoring.
Workday recommends that you subscribe only to those business processes that can drive changes to
your provisioning groups:
• Add Additional Job
• Contract Contingent Worker
• Hire
• Start International Assignment
• End Additional Job
• End Contingent Worker
• End International Assignment
• Termination
Security: Integration Build in the Integration functional area.
4. Set Up Account Provisioning Integration Fields on page 1028.
5. (Optional) Set Up Integration Delivery on page 1839.
If you're not launching the integration by web service, specify how the integration system delivers
integration output files to your external endpoint.
6. (Optional) Launch an Integration on page 23.
If you want to launch the integration by schedule within Workday, schedule how often you want
Workday to launch the integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1028

7. Create an Integration System User (ISU) and grant the ISU access to these domains:
• External Account Provisioning
• Worker Data: All Positions
• Worker Data: Business Title on Worker Profile
• Worker Data: Current Staffing Information
• Worker Data: Public Contact Information
• Worker Data: Public Worker Reports
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
8. (Optional) Create Integration Notifications on page 30.

Set Up Account Provisioning Integration Fields

Prerequisites
Security: Integration Build domain in the Integration functional area.

Context
Map internal Workday values to external values used by your account provisioning service.
This procedure uses the Configure Integration Field Overrides task. However, in this procedure
you provide automatically populated values; you don’t override existing values. If you don’t select the
corresponding report field for each external value, your Account Provisioning integration can’t run
successfully.

Steps
1. As a related action on your Account Provisioning integration, select Integration System > Configure
Integration Field Overrides.
2. In the Define Eligibility document section, select Has Provisioning Group Assignments from the
Override External Field prompt.
3. In the External Account Provisioning Fields document section, select (or create) the specified report
field from the Override External Field prompt for each external field value.
Option Description
Worker ID Employee ID
Legal First Name Legal Name - First Name
Legal Middle Name Legal Name - Middle Name
Legal Last Name Legal Name - Last Name
Primary Work Email Address Email - Primary Work
Primary Work Phone Number Phone - Primary Work
Primary Work Messenger ID Work IM
Primary Work Messenger Type Create a calculated field based on the Work IM
business object that returns the Messenger Type.
There’s no corresponding report field in Workday
that returns this value.

Employee ID Employee ID
Position Position

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1029

Option Description
Position ID Position ID
Business Title Business Title
Location Location
Manager ID Manager ID
Hire Date Hire Date
First Day of Work First Day of Work
Termination Date Termination Date
Active Status Active Status

Concept: Account Provisioning Integration


Workday supports integration with external account provisioning applications and services using the
Simple Cloud Identity Management (SCIM) format. The Account Provisioning integration template enables
you automatically to add and remove hired and terminated workers from applications and services such as
Active Directory and Salesforce Chatter.
The Account Provisioning integration template enables you to create an integration with any account
provisioning endpoint. The account provisioning endpoint opens and closes accounts for workers on
downstream services, such as Active Directory or Google Apps. The account provisioning endpoint relies
on Workday to define which workers have access to a given downstream service. When triggered, the
Account Provisioning integration generates an integration output document in the form of a SCIM file.
SCIM is an industry-standard format for defining membership in provisioning groups.

Integration Launch Options


You can use any of these methods to launch the Account Provisioning integration:
• Scheduled in Workday. You schedule the integration to launch at a preset interval.
• Trigger by event. Configure the Transaction Log Service to subscribe to Workday events that cause
reportable changes to your Provisioning Groups.
• Scheduled in external account provisioning endpoint. You configure a schedule in your external
endpoint. You then configure your external endpoint to launch the Account Provisioning integration
using the Launch Integration Event web service operation. After launch, your external endpoint must
check the integration event status using the Get Integration Events web service operation. When
Get Integration Events returns a status of Complete, it includes a reference to the integration output
document. You can then retrieve the integration output document from My Reports.
Related Information
Concepts
Concept: Workday Connectors on page 500
Tasks
Steps: Set Up Account Provisioning Groups

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1030

Account Provisioning Connector

Steps: Set Up Account Provisioning Connector Integration

Context
You can create an account provisioning integration that sends these types of data to an external account
provisioning endpoint:
• Worker profiles.
• Provisioning group membership.

Steps
1. Create Integration System on page 1854.
Enter the applicable template at the New using Template prompt:
•Account Provisioning Connector: Worker
•(Optional) Account Provisioning Connector: Group. Use this template only if you already use
Account Provisioning Groups and have worker accounts that are part of those groups.
2. (Optional) In the Configure Integration Services task, enable integration services:

Integration Service Template Description


Filename Sequence Generator Both Enable if you want Workday
to apply a custom-formatted,
unique filename to each
integration file.
Define Eligibility Account Provisioning Connector: Enables you to configure an
Worker Integration Field Override to
define which workers Workday
includes in the integration
output.

Security: Integration Build in the Integration functional area.


3. As a related action on your Connector, select Integration System > Configure Integration Attributes
and enter attributes required by the integration template:
Option Description
Output Document Tags Applies selected document tags to integration
output documents generated by the integration.
Document Retention Policy Enter the number of days that Workday should
preserve output files.
4. Set Up Integration Sequence Generators on page 1856.
5. Set Up Integration Delivery on page 1839.
6. Steps: Set Up Document Transformation Connector on page 571.
7. Launch an Integration on page 23.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1031

8. Create an Integration System User (ISU) and grant the ISU access to these domains:
• External Account Provisioning (required for Account Provisioning Connector: Group only)
• Worker Data: Current Staffing Information (required for Account Provisioning Connector: Worker
only)
• Worker Data: Public Worker Reports (required for Account Provisioning Connector: Worker only)
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
9. (Optional) Create Integration Notifications on page 30.

Concept: Account Provisioning Connector


With the Account Provisioning Connector, you can extract worker account related definitions and send it to
an endpoint. Using the Workday Web Services API, the Account Provisioning Connector captures changes
to account data. The integration then configures an output file for delivery to an external endpoint.
The Account Provisioning Connector generates account data integration output files that you can transform
for multiple downstream endpoints.
Depending on your external endpoint, you might need to transform the file into the required format using 1
of these options:
• Transformation step on the business process. You configure the business process definition for the
integration to transform the Connector output file into the format required.
• Workday Studio integration. You configure the business process definition of the integration to launch
a Workday Studio integration. The Studio integration transforms the Connector output file into the
required format.
• Other third-party tool. You configure a third-party tool to transform the Connector output file.
The Account Provisioning Connector is an integration template. When launched, the integration collects
a snapshot of the data and creates an output file in XML format. The Account Provisioning Connector
integration creates the output files in a Workday-defined XML format. You can configure this output for
delivery or further transformation.

Launch/Schedule Options for Account Provisioning Connector


Workday provides these launch schedule options for the Account Provisioning Connector integration:
• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member or have an organization role.
• All Organizations by Type displays if the Integration Process Event for this integration has no
associated organization. You can select any organization and subordinate organization of which
you’re a member or have an organization role.
• Run Frequency. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration collects all qualifying changes based on the launch parameters. You
can specify Run Now to launch the integration manually. Workday prompts you to enter the launch
parameters.
For the launch/schedule option for the Account Provisioning Connector: Group, enter these launch
parameters:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1032

Parameter Description
Provisioning Groups Extracts records for the specified Provisioning
Groups.
As Of Entry Moment Extracts records that are current as of the specified
As Of Entry Moment.

For the launch/schedule option for the Account Provisioning Connector: Worker, you enter these launch
parameters:

Parameter Description
Workers Extracts records for the specified Workers.
As Of Entry Moment, Effective Date Extracts records that are current as of the specified
As Of Entry Moment and Effective Date
parameters.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• Data Changes Audit file, which is a readable version of the integration output file.
• Diagnostic Audit file, which helps you troubleshoot integration errors.
• Schema XSD file, which defines the content and structure of the output file. It includes only those fields
that you’ve enabled for your integration endpoint. Workday generates this file every time the integration
runs; the file uses your integration configuration at the time the integration ran. You can only generate
this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because actual data is included in the Data Change Audit file, you might need to secure this file
separately. Example: if administrators can’t have access to the data.

Affordable Care Act (ACA) Connector

Steps: Set Up ACA Information Returns Connector

Prerequisites
• Ensure you created all correct 1095-C and 1094-C data.
• Security: Integration Build domain in the Integration functional area.

Context
You can create and configure an ACA Information Returns (AIR) Connector integration that uses the IRS
AIR system to:
• Send Form 1094-C and Form 1095-C data to the IRS.
• Receive status messages from the IRS.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1033

Steps
1. Access the Create Integration System task and enter the applicable template for the tax year at the
New using Template prompt.
• ACA Information Returns 2024.
• ACA Information Returns 2023.
• ACA Information Returns 2022.
• ACA Information Returns 2021.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Affordable Care Act (ACA) Administration
• Integration Event
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. Select Integration > Accept ACA Electronic Reporting Notice as a related action on the integration
system.
4. Steps: Set Up ACA Forms 1094-C and 1095-C.
5. Manually launch the integration.
See Launch an Integration on page 23.

Steps: Set Up ACA Mailing Connector

Prerequisites
Security: Integration Build domain in the Integration functional area.

Context
You can create and configure an integration that sends Affordable Care Act (ACA) 1094-C and 1095-C
data from Workday Benefits to an external mailing service provider. The mailing service provider can print
and mail 1095-C forms. Mailing service provider support is an optional service that is available through the
vendor CIC Plus.

Steps
1. Create Integration System on page 1854.
Enter ACA Mailing Connector at the New using Template prompt.
2. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
3. Set Up Integration Delivery on page 1839.
4. Launch an Integration on page 23.
5. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Affordable Care Act (ACA) Administration
• Integration Event
See: Steps: Grant Integration or External Endpoint Access to Workday.
6. (Optional) Create Integration Notifications on page 30.

Concept: Affordable Care Act (ACA) Connectors


Send IRS Form 1094-C and 1095-C data to the Internal Revenue Service (IRS) and external mailing
service providers using ACA Connectors. These integrations enable you to:
• Submit ACA tax data under the Affordable Care Act Information Returns (AIR) Program.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1034

• Retrieve status update messages from the IRS endpoint.


• Send 1094-C and 1095-C data from Workday Benefits to an external mailing service provider. The
mailing service provider can print and mail the 1095-C forms.
Workday provides these ACA integration templates:
• ACA Information Returns (AIR) Connector:
• ACA Information Returns 2024.
• ACA Information Returns 2023.
• ACA Information Returns 2022.
• ACA Information Returns 2021.
• ACA Mailing Connector.

Launch/Schedule Option
To launch the ACA AIR Connector integrations manually, select the Run Now frequency from the Related
Action > Integration > Launch Schedule menu. Workday prompts you for the launch parameters.
Because IRS processing times can be variable, launching manually is the most flexible option.
You can enter these launch parameters for the AIR Connector for each year:

Parameter Description
Company Specifies the company for which you’re
sending1094-C and 1095-C data.
Run Mode Select these options to validate, send, and check
the status of your data:
1. Validate without Sending runs validation checks
on the data without transmitting data to the IRS.
Use this mode to check the data and make
updates to ensure it’s correct before transmitting
to the IRS.
2. Send Data sends 1094-C and 1095-C forms to
the IRS endpoint.
3. Check Status requests that the IRS sends the
status of your submission.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
You can find these files in the Reports and Other Output Files section of the Integration Event. These
files display for each integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if you don’t want administrators to have access to the data.

Integration Completion Status


After running the integration in Check Status mode, you can get a variety of messages and errors
depending on your data. Examine each message carefully and understand the difference between each
status.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1035

Status Description
Rejected The IRS file rejected your file and your file needs
changes.
Note: A change is different from a correction. You
submit a correction for a previously accepted file.
The IRS considers the file a replacement file with a
transmission type code of R.

Accepted with Errors The IRS accepted the file, but has discrepancies.
You can make 1094-C and 1095-C corrections
with the Create ACA 1095-C/1094-C Data
(Corrections) task.
Use the task for correcting the data only after you
transmit data to the IRS. This task updates both
1095-C and 1094-C data. If you don't want to
update 1095-C form data, select the Prevent 1095-
C corrections for previously transmitted items
check box.
Note: If you need to make 1095-C corrections with
an EIB, run the corrections task before making any
updates with EIB. If you run the Create ACA 1095-
C/1094-C Data (Corrections) task after importing
changes with the EIB, Workday overrides any
changes that you loaded using EIB.
Corrections to either 1095-C or 1094-C data have a
transmission type code of C for corrections file.

Accepted The IRS accepted your file without issues or errors.

Related Information
Reference
The Next Level: Benefits Integrations

Troubleshoot: Affordable Care Act (ACA) Connectors

Issue Resolution
You want to find the record in error. Run the integration and the set the launch
parameter to Send Data and save all of the
generated files for review. Review the errors in
the Transmission_MessageAudit_1.zip file. Fix the
errors in an EIB and try the upload again in validate
only mode.
You want to find the record in error from the Workday provides a file called
transmission summary. Transmission_MessageAudit_1.zip. If you open that
file, you'll see the details about any errors. Review
any error files that say <UniqueRecordID>. Fix
the errors and submit in validate only mode.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1036

Issue Resolution
Example: You find a record ID with
1095C-17-00115226|1|50. The number 50 refers to
the 50th 1095-c form from the submission.

The address or name field is too long. Use Address Field 2 to avoid the 35 character limit
for Primary Address.
You want to exclude 1094-C employee to exclude Access the Calculate 1094-C Total and Full Time
workers with tuning rules. Employee Counts by Month task to get a list of
workers included using tuning rules and set a filter.
Run the View 1094-C FTE and Total Count
Details report and copy the report. Filter the
copied report using the same criteria you used in
your tuning rules and identify those employees to
exclude.

You have a blank 1094-C Part 3b full-time If you use the 98% offer method, leave the 4980H
employee count. full-time employee count blank.
You have duplicate dependencies. Access the Delete 1095-C Form Data task. You
can delete an individual 1095 record without
deleting the entire company. Review individual
records and reupload the record using an EIB.
Delete the covered individual reference ID on
the EIB and Workday will generate a new one,
otherwise you'll get a duplicate error. Publish the
1095 for that Company so it will display on the
record of the worker.

AngelPoints

Steps: Set Up AngelPoints Integration

Context
Create an integration system that establishes accounts in AngelPoints and updates the accounts when
changes occur. The integration reports changes to worker status so that AngelPoints can activate or
deactivate accounts as needed.
After the initial full file worker synchronization, Workday sends AngelPoints a changes-only file, when
scheduled. The changes-only file contains complete records for workers who are new or whose information
has changed since the last integration run.

Steps
1. Access the Create Integration System task and enter AngelPoints - Worker Sync at the New using
Template prompt.
Security: Integration Build in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1037

2. In the Configure Integration Services task, enable integration services:


Option Description
Define Eligibility Enable this service to define rules for whether
Workday includes a worker in the integration.
If you want to include all workers automatically
in the integration, you don't need to select this
option.
Account Provisioning - Worker Sync Enables you to configure the ISO Country Code,
Region Organization Type, and Rehire Date
usage.
Account Provisioning - Common Enables you to configure Employee ID Name and
Configuration Workday ID (WID) usage.
Account Provisioning - Delivery Service Enables you to configure delivery of integration
output documents to the AngelPoints SFTP
server. If you don't enable this service, configure
another integration system to retrieve the
integration output documents and send them to
AngelPoints.
AngelPoints Additional Fields Service Enables you to map up to 9 Organizations
in Workday to the corresponding values in
AngelPoints.
Transaction Log Service Enables the integration to monitor events in
Workday and launch when events occur that
change worker data.

Security: Integration Build in the Integration functional area.


3. (Optional) To send up to 20 additional fields to AngelPoints, access the Configure Integration
Services task. Add a Custom Fields integration service to the Custom Integration Services grid.
4. Create an Integration System User (ISU) and grant the ISU access to these domains:
• Integration Event
• Person Data: Gender
• Person Data: Home Contact Information
• Worker Data: Current Staffing Information
• Worker Data: Public Worker Reports
• Worker Data: Work Contact Information
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
5. As a related action on your Connector, select Integration System > Configure Integration Attributes
and enter attributes required by the integration template:
Option Description
Include Inactive Workers in Full File Includes inactive workers in the output when you
enable the Full File launch parameter. If you don't
select this option, Workday excludes inactive
workers from Full File results.
Required Field Validation Applies additional validation rules that identify
errors that can occur when exporting data, and
specifies error handling:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1038

Option Description
• Omit - Report Error: Workday doesn't include
records with errors in the output file. If you
don't select a value, Workday uses this option.
• Include - Report Warning: Workday includes
records with errors in the output file; warning
displays in the Integration Event for the
integration run.

ISO Country Code Select the type of ISO Country Codes (options are
two- or three-character codes) that you want to
include in the integration output document.
Region Organization Type Specify the organization type for regions that
you want to include in the integration output
document. If not specified, Workday doesn't
include region data in the integration output
document.
Send Rehire Date Specifies that Workday includes the rehire date in
the integration output document. Workday doesn't
include the original hire date for rehired workers.
If not selected, Workday always sends the original
hire date.
Employee ID Name Specify the ID type used to identify workers on the
integration output document.
Use WID To force use of Workday ID (WID) values
to identify workers on the integration output
document, select this option. Use this option if
any type-specific IDs (such as Organization Type)
exceed 90 bytes of UTF-8 characters.
Document Retention Policy To specify the number of days that Workday
retains integration output files, enter the
Document Retention Policy attribute value.
6. Set Up Integration Field Overrides for a Connector on page 1860.
Workday requires this step only if you enabled any of these integration services:
Option Description
AngelPoints Additional Fields Service You can select up to 9 organization fields to
include in your output file. The integration
uses these organization fields as membership
groupings in AngelPoints.
Define Eligibility Select a Boolean report field or calculated field for
workers that you want to include in the integration
output file.
Custom Fields Map additional worker data fields to the
corresponding values in AngelPoints. AngelPoints
accepts up to 20 custom field values.
7. As a related action on the integration system, select Integration System > Configure Integration
Maps.
Map tenant values for employee data in Workday to AngelPoints.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1039

8. Set Up Integration Sequence Generators on page 1856.


9. Set Up Integration Delivery on page 1839.
10.As a related action on the integration system, select Integration System > Configure Integration
Transaction Log.
Configure the integration to subscribe to Workday events that can trigger the need to send an update to
AngelPoints. This step is required only if you enabled the Transaction Log Service.
11.Launch an Integration on page 23.
12.(Optional) Configure Worklets for SSO-Based Access to AngelPoints.

Steps: Set Up Worklets for SSO-Based Access to AngelPoints

Prerequisites
Know your AngelPoints tenant name.

Context
Create worklets that enable your workers to provide access credentials to AngelPoints from worklets in
Workday.

Steps
1. Create an X.509 Private Key Pair.
Create an X.509 private key pair, save the public key as a cert file, and send the public certificate to
AngelPoints.
2. Access the Edit Tenant Setup - Security task and select the x509 Private Key Pair from the prompt.
See: Reference: Edit Tenant Setup - Security
3. Create or Edit SAML SSO Links.
4. Access the Create SAML SSO Link task and create an SSO link named Dashboard with these
attributes:
Option Description
SAML Version 1.1
Assertion Consumer Service URL https://
<angelpoints_customer_name>.angelpointsevs.com/
login.sso
Name Identifier User Name
Recipient https://
<angelpoints_customer_name.angelpointsevs.com/
login.sso
Audience https://sp.angelpoints.com/SAML1
Deeplink https://
<angelpoints_customer_name.angelpointsevs.com/
handlers/dashboard.aph
Issuer ID https://myworkday.com/<workday_tenant>/
login.htmld
Signature Method SHA256

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1040

5. Access the Create SAML SSO Link task and create an SSO link named Event Calendar with these
attributes:
Option Description
SAML Version 1.1
Assertion Consumer Service URL https://
<angelpoints_customer_name>.angelpointsevs.com/
login.sso
Name Identifier User Name
Recipient https://
<angelpoints_customer_name.angelpointsevs.com/
login.sso
Audience https://sp.angelpoints.com/SAML1
Deeplink https://
<angelpoints_customer_name.angelpointsevs.com/
handlers/event/calendar.aph
Issuer ID https://myworkday.com/<workday_tenant>/
login.htmld
Signature Method SHA256
6. Access the Create SAML SSO Link task and create an SSO link named Log Independent Volunteer
Activity (IVA) with these attributes:
Option Description
SAML Version 1.1
Assertion Consumer Service URL https://
<angelpoints_customer_name>.angelpointsevs.com/
login.sso
Name Identifier User Name
Recipient https://
<angelpoints_customer_name.angelpointsevs.com/
login.sso
Audience https://sp.angelpoints.com/SAML1
Deeplink https://
<angelpoints_customer_name.angelpointsevs.com/
handlers/event/ive-create-non-manager.aph
Issuer ID https://myworkday.com/<workday_tenant>/
login.htmld
Signature Method SHA256
7. Access the Create SAML SSO Link task and create an SSO link named Search for Volunteer Events
with these attributes:
Option Description
SAML Version 1.1
Assertion Consumer Service URL https://
<angelpoints_customer_name>.angelpointsevs.com/
login.sso

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1041

Option Description
Name Identifier User Name
Recipient https://
<angelpoints_customer_name.angelpointsevs.com/
login.sso
Audience https://sp.angelpoints.com/SAML1
Deeplink https://
<angelpoints_customer_name.angelpointsevs.com/
handlers/event/search.aph
Issuer ID https://myworkday.com/<workday_tenant>/
login.htmld
Signature Method SHA256
8. Access the Create SAML SSO Link task and create an SSO link named Submit My Hours with these
attributes:
Option Description
SAML Version 1.1
Assertion Consumer Service URL https://
<angelpoints_customer_name>.angelpointsevs.com/
login.sso
Name Identifier User Name
Recipient https://
<angelpoints_customer_name.angelpointsevs.com/
login.sso
Audience https://sp.angelpoints.com/SAML1
Deeplink https://
<angelpoints_customer_name.angelpointsevs.com/
handlers/event/submit-hours.aph
Issuer ID https://myworkday.com/<workday_tenant>/
login.htmld
Signature Method SHA256
9. Access the Create Quicklink Group task.
Create a Volunteering group, and add the 5 links you created in the preceding steps to the group.
10.Create a Quicklinks Worklet.
Create a Quicklinks Custom Report that includes the Quicklink Group. Set the output as a worklet, then
share the report with any user groups.
11.Add the worklet to the landing pages of your choice.
See: Steps: Set Up Dashboards and Landing Pages.

Concept: AngelPoints Integration


Support employee volunteering, giving, and sustainability needs for your organization using the
AngelPoints integration. AngelPoints offers a web-based service designed to increase participation in your
employee volunteering, giving, and sustainability programs. AngelPoints enables you to track and report on
the collective impact of your company. Workday synchronizes information about workers and organizations
with AngelPoints so that you can automate management of accounts in AngelPoints.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1042

Workday synchronizes HCM data with AngelPoints using a single integration system, which delivers files to
an external SFTP server.
Workday manages all HCM data, including:
• Workers
• Organizations
Related Information
Concepts
Concept: Workday Connectors on page 500

Assign Organizations Inbound Connector

Steps: Set Up Assign Organizations Inbound Connector Integration

Prerequisites
Set up an external endpoint that your Workday integration can access. Your external endpoint must be
able to generate change data for organization assignments in the defined XML format.

Context
You can create an integration that:
• Accesses an external server.
• Retrieves a data file containing organization assignment changes.
• Imports change data into Workday.

Steps
1. Configure your external endpoint so that it can generate data for organization assignment changes. The
data must be in one of the formats supported by the Assign Organizations Inbound Connector.
2. Access the Create Integration System task and enter Core Connector: Assign Organization Inbound
at the New using Template prompt.
Security: Integration Build in the Integration functional area.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Build
• Integration Event
• Manage: Organization Integration
• Manage: Organization Update Integration
• Worker Data: Organization Information
• Worker Data: Public Worker Reports
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. Set Up Assign Organizations Inbound Connector Attributes on page 1043.
Create integration attributes for the Connector.
5. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves data files with organization changes from your external
endpoint.
6. Launch an Integration on page 23.
Schedule how often the integration system runs.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1043

Set Up Assign Organizations Inbound Connector Attributes

Prerequisites
Security: Integration Configure domain in the Integration functional area.

Context
Configure integration attributes for an integration based on the Core Connector: Assign Organization
Inbound template.

Steps
1. As a related action on your Assign Organizations Inbound Connector integration, select Integration
System > Configure Integration Attributes.
2. Add a row for each attribute and specify a value:
Option Description
Business Process Auto Complete Completes the business process for the
organization assignment action automatically. If
not selected, business process runs normally.
Input File Tag Select one or more document tags that identify
the file containing the organization inbound
updates. Use this attribute in scenarios where you
want to attach multiple files of different types to
the business process. If you define multiple tags
for the attribute, configure the Document Retrieval
service to apply all listed tags in order for this
integration to find the file. If you leave this field
empty, the integration processes input files with a
Retrieved tag.
Validation Process Specifies how the integration processes an
organization record that fails validation:
• Skip: the integration system skips the invalid
record and processes any subsequent records.
• Abort: the integration system stops all
processing.
Note: Records that you loaded previously in
the same integration run don't roll back.

Input File Format Indicates that the incoming file is in XML format.
Document Retention Policy Specify how many days Workday keeps the
imported files. If you don't override this value,
Workday sets the retention period to 30 days.

View Assign Organizations Inbound Connector Integration Audits

Prerequisites
Security: Background Process Management domain in the Tenant Non-Configurable functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1044

Context
For each integration event, you can use the Assign Organizations Inbound Connector integration audits to
determine:
• What operation performs (DataChangesAudit.html)
• Details about the file (DiagnosticAudit.html)

Steps
1. As a related action on the integration event, select Background Process > View Output Files.
2. Select an audit file:
Option Description
DataChangesAudit.html For each worker, displays the operation (Add,
Update, Inactivate); for Update operations, also
displays each changed field.
DiagnosticAudit.html For each worker, displays the document name,
the name and Reference ID of the worker, and
if the file contained errors. Also displays any
validation messages received while processing
the organization.

Related Information
Tasks
Launch an Integration on page 23
View Integration Events on page 27

Concept: Assign Organizations Inbound Connector


To import organization assignments from an external endpoint that manages organization assignments into
Workday, use the Assign Organizations Inbound Connector integration. The Assign Organizations Inbound
Connector updates worker assignments to organizations such as a Company, Cost Center, Region, or
Business Unit. With the Assign Organizations Inbound Connector, you can use a non-Workday application
as your source of record for chart of account assignments, then synchronize that data with Workday.
Note: The Assign Organizations Inbound Connector integration works with organizations in Workday.
Familiarize yourself with the organization feature in Workday.

Features and Limitations


The Assign Organizations Inbound Connector can assign workers to these types of organizations:
• Companies
• Cost Centers
• Regions
• Business Units
The Assign Organizations Inbound Connector has these limitations:
• Workers and organizations must exist in Workday.
• The integration doesn't support assignment to Supervisory organizations.
• The integration doesn't support custom Organizations.

File Format for Assign Organizations Inbound Connector Data


The Assign Organizations Inbound Connector integration imports data in a Workday-defined XML format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1045

Integration Process Flow


The Assign Organizations Inbound Connector integration can import organization data using this process:
1. Your external endpoint generates a file (in the Workday-supported format) and sends it to a file server
known to the integration.
2. You launch the integration, either by schedule or manually.
3. The integration retrieves the file according to the Document Retrieval configuration on the Integration
Process Event and applies document tags.
4. The integration processes the file, then imports the data into Workday:

Assign Organizations Inbound Connector Audits


The Assign Organizations Inbound Connector integration generates audit files each time it runs.
Related Information
Concepts
Concept: Workday Connectors on page 500

Reference: Assign Organizations Inbound Connector File Schema

CSV File Description


The CSV format consists of 17 fields. For a complete description of each field, see the XML Elements
section:
• Worker_ID
• Worker_Type
• Position_Reference_ID
• Effective_Date
• Company_Organization_Reference_ID
• Cost_Center_Organization_Reference_ID
• Region_Organization_Reference_ID
• Business_Unit_Organization_Reference_ID
• Custom_Organization_Reference_ID_1 (Don't use this field.)
• Custom_Organization_Reference_ID_2 (Don't use this field.)
• Custom_Organization_Reference_ID_3 (Don't use this field.)
• Custom_Organization_Reference_ID_4 (Don't use this field.)
• Custom_Organization_Reference_ID_5 (Don't use this field.)
• Custom_Organization_Reference_ID_6 (Don't use this field.)
• Custom_Organization_Reference_ID_7 (Don't use this field.)
• Custom_Organization_Reference_ID_8 (Don't use this field.)
• Custom_Organization_Reference_ID_9 (Don't use this field.)
Note: The Date format used for CSV is M/d/yyyy, which follows the date and time pattern defined for a
java.text.SimpleDateFormat.

XML Elements
The XML schema for inbound organization update data includes these elements:

Element Level
Description
Import_Assign_Organization_Request 1Contains all other elements. Workday enables only
1 element per file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1046

Element Level
Description
Worker_Assign_Organization 2Contains 1 instance of all subsequent elements,
except as noted. Workday enables unlimited
number of elements per file.
Worker_ID 3Reference ID value for the worker. Worker must
exist in Workday. Must be in XSD string format.
If you entered a value for Position_Reference_ID,
leave this field empty.

Worker_Type 3Valid values are Employee or Contingent Worker;


value must be in XSD string format.
If you entered a value for Position_Reference_ID,
leave this field empty.

Position_Reference_ID 3Reference ID for the position of the worker. Must


be in XSD string format.
If you entered values for Worker_ID and
Worker_Type, leave this element empty.

Effective_Date 3Date that the organization assignment for the


worker becomes effective in Workday. Must be in
XSD date format.
Company_Organization_Reference_ID 3Reference ID for the Company to which you’re
assigning the worker. Must be in XSD string format.
Cost_Center_Organization_Reference_ID 3Reference ID for the Cost Center to which you’re
assigning the worker. Must be in XSD string format.
Region_Organization_Reference_ID 3Reference ID for the Region to which you’re
assigning the worker. Must be in XSD string format.
Business_Unit_Organization_Reference_ID 3Reference ID for the Business Unit to which you’re
assigning the worker. Must be in XSD string format.
Custom_Organization_Reference_ID 3Don't use this element.

XML Schema
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:ao="urn:com.workday/coreconnector/inbound/assignorg"
targetNamespace="urn:com.workday/coreconnector/inbound/assignorg"
elementFormDefault="qualified" attributeFormDefault="qualified">
<xsd:annotation>
<xsd:appinfo>Core Connector Assign Organization Inbound</
xsd:appinfo>
<xsd:documentation>This schema defines an inbound record
for the Core Connector: Assign Organization Inbound Integration</
xsd:documentation>
</xsd:annotation>
<!-- Wrapping element for the assign organization records -->
<xsd:element name="Import_Assign_Organization_Request"
type="ao:Import_Assign_Organization_Request"> </xsd:element>
<!-- Single inbound record definition -->
<xsd:complexType name="Import_Assign_Organization_Request">
<xsd:sequence>
<xsd:element name="Worker_Assign_Organization"
type="ao:Worker_Assign_Organization" maxOccurs="unbounded"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1047

</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Worker_Assign_Organization">
<xsd:sequence>
<xsd:choice>
<xsd:sequence>
<xsd:element name="Worker_ID"
type="xsd:string" default="Employee"/>
<xsd:element name="Worker_Type"
type="ao:Worker_Type"/>
</xsd:sequence>
<xsd:sequence>
<xsd:element
name="Position_Reference_ID" type="xsd:string"/>
</xsd:sequence>
</xsd:choice>
<xsd:element name="Effective_Date" type="xsd:date"
nillable="true" minOccurs="0"/>
<xsd:element name="Company_Organization_Reference_ID"
type="xsd:string" nillable="true" minOccurs="0"/>
<xsd:element
name="Cost_Center_Organization_Reference_ID" type="xsd:string"
nillable="true" minOccurs="0"/>
<xsd:element name="Region_Organization_Reference_ID"
type="xsd:string" nillable="true" minOccurs="0"/>
<xsd:element
name="Business_Unit_Organization_Reference_ID" type="xsd:string"
nillable="true" minOccurs="0"/>
<xsd:element name="Custom_Organization_Reference_ID"
minOccurs="0" maxOccurs="unbounded" type="xsd:string" nillable="true" />
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="Worker_Type">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Employee"/>
<xsd:enumeration value="Contingent Worker"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>

Core Connector: Background Check Order

Steps: Set Up Core Connector: Background Check Order Integrations

Prerequisites
You must:
• Understand Workday integrations.
• Understand Workday integration business processes.
• Set up the background check packages and statuses.
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Connect Workday to the external background check endpoint through 2 integration systems:
• An outbound integration that sends background check requests to the external endpoint.
• An inbound integration that receives background check information from the external endpoint.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1048

Steps
1. Configure the Core Connector: Background Check Order Outbound integration.
a) Access the Create Integration System task.
b) Enter Core Connector: Background Check Order Outbound at the New using Template prompt.
2. (Optional) Enable these integration services. The Configure Integration Services task displays all
integration services, including required services; the required integration services aren't editable.
Option Description
Core Connector: Background Check Enable if you want Workday to deliver output files
Outbound Delivery to background check vendors.
Note: If you disable this service, deliver the files
using an alternative method.

Core Connector: Background Check File Enable if you want Workday to apply a custom-
Sequence Generator formatted, unique filename to each integration file.
Integration Document Retention Enable if you want Workday to preserve output
files.
3. (Optional) Add Evergreen Requisitions for background checks.
a) From the related action menu of the integration system, select Integration System > Configure
Integration Services.
Select Create Integration Field Override Service as an Integration Service in the Custom
Integration Service grid.
b) Configure the Create Integration Field Override Service task. As you complete the task, add these
values:
• On the Name field at the header, add Evergreen Requisition.
• On the Business Object field at the header, add Background Check.
• On the Fields grid, enter Evergreen Requisition in the Name column.
c) As a related action on the integration system, select Integration System > Configure Integration
Field Overrides.
Select Evergreen Requisition as the Override External Field for Evergreen Requisition
background check.
4. As a related action on the integration system, select Integration System > Configure Integration
Attributes.
Enter attributes required by the integration template.
5. As a related action on the integration system, select Integration System > Configure Integration
Maps.
Map values between Workday and the external file format.
6. Set Up Integration Delivery on page 1839.
7. Set Up Integration Sequence Generators on page 1856.
8. (Optional) Configure the Document Transformation integration.
See Steps: Set Up Document Transformation Connector on page 571.
9. Add Integration Steps to Background Check Business Process on page 1049.
To launch the outbound integration automatically, configure the Background Check business process
definition.
10.Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:

Functional Area Domains


Integration Integration Event

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1049

Functional Area Domains


Personal Data Worker Data: Background Check Status
Pre-Hire Process • Job Requisition Data
• Manage Pre-Hire Process: Manage Pre-Hires
• Pre-Hire Data: Background Check Status

Recruiting • Candidate Data: Background Check History


• Candidate Data: Job Application
• Manage: Evergreen Requisitions

Staffing Worker Data: Public Worker Reports


Worker Profile and Skills • Pre-Hire: Skills and Experience
• Worker Data: Skills and Experience

See Steps: Grant Integration or External Endpoint Access to Workday.


11.Configure the Core Connector: Background Check Inbound integration.
a) Access the Create Integration System task.
b) Enter Core Connector: Background Check Inbound at the New using Template prompt.
12.As a related action on the integration, select Integration System > Configure Integration Attributes.
Enter attributes required by the integration template.
13.Set Up Integration Retrieval on page 1845.
14.Create an Integration System User (ISU) and grant the ISU access to these domains:

Functional Area Domain


Personal Data Worker Data: Background Check Status
Pre-Hire Process Pre-Hire Data: Background Check Status
Recruiting • Candidate Data: Background Check History
• Manage: Evergreen Requisitions

See Steps: Grant Integration or External Endpoint Access to Workday.


15.Launch an Integration on page 23.

Add Integration Steps to Background Check Business Process

Prerequisites
• Identify the Background Check business process or processes that you use to call the outbound
integration. Your tenant can use more than 1 Background Check business process; you need to modify
them all.
• Security: Business Process Administration and Manage: Business Process Definitions domains in the
System functional area.

Context
To call the outbound integration and perform other operations or processes, add steps to the Background
Check business process.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1050

Steps
1. Open the business process.
2. Select Business Process > Edit Definition as a related action.
3. Set up the business process steps:

OrderIf Type Specify Optional


Group Additional Notes
a Initiation No
b Integration No This step runs your integration for
Core Connector: Background Check
Order Outbound.
• Set the Background Check
ID field to Determine Value at
Runtime and Background Check
Business Process.
• For the As of Entry Moment,
set the Value Type to Determine
Value at Runtime. Specify
a value of Current Moment
(DateTime).

c ServiceDocument No Sends the XML file containing the


Delivery background check requests to the
external endpoint.
d Background Action Select No • HR
Check Background Administrator
Event has Check • Manager
Package? Overall
• Manager
(Workday Status
(Unconstrained)
Owned)
• Recruiter
• Recruiter
(Unconstrained)

e Event is Action Make No • HR


subevent of Background Administrator
Recruiting Check • Manager
Event? Decision
• Manager
(Workday
(Unconstrained)
Owned)
• Recruiter
• Recruiter
(Unconstrained)

Concept: Core Connector: Background Check Order


With the Core Connector: Background Check Order Outbound integration, you can send background
check requests for workers, pre-hires, and candidates to an external endpoint. The external endpoint
performs the checks and sends information back. The Core Connector: Background Check Order Inbound
integration receives the information and updates the Workday data. The integration sends requests in an
output XML file, and retrieves information in an input XML file.
Depending on the external endpoint, you might need to transform the output file into the format that the
external endpoint supports using 1 of these options:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1051

• Transformation step on the business process. You configure the business process definition of the
outbound integration to transform the output file.
• Workday Studio integration. You configure the business process definition of the outbound integration
to launch a Workday Studio integration that transforms the output file.
• Other third-party tool. You configure a third-party tool to transform the output file.

Reference: File Schema for Core Connector: Background Check Order Outbound

XML Schema
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:bgo="urn:com.workday/coreconnector/outbound/backgroundcheckout"
elementFormDefault="qualified" attributeFormDefault="qualified"
targetNamespace="urn:com.workday/coreconnector/outbound/backgroundcheckout">

<xsd:element name="Background_Check_Connector_Outbound"
type="bgo:Background_Check_Connector_Outbound_Type"/>

<xsd:complexType name="Background_Check_Connector_Outbound_Type">
<xsd:sequence>
<xsd:element name="Header"/>
<xsd:element name="Background_Check_Data"
type="bgo:Background_Check_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Background_Check_Data_Type">
<xsd:sequence>
<xsd:element name="Background_Check_ID" type="xsd:string"/>
<xsd:element name="Submission_Date" type="xsd:dateTime"/>
<xsd:element name="Package_Data" type="bgo:Package_Data_Type"/>
<xsd:element name="Requester_Data" type="bgo:Requester_Data_Type"/
>
<xsd:element name="Recipient_Data" type="bgo:Recipient_Data_Type"/
>
<xsd:element name="Job_Requisition_Data" minOccurs="0"
type="bgo:Job_Requisition_Data_Type"/>
<xsd:element name="Additional_Data" minOccurs="0"
type="bgo:Additional_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Requester_Data_Type">
<xsd:sequence>
<xsd:element name="Worker_ID">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" use="required">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Employee_ID"/>
<xsd:enumeration
value="Contingent_Worker_ID"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="First_Name" type="xsd:string"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1052

<xsd:element name="Middle_Name" type="xsd:string"/>


<xsd:element name="Last_Name" type="xsd:string"/>
<xsd:element name="Email_Usage_Type" type="xsd:string"/>
<xsd:element name="Email_Address" type="xsd:string"/>
<xsd:element name="Phone_Usage_Type" type="xsd:string"/>
<xsd:element name="Phone_Device_Type" type="xsd:string"/>
<xsd:element name="International_Phone_Code" type="xsd:string"/>
<xsd:element name="Area_Code" type="xsd:string"/>
<xsd:element name="Phone_Number" type="xsd:string"/>
<xsd:element name="Phone_Extension" type="xsd:string"/>
<xsd:element name="Additional_Data" minOccurs="0"
type="bgo:Additional_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Recipient_Data_Type">
<xsd:sequence>
<xsd:element name="Recipient_ID">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="type" use="required">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Applicant_ID"/
>
<xsd:enumeration value="Employee_ID"/>
<xsd:enumeration
value="Contingent_Worker_ID"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="First_Name" type="xsd:string"/>
<xsd:element name="Middle_Name" type="xsd:string"/>
<xsd:element name="Last_Name" type="xsd:string"/>
<xsd:element name="Address_Usage_Type" type="xsd:string"/>
<xsd:element name="Address_Line_Data">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Address_Line" minOccurs="0"
maxOccurs="unbounded" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Municipality" type="xsd:string"/>
<xsd:element name="Submunicipality_Data">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Submunicipality" minOccurs="0"
maxOccurs="unbounded" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Country_Code" type="xsd:string"/>
<xsd:element name="Country_Region" type="xsd:string"/>
<xsd:element name="Postal_Code" type="xsd:string"/>
<xsd:element name="Email_Usage_Type" type="xsd:string"/>
<xsd:element name="Email_Address" type="xsd:string"/>
<xsd:element name="Phone_Usage_Type" type="xsd:string"/>
<xsd:element name="Phone_Device_Type" type="xsd:string"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1053

<xsd:element name="International_Phone_Code" type="xsd:string"/>


<xsd:element name="Area_Code" type="xsd:string"/>
<xsd:element name="Phone_Number" type="xsd:string"/>
<xsd:element name="Phone_Extension" type="xsd:string"/>
<xsd:element name="Education_Data" minOccurs="0">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Education_ID" type="xsd:string"/>
<xsd:element name="School_Type" type="xsd:string"/>
<xsd:element name="School_Name" type="xsd:string"/>
<xsd:element name="Location" type="xsd:string"/>
<xsd:element name="Field_Of_Study" type="xsd:string"/>
<xsd:element name="Degree" type="xsd:string"/>
<xsd:element name="First_Year_Attended"
type="xsd:string"/>
<xsd:element name="Last_Year_Attended"
type="xsd:string"/>
<xsd:element name="Grade_Average" type="xsd:string"/>
<xsd:element name="Is_Highest_Level_of_Education"
type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Job_History_Data" minOccurs="0">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="External_Employment_ID"
type="xsd:string"/>
<xsd:element name="Company" type="xsd:string"/>
<xsd:element name="Job_Title" type="xsd:string"/>
<xsd:element name="Start_Date" type="xsd:date"/>
<xsd:element name="End_Date" type="xsd:date"/>
<xsd:element name="Responsibilities_And_Achievements"
type="xsd:string"/>
<xsd:element name="Location" type="xsd:string"/>
<xsd:element name="Job_Reference" type="xsd:string"/>
<xsd:element name="Contact" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Additional_Data" minOccurs="0"
type="bgo:Additional_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Job_Requisition_Data_Type">
<xsd:sequence>
<xsd:element name="Job_Requisition_ID" type="xsd:string"/>
<xsd:element name="Job_Requisition_Status" type="xsd:string"/>
<xsd:element name="Job_Posting_Title" type="xsd:string"/>
<xsd:element name="Supervisory_Organization" type="xsd:string"/>
<xsd:element name="Recruiting_Start_Date" type="xsd:date"/>
<xsd:element name="Target_Hire_Date" type="xsd:date"/>
<xsd:element name="Target_End_Date" minOccurs="0" type="xsd:date"/
>
<xsd:element name="Scheduled_Weekly_Hours" type="xsd:string"/>
<xsd:element name="Job_Profile" type="xsd:string"/>
<xsd:element name="Worker_Type" type="xsd:string"/>
<xsd:element name="Worker_Sub_Type" type="xsd:string"/>
<xsd:element name="Primary_Location" type="xsd:string"/>
<xsd:element name="Additional_Locations">
<xsd:complexType>
<xsd:sequence>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1054

<xsd:element name="Additional_Location" minOccurs="0"


maxOccurs="unbounded" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Time_Type" type="xsd:string"/>
<xsd:element name="Training_Profile" minOccurs="0"
maxOccurs="unbounded">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Training_Name" type="xsd:string" />
<xsd:element name="Description" type="xsd:string"
minOccurs="0" />
<xsd:element name="Training_Type" type="xsd:string" />
<xsd:element name="Required" type="xsd:string"
minOccurs="0" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Additional_Data" minOccurs="0"
type="bgo:Additional_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Additional_Data_Type">
<xsd:sequence>
<xsd:any processContents="lax" minOccurs="0" maxOccurs="unbounded"
namespace="##targetNamespace"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Package_Data_Type">
<xsd:sequence>
<xsd:element name="Package_ID" type="xsd:string"/>
<xsd:element name="Package_Name" type="xsd:string"/>
<xsd:element name="Package_Status" type="xsd:string"/>
<xsd:element name="Results_URL" type="xsd:string"/>
<xsd:element name="Comments" type="xsd:string"/>
<xsd:element name="Test_Data" minOccurs="0"
type="bgo:Test_Reference_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Test_Reference_Data_Type">
<xsd:sequence>
<xsd:element name="Test_ID" type="xsd:string"/>
<xsd:element name="Test_Name" type="xsd:string"/>
<xsd:element name="Test_Status" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Background_Check_Status_Data_Type">
<xsd:sequence>
<xsd:element name="Status_Date" type="xsd:date"/>
<xsd:element name="Background_Check_Status_ID" type="xsd:string"/>
<xsd:element name="Status" type="xsd:string"/>
<xsd:element name="Comments" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1055

Reference: File Schema for Core Connector: Background Check Inbound

XML Elements
To import background check data from an external background check application into Workday, the data
must be in the XML format described in this section.
The XML schema includes these elements:

Element Level Description


Background_Check_Connector_Inbound
1 Contains all other elements. Only 1 element permitted per file.
Background_Check_Data 2 Unlimited number of elements permitted per file.
Business_Process_Data 3 Contains business process configurations.
Auto_Complete 4 Specifies if business process automatically completes workflow
steps and bypasses To Do tasks, Notifications, and approvals for
a process or subprocess. Must be in XSD boolean format.
Run_Now 4 Triggers immediate start of the business process or subprocess.
Comment_Data 4 Contains comment elements.
Comment 5 Free-form text field. Must be in XSD string format.
Worker_ID 5 Worker ID associated with the comment. Must be in XSD string
format.
Dynamic_Business_Process_Data3 Contains configuration elements specific to the Recruiting Job
Application dynamic business process.
Next_Step_ID 4 ID value for next step in the job application business process.
Must be in XSD string format. If a Decline next step provided,
Disposition_Step_ID must have a value.
Disposition_Step_ID 3 ID value for disposition reason where a Decline next step
provided on job application business process. Must be in XSD
string format.
Comment_Data 4 Contains comment elements.
Comment 5 Free-form text field. Must be in XSD string format.
Worker_ID 5 Worker ID associated with the comment. Must be in XSD string
format.
Package_Comment 4 Comment for the package. Must be in XSD string format.
Results_URL 4 URL that points to background check results on the external
background check server. Must be in XSD string format.
Background_Check_ID 3 Reference ID value for the background check request. Must be
in XSD string format. If empty, Requires Recipient element and
subelements.
Recipient 3 Contains recipient identification. Required only if there's no
Background_Check_ID. Includes only 1 of these subelements:
• Employee_ID
• Applicant_ID
• Candidate_ID
• Contingent_Worker_ID

Employee_ID 4 Identifies the recipient. Must be in XSD string format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1056

Element Level Description


Applicant_ID 4 Identifies the recipient. Must be in XSD string format.
Candidate_ID 4 Identifies the recipient. Must be in XSD string format.
Contingent_Worker_ID 4 Identifies the recipient. Must be in XSD string format.
Background_Check_Status_Data 3 Contains status data elements for the background check.
Status_Date 4 Date of the status entry for the background check. Must be in
XSD dateTime format.
Status_ID 4 ID of the status entry. Must be in XSD string format.
Status_Comment 4 Free-form text field. Must be in XSD string format.
Package_Data 3 Contains the package data elements.
Package_ID 4 Reference ID value for the package. Must be in XSD string
format.
Package_Status 4 Status for the background check request contained in the
package. Must be in XSD string format.
Package_Comment 4 Comment for the package. Must be in XSD string format.
Results_URL 4 URL that points to background check results on the external
background check server. Must be in XSD string format.
Package_Test_Data 3 Contains package test data. An example test ensures that the
supplied Social Security Number (SSN) is valid.
Test_ID 4 Reference ID value for the background check test. Must be in
XSD string format.
Test_Status 4 Result of the background check test from the external server.
Must be in XSD string format.

XML Schema
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="urn:com.workday/coreconnector/inbound/backgroundcheck"
xmlns:tns="urn:com.workday/coreconnector/inbound/backgroundcheck"
elementFormDefault="qualified" attributeFormDefault="qualified">
<xs:element name="Background_Check_Connector_Inbound">
<xs:complexType>
<xs:sequence>
<xs:element name="Background_Check_Data"
type="tns:Background_Check_DataType" maxOccurs="unbounded" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:complexType name="Background_Check_DataType">
<xs:sequence>
<xs:element name="Business_Process_Data" minOccurs="0"
type="tns:Business_Process_DataType"/>
<xs:element name="Dynamic_Business_Process_Data" minOccurs="0"
type="tns:Dynamic_Business_Process_DataType"/>
<xs:choice minOccurs="1">
<xs:element name="Background_Check_ID" type="xs:string"/>
<xs:element name="Recipient" type="tns:Recipient_DataType"/>
</xs:choice>
<xs:element name="Background_Check_Status_Data" minOccurs="0"
type="tns:Background_Check_Status_DataType"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1057

<xs:element name="Package_Data" minOccurs="0"


type="tns:Package_DataType"/>
<xs:element name="Package_Test_Data" maxOccurs="unbounded"
minOccurs="0" type="tns:Package_Test_DataType"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Background_Check_Status_DataType">
<xs:sequence>
<xs:element name="Status_Date" type="xs:dateTime"/>
<xs:element name="Status_ID" type="xs:string"/>
<xs:element name="Status_Comment" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Package_DataType">
<xs:sequence>
<xs:element name="Package_ID" type="xs:string"/>
<xs:element name="Package_Status" type="xs:string"/>
<xs:element name="Package_Comment" type="xs:string" minOccurs="0"/>
<xs:element name="Results_URL" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Package_Test_DataType">
<xs:sequence>
<xs:element name="Test_ID" type="xs:string"/>
<xs:element name="Test_Status" type="xs:string"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Business_Process_DataType">
<xs:sequence>
<xs:element name="Auto_Complete" type="xs:boolean"/>
<xs:element name="Run_Now" type="xs:boolean"/>
<xs:element name="Comment_Data" type="tns:Comment_DataType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Dynamic_Business_Process_DataType">
<xs:sequence>
<xs:choice minOccurs="1">
<xs:element name="Next_Step_ID" type="xs:string"/>
<xs:element name="Disposition_Step_ID" type="xs:string"/>
</xs:choice>
<xs:element name="Comment_Data" type="tns:Comment_DataType"
minOccurs="0"/>
<xs:element name="Package_Comment" type="xs:string" minOccurs="0"/
>
<xs:element name="Results_URL" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Cancel_Business_Process_DataType">
<xs:sequence>
<xs:element name="Background_Check_ID" type="xs:string"/>
<xs:element name="Comment" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Recipient_DataType">
<xs:choice>
<xs:element name="Employee_ID" type="xs:string" minOccurs="0" />
<xs:element name="Applicant_ID" type="xs:string"
minOccurs="0" />
<xs:element name="Candidate_ID" type="xs:string"
minOccurs="0" />
<xs:element name="Contingent_Worker_ID" type="xs:string"
minOccurs="0" />
</xs:choice>
</xs:complexType>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1058

<xs:complexType name="Comment_DataType">
<xs:sequence>
<xs:element name="Comment" type="xs:string" minOccurs="0"/>
<xs:element name="Worker_ID" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:schema>

Core Connector: Candidate Outbound

Steps: Set Up Core Connector: Candidate Outbound Integration

Prerequisites
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure

Context
You can create a Core Connector: Candidate Outbound integration system to export candidate and job
application data from Workday to external applications.
The integration detects changes to candidate data from changes in:
• Job applications
• Job requisitions
• Prospect profiles
• Recruiting business processes
The integration doesn't track delegated or reassigned tasks, as well as these types of business process
steps:
• Approval
• Review Documents
• To Do

Steps
1. Create Integration System.
Enter Core Connector: Candidate Outbound in the New Using Template prompt.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
DIS - Performance Log Provides logs to keep track of DIS in integration
events.
Effective Stack - Performance Log Provides logs to track the performance of effective
changes calculations.
Integration Document Retention Preserves integration file output for later viewing.
Core Connector: Candidate Outbound - Enables you to define mappings for select
Integration Maps attributes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1059

3. As a related action on your Core Connector: Candidate Outbound integration, select Integration
System > Configure Integration Field Attributes.
Select which candidate fields to include in the output file.
4. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter attributes for integration services that you enabled in Step 2, as well as required
attributes.
5. Select Integration System > Configure Integration Maps as a related action on the integration
system and map the values between Workday and the external file format.
6. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Build
domain.
If you add custom fields to the integration, grant the ISU access to the domains for the custom fields.
See Steps: Grant Integration or External Endpoint Access to Workday.
7. Launch an Integration on page 23.
Specify these launch criteria to determine how you want the integration to export data:
• To export all data, select the Full File check box and clear the Candidate Change Detection check
box.
• To export only updated data with prior values, clear the Full File check box and select the
Candidate Change Detection check box.
• To export only updated data without prior values, select the Full File check box and the Candidate
Change Detection check box.

Core Connector: Competency Model

Steps: Set Up Core Connector: Competency Model Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Create a Core Connector: Competency Model integration to export changes to competency model
definitions to an external endpoint.

Steps
1. Access the Create Integration System task and enter Core Connector: Competencies Outbound in the
New Using Template prompt.
2. (Optional) Set Up Integration Sequence Generators on page 1856.
3. As a related action on your Core Connector: Competency Model integration, select Integration System
> Configure Integration Attributes and enter attributes required by the integration template.
4. Select Integration System > Configure Integration Maps as a related action on the integration
system. Map values between Workday and the external file format.
5. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Set Up: Skills and Experience
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
6. Select and Set Up Connector Output Fields on page 1864.
7. Create Integration Business Process on page 1838.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1060

8. (Optional) Steps: Set Up Document Transformation Connector on page 571.


9. Launch an Integration on page 23.

Concept: Core Connector: Competency Model


The Core Connector: Competency Model integration exports competency model data from Workday in
simple XML format. As you create, update, or delete competency model data, the integration generates an
output file containing the changes.
The integration includes a configurable set of competency model data. You can select which fields to
include or exclude, which ones to require, and which ones to truncate.

Launch/Schedule Options
Workday provides these launch schedule options for the Core Connector: Competency Model integration:
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Competency Model integration to run several times
per day; launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually. Workday prompts you for launch parameters.
For each launch schedule option, you can enter these launch parameters:

Parameter Description
As Of Entry Moment Extracts records that are current as of the specified
parameter.
Effective Date Extracts records that are current as of the specified
parameter.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration system. Workday generates this file every time the
integration runs. The file reflects your integration configuration as of the moment that the integration
ran. You can only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can’t have access to the data.
Related Information
Concepts
Concept: Workday Connectors on page 500

Reference: Core Connector: Competency Model Integration Data Sections


Before you build an integration with the Core Connector: Competency Model template, familiarize yourself
with the data section to understand which fields are available for output and how the configuration options
affect integration behavior.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1061

Section Description Fields


Competency Data • This section can have one or more records. • Competency ID
• The Competency Level attribute doesn’t • Competency Name
send data, but enables the attributes with • Competency Description
the same attribute prefix. Example: enable • Competency Category
Competency Level in order to use the • Competency Level
Competency Level, Competency Rating,
• Competency Level /
and Competency Behavior field attributes.
Competency Level ID
• Competency Level /
Competency Level Name
• Competency Level /
Competency Level Behavior
• Competency Level /
Competency Level Value
• Competency Level /
Competency Level Range Begin
• Competency Level /
Competency Level Range End
• Competency Level /
Competency Level Exclude from
Calculations
• Inactive

Core Connector: Global Worker

Steps: Set Up Core Connector: Global Worker

Prerequisites
• Create a True/False Condition calculated field that returns true for any worker that you want to include
in integration output. The calculated field must be based on the Worker primary business object.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To export changes to worker data that account for local time zones, create a Core Connector: Global
Worker integration.

Steps
1. Create Integration System on page 1854.
Enter Core Connector: Global Worker at the New Using Template prompt.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
Core Connector: Global Worker Transaction Enables your integration to subscribe to events
Log Service that take place in Workday. This option enables
your integration to report only changed fields for
workers, rather than report all fields.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1062

Option Description
If disabled, your integration first extracts all data
for eligible records, then evaluates the data for
changes. Using this option can adversely affect
performance.

Core Connector: Global Worker Sequence Applies a custom-formatted, unique filename to


Generator Service each integration file.
3. As a related action on your Core Connector: Global Worker integration select Integration System >
Configure Integration Transaction Log.
Select the Workday transactions that you want monitored for changes.
Note: Workday recommends that you select Subscribe to all Transaction Types except, then filter
out only transaction types that you know have no relevance to your needs. If in doubt, don't filter out a
transaction type.
4. Set Up Integration Sequence Generators on page 1856.
5. Select and Set Up Connector Output Fields on page 1864.
6. As a related action on your Core Connector: Global Worker integration, select Integration System >
Configure Integration Attributes. Enter attributes for integration services that you enabled in Step 2,
as well as required attributes.
7. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
8. As a related action on your integration, select Integration System > Configure Integration
Population Eligibility and select a True/False Condition calculated field that defines which workers the
integration should poll for changes.
9. Set Up Integration Delivery on page 1839.
10.(Optional) Steps: Set Up Document Transformation Connector on page 571.
If you skip this step, create an external application that transforms Workday XML into a format that your
external endpoint supports.
11.Launch an Integration on page 23.

Concept: Core Connector: Global Worker


The Core Connector: Global Worker integration exports worker data changes from Workday in simple
XML format. Workday applies effective dates based on local time zones. As you hire, promote, transfer,
terminate, or update worker data, the integration generates an XML file containing the changes.
Using configurable data sections, you can remove fields, truncate them, or make them required.

Change Detection
Core Connector: Global Worker detects changes to worker data by monitoring a transaction log. When
you configure the integration system, you select which business process and transaction types that the
integration system subscribes to. If your integration system doesn’t subscribe to a transaction type that
affects the profile of your worker, Workday doesn’t include changes triggered by that transaction type. By
including all business process and transaction types, you benefit automatically when Workday adds new
types. However, including all is also a potential risk, as the integration might include more information than
is necessary.
Core Connector: Global Worker integration uses a three-step process to detect and report changes:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1063

1. The integration checks the transaction log. It determines which workers have changes that result in the
generation of one of the configured transaction events.
2. For each worker with a matching transactional change, the integration compares their report fields for:
• The time at which the integration ran.
• The time at which the integration last successfully ran
The integration identifies which, if any, of the values of interest have changed.
3. If the worker has any changes in field values or eligibility, Workday generates an appropriate creation,
change, or deletion message.

Change Detection Limitations


Changes to the Classification of a Job don’t trigger change detection for this integration. The context of
the change is on the Job Profile (template), and not directly related to any associated job (instance) for a
worker. However, full extraction on worker records includes the job classification element.

Worker Eligibility
For each integration system, you define a group of workers that belongs to the integration system. A single
True/False Condition report field or calculated field defines membership. If the field value is true for a
worker, that worker is a member of the group, and Workday includes changes for that worker in the output
file. If the field value is false, the integration system ignores that worker.
You can use report fields on the Worker business object to define eligibility. If you can't define your group
membership criteria using a report field, you can create and use a calculated field. If multiple Boolean
values are true, the calculated field can evaluate the worker business object and its related business
objects to return true. Example: use a calculated field to return true if:
• The worker is a contingent employee.
• The primary location of the worker is in the United States.
• The supervisor of the worker is John Doe.

Output Configuration and Formats


The Core Connector: Global Worker integration supports output configuration using data sections. The
integration template includes these data sections:
• Personal Data.
• Status Data.
• Position Data.
• Leave of Absence Data.
You can select which fields to include or exclude, which ones to require, and which ones to truncate.
Workday exports data in a Workday-defined XML format. Each field element in the XML file includes
separate elements containing the current value and the prior value.

Launch/Schedule Options
Workday provides these launch schedule options for the Core Connector: Worker integration:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1064

• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member or have an organization role.
• Organization By Type displays if the Integration Process Event for this integration has no associated
organization. You can select any organization and subordinate organization of which you’re a
member or have an organization role.
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Worker integration to run several times per day;
launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers.
Workday prompts you to enter launch parameters.
For each launch schedule option, you can enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the
Successful As Of Entry Moment, Last specified As Of Entry Moment and Effective
Successful Effective Date Date parameters. If Full File isn’t selected, then
the extract includes only those records that have
changed in one or more output fields. Workday
compares to what was current as of the Last
Successful As Of Entry Moment and Last
Successful Effective Date parameters.
Full File Extracts Workers as of the As Of Entry Moment
and Effective Date, regardless of whether they’ve
changed.
Restrict Results By Orgs Extracts Workers for only the specified
Organizations and all subordinates.
Workers Extracts only the specified Workers.
If you configure no values, then the integration
considers all workers when looking for transactional
and data changes. Specifying workers in this
list doesn’t force their inclusion in the output file.
Information for a worker displays in the output
file only if there are changes in the data fields
evaluated by the integration system.
If there was an error involving data for one or more
workers during a prior integration run, specify
workers in this parameter at launch time. Correct
the worker data and then run the integration again
only for those workers. In this case, set the Last
Successful As Of Entry Moment to the moment
used for that parameter on the prior run that had
problems.

Integration Audit Files


Every time the integration runs, Workday generates these files:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1065

• The Data Changes Audit is a readable version of the integration output file (only when data changes are
detected).
• The Diagnostic Audit is designed to help you troubleshoot integration events.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration system. Workday generates this file every time the
integration runs. The file reflects your integration configuration as of the moment that the integration
ran. You can only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example, if administrators can’t have access to the data.

Core Connector: Job Postings

Steps: Set Up Core Connector: Job Postings

Prerequisites
Security: Integration Build domain in the Integration functional area.

Context
To send job posting data to an external job posting service or web site, create and configure a Core
Connector: Job Postings integration system.

Steps
1. Access the Create Integration System task and enter Core Connector: Job Postings at the New using
Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Enable 1 or more of the optional integration services.
The Configure Integration Services task displays all integration services, including required services.
Required integration services aren’t editable.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Job Postings: External
• Job Postings: Internal
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select Integration System > Configure Integration Maps from the related actions menu and enter
integration service attributes.
All Internal Values need to be mapped to an External Value. If you don't have every Internal Value
mapped, then you can also create a Default Value. The integration can fail if you don't select a Default
Value.
5. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Workday displays attributes for each enabled integration service; if you enable additional integration
services, more attributes display in the Configure Integration Attributes task.
6. Set Up Integration Sequence Generators on page 1856.
This step is required only if you enabled the Filename Sequence Generator integration service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1066

7. Set Up Integration Delivery on page 1839.


Specify how Workday delivers integration output documents. Configure a Document Delivery step on
the business process definition for the integration.
8. (Optional) Create Integration (Step).
Add the integration to the Post Job business process.
9. (Optional) Launch an Integration on page 23.
This step is required if you didn’t add the integration to the Post Job business process.
10.Steps: Set Up Document Transformation Connector on page 571.
Create a transformation that converts integration output files into the format required by the external
endpoint.

Concept: Core Connector: Job Postings


Core Connector: Job Postings exports all active job postings from Workday to one or more external job
posting websites. As you post, update job postings, or unpost jobs, the integration generates an output file
in Workday XML format containing all active postings.

Integration Services
The Core Connector: Job Postings template includes these integration services:

Table 2: Core Connector: Job Postings Integration Services

Integration Service Required/ Description


Optional
Core Connector: Job Postings Init Svc Required Extracts job posting data from your tenant and
generates an output file in Workday XML format.
Optionally, the Connector can include inactive as
well as active job postings.
Filename Sequence Generator Optional Enables the Connector to generate a unique,
sequenced filename each time it runs.
Transaction Log Service N/A Don’t enable this service.
Document Delivery Service Optional Enables the Connector to send output files to
an external endpoint over a range of different
transports such as AS2, FTP, FTPS, and SFTP.
You can have the documents delivered as part of
a larger business process. Example: an explicit
approval step before the delivery step.
Integration Document Retention Optional Enables the Connector to store output files for
auditing purposes.

Launch/Schedule Options
Workday provides these launch schedule options for the Core Connector: Job Postings integration:
• Launch using an Integration step on the Post Job business process.
• Launch by schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration collects all active job postings to send to the external endpoint. Workday
recommends that if you schedule Core Connector: Job Postings, you schedule the integration to run
daily.
• Launch immediately. You can launch the integration manually. Workday prompts you for the launch
parameters.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1067

For launch by schedule and launch immediately, you can enter these launch parameters:

Parameter Description
Job Requisition(s) Extracts only the specified Job Requisitions.
Job Posting(s) Extracts only the specified job postings.
Job Posting Site Name(s) Extracts job postings for only the specified job
posting site.
Job Posting Start Date Extracts job postings with a start date on or after
the specified date.
Job Posting End Date Extracts job postings with an end date on or before
the specified date.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. Workday generates this
file every time the integration runs. You can only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can’t have access to the data.
Related Information
Concepts
Setup Considerations: Job Postings

Reference: Core Connector: Job Postings XML Schema


Core Connector: Job Postings integrations generate output files in this XML format:
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jp="urn:com.workday/coreconnector/outbound/jobpostingsout"
elementFormDefault="qualified" attributeFormDefault="qualified"
targetNamespace="urn:com.workday/coreconnector/outbound/jobpostingsout">

<xsd:element name="Job_Postings_Connector_Outbound"
type="jp:Job_Postings_Connector_Outbound_Type"/>

<xsd:complexType name="Job_Postings_Connector_Outbound_Type">
<xsd:sequence>
<xsd:element name="Job_Postings" type="jp:Job_Postings_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Job_Postings_Type">
<xsd:sequence>
<xsd:element name="Job_Postings_Data" type="jp:Job_Postings_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Job_Postings_Data_Type">
<xsd:sequence>
<xsd:element name="Job_Posting_Data" type="jp:Job_Posting_Data_Type"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1068

</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Job_Posting_Data_Type">
<xsd:sequence>
<xsd:element name="Job_Posting_ID" type="xsd:string"/>
<xsd:element name="Job_Posting_Title" type="xsd:string"/>
<xsd:element name="Job_Posting_Description" type="xsd:string"/>
<xsd:element name="Job_Posting_Site" type="xsd:string"/>
<xsd:element name="External_Job_Path" type="xsd:string"/>
<xsd:element name="External_Apply_URL" type="xsd:string"/>
<xsd:element name="Job_Requisition_ID" type="xsd:string"/>
<xsd:element name="Primary_Posting_Location" type="xsd:string"/>
<xsd:element name="Additional_Posting_Locations" >
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Additional_Location" minOccurs="0"
maxOccurs="unbounded" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Job_Posting_Start_Date" type="xsd:string"/>
<xsd:element name="Job_Posting_End_Date" type="xsd:string"/>
<xsd:element name="Job_Family" type="xsd:string"/>
<xsd:element name="Time_Type " type="xsd:string"/>
<xsd:element name="Job_Type " type="xsd:string"/>
<xsd:element name="Supervisory_Organization" type="xsd:string"/>
<xsd:element name="Similar_Jobs" type="xsd:string"/>
<xsd:element name="Additional_Data" minOccurs="0"
type="jp:Additional_Data_Type"/>
</xsd:sequence>
</xsd:complexType>

<xsd:complexType name="Additional_Data_Type">
<xsd:sequence>
<xsd:any processContents="lax" minOccurs="0" maxOccurs="unbounded"
namespace="##targetNamespace"/>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

Core Connector: Job Profile and Job Family

Steps: Set Up Core Connector: Job Profile and Job Family Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To export core job family and job profile definitions to an external endpoint, you can create a Core
Connector: Job Profile and Job Family integration system.

Steps
1. Access the Create Integration System task and enter Core Connector: Job Profile and Job Family in
the New Using Template prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1069

2. Enable 1 or both of these integration services.


Option Description
Core Connector: Job Family Data Section Includes job family data in the integration output
Fields document.
Core Connector: Job Profile Data Section Includes job profile data in the integration output
Fields document.
3. As a related action on your Core Connector: Job Profile and Job Family integration, select Integration
System > Configure Integration Attributes and enter attributes required by the integration template.
4. Select Integration System > Configure Integration Maps as a related action on the integration
system and map values between Workday and the external file format.
5. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Job Information
See: Steps: Grant Integration or External Endpoint Access to Workday.
6. Select and Set Up Connector Output Fields on page 1864.
7. Set Up Integration Delivery on page 1839.
8. Set Up Integration Sequence Generators on page 1856.
9. (Optional) Steps: Set Up Document Transformation Connector on page 571.
10.Launch an Integration on page 23.

Concept: Core Connector: Job Profile and Job Family


With Core Connector: Job Profile and Job Family, you can extract job-related definitions, transform the
data, and send it to an endpoint of your choice. The integration provides tools to capture changes to job
profile and job family data and configure an output file to deliver to an external endpoint.
The Core Connector: Job Profile and Job Family integration provides a single source-of-truth for core
data. It generates integration output files that you can transform as required to serve the needs of multiple
downstream endpoints. Because your needs vary based on organization size, privacy requirements, and
external endpoint requirements, the Core Connector: Job Profile and Job Family integration offers a choice
of implementation options.
Depending on the requirements of your external endpoint, you might need to transform the file into the
format that it supports using one of these options:
• Transformation step on the business process. You configure the business process definition for the
integration to transform the output file into the format required.
• Workday Studio integration. You configure the business process definition for the integration to launch
a Workday Studio integration. The Studio integration then transforms the output file into the format
required.
• Other third-party tool. You configure a third-party tool to transform the output file.
Core Connector: Job Profile and Job Family is an integration template with a configurable set of data
across a range of categories. It enables you to specify which data elements to include in integration output
files. When launched, the integration collects a snapshot of all data and creates an output file in XML
format based on your specifications.
The Core Connector: Job Profile and Job Family integration creates integration output files in a Workday-
defined XML format. You can configure this output for delivery, or further transformation.
Using Core Connector: Job Profile and Job Family in combination with Core Connector: Worker, you can
create a single source-of-truth for all external endpoints that need Workday data. By creating a single set of
Connectors, you can provide a rapid, flexible, and repeatable method for integrating with Workday. Using
this Connector you can ensure that all external endpoints receive only the data that you want to expose.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1070

Launch/Schedule Options
Workday provides these launch schedule options for Core Connector: Job Profile and Job Family:
• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member or have an organization role.
• Organization By Type displays if the Integration Process Event for this integration has no associated
organization. You can select any organization and subordinate organization of which you’re a
member or have an organization role.
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Worker integration to run several times per day;
launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers.
Workday prompts you for launch parameters.
For each launch schedule option, you enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the specified
Successful As Of Entry Moment, Last As Of Entry Moment and Effective Date
Successful Effective Date parameters. If Full Extract isn’t selected, then
the extract includes only records that changed
in one or more output fields. Workday compares
current records with what was current as of the
Last Successful As Of Entry Moment and Last
Successful Effective Date parameters.
Full Extract Extracts Job Profiles and Job Families as of the As
Of Entry Moment and Effective Date, regardless
of whether they’ve changed.
Job Families Extracts only the specified Job Families.
Job Profiles Extracts only the specified Job Profiles.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration. Workday generates this file every time the integration
runs. The file reflects your integration configuration as of the moment that the integration ran. You can
only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can’t have access to the data.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1071

Reference: Core Connector: Job Profile and Job Family Data Sections
Before you build an integration with the Core Connector: Job Profile and Job Family template, familiarize
yourself with each data section to understand which fields are available for output and how the
configuration options affect integration behavior.
During integration configuration, you enable integration services for each data section that you want to
include in integration output documents.

Section Description Fields


Job Family Data This section can have multiple records. • Job Family ID
• Inactive
• Job Family Name
• Job Family Summary
• Job Profile

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1072

Section Description Fields


Job Profile Data This section can have multiple records. • Job Profile ID
• Inactive
• Job Title
• Job Profile Summary
• Public Job
• Work Shift Required
• Management Level
• Job Category
• Job Level
• Job Family
• Job Classifications
• Job Exempt Location Context
• Job Exempt
• Compensation Grade
• Company Insider Type
• Critical Job
• Difficulty to Fill
• Pay Rate Country
• Pay Rate Type
• Workers Compensation Code
• Responsibility Description
• Responsibility Required
• Work Experience
• Work Experience Rating
• Work Experience Required
• Education Degree
• Education Field of Study
• Education Required
• Language
• Language Ability Type
• Language Proficiency Type
• Language Required
• Competency
• Certification
• Certification Country
• Certification Name
• Certification Issuer
• Proficiency Rating
• Training Name
• Training Description
• Training Type
• Training Required

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1073

Core Connector: Job Requisitions

Steps: Set Up Core Connector: Job Requisitions Integration

Context
To export changes to job requisition data, create a Core Connector: Job Requisitions integration.

Steps
1. Access the Create Integration System task and enter Core Connector: Job Requisitions at the New
Using Template prompt.
Security: Integration Build in the Integration functional area.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including services that are required; those integration services aren’t
editable.
Option Description
HiredScore Effective Data Fields Provides Role Assignment data for the Job
Requisition. (For HiredScore users only)
Job Qualification Data Section Fields Provides job qualifications data for each job
requisition.
Position Data Section Fields Provides position data for the job requisition.
Transaction Log Service Enables your integration system to subscribe to
events that take place in Workday. Reports only
changed fields for job requisitions, rather than all
fields.
If disabled, your integration first extracts all data
for eligible records, then evaluates the data for
changes. Using this option can adversely affect
performance.

Job Requisition Init Svc Specifies these attributes on the integration


system:
• Integration attributes
• The integrations maps
• The launch parameters (non-date launch
parameters)
• The toggleable routing strategy

Date Launch Parameters Specifies the:


• As-of-entry moment from which to begin
processing entries into Workday.
• Effective date when entries became effective
in Workday.
• Date of the last successful integration event
since the as-of-entry moment.
• Date of the last successful integration since
the effective date.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1074

Option Description
Job Requisition Data Section Fields Provides job requisition data for each job
requisition.
Job Qualification Data Section Fields Provides job qualification data for each job
requisition.
Job Requisitions Delivery Service Enables the delivery of integration documents to
an endpoint. Example: An SFTP endpoint.
Filename Sequence Generator Outputs filenames in sequence to prevent
overriding existing files. Example: Filename1,
Filename2.
Integration Document Retention Retains all of the integration documents.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Job Requisition Data
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. (Optional) As a related action on the integration system, select Integration System > Configure
Integration Transaction Log.
Configure the integration to subscribe to Workday events that might trigger the need to send an update
to the external endpoint. This step is required only if you enabled the Transaction Log Service.
5. Set Up Integration Sequence Generators on page 1856.
Specify how Workday applies a unique name to each integration output document.
6. Set Up Core Connector: Job Requisitions Integration Attributes and Maps on page 1074.
7. Select and Set Up Connector Output Fields on page 1864.
Select fields for the output file and enable data validations.
8. (Optional) Add Custom Fields to Connector Output on page 1865.
Configure custom fields for the output file.
9. Set Up Integration Delivery on page 1839.
Specify how and where to deliver the integration output files.
10.Define how Workday transforms integration output documents using XSLT.
See: Steps: Set Up Document Transformation Connector on page 571.
11.Launch an Integration on page 23.
Schedule how often you want Workday to launch the integration.

Set Up Core Connector: Job Requisitions Integration Attributes and Maps

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Steps
1. As a related action on your Core Connector: Job Requisitions integration, select Integration System >
Configure Integration Attributes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1075

2. Enter attribute values for enabled integration services:


Option Description
Country Code Type Specifies which Country Code type (ISO-3166-1-
Alpha-2, ISO-3166-1-Alpha-3) to include in the
output file.
Output Document Tags Select one or more Document Tags to apply to
each integration output document.
Required Field Validation Applies additional validation rules that identify
errors that can occur when exporting data, and
specifies error handling:
• Omit: the integration doesn't include records
with errors in the output file.
• Include: the integration includes records with
errors in the output file; warning displays in the
Integration Event for the integration run.

Include Prior Values Includes prior values with the current value of
each field.
Format Line Breaks For HTML - Job Replaces any line breaks in the Job Description
Description Summary Summary field with an HTML <\br> line break tag.
Include Non-Recruitable Job Requisitions Includes Job Requisitions that Workday doesn't
consider available for recruiting.
Document Retention Policy Enter the number of days that Workday preserves
output files.

Concept: Core Connector: Job Requisitions


The Core Connector: Job Requisitions integration can export job requisition changes from Workday in
simple XML format. As you create, update, or delete job requisition data, the integration generates an
output file containing the changes.
The integration includes a configurable set of job requisition data across a range of categories. You can
specify which data sections to include in the output file. Each section provides a set of fields. You can
select which fields to include or exclude, which fields you want to require, and which fields you want to
truncate.
Use this Connector to send data on open, closed, and future positions. Don't use this Connector to track
changes to a worker in a position. This Connector doesn't support evergreen job requisitions.

Change Detection
The Core Connector: Job Requisitions detects changes to job requisitions by monitoring a transaction
log. When you configure the integration system, you select which business process and transaction types
that the integration system subscribes to. Excluding business process and transaction types that are
irrelevant to your needs improves performance. However, if your integration system doesn’t subscribe to a
transaction type that affects your job requisition records, Workday wouldn’t include changes triggered by
that transaction type. Workday recommends that if you aren’t sure if the integration system must subscribe
to a given transaction or business process type, don’t exclude it.
The Core Connector: Job Requisitions integration uses a three-step process to detect and report changes:
1. The integration checks the transaction log. It determines which job requisitions have changes that
resulted in the generation of at least one of the configured transaction events.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1076

2. For each job requisition with a matching transactional change, the integration compares values:
• For the time at which the integration was run
• Time at which it was last successfully run
It identifies which, if any, of the values of interest have changed.
3. If the job requisition has any changes in field values, Workday generates an appropriate creation,
change, or deletion message.

Full-Diff Extract
You can configure your Core Connector: Job Requisitions integration to select all job requisitions, then
determine changes for the returned data. To enable this option, disable the Transaction Log service. When
you run the integration, Workday extracts all applicable data for all job requisitions. The integration extracts
all data regardless of whether the job requisition had any changes since the last successful integration
system run. Using this option can adversely affect Workday performance. Core Connector: Job Requisition
integration first selects all positions, and only then, determines changes for the returned data.

Launch/Schedule Options
Workday provides these launch schedule options for the Core Connector: Job Requisitions integration:
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Job Requisitions integration to run several times per
day; launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually. Workday prompts you to enter launch parameters.
For each launch schedule option, you can enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the specified
Successful As Of Entry Moment, Last As Of Entry Moment and Effective Date
Successful Effective Date parameters. If Full Extract isn’t selected, then
the extract includes only those records that have
changed in one or more output fields. Workday
compares current values as of the Last Successful
As Of Entry Moment and Last Successful
Effective Date parameters.
Full Extract Extracts Job Requisitions as of the As Of Entry
Moment and Effective Date, regardless of whether
they’ve changed.
Job Requisition(s) Extracts only the specified Job Requisitions.
Location(s) Extracts Job Requisitions for only the specified
Locations. Filtering is based on both Primary and/or
Additional values tagged on the Job Requisition.
Supervisory Organization(s) Extracts Job Requisitions for only the specified
Supervisory Organizations.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1077

• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration system. Workday generates this file every time the
integration runs. The file reflects your integration configuration as of the moment that the integration
ran. You can only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can't have access to the data.
Related Information
Concepts
Setup Considerations: Job Requisitions for Recruiting

Reference: Core Connector: Job Requisitions Integration Data Sections


Before you build an integration with the Core Connector: Job Requisitions template, familiarize yourself
with each data section to understand which fields are available for output and how the configuration
options affect integration behavior.
During integration configuration, you enable integration services for each data section that you want to
include in the output file.

Section Description Fields


Job Requisition This section can have one or more records. • Job Requisition ID
Data • Job Requisition Status
• Supervisory Organization
• Job Posting Title
• Positions Allocated
• Positions Available
• Available for Recruiting
• Replacement for Worker
• Job Description
• Job Description Summary
• Justification
• Recruiting Instruction
• Do Not Send To Recruiting
System
• Recruiting Start Date
• Target Hire Date
• Target End Date
• Job Profile
• Worker Type
• Worker Subtype
• Primary Location
• Additional Location
• Time Type
• Scheduled Weekly Hours
• Work Shift

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1078

Section Description Fields


Job Qualification These attributes do not send data directly but • Competency Qualification
Data activate the attributes with the same prefix: • Competency Qualification /
• Competency Qualification Competency
• Certification Qualification • Competency Qualification /
Competency Level
• Education Qualification
• Competency Qualification /
• Language Qualification
Competency Required
• Responsibility Qualification
• Certification Qualification
• Training Qualification
• Certification Qualification /
• Work Experience Qualification Certification
Example: Enabling Language Qualification • Certification Qualification /
allows the use of these related field attributes: Certification Country
• Language • Certification Qualification /
Certification Name
• Language Ability Type
• Certification Qualification /
• Language Proficiency Type
Certification Issuer
• Language Required
• Certification Qualification /
Certification Required
• Education Qualification
• Education Qualification /
Education Degree
• Education Qualification /
Education Field of Study
• Education Qualification /
Education Required
• Language Qualification
• Language Qualification /
Language
• Language Qualification /
Language Ability Type
• Language Qualification /
Language Proficiency Type
• Language Qualification /
Language Required
• Responsibility Qualification
• Responsibility Qualification /
Responsibility Description
• Responsibility Qualification /
Responsibility Required
• Training Qualification
• Training Qualification /
Training Name
• Training Qualification /
Training Description
• Training Qualification /
Training Type
• Training Qualification /
Training Required
• Work Experience Qualification
• Work Experience
Qualification / Work
Experience
• Work Experience
Qualification / Work
©2025 Workday, Inc. All rights reserved Workday Rating
Proprietary and Confidential
Experience
| HCM Connectors | 1079

Section Description Fields


Position Data This section has a single record, with primary • Position ID
position only. • Is Closed

HiredScore Data This section can have one or more records. • Role Assignment Reference
• Effective Date
• Role
• Role Reference
• Role Assignee
• Role Assignee Reference
• Worker
• Worker Reference

Core Connector: LMS Outbound

Steps: Set Up Core Connector: Worker for LMS Outbound Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To export changes to worker data, create a Core Connector: Worker for LMS Outbound integration.

Steps
1. Access the Create Integration System task and enter Core Connector: LMS Outbound in the New
using Template prompt.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
Core Connector: Organization Outbound Enables the integration system to deliver
Integration Configuration organization data to an external LMS.
Core Connector: Organization Data Section Provides organization data fields.
Fields
The Core Connector: Organization Outbound
Integration Configuration service must be enabled
to enable this service.

Core Connector: Organization Filename Applies a custom-formatted, unique filename to


Sequence Generator each integration file.
The Core Connector: Organization Outbound
Integration Configuration service must be enabled
to enable this service.

Core Connector: Organization Transaction Enables your integration system to subscribe to


Log Service events that take place in Workday. This action
enables your integration to report changed fields
for workers, rather than report all fields.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1080

Option Description
If disabled, your integration first extracts all data
for eligible records, then evaluates the data for
changes. Using this option can adversely affect
performance.
The Core Connector: Organization Outbound
Integration Configuration service must be enabled
to enable this service.

Define Organization Eligibility Enables you to configure an Integration Field


Override to define which organizations to include
in the integration output.
The Core Connector: Organization Outbound
Integration Configuration service must be enabled
to enable this service.

Core Connector: Location Integration Enables the integration system to deliver location
Configuration data to an external LMS.
Core Connector: Location Data Section Fields Provides location data fields.
The Core Connector: Location Integration
Configuration service must be enabled to enable
this service.

Core Connector: Location Filename Sequence Enable if you want Workday to apply a custom-
Generator formatted, unique filename to each integration file.
The Core Connector: Location Integration
Configuration service must be enabled to enable
this service.

Core Connector: Competencies Outbound Enables the integration system to deliver


Integration Configuration competency data to an external LMS.
Core Connector: Competency Data Section Provides competency data fields.
Fields
The Core Connector: Competencies Outbound
Integration Configuration service must be enabled
to enable this service.

Core Connector: Competencies Outbound Enable if you want Workday to apply a custom-
Filename Sequence Generator formatted, unique filename to each integration file.
The Core Connector: Competencies Outbound
Integration Configuration service must be enabled
to enable this service.

Core Connector: Job Profile and Job Family Enables the integration system to deliver job
Integration Configuration profile and job family data to an external LMS.
Core Connector: Job Profile Data Section Provides Job Profile data fields.
Fields
The Core Connector: Job Profile and Job Family
Integration Configuration service must be enabled
to enable this service.

Core Connector: Job Family Data Section Provides Job Family data fields.
Fields

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1081

Option Description
The Core Connector: Job Profile and Job Family
Integration Configuration service must be enabled
to enable this service.

Core Connector: Job Profile and Job Family Enable if you want Workday to apply a custom-
Filename Sequence Generator formatted, unique filename to each integration file.
The Core Connector: Job Profile and Job Family
Integration Configuration service must be enabled
to enable this service.

Core Connector: Worker Integration Enables the integration system to deliver worker
Configuration data to an external LMS.
Worker Personal Data Section Fields Provides employee personal data and contact
information.
The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Worker Status Data Section Fields Provides employment status and service dates.
The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Worker Position Data Section Fields Provides:


• Job profile data.
• Organization membership data.
• Salary and base compensation elements.
The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Worker Contract Data Section Fields Provides employment contract data.


The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Worker Leave of Absence Data Section Fields Provides leave of absence data.
The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Worker Qualification Data Section Fields Provides qualifications data for each worker.
The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Core Connector: Worker Transaction Log Subscribes to events that take place in Workday
Service enabling your integration to report only worker
fields that changed.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1082

Option Description
If disabled, your integration first extracts all data
for eligible records, then evaluates the data for
changes. Using this option can adversely affect
performance.
The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Define Eligibility Enables you to configure an Integration Field


Override to define which workers to include in the
integration output.
The Core Connector: Worker Integration
Configuration service must be enabled to enable
this service.

Core Connector: Integration Maps - Enables you to define integration maps that
Foundation translate foundational data values between
Workday and your LMS.
To enable this service, enable one of the
integration configuration services.

Core Connector: Integration Maps - Job Enables you to define integration maps that
translate job profile and Job Family data values
between Workday and your LMS.
To enable this service, enable one of the
integration configuration services.

Core Connector: Integration Maps - Talent Enables you to define integration maps that
translate talent data values between Workday and
your LMS.
To enable this service, enable one of the
integration configuration services.

Core Connector: Integration Maps - Worker Enables you to define integration maps that
translate worker data values between Workday
and your LMS.
To enable this service, enable one of the
integration configuration services.

3. As a related action on your integration, select Integration System > Configure Integration
Transaction Log.
Note: We recommend that you select Subscribe to all Transaction Types except. Then, filter out
only transaction types that you know have no relevance to your needs. If in doubt, don't filter out a
transaction type.
4. Set Up Integration Sequence Generators on page 1856.
5. As a related action on your Core Connector: Worker integration, select Integration System >
Configure Integration Attributes and enter attributes for integration services that you enabled in Step
4, as well as required attributes.
6. Select Integration System > Configure Integration Maps as a related action on the integration
system. Map values between Workday and the external file format.
7. Create Core Connector: Worker for LMS Outbound Worker Selection Criteria on page 1083.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1083

8. Select and Set Up Connector Output Fields on page 1864.


9. Create Integration Business Process on page 1838.
10.Steps: Set Up Document Transformation Connector on page 571.
11.Launch an Integration on page 23.
12.Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Job Information
• Manage: Location
• Manage: Organization Integration
• Person Data: Birth Place
• Person Data: Citizenship Status
• Person Data: Date of Birth
• Person Data: Disabilities
• Person Data: Emergency Contacts
• Person Data: Ethnicity
• Person Data: Gender
• Person Data: Home Contact Information
• Person Data: Hukou (China)
• Person Data: ID Information
• Person Data: Marital Status
• Person Data: Military Status
• Person Data: Name
• Person Data: Nationalities
• Person Data: Personal Data
• Person Data: Personal Information
• Person Data: Preferred Name
• Person Data: Religion
• Set Up: Skills and Experience
• Worker Data: Beneficiaries and Dependents
• Worker Data: Benefit Elections
• Worker Data: Compensation
• Worker Data: Compensation by Organization
• Worker Data: Leave of Absence
• Worker Data: Organization Information
• Worker Data: Public Worker Reports
• Worker Data: Staffing
• Worker Data: Total Compensation
• Worker Data: Work Contact Information
See: Steps: Grant Integration or External Endpoint Access to Workday.

Create Core Connector: Worker for LMS Outbound Worker Selection Criteria

Prerequisites
Security: Custom Field Management domain in the System functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1084

Context
Select a report field or create a calculated field that defines the eligibility criteria for sending workers.
Configure the field as an override in the Core Connector: LMS Outbound integration so that workers who
meet the specified criteria are included in the integration.

Steps
1. If an existing report field doesn’t provide the criteria you want, create a calculated field for worker
selection:
a) Access the Create Calculated Field task.
b) Specify a meaningful Field Name. Example: LMS Outbound Worker Eligibility.
c) At the Business Object prompt, select Worker.
d) At the Function prompt, select True/False Condition.
e) On the Calculation tab, specify one or more conditions for worker selection.
To select workers from specific supervisory organizations, but not all organizations, your selection
criteria can look like:

And/Or ( Field Operator Comparison Comparison )


Type Value
And Supervisory in the Value Human
Organization selection list specified in Resources
this filter
Information
Technology
Payroll
f) (Optional) Click the Additional Info tab, click the Category prompt, and select Integration.
Categorizing a calculated field makes it easier to find.
2. Configure the field override in the integration:
a) Access the View Integration System report.
b) As a related action on the integration system, select Integration System > Configure Integration
Field Overrides.
c) For the Define Eligibility document, click the Override External Field prompt and select the report
field or calculated field that determines eligibility.
3. To create overrides for worker domains, roles, statuses, status descriptions, or custom fields, repeat
these steps.

Concept: Core Connector: Worker for LMS Outbound Integration


The Core Connector: Worker for LMS Outbound integration exports worker, job, talent, location, and
organization data changes from Workday in simple XML format. As you update Workday data, the
integration generates an XML file containing the changes and exports it to your Learning Management
System (LMS).
Using configurable data sections or Workday-delivered report fields and calculated fields that you create,
you can customize the output to meet the needs of your LMS.

Change Detection
The Core Connector: Worker for LMS Outbound detects changes to Workday data by monitoring a
transaction log. When you configure the integration system, you select which business process and
transaction types that the integration system subscribes to. Excluding business process and transaction
types that are irrelevant to your needs improves performance. However, if your integration system doesn’t
subscribe to a transaction type that affects data in your LMS, Workday wouldn’t include changes triggered

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1085

by that transaction type. Workday recommends that if you aren’t sure if the integration system must
subscribe to a given transaction or business process type, don’t exclude it.
The Core Connector: Worker for LMS Outbound integration uses a three-step process to detect and report
changes:
1. When the integration checks the transaction log, the integration determines which workers have
changes that generated a configured transaction event.
2. For each worker with a matching transactional change, the integration compares their report fields:
• For the time at which the integration was run
• For the time at which the integration was last successfully run
The integration identifies which, if any, of the values of interest have changed.
3. If the worker has any changes in field values or eligibility, Workday generates an appropriate creation,
change, or deletion message.

Change Detection Limitations


Changes to the Classification of a Job don’t trigger change detection for this integration. The context of
the change is on the Job Profile (template), and isn’t directly related to any associated job (instance) for a
worker. However, full extraction includes the job classification element.

Full-Diff Extract
You can configure your Core Connector: Worker for LMS Outbound integration to all workers who meet the
eligibility criteria. To enable this option, disable the Transaction Log service. When you run the integration,
Workday extracts all applicable data for the defined population of employees. Workday extracts data
regardless of whether the worker had any changes since the last successful integration system run. Using
this option can adversely affect Workday performance.

Worker Eligibility
For each integration system, you define a group of workers that belongs to the integration system. You
define membership by a single Boolean report field or calculated field. If the field value is true for a worker,
that worker is a member of the group, and Workday includes changes for that worker in the output file. If
the field value is false, the integration system ignores that worker.
You can use report fields on the Worker business object to define eligibility. If you can't define your group
membership criteria using a report field, you can create and use a calculated field. If multiple Boolean
values are true, the calculated field can evaluate the worker business object and its related business
objects to return true. Example: use a calculated field to return true if the:
• Worker is a contingent employee
• Primary location for the worker is in the United States
• Supervisor of the worker is John Doe

Launch/Schedule Options
Workday provides these launch schedule options for the Core Connector: Worker for LMS Outbound
integration:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1086

• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member or have an organization role.
• Organization By Type displays if the Integration Process Event for this integration has no associated
organization. You can select any organization and subordinate organization of which you’re a
member or have an organization role.
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Worker for LMS Outbound integration to run several
times per day; launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers.
Workday prompts you to enter launch parameters.
For each launch schedule option, you can enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the specified
Successful As Of Entry Moment, Last As Of Entry Moment and Effective Date
Successful Effective Date parameters. If Full File isn’t selected, then the
extract includes only those records that changed
in one or more output fields. Workday compares
values current as of the Last Successful As Of
Entry Moment and Last Successful Effective
Date parameters.
Full Extract for Job Profiles/Job Families, Extracts selected items as of the As Of Entry
Locations, and Organizations Moment and Effective Date, regardless of whether
they’ve changed.
Full File Extracts Workers as of the As Of Entry Moment
and Effective Date, regardless of whether they’ve
changed.
Job Families Extracts only the specified Job Families.
Job Profiles Extracts only the specified Job Profiles.
Location(s) Extracts only the specified Locations.
Organization Type Extracts Organizations for only the specified
Organization Types.
Organization(s) Extracts only the specified Organizations.
Restrict Results By Orgs Extracts Workers for only the specified
Organizations and all subordinates.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1087

Parameter Description
Workers Extracts only the specified Workers.
If you configure no values, then the integration
considers all workers when looking for transactional
and data changes. Specifying workers in this
list doesn’t force their inclusion in the output file.
Information for a worker displays in the output
file only if there are changes in the data fields
evaluated by the integration.
If there was an error involving data for one or more
workers during a prior integration run, you can
specify workers in this parameter at launch time.
Correct the worker data and then run the integration
system again only for those workers. In this case,
set the Last Successful As Of Entry Moment to the
moment used for that parameter on the prior run
that had problems.

Integration Output Files


The Core Connector: Worker for LMS Outbound integration can generate and deliver up to 5 configurable
outputs, depending on which integration services you enable. Workday includes each configurable output
in a separate integration output file that Workday generates each time the integration runs. To enable
you to identify which output files include a specific configurable output, Workday applies one of the
corresponding document tags to each output file:
• Core Connector: Organization Outbound
• Core Connector: Locations
• Core Connector: Competencies Outbound
• Core Connector: Job Profile and Job Family
• Core Connector: Worker
Workday applies these document tags automatically. You can’t disable or edit the names of these
document tags. You can apply additional document tags to the output files.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration system. Workday generates this file every time the
integration runs. The file reflects your integration configuration as of the moment that the integration
ran. You can only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can’t have access to the data.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1088

Reference: Core Connector: Worker for LMS Outbound Integration Data Sections
Before you build an integration with the Core Connector: Worker for LMS Outbound template, familiarize
yourself with each data section to understand which fields are available for output and how the
configuration options affect integration behavior.
During integration configuration, you enable integration services for each data section that you want to
include in the output file.
Some sections also have an Operation field that indicates whether a row of data is new, changed, or
deleted. Operation codes are: ADD, REMOVE, MODIFY, or NONE.

Section Description Fields


Core Connector: This section can have multiple records. • Organization ID
Organization Data • Organization Code
• Organization Type
• Organization Name
• Organization Description
• Organization Subtype
• Inactive
• Manager
• Organization Owner
• Superior Organization
• Primary Business Site
Reference

Core Connector: This section can have multiple records. • Location


Location Data • Location Name
• Location Usage
• Location Type
• Inactive
• Time zone
• Default Currency
• Default Currency Code
• Country
• Address Line Data
• Municipality
• Country Region
• Country Region Description
• Postal Code
• Is Primary Address
• Address Usage
• International Phone Code
• Area Code
• Phone Number
• Phone Device Type
• Phone Usage
• Email Address
• Email Usage

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1089

Section Description Fields


Core Connector: • This section can have one or more • Competency ID
Competency Data records. • Competency Name
• The Competency Level attribute doesn’t • Competency Description
send data, but enables the attributes with • Competency Category
the same attribute prefix. Example: enable • Competency Level
Competency Level in order to use the
• Competency Level /
Competency Level, Competency Rating,
Competency Level ID
and Competency Behavior field attributes.
• Competency Level /
Competency Level Name
• Competency Level /
Competency Level Behavior
• Competency Level /
Competency Level Value
• Competency Level /
Competency Level Range Begin
• Competency Level /
Competency Level Range End
• Competency Level /
Competency Level Exclude from
Calculations
• Inactive

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1090

Section Description Fields


Core Connector: This section can have multiple records. • Job Profile ID
Job Profile Data • Inactive
• Job Title
• Job Profile Summary
• Public Job
• Work Shift Required
• Management Level
• Job Category
• Job Level
• Job Family
• Job Classifications
• Job Exempt Location Context
• Job Exempt
• Compensation Grade
• Company Insider Type
• Critical Job
• Difficulty to Fill
• Pay Rate Country
• Pay Rate Type
• Workers Compensation Code
• Responsibility Description
• Responsibility Required
• Work Experience
• Work Experience Rating
• Work Experience Required
• Education Degree
• Education Field of Study
• Education Required
• Language
• Language Ability Type
• Language Proficiency Type
• Language Required
• Competency
• Competency Level
• Competency Required
• Certification
• Certification Country
• Certification Name
• Certification Issuer
• Certification Required
• Training Name
• Training Description
• Training Type
• Training Required

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1091

Section Description Fields


Core Connector: This section can have multiple records. • Job Family ID
Job Family Data • Inactive
• Job Family Name
• Job Family Summary
• Job Profile

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1092

Section Description Fields


Worker Personal • This section has a single record. • Name Data
Data • If not overridden, name fields are based on • Name Data / Name Type
Legal Name. • Name Data / First Name
• The Name Data, Address Data, Phone • Name Data / Middle Name
Data, and Email Data attributes don’t send • Name Data / Last Name
data. They enable the attributes with the • Name Data / Secondary Last
same attribute prefix. Example: enable Name
Email in order to use the Email Usage,
• Name Data / Title
Email is Public, and Email Address field
attributes. • Name Data / Social Suffix
• Name Data / Title is the Prefix of the name • Name Data / Formatted Name
and Name Data / Social Suffix is the Suffix • Name Data / Reporting Name
of the name. • Name Data / First Name in Local
• Country of Birth is a two-digit country code Script
based on ISO 3166-1 alpha-2. • Name Data / Middle Name in
Local Script
• Name Data / Last Name in Local
Script
• Name Data / Secondary Last
Name in Local Script
• Name Data / Name in Local
Script
• Name Data / First Name in Local
Script 2
• Name Data / Middle Name in
Local Script 2
• Name Data / Last Name in Local
Script 2
• Name Data / Secondary Last
Name in Local Script 2
• Name Data / Full Legal Name
• Gender
• Disability
• Address Data
• Address Data / Address Type
• Address Data / Address Usage
• Address Data / Address Is
Public
• Address Data / Is Primary
• Address Data / Address Line
Data
• Address Data / Municipality
• Address Data / Submunicipality
• Address Data / Region
• Address Data / Subregion
• Address Data / Postal Code
• Address Data / Country
• Address Data / Address Line
Data Local
• Address Data / Municipality
Local
• Address Data / Submunicipality
Local
• Address Data / Subregion Local
©2025 Workday, Inc. All rights reserved Workday
• Phone Data Proprietary and Confidential
| HCM Connectors | 1093

Section Description Fields


Worker Status Data • Staffing Event codes are: • Staffing Event
• HIR (hire). • Staffing Event Date
• TRM (termination). • Employee Status
• LOA (leave of absence). • Active
• RFL (return from leave). • Active Status Date
• TFR (change of the supervisory • Hire Date
organization of the worker). • Original Hire Date
• End Employment Date
Note: TFR staffing events don't populate
• Continuous Service Date
the Staffing Event Date field.
• First Day of Work
• Employee Status codes are: Active,
OnLeave, Terminated, and NotYetHired. • Terminated
• Termination Date
• Pay Through Date
• Termination Last Day of Work
• Probation Start Date
• Probation End Date
• Has International Assignment
• Home Country
• Host Country
• Rehire

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1094

Section Description Fields


Worker Position • This section has a single record, with • Operation
Data primary position only. • Position ID
• Effective Date represents the effective • Effective Date
date for the most recent change to position • Primary Position
data. • Position Title
• A position can have a number of job • Business Title
classifications that you arrange according
• Worker Type
to job classification groups.
• Position Time Type
• Job Exempt
• Pay Rate Type
• Job Classification Data
• Job Classification Data/
Operation
• Job Classification Data / Job
Classification
• Job Classification Data / Job
Classification Group
• Organization Data
• Organization Data/Operation
• Organization Data /
Organization
• Organization Data /
Organization Type
• Company Insider Type
• Work Shift
• Job Profile
• Management Level
• Job Category
• Job Family
• Business Site
• Business Site Name
• Business Site Address Type
• Business Site Address Line
Data
• Business Site Municipality
• Business Site Submunicipality
• Business Site Region
• Business Site Subregion
• Business Site Postal Code
• Business Site Country
• Business Site Address Line
Data Local
• Business Site Municipality Local
• Business Site Submunicipality
Local
• Business Site Subregion Local
• Supervisor ID
• Supervisor Name

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1095

Section Description Fields


Worker Contract • This section can have multiple records. • Operation
Data • Although an employee has only 1 contract • Position ID
in effect at a time, this section can include: • Contract ID
• Contracts from the past. • Contract Type
• Contracts that become effective in the • Start Date
future. • End Date
• Contract Status
• Description

Worker Leave of This section contains position-specific data. • Operation


Absence Data • Position ID
• This section can have multiple records.
• An employee can be on multiple different • On Leave
types of leave at the same time. • Leave Start Date
• These fields in the Status Data section • Leave End Date
indicate if an employee is on leave: • Leave of Absence Type
• Employee Status
• Staffing Event
• Staffing Event Date
Enable the Leave of Absence section if
you need additional information about
leave.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1096

Section Description Fields


Worker • This section has a single record. • Competency Achievement
Qualification Data • The Competency Achievement, • Competency Achievement /
Certification Achievement, Training, Operation
Education, and External Job attributes • Competency Achievement /
don’t send data. They enable the attributes Competency Achievement ID
with the same attribute prefix. Example: • Competency Achievement /
enable Education in order to use the Competency
Last Year Attended or Field of Study field • Competency Achievement /
attributes. Competency Level
• Competency Achievement /
Assessment Date
• Competency Achievement /
Assessed by Worker
• Certification Achievement
• Certification Achievement /
Operation
• Certification Achievement /
Certification Achievement ID
• Certification Achievement /
Certification
• Certification Achievement /
Certification Country
• Certification Achievement /
Certification Name
• Certification Achievement /
Certification Issuer
• Certification Achievement /
Issued Date
• Certification Achievement /
Expiration Date
• Certification Achievement /
Exam Date
• Certification Achievement /
Exam Score
• Training
• Training / Operation
• Training / Training Achievement
ID
• Training / Training Name
• Training / Training Description
• Training / Training Type
• Training / Training Duration
• Training / Completion Date
• Education
• Education / Operation
• Education / Education
Achievement ID
• Education / Institution
• Education / Institution Name
• Education / Institution Type
• Education / Institution Location
• Education / Institution Country
• Education / Degree
©2025 Workday, Inc. All rights reserved • Workday
Education Proprietary
/ Field and Confidential
of Study
| HCM Connectors | 1097

Core Connector: Location

Steps: Set Up Core Connector: Location Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To extract and export core location definitions to an external endpoint, you can create a Core Connector:
Location integration system.

Steps
1. Access the Create Integration System task and enter Core Connector: Locations in the New Using
Template prompt.
2. As a related action on your Core Connector: Locations integration, select Integration System >
Configure Integration Attributes and enter attributes required by the integration template.
3. Select Integration System > Configure Integration Maps as a related action on the integration
system and map values between Workday and the external file format.
4. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Manage: Location
See: Steps: Grant Integration or External Endpoint Access to Workday.
5. Select and Set Up Connector Output Fields on page 1864.
6. (Optional) Add Custom Fields to Core Connector: Location Integration on page 1097.
7. Set Up Integration Delivery on page 1839.
8. Set Up Integration Sequence Generators on page 1856.
9. (Optional) Steps: Set Up Document Transformation Connector on page 571.
10.Launch an Integration on page 23.

Add Custom Fields to Core Connector: Location Integration

Prerequisites
Security: Integration Configure, Integration Build Custom Services, and Integration Build domains in the
Integration functional area.

Context
Add an unlimited number of custom fields to a Core Connector: Location integration. You can use
calculated fields or report fields to incorporate additional data elements into your output files. You can use
any report field as long as it's available for:
• The Location business object.
• A business object that is directly related to the Location object.
The first step is to create an integration field override service and specify the names of the custom fields.
Then, enable the field override service in the integration and configure the override values. If necessary,
you can also create custom integration maps to define relationships between the custom fields and values
in the external endpoint.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1098

Steps
1. Create an integration field override service and define custom fields:
a) Access the Create Integration Field Override Service task.
b) Give the integration service a meaningful Name.
c) To select the data source for the custom fields, select the Business Object prompt.
d) For each custom field that you want to create, add a row to the Fields grid, enter the field Name,
and optionally provide a Description.
e) To reorder the fields as desired in the output file, use the Order arrows.
2. Access the View Integration System report.
3. Enable the custom integration service:
a) As a related action on the integration system, select Integration System > Configure Integration
Services.
b) In the Custom Integration Services grid, add a row.
c) Select the Integration Service prompt, select Integration Field Override Service (Audited), and then
select the custom integration service that you created in step 1.
4. Configure the custom fields:
a) As a related action on the integration system, select Integration System > Configure Integration
Field Overrides.
b) For each field in the grid, select the Override External Field prompt. Then select the report field or
calculated field that provides the value you want.
The Override External Field prompt lists fields that are relevant to the Business Object you
selected in step 1.

Result
Workday groups your custom fields into a record called ADD that displays on a separate line in the output
file. By default, Workday includes custom fields in output files only when field values change.

Next Steps
To add or change fields in an integration field override service, use one of these methods:
• Access the View Integration System report. Select Integration Field Override Service > Edit as a
related action on the integration service in the Custom Integration Services grid.
• Access the Edit Integration Field Override Service task.

Concept: Core Connector: Location


With Workday Core Connector: Location, you can extract location-related definitions, transform the data,
and send it to an endpoint of your choice. Using Workday business objects and Get Locations public API
as its foundation, Core Connector: Location provides the tools to capture changes to location data and
configure an output file to extract to deliver to an external endpoint.
Core Connector: Location provides a single source-of-truth for core data, and generates integration output
files that you can transform as required to serve the needs of multiple downstream endpoints. Because
your needs vary based on organization size, privacy requirements, and external endpoint requirements,
Core Connector: Location offer a choice of implementation options.
Depending on your external endpoint requirements, transform the file into the format that it supports using
one of these options:
• Transformation step on the business process. You configure the business process definition of the
integration to transform the Core Connector output file into the format required.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1099

• Workday Studio integration. You configure the business process definition of the integration to launch a
Workday Studio integration. The Studio integration then transforms the Core Connector output file into
the format required.
• Other third-party tool. You configure a third-party tool to transform the Core Connector output file.
Core Connector: Location is an integration template with a configurable set of data across a range of
categories. It enables you to specify which data elements to include in integration output files. When
launched, the integration collects a snapshot of all data and creates an output file in XML format based on
your specifications.
Core Connector: Location creates integration output files in a Workday-defined XML format. You can
configure this output for delivery, or further transformation.
Using Core Connector: Location in combination with Core Connector: Worker, you can create a single
source-of-truth for all external endpoints that need Workday data. By creating a single set of Connectors,
you can:
• Provide a rapid, flexible, and repeatable method for integrating with Workday.
• Ensure that all external endpoints receive only the data that you want to expose.

Launch/Schedule Options
Workday provides these launch schedule options for Core Connector: Location:
• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member or have an organization role.
• Organization By Type displays if the Integration Process Event for this integration has no associated
organization. You can select any organization and subordinate organization of which you’re a
member or have an organization role.
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Worker integration to run several times per day;
launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers.
You’re prompted to enter launch parameters.
For each launch schedule option, you enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the specified
Successful As Of Entry Moment, Last As Of Entry Moment and Effective Date
Successful Effective Date parameters. If Full Extract isn’t selected, then
the extract includes only those records that the
integration detects to have changed in one or more
output fields. Workday compares values to what
was current as of the Last Successful As Of Entry
Moment and Last Successful Effective Date
parameters.
Full Extract Extracts Locations as of the As Of Entry Moment
and Effective Date, regardless of whether they’ve
changed.
Location(s) Extracts only the specified Locations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1100

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration. Workday generates this file every time the integration
runs. The file reflects your integration configuration as of the moment that the integration ran. You can
only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can’t have access to the data.

Reference: Core Connector: Location Data Sections


Before you build an integration with the Core Connector: Location integration template, familiarize yourself
with each data section to understand which fields are available for output and how the configuration
options affect integration behavior.

Section Description Fields


Location Data This section can have multiple records. • Location
• Location Name
• Location Usage
• Location Type
• Inactive
• Time zone
• Default Currency
• Default Currency Code
• Country
• Address Line Data
• Municipality
• Country Region
• Country Region Description
• Postal Code
• Is Primary Address
• Address Usage
• International Phone Code
• Area Code
• Phone Number
• Phone Device Type
• Phone Usage
• Email Address
• Email Usage

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1101

Core Connector: Organization

Steps: Set Up Core Connector: Organization Integration

Prerequisites
Security: These domains in the Integration functional area:
• Integration Build
• Integration Configure

Context
To export core organization definitions to an external endpoint, create a Core Connector: Organization
integration.

Steps
1. Access the Create Integration System task and enter Core Connector: Organization Outbound in the
New Using Template prompt.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
Filename Sequence Generator Enable if you want Workday to apply a custom-
formatted, unique filename to each integration file.
Transaction Log Service Enables your integration system to subscribe
to events by only organizations that meet the
configured criteria (Example: organization type)
and had a transaction event. The subscription
to your integration system will be within the date
parameters range and will be extracted as of
the Effective Date and As Of Entry Moment
parameters. Your integration compares data in
the fields configured in your output file with the
data as of the Last Successful date parameters.
If the service detects any changes or it's a new
organization, the integration output will include the
organization.
The Transaction Log service doesn't save
changes to organization data such as
organization name and code. Disable the
Transaction Log service when you want your
integration to detect these types of changes.
Also, to improve performance and avoid
undetected changes, Workday recommends
that you disable the Transaction Log service
for the Get Organizations web service. The
Transaction Log service doesn't detect some
changes because event logs don't capture all
organization changes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1102

Option Description
Define Organization Eligibility Enables you to configure an Integration Field
Override to define organizations included in the
integration output.
3. As a related action on your Core Connector: Organization integration, select Integration System >
Configure Integration Attributes and enter attributes required by the integration template.
4. Select Integration System > Configure Integration Maps as a related action on the integration
system and map values between Workday and the external file format.
5. (Required if you enable Define Organization Eligibility service.) As a related action on your Core
Connector: Organization integration, select Integration System > Configure Integration Field
Overrides. Designate a report field or calculated field that identifies if an organization is or isn't eligible
for the integration.
Base the report field or calculated field on the organization business object, and it must return a
Boolean true or false. A Boolean true includes the organization in the integration while a Boolean false
excludes the organization.
6. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Manage: Organization Integration
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
7. Select and Set Up Connector Output Fields on page 1864.
8. Set Up Integration Delivery on page 1839.
9. Set Up Integration Sequence Generators on page 1856.
10.(Optional) Steps: Set Up Document Transformation Connector on page 571.
11.Launch an Integration on page 23.
Related Information
Concepts
SOAP API Troubleshooting and Guides

Concept: Core Connector: Organization


With Core Connector: Organization, you can extract organization-related definitions, transform the data,
and send it to an endpoint of your choice. Using Workday business objects and Get Organizations public
API as its foundation, Core Connector: Organization provides the tools to capture changes to organization
data and configure an output file to extract to deliver to an external endpoint.
Core Connector: Organization provides a single source-of-truth for core data, and generates integration
output files that you can transform as required to serve the needs of multiple downstream endpoints.
Because your needs vary based on organization size, privacy requirements, and external endpoint
requirements, Core Connector: Organization offer a choice of implementation options.
Depending on the requirements of your external endpoint, transform the file into the format that it supports
using one of these options:
• Transformation step on the business process. You configure the business process definition of the
integration to transform the Core Connector output file into the format required.
• Workday Studio integration. You configure the business process definition of the integration to launch
a Workday Studio integration. The Studio integration transforms the Core Connector output file into the
format required.
• Other third-party tool. You configure a third-party tool to transform the Core Connector output file.
Core Connector: Organization is an integration template with a configurable set of data across a range
of categories. Core Connector: Organization enables you to specify which data elements to include in

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1103

integration output files. When launched, the integration collects a snapshot of all data and creates an
output file in XML format based on your specifications.
Core Connector: Organization integration creates integration output files in a Workday-defined XML format.
You can configure this output for delivery, or further transformation.
Using Core Connector: Organization in combination with the Core Connector: Worker, you can create
a single source-of-truth for all external endpoints that need Workday data. By creating a single set of
Connectors, you can:
• Provide a rapid, flexible, and repeatable method for integrating with Workday.
• Ensure that all external endpoints receive only the data that you want to expose.

Launch/Schedule Options
Workday provides these launch schedule options for the Core Connector integrations:
• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member or have an organization role.
• Organization By Type displays if the Integration Process Event for this integration has no associated
organization. You can select any organization and subordinate organization of which you’re a
member or have an organization role.
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Worker integration to run several times per day;
launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers.
Workday prompts you to enter launch parameters.
For each launch schedule option, you enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the specified
Successful As Of Entry Moment, Last As Of Entry Moment and Effective Date
Successful Effective Date parameters. Compares values of fields configured
in your output file to what was current as of the
Last Successful As Of Entry Moment and Last
Successful Effective Date parameters. When
you disable the Transaction Log Service, Workday
does this compare for all organizations meeting the
configured criteria. Example: organization type.
Full Extract When True, the integration ignores the Transaction
Log Service and all organizations meeting the
configured criteria (Example: organization type)
are extracted as of the As Of Entry Moment and
Effective Date, regardless of whether they’ve
changed. This option is useful when you want to do
a full data sync to an external endpoint.
Organization Type Extracts Organizations for only the specified
Organization Types.
Organization(s) Extracts only the specified Organizations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1104

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration. Workday generates this file every time the integration
runs. The file reflects your integration configuration as of the moment that the integration ran. You can
only generate this file by running the integration.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can need to secure this
file separately. Example: if administrators can’t have access to the data).
Related Information
Concepts
SOAP API Troubleshooting and Guides

Reference: Core Connector: Organization Data Sections


Before you build an integration with the Core Connector: Organization integration template, familiarize
yourself with each data section to understand which fields are available for output and how the
configuration options affect integration behavior.

Section Description Fields


Organization Data This section can have multiple records. • Organization ID
(Core Connector: • Organization Code
Organization)
• Organization Type
• Organization Name
• Organization Description
• Organization Subtype
• Inactive
• Manager
• Leadership Role Assignee
• Organization Owner
• Superior Organization
• Primary Business Site
Reference

Core Connector: Positions

Steps: Set Up Core Connector: Positions Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To export changes to position data, create a Core Connector: Positions integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1105

Steps
1. Access the Create Integration System task and enter Core Connector: Positions from the New
Using Template prompt.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
Job Qualification Data Section Fields Provides job qualifications data for each position.
Job Requisition Data Section Fields Provides job requisition data for the position.
Filename Sequence Generator Applies a custom-formatted, unique filename to
each integration file.
Transaction Log Service Enables your integration system to subscribe to
events that take place in Workday. This action
enables your integration to report only changed
fields for positions, rather than report all fields.
If disabled, your integration first extracts all data
for eligible records, then evaluates the data for
changes. Using this option can adversely affect
performance.

3. As a related action on your Core Connector: Positions integration, select Integration System >
Configure Integration Transaction Log.
Select the Workday transactions that you want monitored for changes.
Note: Workday recommends that you select Subscribe to all Transaction Types except. Then, filter
out only transaction types that you know have no relevance to your needs. If in doubt, don't filter out a
transaction type.
4. As a related action on your Core Connector: Positions integration, select Integration System >
Configure Integration Attributes and enter attributes for integration services that you enabled in Step
2, as well as required attributes.
5. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Job Information
• Worker Data: All Positions
See: Steps: Grant Integration or External Endpoint Access to Workday.
6. Select and Set Up Connector Output Fields on page 1864.
7. (Optional) Add Custom Fields to Core Connector: Positions Integration on page 1105.
8. Create Integration Business Process on page 1838.
9. (Optional) Set Up Integration Sequence Generators on page 1856.
10.(Optional) Steps: Set Up Document Transformation Connector on page 571.
11.Launch an Integration on page 23.

Add Custom Fields to Core Connector: Positions Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1106

Context
Add an unlimited number of custom fields to a Core Connector: Positions integration. You can use
calculated fields or report fields to incorporate additional data elements into your output files. You can use
any report field as long as it's available for:
• The Position business object.
• A business object that is directly related to the Position object.
The first step is to create an integration field override service and specify the names of the custom fields.
Then, enable the field override service in the integration and configure the override values. If necessary,
you can also create custom integration maps to define relationships between the custom fields and values
in the external endpoint.

Steps
1. Create an integration field override service and define custom fields:
a) Access the Create Integration Field Override Service task.
b) Give the integration service a meaningful Name.
c) To select the data source for the custom fields, select the Business Object prompt.
d) For each custom field that you want to create, add a row to the Fields grid, enter the field Name,
and optionally provide a Description.
e) To reorder the fields as desired in the output file, use the Order arrows.
2. Access the View Integration System report.
3. Enable the custom integration service:
a) As a related action on the integration system, select Integration System > Configure Integration
Services.
b) In the Custom Integration Services grid, add a row.
c) Select the Integration Service prompt, select Integration Field Override Service (Audited), and then
select the custom integration service that you created in step 1.
4. Configure the custom fields:
a) As a related action on the integration system, select Integration System > Configure Integration
Field Overrides.
b) For each field in the grid, select the Override External Field prompt and select the report field or
calculated field that provides the value you want.
The Override External Field prompt lists fields that are relevant to the Business Object you
selected in step 1.
5. To map the custom field values to external values, create and configure one or more integration maps:
a) As a related action on the integration system, select Integration System > Maintain Integration
Maps.
b) For each field that requires a map, specify a map Name in the format: ADD-<FieldName>.
The ADD prefix indicates that the map pertains to the Additional Data section, and the <FieldName>
identifies the fields mapped in the future.
c) Specify the Internal Value Type and External Value Type for each map. You can create an
Enumeration with a list of valid values or select a report field at the Data Type prompt.
d) Save the maps when you finish.
e) As a related action on the integration system, select Integration System > Configure Integration
Maps. To find the custom maps, then scroll to the bottom of the grid.
f) Add a row for each tenanted value, select the Internal Value, and enter the External Value for the
output file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1107

Result
Workday groups custom fields into a record called ADD that displays on a separate line in the output file.
By default, Workday includes custom fields in output files only when field values change.

Next Steps
To add or change fields in an integration field override service, use one of these methods:
• In the View Integration System report, select Integration Field Override Service > Edit as a related
action on the integration service in the Custom Integration Services grid.
• Access the Edit Integration Field Override Service task.

Concept: Core Connector: Positions


The Core Connector: Positions integration exports position changes from Workday in simple XML format.
As you create, update, or delete position data, the integration generates an output file containing the
changes.
The integration includes a configurable set of position data across a range of categories. You can specify
which data sections to include in the output file. Each section provides a set of fields. You can select which
fields to include or exclude, which ones to require, and which ones to truncate.
Use this Connector to send data on open, closed, and future positions. Don't use this Connector to track
changes to a worker in a position.

Change Detection
The Core Connector: Positions integration detects changes to positions by monitoring a transaction log.
When you configure the integration system, you select which business process and transaction types that
the integration system subscribes to. Excluding business process and transaction types that are irrelevant
to your needs improves performance. However, if your integration doesn’t subscribe to a transaction type
that affects your position records, Workday doesn’t include changes for that transaction type. Workday
recommends that you include all transactions and business types. Exclude transactions and business
types only if you're sure that the integration doesn't need to subscribe to them.
The Core Connector: Positions integration uses a three-step process to detect and report changes:
1. When the integration checks the transaction log, the integration determines which positions changed
and generated one of the configured transaction events.
2. For each position with a matching transactional change, the integration compares values for:
• The time at which the integration ran.
• The time at which the integration was last successfully run.
The integration identifies which, if any, of the values of interest have changed.
3. If the position has any changes in field values, Workday generates an appropriate creation, change, or
deletion message.

Full-Diff Extract
Full-Diff Extract provides data on all positions, which had changes, between the effective dates provided.
To enable this option, disable the Transaction Log service. When you run the integration, Workday extracts
all applicable data for all positions, regardless of whether the position had any changes since the last
successful integration system run. Using this option can adversely affect Workday performance. The
Core Connector: Positions integration first selects all positions, and only then, determines changes for the
returned data.

Results Filtering
Core Connector: Positions can filter results by:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1108

• Open positions only (including frozen positions).


• Closed positions only.
• Open and closed positions.
The integration template includes attributes that enable you to restrict results to:
• Positions available for recruiting.
• Positions available for hire.

Integration Launch and Scheduling


Workday provides these launch schedule options for the Core Connector: Positions integration:
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Positions integration to run several times per day;
launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually. Workday prompts you to enter launch parameters.
To bypass entering a from date Effective Date as a launch parameter, enable the Restrict to Positions in
the Entry Range integration attribute. The integration only returns positions that are entered between the
Last Successful as of Entry Moment and the As of Entry Moment launch parameter values. Workday
then uses the Effective Date parameter as the As of Effective Date filter and doesn’t use the Last
Successful Effective Date filter.
Note: If you don't enable the Restrict to Positions in the Entry Range integration attribute, the
integration doesn't return positions with effective dates prior to 1/1/1970.
For each launch schedule option, you can enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the
Successful As Of Entry Moment, Last specified As Of Entry Moment and Effective
Successful Effective Date Date parameters. If Full Extract isn’t selected,
then the extract includes only those records
that have changed in one or more output fields.
Workday compares what was current as of the
Last Successful As Of Entry Moment and Last
Successful Effective Date parameters.
Full Extract Extracts Positions as of the As Of Entry Moment
and Effective Date, regardless of whether they’ve
changed.
Location(s) Extracts Positions for only the specified Locations.
Position(s) Extracts only the specified Positions.
Supervisory Organization(s) Extracts Positions for only the specified Supervisory
Organizations.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration system. Workday generates this file every time the
integration runs. The file reflects your integration configuration as of the moment that the integration
ran. You can only generate this file by running the integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1109

You can find these files in the Integration Event for each integration run. For each integration run, view the
Reports and Other Output Files section.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can’t have access to the data.

Reference: Core Connector: Positions Integration Data Sections


Before you build an integration with the Core Connector: Positions template, familiarize yourself with each
data section to understand which fields are available for output and how the configuration options affect
integration behavior.
During integration configuration, you enable integration services for each data section that you want to
include in the output file.

Section Description Fields


Position Data This section can have one or more records. • Position ID
• Supervisory Organization
• Job Posting Title
• Job Description
• Academic Tenure Eligible
• Available for Hire
• Available for Recruiting
• Hiring Freeze
• Availability Date
• Earliest Hire Date
• Job Family
• Job Profile
• Location
• Worker Type
• Time Type
• Worker Subtype
• Filled By Worker

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1110

Section Description Fields


Job Qualification The Competency Qualification, Certification • Competency Qualification
Data Qualification, Education Qualification, • Competency Qualification /
Language Qualification, Responsibility Competency
Qualification, Training Qualification, and Work
• Competency Qualification /
Experience Qualification attributes don’t send
Proficiency Rating
data. These attributes enable the attributes
with the same attribute prefix. Example: • Competency Qualification /
enable Language Qualification in order to Competency Required
use the Language, Language Ability Type, • Certification Qualification
Language Proficiency Type, and Language • Certification Qualification /
Required field attributes. Certification
• Certification Qualification /
Certification Country
• Certification Qualification /
Certification Name
• Certification Qualification /
Certification Issuer
• Certification Qualification /
Certification Required
• Education Qualification
• Education Qualification /
Education Degree
• Education Qualification /
Education Field of Study
• Education Qualification /
Education Required
• Language Qualification
• Language Qualification /
Language
• Language Qualification /
Language Ability Type
• Language Qualification /
Language Proficiency Type
• Language Qualification /
Language Required
• Responsibility Qualification
• Responsibility Qualification /
Responsibility Description
• Responsibility Qualification /
Responsibility Required
• Training Qualification
• Training Qualification / Training
Name
• Training Qualification / Training
Description
• Training Qualification / Training
Type
• Training Qualification / Training
Required
• Work Experience Qualification
• Work Experience Qualification /
Work Experience
• Work Experience Qualification /
Work Experience Rating
©2025
• Work Experience Qualification /
Workday, Inc. All rights reserved Workday
Work Proprietary
Experience Requiredand Confidential
| HCM Connectors | 1111

Section Description Fields


Job Requisition • Job Requisition ID
Data • Positions Available
• Replacement for Worker
• Justification
• Recruiting Instruction
• Do Not Send To Recruiting
System
• Recruiting Start Date
• Target Hire Date
• Target End Date
• Primary Location
• Additional Location
• Scheduled Weekly Hours
• Work Shift

Job Profile Data • Job Profile ID


• Job Title
• Job Profile Summary
• Management Level
• Job Family
• Job Classifications
• Job Exempt Location Context
• Job Exempt
• Company Insider Type

Core Connector: Worker

Setup Considerations: Core Connector: Worker


You can use this topic to help make decisions when planning your configuration and use of the Core
Connector: Worker integration. It explains:
• Why to set it up.
• How it fits into the rest of Workday.
• Downstream impacts and cross-product interactions.
• Security requirements and business process configurations.
• Questions and limitations to consider before implementation.
Refer to detailed task instructions for full configuration details.

What It Is
The Core Connector: Worker integration enables you to extract changes to worker data from Workday and
send them to external applications for:
• Identity management.
• Talent management.
• Time tracking.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1112

Core Connector: Worker with the Worker Data Initialization Service enabled can extract worker data more
efficiently using updated frameworks and capabilities. We strongly recommend that you use this service for
all new Core Connector: Worker integrations.

Business Benefits
Core Connector: Worker enables you to use Workday to maintain a single source of truth for your entire
population of workers. You can then send updates to worker data to other applications that need that
information. Using Core Connector: Worker, you can easily keep worker data in sync across many different
applications.
Additionally, Core Connector: Worker with Data Initialization Service provides a more performant,
resilient, and scalable way to extract worker data. It doesn’t make API calls, helping it withstand network
fluctuations. It can extract data more efficiently; and it can get more data than Core Connector: Worker
without the service enabled.

Use Cases
• Select groups of output fields to include in the integration output file.
• Within each group of fields, include, exclude, or require specific fields.
• Add additional custom report fields.
• Monitor specific business processes for activity.
• Limit output to specific workers or groups of workers.
• Generate an output file that contains only changed fields for each affected worker.
• Send the output file to an external endpoint using FTP, SFTP, email, or other transports.
You can use Core Connector: Worker to send updates on worker data to several types of external
application. Examples:
• Add and remove workers from an identity management application.
• Populate an external time-tracking application.

Questions to Consider

Question Considerations
Does a vendor-specific integration template support If a vendor-specific integration supports your
your use case? use case, use that integration instead of Core
Connector: Worker. A vendor-specific integration,
with a vendor-specific file output format, is easier
to plan, implement, and test. For more information
about our vendor integrations, see the Workday
Marketplace site.
Is the data that you need to send to an external Core Connector: Worker includes many fields
endpoint specific to workers? related specifically to workers. If you need data
specific to other types of HCM data (Examples:
Organizations, Job Profiles), use the applicable
Core Connector instead. To see available Core
Connector templates, access the View Integration
Template report, then enter Core Connector at the
prompt.
Do you need to extract multiple job data for a If you take advantage of multiple job capabilities
worker? for workers, you should use Core Connector:
Worker with Data Initialization Service enabled.
Core Connector: Worker without Data Initialization
Service doesn’t support extracting multiple job data.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1113

Question Considerations
Do you need to extract local time zone effective If you have workers located in different time zones
data? and want to send effective data to downstream
applications, taking into account the difference in
time zone, use Core Connector: Global Worker.

Recommendations
• Consider engaging with professional services when implementing this integration.
• Workday recommends that you enable the Worker Data Initialization Service. Enabling this service
provides greater resiliency, performance improvements, and an improved configuration experience.
• If you’re planning to enable an existing Core Connector: Worker integration with the Data Initialization
Service, use the Migrate Integration Configuration for Data Initialization Service task to ensure
proper conversion.
• Note: When using the Migrate Integration Configuration for Data Initialization Service task, to
avoid impact to Field Override results, the Integration System User (ISU) and related Integration
System Security Group (ISSG) must be secured to the following domains:
• Report / Task Permissions = View
• Integration Permissions = Get
• If you change your Core Connector: Worker integration to use the Worker Data Initialization Service,
note that output can vary when you enable this service. Output can vary due to differences in
integration behavior with the Data Initialization Service enabled. You can perform these steps to confirm
results in your Sandbox/Implementation tenant before committing the change to your Production tenant:
1. Clone the integration.
2. Run the Migrate Integration Configuration for Data Initialization Service task against the cloned
integration.
3. Use the original integration to generate an output file.
4. Use the cloned integration to generate an output file with the same launch parameters.
5. Thoroughly compare the results.
6. If you find no differences or exceptions, you can migrate the integration in your Production tenant.
• To improve integration performance and relevance (with either option):
• Don't make integration field attributes required.
• Don't configure a maximum field length for field attributes.
• Set the Version integration attribute to 25 or higher.
• Use XML as the output format (not CSV).
• Don't group additional information fields.
• Use the Transaction Log Service.
• Avoid using more than 20 field overrides.
• Avoid using the Worker History business object.
• Avoid using these report fields:
• Staffing History – All.
• Staffing History – Approved.
• Worker Events Completed.
• Worker History.

Requirements
No impact.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1114

Limitations
You can't use Core Connector: Worker to send time-worked data. However, you can send updates to an
external time tracking application when you hire, change, and terminate workers.
These limitations apply when you use Core Connector: Worker with the Worker Data Initialization
Service enabled:
• The Worker Photo data section doesn't include an image field.
• Core Connector: Worker doesn't apply contextual security. You can control what fields to include in the
output through fields and attributes in the integration.
• Any field overrides and external parameter assignments must use the Worker business object. These
field overrides can't have restricted usage.

Tenant Setup
No impact.

Security
Enable security for these domains in order to configure Core Connector: Worker:
• Integration Build
• Integration Configure
Enable security for these domains for the integration to access Workday data:
• Manage: Organization Integration
• Person Data: Birth Place
• Person Data: Citizenship Status
• Person Data: Date of Birth
• Person Data: Disabilities
• Person Data: Emergency Contacts
• Person Data: Ethnicity
• Person Data: Gender
• Person Data: Home Contact Information
• Person Data: Hukou (China)
• Person Data: ID Information
• Person Data: Institutional Contact Information
• Person Data: Marital Status
• Person Data: Military Status
• Person Data: Name
• Person Data: Nationalities
• Person Data: Personal Data
• Person Data: Personal Information
• Person Data: Preferred Name
• Person Data: Religion
• Worker Data: Beneficiaries and Dependents
• Worker Data: Benefit Elections
• Worker Data: Compensation
• Worker Data: Compensation by Organization
• Worker Data: Leave of Absence
• Worker Data: Organization Information
• Worker Data: Public Worker Reports
• Worker Data: Staffing
• Worker Data: Workers

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1115

Business Processes
No impact.

Reporting

Report Description
View Integration System View all integrations that you've created. You can
then edit a specific integration that you locate with
this report.
Integration Events Displays:
• A summary of integration events that are in
process or completed.
• Details about the status for each integration
event.

Connections and Touchpoints

Features Considerations
Compensation Core Connector: Worker sends base pay amounts,
currency, and compensation change reasons for
included workers.
HCM Core Core Connector: Worker sends HCM core data for
included workers.
Talent Core Connector: Worker sends qualification data
for included workers.

Workday offers a Touchpoints Kit with resources to help you understand configuration relationships in your
tenant. Learn more about the Workday Touchpoints Kit on Workday Community.

Steps: Set Up Core Connector: Worker Integration

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To export changes to worker data, create a Core Connector: Worker integration.

Steps
1. Create Integration System on page 1854.
Enter Core Connector: Worker in the New Using Template prompt.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
For all Data Section Fields services, disable the service if you don't enable at least 1 field within the
data section.
Option Description
Worker Data Initialization Service Provides field attributes under a new CCW –
Workers for DIS folder. If selected:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1116

Option Description
• Configure population eligibility in the
Configure Integration Population Eligibility
task.
• Workday doesn't apply web service contextual
security, but you can ensure data security
based on eligibility configuration.
Workday recommends that you use this service if
you:
• Extract data for large numbers of workers.
• Experience performance issues with existing
Core Connector: Worker integrations.
Workday recommends that you test this service to
determine any downstream impacts.
Data Initialization Service - Exception Log Provides error logs for calculated fields
exceptions. Automatically enabled when you
enable the Worker Data Initialization Service.
DIS - Performance Log Provides logs to track performance of DIS in
integration events. Automatically enabled when
you enable the Worker Data Initialization
Service.
Effective Stack - Performance Log Provides logs to track the performance of effective
changes calculations. Automatically enabled
when you enable the Worker Data Initialization
Service.
Directory Service - Delivery Service Enables the integration system to deliver output
files to an external endpoint.
Core Connector: Worker Transaction Log Enables your integration system to subscribe
Service to any event that takes place in Workday. This
option enables your integration to report only
changed fields for workers, rather than report all
fields.
If disabled, your integration first extracts all data
for eligible records, then evaluates the data for
changes. Using this option can adversely affect
performance.

Core Connector: Worker Filename Sequence Applies a custom-formatted, unique filename to


Generator each integration file.
CSV Options Applies quotation formatting and column headers
to the integration file.
Integration Document Retention Preserves integration file output for later viewing.
Worker Profile Photo Provides worker photo data (in base64 binary
format). If enabled, set the Version integration
attribute to 17 or later. You can disable
this service if you enable the Worker Data
Initialization Service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1117

Option Description
Worker Personal Data Section Fields Provides employee personal data and contact
information. If enabled, set the Version
integration attribute to 17 or later. You can disable
this service if you enable the Worker Data
Initialization Service.
Worker Status Data Section Fields Provides employment status and service dates.
If enabled, set the Version integration attribute
to 17 or later. You can disable this service if you
enable the Worker Data Initialization Service.
Worker Position Data Section Fields Provides:
• Job profile data
• Salary and base compensation elements
• Organization membership data
If enabled, set the Version integration attribute
to 17 or later. You can disable this service if you
enable the Worker Data Initialization Service.
Worker Contract Data Section Fields Provides employment contract data. If enabled,
set the Version integration attribute to 17 or later.
You can disable this service if you enable the
Worker Data Initialization Service.
Worker Leave of Absence Data Section Fields Provides leave of absence data. If enabled, set
the Version integration attribute to 17 or later.
You can disable this service if you enable the
Worker Data Initialization Service.
Worker Compensation Data Section Fields Provides compensation data for each worker. If
enabled, set the Version integration attribute to
17 or later. You can disable this service if you
enable the Worker Data Initialization Service.
Worker Identification Data Section Fields Provides identification data for each worker. If
enabled, set the Version integration attribute to
17 or later. You can disable this service if you
enable the Worker Data Initialization Service.
Worker Related Person Data Section Fields Provides related person data for each worker.
If enabled, set the Version integration attribute
to 17 or later. You can disable this service if you
enable the Worker Data Initialization Service.
Worker Qualification Data Section Fields Provides qualifications data for each worker. If
enabled, set the Version integration attribute to
17 or later. You can disable this service if you
enable the Worker Data Initialization Service.
Worker Transaction Log Data Section Fields Provides transaction log data for each worker.
If enabled, set the Version integration attribute
to 17 or later. You can disable this service if you
enable the Worker Data Initialization Service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1118

3. As a related action on your Core Connector: Worker integration select Integration System >
Configure Integration Transaction Log.
Select the Workday transactions that you want monitored for changes.
Note: Workday recommends that you select Subscribe to all Transaction Types except. Then, filter
out only transaction types that you know have no relevance to your needs. If in doubt, don't filter out a
transaction type.
4. (Optional) Add custom fields to connector out put, or integration field overrides for DIS.
Add an unlimited number of custom fields to a Core Connector: Worker integration. You can use
calculated fields or report fields to incorporate additional data elements into your output files. You can
use any report field as long as it's available for:
• The Worker business object.
• A business object that is directly related to the Worker object.
See Add Custom Fields to Connector Output. If you enable the Worker Data Initialization Service see
Set Up Integration Field Overrides for DIS
5. Set Up Integration Sequence Generators on page 1856.
6. Configure Core Connector: Worker Integration Attributes on page 1119.
7. From the related actions menu on the integration, select Integration System > Configure Integration
Maps.
On the Integration Maps grid, add a row for each tenant value. Select the Internal Value and enter the
External Value for the output file.
(Optional) Provide a Default Value for data elements with values that don't have a corresponding map
value.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1119

8. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Manage: Organization Integration
• Person Data: Birth Place
• Person Data: Citizenship Status
• Person Data: Date of Birth
• Person Data: Disabilities
• Person Data: Emergency Contacts
• Person Data: Ethnicity
• Person Data: Gender
• Person Data: Home Contact Information
• Person Data: Hukou (China)
• Person Data: ID Information
• Person Data: Institutional Contact Information
• Person Data: Marital Status
• Person Data: Military Status
• Person Data: Name
• Person Data: Nationalities
• Person Data: Personal Data
• Person Data: Personal Information
• Person Data: Preferred Name
• Person Data: Religion
• Worker Data: Beneficiaries and Dependents
• Worker Data: Benefit Elections
• Worker Data: Compensation
• Worker Data: Compensation by Organization
• Worker Data: Leave of Absence
• Worker Data: Organization Information
• Worker Data: Public Worker Reports
• Worker Data: Staffing
• Worker Data: Workers
See: Steps: Grant Integration or External Endpoint Access to Workday.
Note: If you enabled the Worker Data Initialization Service, grant the ISU access to Integration Event
only.
9. Select Workers to Include in a Core Connector: Worker Integration on page 1123.
10.(For Version 17 and higher integrations only) Select and Set Up Connector Output Fields on page
1864.
11.(For Version 15 and 16 integrations only) Map Core Connector: Worker Integration Data on page 1124.
Map Workday data to the integration.
12.Create Integration Business Process on page 1838.
13.(Optional) Steps: Set Up Document Transformation Connector on page 571.
14.Launch an Integration on page 23.

Configure Core Connector: Worker Integration Attributes

Prerequisites
Security: Integration Build and Integration Configure domains in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1120

Context
Configure the Core Connector: Worker integration by entering attributes for enabled integration services,
as well as required attributes.

Steps
1. From the related actions menu on your integration, select Integration System > Configure Integration
Attributes.
2. Enable and disable integration attributes. As you complete the task, consider:
Option Description
Output Filename Assigns the name to the output file. If you enabled
the filename sequence generator, leave this value
empty. Otherwise, enter a valid filename.
Output Document Tags The integration applies these tags to integration
output files.
Version Sets the version of the output file.
Output Format Specifies the format of the file that the integration
generates.
Include Inactive Workers in Full File Includes inactive workers in the output when you
enable the Full File launch parameter option. If
not specified, the integration excludes inactive
workers from Full File results.
Name Type Includes selected Name Types in the output file.
(Applicable for Version 17 and above).
Country ISO Code Type Includes the selected type of country code for
addresses in the output file. If not specified,
the integration uses ISO 3166-1 Alpha 2 code.
(Applicable for Version 17 and above).
Country Code Type Includes the selected type of country code for
addresses in the output file. If not specified,
the integration uses ISO 3166-1 Alpha 2 code.
(Applicable for Version 17 and above).
Address Type Includes the primary address for the selected
Address Types in the output file. (Applicable for
Version 17 and above).
Address Usage Includes any additional nonprimary addresses in
the output file:
• Of the selected Address Usages
• For the selected Address Types
(Applicable for Version 17 and above).
Include Private Addresses Includes private addresses in the output file.
(Applicable for Version 17 and above).
Include Non-Primary Addresses Includes nonprimary addresses in the output file.
(Applicable for Version 17 and above). Workday
applies this value only if you enable the Worker
Data Initialization Service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1121

Option Description
Phone Number Format Specifies which output format that the integration
uses for Formatted Phone Number.
Phone Type Includes the primary phone number for the
selected Phone Types in the output file.
(Applicable for Version 17 and above).
Include Private Phone Numbers Includes private phone numbers in the output file.
(Applicable for Version 17 and above).
Include Non-Primary Phone Numbers Includes nonprimary phone numbers in the
output file. (Applicable for Version 17 and above).
Workday applies this value only if you enable the
Worker Data Initialization Service.
Email Type Includes the primary email address for the
selected Email Types in the output file.
(Applicable for Version 17 and above).
Include Private Email Addresses Includes private email addresses in the output file.
(Applicable for Version 17 and above).
Include Non-Primary Email Addresses Includes nonprimary email addresses in the
output file. (Applicable for Version 17 and above).
Workday applies this value only if you enable the
Worker Data Initialization Service.
Include Prior Values Includes a Prior Value attribute containing the
previous value for a field. (Applicable for Version
17 and above).
Job Classification Group for Job Specifies the type of Job Classification Group
Classification that the integration uses to select the Job
Classification fields in the output. Also enable this
field in the Position Data field service. (Applicable
for Version 17 and above).
Organization Type for Organization Specifies the type of Organization that the
integration uses to select the Organization field
in the output. Also enable this field in the Position
Data field service. (Applicable for Version 17 and
above).
Identification Type for Identification Specifies the type of Identification that the
integration uses to select the Identification
field in the output. Also enable this field in the
Identification Data field service. (Applicable for
Version 17 and above).
Related Person Type for Related Person Specifies the type of Related Person (Example:
Beneficiary, Dependent, Emergency Contact) that
the integration uses to select the Related Person
data in the output. Also enable this field in the
Related Person data field service. (Applicable for
Version 17 and above).
Required Field Validation To identify errors that might occur when the
integration exports data, the integration applies
validation rules to the worker data. This attribute

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1122

Option Description
controls what happens when these validation
rules detect an issue. If not specified, the
integration uses Omit - Report Error:
• Omit - Report Error: integration omits worker
record, reports error, continues processing.
• Omit - Report Warning: integration omits
worker record, displays a warning message,
continues processing.
• Include - Report Warning: integration includes
worker record, adds a warning message to the
integration event, continues processing.
(Applicable for Version 17 and above).
Include Terminated and Transferred Workers Overrides the standard integration behavior.
from Restrict Results By Orgs Includes in delta extracts those Workers who
you have terminated or transferred out of the
organizations specified in the Restrict Results by
Org launch parameter.
Include Address Field Descriptive Attributes Includes or excludes the Type and Label
attributes for certain Address fields in the output
file. If you set the Version to 21.0 or higher, then
the integration includes the additional attributes. If
you set the Version to 20 or lower, the integration
doesn't include the additional attributes. You can
set this integration attribute to override either
value. (Applicable for Version 17 and above).
Suppress Worker Messages Audit Disables generation of Get_Workers web service
responses for each worker in the Messages Audit
file.
Suppress Audit Reports Disables generation of the Data Changes Audit
and Diagnostic Audit files.
Include Multiple Supervisors If selected, the output includes multiple
supervisors (if applicable) for the position of the
worker. (Applicable for Version 25.0 and above).
Use Transaction Log with Full File If selected, the integration uses the Transaction
Log (if enabled) for Full File extracts. (Applicable
for Version 17 and above).
Group Additional Information Fields By If selected, the output file includes the Additional
Service Information Fields grouped under the Field
Override Service Name. You enter the Field
Override Service Name in the Configure
Integration Field Overrides related action on the
integration system.
To group under a custom group name, place a
period between the group name and the field
name. Don't include a period in any other part of
the name. Example: Group_Name.Field_Name
3_1

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1123

Option Description
Workday applies this value only if you enable the
Worker Data Initialization Service.

Include Multiple Positions If selected, the Position Data Section returns


additional jobs and international assignments.
(Applicable for Version 25 and above). Workday
applies this value only if you enable the Worker
Data Initialization Service.
Job Type Select the job types that you want Workday
to return (applicable for Version 25.0 and
above). The Primary Position and International
Assignment fields in the Position Data Section
reflect the types of positions returned. Workday
applies this value only if you enable the Worker
Data Initialization Service.
Always Include Workers with Manager Change The integration checks each worker for
in Output associated manager change events. If manager
change events exist for a worker, the integration
includes the worker in the integration output
regardless of field output changes. Workday
applies this value only if you enable the Worker
Data Initialization Service.
Generate Multiple Output Files If selected, the integration creates multiple output
files containing 1000 Workers each. (Applicable
for Version 34 and above). Workday applies
this value only if you enable the Worker Data
Initialization Service.
Suppress Warning Messages on Calculated Disables the warning messages related to
Field Exceptions exceptions that the integration returns from
calculated fields used as Field Overrides or
Eligibility Criteria. Workday applies this value
only if you enable the Worker Data Initialization
Service.
Show headers Determines if the integration includes column
headers. If not specified, the integration displays
the headers.
Always quote values Determines if the integration applies quotation
marks to output file values. If not specified, the
integration applies quotation marks only to any
value that requires quotation marks.
Document Retention Policy Specify the duration (in days) that the integration
retains output files for viewing.

Select Workers to Include in a Core Connector: Worker Integration

Prerequisites
You must have a Core Connector: Worker integration system to perform this task.
If you intend to use a calculated field for the eligibility criterion, create it before performing this task.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1124

Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Designate a report field or calculated field that identifies if a worker is or isn't eligible for the integration.
You have to create the report field or calculated field on the Worker business object, and it must return a
Boolean true or false. A Boolean true includes the worker in the integration, while a Boolean false excludes
the worker.

Steps
1. As a related action on the Core Connector: Worker integration system, select Integration System >
Configure Integration Field Overrides.
2. Select a report field or calculated field from the Override External Field prompt in the Field
Configuration grid for Define Eligibility / Eligibility criterion.

Example
If your integration system monitors changes for all of your staff employees, you select the Worker
is Employee field. This field would return true for all your employees, and return false for all of your
contingent workers.
If your integration system monitors changes for your sales staff in your Chicago office, you create a
calculated field that returns true if the:
• Worker was an employee.
• The worker belonged to a sales organization.
• The worker belonged to the Chicago location.
Related Information
Tasks
Create Calculated Fields

Map Core Connector: Worker Integration Data

Prerequisites
You must have selected 15 or 16 as the Version when configuring the integration attributes to perform this
task.
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
In this task, you add (and if necessary, create) an Integration Field Override Service to the Core
Connector: Worker integration. The Integration Field Override Service defines the fields that Workday
includes on integration output files. Then, you configure integration field overrides for all integration
services. These overrides define which report fields Workday uses to add data for each field.

Steps
1. As a related action on the Core Connector: Worker integration, select Integration System > Configure
Integration Services.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1125

2. Add a row to the Custom Integration Services grid and select an Integration Field Override Service from
the Integration Service prompt. If you haven't already created one, do so now:
a) Access the Create Integration Field Override Service task.
b) Name your new Integration Field Override Services. Then, select the business object (Contingent
Worker, Employee, or Worker) that includes the report fields that you want to map to the integration
file for each worker.
c) Add 1 row for each field and provide a name for each field. You can reorder the fields using the up
and down arrows.
3. As a related action on the Core Connector: Worker integration, select Integration System > Configure
Integration Field Overrides.
4. Scroll down to the Field Configuration grid for the Integration Field Override Service.
5. For each field, select a corresponding report field from the Override External Field prompt.

View Core Connector: Worker Integration Audits

Prerequisites
Security: Background Process Management domain in the Tenant Non-Configurable functional area.

Context
For each integration event, you can use the Core Connector: Worker integration audits to determine:
• What data sends (DataChangesAudit.html)
• Why Workday includes the worker in the integration event (DiagnosticAudit.html)
• How the data groups on the integration file (Event Name.csv)

Steps
1. As a related action on the integration event, select Background Process > View Output Files.
2. Select an audit file:
Option Description
DataChangesAudit.html For each worker, displays the Integration Field
Override Service name, field name, current and
prior field values, and worker transactions for
each field included on the integration file.
If you enabled the Suppress Audit Files
integration attribute, Workday doesn't generate
this audit file. For this reason, suppression isn't
the automatically populated configuration.

DiagnosticAudit.html For each worker, displays each worker


transaction that the integration detected during
the date range covered by the integration event.
If you enabled the Suppress Audit Files
integration attribute, Workday doesn't generate
this audit file. For this reason, suppression isn't
the automatically populated configuration.

Event Name.csv Displays the raw output of the integration in a


Comma Separated Value (CSV) format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1126

Concept: Core Connector: Worker


The Core Connector: Worker integration exports worker data changes from Workday in simple XML format.
Workday also supports output in CSV (Comma-Separated Value) format, with certain limitations. As you
hire, promote, transfer, terminate, or update worker data, the integration generates a text file containing the
changes.
Using configurable data sections or Workday-delivered report fields and calculated fields that you create,
you can export any worker data, in any combination.
Use this Connector to send data for workers and attributes of those workers.

Change Detection
The Core Connector: Worker detects changes to worker data by monitoring a transaction log. When
you configure the integration system, you select which business process and transaction types that
the integration system subscribes to. Workday ignores changes caused by business processes and
transaction types that the integration doesn't subscribe to. By including all business process and
transaction types, you benefit automatically when Workday adds new types. However, including all is also
a potential risk, as the integration might include more information than is necessary.
The Core Connector: Worker integration uses a three-step process to detect and report changes:
1. The integration checks the transaction log. It determines which workers have changes that result in the
generation of one of the configured transaction events.
2. For each worker with a matching transactional change, the integration compares their report fields for:
• The time at which the integration ran.
• The time at which the integration last successfully ran.
The integration identifies which, if any, of the values of interest have changed.
3. If the worker has any changes in field values or eligibility, Workday generates an appropriate creation,
change, or deletion message.

Change Detection Limitations


Changes to the Classification of a Job don’t trigger change detection for this integration. The context of
the change is on the Job Profile (template), and not directly related to any associated job (instance) for a
worker. However, full extraction on worker records includes the job classification element.

Full-Diff Extract
You can configure your Core Connector: Worker integration to select all workers who meet the eligibility
criteria, then determine changes for the returned data. To enable this option, disable the Transaction Log
service or enable the Use Transaction Log with Full File integration attribute. When you run the integration,
Workday extracts all applicable data for the defined population of employees. If any data for an employee
changed during the defined date range, Workday includes all data for that employee. The integration
doesn’t include prior values when performing a full extract using the Transaction Log option. Using this
option can adversely affect Workday performance.

Worker Eligibility
For each integration system, you define a group of workers that belongs to the integration system. A single
boolean report field or calculated field defines membership. If the field value is true for a worker, that
worker is a member of the group, and Workday includes changes for that worker in the output file. If the
field value is false, the integration system ignores that worker.
You can use report fields on the Worker business object to define eligibility. If you can't define your group
membership criteria using a report field, you can create and use a calculated field. If multiple boolean

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1127

values are true, the calculated field can evaluate the worker business object and its related business
objects to return true. Example: use a calculated field to return true if:
• The worker is a contingent employee.
• The primary location of the worker is in the United States.
• The supervisor of the worker is John Doe.

Worker Data Initialization Service


Core Connector: Worker includes a Worker Data Initialization Service as an alternate method for accessing
data from Workday. This integration service can provide significant performance improvements. We highly
recommend that you use this service if:
• You’re extracting data for large numbers of workers.
• You're experiencing performance issues with existing integrations.
You can use the Migrate Integration Configuration for Data Initialization Service task to make setting
up new integrations with this service easier.
The Worker Data Initialization Service provides field attributes under a separate CCW – Workers for DIS
folder in the Configure Integration Field Attributes task. Core Connector: Worker integrations require
access to the Integration Event security domain only.
Core Connector: Worker doesn't support returning multiple values when a Field Override uses a multi-
instance field.

Output Configuration and Formats


The Core Connector: Worker integration supports output configuration using either data sections or report
fields. The integration template includes a Version attribute. Versions 17 and later supports configurable
data sections. Versions 16 and earlier support report field overrides and provides backward compatibility
for any HCM Worker: Connector integrations that you built before Workday 17, using HCM Worker Sync:

Data Sections The template includes a configurable set of HCM


data across a range of categories. You can specify
which data sections to include in the output file.
Each section provides a set of fields. You can select
which fields to include or exclude, which ones to
require, and which ones to truncate.

Report fields You can include any report fields from the Worker-
related business objects (Contingent Worker,
Employee, and Worker) on the integration file.
You can add a unique label for each field. When
Workday generates an integration file, it combines
the field name and the report field into a single
formatted entry.

Workday creates Core Connector: Worker integration files in one of these formats, depending on which
Version attribute you select:
• Version 15 and 16: Workday can generate an output file in Comma-Separated Value (CSV) format;
values and separators are all in ASCII text. The file includes current values for each field included in the
file.
• Version 16 and later: Workday can generate an output file in XML format. Each field element in the file
includes separate elements containing the current value and the prior value.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1128

Launch/Schedule Options
Workday provides these launch schedule options for the Core Connector: Worker integration:
• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member. You can also select any organization or subordinate organization if you
have an organization role.
• Organization By Type displays if the Integration Process Event for this integration has no associated
organization. You can select any organization and subordinate organization of which you’re a
member or have an organization role.
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Worker integration to run several times per day;
launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers.
Workday prompts you to enter launch parameters.
For each launch schedule option, you can enter these launch parameters:

Parameter Description
As Of Entry Moment, Effective Date, Last Extracts records that are current as of the
Successful As Of Entry Moment, Last specified As Of Entry Moment and Effective
Successful Effective Date Date parameters. If Full File isn’t selected, then
the extract includes only those records that have
changed in one or more output fields. Workday
compares to what was current as of the Last
Successful As Of Entry Moment and Last
Successful Effective Date parameters.
Full File Extracts Workers as of the As Of Entry Moment
and Effective Date, regardless of whether they’ve
changed.
Restrict Results By Orgs Extracts Workers for only the specified
Organizations and all subordinates.
Workers Extracts only the specified Workers.
If you configure no values, then the integration
considers all workers when looking for transactional
and data changes. Specifying workers in this
list doesn’t force their inclusion in the output file.
Information for a worker displays in the output
file only if there are changes in the data fields
evaluated by the integration system.
If there was an error involving data for one or more
workers during a prior integration run, specify
workers in this parameter at launch time. Correct
the worker data and then run the integration again
only for those workers. Set the Last Successful
As Of Entry Moment to the moment used for that
parameter on the prior run.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1129

Integration Audit Files


Every time the integration runs, Workday generates these files:
• The Data Changes Audit is a readable version of the integration output file.
• The Diagnostic Audit is designed to help you troubleshoot integration errors.
• The Schema XSD file defines the content and the structure of the output file. It includes only those
fields that you’ve enabled for your integration system. Workday generates this file every time the
integration runs. The file reflects your integration configuration as of the moment that the integration
ran. You can only generate this file by running the integration.
The Reports and Other Output Files section of the Integration Event for each integration run displays
these files.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: If administrators can’t have access to the data.
Related Information
Tasks
Add Custom Fields to Connector Output on page 1865

Concept: Core Connector: Worker Integration Data Mapping


You must have selected 15 or 16 as the Version when configuring the integration attributes to perform this
task.
This data mapping example displays how you would map worker data to a Version 15 or 16 Core
Connector: Worker integration:
1. Create an Integration Field Override Service named Worker Data, with these field names:
• Full Name
• First Name
• Last Name
• Email Address
• Secondary Email Address
• Employee Type
2. Add the Worker Data integration service to your Core Connector: Worker integration system.
3. In the Integration Field Overrides for your integration system, you map Workday report fields to the
fields you defined:

Fields Override External Field


Worker Data / Full Name Legal Name
Worker Data / First Name Legal Name - First Name
Worker Data / Last name Legal Name - Last Name
Worker Data / Email Address Email - Primary Work
Worker Data / Employee Type Worker Type - Text

When you hire employee John Doe into your company (Acme, Inc. in this example), Workday includes this
entry for John Doe on the integration file:
Full Name: John Doe
First Name: John
Last Name: Doe
Email Address: john.doe@acmeinc.com

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1130

Employee Type: Employee

Concept: Core Connector: Worker Integration Launch Parameters

Scheduled Integration Launch Parameter Examples

Example 1: Full File, Run Weekly. To schedule a full file integration, specify these
values for the Effective Date, As Of Entry
Moment, and Full File launch parameters:

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime
As Of Entry Determine Current
Moment Value at Moment
Runtime (DateTime)
Full File Determine Select check
Value at box as True.
Runtime

When the integration runs, it sends a file that


contains all workers who are in the specific
date range. The integration includes all workers
regardless if there are any changes for a worker.

Example 2: Full File, Compare Current, Run To schedule an integration that compares:
Now.
• Current worker records.
• What was current as of the Last Successful
Effective Date and Last Successful As Of
Entry Moment.
Specify these values:

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime
As Of Entry Determine Current
Moment Value at Moment
Runtime (DateTime)
Last Determine As Of Effective
Successful Value at Date of Last
Effective Date Runtime Completed
Integration
Event
Last Determine As Of Entry
Successful Value at DateTime
As Of Entry Runtime of Last
Moment Completed

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1131

Field Value Type Value


Integration
Event

Each time the integration runs, it sends a file that


contains:
• Changes that occurred between the last
integration run (From Last Successful As Of
Entry Moment) and the current date and time
(As of Entry Moment ).
• Changes that are effective between the Last
Successful Effective Date and the Effective
Date.

Example 3: Restrict Results by Orgs. To schedule an integration that extracts workers


from specific orgs and their subordinates, specify
values for these launch parameters:
• Effective Date
• As Of Entry Moment
• Restrict Results by Orgs

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime
As Of Entry Determine Current
Moment Value at Moment
Runtime (DateTime)
Restrict Determine Organizations
Results By Value at
Orgs Runtime

Example 4: Full File, Workers To schedule an integration that extracts specified


workers, specify these values for the Effective
Date, As Of Entry Moment, and Workers launch
parameters:

Field Value Type Value


Effective Date Determine Current
Value at Effective Date
Runtime
As Of Entry Determine Current
Moment Value at Moment
Runtime (DateTime)
Workers Determine Workers
Value at
Runtime

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1132

Reference: Core Connector: Worker Integration Data Sections


Before you build an integration with the Core Connector: Worker template, familiarize yourself with each
data section to understand which fields are available for output and how the configuration options affect
integration behavior.
During integration configuration, you enable integration services for each data section that you want to
include in the output file.
Some sections also have an Operation field that indicates whether a row of data is new, changed, or
deleted. Operation codes are: ADD, REMOVE, MODIFY, or NONE.

Section Description Fields


Worker Profile • This section has a single record. • Filename
Photo • Workday populates this section only if the • Image
worker has a profile photo.
• Workday includes Profile photo data in the
Image field in base64 binary format. Use
a base64 converter to translate the binary
data into a graphic file.
• Workday ignores any Maximum Length
value for the Image field attribute.
• If the Image field value is changed,
Workday includes only a truncated prior
value, not the full prior image. A truncated
prior value indicates that the image
changed. Truncation doesn't require
sending a large (redundant) prior value
base64 string in the output file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1133

Section Description Fields


Worker Personal • This section has a single record. • Name Data
Data • If not overridden, name fields are based on • Name Data / Name Type
Legal Name. • Name Data / First Name
• The Name Data, Address Data, Phone • Name Data / Middle Name
Data, and Email Data attributes don’t send • Name Data / Last Name
data. They enable the attributes with the • Name Data / Secondary Last
same attribute prefix. Example: Enable Name
Email in order to use the Email Usage,
• Name Data / Title
Email is Public, and Email Address field
attributes. • Name Data / Social Suffix
• Name Data / Title is the Prefix of the name • Name Data / Formatted Name
and Name Data / Social Suffix is the Suffix • Name Data / Reporting Name
of the name. • Name Data / First Name in Local
• Country of Birth is a two-digit country code Script
based on ISO 3166-1 alpha-2. • Name Data / Middle Name in
• If a worker has more than 1 Ethnicity, Local Script
Workday includes only 1 ethnicity value • Name Data / Last Name in Local
unless: Script
• Name Data / Secondary Last
• The Version integration attribute is set
Name in Local Script
to 21 or higher.
• Name Data / Name in Local
• The integration generates output files in
Script
XML format.
• Name Data / First Name in Local
Script 2
• Name Data / Middle Name in
Local Script 2
• Name Data / Last Name in Local
Script 2
• Name Data / Secondary Last
Name in Local Script 2
• Name Data / Full Legal Name
• Gender
• Birth Date
• Country of Birth
• Region of Birth
• City of Birth
• Marital Status
• Religion
• Disability
• Ethnicity
• Hispanic or Latino
• Citizenship Status
• Nationality
• Military Status
• Military Discharge Date
• Address Data
• Address Data / Address Type
• Address Data / Address Usage
• Address Data / Address Is
Public
• Address Data / Is Primary
• Address Data / Address Line
Data
©2025 Workday, Inc. All rights reserved • Address DataProprietary
Workday / Municipality
and Confidential
• Address Data / Submunicipality
| HCM Connectors | 1134

Section Description Fields


Worker Status Data • Staffing Event codes are: HIR (hire), TRM
• Staffing Event
(termination), LOA (leave of absence), RFL
• Staffing Event Date
(return from leave), and TFR (supervisory
• Employee Status
organization change). Workday returns the:
• Active
• HIR code for workers with an Employee • Active Status Date
Status value of Active. • Hire Date
• HIR code for workers with a Prior • Original Hire Date
Employee Status of Terminated and a • Hire Reason
current Employee Status of Active. • End Employment Date
• LOA code for a worker with a Prior • Continuous Service Date
Employee Status of Is Not on Leave
• First Day of Work
and a current Employee Status of On
Leave. • Expected Retirement Date
• RFL code for a worker with a Prior • Retirement Eligibility Date
Employee Status of On Leave and a • Retired
current Employee Status of Active. • Retirement Date
• TFR code for a worker with a Prior • Seniority Date
Organization value. • Severance Date
• TRM code for a worker with a Prior • Benefits Service Date
Employee Status of Is Not Terminated • Company Service Date
and a current Employee Status of • Time Off Service Date
Terminated. • Vesting Date
• Employee Status codes are: Active, • Terminated
OnLeave, Terminated, and NotYetHired.
• Termination Date
• These fields support Record of
• Pay Through Date
Employment (ROE) reporting for Canada:
• Primary Termination Reason
• Last Date for Which Paid • Primary Termination Category
• Expected Return Date • Termination Involuntary
• Not Returning • Secondary Termination Reason
• Return Unknown • Local Termination Reason
• Not Eligible for Hire
• Regrettable Termination
• Termination Last Day of Work
• Resignation Date
• Last Date for Which Paid
• Expected Date of Return
• Not Returning
• Return Unknown
• Probation Start Date
• Probation End Date
• Academic Tenure Date
• Has International Assignment
• Home Country
• Host Country
• Rehire

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1135

Section Description Fields


Worker Position • This section has a single record, with • Operation
Data primary position only. • Position ID
• Effective Date represents the effective date • Effective Date
for the most recent change to position data. • Primary Position
Workday doesn't report prior values for this • Position Title
field.
• Business Title
• A position can have a number of job
• Worker Type
classifications that you arrange according
to job classification groups. • Position Time Type
• Job Exempt
• Scheduled Weekly Hours
• Default Weekly Hours
• Full Time Equivalent Percentage
• Exclude from Headcount
• Pay Rate Type
• Job Classification Data
• Job Classification Data/
Operation
• Job Classifications
• Job Classification Group
• Company Insider Type
• Organization Data
• Organization Data/Operation
• Organization
• Organization Type
• Work Shift
• Work Hours Profile
• Workers Compensation Code
• Job Profile
• Management Level
• Job Category
• Job Family
• Business Site
• Business Site Name
• Business Site Address Type
• Business Site Address Line
Data
• Business Site Municipality
• Business Site Submunicipality
• Business Site Region
• Business Site Subregion
• Business Site Postal Code
• Business Site Country
• Business Site Address Line
Data Local
• Business Site Municipality Local
• Business Site Submunicipality
Local
• Business Site Subregion Local
• Regular Paid Equivalent Hours
• Worker Hours Profile
Classification
©2025
• Supervisor ID
Workday, Inc. All rights reserved Workday Proprietary and Confidential
• Supervisor Name
| HCM Connectors | 1136

Section Description Fields


Worker Contract • This section can have multiple records. • Operation
Data • Although an employee can have only 1 • Position ID
contract in effect at a time, this section • Contract ID
can include contracts from the past. This • Contract Type
section also can include contracts that • Start Date
become effective in the future.
• End Date
• Contract Status
• Description

Worker Leave of • This section contains position-specific data.


• Operation
Absence Data • This section can have multiple records. • Position ID
• An employee can be on multiple different • On Leave
types of leave at the same time. • Leave Start Date
• These fields in the Status Data section • Estimated Leave End Date
indicate whether an employee is on leave: • Leave End Date
• Employee Status • First Day of Work
• Staffing Event • Leave Last Day of Work
• Staffing Event Date • Leave of Absence Type
• Benefits Effect
Enable the Leave of Absence section if you
need additional information about leave. • Payroll Effect
• Paid Time Off Accrual Effect
• Continuous Service Accrual
Effect
• Stock Vesting Effect

Worker • This section contains position-specific data. • Operation


Compensation • Effective Date represents the effective • Position ID
Data date for the most recent change to • Effective Date
compensation data. Workday doesn't • Compensation Change Reason
report prior values for this field. • Total Annual Base Pay
• Total Base Pay
• Base Pay Currency
• Base Pay Frequency

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1137

Section Description Fields


Worker This section contains worker identification • Operation
Identification Data data. • Identification
Workday performs Required field validation • ID
for this section only when a worker has • ID Type
at least one of the ID Types that you've • Issued Date
configured for reporting. • Expiration Date
• Verification Date
• Issuing Agency
• Series
• Country
• Region
• Authority
• License Class
• Organization
• Description

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1138

Section Description Fields


Worker Related • This section can have multiple records. It • Operation
Person Data contains related-person details to a worker • Related Person ID
that can include emergency contacts, • Related Person Type
beneficiaries, and dependent details • Relationship
related to a worker.
• Name Data
• If not overridden, name fields are based on
• Name Data / Name Type
Legal Name.
• Name Data / First Name
• The Name Data, Address Data, Phone
Data, and Email Data attributes don’t send • Name Data / Middle Name
data. They enable the attributes with the • Name Data / Last Name
same attribute prefix. Example: Enable • Name Data / Secondary Last
Email in order to use the Email Usage, Name
Email is Public, and Email Address field • Name Data / Title
attributes. • Name Data / Social Suffix
• Name Data / Title is the Prefix of the name • Name Data / Formatted Name
and Name Data / Social Suffix is the Suffix • Name Data / Reporting Name
of the name. • Name Data / First Name in Local
Script
• Name Data / Middle Name in
Local Script
• Name Data / Last Name in Local
Script
• Name Data / Secondary Last
Name in Local Script
• Name Data / Name in Local
Script
• Name Data / First Name in Local
Script 2
• Name Data / Middle Name in
Local Script 2
• Name Data / Last Name in Local
Script 2
• Name Data / Secondary Last
Name in Local Script 2
• Name Data / Full Legal Name
• Gender
• Birth Date
• Marital Status
• Disability
• Ethnicity
• Address Data
• Address Data / Address Type
• Address Data / Address Usage
• Address Data / Address Is
Public
• Address Data / Is Primary
• Address Data / Address Line
Data
• Address Data / Municipality
• Address Data / Submunicipality
• Address Data / Region
• Address Data / Subregion
• Address Data / Postal Code
©2025 Workday, Inc. All rights reserved • Address DataProprietary
Workday / Country and Confidential
• Address Data / Address Line
| HCM Connectors | 1139

Section Description Fields


Worker • This section has a single record. • Competency Achievement
Qualification Data • The Competency Achievement, • Competency Achievement /
Certification Achievement, Training, Operation
Education, and External Job attributes • Competency Achievement /
don’t send data. They enable the attributes Competency Achievement ID
with the same attribute prefix. Example: • Competency Achievement /
Enable Education in order to use the Competency
Last Year Attended or Field of Study field • Competency Achievement /
attributes. Proficiency Rating
• Competency Achievement /
Assessment Comments
• Competency Achievement /
Assessment Date
• Competency Achievement /
Assessed by Worker
• Certification Achievement
• Certification Achievement /
Operation
• Certification Achievement /
Certification Achievement ID
• Certification Achievement /
Certification
• Certification Achievement /
Certification Country
• Certification Achievement /
Certification Name
• Certification Achievement /
Certification Issuer
• Certification Achievement /
Certification Number
• Certification Achievement /
Issued Date
• Certification Achievement /
Expiration Date
• Certification Achievement /
Exam Date
• Certification Achievement /
Exam Score
• Training
• Training / Operation
• Training / Training Achievement
ID
• Training / Training Name
• Training / Training Description
• Training / Training Type
• Training / Training Duration
• Training / Completion Date
• Education
• Education / Operation
• Education / Education
Achievement ID
• Education / Institution
• Education / Institution Name
©2025 Workday, Inc. All rights reserved • Education
Workday / Institution
ProprietaryType
and Confidential
• Education / Institution Location
| HCM Connectors | 1140

Section Description Fields


Worker Transaction • This data section applies only if you enable • Transaction Log Description
Log Data the Core Connector: Worker Transaction • Transaction Effective Moment
Log Service integration service. • Transaction Entry Moment
• This data section applies only to non- Full • Transaction Log Type
File integration runs. Exception: if you set • Is Rescind Or Rescinded
the Use Transaction Log with Full File
• Is Correction Or Corrected
integration attribute to True. In that case,
Workday still includes this data section in
the integration output.
• The data fields in this data section don't
represent field-level change detection.
Therefore, there are no priorValue
annotations in this data section.
• Workday includes transaction log entries
only for worker transactions that match:
• The type of transaction log subscription
that you configured for the integration.
• The launch parameter dates.

Directory Service

Steps: Set Up Directory Service Integration

Prerequisites
• Be familiar with the organization structure of your Directory Service server.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To synchronize account profiles between Workday and a directory server, create a Directory Service
integration. The integration can send an LDIF file to an FTP server for use by your directory server.

Steps
1. Access the Create Integration System task and enter Directory Service in the New using Template
prompt.
2. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
Active Directory Enable only if your target directory server runs
Microsoft Active Directory.
Simple DN Enable only if you use a simple Distinguished
Name format on your target directory server.
Simple DN User ID Enable only if you use a simple Distinguished
Name format on your target directory server.
Directory Service Distinguished Name Enable only if you use a complex Distinguished
Name format on your target directory server.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1141

Option Description
Transaction Log Service Enables your integration system to subscribe to
events that take place in Workday. This service
enables your integration to report only changed
fields for workers, rather than report all fields.
If disabled, your integration first extracts all data
for eligible records, then evaluates the data for
changes. Using this option can adversely affect
performance.

Integration Document Retention Enable if you want to retain copies of exported


files for a set period.
Filename Sequence Generator Enable if you want Workday to apply a custom-
formatted, unique filename to each integration file.
CSV Options Enable if you want to apply quotation formatting
and column headers to the integration file.
3. As a related action on your Directory Service integration, select Integration System > Configure
Integration Transaction Log
Note: We recommend that you select Subscribe to all Transaction Types except, then filter out
only transaction types that you know have no relevance to your needs. If in doubt, don't filter out a
transaction type.
4. Set Up Integration Sequence Generators on page 1856.
5. As a related action on your Directory Service integration, select Integration System > Configure
Integration Attributes. Enter attributes for integration services that you enabled in Step 2, as well as
required attributes.
6. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Event
• Worker Data: Public Worker Reports
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
7. Map Directory Service Integration Data on page 1141.
8. Select Workers to Include in a Directory Service Integration on page 1142.
9. Create Integration Business Process on page 1838.
10.Launch an Integration on page 23.

Map Directory Service Integration Data

Prerequisites
You must have a Directory Service integration system to perform this task.
Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
You can add an Integration Field Override Service to the Directory Service integration. The Integration
Field Override Service defines the fields that Workday includes on integration output files. The output files
must match the schema on the target directory server. Then you configure integration field overrides for all
integration services. These overrides define which report fields Workday uses to add data for each field.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1142

Steps
1. From the related actions menu of the Directory Service integration, select Integration System >
Configure Integration Services.
2. Add a row to the Custom Integration Services grid and select an Integration Field Override Service
from the Integration Service prompt. If you haven't already created one, do so now:
a) Access the Create Integration Field Override Service task.
b) Name your new Integration Field Override Services. Then, select the business object (Contingent
Worker, Employee, or Worker). The business object includes the report fields that you want to map
to the integration file for each worker.
c) Add 1 row for each field and provide a name for each field. You can reorder the fields using the up
and down arrows. If your integration produces an LDIF file, Workday includes each field name on the
integration file.
3. From the related actions menu of the Directory Service integration, select Integration System >
Configure Integration Field Overrides.
4. Specify how you want Workday to generate a DN (Distinguished Name) for each worker included in the
integration:
Option Description
Simple DN User / User Identity Select a report field that returns the name format
that you want to use for each worker name.
Directory Service Distinguished Name / DN Create, then select, a calculated field that
prefix constructs a DN in the format used by your
directory server.
5. Scroll down to the Field Configuration grid for the Integration Field Override Service.
6. For each field, select a corresponding report field or calculated field from the Override External Field
prompt.

Example
You create an Integration Field Override Service using the Employee business object that includes a field
named lastname.
• lastname mapped to the Legal Name - Last Name report field
• Simple DN User/User Identity mapped to the Legal name in General Display Format report field.
When Workday creates an LDIF file for the employee John Doe, the LDIF file includes an entry of
CN=John Doe,l Lastname=Doe.

Select Workers to Include in a Directory Service Integration

Prerequisites
• You must have a Directory Service integration system to perform this task.
• If you intend to use a calculated field for the eligibility criterion, create it before performing this task.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Designate a report field or calculated field that identifies if a worker is or isn't eligible for the integration.
The report field or calculated field is based on the Worker business object, and it must return a boolean
true or false. A boolean true includes the worker in the integration, while a boolean false excludes the
worker.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1143

Steps
1. As a related action on the Directory Service integration system, select Integration System > Configure
Integration Field Overrides.
2. In the Field Configuration grid for Account Provisioning Eligibility / Eligibility criterion, select a report
field or calculated field from the Override External Field prompt.

Example
If your integration system target is a directory server that manages all of your staff employees, select the
Worker is Employee field. This field returns true for all your employees, and return false for all of your
contingent workers.
Create a calculated field if your target is a directory server that manages sales staff in Chicago. The field
returns true if the:
• Worker is an employee.
• Worker belongs to a sales organization.
• The worker belongs to the Chicago location.
Related Information
Tasks
Create Calculated Fields

View Directory Service Integration Audits

Prerequisites
Security: Background Process Management domain in the Tenant Non-Configurable functional area.

Context
For each integration event, you can use the Directory Service integration audits to determine:
• Data sent (DataChangesAudit.html)
• Why Workday included the worker in the integration event (DiagnosticAudit.html)
• How the data was grouped on the integration output file (Event_Name.csv or Event_Name.ldif)
• Where Event_Name is the name of the integration eventrvic

Steps
1. As a related action on the integration event, select Background Process > View Output Files.
2. Select an audit file:
Option Description
DataChangesAudit.html For each Integration Field Override Service,
displays field names for each worker, current
and prior field values, and worker transactions.
Workday displays these fields for each field
included on the integration file.
DiagnosticAudit.html For each worker, displays each worker
transaction that the integration detected during
the date range covered by the integration event.
Event_Name.csv Displays the actual output of the integration in
the format that you specified in the integration
Event_Name.ldif
attributes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1144

Concept: Directory Service Integration


The Directory Service integration exports worker data changes from Workday in a format that supports
both LDAP and Microsoft Active Directory servers. This integration assumes that Workday is the source-
of-truth for the HCM data that it exports to your directory servers. As you hire, promote, transfer, terminate,
or update worker data, the integration identifies updates that are relevant to your LDAP or Microsoft Active
Directory servers.
Using Workday-delivered report fields and calculated fields that you create, you can export any worker
data, in any combination.

Change Detection
The Workday transaction log drives the change detection process by tracking event-based changes
to employee data. By configuring integration subscriptions to transaction log events, you can identify
employees whose changes Workday reports. The Directory Service integration detects changes to export
to the directory server by monitoring a transaction log. When you configure the integration, you select
which business process and transaction types that the integration subscribes to. Excluding business
process and transaction types that are irrelevant to your directory service server improves performance.
However, if your integration doesn’t subscribe to a transaction type that affects directory server profiles,
Workday doesn’t include changes for that transaction type. Workday recommends that if you aren’t sure if
the integration must subscribe to a given transaction or business process type, don’t exclude it.
The Directory Service integration uses a three-step process to detect and report changes:
1. The integration checks the transaction log. The integration then determines which workers have had
changes that generated of at least one of the configured transaction events.
2. For each worker with a matching transactional change, the integration compares their report fields for:
• The time at which the integration ran.
• The time at which it was last successfully run.
The integration identifies which, if any, of the values of interest have changed.
3. If the worker has any changes in field values or eligibility, Workday generates an appropriate creation,
change, or deletion message.

Worker Eligibility
For each integration, you define a group of workers a directory server manages, and thus also to the
integration. You define membership with a single Boolean report field or calculated field. If the field value
is true for a worker, that worker is a member of the group, and the integration includes changes for that
worker. If the field value is false, the integration ignores that worker.
You can use report fields on the Worker business object to define eligibility. If you can't match the
membership criteria for your directory server using a report field, you can create and use a calculated field.
If multiple Boolean values are true, the calculated field can evaluate the worker business object and its
related business objects to return true. Example: use a calculated field to return true if:
• The worker is a contingent employee
• The primary location if the worker is in the United States,
• The supervisor of the worker is John Doe
You can configure the eligibility and the relevant data for a given directory server, which your integration
then reflects. If your company uses several directory servers, configure a separate integration for each
directory server. For each integration, identify both the group eligibility along with the detailed data
definition to support each directory server.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1145

Distinguished Name (DN) Support


The Directory Service integration supports both simple and complex DNs. For both types, you set the base
DN of your directory server in the integration attributes. You then define how Workday builds a simple or
complex DN for each worker included on the integration file:
• Include simple DNs. Select a report field (such as Legal Name in Display Format) for the Simple DN /
User Identity field configuration override. Set your prefix (such as CN) in the integration attributes.
• Include complex DNs. Create a calculated field that retrieves values from other report fields, adds the
necessary prefixes, and concatenates them in a text string.

Synchronization Options
The Directory Service integration enables Workday to be your source-of-truth. However, you can configure
your integration to work with existing directory server accounts. The Directory Service integration provides
these synchronization options:
• Create. Use this option if:
• Workday is the primary source of all worker account information on the directory server
• You add workers to Workday before you add them to the directory server.
• Update. Use this option if you add workers to the directory server manually before you add workers to
Workday.
Selecting an option that doesn’t match how you intend to synchronize Workday with your directory server
can cause errors when importing the LDIF file. The LDIF file can instruct the directory server to create an
already-existing account or to modify a nonexistent account.

Output Configuration and Formats


You can include any report fields from the Worker-related business objects (Contingent Worker, Employee,
and Worker) on the integration file. You can add a unique label for each report field that matches the
existing schema on your directory server. When Workday generates an integration file, it combines the field
name and the report field into a single formatted entry.
Workday creates Directory Service integration files in either of these formats:
• LDIF (LDAP Data Interchange Format). This format supports LDAP servers and Microsoft Active
Directory servers.
• CSV (Comma-Separated Value). Workday creates a CSV file that included the values from the report
fields but doesn’t include the field labels.

Launch/Schedule Options
Workday provides these launch schedule options for the Directory Service integration:
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes since the last time that the
integration successfully completed. You can set a Directory Service integration to run several times per
day; launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers.
Example: to cancel a directory server account for a worker immediately, launch the integration
manually. Select the worker from the Workers field. The integration prompts you to enter these launch
parameters:
• Last Successful Launch Moment defaults to the last moment (date and time) at which the
integration was successfully launched. To force the integration to retrieve data changes over a wider
period, you can override this date and time.
• Workers enables you to restrict the integration to only considering those workers selected in this
list. If you configure no values, the integration considers all workers when looking for transactional
and data changes. Specifying workers in this list doesn’t force their inclusion in the output file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1146

Information for a worker displays in the output file only if there are changes in the data fields
evaluated by the integration.
If there was an error involving data for one or more workers during a prior integration run, specify
workers in this parameter at launch time. Correct the worker data and then run the integration again
only for those workers. In this case, set the Last Successful Launch Moment to the date and time
used for that parameter on the prior run which had problems.

Concept: Directory Service Integration Data Mapping


This data mapping example displays how you would map worker data to the inetorgperson Object Class in
the Directory Service integration:
1. Create an Integration Field Override Service named Worker Data. The field names must match the
names from the inetorgperson object class from the inetorgperson schema:
• displayName
• givenName
• sn
• mail
• Secondary Email Address
• employeeType
2. Add the Worker Data integration service to your Directory Service integration system.
3. In the Integration Field Overrides for your integration system, you map Workday report fields to the
fields you defined:

Fields Override External Field


Worker Data / displayName Legal Name
Worker Data / givenName Legal Name - First Name
Worker Data / sn Legal Name - Last Name
Worker Data / mail Email - Primary Work
Worker Data / employeeType Worker Type - Text

When you hire employee John Doe into your company (Acme, Inc. for this example), Workday includes an
entry for John Doe with his simple or complex DN:
dn: CN=john doe,DC=acmeinc,DC=com
changetype:add
objectclass: inetOrgPerson
displayName: John Doe
givenName: John
sn: Doe
mail: john.doe@acmeinc.com
employeeType: Employee

FAQ: Directory Service Integration


What directory servers does the Directory If you configure the LDIF file option, the Directory
Service integration support? Service integration supports both LDAP and
Microsoft Active Directory. Additionally, you can
create the output in CSV format, and optionally

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1147

post-process the file to conform to other directory


server formats.

Can the Directory Service integration connect The integration writes a file in LDIF (LDAP Directory
directly to my directory server? Interchange Format) or CSV format. The integration
posts the file to an FTP or SFTP server that you
specify in the integration attributes. From there,
you can import the file into your directory server.
Workday doesn't have direct access to your
directory server.

If I change a record on my directory server, can I The Directory Service integration design is based
export that change to Workday? on the assumption that Workday is the source-
of-truth, not your directory servers. The Directory
Service integration supports one-way integration
from Workday to your directory server, using an
FTP server. Workday doesn't detect changes made
directly on your directory server.

E-Verify

Setup Considerations: E-Verify Integration


You can use this topic to help make decisions when planning your configuration and use of the Workday
integration with E-Verify. It explains:
• Why to set it up.
• How it fits into the rest of Workday.
• Downstream impacts and cross-product interactions.
• Security requirements and business process configurations.
• Questions and limitations to consider before implementation.
Refer to detailed task instructions for full configuration details.

What It Is
E-Verify is a service provided by the United States Citizenship and Immigration Services (USCIS). You
can enable the Workday E-Verify integration to submit Form I-9 data to E-Verify. The E-Verify integration
supports:
• Case creation and closure at E-Verify.
• Data verification.
• Duplicate case closure.
• Photo match requests from government databases.
• Resubmission of Forms I-9 to E-Verify in bulk.
• Sync of case statuses from E-Verify.
• E-Verify web services account password update.

Business Benefits
You can use the Workday integration with E-Verify to:
• Streamline Form I-9 authorization for your employees.
• Maintain workforce employment eligibility and help your company reach its compliance goals.
• Receive verification results of employment eligibility from the Department of Homeland Security (DHS)
and Social Security Administration (SSA) databases promptly.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1148

• Reduce manual administrative work.

Use Cases
If you’re using an E-Verify STAGE environment, you can test certain outcomes for a better understanding
of what each response means.
You can use the E-Verify integration to receive verification of employment eligibility for your employees.
You can:
• Select if you want to create a new case by closing existing duplicate cases at E-Verify if Workday
identifies more than 1 case with the same SSN in the past 365 days.
• Configure the integration to sync case statuses from E-Verify automatically.
• View any Section 1 or Section 2 information that might need correcting.
• Select if a photo provided by the DHS or SSA databases matches the document the employee
presented. If it doesn’t match, you must scan and upload front and back images of the employee’s
document.

Questions to Consider

Questions Considerations
Can you only have an E-Verify STAGE You must have a production E-Verify account to
Environment account? request an E-Verify STAGE Environment account.
If you’re an implementing customer, enroll in a
production Web services account before requesting
an E-Verify STAGE Environment account.
What if you have an external production account You can still have an existing production account.
and you're transitioning to Workday? E-Verify won't close the existing account until you
instruct them to do so.
Ensure you have the Memorandum of
Understanding (MOU) for Web Services Employers
account type.

What do you do if you have multiple companies


associated with different Federal and State If you have multiple companies associated with
Employer Identification Numbers (FEIN)? different FEIN, you can configure either:
• 1 single Complete Form I-9 and Amend Form I-9
business process with condition rules.
• 1 single Complete Form I-9 and Amend Form I-9
business process for each company so it routes
appropriately.

Recommendations
With the E-Verify integration, Workday recommends you:
• Set up calendar reminders to change passwords. The integration stops working once your password
expires.
• Consider how many companies you have and set up multiple integrations so cases can route correctly.
• Create a validation condition on the Complete Form I-9 business process to require a Social Security
Number (SSN) when an employee completes Section 1. Otherwise, the E-Verify integration fails.
If an employee doesn’t have an SSN on their start date, leave the Review Form I-9 item in the Inbox. If you
submit the case and it fails, you must handle the case separately.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1149

If an employee enters their Foreign Passport number on Section 1 and presents an I-766 document for
Section 2, send back Section 1 so the employee can enter their Alien number. Otherwise, E-Verify won’t
create a case.
If you're using an E-Verify STAGE Environment, don't use real data. Use your own fake data or the
test cases on Workday Community. The E-Verify STAGE Environment isn't as secure as an E-Verify
production account. Since more people can access the STAGE Environment, they can view the information
you use.

Limitations
• The Memorandum of Understanding (MOU) for Web Services Employers is the only Memorandum of
Understanding (MOU) that functions with Workday. This is the MOU required by E-Verify if you use the
Workday integration with E-Verify.
• Workday provides the software integration that allows you to exchange data with E-Verify. However,
pursuant to the Memorandum of Understanding (MOU) your organization signs with E-Verify, you have
the relationship with E-Verify. Workday does not have any control over E-Verify's Web Service. If there
is a technical problem with E-Verify's Web Service, we recommend you contact E-Verify to resolve the
issue.
• E-Verify requires you to update your web services account password every 90 days, and you must wait
at least 5 days before changing it.
• If you get an error when you initially submit a Form I-9, you can only:
• Cancel the Form I-9 and reinitiate it.
• Access the E-Verify website and create a case manually.
• If you use the Retry button to submit a case that requires a photo match, duplicate case, or data
verification, you can only progress the case on the E-Verify website.

Tenant Setup
If you have multiple companies and select the Collect advanced routing fields when Updating Form I-9
Receipts check box on the Maintain Form I-9 Settings task, advanced routing would be a tenant-wide
decision.
When you configure the E-Verify Employment Verification integration template, these attributes will be the
default name sent to E-Verify as the point of contact for case questions:
• E-Verify Contact Name
• E-Verify Email Address
• E-Verify Phone Number
When you configure the Manage E-Verify Duplicate Case Reasons grid on the Maintain Form I-9
Settings task, these reasons are a tenant-wide decision.

Security

Domains Functional Areas Considerations


Integration Build Integration Provides access to setup
information related to integration
systems.
Integration Event Integration Provides access to launching
integrations and viewing their
status in the process monitor.
Integration Debug Integration Provides access to launch and
debug an integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1150

Domains Functional Areas Considerations


Process: I-9 Forms Onboarding Provides access to overall
processing for employees Forms
I-9.
Worker Data: I-9 Forms Onboarding Provides a user with access to
another employee's Form I-9.
Process: Resubmit Form I-9 Onboarding Provides a person access to
resubmit a Form I-9 to E-Verify.

Business Processes

Business Processes Considerations


Amend Form I-9 • Enables an employer to amend Forms I-9 after
the Complete Form I-9 business process.
• Forms only send to E-Verify through the E-Verify
integration using the Update Form I-9 Receipts
task.

Complete Form I-9 (Optional) Employers can configure E-Verify service


steps to send electronic Form I-9 information to the
E-Verify service.

Reporting

Reports Considerations
E-Verify Account Details Lists IDs and other data for all E-Verify integrations
in your tenant.
View E-Verify Account Details Displays enrollment credentials and point-of-contact
information for a single integration system.

Note:
Workday retrieves and saves your E-Verify Account ID to your tenant when you make a service call
through the E-Verify integration. The E-Verify Account ID retrieved can be viewed in E-Verify Account
Details. When E-Verify requires a mandatory web service upgrade, Workday will share your E-Verify
Account ID with E-Verify at their request.

Integrations
If you have multiple companies, you can create a separate integration for each company.

Connections and Touchpoints


You must use the electronic Form I-9 in Workday to use the E-Verify integration.
Workday offers a Touchpoints Kit with resources to help you understand configuration relationships in your
tenant. Learn more about the Workday Touchpoints Kit on Workday Community.
Related Information
Reference
The Next Level: Discover the Capabilities of Workday’s E-Verify Integration
Workday Community: How to Get and Set Up Your E-Verify Staging Account Integration in Workday

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1151

Steps: Set Up E-Verify Integration

Prerequisites
Complete all prerequisites for the E-Verify service.

Context
Create an integration system that connects to the E-Verify service provided by the United States
Citizenship and Immigration Services (USCIS). The integration:
• Submits Form I-9 data to the E-Verify service for employment eligibility verification.
• Receives results for employment eligibility verification, including photos. Department of Homeland
Security (DHS) and Social Security Administration (SSA) databases provide some of these results.
Create 1 E-Verify integration for each separate E-Verify Account ID or Federal Employer Identification
Number (FEIN).

Steps
1. Access the Edit Tenant Setup - System task.
Enable jpeg, pdf, and png file types in the File Type Setup Instructions prompt.
Security: Set Up: Tenant Setup - System domain in the System functional area.
2. Access the Create Integration System task.
Enter E-Verify - Employment Verification at the New using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
3. From the related actions menu on the integration system, select Integration System > Configure
Integration Attributes:

Attribute Value
E-Verify URL Select the staging or production environment URL
you want to use.
E-Verify User Id Enter the ID for the E-Verify web services
account.
E-Verify Password Enter the password for the E-Verify web services
account.
Note: E-Verify requires that you change this
password every 90 days. If you don't do so,
E-Verify locks out your web services account
and the integration will no longer complete
successfully.

E-Verify Contact Name Enter the default name sent to E-Verify as the
point of contact for case questions.
E-Verify Email Address Enter the default email sent to E-Verify as the
point of contact for case questions.
E-Verify Phone Number Enter the default phone number sent to E-Verify
as the point of contact for case questions.
E-Verify Company Enter the company associated with the E-Verify
integration to:
• Sync case statuses from E-Verify.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1152

Attribute Value
• Resubmit Forms I-9 to E-Verify to create cases
when the integration fails to connect.
Configure this attribute for each E-Verify
integration you have.
4. Access the Create Integration System User task to create an ISU.
5. Create Integration System Security Groups.
Create an Integration System User (ISU) with an unconstrained security group, and grant the ISU Get
and Put access to these domains:
• Integration Event
• Person Data: ID Information
• Person Data: Name
• Person Data: Personal Data
• Person Data: Personal Information
• Worker Data: I-9 Forms
• Worker Data: Staffing
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
6. From the related actions menu of the E-Verify Integration, access Workday Account > Edit and add
the ISU you created.
7. Create Integration (Step).
Enable launch of the integration from these business processes:
• Complete Form I-9
• Amend Form I-9

Next Steps
Access the Maintain E-Verify Account Details task. Record, maintain, and retrieve your E-Verify
enrollment credentials and point-of-contact associated with your E-Verify integrations.
Workday provides these reports for E-Verify account detail information:
• View E-Verify Account Details displays enrollment credentials and point-of-contact information for a
single integration system.
• E-Verify Account Details lists IDs and other basic data for all E-Verify integrations in your tenant.
Note:
Workday retrieves and saves your E-Verify Account ID to your tenant when you make a service call
through the E-Verify integration. The E-Verify Account ID retrieved can be viewed in E-Verify Account
Details. When E-Verify requires a mandatory web service upgrade, Workday will share your E-Verify
Account ID with E-Verify at their request.

Complete Set Up and Upgrade Prerequisites for E-Verify Integration

Context
Enroll in E-Verify and send a request email to E-Verify for access to the E-Verify service. Then create your
E-Verify integration.
If you're not using the most current version of E-Verify, contact support to request an upgrade.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1153

Steps
1. Enroll in the E-Verify program from the U.S. Citizenship and Immigration Services:
a) Sign up with E-Verify through the enrollment website.
b) Define your access methods (Web Services Employer ).
c) Execute the Memorandum of Understanding (MOU) for Web Services Employers .
d) Add Company and Program Administrator details.
e) Assign the E-Verify Program Administrator and have the administrator complete the E-Verify
Knowledge Session and test.
f) Add any other hiring sites or verifiers defined within the service.
Note: For existing E-Verify accounts that need to change their access method, re-enroll and create a
new account. Example: You currently have an employer agent account and want to change your access
method to web services. Then, re-enroll and create a new web services account.
2. Send an email to E-Verify to request production and staging accounts. For instructions, see: Request
Access to Your E-Verify Staging and E-Verify Production Accounts.
You must create E-Verify staging accounts to start testing the E-Verify integration.
E-Verify provides you with your web service credentials for the production E-Verify endpoint.
3. Create an E-Verify integration system in your Workday Production tenant.
When configuring the E-Verify Environment URL integration attribute, set it to the E-Verify production
URL.
Related Information
Tasks
Steps: Set Up Electronic Form I-9
Reference
The Next Level: Discover the Capabilities of Workday’s E-Verify Integration
Workday Community: How to Get and Set Up Your E-Verify Staging Account Integration in Workday

Launch E-Verify Integration Manually

Prerequisites
Security: Integration Event domain in the Integration functional area.

Context
Launch the E-Verify integration manually to:
• Change your E-Verify password.
• Close cases.
• Verify the E-Verify service is running and accepting requests from your integration.
• Verify your username and password.
• Select the run frequency to run now, or schedule a recurring sync of:
• E-Verify case statuses.
• Resubmitting Forms I-9 in bulk to E-Verify.
If the E-Verify service is down and you don't want to resubmit Forms I-9 in bulk, you can resubmit an
employee manually when the Complete Form I-9 business process launches the E-Verify integration.
However, when you manually relaunch the integration, the launch isn't within the context of the Complete
Form I-9 business process. Therefore:
• Once you manually relaunch the integration, you perform all further verification tasks directly in the E-
Verify service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1154

• Workday recommends that you find the instance of the Complete Form I-9 business process and
complete the last step if E-Verify doesn't return an Employment Authorized status.

Steps
1. Access the Launch / Schedule Integration task.
2. Select the Integration at the prompt.
3. Determine the Run Frequency, then select OK.
4. In the Integration Criteria grid, specify the applicable launch parameters:

E-Verify Service Call Values Usage Description Launch Parameter


ChangePassword Sends a password change Enter a new password in the
command to the E-Verify New E-Verify Password field.
service.
CloseCase Enables you to manually close a Enter these parameters:
case.
• E-Verify Case Number
• E-Verify Case Closure
Reason
• E-Verify Case Closure
Reason Details (Optional)
• Submit Employee ID

CloseMultipleCases Enables the E-Verify integration Not Applicable


to assess and close multiple
cases. You can't manually run
this service call.
GetCaseClosureReason Retrieves all case closure E-Verify Case Number
reasons for open duplicate
cases.
MassRetry Resubmits Forms I-9 to E-Verify Default Overdue Reason
based on the schedule you (Optional)
determine. This creates cases
Default Overdue Reason Other
when the integration fails to
(Optional)
connect due to:
• An integration template error.
• Events such as a government
shutdown.
• E-Verify password expiration.
Note: If your integration
events fail due to E-Verify
password expiration, Workday
recommends that you reset
your password before you
manually run the integration with
the MassRetry service call to
reprocess impacted workers.

SyncCaseStatus Syncs case statuses from E- Not Applicable


Verify based on the schedule
you determine.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1155

E-Verify Service Call Values Usage Description Launch Parameter


Before you select this option,
select a valid company for the
E-Verify Company attribute
on the E-Verify - Employment
Verification integration template.
Valid companies include any
workers with possible new or
updated Forms I-9.

VerifyConnection Pings the E-Verify service to Not Applicable


verify that:
• The E-Verify service is
running.
• The user ID and password
are valid.
• The service is accepting web
service requests.

VerifyCredentials Enables you to verify your E- Not Applicable


Verify username and password
when you run the integration.
WorkerSubmit Manually resubmits the worker Enter these parameters for
I-9 data. Use this option if the E- the employee who you want to
Verify service was down when resubmit to E-Verify:
the Complete Form I-9 business
• Submit Employee ID
process launched the E-Verify
integration. • Default Overdue Reason
• Default Overdue Reason
Other

5. Select OK to launch the integration.

Change E-Verify Account Password

Prerequisites
Security: Integration Build, Integration Event, and Integration Debug domains in the Integration functional
area.

Context
United States Citizenship and Immigration Services (USCIS) requires that you change your E-Verify
account password every 90 days. If you don't change your password within 90 days, E-Verify locks your
account. To change your password after the 90-day limit, see E-Verify - Resetting password and unlocking
E-Verify Web Services account. You must wait at least 5 days before changing your password again.
Use the Launch / Schedule Integration task for your E-Verify integration, enter a new password, and
send the password update request to the E-Verify service. It is your responsibility to adhere to the E-Verify
password rules as defined by USCIS.

Steps
1. Access the Launch / Schedule Integration task.
2. Select the Integration at the prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1156

3. Select Run Now as the Run Frequency, then select OK.


4. In the Integration Criteria grid, specify launch parameters:
Option Description
E-Verify Service Call Select ChangePassword from the Value prompt.
New E-Verify Password Enter the new password in the Value field.
E-Verify requires that your password contains:
• At least 1 uppercase or lowercase letter.
• At least 1 number.
• At least 1 special character.
• No more than 2 identical, consecutive
characters in any position from the previous
password.
• A non-numeric in the first and last position.
Workday recommends you follow best practices
when creating passwords.

5. Select OK to launch the integration.


The integration updates the password for the E-Verify web services account on the USCIS / E-Verify
server. You still need to update the password on your E-Verify integration.
6. From the related actions menu of the integration system, select Integration System > Configure
Integration Attributes and update the E-Verify Password attribute value.

Concept: E-Verify Integration


Integrate Workday with the E-Verify service provided by the United States Citizenship and Immigration
Services (USCIS). Use the E-Verify integration to:
• Submit Form I-9 data to the E-Verify service.
• Receive verification results of employment eligibility (including photos) from Department of Homeland
Security (DHS) and Social Security Administration (SSA) databases promptly.
The integration supports:
• Case creation.
• Duplicate cases.
• Syncing case statuses.
• Data verification.
• Photo match requests.
• Scan and upload requests.
• Closing cases.
• Updating the E-Verify web services account password.

Preparing to Use E-Verify


The E-Verify integration is available for organizations that are already in the E-Verify program. For details,
see the E-Verify website.
Workday strongly recommends that you're familiar with the E-Verify program before creating an E-Verify
integration, especially:
• When manually processing verifications.
• In the E-Verify work flow.
Before using E-Verify, you need to:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1157

1. Review the E-Verify Memorandum of Understanding (MOU) and familiarize yourself with your
responsibilities when using E-Verify.
1. Define your E-Verify participation sites, where all new hires take part in E-Verify.
2. Define your E-Verify Program Administrator.
3. Define members who need access to the E-Verify website to run cases manually. This supports
management of cases outside of Workday.
When you're ready, you can enroll in E-Verify through the enrollment website. Review the enrollment
checklist and ensure that you've all of the required information before you select Begin E-Verify Enrollment.

Before Starting a Workday to E-Verify Integration


• Establish a Memorandum of Understanding (MOU) between your organization and E-Verify. Ensure
that you select the Employers Web Services type. Workday recommends that you complete this step
before any testing and data exchange takes place between your data and the DHS.
• Appoint a program administrator who is provided access to E-Verify directly.

Integration Process
The E-Verify integration exchanges data with the E-Verify website using this process:
1. The Complete Form I-9 or Amend Form I-9 (updating receipts only) business process passes Form I-9
information for an employee to the E-Verify integration.
2. The Complete Form I-9 or Amend Form I-9 (updating receipts only) business process launches the E-
Verify integration.
3. The E-Verify integration sends Form I-9 data to the E-Verify service.
4. The E-Verify service checks Form I-9 data against DHS and SSA records.
5. The E-Verify service sends eligibility results back to the E-Verify integration.
6. The E-Verify integration processes the eligibility results and does one of these actions:
• If the Form I-9 data matches government databases, the case receives an Employment Authorized
status and the case automatically closes.
• If E-Verify identifies cases for an employee created within 365 days, you can close all their duplicate
cases before creating a new case at E-Verify.
• If E-Verify queues a case, you can schedule the integration to sync an updated case status so the
case can progress forward.
• If E-Verify has a photo on file, the Complete Form I-9 or Amend Form I-9 business process routes a
photo match request to the appropriate role.
• If E-Verify returns a MANUAL_REVIEW status, an individual at the DHS is physically reviewing the
case information. You can schedule the integration to sync the updated status.
• If E-Verify didn't find a matching record, the Complete Form I-9 business process routes a retry
request to the appropriate role. The role holder then amends the Form I-9 data and reverifies the
data with E-Verify.
Note: If the second attempt fails, DHS returns a PENDING_REFERRAL case status for the
employee.
• If the Form I-9 information included the email address for the employee, E-Verify emails updates on
the verification process to that email address.

E-Verify Integration Limitations


Only run the E-Verify integration with live data from your Production environment. Never send test data to
E-Verify from any Workday environment.
If DHS or SSA returns a PENDING_REFERRAL case status for an employee whose credentials don't
match DHS or SSA records:
• You can't process the verification request further in Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1158

• You must use the E-Verify website directly to progress the case and bring the final case status back into
Workday to complete it.
When you receive the Form I-9 Data Verification event, you can only update information E-Verify identifies
as incorrect. Otherwise, you must wait until the Form I-9 is completed to initiate the Amend Form I-9 task.
When you’re using the Update Form I-9 Receipts task, you can’t receive the Form I-9 Data Verification or
Photo Match responses.
If you don't configure the integration to sync case statuses, you must use the E-Verify website directly
if the U.S. Employment Verification Status returns as Authorization Pending. If you do configure the
integration to sync case statuses, you can continue syncing until the case reaches closure. Once receiving
closure, Workday closes the case automatically. The integration syncs case statuses that don't require a
photo match or data verification.
Related Information
Tasks
Complete Set Up and Upgrade Prerequisites for E-Verify Integration on page 1152
Steps: Set Up Electronic Form I-9

Concept: Mass Resubmit Forms I-9 to E-Verify


You can resubmit Forms I-9 to E-Verify in bulk based on the frequency and schedule you determine. If
you decide to schedule the resubmission on a recurring basis and use a frequency other than Run Now,
Workday recommends selecting a Start Time at nonpeak or off-hours.
The Launch / Schedule Integration task displays the overdue reason configured on the Overdue
Reason prompt on the Maintain Form I-9 Settings task. Specifying an overdue reason on the Form I-9
takes precedence over the overdue reason that displays on Launch / Schedule Integration task.
If you resubmit a Form I-9 that later requires any of these responses, you can only progress the case at the
E-Verify website:
• Photo match.
• Duplicate case.
• Data verification.
You can't resubmit Forms I-9 in bulk that has a validation error, such as an:
• Invalid document number.
• Incorrect social security number.
The mass resubmission won't include the Forms I-9 for employees that have multiple positions in different
companies and self-initiate the Complete Form I-9 task (not part of the Onboarding or Manage Form I-9
Assignment business processes).
You can resubmit self-initiated Forms I-9 through the:
• Integration using the WorkerSubmit option for the E-Verify Service Call field.
• Retry button on the Final U.S. Employment Verification Status step.
To verify the U.S. Employment Verification Status of employees whose Forms I-9 you resubmitted in bulk,
you can use the U.S. Electronic Form I-9 Verifications report.

Image Upload

Steps: Set Up Integration to Load Worker Photos in Bulk

Context
You can create an integration to upload multiple worker photos from an external server.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1159

Steps
1. Create Integration System.
Enter the Image Upload Template on the New Using Template prompt.
2. Access the Create an Integration System User task.
Security: Integration Security domain in the Integration functional area.
3. Grant the ISU Put access to these domains:
• Integration Event
• Person Data: Personal Photo
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
5. Access the Configure Integration Services task.
Enable the Document Image Retrieval Service, and don't enable the FTP client. You can't use both
at the same time. We recommend using the Document Image Retrieval Service because it supports
multiple protocols.
6. (Optional) Set Up Integration Retrieval.
Complete this step if you enabled the Document Image Retrieval Service.
7. Launch an Integration .
Related Information
Tasks
Launch an Integration on page 23
Steps: Grant Integration or External Endpoint Access to Workday

Concept: Worker Photo Recommendations


Once you upload an image, it can display in many places throughout Workday. Therefore, images are
dynamically scaled and cropped so that they display at an appropriate size. Although an image might be
scaled and cropped at run time, the aspect ratio of the original image never changes.
For best results and performance, follow these guidelines:

Feature Description
Size The maximum image size (in terms of storage) is
10 MB.
Aspect Ratio Use square images for best results. Because
images typically display as circles within Workday,
images in any other shape don't fit properly,
resulting in white spaces in the circular area. An
image about 200 x 200 pixels produces good
results for most applications. Example: The worker
profile image is 150 x 150 pixels. Elsewhere, the
same images might display at 50 x 50 pixels. At
run time, users can enlarge the image to its original
size.
Background A transparent background (available with PNG
images, but not with the JPG format) is optimal.
However, a solid white background also produces
good results.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1160

Feature Description
Color Space Workday doesn't support images in the CMYK color
space.
File Format Workday supports JPG, PNG, and GIF formats for
worker images. However, PNG and JPG images
produce the best results in terms of size and
quality. Worker images in GIF format might produce
undesirable results when resized for different uses
at run time.
Layout Use a consistent photographic layout for all
workers.

Related Information
Tasks
Load Worker Photos Individually
Steps: Set Up Integration to Load Worker Photos in Bulk

Inline Assessments

Steps: Set Up Inline Assessments Integration

Prerequisites
Know the user name, password, and endpoint URL for the external site for the assessment vendor.

Context
You can create an integration with third-party assessment vendors for registering candidates that have
applied for a job using an external career site.

Steps
1. Access the Create Integration System task and enter Inline Assessment at the New using Template
prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Candidate Data: Assessment Results
• Integration Event
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.

Concept: Inline Assessments Integration


The Inline Assessments integration enables you to integrate with third-party assessment vendors for
registering candidates that are applying for a job using an external career site. Workday provides the Inline
Assessment integration template. The integration exports these fields (in a Workday-defined XML format)
to the external assessment vendor:
• Assessment Test Reference (WID, ID)
• Job Application Reference (WID, ID)

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1161

• Candidate Reference (WID, ID)


• Candidate First Name
• Candidate Last Name
• Candidate Email

Integration Services
The Inline Assessment integration template includes these integration services:

Integration Service Required? Description


Inline Assessment Registration - Required Launches the integration.
ESB Service
Integration Document Retention Required Retains copy of each integration
file

Launch/Schedule Options
Workday launches the integration automatically when:
• A candidate advances past the first application page on the external career site.
• The job requires an inline assessment.

Reference: Inline Assessments Integration XML Schema

Inline Assessment XML Element Reference

XML Element Description


Register_Candidate_Request Parent element for these subelements:
• Assessment_Test_Reference
• Job_Application_Reference
• Candidate_Reference
• Candidate_First_Name
• Candidate_Last_Name
• Candidate_Email

Assessment_Test_Reference Must be a Reference ID value.


Job_Application_Reference Must be a Reference ID value.
Candidate_Reference Must be a Reference ID value.
Candidate_First_Name Must be in XSD string format.
Candidate_Last_Name Must be in XSD string format.
Candidate_Email Must be in XSD string format.

Inline Assessment Integration Sample XML File


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:wor="http://www.workday.com/WorkdayInlineAssessment/">
<soapenv:Header/>
<soapenv:Body>
<wor:Register_Candidate_Request wor:version="?">
<!--Optional:-->
<wor:Candidate_First_Name>?</wor:Candidate_First_Name>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1162

<!--Optional:-->
<wor:Candidate_Last_Name>?</wor:Candidate_Last_Name>
<wor:Candidate_Email>?</wor:Candidate_Email>
<wor:Candidate_Reference_ID>?</wor:Candidate_Reference_ID>
<wor:Job_Application_Reference_ID>?</
wor:Job_Application_Reference_ID>
<wor:Assessment_Test_Reference_ID>?</
wor:Assessment_Test_Reference_ID>
</wor:Register_Candidate_Request>
</soapenv:Body>
</soapenv:Envelope>

Kenexa Connectors

Steps: Set Up Kenexa Foundation Data Integration

Prerequisites
• Know the sender ID, client ID, and endpoint URL for your Kenexa account.
• Use the Job Management staffing model for your organization. If you use the Position Management
staffing model, you can’t use this Connector.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To send foundation data to your Kenexa account, create and configure a Kenexa Foundation Connector
integration system.

Steps
1. Access the Create Integration System task and enter Kenexa Foundation Data at the New using
Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Enable one or more of the optional integration services.
The Configure Integration Services task displays all integration services, including required services.
Required integration services aren’t editable.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
security domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Workday displays attributes for each enabled integration service; if you enable additional integration
services, more attributes display in the Configure Integration Attributes task.
5. As a related action on the integration system, select Integration System > Configure Integration
Maps and map data between Workday and Kenexa.

Steps: Set Up Kenexa User Provisioning Connector

Prerequisites
• Use the Job Management staffing model for your organization. If you use the Position Management
staffing model, you can’t use this Connector.
• Create a True/False Condition calculated field that returns true for any workers that you want to include
in the integration output.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1163

• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
To send new and changed worker data to your Kenexa account, create and configure an integration based
on the Kenexa User Provisioning integration template.

Steps
1. Access the Create Integration System task and enter Kenexa User Provisioning at the New using
Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
security domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
For Eligibility Criteria, select a True/False Condition calculated field that returns true for any workers
that you want to include in the integration output.
4. Select Integration System > Configure Field Overrides for Data Initialization Services as a related
action on the integration system.
Use calculated fields and report fields to define overrides.
5. Set Up Integration Delivery on page 1839
Specify how Workday delivers integration output documents. Configuring a Document Delivery step on
the business process definition for the integration.
6. Launch an Integration on page 23.
Launch the integration manually or configure a recurring schedule.

Steps: Set Up Kenexa Hire Inbound Integration

Prerequisites
• Set up an external SFTP that Kenexa and your integration can access.
• Use the Job Management staffing model for your organization. If you use the Position Management
staffing model, you can’t use this Connector.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Set up an integration system to import new hire data from Kenexa into Workday.

Steps
1. Access the Create Integration System task and enter Kenexa Hire Inbound at the New using
Template prompt.
Security: Integration Build in the Integration functional area.
(Optional) To import payment elections and tax-related data, enable the Kenexa Hire Inbound - Pay and
Tax Service.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1164

2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these security
domains:
• Contract Contingent Worker (business process)
• Hire (business process)
• Manage: Payment Election
• Manage Pre-Hire Process: Manage Pre-Hires
• Personal Information Change (business process)
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. As a related action on your Kenexa Hire Inbound integration, select Integration System > Configure
Integration Attributes add a row for each attribute and specify a value.
4. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves data files from the SFTP server.
5. Launch an Integration on page 23.
Schedule how often the integration system runs.

Concept: Kenexa Connector


Synchronize data between Workday and IBM Kenexa® Talent Acquisition Suite with the Kenexa
Connector. These Connectors enable you to establish an integration between your Workday tenant and
Kenexa, for workers in the United States only. To support Kenexa, Workday provides 3 Kenexa integration
templates:
• Kenexa Foundation Data
• Kenexa User Provisioning
• Kenexa Hire Inbound
To integrate Workday with Kenexa, implement all 3 Kenexa integrations. Kenexa Connectors support the
Job Management staffing model only. If you use Position Management in your tenant, you can’t use these
Connectors.

Kenexa Foundation Connector


The Kenexa Foundation Data template supports export of organization, location, job family, job
classification, and job profile data from Workday to Kenexa BrassRing. As you add, change, move, and
delete these items, the integration sends updates directly to your Kenexa account.

Integration Service Description


Kenexa Foundation Data - Organizations Data Init Extracts organization structure changes from your
Service tenant. You can select types of organizations that
the integration monitors for changes.
Kenexa Foundation Data - Locations Data Init Extracts location changes from your tenant. You
Service can select types of locations that the integration
monitors for changes.
Kenexa Foundation Data - Job Families Data Init Extracts job family changes from your tenant.
Service
Kenexa Foundation Data - Job Profiles Data Init Extracts job profile changes from your tenant.
Service
Kenexa Foundation Data - Job Classifications Data Extracts job classification changes from your
Init Service tenant.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1165

Kenexa Account Provisioning Connector


The Kenexa User Provisioning template enables you to create, update, and disable accounts in Kenexa
Talent Acquisition Suite. As you hire, transfer, and terminate workers, the integration generates a CSV file
with the changes. The integration then delivers the CSV file to an SFTP site. The template enables you to
filter output so that the integration sends only data for eligible workers.

Kenexa Hire Inbound


The Kenexa Hire Inbound template enables you to import Kenexa Onboarding XML files containing new
hire data from an external SFTP site. Workday provides the XML file format. You can customize element
names as part of the field mapping. Contact Kenexa for assistance in formatting and generating the
inbound XML file.
To support multiple input files and prevent duplicates, you can configure a uniqueness check in the
Connector. You can select either Worker ID or Custom ID as the unique attribute. A uniqueness check
ensures that there are no duplicate records in the input file. The uniqueness check also determines
if Workday has assigned the Worker ID or Custom ID to an active worker. This verification enables
processing of multiple input files. Workday also requires uniqueness checking to rehire workers who you
previously terminated but didn’t have a Workday account during their previous tenure.

Integration Launch and Scheduling


Workday provides these launch schedule options for Kenexa Foundation Connector and Kenexa Account
Provisioning integrations:
• Launch using a schedule. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters.
• Launch immediately. You can launch the integration manually. Workday prompts you for the launch
parameters.
For launch using a schedule and launch immediately, you can enter these launch parameters:

Parameter Description
As Of Entry Moment Extracts records that you entered into Workday
after the specified moment.
Effective Date Extracts records that became effective in Workday
on or after the specified date.
Last Successful As Of Entry Moment Extracts records that you entered into Workday
after this date/time.
Last Successful Effective Date Extracts records with an effective date after this
date.

Integration Audit Files


Every time a Kenexa Connector integration runs, Workday generates these files:
• (Outbound Connectors only) A copy of the outbound file. The integration retains this document for a
length of time that you define.
• The MessagesAudit.zip file includes troubleshooting files that confirm data processing steps.
• (Outbound Connectors only) The Data Changes Audit is a readable version of the integration output file.
• (Outbound Connectors only) The Diagnostic Audit is designed to help you troubleshoot integration
errors.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1166

Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if administrators can’t have access to the data.

Reference: Kenexa User Provisioning Attributes


This table lists all available attributes that the Kenexa User Provisioning integration supports. Contact
Kenexa for configuration assistance.

Attribute Required?
First Name Y
Last Name Y
Middle Name N
User Name Y
Email Address Y
HRIS Employee Id Y
Phone Number N
Phone Extension N
Job Title N
Active Y
Country Y
Locale Y
Fax Number N
Sender Employee Id Y
Source N
User SSO Id N
SSO Enabled N
Expiration Date N
Validity Date N
BR Hiring Access Y
BR User Type Y
BR Approval Groups N
BR Code Access Groups N
BR Express User Y
BR KIB User Group N
BR Manager Y
BR Organization Group Y
BR Recruiter Y
BR User Group Y
OB Manager Access Y

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1167

Attribute Required?
OB User Type Y
OB User Group Y
TM Performance Access Y
TM User Type Y
Department N
BRTG Job Access Y
Connections Social Access Y
TimeZone Y
TS Admin Access Y
TS Admin User Type Y
TI Talent Access Insights Y

Reference: Kenexa Hire Inbound Attributes


This table lists all available attributes that the Kenexa Hire Inbound integration supports. Contact Kenexa
for configuration assistance.

Field Description Required? Comments


Country Employee Country – Required Defined by Workday
Drives Employee Name integration mapping. ISO
Data Logic 3166-1 alpha 3.
Worker_ID Specify the Employee Optional Workday uses this
or Contingent Worker ID value to look up existing
that identifies the Worker applicants that were
record. previous employees
or contingent workers.
Workday also uses this
value as the HRIS ID for
new workers.
Applicant_ID Specify the Applicant ID Optional Workday generates an
for the pre-hire record. ID when no ID exists on
the file. Workday doesn't
use this value to find
pre-hires.
Title_Prefix Employee Prefix Data Optional Defined by Workday
integration mapping
Name_Suffix Employee Suffix Data Optional Defined by Workday
integration mapping
Salutation_Prefix Optional Defined by Workday
integration mapping
First_Name Required Conditionally Required
Based on Country
Reference

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1168

Field Description Required? Comments


Middle_Name Optional
Last_Name Required Conditionally Required
Based on Country
Reference
Secondary_Last_Name Optional Conditionally required
based on Country
Reference.
Local_First_Name Optional Conditionally required
based on Country
Reference.
Local_Last_Name_2 Optional Conditionally required
based on Country
Reference.
Local_Middle_Name Optional Conditionally required
based on Country
Reference.
Local_Middle_Name_2 Optional Conditionally required
based on Country
Reference.
Local_Last_Name Optional Conditionally required
based on Country
Reference.
Local_Last_Name_2 Optional Conditionally required
based on Country
Reference.
Local_Secondary_Last_Name Optional Conditionally required
based on Country
Reference.
Local_Secondary_Last_Name_2 Optional Conditionally required
based on Country
Reference.
Email Address Optional Text Field
Email_Address_Public Optional Text Field
Work_Email_Address Optional Text Field
Work_Email_Address_Public Optional Boolean True/False
value (1 or 0).
Phone Device Type Required Defined by Workday
integration mapping.
Phone Number Required Text Field
Address Data Can repeat 3 Address See default mapping in
records. Example: tenant for default field
Address_2_Address_Country values.
Address_Country Optional Conditionally required
based on Country

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1169

Field Description Required? Comments


Reference. ISO 3166-1
alpha 3.
Address_Effective_Date Optional Conditionally required if
loading address data
Municipality City for the Home Optional Conditionally required
Address of the worker. based on Country
Reference.
Region State for the Home Optional Conditionally required
Address of the worker. based on Country
Reference. ISO 3166-1
alpha 3.
Postal Code Optional Conditionally required
based on Country
Reference.
Region_Subdivision_1 Region subdivision Optional
Region_Subdivision_2 Region subdivision Optional
Region_Subdivision_1_Local
Region subdivision Local Optional
Region_Subdivision_2_Local
Region subdivision Local Optional
City_Subdivision_1 City subdivision Optional
City_Subdivision_1_Local City subdivision Optional
City_Subdivision_2 City subdivision Local Optional
City_Subdivision_2_Local City subdivision Local Optional
Municipality - Local Municipality Local Optional
Address_Line_1 Optional
Address_Line_1_Local Optional
Address_Line_2 Optional
Address_Line_2_Local Optional
Address_Line_3 Optional
Address_Line_3_Local Optional
Address_Line_4 Optional
Address_Line_4_Local Optional
Address_Line_5 Optional
Address_Line_5_Local Optional
Address_Line_6 Optional
Address_Line_6_Local Optional
Address_Line_7 Optional
Address_Line_7_Local Optional
Address_Line_8 Optional

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1170

Field Description Required? Comments


Address_Line_8_Local Optional
Address_Line_9 Optional
Address_Line_9_Local Optional
Birth_Date Optional Text Field: YYYY-MM-
DD. ISO 8601.
Gender Optional Defined by Workday
integration mapping.
Country_of_Birth Optional Defined by Workday
integration mapping. ISO
3166-1 alpha 3.
Region_of_Birth State of Birth for the Optional Defined by Workday
employee. integration mapping. ISO
3166-2
City_of_Birth City of Birth for the Optional
employee.
Marital_Status Marital status date of the Optional Defined by Workday
person. integration mapping
Marital_Status_Date Optional
Citizenship_Status Optional
Ethnicity Optional Defined by Workday
integration mapping
Nationality Nationality Reference for Optional Defined by Workday
the employee. integration mapping. ISO
3166-1 alpha 3.
Native_Country_Region Optional Defined by Workday
integration mapping. ISO
3166-1 alpha 3.
Military_Status Optional Defined by Workday
integration mapping
Military_Status_Begin_DateBeginning date for Optional
military service status.
Military_Service_Type Service type for military Optional
service
Military_Rank Military rank for military Optional
service type
Military_Notes Notes for military service Optional
Discharge_Date Optional Text Field: YYYY-MM-
DD. ISO 8601.
Personnel File Agency Personnel File Agency Optional
(China) Indicates where
workers have their
personnel file stored.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1171

Field Description Required? Comments


Date_of_Death Date of death for the Optional
worker.
Tobacco_Use Tobacco usage for the Optional
person.
Hispanic_or_Latino_for_Visual_Survey
Reference to visual Optional
survey ethnicity for the
person.
Hispanic_or_Latino Boolean. Reference to Optional
visual survey ethnicity
for Hispanic or Latino for
the person.
Religion Reference for religions Optional
for the person.
Personnel_File_Agency Optional
Hukou_Region Country Region of the Optional
Hukou of the person.
Hukou_Subregion Country Subregion on Optional
the Hukou of the person.
Hukou_Locality Locality on the Hukou of Optional
the person
Hukou_Postal_Code Hukou Postal Code for Optional
the Person
Hukou_Type Hukou Type on the Optional
Hukou of the person.
Native Country Region Native Region on the Optional
Hukou of the person.
Political_Affiliation Political affiliation of the Optional
person.
Last_Medical_Exam_Date Date of most recent Optional
medical examination for
the person.
Last_Medical_Exam_Valid_To
Expiration date of Optional
most recent medical
examination for the
person.
Medical Exam Notes Notes for the most Optional
recent medical
examination for the
person.
Social_Benefits_Locality Social Benefits Locality Optional
for the person.
Relative Data Can repeat 3 Relative See default mapping in
records. Example: tenant for default field
Relative_Type_1 values.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1172

Field Description Required? Comments


Relative_Type_1 Specifies the relative Optional
person relationship.
Relative_Country_1 The country that the Optional
name is for.
Relative_Title_1 A reference to the title Optional
for a person.
Relative_Salutation_1 Reference to the form Optional
of address for a person.
Valid for Germany only.
Relative_First_Name_1 The first name (given Optional
name) for a person.
Relative_Middle_Name_1 The middle name for a Optional
person.
Relative_Last_Name_1 The last name (family Optional
name) for a person
Relative_Social_Suffix_1 A reference to the social Optional
suffix for a person.
Custom ID Data Can repeat 10 Custom See default mapping in
ID records. Example: tenant for default field
Custom_ID_1 values.
Custom_ID_1_Type Conditionally Required Defined by Workday
When Custom ID Data is integration mapping
Provided
Custom_ID_1 Conditionally Required Text
When Custom ID Data is
Provided
Passport_ID_Issuing_Country Optional Conditionally required
when passport data
exists on the file.
Defined by Workday
integration mapping. ISO
3166-1 alpha 3.
Passport_ID_Type Optional Conditionally required
when passport data
exists on the file.
Defined by Workday
integration mapping
Passport_ID Optional Conditionally required
when passport data
exists on the file.
Passport_ID_Issued_Date Optional
Passport_ID_Expiration_Date Optional
Passport_ID_Issuing_Country Optional

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1173

Field Description Required? Comments


Visa_ID_Issuing_Country Optional Conditionally required
when visa data exists
on the file. Defined by
Workday integration
mapping. ISO 3166-1
alpha 3.
Visa_ID_Type Optional Conditionally required
when visa data exists
on the file. Defined by
Workday integration
mapping
Visa_ID Optional Conditionally Required
When Visa Data is
Provided
Visa_ID_Expiration_Date Optional
Visa_ID_Issued_Date Optional
Government ID Data Can repeat 10 See default mapping in
Government ID records. tenant for default field
Example: Custom_ID_1 values.
Government_ID_1 Optional
Government_ID_1_Expiration_Date Optional
Government_ID_1_Issued_Date Optional
Government_ID_1_Issuing_Country Conditionally Required
When Government ID
Data is Provided
Government_ID_1_Type Conditionally Required
When Government ID
Data is Provided
National ID Data Can repeat 10 National See default mapping in
ID records. Example: tenant for default field
National_ID_1 values.
National_ID_1_Type Conditionally Required Defined by Workday
When National ID Data integration mapping. Add
is Provided numbers to repeating
elements. Example:
National_ID_Reference1,
National_ID_Reference2.
National_ID_1_Issuing_Country Conditionally Required Defined by Workday
When National ID Data integration mapping. Add
is Provided numbers to repeating
elements. Example:
Issue_Country_Reference1,
Issue_Country_Reference2.
ISO 3166-1 alpha 3.
National_ID_1_Issuing_Agency Text Field

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1174

Field Description Required? Comments


National_ID_1_Expiration_Date Text Field: YYYY-MM-
DD. ISO-8601
National_ID_1_Issued_Date Text Field: YYYY-MM-
DD. ISO-8601
National_ID_1_Series Text Field
National_ID_1 Can repeat 10 National Conditionally required Add numbers to
ID values. when National ID data repeating elements.
exists on the file. Example: National_ID1,
National_ID2
User_Name Workday Account User Optional Text Field
Name for the employee.
Hire_Date Required Text Field: YYYY-MM-
DD. ISO-8601
Hire_Reason Conditionally Required Defined by Workday
integration mapping
Employee_Type Conditionally Required Defined by Workday
integration mapping
Contingent_Type Conditionally Required Defined by Workday
integration mapping
Contract_Reason Conditionally Required Defined by Workday
integration mapping
Job_Profile You can use a Kenexa Required Job Code from
Foundation Data Foundation Data
integration to load this Integration.
data.
Position_Time_Type Required Defined by Workday
integration mapping
Default_Hours Optional Text
Scheduled_Hours Optional Text
Work_Shift Optional Defined by Workday
integration mapping
Work_Hours_Profile Optional Defined by Workday
integration mapping
Job_Classification You can use a Kenexa Optional Reference ID from
Foundation Data Foundation Data
integration to load this Integration.
data.
Location You can use a Kenexa Required Reference ID from
Foundation Data Foundation Data
integration to load this Integration.
data.
Supervisory_Organization You can use a Kenexa Required Send Kenexa
Foundation Data corresponding object

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1175

Field Description Required? Comments


integration to load this ID if the data exists in
data. Kenexa.
Start_Date Optional YYYY-MM-DD. ISO
8601
End_Date Conditionally Required YYYY-MM-DD. ISO
Based on Employee 8601
Type.
Continuous_Service_Date Optional YYYY-MM-DD. ISO
8601
Probation_Type_Reference Optional Defined by Workday
integration mapping
Probation_Start_Date Optional YYYY-MM-DD. ISO
8601
Probation_End_Date Optional YYYY-MM-DD. ISO
8601
Probation_Extended_End_Date Optional YYYY-MM-DD. ISO
8601
Probation_Note Optional Text
Probation_Period_Reference Optional Defined by Workday
integration mapping
Probation_Reason_Reference Optional Defined by Workday
integration mapping
Pay_Rate_Type Optional Defined by Workday
integration mapping
Work_Space You can use a Kenexa Optional Location (from Kenexa
Foundation Data Foundation Data)
integration to load this
data.
Position_Title Optional Text Field
Job_Title Optional Text Field
Compensation_Package Conditionally required if Defined by Workday
Comp Data exists on file. integration mapping
Compensation_Grade_Profile Optional Defined by Workday
integration mapping
Compensation_Grade Conditionally required if Defined by Workday
Comp Data exists on file. integration mapping
Amount Conditionally required if Text Field
Comp Data exists on file.
Compensation_Currency Conditionally required if ISO 4217 alpha
Comp Data exists on file.
Compensation_Frequency Conditionally required if Defined by Workday
Comp Data exists on file. integration mapping

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1176

Field Description Required? Comments


Compensation_Step Optional Defined by Workday
integration mapping
Compensation_Plan Conditionally required if Defined by Workday
Comp Data exists on file. integration mapping
Stock_Plan Optional Defined by Workday
integration mapping
Stock_Currency Conditionally required if Defined by Workday
Stock Data exists on file. integration mapping. ISO
4217 alpha
Stock_Individual_Target_Amount Optional Include 1 of these
elements if stock data
exists on the file:
• Target Amount
• Target Percent
• Target Shares

Stock_Individual_Target_Percent Optional Include 1 of these


elements if stock data
exists on the file:
• Target Amount
• Target Percent
• Target Shares

Stock_Individual_Target_Shares Optional Include 1 of these


elements if stock data
exists on the file:
• Target Amount
• Target Percent
• Target Shares

Compensation_Plan Conditionally required if Defined by Workday


Commission Data exists integration mapping
on file.
Commission_Target_Amount Conditionally required if Text Field
Commission Data exists
on file.
Commission_Frequency Conditionally required if Defined by Workday
Commission Data exists integration mapping
on file.
Commission_Draw_Amount Optional Text Field
Commission_Draw_Frequency Optional Defined by Workday
integration mapping
Commission_Draw_Duration Optional Informational text field
to describe how long the
draw will be.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1177

Field Description Required? Comments


Compensation_Currency Conditionally required if Defined by Workday
Commission Data exists integration mapping. ISO
on file. 4217 alpha
Merit_Guaranteed_Minimum Optional Boolean True/False
value (1 or 0).
Merit_Individual_Target_Percent Optional Enter 1 for 100%. Enter
0.5 for 50%.
Merit_Plan Conditionally required if Defined by Workday
Merit Data exists on file. integration mapping
Bonus_Plan Conditionally Required Defined by Workday
if Bonus Data exists on integration mapping
file.
Bonus_Percent_Assigned Optional Enter 1 for 100%. Enter
0.5 for 50%.
Bonus_Guaranteed_Minimum Optional Text Field
Bonus_Individual_Target_Percent Optional Enter 1 for 100%. Enter
0.5 for 50%.
Bonus_Individual_Target_Amount Optional Text Field
Allowance Data Can repeat 5 Allowance See default mapping in
records. Example: tenant for default field
Allowance_Plan_2 values.
Allowance_Currency Optional Conditionally required
when allowance
payment data exists
on the file. Defined by
Workday integration
mapping. ISO 3166-1
alpha 3.
Allowance_Plan Optional Defined by Workday
integration mapping
Allowance_Amount Optional Text Field
Allowance_Percent Optional Enter 1 for 100%. Enter
0.5 for 50%.
Allowance_End_Date Optional YYYY-MM-DD. ISO
8601
Allowance_Frequency Optional Defined by Workday
integration mapping
One-Time Payment Data Can repeat 5 One- See default mapping in
Time Payment records: tenant for default field
Example: One- values.
Time_Payment_Plan_2
One- Conditionally required if Conditionally required
Time_Payment_Currency One Time Payment data when one-time payment
exists on file. data exists on the file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1178

Field Description Required? Comments


Defined by Workday
integration mapping. ISO
3166-1 alpha 3.
One- Conditionally required if Defined by Workday
Time_Payment_Plan One Time Payment data integration mapping
exists on file.
One- Conditionally required if YYYY-MM-DD. ISO
Time_Payment_Date One Time Payment data 8601
exists on file.
One- Conditionally required if Text Field
Time_Payment_Amount One Time Payment data
exists on file.
One- Optional Enter 1 for 100%. Enter
Time_Payment_Percent 0.5 for 50%.
Education Data Can repeat 5 Education See default mapping in
Records: Example: tenant for default field
School_Country_1 values.
School_Name_1 Conditionally required if Text Field
School Data exists on
file.
Year_of_Degree_1 Conditionally required if YYYY
School Data exists on
file.
Subject_of_Study_1 Conditionally required if Defined by Workday
School Data exists on integration mapping
file.
Attainment_Level_1 Conditionally required if Defined by Workday
School Data exists on integration mapping
file.
School_Country_1 Conditionally required if Defined by Workday
School Data exists on integration mapping. ISO
file. 3166-1 alpha 3
School_Type_1 Conditionally required if Defined by Workday
School Data exists on integration mapping
file.
Federal_Tax_Exemption_Effective_Date Conditionally required YYYY-MM-DD. ISO
if Federal Tax Election 8601
Data exists on file.
Federal_Tax_Number_of_Allowances Optional Text Field
Federal_Tax_Additional_Amount Optional Text Field
Federal_Tax_Exempt_Indicator Optional Boolean True/False
value (1 or 0).
Federal_Tax_Exempt_from_NRA_Additional_AmountOptional Boolean True/False
value (1 or 0).

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1179

Field Description Required? Comments


Federal_Tax_Lock_In_Letter
Lock in Letter indicator Optional Boolean True/False
on the W-4. value (1 or 0).
Federal_Tax_No_Wage_No_Tax
If worker is nonresident Optional Boolean True/False
alien, indicate whether value (1 or 0).
the worker is subject to
NRA additional amount.
Federal_Tax_Nonresident_Alien Optional
Federal_Tax_Marital_Status Optional
Federal_Tax_Company Optional
Payment Election Data Can repeat 3 See default mapping in
Payment Elections tenant for default field
records. Example: values.
Payment_Election_Account_Type_1
Payment_Election_Bank_Account_Nickname_1
Nickname of the actual Optional Optional
bank account
Payment_Election_Rule_1 Conditionally required if Defined by Workday
Payment Election data integration mapping
exists on file.
Payment_Election_Type_1 Conditionally required if Defined by Workday
Payment Election data integration mapping
exists on file.
Payment_Election_Bank_Name_1 Conditionally required if
Payment Election data
exists on file.
Payment_Election_Bank_Account_Number_1 Optional
Payment_Election_Bank_ID_1 Optional
Payment_Election_Currency_1 Conditionally required if Defined by Workday
Payment Election data integration mapping. ISO
exists on file. 4217 alpha
Payment_Election_Country_1 Conditionally required if Defined by Workday
Payment Election data integration mapping. ISO
exists on file. 3166-1 alpha 3
Payment_Election_Bank_Name_1 Optional
Payment_Election_Roll_Number_1 Optional
Payment_Election_Account_Type_1 Optional Text Field. Defined by
Workday integration
mapping
Payment_Election_BIC_1 Optional Text Field
Payment_Election_IBAN_1 Optional Text Field
Payment_Election_Branch_ID_1 Optional Text Field
Payment_Election_Check_Digit_1 Optional Text Field

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1180

Field Description Required? Comments


Payment_Election_Amount_1
Fixed payment amount Optional
allocated to this bank
amount
Payment_Election_Percentage_1
Percentage of payment Optional Enter 1 for 100%. Enter
allocated to this bank 0.5 for 50%.
account
Payment_Election_Full_Amount_1
When true, allocates the Optional Boolean True/False
full amount to this bank value (1 or 0).
account
Organization_Business_Unit_ID Optional
Organization_Company_ID Optional
Organization_Cost_Center_ID Optional
Organization_Custom_ID Optional
Organization_Fund_ID Optional
Organization_Gift_ID Optional
Organization_Grant_ID Optional
Organization_Program_ID Optional
Organization_Region_ID Optional
Pay_Group Optional

Kronos Workforce Timekeeper Outbound

Steps: Set Up Integration for Kronos Employee Extract

Context
Create an integration that establishes worker records in Kronos and updates the records when changes
occur. The integration reports changes to worker status so that Kronos can activate or deactivate records
as needed.
After the initial full file worker synchronization, Workday sends Kronos a changes-only file, when
scheduled. The changes-only file contains complete records for workers who are new or whose information
has changed since the last integration run.

Steps
1. Create Integration System on page 1854.
Enter Kronos Employee Extract Template at the New Using Template prompt.
2. Select Integration System > Configure Integration Attributes as a related action on your integration
system and configure attributes for your integration.
3. As a related action on the integration, select Integration System > Configure Integration Maps.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1181

4. Create an Integration System User (ISU) and grant the ISU Get and Put access to these security
domains:
• Integration Event
• Set Up: Compensation
• Worker Data: Public Worker Reports
See: Steps: Grant Integration or External Endpoint Access to Workday.
5. (Optional) Set Up Integration Subscriptions on page 1855.
6. Launch an Integration on page 23.

Next Steps
Set up absence and payroll input Connectors to import time card data from Kronos into Workday.

Concept: Kronos Workforce Timekeeper Integration


Track worker time and attendance through the Workday integration with Kronos Workforce Timekeeper.
Kronos Workforce Timekeeper automates the error-prone processes related to time and attendance.
Workforce Timekeeper enables you to apply complex time and attendance pay policies accurately.
Workforce Timekeeper provides your managers with real-time labor data along with the tools to control
costs and improve productivity. Workday synchronizes information about workers and organizations with
Kronos so that your employees can record time and attendance.
Workday synchronizes HCM data with Kronos using the outbound integration system, which delivers
files to an external FTP server. You then use Kronos Connect to import the file into Kronos Workforce
Timekeeper.
Note: To import Kronos time card data into Workday, create an inbound integration using the Absence
and Payroll Input Connectors.
Workday is the source-of-truth for HCM data, including:
• Workers
• Organizations
• Job profiles
Kronos collects time and attendance data from employees. The Kronos integrations do not work directly
with Payroll Interface. However, Workday can generate payroll data using time and attendance data
uploaded from Kronos Workforce Timekeeper.

Concept: Kronos Integration Data Mapping

Employee Extract Maps


When you create integration maps for the Kronos Employee Extract files, you’re mapping Workday values
to Kronos values. In this case, the Internal Values represent the Workday values and the External Values
represent the Kronos values.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1182

Employee Extract Map Samples


Map Description Internal External
Value Value
(Workday) (Kronos)
Business Maps Staff SPYS
Title Business Payroll
Title Specialist
between
Workday
and
Kronos
values.
Ethnicity Maps White (Not CAUC
ethnicity Hispanic or
values Latino)
between
Workday
and
Kronos
values.
Leave Maps Workers WC
Type Leave Compensation
Name Type
names
between
Workday
and
Kronos
values.

FAQ: Kronos Outbound Integration


What is the format of the Kronos integration The Kronos integration files are Pipe Delimited files.
files?
Can I select the fields included in the Kronos No, the Kronos integration employee extract
integration? includes 111 fields and you can't change the output.
Use Kronos Connect to map the desired Workday
fields to the appropriate Kronos fields.

Can I select the records to include in the Kronos You can't filter the Kronos integration extract
Employee Extract integration? records by specific workers or organizations. The
dates you specify in the launch parameters of the
employee extract determine whether Workday
creates a full or change extract. You can also Edit
Subscriptions to target specific event records to
include.

Can I import Kronos time card data into Yes, using the Absence and Payroll Input
Workday? Connectors.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1183

LinkedIn Recruiter System Connect

Steps: Set Up LinkedIn Recruiter System Connect

Prerequisites
Review LinkedIn documentation for Recruiter System Connect (RSC) feature guidelines.
You must have a LinkedIn Recruiter admin license. See Access RSC features based on a user's license
and permissions in Recruiter for more information.
Security: These domains in the Recruiting functional area:
• Candidate Data: LinkedIn Recruiter System Connect
• Set Up: LinkedIn Middleware

Context
You can use the LinkedIn RSC integration to synchronize this data between LinkedIn Recruiter and
Workday Recruiting:
• Candidate data.
• LinkedIn InMail.
• Job application.
• Prospect data.
Supported browsers include Chrome, Firefox, or Microsoft Edge.
You can enable One-Click Export functionality to quickly export a LinkedIn profile from LinkedIn Recruiter
to Workday.

Steps
1. Create an integration system user (ISU) and an integration for One-Click Export.
See Steps: Set Up LinkedIn One-Click Export on page 1184.
2. Access the Edit Tenant Setup - Recruiting task.
Click Configure LinkedIn Integrations.
a) Select the ISU created for the LinkedIn integration. The ISU is required for LinkedIn RSC One-Click
Export.
b) Review and accept the Terms and Conditions agreement.
The Terms and Conditions apply to both Apply with LinkedIn and LinkedIn RSC. Accepting the
agreement doesn't impact previously enabled Apply with LinkedIn functionality.
3. Select the package containing the LinkedIn RSC integration.
For more information, see Connect your Workday ATS to Recruiter. If you encounter an error message,
see Troubleshoot hiring integrations widget.
4. Access the Edit Tenant Setup - Recruiting task.
Click Configure LinkedIn Integrations and verify if you enabled the integration under Additional
Information for Integration.
5. Configure theLinkedIn Recruiter System Connect Import integration.
See Steps: Set Up Inbound LinkedIn Recruiter System Connect.
6. Configure theLinkedIn Recruiter System Connect Export integration.
See Steps: Set Up Outbound LinkedIn Recruiter System Connect.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1184

7. Access the Configure Profile Group task.


a) Add these reports to the LinkedIn Data for Candidate Profile and LinkedIn Data for Prospect
Profile profile groups:
• InMail History
• LinkedIn Profile
LinkedIn controls the display language for the reports.
b) Add the Candidates Exported for This Job from LinkedIn report to the Candidates for Job
Requisition Composite View profile group.
See Steps: Set Up Profiles and Profile Groups.
8. Set Up Scheduled LinkedIn Recruiter System Connect Integrations.

Next Steps
When you switch to a new environment, repeat the steps to configure the LinkedIn RSC integration.
If you're testing in a non-production environment and sent data to LinkedIn, contact LinkedIn before moving
to Production so they can deactivate the integration and delete the test data. For more information, see
Testing Recruiter System Connect (RSC).
Related Information
Reference
Reference: Edit Tenant Setup - Recruiting
2022R2 What's New Post: LinkedIn Recruiter System Connect (RSC) One-Click Export

Steps: Set Up LinkedIn One-Click Export

Prerequisites
Security: These domains in the Integration and System functional areas:
• Integration Security
• Security Configuration

Context
The One-Click Export functionality requires you to create an integration system user (ISU) and an
integration system. Once you configure the One-Click Export integration, you can enable the functionality
for LinkedIn Recruiter System Connect (RSC).

Steps
1. Access the Create Integration System User task.
Create the integration system user (ISU) for your LinkedIn RSC One-Click Export integration.
2. Access the Create Security Group task.
Create an unconstrained integration system security group.
3. Select the ISU that you created from the Integration System Users prompt.
4. From the related actions of the security group, select Security Group > Maintain Domain
Permissions for Security Group.
5. Select the Candidate Data: Web Service LinkedIn Recruiter System Connect domain from the Domain
Security Policies permitting Put access prompt.
6. Run the Activate Pending Security Policy Changes task.
Security: Security Activation domain in the System functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1185

7. Access the Create Integration System task.


Create an integration system using the LinkedIn Recruiter System Connect One Click Export template.
You can only create 1 integration system for the template.
Security: Integration Build domain in the Integration functional area.
8. From the related actions of the integration system, select Workday Account > Edit.
Add the ISU that you created. You can only assign 1 ISU to the integration system.

Next Steps
Access your LinkedIn Recruiter Admin account and enable 1-click export in the ATS integrations settings
after you enable LinkedIn RSC.
Related Information
Reference
2022R2 What's New Post: LinkedIn Recruiter System Connect (RSC) One-Click Export

Steps: Set Up Inbound LinkedIn Recruiter System Connect

Prerequisites
Ensure you've:
• Completed Steps 1–3 of Steps: Set Up LinkedIn Recruiter System Connect on page 1183.
• Enabled the integration in Workday for 1 or more LinkedIn contracts.
Synchronize historical data to prevent duplicate prospect data in Workday.

Context
You can create a LinkedIn Recruiter System Connect Import integration system to import this data from
LinkedIn to Workday:
• LinkedIn InMail.
• LinkedIn Profiles.
You can access this data in the prospect and candidate profiles in Workday. Workday might not display the
imported data based on privacy settings that users set in LinkedIn.
You can only configure 1 inbound integration system per LinkedIn contract.

Steps
1. (Optional) Maintain Recruiting Sources.
To report on LinkedIn-sourced data, create a recruiting source that maps to Recruiter System Connect.
2. Create Integration System on page 1854.
Select the LinkedIn Recruiter System Connect Import option from the New using Template prompt.
3. Select Integration System > Configure Integration Attributes as a related action on the integration
system, and configure the LinkedIn Contract ID attribute.
4. Create an integration system user (ISU) and grant the ISU Get and Put access to these domains:
• Candidate Data: Web Service LinkedIn Recruiter System Connect in the Recruiting functional area.
• Integration Event in the Integration functional area.
See: Steps: Grant Integration or External Endpoint Access to Workday.
5. Launch an Integration on page 23.
• To ensure an optimal experience, sync a minimum of 2 years of historical data between LinkedIn
and Workday. To avoid integration failures due to large volumes of data, we recommend launching

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1186

multiple manual integrations for 1-3 months of data at a time. You might need to test the date range
that is successful for your integration events.
• Schedule ongoing integrations after synchronizing historical data. A typical schedule is every 15, 30,
45, or 60 minutes depending on business needs.
6. (Optional) Create a custom report on candidates and filter by the new source value.

Result
Recruiters can access LinkedIn Profile data and InMails from the Candidate or Prospect profile in
Workday. You can view the LinkedIn profile on 1 of the supported web browsers. If a LinkedIn Recruiter
browser session isn't active, Workday Recruiting displays the LinkedIn profile as the public profile for the
candidate or prospect.
Related Information
Concepts
Concept: LinkedIn Recruiter System Connect on page 1189

Steps: Set Up Outbound LinkedIn Recruiter System Connect

Prerequisites
Ensure you've:
• Completed Steps 1–3 of Steps: Set Up LinkedIn Recruiter System Connect on page 1183.
• Enabled the integration in Workday for 1 or more LinkedIn contracts.

Context
You can create LinkedIn Recruiter System Connect Export integration systems for your external career
sites to send this data from Workday to LinkedIn:
• External candidates.
• Job applications.
• Job application stages.
• Job postings (marked as private).
• Prospects.
You can have multiple export integration systems, however only 1 per external career site. This integration:
• Enables recruiters to view limited job application information for Workday jobs on the LinkedIn
candidate profile.
• Exports job postings as private to LinkedIn Recruiter, and won't override any custom solutions that send
job posting data from Workday to LinkedIn.
• Isn't a job posting integration.
LinkedIn verifies each candidate or prospect sent from Workday by matching the data with a corresponding
LinkedIn profile. If LinkedIn finds a match, LinkedIn displays the data and sends a LinkedIn profile
reference to Workday. Workday associates this reference with the candidate or prospect profile. If LinkedIn
can't find a match, the exported Workday data won't display in LinkedIn Recruiter.

Steps
1. Create Integration System on page 1854.
Select the LinkedIn Recruiter System Connect Export option from the New using Template prompt.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1187

2. Select Integration System > Configure Integration Attributes as a related action on the integration
system,
Configure the Included External Job Posting Site attribute for the external career site.
(Optional) You can enable the Excluded Countries attribute to filter data.
3. Create an integration system user (ISU) and grant the ISU Get and Put access to these domains:
• Candidate Data: Web Service LinkedIn Recruiter System Connect in the Recruiting functional area.
• Integration Event in the Integration functional area.
See Steps: Grant Integration or External Endpoint Access to Workday.
4. Launch an Integration on page 23.
• To ensure an optimal experience, sync a minimum of 2 years of historical data between LinkedIn
and Workday. To avoid integration failures due to large volumes of data, we recommend launching
multiple manual integrations for 1-3 months of data at a time. You might need to test the date range
that is successful for your integration events.
• Schedule ongoing integrations after synchronizing historical data. A typical schedule is every 15, 30,
45, or 60 minutes depending on business needs.

Result
In LinkedIn Recruiter, recruiters with security access can view Workday data for Workday candidates that
have a LinkedIn profile.
LinkedIn Recruiter One-Click Export uses exported job postings to associate candidates with open job
requisitions in Workday.
Related Information
Concepts
Concept: LinkedIn Recruiter System Connect on page 1189

Set Up Scheduled LinkedIn Recruiter System Connect Integrations

Prerequisites
Steps: Set Up LinkedIn Recruiter System Connect
Launch inbound and outbound LinkedIn Recruiter System Connect (RSC) integrations to synchronize the
last 2 years of candidate data.
Security:
• Candidate Data: LinkedIn Recruiter System Connect domain in the Recruiting functional area.
• Candidate Data: Web Service LinkedIn Recruiter System Connect domain in the Recruiting functional
area.
• Integration Event domain in the Integration functional area.
• Set Up: LinkedIn Middleware domain in the Recruiting functional area.

Context
Set up run schedules for both the inbound and outbound integrations between LinkedIn Recruiter and
Workday after synchronizing historical data between the 2 applications to ensure that:
• The candidate data remains synced.
• Recruiters spend less time switching between LinkedIn Recruiter and Workday when searching for
candidates.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1188

Steps
1. Access the Launch / Schedule Integration task.
See Launch an Integration.
2. Select the inbound or outbound LinkedIn RSC integration from the Integrations prompt.
3. In the Run Frequency prompt, select the frequency that best fits your business needs.
4. As you complete the Integration Criteria grid, consider:

Provider Field Description Value Type Value


LinkedIn Integration Start The last time this Determine Value Select from these
Recruiter System Time integration was at Runtime options:
Connect Launch run.
• As Of Entry
Parameters
DateTime of
Last Completed
Integration
Event
• As Of Entry
DateTime of
Last Completed
or Completed
with Warnings
Integration
Event

Integration End The integration Determine Value Current Moment


Time end time. at Runtime (DateTime)
5. Complete the Schedule tab. Select the parameters under the Recurrence Criteria section.
Your selection on the Catch Up Behavior prompt determines how many times Workday reruns an
integration after an error.
When you select Dependent on the Run Frequency prompt, consider:
Option Description
Dependency Select the Dependency event type that triggers
this integration.
Trigger on Status Select the event statuses that will trigger this
integration. You can run this integration when a
specified Workday event status completes, fails,
or aborts.
6. Select the Start Date and End Date to schedule the integration event in the Range of Recurrence
section.

Result
View details about the scheduled integrations in the Scheduled Future Processes report.

Example

Next Steps
Repeat the steps for the other LinkedIn RSC integration.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1189

Concept: LinkedIn Recruiter System Connect


The LinkedIn Recruiter System Connect (RSC) integration enables data transfer between Workday
Recruiting and LinkedIn Recruiter. The integration reduces switching between the 2 applications.

Integration Templates
Workday supports these LinkedIn RSC Integration Templates:
• LinkedIn Recruiter System Connect Export.
• LinkedIn Recruiter System Connect Import
• LinkedIn Recruiter System Connect One Click Export

Imported LinkedIn InMails


Existing Workday prospect profiles display LinkedIn InMail data based on the privacy settings that users
set in LinkedIn. If the candidate or prospect elects to share contact information, Workday will include their
contact information as part of the import.
Workday creates new prospect profiles for LinkedIn InMail recipients who have elected to share their name
data, but don't have a Workday profile. To ensure Workday creates prospect profiles, enable the InMail
Stub Profile setting in the LinkedIn Recruiter administrator settings. If the recipients didn't elect to share
their name data, Workday won't be able to create a new prospect in Workday.
If a recruiter with access to LinkedIn Recruiter is also an internal candidate, the LinkedIn InMail
communication for that recruiter doesn’t import into Workday.

Security
Due to the different security model of LinkedIn, Workday excludes confidential candidates and job
applications when exporting data to LinkedIn. We can't associate data imported from LinkedIn with
confidential data in Workday.
Workday recruiters with security to access LinkedIn Recruiter can view candidates and job applications
sent from Workday to LinkedIn. Workday users with security to access candidate or prospect profiles can
view LinkedIn Profiles and LinkedIn InMail data.

Integration Support
Workday supports:
• Displaying the inbound data retrieved from LinkedIn within Workday.
• The inbound LinkedIn RSC integration and retrieving LinkedIn data.
• The outbound LinkedIn RSC integration and exporting Workday data.
• The One-Click Export integration and retrieving the LinkedIn data.
LinkedIn supports:
• All APIs for data transfer to and from LinkedIn Recruiter.
• All RSC features within LinkedIn Recruiter.
• Matching candidates between Workday and LinkedIn.
• Providing LinkedIn message history and consented LinkedIn InMail contact information for Workday
retrieval.
• Providing One-Click Export data for Workday retrieval.
• The LinkedIn Onboarding widget inside of Workday.
• The LinkedIn Profile widget on the candidate profile.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1190

Troubleshooting: LinkedIn Recruiter System Connect Integration

You couldn't successfully enable the LinkedIn Recruiter System Connect (RSC) integration after
several attempts.
If you're seeing internal server errors or other issues while enabling the LinkedIn RSC integration, you can
start over by resetting the LinkedIn Middleware integration.
Note: The Reset LinkedIn Middleware Integrations task removes configuration data in Workday for the
LinkedIn RSC and Apply with LinkedIn integrations. Running this task is irreversible for both integrations.
Only use this task in a:
• Non-Production environment.
• Production environment if the LinkedIn RSC and Apply with LinkedIn integrations aren't in use yet.
Solution:

Steps
Security: Set Up: LinkedIn Middleware domain in the Recruiting functional area.
1. Access the Reset LinkedIn Middleware Integrations task.
2. Select the Reset check box.
3. Wait 30 to 60 minutes.
4. Try to enable the LinkedIn RSC integration again.
See Steps: Set Up LinkedIn Recruiter System Connect.

The LinkedIn RSC export integration completes with errors.


Cause: The integration event completed, but you're missing records in LinkedIn Recruiter due to rejected
data. Example: LinkedIn rejected a candidate record because the last name for a candidate is missing in
Workday.
Solution:

Steps
Security: Integration Event domain in the Integrations functional area.
1. Access the Integration Events report.
See View Integration Events.
2. Access the integration that completed with errors.
3. On the Output Files tab, review the MessagesAudit.zip file for any errors that occurred during the
integration.
4. Correct the data on the candidate profile.
5. Launch an Integration.
Launch the LinkedIn RSC export integration again.

The LinkedIn RSC integration failed due to a server error.


The LinkedIn RSC integration has failed with a 500 Internal Server Error or 504 Gateway Timeout
response message. If you encounter these failures several times, contact LinkedIn support.
Cause: LinkedIn's server isn't responding.
Solution:

Steps
Security: Integration Event domain in the Integrations functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1191

1. Access the Integration Events report.


See View Integration Events.
2. Access the integration that failed.
3. On the Messages tab, review the Process Messages grid for any errors that occurred during the
integration.
4. Contact LinkedIn support.
Related Information
Reference
Troubleshoot hiring integrations widget

Medicare Integrations

Steps: Set Up Medicare Integrations

Prerequisites
Establish an Employer Voluntary Data Sharing Agreement (VDSA) with the Centers for Medicare &
Medicaid Services (CMS):
• Sign the VSDA agreement and obtain a VDSA ID.
• Designate an employer-named contact and know who the CMS EDI contact is.

Context
You can create integrations that support Employer Voluntary Data Sharing Agreements (VDSAs) with
CMS.
Perform this procedure once for each integration template.

Steps
1. Access the Create Integration System task and enter the applicable template name at the New using
Template prompt:
Option Description
Medicare Secondary Payer Input File Sends coordination of benefits request files for
Outbound active employees to CMS.
Medicare Secondary Payer Response File Imports coordination of benefits response files for
Inbound active employees from CMS.
Non-Medicare Secondary Payer Input File Sends coordination of benefits request files for
Outbound retired employees and dependents to CMS.
Non-Medicare Secondary Response File Imports coordination of benefits response files for
Inbound retired employees and dependents from CMS.

Security: Integration Build in the Integration functional area.


2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Integration Build
• Worker Data: Medicare
See: Steps: Grant Integration or External Endpoint Access to Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1192

3. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
4. Configure delivery and retrieval of integration files using SFTP.
(Inbound integrations) See: Set Up Integration Retrieval on page 1845.
(Outbound integrations) See: Set Up Integration Delivery on page 1839.
5. Launch an Integration on page 23.
Launch each integration manually during the date-of-submission windows defined by CMS. Don't
schedule your integrations.

Concept: Medicare Integrations


Workday enables you to support Employer Voluntary Data Sharing Agreements (VDSAs) with the Centers
for Medicare & Medicaid Services (CMS).
Workday provides 4 integrations that enable you to send and receive coordination of benefits request and
response files for active and retired employees and their dependents:
• Medicare Secondary Payer Input File Outbound
• Medicare Secondary Payer Response File Inbound
• Non-Medicare Secondary Payer Input File Outbound
• Non-Medicare Secondary Response File Inbound

Medicare Integration Details


When planning to implement Medicare integrations, consider:
• These integrations support Employer VDSA agreement with CMS. These integrations don't support
Section 111 compliance reporting for GHP or non-GHP coverage (worker’s compensation or legal
settlements). Establish your TIN numbers for the VDSA data exchange before you can use our
delivered integrations for the coverage data.
• Workday doesn’t maintain Medicare Part C data as part of Medicare coverage information.
• The Non-Medicare Secondary Payer Input File Outbound integration template doesn't support Drug
Subsidy reporting records. Workday supports EGWP drug coverage with the Import Medicare Part D
EGWP web service operation.
• Workday transmits Medicare Beneficiary Identifier (MBI) information for outbound Medicare
integrations. Workday no longer transmits Health Insurance Claim Number (HICN) information for those
integrations.

Integration Files and Reports


Every time a Medicare integration runs, Workday generates these files:
• Data Changes Audit file, which is a readable version of the integration output file.
• Diagnostic Audit file, which helps you troubleshoot integration errors.
You can find these files in the Reports and Other Output Files section of the Integration Event for each
integration run.
Note: Because actual data is included in the Data Changes Audit file, you might need to secure this file
separately.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1193

Okta

Steps: Set Up Okta Integration

Prerequisites
• Determine if you want to configure this integration (Workday-driven provisioning) or configure Okta to
import data from Workday. See: Configuring Provisioning for Workday.
• Know the location and token for your Okta tenant.
• Review the Workday deployment documentation provided by Okta.
• Security: Integration Build and Integration Configure domains in the Integration functional area.

Context
Implement an integration based on the Okta - Worker template to monitor Workday events and send a
notification to your Okta tenant when worker data changes.

Steps
1. Access the Create Integration System task and enter Okta - Worker at the New using Template
prompt.
Security: Integration Build in the Integration functional area.
2. (Optional) In the Configure Integration Services task, enable any optional integration services.
Security: Integration Build in the Integration functional area.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Worker Data: Current Staffing Information
• Worker Data: Public Worker Reports
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select Integration System > Configure Integration Attributes as a related action on your integration
system and configure attributes for your integration.
5. Select Workers to Include in Connector Output on page 1863.
Complete this step only if you enabled the Define Eligibility integration service in Step 2.
6. Configure one of these methods to monitor events in Workday:
a) Create Integration (Step).
b) Set Up Integration Subscriptions on page 1855.
Select any business processes and transaction events that directly affect a worker. Examples: hire,
transfer, termination.

Next Steps
Configure your Okta tenant to extract required data from Workday.

Concept: Okta Integration


The Okta integration enables you to send notifications of changes to your employees directly to your Okta
tenant. The Okta - Worker integration template enables you to monitor business processes and events in
Workday that impact your workers. As you hire, transfer, and terminate your workers, the Okta integration
sends the Workday ID (WID) value for each affected worker directly to your Okta tenant.
The Okta integration sends only the WID value for each affected worker. Configure your Okta tenant to
extract additional data from your Workday tenant using the Workday Web Service API.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1194

Integration Services
The Okta - Worker integration template consists of these integration services:

Integration Service Required/Optional Description


Account Provisioning Connector: Required Extracts worker data from your
Worker - ESB Service Workday tenant.
Account Provisioning Connector: Required Manages configuration of your
Worker - Configuration Okta integration, including
attribute values.
Integration Document Retention Required Defines how long the integration
stores output files for auditing
purposes.
Define Eligibility Optional Enables you to define which
workers the integration monitors
for sending notifications to
Okta. Create a Document Field
Override with a report field or
calculated field. The report field
or calculated field must return a
check box true value for workers
that you want to include.
Okta Account Provisioning Required Transforms data into JavaScript
Object Notation (JSON) format
and sends data to your Okta
tenant.

Launch/Schedule Options for Okta Integration


When you configure the Okta integration, you select which business process and event types that trigger
the integration. Excluding business process and transaction types that are irrelevant to Okta improves
performance. However, Workday doesn’t notify your Okta tenant of changes for a transaction type if:
• Your integration system doesn’t subscribe to a transaction type that affects your workers.
• Your integration isn’t in the business process for a transaction type that affects your workers.
If you aren’t sure if the Okta integration should subscribe to a transaction or business process type,
exclude the transaction or business process type.
Note: To avoid triggering double integration events, don't configure the same Transaction Type as both a
Business Process Integration Step and an Integration Subscription.
Workday provides these options for launching the Okta integration:

Option Advantages Disadvantages


Business Process Integration Enables you to adjust integration Requires you to configure an
Step scheduling for each business integration step for each business
process type using condition rules process that you want to monitor.
and delay steps.
Integration Subscriptions Enables you to select, from a You can't adjust the integration
single prompt, each business launch time using condition rules
process, and event type that or delay steps. The integration
you want to monitor. Workday launches when the business
includes automatically all process completes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1195

Option Advantages Disadvantages


business process definitions for
each business process type that
you select.

Launch Parameters for Okta Integration


The Okta integration includes these launch parameters:

Launch Parameter Description


Workers Returns the worker data as of the specified date
and time. The integration can only launch for a
single worker:
• If you're launching the integration manually,
select only 1 worker.
• If you configure the integration to launch by
business process or integration subscription,
use the Workday-delivered Transaction
Targets as Workers field.
Note: Don't use the Transaction Targets
report field. This field can sometimes return
multiple workers, which the integration can't
process.

As of Entry Moment Includes any changes to worker data entered as of


the specified date and time.
Workday suggests using:
• The current moment if launching manually.
• The Workday-delivered field Current Moment
(DateTime) if launching using a business
process or integration subscription.
• The Workday-delivered field Transaction Entry
Moment if launching using a business process
or integration subscription.
Workday doesn't recommend back-dating the As
of Entry Moment parameter because it can cause
subsequent data values to be invalid.

Effective Date Returns the worker data effective as of the


specified date. Workday recommends that you use
the Transaction Effective Moment field.
Note: For termination-related Business Process
(BP) initiation or Integration Subscription, Workday
recommends that you use a calculated field to
take Transaction Effective Moment + 1 Day. This
calculated field reflects the first day that the worker
didn't work.

Integration Files
Every time the integration runs, Workday generates these files:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1196

• Data files: Workday generates 2 files in different formats. Each file includes the same data.
• Data Changes Audit file, which is a readable version of the integration output file.
• Diagnostic Audit file, which helps you troubleshoot integration errors.
You can find these files in the Integration Event for each integration run.
Note: Since the Data Changes Audit file includes actual data, evaluate the need to secure this file
separately.

Reference: Okta Integration Output Fields


The Okta integration generates 2 data files for each event, in XML and JSON format. Each file contains the
same data; the Okta integration sends the JSON file to your Okta tenant.

Field Description
Published Date and time when Workday generated the output
file, in ISO 8601 format.
Generator Name of the Workday tenant and environment that
generated the output file.
Verb Identifies the business process or event.
Context Includes the Workday ID (WID) of the worker
affected by the business process or event.

Organization Inbound Connector

Steps: Set Up Organization Inbound Connector

Prerequisites
Set up an external server that an external endpoint and your integration can access.

Context
Set up an integration system to import organization changes from an external endpoint into Workday.

Steps
1. To generate organization change data, configure your external endpoints.
To improve Connector performance, Workday recommends that you load organizations in batches for
high-volume organization loads.
2. Access the Create Integration System task and enter Core Connector: Organization Inbound at the
New using Template prompt.
Security: Integration Build in the Integration functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1197

3. Create an Integration System User (ISU) and grant the ISU Get and Put access to these security
domains:
• Integration Build
• Manage: Organization Integration
• Manage: Organization Update Integration
• Worker Data: Organization Information
• Worker Data: Public Worker Reports
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. Set Up Assignable Roles.
Add the ISU account to a role that can assign roles for any affected organization at the Assigned by
Security Groups prompt.
5. As a related action on your integration, select Integration System > Configure Integration Attributes,
add a row for each attribute, and specify a value.
6. Set Up Integration Retrieval on page 1845.
7. Launch an Integration on page 23.

Concept: Organization Inbound Connector


Use the Organization Inbound Connector to import organization data from an external endpoint that
defines organizations and their codes into Workday. The Organization Inbound Connector can add
new organizations to Workday, update existing organizations, and inactivate organizations. With the
Organization Inbound Connector, you can use a non-Workday application as your source-of-truth for
organization data, then synchronize that data with Workday.
The Organization Inbound Connector works with organizations in Workday. Workday recommends that you
familiarize yourself with Workday organization features.

Organization Events
The Organization Inbound Connector enables your external endpoint to:
• Create an organization in Workday. To load the organization into Workday, include an organization in
the integration file with a unique Reference ID. Define these items in a hierarchy for an organization:
• Reference ID.
• Name.
• Availability date.
• Code.
• Organization type and subtype.
• Location.
• Edit an existing organization in Workday. To amend the existing organization in Workday, include
an organization in the integration file with a pre-existing Reference ID. You can change the superior
organization (equivalent to moving the organization) of the organization. You can also edit other
information about the organization, including role assignments.
Organization Inbound Connector supports 1 assignment of role to position, whether the position
supports multiple assignments or not.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1198

• Inactivate an organization. By using the provided Inactive flag, you can inactivate an organization.
When you inactivate an organization:
• Workday moves all active subordinate and included organizations up to an active superior
organization unless you specify a specific organization. Inactive subordinate and included
organizations don’t move up.
• Specify a specific organization if:
• There’s no parent organization.
• The organization that you're inactivating has active subordinates and included organizations.
• If you set Keep in Hierarchy to false, Workday dissolves the organization structure and converts
inactive organizations to standalone organizations.

File Format for Organization Inbound Connector Data


The Organization Inbound Connector imports data in a Workday-defined CSV (Comma-Separated Value)
or XML format. Send data full file. The Organization Inbound Connector doesn’t support change-only files.
Instead, the integration determines if an organization is new or changed based on the Reference ID.
To improve Connector performance, Workday recommends that you load organizations in batches for high
volume organization loads.
Note: If you include a new organization that doesn't exist in Workday, the Reference ID can't already be in
use by another organization. The Organization Inbound Connector performs no additional data validation
aside from the Reference ID. Workday overwrites the existing organization if:
• You include a new organization on the file.
• The organization uses the same Reference ID as an existing organization.

Integration Process Flow


The Organization Inbound Connector imports organization data using this process:
1. Your external endpoint generates a file (in the Workday-supported format) and sends it to a file server
known to the integration.
2. You launch the integration, either by schedule or manually.
3. The integration retrieves the file according to the Document Retrieval configuration on the Integration
Process Event and applies document tags.
If the file isn’t in Workday XML or CSV format, configure a Document Transformation integration to
convert the input file.
4. The integration processes the file, then imports the data into Workday:
• The integration creates new organizations in Workday.
• The integration updates or inactivates existing organizations.

Organization Inbound Connector Audits


The Organization Inbound Connector generates audit files each time it runs.

View Organization Inbound Connector Integration Audits

Prerequisites
Security: Background Process Management domain in the Tenant Non-Configurable functional area.

Context
For each integration event, you can use the Organization Inbound Connector integration audits to
determine:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1199

• What operation performs (DataChangesAudit.html)


• Details about the file (DiagnosticAudit.html)

Steps
1. As a related action on the integration event, select Background Process > View Output Files.
2. Select an audit file:
Option Description
DataChangesAudit.html For each organization, displays the operation
(Add, Update, Inactivate); for Update operations,
also displays each changed field.
DiagnosticAudit.html For each organization, displays the document
name, the name and Reference ID of the
organization, and if the file contained errors. Also
displays any validation messages received while
processing the organization.

Reference: Organization Inbound Connector File Schema

CSV File Description


The CSV format consists of various fields, each occurring once per organization. If you don't include a
header on the CSV file, the fields must be in the order listed. For a complete description of each field, see
the XML Elements section:
Note: The CSV file input supports a single Container_Organization_Reference_ID field
value for each included organization. The XML file input, in contrast, can support multiple
Container_Organization_Reference_ID field values for each organization.
• Organization_Reference_ID
• Organization_Name
• Availability_Date
• Include_Organization_Code_In_Name
• Organization_Code
• Organization_Type_Name
• Organization_Subtype_Name
• Organization_Visibility_Name
• Organization_Inactive
• Inactivation_Date
• Superior_Organization_Reference_ID. If Container_Organization_Reference_ID has a value, leave this
field empty.
• Container_Organization_Reference_ID. If Superior_Organization_Reference_ID has a value, leave this
field empty.
• Frozen_Status
• Staffing_Model
• Primary_Business_Site_Reference
• Organization_Role_ID_1
• Position_ID_1
• Organization_Role_ID_2
• Position_ID_2
• Organization_Role_ID_3
• Position_ID_3
• Keep_in_Hierarchy

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1200

• Organization_for_Subordinates_Reference_ID
• Organization_for_Included_Organizations_Reference_ID

XML Elements
The XML schema for inbound organization update data includes these elements:

Element Level
Description
External_Organization_Inbound_Records 1Contains all other elements. Only 1 element
permitted per file.
External_Organization_Inbound_Record 2Contains 1 instance of all subsequent elements,
except as noted. Unlimited number of elements
permitted per file.
Organization_Reference_ID 3Reference ID value for the organization. If you're
inserting the organization into Workday, ensure
that this Reference ID doesn't exist for any other
organization in Workday. Must be in XSD string
format.
Organization_Name 3Organization name in Workday. Must be in XSD
string format.
Availability_Date 3Availability Date is for informational purposes. This
field value communicates when to begin using
this organization. Workday doesn't use this field in
any Workday validations to control when a staffing
transaction can use the Organization, such as Hire
Employee or Change Job. Must be in XSD date
format.
Include_Organization_Code_In_Name 3Indicates if you're concatenating the
Organization_Code element value with the
Organization_Name value. Must be in XSD
Boolean format.
Organization_Code 3Organization code value. Must be in XSD string
format.
Organization_Type_Name 3Organization type for the organization. Must be in
XSD string format.
Organization_Subtype_Name 3Organization subtype for the organization. Must be
in XSD string format.
Organization_Visibility_Name 3Determines organization visibility in Workday. Must
be in XSD string format.
Valid visibility values are Role Assignees, Role
Assignees of Current and Superiors, Role
Assignees and Members, and Everyone.
Former visibility values Administrators Only,
Administrators Only - All Organizations, and
Members Only are also still valid.

Organization_Inactive 3If set to Yes, sets the organization to inactive. You


can't use this element to reactivate organizations.
Must be in XSD Boolean format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1201

Element Level
Description
Inactivation_Date 3Date that organization becomes inactive. Must be
in XSD date format.
Superior_Organization_Reference_ID 3Reference ID value for the superior organization
of the organization in Workday. This field will be
effective as of current date. Must be in XSD string
format.
If you include a
Container_Organization_Reference_ID value,
leave this element empty. Only applicable for
hierarchical organization types such as supervisory
organization and cost center hierarchy.

Container_Organization_Reference_ID 3Reference ID value for the organization in Workday


that you're including the organization in. This field
will be effective as of current date. Must be in XSD
string format.
If you include a
Superior_Organization_Reference_ID value,
leave this element empty. You can enter only
organizations that can include the organization type
for that container organization. Example: This value
could only be the Reference ID for a cost center
hierarchy when the organization is a cost center.

Frozen_Status 3If set to Yes, freezes all positions in the


Organization. You can use this field only for
supervisory organizations. Must be in XSD Boolean
format.
Staffing_Model 3Indicates the type of staffing model used by
the organization. You can use this field only
for supervisory organizations and for new
organizations with no superior. Valid Staffing
Model values are: Position Management and Job
Management. Must be in XSD string format.
Primary_Business_Site_Reference 3Workday ID (WID) for the Organization primary
business site location. You can use this field
only for supervisory organizations and for new
organizations with no superior. Must be in XSD
string format.
Organization_Role_ID_1 3Name of an organization role. Must be in XSD
string format.
Position_ID_1 3Position ID that you assign to the
Organization_Role_ID_1. Must be in XSD string
format.
Organization_Role_ID_2 3Name of an organization role. Must be in XSD
string format.
Position_ID_2 3Position ID that you assign to the
Organization_Role_ID_2. Must be in XSD string
format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1202

Element Level
Description
Organization_Role_ID_3 3Name of an organization role. Must be in XSD
string format.
Position_ID_3 3Position ID that you assign to the
Organization_Role_ID_3. Must be in XSD string
format.
Keep_in_Hierarchy 3Keeps an organization that you're inactivating in
its current hierarchy. If not specified, Workday
sets the value to False. Use only when you set
Organization_Inactive to Yes. You can't use
Keep_in_Hierarchy when an organization is
already inactive. In that case, use the Inactivate
Organizations web service instead. Must be in XSD
Boolean format.
Organization_for_Subordinates_Reference_ID 3Reference ID value for new superior organization
for any subordinate organizations. Only applicable
if you're inactivating the organization because
an inactive organization can't have active
subordinates. If not specified, inactive subordinates
remain as is and Workday moves active ones to
superior. Must be in XSD string format.
Organization_for_Included_Organizations_Reference_ID
3Reference ID value for new superior organization
for any included organizations. Only applicable
if you're inactivating the organization because
an inactive organization can't include active
organizations. If not specified, inactive included
organizations remain as is and active ones move to
superior. Must be in XSD string format.

XML Schema
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="urn:com.workday/org"
xmlns:org="urn:com.workday/org" elementFormDefault="qualified">

<xsd:element name="External_Organization_Inbound_Records">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="External_Organization_Inbound_Record"
type="org:OrgInboundRecord"
maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>

<xsd:complexType name="OrgInboundRecord">
<xsd:sequence>
<xsd:element name="Organization_Reference_ID" type="xsd:string" />
<xsd:element name="Organization_Name" type="xsd:string"
nillable="true"/>
<xsd:element name="Availability_Date" type="xsd:date"/>
<xsd:element name="Include_Organization_Code_In_Name"
type="xsd:boolean"/>
<xsd:element name="Organization_Code" type="xsd:string"
nillable="true"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1203

<xsd:element name="Organization_Type_Name" type="xsd:string"/>


<xsd:element name="Organization_Subtype_Name" type="xsd:string"/>
<xsd:element name="Organization_Visibility_Name"
type="xsd:string"/>
<xsd:element name="Organization_Inactive" type="xsd:boolean"/>
<xsd:element name="Inactivation_Date" type="xsd:date"
nillable="true"/>
<xsd:choice>
<xsd:element name="Superior_Organization_Reference_ID"
type="xsd:string" nillable="true"/>
<xsd:element name="Container_Organization_Reference_ID"
type="xsd:string" maxOccurs="unbounded" nillable="true"/>
</xsd:choice>
<xsd:element name="Frozen_Status" type="xsd:boolean"/>
<xsd:element name="Staffing_Model" type="xsd:string"/>
<xsd:element name="Primary_Business_Site_Reference"
type="xsd:string" nillable="true"/>
<xsd:element name="Role_Assignments">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Role_Assignment"
maxOccurs="unbounded">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Organization_Role_ID"
type="xsd:string" nillable="true"/>
<xsd:element name="Position_ID" type="xsd:string"
nillable="true"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

Salesforce.com Chatter

Steps: Set Up Salesforce.com Chatter Integration

Context
To export updates from My Tasks to Chatter, create a Salesforce.com Chatter integration. Chatter then
displays the My Tasks items.

Steps
1. Create Custom Report for Salesforce.com Chatter Integration on page 1204.
To extract data from My Tasks, create a custom report.
2. Access the Create Integration System task and enter Salesforce - Chatter Workfeed Sync at the New
Using Template prompt.
Security: Integration Build and Integration Configure security domains.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integrations:
Workfeed security domain.
This domain secures the Report Data Source used by the custom report that retrieves Workfeed data.
See: Steps: Grant Integration or External Endpoint Access to Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1204

4. As a related action on your Salesforce.com Chatter integration, select Integration System > Configure
Integration Attributes:
Option Description
Salesforce Integration User ID Enter the account ID for the Salesforce user who
posts the My Tasks data in Salesforce.
Salesforce User Password Enter the password for the account ID.
Salesforce Security Token To authenticate with Salesforce, enter the
Salesforce security token.
Workfeed Report Owner Enter the owner of the custom report that
retrieves My Tasks items from Workday.
Workfeed Report Name Enter the name of the custom report that retrieves
My Tasks items from Workday.
Workday Default URL Enter the Workday tenant URL that Salesforce
Chatter displays.
Salesforce Environment Specify the Salesforce.com sign-in URL,
depending on which environment you select
in the Restricted to Environment prompt. If not
overridden, the integration uses these URLs:
• Production environment: login.salesforce.com
• All other environments, or no environment
specified: test.salesforce.com
You can override these values by editing the
attribute.
5. Launch an Integration on page 23.
Schedule how often you want Workday to launch the integration.

Create Custom Report for Salesforce.com Chatter Integration

Prerequisites
Security: Custom/Standard Report Copy domain in the Tenant Non-Configurable functional area.

Context
Copy the Standard Report My Tasks and create a custom report in Workday that returns My Tasks data
for use by the Salesforce.com Chatter integration.

Steps
1. Access the My Tasks report.
2. As a related action on the report, select Standard Report > Copy.
3. Give the copied report a new Name.
You refer to this report when configuring the Salesforce.com Chatter integration.
4. Change the Data Source to Business Process Transactions Awaiting Employee ID.
5. Select the Columns tab and add Column Heading Override values exactly as listed:
Option Description
Business Process Event Business Process Event

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1205

Option Description
Subject Subject
Date and Time Initiated Date Time Initiated
Due Date Due Date
6. Select the Sort tab and verify that the Sort Direction for Date and Time Initiated is set to Alphabetical -
Descending.
7. Select the Filter tab and add a filter:
Option Description
And/Or And
( (
Field Date and Time Initiated
Operator greater than or equal to
Comparison Type Prompt the user for the value
Comparison Value Default prompt
8. Select the Prompts tab and add a prompt for the ID report field:
Option Description
Field ID
Prompt Qualifier None.
Label Override Employee ID
Default Type No default value
Required Yes
9. In the Prompts tab, add a second prompt for the Date and Time Initiated report field:
Option Description
Field Date and Time Initiated
Prompt Qualifier Default prompt
Label Override As Of DateTime Initiated
Default Type No default value
Required N/A
10.Select the Share tab and select Share with all authorized users.
11.Select the Advanced tab and set the Web Service Options:
Option Description
Enable as Web Service Select.
Web Service API Version v15

Concept: Salesforce.com Chatter Integration


Synchronize My Tasks data between Workday and Salesforce.com Chatter. Salesforce.com Chatter brings
the power of social networks inside your company. Salesforce.com Chatter is a free, private, and secure
social network just for your business. With Chatter, your workers can connect with each other to work

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1206

together and be more productive. The integration pushes updates on the people, projects, and files that
you care about most automatically to your workers, so you always know what's going on.

Salesforce.com Chatter Integration Template


The Salesforce - Chatter Workfeed Sync integration template enables you to export data from the Workday
My Tasks to Salesforce.com Chatter. When run, the integration extracts all new My Tasks items created in
Workday since the last integration run. The integration exports them to Salesforce.com Chatter as a single
entry in private messages.
Note: Set up a Salesforce - Worker Sync integration to use the Salesforce - Chatter Workfeed Sync
integration template.

Salesforce.com Prerequisites
Before setting up the Salesforce.com Chatter integration, verify that you have an Admin User account on
Salesforce.com that your integration can use.

Salesforce.com Configuration
We recommend that you configure your Chatter Admin account as follows:
• Set the User Account Name to the Admin User or Company User. This name displays as the sender on
the private message.
• Don't set an Alias for the User Account.
The Admin account in Chatter can see all messages for all workers.
Salesforce.com Chatter passwords expire every 3 months. Update the password and security token in the
integration attributes for the Salesforce.com integrations.

Configuration Steps
To configure Salesforce.com integrations:
1. Steps: Set Up Salesforce.com Worker Sync Integration on page 1206.
To synchronize worker data in Workday with accounts in Salesforce.com, create a Salesforce - Worker
Sync integration.
2. Create Custom Report for Salesforce.com Chatter Integration on page 1204
Create a custom report to return My Tasks items to the integration.
3. Steps: Set Up Salesforce.com Chatter Integration on page 1203
To export data returned by the custom report to Salesforce.com, create a Salesforce - Chatter
Workfeed Sync integration.

Salesforce.com Worker Sync

Steps: Set Up Salesforce.com Worker Sync Integration

Prerequisites
• Verify that you have an Admin User account on your Salesforce.com tenant that the 2 integration
templates can use.
• Create any Profiles in Salesforce.com that you want to assign to your workers using the integrations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1207

Context
Create an integration system that establishes accounts for workers in Salesforce.com and updates the
accounts when changes occur. The integration reports changes to worker status so that Salesforce.com
can activate or deactivate accounts as needed.
After the initial full file worker synchronization, Workday sends Salesforce.com a changes-only file, when
scheduled. The changes-only file contains complete records for workers who are new or whose information
has changed since the last integration run.
You specify a run frequency, and Workday launches the integration automatically. Upon launch, the
integration collects all qualifying changes based on the launch parameters. You can schedule the
integration to run several times per day. Launching the integration frequently doesn’t affect performance.
If you want to send additional worker attributes to the Salesforce.com environment, consider using Core
Connector: Worker.

Steps
1. Access the Create Integration System task and enter Salesforce - Worker Sync at the New Using
Template prompt.
Security: Integration Build and Integration Configure security domains.
2. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
3. As a related action on the integration system, select Integration System > Configure Integration
Field Overrides.
Define which workers are eligible for Workday to include in the integration. Define which
Salesforce.com profile, department, and division workers belong to in Salesforce:

Grid Description
Define Eligibility / Eligibility criterion Select (or create and select) a Boolean report
field or calculated field from the Override
External Field prompt. The Boolean must
return true for any worker that is included in the
integration.
Salesforce Worker Configuration / Select a report field or calculated field from the
Salesforce_Profile Override External Field prompt. The report field
or calculated field defines which profile each
worker receives in Salesforce.
For information on where to locate the profile ID
for a worker in Salesforce, see Salesforce product
documentation.

4. (Optional) Select Integration System > Configure Integration Transaction Log and select the
Workday transactions that the integration monitors for changes.
Note: Workday recommends that you select Subscribe to all Transaction Types except. Then filter
out only transaction types that you know have no relevance to your needs. If in doubt, don't filter out a
transaction type.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1208

5. Create an Integration System User (ISU) and grant the ISU Get and Put access to these security
domains:
• Worker Data: Current Staffing Information
• Person Data: Gender
• Worker Data: Private Contact Information
• Worker Data: Public Worker Reports
See: Steps: Grant Integration or External Endpoint Access to Workday.
6. Launch an Integration on page 23.
Schedule how often you want Workday to launch the integration.

Concept: Salesforce.com Worker Sync Integration


Synchronize accounts between Workday and Salesforce.com using the Salesforce - Worker Sync
integration template. As you hire workers into Workday, the integration sends worker data to
Salesforce.com. You can use the integration to create Chatter accounts, Salesforce.com accounts, or both
kinds of accounts. You also define rules in the integration to specify which profile, department (Optional),
and division (Optional) the integration assigns a worker to based on defined criteria.
Use this integration template if you want to use the Salesforce.com Chatter integration.

Launch/Schedule Options
Workday provides these launch schedule options for the Salesforce - Worker Sync integration:
• Organization: If you intend to run the integration immediately, select the organization for which you
want to run the integration. The prompt varies depending on the Integration Process Event and on your
security access:
• Owning Organization displays if the Integration Process Event for this integration is associated with
a specific organization. You can select the organization or any of its subordinate organizations of
which you’re a member or have an organization role.
• Organization By Type displays if the Integration Process Event for this integration has no associated
organization. You can select any organization and subordinate organization of which you’re a
member or have an organization role.
• Scheduled Run Frequency. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters. You can schedule a Core Connector: Worker integration to run several times per day;
launching the integration frequently doesn’t affect performance.
• Run Now. You can launch the integration manually for specific workers, or for all eligible workers. The
integration prompts you to enter launch parameters.
For each launch schedule option, you can enter these launch parameters:
• Last Successful Launch Moment automatically populates with the last moment (date and time) at
which the integration system was successfully launched. You can force the integration to search for and
retrieve data changes over a wider period. Override this date and time in order with the Specify Value
option.
• As Of Moment enables you to retrieve the later end of the entry time range. Example: If you specify an
entry range of 07-01-20:00:00:00 to 07-02-20:01:00:00, the As Of Moment time is 07-02-20:01:00:00.
You can enter a specific date in the future (using the Specify Value option) when using the Run Now
launch schedule option. When scheduling a recurring integration event, use the Determine Value at
Runtime option. Then select a date field from the Value prompt. Example: First Day of Next Month.
• Full File extracts all data, regardless of how recently it was changed.
Note: You can only deactivate Salesforce accounts if you don't select Full File.
• Restrict Results By Orgs enables you to select one or more Organizations to include in the integration
output file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1209

Salesforce.com Prerequisites
Before setting up the Salesforce.com integration, verify that you have an Admin User account on
Salesforce.com that the 2 integration templates can use. Create any profiles that you want to assign to
your workers using the integrations.

Salesforce.com Chatter Configuration


If you want to provision Chatter accounts, Workday recommends that you configure your Chatter Admin
account as follows:
• Set the User Account Name to the Admin User or Company User. This name displays as the sender on
the private message.
• Don't set an Alias for the User Account.
The Admin account in Chatter can see all messages for all workers.
Salesforce.com Chatter passwords expire every 3 months. Update the password and security token in the
integration attributes for the Salesforce.com integrations.

Reference: Salesforce.com Worker Sync Integration Fields


This table lists Salesforce.com field values in the Connector output document and the source fields or
attributes in Workday:

Salesforce.com Field Workday Source Field


Username Primary Work Email Address
Alias Worker ID
Email Primary Work Email Address
IsActive Worker is Active & meets Eligibility criteria
LanguageLocaleKey Language Locale Key integration attribute
TimeZonesSidKey Time Zone Configuration integration attribute
LocaleSidKey Locale Sid Key integration attribute
EmailEncodingKey Email Encoding Key integration attribute
ProfileId Integration Field Override
Department Integration Field Override
Division Integration Field Override
Title Position Title
FirstName Preferred First Name
Last Name Preferred Last Name
Country Work Address Country
Company Name Tenant name
EmployeeNumber Worker ID

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1210

Skillsoft Integration

Steps: Set Up Skillsoft Integration

Prerequisites
Know the customer ID, endpoint URL, and password for your Skillsoft account.

Context
Set up an integration that imports licensed courseware into your learning catalog in Workday as external
digital courses.

Steps
1. Access the Create Integration System task and select Learning SkillSoft Course Sync from the New
Using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. Enable all optional integration services. The Configure Integration Services task displays all
integration services, including required services; those integration services aren't editable.
Security: Integration Build and Integration Configure domains in the Integration functional area.
3. Create an Integration System User (ISU) and grant the ISU access to the Integration Event domain in
the Integration functional area.
See Steps: Grant Integration or External Endpoint Access to Workday.
4. Register an API client for integrations in Workday and manage refresh tokens for the integration system
user.
Ensure that you configure these settings:
• For Scope (Functional Areas), select Backpack Hub Service from the prompt.
• Leave Non-Expiring Refresh Tokens selected.
• Leave the Include Workday Owned Scope and Locked Out due to Excessive Failed Signon
Attempts check boxes unselected.
See Register API Clients for Integrations.
5. Access the View API Clients report and record these values for the API client that you generated in the
previous step:
• Client ID.
• Refresh Token.
• Token Endpoint.
Security: Security Administration domain in the System functional area.
6. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Security: Integration Build and Integration Configure domains in the Integration functional area.
7. Access the Configure External Content task and specify Workday Learning-specific settings that the
integration applies to all imported courses.
The Topic Mapping section enables you to map learning topics to your Skillsoft tags or course folders
after you launch the integration for the first time. If you access this task before running the integration,
there are no tags available to map, but you can create mappings for subsequent runs.
Security: Set Up: Learning External Content Integrations domain in the Learning Core functional area.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1211

8. Launch an Integration on page 23.


For the Skillsoft Initiation Mode launch parameter, select one of these launch options:
• ALL: Gets metadata for all course content. Use this mode the first time you run the integration.
• DELTA: Gets new or updated metadata. If you don't select a value, Workday uses DELTA.
• ALL_NOT_RESET: Gets metadata for all course content, but doesn't reset the ALL or DELTA mode.
Related Information
Tasks
Configure External Content

Concept: Skillsoft Integration


Import licensed courseware from Skillsoft into your learning catalog in Workday as external digital courses.
Workday Learning only supports Skillsoft courses on mobile that Skillsoft has designed for mobile.

Skillsoft Integration and Supporting Tasks and Reports


The Skillsoft integration consists of these components and supporting tasks and reports:

Component Description
Configure External Content This task enables you to specify Workday Learning-
specific settings that the integration applies to all
imported courses. You can map learning topics to
your Skillsoft tags or course folder.
View External Digital Course Workday Learning displays this report when you
select a Skillsoft external digital course from:
• A worklet on the Learning Home page.
• The Manage Learning Content report.

Learning SkillSoft Course Sync This integration template enables you to create an
integration system that:
• Retrieves data files from Skillsoft.
• Loads the data into Workday.

Launch/Schedule Options
Workday provides these launch schedule options for the Skillsoft integration:
• Launch on schedule. You specify a run frequency, and Workday launches the integration automatically.
Upon launch, the integration retrieves any files from the endpoint.
• Launch immediately. You can launch the integration manually.

Integration Output Files


The Skillsoft integration creates learning content in Workday based on your Skillsoft catalog. The main
output of the integration is new courses in the learning catalog in your tenant. The integration also outputs
several informational files associated with the integration events. Workday retains these files for debugging
and troubleshooting purposes.

File Retention Description


Diagnostic-Audit.html 30 days A human-readable output file that
you can open in a web browser. It
contains detailed information on

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1212

File Retention Description


the courses that the integration
added, updated, or removed from
the tenant as well as identifiers
that are important for support.
The integration generates this file
as the final step.
Skillsoft-Asset-Metadata.zip 7 days A download of AICC packaged
content from the Skillsoft portal
for debugging purposes. It
contains many small text files
that enable the media player in
Workday to launch out to content
on Skillsoft.
Skillsoft-Full-Course-Listing.csv 7 days A download of the catalog
hierarchy from Skillsoft for
debugging purposes. The
integration uses this data to
generate tags that we apply to the
courses.
Diag_Course_Sync_Summary.xml 3 days An intermediate XML file that
contains records of tenant
modifications. The integration
later processes this data and
transforms it into the Diagnostic-
Audit.html file.
Post-Processing-1.zip 3 days The integration can output up
to 15 similarly named files.
Due to polling delays while
Skillsoft prepare their catalog
for download, the integration
terminates and relaunches a
number of times. These zip
files enable Workday to pass
the context or state from one
invocation to the next.

Troubleshooting: Error When Syncing Course Data with Skillsoft Integration


When you're syncing course data in DELTA mode, you receive an error message because the integration
timed out while waiting for Skillsoft to generate the ZIP file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1213

Cause: Workday reached its maximum number of attempts when trying to sync course data because
Skillsoft isn’t currently available.
Solution: Run the integration in DELTA mode again later.
Solution: Run the integration in ALL mode to sync metadata for all course content.

Social Security Number Verification Service

Steps: Set Up Social Security Number Verification Service Integration

Context
Set up an integration to generate employee Social Security Number data for uploading to the Social
Security Number Verification Service (SSNVS).

Steps
1. Enroll your organization in the Social Security Number Verification Service.
2. Access the Create Integration System task and enter Social Security Number Verification at the New
using Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
domain.
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
4. As a related action on your integration, select Integration System > Configure Integration Attributes
and enter the number of days that Workday preserves output files.
5. Set Up Integration Sequence Generators on page 1856.
In the Sequence ID Format field, add .txt to the end of the field value.
6. Launch an Integration on page 23.
Verify that the integration generates data as expected. Since the integration doesn’t deliver files to the
SSNVS, you can test the integration with live data.
7. Upload the SSNVS files to the SSNVS for overnight processing.

Concept: Social Security Number Verification Service Integration


To verify that your employee names and Social Security numbers (SSN) match Social Security
Administration records, use the Social Security Number Verification Service (SSNVS) integration. The
Social Security Number Verification Service integration generates one or more flat files in the SSNVS file
format for upload to the SSNVS.

About the Social Security Number Verification Service (SSNVS)


The SSNVS provides several online verification methods. The Social Security Number Verification Service
integration generates files for overnight upload. Files can contain up to 250,000 names and SSN numbers;
the SSNVS usually sends results the next government business day. This option is ideal if you want to
verify an entire payroll database or if you hire many workers at a time. While the service is available to all
employers and third-party submitters, these limits apply:
• You can use the service only for verifying current or former employees.
• You can use the service only for wage reporting (Form W-2) purposes.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1214

Integration File Generation and Delivery


The integration template doesn’t support integration file delivery; integration output files are attached to
the integration event. The integration generates a flat text file (.txt) in the SSNVS format. If you run the
integration for more than 250,000 employees (past and current), the integration splits the output into 2 files.
Download the output files from the integration event and send the files on to the SSNVS. This integration
doesn’t support direct delivery of integration output files to the SSNVS.
Using a combination of launch parameters you can define which employees to include in the output file:
• Begin Date and End Date: includes any employee with a Hire Date within the date range.
• Calendar Year: includes any employee who you paid at any point during the calendar year.
• Employee: includes employees that you select by name.

Integration Audit Files


Every time the integration runs, Workday generates a Messages Audit that includes response messages
from the integration system.
You can find the SSNVS zip and Messages Audit files in the Reports and Other Output Files section of
the Integration Event for each integration run.

Talent Profile Inbound Connector

Steps: Set Up Talent Profile Inbound Connector

Prerequisites
Set up an external server that your external endpoint and Connector can access.

Context
Set up an integration that imports worker talent profile updates from an external endpoint into Workday.

Steps
1. Configure your external endpoints so that they generate data for in 1 of the formats supported by the
Connector.
See: Reference: Talent Profile Inbound Connector File Schema on page 1215.
2. Create Integration System on page 1854.
Enter Core Connector: Talent Profile Inbound at the New Using Template prompt.
3. Enable one or more of these optional integration services. The Configure Integration Services task
displays all integration services, including required services; those integration services aren't editable.
Option Description
Talent Profile Inbound: Worker Certification Enables your integration to import certification
Achievement Data achievements into corresponding certification
achievement records in Workday.
Talent Profile Inbound: Worker Competency Enables your integration to import competency
Achievement Data achievements into corresponding competency
achievement records in Workday.
Talent Profile Inbound: Worker Training Enables your integration to import training
Achievement Date achievements into corresponding training
achievement records in Workday.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1215

Option Description
Talent Profile Inbound: Worker Experience Enables your integration to import experience
Data records into corresponding experience records in
Workday.
4. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Manage Certifications (business process)
• Manage Competencies (business process)
• Manage Training (business process)
• Worker Data: Public Worker Reports
• Worker Data: Skills and Experience
• Worker Data: Workers
See: ../../../authentication-and-security/security-for-integrations/access-to-workday-data/
dan1370797146076.dita.
5. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves data files containing changes to worker talent profiles from
your external server. If your integration imports files in CSV format, configure a separate retrieval step
for each worker talent profile file type that applies the appropriate Document tag:
• Talent Profile Inbound Certification
• Talent Profile Inbound Competency
• Talent Profile Inbound Training
6. Launch an Integration on page 23.
Schedule how often the integration system runs.

Concept: Talent Profile Inbound Connector


To import talent profile updates for workers into Workday, use the Talent Profile Inbound Connector.
The Connector can update worker certifications, competencies, and completed training. You can use a
non-Workday application as your source-of-truth for talent profile data, then synchronize that data with
Workday.
Note: Talent Profile Inbound Connector works with worker talent profiles in Workday. Workday
recommends that you familiarize yourself with Workday talent features.

File Format for Talent Profile Inbound Connector Data


The integration imports data in a Workday-defined XML or CSV (Comma-Separated Value) format.

Integration Process Flow


The integration imports talent data using this process:
1. Your external endpoint generates a file (in one of the Workday-supported formats).
2. Your external endpoint sends the file to a file server known to the integration.
3. You launch the integration, either by schedule or manually.
4. The integration retrieves the file according to the Document Retrieval configuration on the Integration
Process Event and applies document tags.
5. The integration processes the file, then imports the data into Workday.

Reference: Talent Profile Inbound Connector File Schema

Certification CSV Format


The certification CSV file must contain these fields, in order:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1216

• Worker_ID
• Worker_Type
• Certification_Reference_ID
• Remove_Certification
• Certification_ID
• Certification_Name
• Issuer
• Country_Code
• Issued_Date
• Expiration_Date
• Examination_Date
• Examination_Score
• Certification_Number

Competency CSV Format


The competency CSV file must contain these fields, in order:
• Worker_ID
• Worker_Type
• Competency_Reference_ID
• Competency_Level_ID
• Note
• Assessed_On
• Assessed_By_Worker_ID
• Assessed_By_Worker_Type

Training CSV Format


The training CSV file must contain these fields, in order:
• Worker_ID
• Worker_Type
• Training_Reference_ID
• Remove_Training
• Training_Name
• Description
• Training_Type_ID
• Completion_Date
• Training_Duration

Worker Experience CSV Format


The Worker Experience CSV file must contain these fields, in order:
• Worker_ID
• Worker_Type
• Experience_Reference_ID
• Remove_Experience
• Experience_Rating_Reference_ID
• Experience_Comment

XML Elements
The XML schema for inbound talent profile data includes these elements:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1217

Element Level
Description
Import_Talent_Profiles_Request 1Contains all other elements. Only 1 element per
file.
Worker_Talent_Profile 2Contains 1 instance of all subsequent elements,
except as noted. Unlimited number of elements per
file.
Worker_ID 3Reference ID value for the worker. Must be in XSD
string format.
Worker_Type 3Employment type for the worker in Workday. If not
specified, Workday sets this value to Employee.
Certification 3Contains 1 instance of each certification-related
subelement. Unlimited number of elements per file.
Certification_Reference_ID 4Reference ID value for the Certification. This value
must match the Reference ID for the certification
defined in Workday. Must be in XSD string format.
Remove_Certification 4If selected, removes the specified certification from
the talent profile of the worker. Must be in XSD
boolean format.
Certification_ID 4External ID value for the certification. Match this
value to the corresponding ID value as defined in
your external endpoint. If Certification_Name and
Issuer have values, don't include this element. Must
be in XSD string format.
Certification_Name 4External name value for the certification. Match this
value to the corresponding name value as defined
in your external endpoint. If Certification_ID has a
value, don't include this element. Must be in XSD
string format.
Issuer 4Entity that manages the certification. If
Certification_ID has a value, don't include this
element. Must be in XSD string format.
Country_Code 4Code value for the country where the worker
acquired the certification. Must be in XSD string
format.
Issued_Date 4Date that the worker acquired the certification. Must
be in XSD date format.
Expiration_Date 4Date that the certification expired. Must be in XSD
date format.
Examination_Date 4Date that worker completed certification exam.
Must be in XSD date format.
Examination_Score 4Score that worker earned for examination. Must be
in XSD string format.
Certification_Number 4The number that the issuer assigned to the
certification. Must be in XSD string format.
Competency 3Contains 1 instance of each competency-related
subelement. Unlimited number of elements per file.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1218

Element Level
Description
Competency_Reference_ID 4Reference ID value for the competency. This value
must match the Reference ID for the competency
defined in Workday. Must be in XSD string format.
Competency_Level_ID 4Reference ID value for the competency level.
This value must match the Reference ID for the
competency level defined in Workday. Must be in
XSD string format.
Note 4Free-form note text. Must be in XSD string format.
Assessed_On 4Date that the assessor assessed the competency
of the worker. Must be in XSD date format.
Assessed_By_Worker_ID 4Reference ID for the worker who assessed the
competency. Must be in XSD string format.
Assessed_By_Worker_Type 4Employment type of the assessing worker in
Workday. If not specified, Workday sets this value
to Employee.
Training 3Contains 1 instance of each training-related
subelement. Unlimited number of elements per file.
Training_Reference_ID 4Reference ID value for the training. This value must
match the Reference ID for the training defined in
Workday. Must be in XSD string format.
Remove_Training 4If selected, removes the specified training from the
talent profile of the worker. Must be in XSD boolean
format.
Training_Name 4External name value for the training. Match this
value to the corresponding name value as defined
in your external endpoint. Must be in XSD string
format.
Description 4Description of the training. Must be in XSD string
format.
Training_Type_ID 4Training type ID value. Must be in XSD string
format.
Completion_Date 4Date that worker completed training. Must be in
XSD date format.
Training_Duration 4Length of time that the training lasted. Must be in
XSD string format.
WorkerExperience 3Contains 1 instance of each worker experience-
related subelement. Unlimited number of elements
per file.
Experience_Reference_ID 4Reference ID value for the experience element of
the worker. This value must match the Reference
ID for the experience record of the worker defined
in Workday. Must be in XSD string format.
Remove_Experience 4If selected, removes the specified experience
record from the talent profile of the worker. Must be
in XSD boolean format.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1219

Element Level
Description
Experience_Rating_Reference_ID 4Reference ID for the experience rating of the
worker. This value must match the Reference ID
for the experience rating of the worker defined in
Workday. Must be in XSD string format.
Experience_Comment 4Comment about the experience of the worker. Must
be in XSD string format.

XML Schema

<?xml version="1.0" encoding="UTF-8"?>


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:tp="urn:com.workday/coreconnector/inbound/talentprofile"
targetNamespace="urn:com.workday/coreconnector/inbound/talentprofile"
elementFormDefault="qualified" attributeFormDefault="qualified">
<xsd:annotation>
<xsd:appinfo>Core Connector: Talent Inbound integration</xsd:appinfo>
<xsd:documentation>This schema defines an inbound record for the Core
Connector: Talent Inbound integration</xsd:documentation>
</xsd:annotation>
<!-- Wrapping element for the worker talent records -->
<xsd:element name="Import_Talent_Profiles_Request"
type="tp:Import_Talent_Profiles_Request"> </xsd:element>
<!-- Single talent inbound record definition -->
<xsd:complexType name="Import_Talent_Profiles_Request">
<xsd:sequence>
<xsd:element name="Worker_Talent_Profile" type="tp:Worker_Talent_Profile"
maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="Worker_Talent_Profile">
<xsd:sequence>
<xsd:element name="Worker_ID" type="xsd:string" />
<xsd:element name="Worker_Type" minOccurs="0"
type="tp:Worker_Type" default="Employee" />
<xsd:element name="Certification" type="tp:Certification"
maxOccurs="unbounded" minOccurs="0" />
<xsd:element name="Competency" type="tp:Competency"
maxOccurs="unbounded" minOccurs="0" />
<xsd:element name="Training" type="tp:Training"
maxOccurs="unbounded" minOccurs="0" />
<xsd:element name="WorkerExperience" type="tp:WorkerExperience"
maxOccurs="unbounded" minOccurs="0"/>
</xsd:sequence>
</xsd:complexType>
<!-- Certification Achievement Talents -->
<xsd:complexType name="Certification">
<xsd:sequence>
<xsd:element name="Certification_Reference_ID" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Remove_Certification" type="xsd:boolean"
nillable="true" minOccurs="0" />
<xsd:choice minOccurs="0">
<xsd:element name="Certification_ID" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:sequence minOccurs="0">
<xsd:element name="Certification_Name" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Issuer" type="xsd:string"
nillable="true"

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1220

minOccurs="0" />
</xsd:sequence>
</xsd:choice>
<xsd:element name="Country_Code" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Issued_Date" type="xsd:date" nillable="true"
minOccurs="0" />
<xsd:element name="Expiration_Date" type="xsd:date"
nillable="true" minOccurs="0" />
<xsd:element name="Examination_Date" type="xsd:date"
nillable="true" minOccurs="0" />
<xsd:element name="Examination_Score" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Certification_Number" type="xsd:string"
nillable="true" minOccurs="0" />
</xsd:sequence>
</xsd:complexType>
<!-- Competency Achievement Talents -->
<xsd:complexType name="Competency">
<xsd:sequence>
<xsd:element name="Competency_Reference_ID" type="xsd:string"
nillable="true" />
<xsd:element name="Competency_Level_ID" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Note" type="xsd:string" nillable="true"
minOccurs="0" />
<xsd:element name="Assessed_On" type="xsd:date" nillable="true"
minOccurs="0" />
<xsd:element name="Assessed_By_Worker_ID" type="xsd:string"
nillable="true" minOccurs="0">
</xsd:element>
<xsd:element name="Assessed_By_Worker_Type" minOccurs="0"
type="tp:Worker_Type" default="Employee" />
</xsd:sequence>
</xsd:complexType>
<!-- Training Talents -->
<xsd:complexType name="Training">
<xsd:sequence>
<xsd:element name="Training_Reference_ID" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Remove_Training" type="xsd:boolean"
nillable="true" minOccurs="0" />
<xsd:element name="Training_Name" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Description" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Training_Type_ID" type="xsd:string"
nillable="true" minOccurs="0" />
<xsd:element name="Completion_Date" type="xsd:date"
nillable="true" minOccurs="0" />
<xsd:element name="Training_Duration" type="xsd:string"
nillable="true" minOccurs="0" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="WorkerExperience">
<xsd:sequence>
<xsd:element name="Experience_Reference_ID" type="xsd:string"
nillable="true"/>
<xsd:element name="Remove_Experience" type="xsd:boolean" nillable="true"
minOccurs="0"/>
<xsd:element name="Experience_Rating_Reference_ID" type="xsd:string"
nillable="true" minOccurs="0"/>
<xsd:element name="Experience_Comment" type="xsd:string" nillable="true"
minOccurs="0"/>

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1221

</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="Worker_Type">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Employee"/>
<xsd:enumeration value="Contingent Worker"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>

Unistaff Connectors

Steps: Set Up Unistaff Foundation Connector

Context
You can create an integration that sends data to Unistaff.

Steps
1. Access the Create Integration System task and enter Unistaff Foundation Data at the New using
Template prompt.
Security: Integration Build and Integration Configure domains in the Integration functional area.
2. To customize which types of foundation data that the integration sends, enable one or more of the
optional integration services.
The Configure Integration Services task displays all integration services, including required services.
Required integration services aren’t editable.
3. Create an Integration System User (ISU) and grant the ISU Get and Put access to the Integration Event
security domain.
See: Steps: Grant Integration or External Endpoint Access to Workday.
4. Select Integration System > Configure Integration Attributes as a related action on the integration
system and enter integration service attributes.
Workday displays attributes for each enabled integration service. If you enable additional integration
services, more attributes display in the Configure Integration Attributes task.
5. As a related action on the integration system, select Integration System > Configure Integration
Maps and map data between Workday and the external endpoint.
6. Select Integration System > Configure Integration Field Overrides as a related action on the
integration system and configure integration output.
Security: Integration Build and Integration Configure domains in the Integration functional area.
7. Create Integration Business Process on page 1838.
Add a Document Delivery Service step to the business process definition of the integration.
8. Set Up Integration Delivery on page 1839.
Configure the integration so that it sends integration output files to Unistaff using SFTP.
9. Launch an Integration on page 23.
Schedule how often the integration system runs. To export all foundation data from Workday to Unistaff,
use the Full Extract launch parameter.

Steps: Set Up Unistaff Hire Inbound Connector

Prerequisites
Set up an external SFTP that Unistaff and your integration can access.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1222

Context
Set up an integration system to import new hire data from Unistaff into Workday.

Steps
1. Access the Create Integration System task and enter Unistaff Inbound at the New using Template
prompt.
Security: Integration Build in the Integration functional area.
(Optional) To import specific types of worker data, enable the Unistaff Inbound - Hire and Contract or
Unistaff Inbound - Update Worker Information integration services.
2. Create an Integration System User (ISU) and grant the ISU Get and Put access to these domains:
• Contract Contingent Worker (business process)
• Dependent Event (business process)
• Edit Government IDs (business process)
• Edit Licenses (business process)
• Edit Other IDs (business process)
• Hire Employee (business process)
• Integration Event
• Legal Name Change (business process)
• Manage Education (business process)
• Manage Job History (business process)
• Manage Payment Election
• Manage Pre-Hire Process: Manage Pre-Hires
• Passports and Visa Change (business process)
• Preferred Name Change (business process)
• Request Compensation Change (business process)
• Request Leave of Absence (business process)
• Request One Time Payment (business process)
• Workday Accounts
• Person Data: Personal Information
• Worker Data: Public Worker Reports
See: Steps: Grant Integration or External Endpoint Access to Workday.
3. As a related action on your Unistaff Inbound integration, select Integration System > Configure
Integration Attributes add a row for each attribute and specify a value.
4. Set Up Integration Retrieval on page 1845.
Specify how the integration system retrieves data files from the SFTP server.
5. Launch an Integration on page 23.
Schedule how often the integration system runs.

Concept: Unistaff Connectors


Synchronize data between Workday and Unistaff with Unistaff Connectors. Unistaff Connectors enable
you to meet data privacy requirements for employees in the Russian Federation. The Connector transfers
personally identifiable information for Russian citizens between Unistaff and Workday. To support Unistaff,
Workday provides 2 Unistaff integration templates:
• Unistaff Foundation Data
• Unistaff Inbound
To integrate Workday with Unistaff, implement both integrations.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1223

Unistaff Foundation Connector


The Unistaff Foundation Data template supports export of organization, location, job family, position,
and job profile data from Workday to Unistaff. As you add, change, move, and delete these items, the
integration sends incremental updates directly to Unistaff. The integration also provides a Full File launch
parameter. You can use the full file launch option to transfer these items from Workday to Unistaff:
• Job families
• Job profiles
• Locations
• Organizations
• Positions

Integration Service Description


Unistaff Foundation Data - Organizations Extracts organization changes from your tenant.
Data Init Service
Unistaff Foundation Data - Locations Data Extracts location changes from your tenant. You can select
Init Service types of locations that the integration monitors for changes.
Unistaff Foundation Data - Job Families Extracts job family changes from your tenant.
Data Init Service
Unistaff Foundation Data - Job Profiles Data Extracts job profile changes from your tenant.
Init Service
Unistaff Foundation Data - Position Extracts position restriction changes from your tenant.
Restrictions Data Init Service

Unistaff Inbound
The Unistaff Inbound template enables you to import new hires and updates to personally identifiable
information only pertaining to Russian citizens. Workday provides the XML file format. Contact Unistaff for
assistance in formatting and generating the inbound XML file. The Unistaff Inbound integration supports
these actions:
• Add Dependent: add, delete, update
• Address: add, delete, replace, update
• Certification: add, delete, update
• Compensation change: add
• Education: add, delete, update
• Government ID: add, replace
• Job History: add, delete, update
• Legal Name: add, update
• License: add, replace
• National ID: add, replace
• Other IDs (Custom IDs): add, replace
• Passport and Visas: add, replace
• Personal Information: add, update
• Phone, Email, Instant Messenger and Web: add
• Preferred Name: add, update
• Request Leave of Absence: add

Launch/Schedule Options
Workday provides these launch schedule options for the Unistaff Foundation Connector integration:

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1224

• Launch using a schedule. You specify a run frequency, and Workday launches the integration
automatically. Upon launch, the integration collects all qualifying changes based on the launch
parameters.
• Launch immediately. You can launch the integration manually. Workday prompts you for the launch
parameters.
For launch using a schedule and launch immediately, you can enter these launch parameters:

Parameter Description
As Of Entry Moment Extracts records that you entered into Workday
after the specified moment.
Effective Date. Extracts records that became effective in Workday
on or after the specified date.
Last Successful As Of Entry Moment Extracts records that you entered into Workday
after this date/time.
Last Successful Effective Date Extracts records with an effective date after this
date.
Full Extract Extracts all records.

Integration Audit Files


Every time the integration runs, Workday generates these files:
• A copy of the outbound file.
• The MessagesAudit.zip file includes troubleshooting files that confirm data processing steps.
• The Unistaff Inbound error log displays integration errors. The integration generates this report only if
there are errors in the integration.
You can find these files in the Integration Event for each integration run.
Note: Because Workday includes actual data in the Data Change Audit file, you can secure this file
separately. Example: if you don't want administrators to access the data.

Reference: Unistaff Hire Inbound Connector XML File Schema


This table lists available attributes that the integration supports. Some supported attributes might not be
available. Contact Unistaff:
• To create custom attributes as needed.
• To import custom field data into Workday.
• For general configuration assistance.
Each file must have a top-level element of Actions. All action elements in the file (Example: Hire) must be
child elements of the Actions top-level element.

Action/Sub-Element(s) Field Comments


Hire Required element. You can
include many Hire elements.
Worker_ID Required element. Specify the
Employee or Contingent Worker
ID that you want to use for the
Worker record. Workday uses
this value to look up existing
applicants that were previous
employees or contingent workers.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1225

Action/Sub-Element(s) Field Comments


Workday uses this ID as the
HRIS ID for new workers.
Updated_Worker_ID Optional element. If Worker_ID
specifies an existing worker that
you're rehiring, setting this field
sets the Worker ID of the new
worker. If empty, the Worker ID
remains unchanged.
User_Name Optional element. Workday
account ID.
Hire_Reason Conditional element. The reason
that you're rehiring the employee.
Defined by Workday integration
mapping.
Contract_Reason Conditional element. The reason
that you're contracting the
contingent worker. Defined by
Workday integration mapping.
Hire_Date Required element. The date of
hire for the worker in YYYY-MM-
DD format.
Employee_Type Conditional element. Defined by
Workday integration mapping.
Contingent_Worker_Type Conditional element. Defined by
Workday integration mapping.
Start_Date Optional element. The first day of
work of the worker in YYYY-MM-
DD format.
End_Date Optional element. The last day of
work of the worker in YYYY-MM-
DD format.
Job_Profile Required element. You can pass
this value with Workday Unistaff
Foundation Data Integration. Job
Profile Code from Foundation
Data Integration.
Position_Time_Type Required element. Defined by
Workday integration mapping.
Location Required element. You can pass
this value with Workday Unistaff
Foundation Data Integration.
Reference ID from Foundation
Data Integration.
Work_Space Optional element. You can
pass this value with Workday
Unistaff Foundation Data

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1226

Action/Sub-Element(s) Field Comments


Integration. Location (from
Unistaff Foundation Data).
Job_Title Optional element. Text field.
Position_Title Optional element. Text field.
Pay_Rate_Type Optional element. Defined by
Workday integration mapping.
Work_Shift Optional element. Defined by
Workday integration mapping.
Supervisory_Organization Required element. You can pass
this value with Workday Unistaff
Foundation Data Integration.
Position Conditional element. Required
for Position Management
organizations. Defined by
Workday integration mapping.
Pay_Group Optional element. You can pass
this value with Workday Unistaff
Foundation Data Integration.
Send Unistaff corresponding
object ID if the data exists in
Unistaff.
Name_Country Optional element. Employee
Country. Controls Employee
Name Data logic. Defined by
Workday integration mapping.
ISO 3166-1 alpha 3.
First_Name Optional element. Employee
Legal First Name.
Middle_Name Optional element. Employee
Legal Middle Name or initial.
Last_Name Employee Legal Last Name
Secondary_Last_Name Optional element.
Local_First_Name Optional element.
Local_Middle_Name Optional element.
Local_Last_Name Optional element.
Local_Secondary_Last_Name Optional element.
Birth_Date Optional element. Employee Birth
Date in YYYY-MM-DD format.
City_of_Birth Optional element. Employee City
of Birth.
Gender Optional element. Defined by
Workday integration mapping.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1227

Action/Sub-Element(s) Field Comments


Region_of_Birth Optional element. Employee
Region (State/Province/Region)
of Birth. Defined by Workday
integration mapping. ISO 3166-2.
Country_of_Birth Employee country of birth.
Marital_Status Optional element. Worker marital
status. Defined by Workday
integration mapping.
Marital_Status_Date Optional element. The date that
this marital status changed.
Workday requires marital status if
you specify the date on the file.
Nationality Optional element. Employee
Nationality Reference. Defined
by Workday integration mapping.
ISO 3166-1 alpha 3 or alpha 2.
Citizenship_Status Optional element. Defined by
Workday integration mapping.
Ethnicity Optional element. Defined by
Workday integration mapping.
Ethnicity_Visual_Survey Optional element. Global Race
reference by visually surveying
the worker
Religion Optional element. Defined by
Workday integration mapping.
Political_Affiliation Optional element. Defined by
Workday integration mapping.
Military_Status Optional element. Defined by
Workday integration mapping.
Military_Service_Type Optional element. Defined by
Workday integration mapping.
Military_Discharge_Date Optional element. Date in YYYY-
MM-DD format.
Military_Notes Optional element.
Military_Rank Optional element. Defined by
Workday integration mapping.
Military_Status_Begin_Date Optional element. Date in YYYY-
MM-DD format.
Address_Line_1 Optional element.
Address_Line_2 Optional element.
Municipality Optional element. City for the
Worker Home Address

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1228

Action/Sub-Element(s) Field Comments


Address_Country Required element. Address
Country. Controls Employee
Contact Data Logic. Defined by
Workday integration mapping.
ISO 3166-1 alpha 3 or alpha 2.
Region Optional element. Region for
the Worker Home Address. ISO
3166-1 alpha 3.
Sub_Region Optional element.
Sub_Region_Type Optional element.
Postal_Code Optional element.
Address_Usage Optional element. Workday
populates this value with HOME if
this element is empty. Defined by
Workday integration mapping.
Address_Usage_Comments Optional element.
Is_Primary Optional values: Y or N.
Phone_Is_Public Optional values: Y or N.
Phone_Country Required element. Phone
Country. Controls Employee
Phone Data Logic. Defined by
Workday integration mapping.
ISO 3166-1 alpha 3.
Phone_Area_Code Optional element.
Phone_Number Optional element.
Phone_Extension Optional element.
Phone_Device_Type Optional element. Defined by
Workday integration mapping.
Phone_Usage Optional element. Workday
populates this value with HOME if
this element is empty. Defined by
Workday integration mapping.
Phone_Usage_Comments Optional element.
Email_Address Conditionally required for a
new worker when you provide a
User_Name. Text field.
Email_Address_Usage Optional element. Workday
populates this value with HOME if
this element is empty. Defined by
Workday integration mapping.
Email_Address_Usage_Comments Optional element.
Compensation_Grade_Profile Optional element. Defined by
Workday integration mapping.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1229

Action/Sub-Element(s) Field Comments


Compensation_Grade Conditionally required if
Compensation data exists on
the file. Defined by Workday
integration mapping.
Compensation_Package Conditionally required if
Compensation data exists on
the file. Defined by Workday
integration mapping.
Compensation_Plan Conditionally required if
Compensation data exists on
the file. Defined by Workday
integration mapping.
Compensation_Step Optional element. Defined by
Workday integration mapping.
Compensation_Amount Conditionally required if
Compensation data exists in this
section.
Compensation_Frequency Conditionally Required if
Compensation data exists in this
section. Defined by Workday
integration mapping.
Compensation_Currency Conditionally required if
Compensation data exists in this
section. Defined by Workday
integration mapping. ISO 4217
alpha.
Stock_Plan Optional element. Defined by
Workday integration mapping.
Stock_Individual_Target_Shares Optional element. Include a
Target Amount, Target Percent,
or Target shares if stock data
exists on the file.
Stock_Individual_Target_Percent Optional element. Include a
Target Amount, Target Percent,
or Target shares if stock data
exists on the file.
Stock_Individual_Target_Amount Optional element. Include a
Target Amount, Target Percent,
or Target shares if stock data
exists on the file.
Stock_Currency Conditional element. Defined by
Workday integration mapping.
ISO 4217 alpha.
Commission_Plan Conditionally required if
Commission data exists on
the file. Defined by Workday
integration mapping

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1230

Action/Sub-Element(s) Field Comments


Commission_Amount Conditionally required if
Commission data exists on the
file.
Commission_Frequency Conditionally required if
Commission data exists on
the file. Defined by Workday
integration mapping.
Commission_Currency Conditionally required if
Commission data exists on
the file. Defined by Workday
integration mapping. ISO 4217
alpha.
Commission_Draw_Amount Optional element.
Commission_Draw_Frequency Optional element. Defined by
Workday integration mapping.
Commission_Draw_Duration Optional element.
Merit_Plan Conditionally required if Merit
data exists on the file. Defined by
Workday integration mapping.
Merit_Individual_Target_Percent Optional element.
Merit_Individual_Target_Amount Optional element.
Merit_Guaranteed_Minimum Optional element.
Merit_Actual_End_Date Optional element. Date in YYYY-
MM-DD format.
Bonus_Plan Conditionally required if Bonus
data exists in this section.
Defined by Workday integration
mapping
Bonus_Individual_Target_Amount Optional element. Text field.
Bonus_Individual_Target_Percent Optional element.
• For 100%, enter 1.
• For 50%, enter 0.5.

Bonus_Percent_Assigned Optional element.


• For 100%, enter 1.
• For 50%, enter 0.5.

Bonus_Guaranteed_Minimum Optional element.


Allowance_Plan Conditionally required if
Allowance data exists in this
section. Defined by Workday
integration mapping.
Allowance_Amount Optional element. Alternately, use
Allowance_Percent.

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1231

Action/Sub-Element(s) Field Comments


Allowance_Percent Optional element. Alternately, use
Allowance_Amount.
Allowance_Frequency Conditionally required if One
Time Payment data exists on
the file. Defined by Workday
integration mapping.
Allowance_Currency Conditionally required if One
Time Payment data exists on
the file. Defined by Workday
integration mapping. ISO 4217
alpha.
Allowance_End_Date Optional element. Date in YYYY-
MM-DD format.
One-Time_Payment_Plan Conditionally required if One
Time Payment data exists on
the file. Defined by Workday
integration mapping.
One-Time_Payment_Reason Optional element. Defined by
Workday integration mapping.
One-Time_Payment_Date Conditionally required if One
Time Payment data exists on
the file. Date in YYYY-MM-DD
format.
One-Time_Payment_Begin_Date Optional element. Date in YYYY-
MM-DD format.
One-Time_Payment_End_Date Optional element. Date in YYYY-
MM-DD format.
One-Time_Payment_Amount Conditionally required if One
Time Payment data exists on the
file.
One-Time_Payment_Percent Optional element. Text field.
• For 100%, enter 1.
• For 50%, enter 0.5.

One-Time_Payment_Currency Conditionally required if One


Time Payment data exists on
the file. Defined by Workday
integration mapping. ISO 4217
alpha.
One-Time_Payment_Comment Optional element.
Hire > Required element.
You can include many
Additional_Nationalities
Additional_Nationality elements.
Additional_Nationality Optional element. Employee
Additional Nationality references.
Defined by Workday integration

©2025 Workday, Inc. All rights reserved Workday Proprietary and Confidential
| HCM Connectors | 1232

Action/Sub-Element(s) Field Comments


mapping. ISO 3166-1 alpha 3 or
alpha 2.
Hire > You can include many Disabilities
elements.
Disabilities

Hire >
Disabilities >
Disability

Disability_Status Optional element. Defined by


Workday integration mapping.
Disability_Status_Date Optional element. Date in YYYY-
MM-DD format.
Disability_Known_Date Optional element. Date in YYYY-
MM-DD format.
Disability_End_Date Optional element. Date in YYYY-
MM-DD format.
Hire >

You might also like