Functional Specification for INTERFACES

XXX-I-nnn Interface Name

Date:
Version:
FIG 3A INTERFACE FUNCTIONAL SPECIFICATION TEMPLATE TABLE OF CONTENTS
Contents
1 DOCUMENT SEMANTICS.....................................................................................................................................4
1.1 DOCUMENT PROPERTIES......................................................................................................................................4
1.2 AMENDMENT HISTORY........................................................................................................................................4
1.3 DISTRIBUTION.....................................................................................................................................................5
1.4 APPROVAL...........................................................................................................................................................5
2 QA’S & SIGNOFFS...................................................................................................................................................6
3 OVERVIEW...............................................................................................................................................................8
4 FUNCTIONAL SPECIFICATION OVERVIEW..................................................................................................8
4.1 GENERAL INFORMATION.....................................................................................................................................8
4.1.1 Business Units Impacted............................................................................................................................8
4.1.2 Reference Document..................................................................................................................................8
4.1.3 Model / Process.........................................................................................................................................8
4.1.4 Scope..........................................................................................................................................................8
4.2 CONTROLS...........................................................................................................................................................8
4.2.1 Interface Description.................................................................................................................................8
4.2.2 Interface Controls......................................................................................................................................8
4.2.3 Dependencies.............................................................................................................................................8
4.2.4 Access Restrictions (Security)...................................................................................................................9
4.3 PROCESSING........................................................................................................................................................9
4.3.1 Starting Conditions....................................................................................................................................9
4.3.2 Frequency..................................................................................................................................................9
4.3.3 Volume of Data..........................................................................................................................................9
4.3.4 Archiving....................................................................................................................................................9
4.3.5 Error Handling and Recovery Start..........................................................................................................9
4.4 ASSUMPTIONS / EXCLUSIONS..............................................................................................................................9
5 INTERFACE FUNCTIONAL SOLUTION..........................................................................................................11
5.1 STAGE 1 – SOURCE SYSTEM..............................................................................................................................11
5.1.1 Program Flow..........................................................................................................................................11
5.1.2 Extraction Criteria...................................................................................................................................11
5.1.3 Calculations, Conversions & Formatting................................................................................................11
5.1.4 Mapping...................................................................................................................................................11
5.1.5 Processing Control...................................................................................................................................11
5.1.6 Business Controls and Security...............................................................................................................11
5.2 STAGE 2 MIDDLEWARE SOLUTION....................................................................................................................12
5.2.1 Program Flow..........................................................................................................................................12
5.2.2 Extraction Criteria..................................................................................................................................12
5.2.3 Calculations, Conversions & Formatting...............................................................................................12
5.2.4 Mapping...................................................................................................................................................12
5.2.5 Processing Control..................................................................................................................................12
5.2.6 Business Controls and Security...............................................................................................................12
5.3 STAGE 3 RECEIVING SYSTEM............................................................................................................................12
5.3.1 Program Flow..........................................................................................................................................12
5.3.2 Extraction Criteria..................................................................................................................................12
5.3.3 Calculations, Conversions & Formatting...............................................................................................12
5.3.4 Mapping...................................................................................................................................................12
5.3.5 Processing Control..................................................................................................................................12

Page 2 of 20
 5.3.6 Business Controls and Security...............................................................................................................13
