Project: Masar

Functional Specification Design (FSD)

Stream ONGP
RICEFW Number ENH000041
BBP Reference
PD.01 - PD.06
Number
Add fields in the nomination
FSD Description
subitem
Version V1.10

Classif
ication
: ENOC
Confid
Functional Specification Document

Document Control
Change History
Vers Date Author Description of Change
ion
0.1 10/02/2 Bill Initial version of Functional Specification
020 Schweitzer
0.9 12/02/2 Bill Version for business review
020 Schweitzer
1.0 23/02/2 Gopal Version for business approval
020 Sharma
1.1 11/05/2 Gopal Added logic to populate parallel operation quantity automatically (Start
023 Sharma of WO0000000028402)

Contact Parties:
Role / Organization Unit Name Description
Functional Consultant Bill Schweitzer
Developer TBD
Development Lead Shashank Subhash

ENOC Reviewed
Name Designation Sign-off date Signature

ENOC Endorsed
Name Designation Sign-off date Signature

ENOC Signed Off

Name Designation Sign-off date Signature

Classif 1
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
Functional Specification Document

Table of contents
1. Functional Description.................................................................................................................................3
1.1 Business Requirement..........................................................................................................................3
2. System Scope...............................................................................................................................................4
3. Constraints, Dependencies, Prerequisites & Assumptions..........................................................................5
3.1 Constraints and Dependencies..............................................................................................................5
3.2 Pre-requisites........................................................................................................................................5
3.3 Assumptions.........................................................................................................................................5
4. Development Type (s)..................................................................................................................................6
4.1 Report...................................................................................................................................................6
4.2 Interface................................................................................................................................................7
4.3 Form......................................................................................................................................................8
4.4 Application (Enhancement / Workflow / Conversion).........................................................................9
5. Input / Import Requirements......................................................................................................................10
5.1 Input / Import Variables / Parameters.................................................................................................10
6. Processing Logic........................................................................................................................................11
6.1 Functional Process Logic....................................................................................................................11
6.2 Technical Process Logic.....................................................................................................................12
6.3 Functional Process Flow.....................................................................................................................13
6.4 Data Requirements..............................................................................................................................13
6.5 Authorization Requirements...............................................................................................................13
6.5.1 Authorization Objects for Programs..............................................................................................13
6.5.2 Authorization Groups for Tables....................................................................................................14
6.6 Language Dependencies.....................................................................................................................14
6.7 Error Management..............................................................................................................................14
6.8 Additional Functions..........................................................................................................................14
7. Output Requirements.................................................................................................................................15
7.1 Output Variables / Parameters.............................................................................................................15
7.2 Special Printing Options.....................................................................................................................15
7.3 Example Outputs / Forms...................................................................................................................15
8. IMG Structure for Custom Developments.................................................................................................16
9. Custom Transaction Details.......................................................................................................................17
10. Testing........................................................................................................................................................18
10.1 Input Data...........................................................................................................................................18
10.2 Test Scenario.......................................................................................................................................18
10.3 Positive Unit Test................................................................................................................................18
10.4 Negative Unit Test..............................................................................................................................18
1. Functional Description.................................................................................................................................3
1.1 Business Requirement..........................................................................................................................3
2. System Scope...............................................................................................................................................4
3. Constraints, Dependencies, Prerequisites & Assumptions..........................................................................5
3.1 Constraints and Dependencies..............................................................................................................5
3.2 Pre-requisites........................................................................................................................................5
3.3 Assumptions.........................................................................................................................................5
4. Development Type (s)..................................................................................................................................6
4.1 Report...................................................................................................................................................6
4.2 Interface................................................................................................................................................7
4.3 Form......................................................................................................................................................8
4.4 Application (Enhancement / Workflow / Conversion).........................................................................9
5. Input / Import Requirements......................................................................................................................10
5.1 Input / Import Variables / Parameters.................................................................................................10
6. Processing Logic........................................................................................................................................11
6.1 Functional Process Logic....................................................................................................................11
6.2 Technical Process Logic.....................................................................................................................12
6.3 Functional Process Flow.....................................................................................................................12
6.4 Data Requirements..............................................................................................................................12
6.5 Authorization Requirements...............................................................................................................12
6.5.1 Authorization Objects for Programs..............................................................................................12
6.5.2 Authorization Groups for Tables....................................................................................................13

Classif 2
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
Functional Specification Document

