You are on page 1of 21

FICO_BANK_ BR0013

FI Receipt
Ver: 1.0 Date:02/03/2021 Page 1 of 21

FUNCTIONAL SPECIFICATION DOCUMENT


____________________________________________________________________________________________________________

NATIONAL UNIVERSITY OF SINGAPORE

FI Receipt
Finance & Controlling
Version 1.0

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 2 of 21

Document Control
Development FICO_BANK_BR0013
ID:
Title: FI Receipt
Description: Customized program to generate the receipt based on FI document generated during bank reconciliation
for collection Giro and TT.
Author Chen Bin
Reference PDD PDD_BNK_BP_Bank Reconciliation
Date 02/03/2021

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 3 of 21

Document Acceptance
Prepared By Reviewed By Approved By
Signature and Signature and Functional Signature and
Consultant Process Owner
Date Date Owner Date

Version Management
The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 4 of 21

Version Date Author Description

1.0 09/02/2021 Chen Bin Initial version

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 5 of 21

Table of Contents

Document Control 2
Document Acceptanced 3
Version Management 4
1 Summary 6
1.1 Requirement Overview 6
1.2 Development Type 6
1.3 Development tool 6
1.4 Impacted Systems 7
1.5 Processing Options 7
2 Enhancement Information/Custom UI 8
2.1 Summary 8
2.2 SAP Object(s) or Process (es) to be enhanced: 8
2.3 Enhancement Description 8
2.4 Selection Screen 9
2.5 Custom table 11
2.6 Data Selection/Validation 11
2.7 Output/Screen Layout 12
2.8 Standard Text 18
2.9 Exception Handling Rules 18
2.10 Security Requirements 18
2.11 Additional Information 19
3 Unit Testing 20
3.1. Test Scenario 20
3.2. Additional Information / Appendix 20

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 6 of 21

1 Summary

1.1 Requirement Overview


Give a brief description of the requested functionality

This functional specification covers enhancement on customized program to generate the receipt based on FI documents, which
generated during bank reconciliation for collection GIRO and TT.

This program provides the following functionality:


1. Allow user to select FI document(s) to print receipt.
2. The form output will be in PDF format, and user can select to display, download, print or send email to customer(s).
3. To email out the receipt, sender email address will be taken from selection screen input.
4. Naming convention for the output PDF is:
If the customer code is found in posting document, the file name is:
Company Code_Document Number_Customer Code _CustomerSearchTerm1_Document Date (DD MMM YYYY)
If Customer Code is not in the document, the file name will be:
Company Code_Document Number_Customer Name (in Header Text)_Document Date (DD MMM YYYY)

1.2 Development Type


Choose the development Type

Development Type: ( ) Report ( ) Interface ( ) Conversion ( ) Enhancement ( X ) Form ( ) Workflow

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 7 of 21

1.3 Development tool


Choose the development Tool

Development Tool: ( X ) ABAP ( ) Report Painter ( ) Smart Forms ( ) User Exit ( ) .Net ( ) Workflow ( ) Eclipse
( ) Fiori RDE ( ) HANA Studio

1.4 Impacted Systems


Place an ‘X’ next to the appropriate software package or business, to indicate all of the software packages or business systems that will be impacted with
this development requirement. For example, an interface between SAP ECC 6 and Source would require an ‘X’ next to both SAP ECC 6 and Source.

Software Package: ( X ) SAP S4 HANA ( ) BW ( ) .Net ( ) Other (List Name)

1.5 Processing Options


Specify general processing options

Processing Mode: ( ) Batch ( X ) Online


Frequency: ( ) Annually ( ) Quarterly ( ) Monthly ( ) Weekly ( ) Daily
( X ) Other ____Ad Hoc_________________________________
Lifetime of ( X ) Permanent ( ) Temporary, e.g. until Go-live, specify details
development _________________________________________

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 8 of 21

2 Enhancement Information/Custom UI
This section provides information relevant to the identified enhancement being requested via this functional specification. (Note: This section will be
deleted if the functional specification is not for an enhancement.)

2.1 Summary
Enhancement Name: FI Receipt