6 TESTING REQUIREMENTS...............................................................................................................................14
6.1 INTERFACE TRIGGER.........................................................................................................................................14
6.2 INTERFACE CONTENT........................................................................................................................................14
6.3 CUSTOM TABLES...............................................................................................................................................14
6.4 CONFIGURATION................................................................................................................................................14
6.5 AUTHORISATIONS..............................................................................................................................................14
6.6 TEST DATA........................................................................................................................................................14
6.7 OTHER TEST CYCLES........................................................................................................................................14
7 ISSUES.....................................................................................................................................................................15
7.1 TECHNICAL ISSUES AND RESOLUTION..............................................................................................................15
8 TECHNICAL SPECIFICATION...........................................................................................................................16
8.1 TECHNICAL FLOW DIAGRAM............................................................................................................................16
8.2 ENTERPRISE INTEGRATION TECHNOLOGY SELECTION......................................................................................16
8.3 INTEGRATION FLOW LOGIC (PSEUDO CODE)....................................................................................................16
8.3.1 Message...................................................................................................................................................16
8.3.2 Detailed Process Flow.............................................................................................................................16
8.3.3 Interface Complexity...............................................................................................................................16
8.4 TECHNICAL WORKSHOP OUTPUT......................................................................................................................16
9 IMPLEMENTATION & DEPLOY.......................................................................................................................18
9.1 USER INSTRUCTIONS:........................................................................................................................................18
9.1.1 Procedures For Processing.....................................................................................................................18
9.1.2 Frequency................................................................................................................................................18
9.1.3 Manual Processing..................................................................................................................................18
9.1.4 Error Handling........................................................................................................................................18
9.1.5 Clearing Out Directories.........................................................................................................................18
9.1.6 Problem Reporting...................................................................................................................................18
9.1.7 SAP Programs and Related Documents..................................................................................................18
9.1.8 Security Checks:......................................................................................................................................18
9.2 SAP JOB DEFINITIONS.......................................................................................................................................18
9.3 ISSUES...............................................................................................................................................................18
9.4 CROSS-REFERENCE DOCUMENTS.......................................................................................................................18
APPENDICES..................................................................................................................................................................19
APPENDIX A: EXCEPTION HANDLING..................................................................................................................19
APPENDIX B: TEST PLAN...........................................................................................................................................19
APPENDIX C: EXTRACTION FILE LAYOUT.........................................................................................................20
APPENDIX D: DATA MAPPING AND TRANSLATION RULES.............................................................................21
APPENDIX E: SAP EDI / ALE CONFIGURATION...................................................................................................21
APPENDIX F: SAP IDOC STRUCTURE.....................................................................................................................21
APPENDIX G: DEVELOPMENT DETAILS...............................................................................................................21

Page 3 of 20
1 DOCUMENT SEMANTICS
1.1 Document Properties

Owner and contact information

Document Prepared by:
Process Owner:
Contact Information:
Responsible Team:

1.2 Amendment History

Amendment history for document

Revision Revision Date Author(s) Comments/Major Changes
No

Summary of Changes since last revision

Section / Topic Short Description of the Change

1.3

1.4

Page 4 of 20
1.5 Distribution

List recipients for distribution of document

Group Recipient Role Level of Involvement

1.6 Approval

List of persons required for approval of document

Name Title Date Signature

Page 5 of 20
2 QA’S & SIGNOFFS
Design Tech Program Deploy
Design Unit Test
QA Date: QA Date: QA Date: QA Date:

Author Author Develop Author

er
Business Business Basis/DBA Business
Owner Owner Owner

Analyst Analyst Analyst Analyst

Developer Busines Develope
s Owner r
Security Security Security

Basis/DBA Basis/DBA Basis/DBA

Support Support Support

Page 6 of 20
3 OVERVIEW

Page 8 of 20
4 FUNCTIONAL SPECIFICATION OVERVIEW

Interface Number and Name:

Written By: Date Completed:

Functional Contact : Phone#:

Technical Contact : Phone#:

Third Party Contact : Phone#:

Middleware Contact : Phone#:

4.1 General Information

4.1.1 Business Units Impacted

4.1.3 Reference Document

4.1.4 Model / Process

4.1.5 Scope

4.2 Controls

4.2.1 Interface Description

4.2.2 Interface Controls

4.2.3 Dependencies

Page 9 of 20
4.2.4 Access Restrictions (Security)

Business Role Name:

Transaction:

Transaction Type:

Restrictions / Authorization Checks:

Data Classification (unrestricted/restricted/confidential):

4.3 Processing

4.3.1 Starting Conditions

4.3.2 Frequency

4.3.3 Volume of Data

4.3.4 Archiving

4.3.5 Error Handling and Recovery Start