6.6 Language Dependencies.....................................................................................................................13

6.7 Error Management..............................................................................................................................13
6.8 Additional Functions..........................................................................................................................13
7. Output Requirements.................................................................................................................................14
7.1 Output Variables / Parameters.............................................................................................................14
7.2 Special Printing Options.....................................................................................................................14
7.3 Example Outputs / Forms...................................................................................................................14
8. IMG Structure for Custom Developments.................................................................................................15
9. Custom Transaction Details.......................................................................................................................16
10. Testing........................................................................................................................................................17
10.1 Input Data...........................................................................................................................................17
10.2 Test Scenario.......................................................................................................................................17
10.3 Positive Unit Test................................................................................................................................17
10.4 Negative Unit Test..............................................................................................................................17

Classif 3
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

1. Functional Description

1.1 Business Requirement

Product movements/outturn dip levels will be captured tank wise at a sub-item level to eliminate manual entry
of inventory values. The difference between dips will be updated automatically as a ticket sub item actual posted
quantity. Addition of all actual posted quantity should be calculated as a total volume.
It may possible simultaneous load or discharge happens for other operation e.g. truck loading from the same
tank. Therefore, system should have provision to add or subtract parallel operation quantity from the actual
posted quantity and add comments for this adjustment.

Below fields will be added in the ticket sub item level:

1) Opening dip date

2) Opening dip time
3) Corrected opening dip
4) Closing dip date
5) Closing dip time
6) Corrected closing dip
7) Parallel operation quantity (+/-)
8) Reason (comments for adjustment)

Start of WO0000000028402
When executing import/export/Pipeline transfer for tank using tank dips, SAP must account for any other
transaction that has happened between opening and closing dips automatically (parallel operation quantity) and
show the actual ticketed value.
End of WO0000000028402

Classif 4
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

2. System Scope

S/4 HANA
ARIBA
IBP
BI
BPC
RETAIL
CPI
PI/PO
FIORI
BO/Lumira
HYBRIS – C4C
HYBRIS – MKT. CLOUD
HYBRIS - COMMERCE
SUCESSFACTORS
MII
LUMIRA
QCI
GRC
Others

Classif 5
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

3. Constraints, Dependencies, Prerequisites & Assumptions

3.1 Constraints and Dependencies

Nomination should be created/exist.
Tank should be created in the system.
Tank dip should be taken and recorded in the system.

3.2 Pre-requisites
As above.

3.3 Assumptions
Business will use nomination item level details ‘Load/Discharge’ to update berth, loading system, and
lightering nomination details.
Adjustment quantity will be added by business with correct sign ‘+’ or ‘-‘.

Classif 6
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

4. Development Type (s)

REPORT
INTERFACE
CONVERSION
ENHANCEMENT
FORMS
WORKFLOW
FIORI

4.1 Report
NA
Execution Mode Batch Online

Report Painter Report Writer BW/BI

Report Creation
with
ABAP Program Fiori Other:

Drill Down Print Sort

Needed
Characteristics
Slice & Dice Other:

Data Volume

Daily Weekly Bi-Weekly

Frequency of
Use
Monthly Other:

Classif 7
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

4.2 Interface
NA
IDoc RFC

ABAP/Batch ABAP/Proxy

Interface Type File MII

Web Service PI/PO

CPI Other:

EDI/ALE
Configuration Yes No
Required

Direction (With Others (Please

Inbound Outbound
Respect to SAP) Specify)

Connected
Systems/Partner
System

Sender System

Receiver System

Interface Format <<<e.g. .txt, .xml>>><Attach Sample file>

Primary Protocol
<<<e.g.…SOAP/REST/JDBC/MAIL/ODATA etc.…>>><
Used

Data Volume

Authentication
Basic Certificates Others
Mechanism

Daily Weekly Bi-Weekly

Frequency of
Use
Monthly Other:

Classif 8
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

4.3 Form
NA
Output Receiver:
In-House/Third In-House Only Third Party
Party
Special Printing
Form selection based on the surveyor company
Options
Adobe Form Smart Forms
Type
SAP Script Third Party Service

Output Volume

Daily Weekly Bi-Weekly

Frequency of
Use
Monthly Other:

Multilingual Yes No

Optical Archiving
Required Yes No

Classif 9
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

4.4 Application (Enhancement / Workflow / Conversion)

Execution Mode Batch Online

