Escolar Documentos
Profissional Documentos
Cultura Documentos
System (IBS)
GT FI EFNS for
CSV Accounting
Document Upload
KPMG International
November
2010
Author
Date
Revision/CR #
28 Sept 2009
0.2
Neta West
15 Oct 2010
John Hughes
09 Nov 2010
1.0
Sara Neale
Approval
Version
1.0
1.0
1.0
1.0
1.0
1.0
1.0
1.0
Name
John Hughes
Debasish Jana
Bryan Dobes
Neta West
Praveen Kumar Singh
Peter Walker
QCB
Ian Stutt
Date Reviewed
09 Nov 2010
08 Nov 2010
09 Nov 2010
10 Nov 2010
08 Nov 2010
08 Dec 2010
14 Dec 2010
311129709
Page 1
Contents
1
Introduction
1.1
1.2
Request Overview
Overview
2.1
Business Driver
2.2
2.3
Assumptions
2.4
2.4.1
2.5
10
3.1
10
3.1.1
Processing Logic 10
3.1.1.1
Validation
3.1.2
3.2
10
Customized Screens
11
3.2.1
3.2.2
Technical Details 12
3.2.3
3.2.4
Technical Details 13
3.2.5
3.2.6
Technical Details 14
3.3
11
15
3.3.1
Custom Tables
3.3.1.1
3.3.2
Internal Tables
15
3.3.3
Standard Tables
18
3.4
14
15
19
311129709
Page 2
3.5
Special Requirements
20
3.6
Dependencies
21
3.6.1
Data Dependencies
21
3.6.2
System Dependencies 22
3.6.3
Process Dependencies 22
3.7
Constraints
22
3.8
Workflow Requirements
22
3.8.1
Workflow Tasks/Notifications 22
3.8.2
Thresholds 22
Scheduling Requirements
23
Testing Requirements
24
5.1
Test Specification
24
5.2
24
5.3
25
5.4
26
5.4.1
5.4.2
5.4.3
5.4.4
5.4.5
5.4.6
26
27
Globalization
28
6.1
Internationalization
28
6.1.1
Currency Format 28
6.1.2
Date Formats
6.1.3
Language
6.1.3.1
Data
6.1.3.2
Messages
6.1.3.3
User-Determined Text 28
28
28
28
28
311129709
Page 3
6.1.4
Configuration Requirements 28
6.1.5
6.1.5.1
Window Titles
6.1.5.2
Titles
6.1.5.3
Button Texts 29
6.1.5.4
Labels 29
6.1.5.5
Captions (comments/instructions/texts) 29
6.1.5.6
Tool Tips
6.1.5.7
Menus 29
6.1.5.8
Roadmap Steps
6.1.5.9
Links
6.1.5.10
Tab Labels
6.1.5.11
6.1.5.12
28
29
29
29
29
29
29
30
31
7.1
31
7.2
Transaction Codes
31
7.3
Security/Authorization Requirements
32
7.3.1
Authorization Group
7.3.2
7.3.2.1
Requirements
33
33
Appendix
34
311129709
Page 4
1
1.1
Introduction
1.2
Request Overview
Scenario ID
F11
Scenario Title
Financial Accounting
Process ID
F1125
Process Title
Development
Specification ID
RICEFW_FI_0002
Name of
Enhancement
Brief Description:
Requesting Team
Type
Finance
Routines
SAP Code
Modification
Custom Program/Transaction
This is custom program which will have an associated custom
transaction.
Other_________________
Data latency
Real-time
Batch
On-demand
Frequency
Annually
Quarterly
Monthly
Weekly
Daily
Other
R/3
CRM
APO
EBP
BI
SEM
Systems Impacted
Other_________
Modules Impacted
FI
CO
SD
MM
PP
QM
BW
SEM
Other_________
Complexity
High
Medium
Low
Spec Created on
10/15/2010
Date required by
11/15/2010
Created by
Neta West
Phone:
201-505-2681
Functional Analyst
John Hughes
Phone:
201-505-2262
Technical Analyst
To be defined
Phone:
Business Owner
Peter Walker
Phone:
2
2.1
Overview
Business Driver
To enable the business to:
2.2
Post the large number of accounting journals within the system by the business as part of the
period end activities
Create large journals and then efficiently process and post them
All other validations and substitutions will be invoked for the Company Code at the header or FI
line item.
Only predefined document types can be used to post via CSV. These document types will be
custom.
The business is responsible for the data on each posting. If an error occurs at the time of
processing and this processing is carried out by a user other than the business then the
correction is required by business.
The postings of the journals will be able to be parked and or parked and then posted. Radio
buttons will exist on the selection screen to enable this. Where the parked button is selected
the journal postings will be parked only. This will require the relevant authorized user to log onto
the system and then review and post the parked entries.
Where the Post button is selected the program will post the journals. No subsequent action will
be required from users in the system.
The following business rules have been identified for this enhancement:
This upload process will support standard SAP processing of multiple currency transactions.
Accounting documents must not exceed 999 lines as this is the limitation on BSEG accounting
document line items.
The execution of the transaction will post as many journals as specified on the CSV spreadsheet.
The CSV upload program must comply with the standard SAP delivered and configured
validations. E.g. Company Code settings master data settings and document posting rules.
2.3
The CSV upload program must comply with the custom validations developed for the Member
Firm.
The CSV upload program will process the journals via batch processing (Transaction SM35).
The CSV template upload functionality is designed to be used for the following kinds of financial
journal postings:
o
Accrual journals
Where expenses are posted to engagements, and no Engagement Phase is added, the program
will default Phase 1 on the engagement as the phase. Note: Phases are required to be entered
when posting financial entries to the Engagement.
The program will check to ensure that postings are made only to valid Company Codes
consistent with the users authorizations.
The program will only process a CSV file if the user has authorizations for all the Company
Codes and document types specified on the spreadsheet.
Assumptions
The following assumptions have been identified for this enhancement:
No Postings to CO-PA will be made using the CSV journal upload functionality. The reason is that
all CO-PA relevant postings are carried out with an associated workflow for approval and are not
carried out by finance support department.
Vendor invoices processed by the business and forwarded/received by the Finance department
are deemed pre-approved by the business.
Pre and post audit and internal control processes will be manual and are not required to be built
into the CSV upload.
Users who have access to the CSV upload will require access to FB01 in order to process the
batch job.
Relevant controls for SOX and audit compliance will be considered within the design for the AR
and AP processors.
The program will handle the users logon language and display all screens in the appropriate
language.
Users date (DD/MM/YYYY or MM/DD/YYYY) and number settings (how the units are separated)
will be used by the program. The user should maintain the spreadsheet consistent with their own
user settings for the date. (See user settings SU01)
This CSV journal upload allow to enter user defined exchange rate which different the default
exchange rate maintained in the system.
The CSV template will be consistent with the internal table structure and the structure of the file
when it is uploaded to the upload screen.
The program will be design in line with the internationalization requirements for the Global
Template. A separate document will contain the internationalization requirements for language,
currencies and date formats.
The program will be designed in line with the error handling requirements for the Global
Template. A separate document will contain the error handling requirements for the Global
Template.
The user who processes the batch job will be stamped as the user on the financial document
posting.
The transaction code is stamped in the header of the financial document posting in the field
TCODE. This will enable the user to understand what process created the financial posting.
2.4
2.5
Alternatives
Evaluation
Pros
Cons
Pros
Cons
Pros
Cons
3
3.1
Processing Logic
Defined below is the program logic for the CSV journal upload program.
This logic will form the basis for the program code, which will be defined as part of the technical
specification.
1. A custom program will upload the input CSV file into an internal table. The input file available
would be an MS CSV spreadsheet. The records from the uploaded file will be then split as per
the fields given in the custom document type table and will be appended into the internal tab.
2. The data in the internal table is checked with validation rules and displayed as an ALV grid.
3. The user then checks if the contents of file uploaded is correct or not. As part of this check
mandatory fields are evaluated and an information message is displayed of the fields that have
not been populated on the spreadsheet.
4. The standard function program will use this file and will generate the BDC session. After
populating this information will be transferred to the output file.
5. If the Park button is selected on the selection screen then the accounting journals that are
passed to the standard function program and will be parked only.
6. Else if the Post button is selected on the selection screen then the accounting journals that
are passed to the standard function program and will be posted.
3.1.1.1
Validation
Upon initialization of the program, the processing type (G/L, A/P or A/R) is determined based on the
calling transaction code.
This will be used later to determine that the document type(s) used is (are) legitimate and appropriate
use of the custom document check table.
3.1.2
All other validations and substitutions will be invoked for the Company Code at the header or FI
line item.
Amounts can be entered in the template using the period (.) as the decimal separator only in the
CSV format. The users number notation will be applied when the values are read from the CSV
file to the internal table.
Dates can be entered in the template using either . or /. The date must be entered on the
template in the format MM DD YYYY.
Access to SM35 must be controlled so that the user only views their batch jobs.
The AP users will access the CSV (.CSV) upload via a different transaction.
assigned to the relevant AP roles only.
A check in the program will be included to ensure that the AP users can only create invoices with
the relevant AP document types.
For AP the CSV spreadsheet should be returned to the responsible area for correction as the
sending party is the one who has responsibility to ensure the data is correct. This is a manual
(offline) step required in the process.
Sundry cost recovery AR invoices will be deemed approved by the business for entry into SAP.
Financial Accounting group users will access the CSV upload via transaction GL = ZFI_GL_UPL.
They will have access to the documents types for GL only. I.e. those document types specified
in the custom Z table grouped by processing type S.
AR users will access the CSV upload via transaction, AR = ZFI_AR_UPL. They will have access
to the documents types for AR only. I.e. those document types specified in the custom Z table
grouped by processing type D.
AP users will access the CSV upload via transaction AP = ZFI_AP_UPL. They will have access
to the documents types for AP only. I.e. those document types specified in grouped by
processing type K.
The ALV display has been updated such that when the user uploads the CSV spreadsheet to the
screen, the accounting header and line item are highlighted in different values to distinguish the
difference.
This will be
Excel Accounting
Document Upload.xls
3.2
Customized Screens
A selection screen is required for this enhancement in order to execute the program.
3.2.1
This screen is used to enter the name of the spreadsheet to upload and the name of the batch input
session to create.
3.2.2
Technical Details
Seq.
No.
Parameter
Name
Parameter
Description
Parameter
Data Type
Default
S_BURKS
Company
Code
Select
Option
BBSEGBURKS
N/A
4 Char
Mandatory
P_IFILE
Parameter
RLGRAPFILENAME
N/A
XX Char
Mandatory
P_BNAME
Batch input
session name
Parameter
BGR00GROUP
CSV_
12 Char
Mandatory
P_PARK
Park
Document
Radio Button
Char
Yes
1 Char
N/A
P_POST
Post
Document
Radio Button
Char
N/A
1 Char
N/A
Type
Data
Length
UPLOAD
Status
3.2.3
The following screen is then displayed after the execution of the spreadsheet upload. Here the data is
able to be reviewed.
3.2.4
Technical Details
The layout of this table is based on the custom table structure of table for the CSV upload structure. The
table name will be defined in the technical specification document.
3.2.5
One custom table will be developed which will contain the document types defined by function that are
able to be used within the program for CSV upload of accounting documents. In order to use a
document type for a function it must exist in this table first along with the function for which the document
should be used. E.g. AR = Processing type (D) and document type (DA).
It is expected that the custom table will need to be maintained over time as the document types for GL,
AR and AP expand for usage with the CSV upload.
The table is able to be maintained via a customized transaction. The table name will be defined in the
technical specification document.
Data Element
Data Type
Data
Length
Status
Processing Type
Char
Mandatory
Document Type
Char
Mandatory
3.2.6
Technical Details
The layout of this table is based on the custom table structure of table for Permissible Document Types
Maintenance screen.
3.3
3.3.1
Custom Tables
3.3.1.1
The table will be treated as master data table will be maintainable via a custom transaction code.
The structure of table for holding document types:
Data
Data Element
Data Type
MANDT
Char
Mandatory
ZPROCTYPE
(Processing
Type)
Char
Mandatory
BLART
(Document Type)
Char
Mandatory
Length
Status
(Client)
3.3.2
Key/Non Key
Field
Key
Key
Key
Internal Tables
The user will populate a template spreadsheet which will be used to create the journal in SAP. The
template will need to be taken into an internal table in order to be validated and processed.
The user will create the header and appropriate line items for the journal, AR or AP invoice within the
CSV spreadsheet. Only one header will be required per accounting document (GL, AP or AR Invoice).
The user can create more than one accounting document on the CSV spreadsheet in order to post into
SAP. The header record distinguishes the next document within the CSV structure.
The user will have the ability to download the template upload structure from the ALV screen. This will
ensure that any changes made to the structure are made available to the user so that the templates are
consistent with the program and errors in upload are reduced.
Technical
Name
Length
Data type
Status
Identification
Character
BLDAT
DATS
Mandatory
Document type
BLART
CHAR
Mandatory
Company Code
BUKRS
CHAR
Mandatory
BUDAT
DATS
Mandatory
Exchange Rate
KURSF
DEC
Optional
Translation Date
WWERT
DATS
Optional
Currency Key
WAERS
CUKY
Optional
Calculate tax
XMWST
CHAR
Optional
STGRD
CHAR
Optional
STODT
DATS
Optional
XBLNR
16
CHAR
Optional
BKTXT
25
CHAR
Optional
Ledger Group
LDGRP
CHAR
Optional
Data type
Status
Line Item
Field Name
Technical
Name
Length
NEWBS
CHAR
Mandatory
NEWBK
CHAR
Optional
NEWKO
17
CHAR
Optional
Field Name
Technical
Name
NEWUM
Length
Data type
Status
Optional
CHAR
ANLN1
12
CHAR
Optional
BEWAR
CHAR
Optional
SDATE
DATS
Optional
ANLN2
CHAR
Optional
WRBTR
16
CHAR
MWSKZ
CHAR
Optional
TXJCD
CHAR
Optional
Cost Center
KOSTL
10
CHAR
Optional
Profit Center
PRCTR
10
CHAR
Optional
Order Number
AUFNR
12
CHAR
Optional
Sales Document
VBEL2
10
CHAR
Optional
POSN2
CHAR
Optional
Personnel Number
PERNR
NUMC
Optional
Mandatory
Personnel Number
Optional
(*Engagement Partner)
ZZPERNR
NUMC
Value Date
VALUT
DATS
Optional
Payment Terms
ZTERM
CHAR
Optional
Payment Methods
ZLSCH
CHAR
Optional
Baseline Date
ZFBDT
CHAR
Optional
Discount Base
SKFBT
16
CHAR
Optional
Payment Block
ZLSPR
CHAR
Optional
Assignment
ZUONR
18
CHAR
Optional
Field Name
Technical
Name
Item Text
SGTXT
Length
50
Data type
Status
CHAR
Optional
3.3.3
Standard Tables
Data Field
BBKPF
BBSEG
FAGLFLEXA
COEP
3.4
Common include function module will be defined for all exception messages within Finance. The
program will call the function modules to get the correct exception messages.
Upload
Error checks are upon the upload of the CSV file to the ALV display for expense accounts. These are
warnings only and should be correct in the source file OR within the screen.
Creation of the Batch Job
If mandatory fields have not been populated, header or line item data is not correct, or data values are
not correct errors will be identified upon creation of the batch job.
Processing of the Batch Job
Data errors will be identified via standard SAP error handling in transaction SM35 The user will be able
to view the error and attempted screen entries. These can then be corrected in the source file before
uploading again.
Message:
The following error handling messages will be invoked during the processing of the batch.
These are handled by standard SAP program (RFBIBL00) and will not be defined by the custom
program.
Message Type
Error
Error
Error
Error
Message Type
Indicator is incorrect.
3.5
Error
Error
Error
Error
Special Requirements
User must complete the CSV sheet as per template completion guidelines. This will be defined in
appropriate user guide.
The following help information will be provided on the initial selection screen for the CSV Accounting
Document Upload, so that users will have custom help notes available. This will provide guidance and
an overview of the program for users.
Purpose
The purpose of this program is to upload and post accounting journals into SAP via a CSV spreadsheet.
The trigger for this program is the need to book accounting journals for the accounting period. This is
able to be used throughout the month and as part of the month end process.
Integration
N/A
Prerequisites
N/A
Features
Selection
The user is able to select the following details:
File Name The user selects where the CSV file is saved to upload into the program.
Parking Document The user selects this radio button if they want to park the accounting
documents in the system. A parked document is not updated to the general ledger.
Posting Document The user selects this radio button if they want to post the accounting
documents in the system. A posted document is updated in the general ledger.
Standard Variants
N/A
Output
As a result of successfully processing this program accounting journals will be posted into the
system. These could be in the format of GL journals, AP invoices, General AR invoices or
accounting migration postings.
Activities
This program will create accounting documents based on the data uploaded from the CSV file. This
CSV upload program is intended to be used for accounting journals only. The input CSV file will contain
data for accounting journals only.
The CSV upload program will post accounting journals through a Batch Data Communication (BDC)
session method. This program will create a BDC session which can be processed manually by the user
by executing transaction 'SM35'.
The BDC session will be created by calling standard program
RFBIBL00.
This upload program will first upload the CSV file and will display the data in an Advanced List Viewer
(ALV) display. The user can then review the data of the CSV file. If the user finds everything fine then
he/she can click the process button to create a BDC session for the given data.
Once the BDC session is created the program will display the session name which is created. The user
can click on process session to go to view the batch session directly and there he can select his BDC
session which is unprocessed and then click on process button to process the session.
This program will leverage a custom table which will be used to control which document types will post as
a result of this enhancement. Member Firms will be able to create custom document types to post with
this enhancement.
Example
N/A
3.6
Dependencies
The following dependencies have been identified for this enhancement:
3.6.1
Data Dependencies
There is a data dependency on the custom table with the document types. This CSV upload program
with this custom enhancement will only allow user to upload and post journals on pre-defined document
types as defined in the custom table.
3.6.2
System Dependencies
3.6.3
Process Dependencies
3.7
Constraints
No limitations or constrains have been identified.
3.8
Workflow Requirements
No workflow requirements have been identified.
Proces
s
Work
List Type
Action
Reqd.
Summarize
d text
required
Detailed
text
required
Triggered
from
3.8.2 Thresholds
Thresholds are not relevant for this enhancement.
Scenario
Function
Threshold Requirements:
Engagement code
realization rate & function
Task Recipient
Who
receive
s it
Who
else
can see
it
Scheduling Requirements
The following scheduling requirements have been identified for this enhancement:
NOTE: There will also be a manual transaction available to run the CSV journal upload process
on an as required basis.
Dependencies
No process dependencies have been identified.
Frequency
If scheduled, this process to be executed in line with the requirements of the individual Member Firm.
5
5.1
Testing Requirements
Test Specification
Refer to the attached test specification for unit tests for this enhancement:
Test Spec
5.2
Test Scenario
Using TCode ZFI_GL_UPL post
a general ledger accounting
entry with the following
scenarios:
Expected Results
An accounting journal is
created with adherence to the
standard and custom
validations.
Comments
ID
GL journal
AP journal
AR journal
GL journal
AP journal
AR journal
5.3
GL journal
AP journal
AR journal
Expected Results
The ALV screen displays
upload errors prevent batch
creation(i.e. total dr/cr do not
agree, column missing, etc.)
Comments
Company Code
Client/Customer
GL Accounts
Transactional Data
5.4
System
Client
TBD
Test User/s
Portal
5.4.2
System
Client
Test User/s
Portal
5.4.3
System
Client
TBD
Test User/s
Portal
5.4.4
5.4.5
5.4.6
6
6.1
Globalization
Internationalization
6.1.1
Currency Format
Currency formats will be read from the users settings. There will be a subroutine in the program that will
read the settings and ensure that the currency format settings are presented to the user based on their
format.
6.1.2
Date Formats
Date formats will be read from the users settings. There will be a subroutine in the program that will read
the settings and ensure that the date settings are applied to the dates entered by the users on the CSV
spreadsheet.
6.1.3
Language
6.1.3.1
Data
The data elements contained in this custom table are referencing some standard data elements which
will be translated where required automatically.
There is one field which is referencing a custom data type. This will need to be translated.
6.1.3.2
Messages
Messages used within this enhancement are contained in the message class /KGO/FI_MSG_CLASS.
These messages will need to be translated.
6.1.3.3
User-Determined Text
6.1.4
Configuration Requirements
6.1.5
6.1.5.1
Window Titles
6.1.5.2
Titles
Custom text elements created for the screens associated with this enhancement are required to be
translated.
6.1.5.3
Button Texts
This is not relevant for this enhancement, as all buttons (Execute, Create Session and Process Session)
are standard and will be automatically translated.
6.1.5.4
Labels
6.1.5.5
Captions (comments/instructions/texts)
6.1.5.6
Tool Tips
6.1.5.7
Menus
6.1.5.8
Roadmap Steps
6.1.5.9
Links
7
7.1
7.2
The file was approved by an employee that is included on an authorized master approver list.
If the total amount in the CSV file does not agree, then audit should follow through to ensure that
all rejects are handled and posted manually in the current accounting period. Hash totals must
agree within the accounting period.
Transaction Codes
The following transaction codes have been identified for this enhancement:
Transaction Code
Description
Purpose
ZFI_GL_UPL
ZFI_AR_UPL
ZFI_AP_UPL
ZFI_DOCTYPE_MNT
Maintain permissible
document types table
7.3
Security/Authorization Requirements
The following security requirements have been identified for this enhancement:
Role
Transaction
Authorization Considerations
General Ledger
Manager
ZFI_GL_UPL
ZFI_DOCTYPE_MNT
ZFI_GL_UPL
Accounts
Receivable
Manager
ZFI_AR_UPL
ZFI_DOCTYPE_MNT
ZFI_AR_UPL
Accounts Payable
Manager
ZFI_AP_UPL
ZFI_DOCTYPE_MNT
ZFI_AP_UPL
7.3.1
Authorization Group
The transaction code to maintain the custom table will be associated with the authorization group ZFIN.
7.3.2
The program must ensure that users are able to process the accounting journals based on the following:
1) For authorized Company Codes only
2) For authorized document types from the custom table only
This will be achieved through program logic that will be called upon processing of the program.
7.3.2.1
Requirements
Values for the Company Code should be defined as a field on the selection screen
Values of document type and Company Code should be checked on the spreadsheet that is
being uploaded
Appendix
Related/Referenced Documents
Document Name
Version
Brief Description
KPMG
General Release
GT FI Blueprint F1121
IBS_BP_F1121_AccountsPayable
Accounts Payable
General Release
KPMG
IBS_BP_F1122_AccountsReceivable
KPMG IBS_BP_F1125_GeneralLedger
GT FI Blueprint F1122
Accounts Receivable
General Release
GT FI Blueprint F1125
General Ledger
General Release
KPMG
IBS_BP_F1126_FixedassetAccounting
Attachments
Document Name
CVS Accounting Document
Version
Brief Description
CVS Accounting Document
Upload Template
Excel Accounting
Document Upload.xls
Upload
2010 KPMG International Cooperative (KPMG International), a Swiss entity. Member firms of the
KPMG network of independent firms are affiliated with KPMG International. KPMG International provides
no client services. No member firm has any authority to obligate or bind KPMG International or any other
member firm vis--vis third parties, nor does KPMG International have any such authority to obligate or
bind any member firm. All rights reserved.
The information contained herein is of a general nature and is not intended to address the circumstances
of any particular individual or entity. Although we endeavour to provide accurate and timely information,
there can be no guarantee that such information is accurate as of the date it is received or that it will
continue to be accurate in the future No one should act on such information without appropriate
professional advice after a thorough examination of the particular situation.