Enhancement Type: ( ) User Exit/Customer Function ( ) BADI ( X ) Custom Transaction/Fiori Application ( ) Custom
Analytics
Attachment: ( ) No ( X ) Yes - Filename: ______Receipt Samples_ ______

2.2 SAP Object(s) or Process(es) to be enhanced:


List the SAP object(s) or transaction(s) to be enhanced. Include the GUI (Web, BSP, Win, etc.) to be used for portal display.

N.A.

2.3 Enhancement Description


Provide a written description of the functionality that needs to be developed. Identify/describe the SAP application transaction that uses or is used to invoke
the enhancement. Describe tables, transactions, reports, forms, screens and other objects that need to be created or modified. Complete the report/form or
interface/conversion sections as appropriate to provide additional details. For portal development, list I-views and pages (new, existing or enhanced) to be
used and include navigation information (e.g. side and top menus, etc.).

Customized program to generate the receipt based on FI document generated during bank reconciliation for collection Giro and TT.

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 9 of 21

2.4 Selection Screen


Describe the selection screen for the report, form or program. Specify fields for selection and describe the validations/checks needed after the user has
entered the selection criteria.

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 10 of 21

No. SAP Field Name Data Length Compulsory? Comments


Field Type
1 BKPF- Company Code C 4 Yes User to specify Company Code(s).
BUKRS Program will default the Company Code that
maintained under User Profile.
2 - Document Number From C 10 Yes User need to enter document number of
- Document Number To C 10 No Reclassification Journal.
3 - Fiscal Year N 4 Yes User to specify Fiscal Year(s).
Program will default current Fiscal Year in this
field.
4 - Email Checkbox Checkbox - No When user tick this option and execute,
program will email the receipt(s) to
customer(s). Customer email address will be
taken from Customer Master (use KNA1-
ADDRNUMBER as key field to get first item in
ADR6- SMTP_ADDR).
This option is unchecked by default.
5 - Sender Email Address C 50 Yes when When user thick the “Email” checkbox, it is
Email compulsory to fill in the sender email address.
Checkbox is Program will use this email to send out the
ticked receipt.
6 - Recipient Email Address C 50 No When user tick the Email checkbox and enter
the email address in this field, system will send
receipt(s) to thisthe following email
address(es): as well.
 Email address(es) entered in this field:
Use “;” to split if multiple email
addresses applied apply here.
 Email address maintained in customer
master: when the customer account is
found in the line item.
The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 11 of 21

 Sender Email address will be taken from user profile (User who execute this program) – Check with Developer

2.5 Custom table


Specify the custom table structure to be created for the report

Constant table TVARVC TVARVC_CONVEXIT (table value is transportable) will be used to store the payment method that printed in FI
receipt. This setting will apply to all company code FI receipt that under bank reconciliation.

The record will be maintained with Variable Name (TVARVC-NAME) “ZFIRECPPMT”, Field Value-Low (TVARVC-LOW) will be used to
store GL Account, and Field Value-High (TVARVC-HIGH) field will be used to indicate the Payment Method text.

Sample records to be created in this table:

Variable Name Field Value-Low Field Value-High


ZFIRECPPMT 2513105 Telegraphic Transfer
ZFIRECPPMT 2513106 GIRO
ZFIRECPPMT 2513107 GIRO

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 12 of 21

Example, when the line with GL clearing account 2513105, program will check in constant table and match the GL account under Variable
Name ZFIRECPPMT, and show “Telegraphic Transfer” in Receipt “Received via:” part. (Refer to Section 2.7 -indicator 14 for details)

2.6 Data Selection/Validation


Specify the data that the report, form or program should select and any filter criteria

Program will extract will line items from ACDOCA based on the following conditions:
1. Input values from selection screen
2. Total amount will be taken from clearing account line item: Use constant table to match the clearing account line ( TVARVC-
LOW=ACDOCA-RACCT) (Refer to Section 2.5 for details)
3. Line item for Customer: Determined by the line which ACDOCA-KUNNR field is not blank.
4. Line item for Tax: Determined by the line which ACDOCA-KTOSL field is not blank.
5. Header Text: Use READ_TEXT function to get the Header Text Description by Text ID (Z0010 – Customer Name, Z0011 – Customer
Address and Z0012 – Item Description)

2.7 Output/Screen Layout