Modification User Exit BAPI

BADI Module pool Fiori

Application Type Transaction Enh. Spot Workflow

WebDynpro ABAP

Other: Function modules mentioned in section 6.2 will be modified.

Data Volume

Daily Weekly Bi-Weekly

Frequency of
Use
Monthly Other:

Classif 10
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

5. Input / Import Requirements

5.1 Input / Import Variables / Parameters

NA

Classif 11
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

6. Processing Logic

6.1 Functional Process Logic

Below fields can be updated in the ‘PM3 – Physical Measurement – Gauge reading’ ticket in ‘gauge reading tab.

1) Opening dip date

2) Opening dip time
3) Opening dip
4) Closing dip date
5) Closing dip time
6) Closing dip

But these fields are not editable in the final (C – Carrier) ticket. Therefore, these fields will be added in the sub
item screen. This will help to calculate actual posted quantity automatically based on the opening and closing
(final) dip details. If required, this quantity can be modified manually. Also, this will keep summary of the
opening and closing (final) dip details for future reference.
Note: Additional of all actual posted quantity to be calculated as a total volume is a standard SAP functionality.

Parallel operation quantity can be added with correct sign ‘+’ or ‘-‘to post the correct quantity in the inventory
for the recorded operation. The reason for adjustment can be added in ‘Parallel operation reason’ field for
future reference.

Start of Start of WO0000000028402

During vessel loading or discharge or pipeline transfer (e.g. JIFF transfer), if there is parallel processing or truck
loading/discharge is happening then system should identify all those transactions. System should calculate the
quantities for those transactions and populate the field 'Parallel Operation Quantity' in ticketing unit. This
quantity is used to calculate the 'Actual Quantity' in the nomination sub item. The ticket should be posted for
Ticketing Quantity (all units) = Dip difference quantity (all units) +/- Parallel operation quantity (all units).

End of Start of WO0000000028402

Classif 12
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

6.2 Technical Process Logic

Create a Structure ZONG_GUAGE_READ and add in the table OIJNOMSUBITEMS.

Data
Field Data Element Length Dec Short Description
Type
O_GAUGE_DATE OIJ_DATE DATS 8 0 Opening dip date
O_GAUGE_TIME OIJ_TIME TIMS 6 0 Opening dip time
O_DIP_READ OIJ_O_DIP_READ QUAN 13 3 Opening dip
C_GAUGE_DATE OIJ_DATE NUMC 10 0 Closing dip date
C_GAUGE_TIME OIJ_TIME CHAR 10 0 Closing dip time
C_DIP_READ OIJ_C_DIP_READ QUAN 13 3 Closing dip
ZPMENGE ZPMENGE QUAN 13 3 Parallel Operation Quantity
ZPREASON ZPREASON CHAR 70 Parallel Operation Reason

Opening dip and closing dip details will be used to get the receipt or loaded quantity in the tank and update as
actual posted quantity.

If OIJ_EL_TICKET_I – SITYP = ‘O’

Read the table ZTPMAP with WERKS_P = OIJ_EL_TICKET_I - WERKS_O and LGORT_P = OIJNOMSUBITEMS-
TANK_NR to get corresponding WERKS_T and LGORT_T.

If OIJ_EL_TICKET_I – SITYP = ‘D’

Read the table ZTPMAP with WERKS_P = OIJ_EL_TICKET_I - WERKS_D and LGORT_P = OIJNOMSUBITEMS-
TANK_NR to get corresponding WERKS_T and LGORT_T.

Use terminal plant and storage location details to get the SOC: Storage object characteristic segment number.
Read table OIISOCISL with WERKS = ZTPMAP-WERKS_T, LGORT = ZTPMAP-LGORT_T and get SOCNR.

Pass OIJ_EL_TICKET_I-LOCID, SOCNR, OIJNOMSUBITEM-O_DIP_READ and OIJNOMSUBITEM-C_DIP_READ in

function module OIJ_GAUGE_CALC to get OIJ_MENGE and update in the field OIJNOMSUBITEMS- OIJ_ACTQTY.
If require OIJ_ACTQTY can be modified manually.

Process for parallel operation quantity

Add or subtract the parallel operation quantity ZPMENGE from actual posted quantity OIJ_ACTQTY based on
the sign ‘+’ or ‘-‘.

Start of Start of WO0000000028402