4.4 Assumptions / Exclusions

5
Page 10 of 20
6 INTERFACE FUNCTIONAL SOLUTION
6.1 Stage 1 – Source System

6.1.1 Program Flow

6.1.2 Extraction Criteria

6.1.3 Calculations, Conversions & Formatting

6.1.4 Mapping

6.1.5 Processing Control

6.1.6 Business Controls and Security

Authorization Checks

System Security Requirements

Page 11 of 20
6.2 Stage 2 Middleware Solution

6.2.1 Program Flow

6.2.2 Extraction Criteria

6.2.3 Calculations, Conversions & Formatting

6.2.4 Mapping

6.2.5 Processing Control

6.2.6 Business Controls and Security

Authorization Checks

System Security Requirements

Page 12 of 20
Page 13 of 20
6.3 Stage 3 Receiving System

6.3.1 Program Flow

6.3.2 Extraction Criteria

6.3.3 Calculations, Conversions & Formatting

6.3.4 Mapping

6.3.5 Processing Control

6.3.6 Business Controls and Security

Authorization Checks

System Security Requirements

Page 14 of 20
7 TESTING REQUIREMENTS

7.1 Interface Trigger

7.2 Interface Content

7.3 Custom Tables

7.4 Configuration

7.5 Authorisations

7.6 Test Data

7.7 Other Test Cycles

Page 15 of 20
9 ISSUES

9.1 Technical Issues and Resolution

Page 16 of 20
10 TECHNICAL SPECIFICATION

10.1 Technical Flow Diagram

10.2 Enterprise Integration Technology Selection

10.3 Integration Flow Logic (Pseudo Code)

10.3.1 Message

10.3.2 Detailed Process Flow

Source

Middleware

Recipient(s)

10.3.3 Interface Complexity

10.4 Technical Workshop Output

Page 17 of 20
11 IMPLEMENTATION & DEPLOY
11.1 User Instructions:

11.1.1 Procedures For Processing

11.1.2 Frequency

11.1.3 Manual Processing

11.1.4 Error Handling

11.1.5 Clearing Out Directories

11.1.6 Problem Reporting

11.1.7 SAP Programs and Related Documents

11.1.8 Security Checks:

11.2 SAP Job Definitions

Job Name:________________________

STEP # PROGRAM VARIANT USED PRINT REQUIREMENTS SUBMITTED JOBS SAP

NAME UPDATED
(YES,NO)

11.3 Issues

11.4 Cross-reference documents

12

Page 18 of 20
 13 APPENDICES
14 APPENDIX A: EXCEPTION HANDLING

No. Potential Errors Resolution Notification Procedures

1
2
3

15 APPENDIX B: TEST PLAN

No. Test Conditions Test Data Expected Actual Results Pass/Fail

and Cases Results

16
17 APPENDIX C: EXTRACTION FILE LAYOUT

18
19 APPENDIX D: DATA MAPPING AND TRANSLATION RULES

20 APPENDIX E: SAP EDI / ALE CONFIGURATION

 DEFINE RFC DESTINATIONS (TRANSACTION SM59) :

RFC DESTINATION CONNECTION TYPE APPLICATION SERVER

Page 19 of 20
  CREATE LOGICAL SYSTEMS (TRANSACTION : SALE):
LOGICAL SYSTEM DESCRIPTION

 CREATE PORTS (TRANSACTION : WE21):

RFC PORT LOGICAL DESTINATION DESCRIPTION

 CREATE PARTNERS (WE20):

PARTNER NUMBER PARTNER TYPE

 INBOUND PARAMETERS (TRANSACTION : OYEL) :

PARTNER NUMBER MESSAGE TYPE PROCESS CODE

 ASSIGN IDOC TO MESSAGE TYPES (TRANSACTION : WE82)

LOGICAL MESSAGE TYPE :
BASIC TYPE :
EXTENDED TYPE

21 APPENDIX F: SAP IDOC STRUCTURE

22 APPENDIX G: DEVELOPMENT DETAILS

Page 20 of 20