Describe the data that should appear on the report, form or program. Attach a sample layout of the report or form or program.

Format of Receipt Printout:

 Printout for Customer Part:

Loop through ACDOCA line item, if all KUNNR fields (customer account) are blank, customer name, address and line item text will be
taken from Header Text fields:
Customer Name: Use SE75 to find object BELEG and text id. Use function module READ_TEXT with object BELEG ID Z010
Customer Address: Use SE75 to find object BELEG and text id. Use function module READ_TEXT with object BELEG ID Z011

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 13 of 21

Else, customer details will be taken from Header Text section:


Customer Name: KNA1-NAME1 (use KNA1-KUNNR=ACDOCA-KUNNR to get NAME1)
Address line 1: KNA1-STRAS
Address line 2 (suppress if this field is empty): ADDR2_DATA-STR_SUPPL3 (Street 4 in Customer master)
Address line 3 (suppress if this field is empty): ADDR2_DATA-LOCATION (Street 5 in Customer master)
Address line 24: KNA1-LAND1 (Country description) + KNA1-PSTLZ (Postal code)

 Printout for Line Item Description Part:

Item description are taken from Header Text (Use SE75 to find object BELEG and text id. Use function module READ_TEXT with object
BELEG ID Z012)

 User need to update these Header Text fields before generating the receipt.

1. Receipt in local currency (SGD)

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 14 of 21

This section will appear when there is Tax


line or Tax code found in the document.

Currency/Amount that highlighted for


indicator 9 – 14 use transactional
currency/amount in transactional currency
for receipts in either local or foreign
currency.

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 15 of 21

No. SAP Fields Field Name Comments


1 ADRC-NAME1 Company Name Bold can Cap the company Name
Use Company Code in FI document to get Company
Name (ACDOCA-RBUKRS=T001-BUKRS), and use
T001-ADRNR=ADRC-ADDRNUMBER to get
Company Name.
1 ADRC-STREET5 + “, “ + Sales office line 1 Use invoice line item BSEG-ZUONR = TVBUR-VKBUR
ADRC-STREET4 to get TVBUR-ADRNR (Address code).
And use TVBUR-ADRNR = ADRC-ADDRNUMBER to
get the details from ADRC table
1 ADRC-STREET + “, ” + Sales office line 2
COUNTRY + “ “ +
POST_CODE1 + “Tel: “ +
TEL_NUMBER
1 T001-STCEG GST Reg No. Cap the text
VAT Registration No. maintained in Company Code
(use ACDOCA-RBUKRS=T001-BUKRS to get T001-
STCEG)
1 - Logo Logo will take from ECC
2 - Page Show page number
3 ACDOCA-BELNR Document Number Bold the number
4 - Heading of printed receipt - Show “TAX INVOICE/RECEIPT”: If the
document contains GST line item/tax code
found in the document.
- Show “OFFICIAL RECEIPT”: for the rest
scenarios.
5 KNA1-NAME1 Customer Name If customer account is there in the accounting
Or document, take from BP name based on SAP Fields
Header Text ID Z0010 column.
The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 16 of 21

No. SAP Fields Field Name Comments


Else taken from Header Text (Text ID Z0010)

6 Address line 1: KNA1-STRAS Customer Address If customer account is there, retrieve the address
Address line 2 (suppress if information based on SAP field column.
this field is empty): Else taken from Header Text (Text ID Z0011)
ADDR2_DATA-STR_SUPPL3
(Street 4 in Customer
master)
Address line 3 (suppress if
this field is empty):
ADDR2_DATA-LOCATION
(Street 5 in Customer
master)
Address line 4 2: KNA1-
LAND1 (Country
description) + KNA1-PSTLZ
Or
Header Text ID Z0011
7 ACDOCA-BUDAT Posting Date Date format “dd.mm.yyyy”
8 Header Text ID Z0012 Description Taken from Header Text (Text ID Z0012)
(line item description)
9 ACDOCA-RWCUR Currency Code Transaction Currency of the receipt
10 ACDOCA-WSL Customer Payment Amount The Currency is taken from ACDOCA-RHCUR
+ve amount refers to debit entry
-ve amount refers to credit entry
11 - Total Amount Total amount for the line items above
12 KONP-KBETR GST rate ACDOCA-MWSKZ = KONP-MWSK1 to take value from
(KSCHL = MWVZ) field KBETR
Ignore this if there is no Tax Code or Tax line found
in the posting document.
The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 17 of 21