Add new field on the nomination subitem screen 'Calculate Parallel Quantity' as a checkbox. If this field is set,
then only calculate the quantity.

Read the table OIJNOMSUBITEMS with NOMTK, NOMIT and SUBITEM to get ZZO_GAUGE_DATE,
ZZO_GAUGE_TIME, ZZC_GAUGE_DATE and ZZC_GAUGE_TIME.
Then read the table MATDOC with WERKS = OIJNOMI-LOCPT, LGORT = OIJNOMSUBITEMS-TANK_NR, BUDAT =
ZZO_GAUGE_DATE to ZZC_GAUGE_DATE and OIB_BLTIME = ZZO_GAUGE_TIME to ZZC_GAUGE_TIME where
OIC_PBATCH = ' ' to get MBLNR.
Sort these MBLNR using SHKZG (make a group of H and S).
Read the table MATDOCOIL with MBLNR for each set (H and S).

Parallel Operation Quantity = 'MATDOC-SHKZG=H' Quantity - ' MATDOC-SHKZG=S' Quantity (for all UoMs).
Note: Manual update to this quantity will have precedence. If parallel operation quantity is updated manually
then system should work as existing developed process.

Classif 13
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
Functional Specification Document

Update the ticket UoM quantity with correct sign. Actual quantity update logic is already available
The ticket is posted with = Dip difference + ('H' Quantity - 'S' Quantity (for all UoMs) for the sub-item/s.
Add this logic in below FMs.

OIJ_EL_DOCG_CREATE_SHIP_NOTIF
ZOGPFM_LOAD_CONFIRM_N
ZOGPFM_CREAT_GOODS_MVMT_N
ZOGPFM_CREATE_DELIVERY_N
ZOGPFM_CREATE_STO_DELIV
ZOGP_EL_DOCG_MAT_TANK2INTR
ZOGPFM_EL_DOCG_CREATE_DELIVERY

End of Start of WO0000000028402

Classif 14
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

6.3 Functional Process Flow

NA

6.4 Data Requirements

NA

6.5 Authorization Requirements

NA
6.5.1 Authorization Objects for Programs
NA

Authorization for Organization Unit(s)

Activity
All / Create / Change / Display / Delete
Program Organization Unit (List of activities in the table TACT)
Please specify all single activities (i.e. 01,02,03,
etc.)
<PROGRAM Operating Concern
NAME>
Controlling Area

Company Code

Functional Area

Credit Control

Plant

Purchasing Organization

Warehouse

Storage Location

Shipping Point

Transportation Planning
Point

Sales Organization

Distribution Channel

Division

Sales Office

Others Nomination Type

Classif 15
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

6.5.2 Authorization Groups for Tables

NA

6.6 Language Dependencies

NA

6.7 Error Management

NA

6.8 Additional Functions

NA

Classif 16
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

7. Output Requirements

7.1 Output Variables / Parameters

NA

7.2 Special Printing Options

NA

7.3 Example Outputs / Forms

NA

Classif 17
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

8. IMG Structure for Custom Developments

NA

Classif 18
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

9. Custom Transaction Details

NA

Classif 19
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid
 Functional Specification Document

10. Testing

10.1 Input Data

NA

10.2 Test Scenario

Positive testing Scenario
1) Create a carrier ticket for nomination and check actual posted quantity is updated based on dip
date/time.

Negative testing scenarios

1) Do not enter dip date/time and update the actual posted quantity manually.

10.3 Positive Unit Test

Step T-Code Step Description Expected Results

Scenario#1 O4TEN/ Create a carrier ticket for Actual posted quantity
O4TFN nomination and check actual should be updated as
posted quantity is updated based expected
on dip date/time.

Scenario#2 O4NM/O4TEN Create nomination for below Actual posted quantity

scenarios with dips and parallel should be based on dip
operation and test difference +/- parallel
Origin Sale operation quantity.
Origin ISTO sales
Transfer scenario
Tank to tank transfer etc.

10.4 Negative Unit Test

Step T-Code Step Description Expected Results

1 O4TEN/O4TFN Do not enter dip date/time and Actual posted quantity
update the actual posted quantity
should be updated
manually.

Scenario# O4NM/O4TEN Create nomination for below Actual posted quantity

2 scenarios with dips and without
should be based on dip
parallel operation and test
difference.

Classif 20
MASAR_ONGP_FSD_ENH000041__V1.0
ication
: ENOC
Confid