No. SAP Fields Field Name Comments


13 ACDOCA-WSL GST amount in transaction Taken from the line which ACDOCA-AUGBL = input FI
currency document number
14 -ACDOCA-WSL Total amount Total amount in transaction currency.
Taken from the GL clearing account line
15 TVARVC-HIGH Payment method Bold the text
Based on GL account of the line item, retrieve the
payment method from constant table. (Details refer
to Section 2.5)
16 Terminal
17 V_USR_NAME-NAME_TEXT User ID that print this receipt User full name in user profile
18 V_USR_NAME-NAME_TEXT User ID that print this receipt User full name in user profile
19 - Print timing Printed date format: dd.mm.yyyy, hours: hh:mm

2. Receipt in foreign currency (non-SGD)

The following highlighted part will appear if transactional currency of the receipt is not in local currency SGD (The rest will be the
same as above layout).
This section will appear when there is Tax
line or Tax code found in the document.

No. SAP Fields Field Name Comments


1 Currency code: ACDOCA- Customer payment amount in local Appear as: (Amount in <currency code>:

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 18 of 21

No. SAP Fields Field Name Comments


RHCUR currency $<amount>)
Amount: ACDOCA-HSL
2 Currency code: ACDOCA- Tax amount in local currency Appear as: (GST in <currency code>: $<amount>)
RHCUR Taken from the line which ACDOCA-AUGBL = input
Amount: ACDOCA-HSL FI document number
Ignore this if there is no Tax Code or Tax line found
in the posting document.
3 Currency code: ACDOCA- Total amount of the above item Appear as: (Amount Received in <currency code>:
RHCUR $<amount>
Amount: ACDOCA-HSL Taken from the GL clearing account line.
Text will be bold in this part.

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 19 of 21

2.8 Standard Text


Provide the name of the standard text and or use of SAP standard text functionality to be included in the form.

Email Content as below:

Dear Customer,

Please find attached Receipt for your reference.

Please feel free to contact us at <SENDER EMAIL ADDRESS> if you have any queries.

Thank you

(This is a computer-generated email. Please do not reply to this email.)

<SENDER EMAIL ADDRESS>: Taken from email address that maintained in user profile that executed the receipt program.

2.9 Exception Handling Rules


Specify instructions to be followed when errors occur or when any processing occurs outside of the normal process flow.

System will prompt error for the following scenarios:


1. If User doesn’t fill in the compulsory field (Company Code, Document Number, Fiscal Year , and Sender Email Address when email
option is selected), system will prompt error message “Fill out all required entry fields”..
2. If User execute the report for Company Code for which he/she is not authorized, system will prompt error message “You are not
authorized for running report for Company Code XXXX”.
3. If Email Address field is blank in selection screen, and there is no email address found under customer master (if customer
account is found in line item), system will prompt error message: “No email address found.”

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 20 of 21

2.10 Security Requirements


Specify how access to the new development is going to be restricted, what user roles will have access and if authorization checks will be required. Is
encryption required?

Authorization Object: Company Code


Transaction code authorization

2.11 Additional Information


Provide addition information regarding the development item as appropriate.

Sample Receipt:

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.
FICO_BANK_ BR0013
FI Receipt
Ver: 1.0 Date:02/03/2021 Page 21 of 21

3 Unit Testing
This section provides information relevant to test the development.

3.1. Test Scenario


Briefly specify the unit test scenario to test the development and include the master and transaction data required to carry out the testing.

No Test Scenario
1 Execute the report, verify results under different selection criteria.
2 Preview, print, download and email the selected receipt(s).
2 Only authorized user is allowed to access this report, and only can execute for assigned company code(s).

3.2. Additional Information / Appendix


Provide addition information regarding the development item as appropriate.

The information contained in this document is confidential and is privileged information of National University of Singapore. It may not be disclosed outside of National University of Singapore.
and may not be duplicated, used or disclosed to any third party without the expressed consent of National University of Singapore.

You might also like