Ooredoo

Material Management
AP450 Purchase Order Form

Technical Design

Purchase Order Form

File Name:AP450 - PO form

Status: Draft

Page 1 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form

General Information
Document Location
Associated Documentation
(FD)

Sign Off
Team

Name

Date

Signature

Revision History
Date
17/12/2013

Author
Rhesa tanoto

Status
Draft

Description / Reason for Change

Initial creation

GENERAL REQUIREMENTS........................................................................................................................... 4

RELATED DOCUMENT.................................................................................................................................... 4

DEVELOPMENT OBJECTS............................................................................................................................. 4

ASSUMPTIONS................................................................................................................................................ 4

TECHNICAL FLOW / PROGRAM LOGIC........................................................................................................ 5

5.1
5.2
5.3
5.4
5.5
5.6
5.7
5.8

General Program Hierarchy...................................................................................................................... 5

Program Subroutine / Component Inventory............................................................................................. 5
Code Reuse.............................................................................................................................................. 5
Selection-screen Layout........................................................................................................................... 5
Authorization Objects and Checks to be Used.......................................................................................... 5
Pseudo Codes.......................................................................................................................................... 5
Output Detail/Layout................................................................................................................................. 5
Interactive Capabilities.............................................................................................................................. 5

PERFORMANCE CONSIDERATIONS............................................................................................................. 5

SET-UP PROCEDURE...................................................................................................................................... 5

RECOVERY PROCEDURE / SPECIAL CONSIDERATIONS...........................................................................6

EXCEPTIONS................................................................................................................................................... 6

10 UNIT TEST........................................................................................................................................................ 6

File Name:AP450 - PO form

Status: Draft

Page 2 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
11 DESIGN CHANGES / ISSUE DOCUMENTATION............................................................................................ 6

File Name:AP450 - PO form

Status: Draft

Page 3 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
1

GENERAL REQUIREMENTS
Program Description
Status (Required)
Business Priority

RELATED DOCUMENT
DevLo
g No

Description

Transport
Request

CHARM
Number

DEVELOPMENT OBJECTS
Object Type
PROGRAM
SMARTFOR
M
STRUCTUR
E
STRUCTUR
E
TABLE TYPE

Print Purchase Order Form

100%
Normal

Name
ZMPUF_PO_FORM_PRINT
ZMPU_PO_FORM

Description
Purchase Order Form Printing
Purchase Order Form

ZMPUS_PO_FORM_ITEM

PO Form item

ZMPUS_PO_FORM_HEADER

PO Form header

ZMPUS_T_PO_FORM_ITEM

PO Form item table

ASSUMPTIONS
1.
2.
3.
4.

Form printed using transaction ME9F

Program only can print 1 document number at a time.
Document number entered in ME9F is copied to program via NAST-OBJKY.
Document title changes base on document type. If document type is Subcontracting (ZSCN), then the title
is Purchase Order Subcontracting. If it is different, use Purchase Order instead.
5. If the item type is service, do not show amount for the service item instead show the amount of every sub
item.

File Name:AP450 - PO form

Status: Draft

Page 4 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
5

FORM DESIGN
Form Layout(s):

PO Form
Design-v0.2.doc

Form Size
Orientation
Paper Size
Font
Font Size

: Landscape
: A4
: Arial
: 10

Data Mapping
No
.

Description

Display Format

Form title

PO Date

DD/MM/YYYY

Incoterm

Page

<Current page> of
<number of page>

Version

Purchasing officer

Contract number

Revision date

DD/MM/YYYY

Requisitioner

PR number

Supplier To

<Supplier name>
<Supplier address>
<Supplier city>
<Supplier country>
<Supplier postal code>

Supplier No

Contact Person

Ship To

<Ship to name>
<Ship to address>
<Ship to city>

Logic & Remarks

See assumptions

If contract number every

items are different, empty
this field

If ship to in every items are

different, empty this field.

File Name:AP450 - PO form

Status: Draft

Page 5 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
<Ship to country>

6
6.1

Invoice To

<Invoice to address>
<Invoice to city>
<Invoice to country>

Payment Term

Item No

N + 1 OR
N.M + 1 (increment)
Example : 1, 2, 3
1.1 , 1.2 , 1.3

Material / service

<material number> - <material

description>
Ship to :<storage location
address>
PR number : <PR number>
Contract number : <contract
number>

Quantity

UoM

Delivery Date

DD/MM/YYYY

Header text

Unit price

Use , for thousand separator

and . For decimal separator

Tax

XX %

Total price without

tax

Use , for thousand separator

and . For decimal separator

Total price with tax

Use , for thousand separator

and . For decimal separator

Remarks

Subtotal

Use , for thousand separator

and . For decimal separator

Discount

Use , for thousand separator

and . For decimal separator

Net price

Use , for thousand separator

and . For decimal separator

Grand total

Use , for thousand separator

and . For decimal separator

Supplier name

Company name

Approver name and

position

<Approver name>
<Approver position>

Use address of the

company responsible for
this invoice (table T001)

Use N + 1 for item non

service and service header
item. Use N.M + 1 for
service sub item

Free text using text element

Free text using text element

Ooredoo Myanmar, Ltd.

TECHNICAL FLOW / PROGRAM LOGIC

General Program Hierarchy

File Name:AP450 - PO form

Status: Draft

Page 6 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form

File Name:AP450 - PO form

Status: Draft

Page 7 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form

6.2

Program Subroutine / Component Inventory

Program
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT
ZMPUF_PO_FORM_PRI
NT

Subroutine/Component
F_ENTRY
F_GET_PURCH_ORDER

Description
Perform that called when we execute
transaction ME9F to print PO form
Get purchase order data

F_GET_SCHEDULE_AGR
EE
F_GET_SERVICE_PACKA
GE
F_GET_TAX

Get schedule agreement data

F_GET_VENDOR

Get vendor data

F_GET_VENDOR_RECOR
D
F_GET_PERSON_DATA

Get vendor master record purchasing

Org. data
Get personal data

F_GET_ADDRESS

Get address data

F_GET_PLANTS

Get plants / branches

F_GET_MATERIAL_TEXT

Get material text description

F_POPULATE_DATA

Populate data into smartform

structures

6.3

Code Reuse
N/A

6.4

Selection-screen Layout
N/A

6.5

Authorization Objects and Checks to be Used

N/A

6.6

Pseudo Codes

Get service package

Get tax amount

1. Get purchasing document data (header and item data)

Retrieve data from table EKKO (purchasing document header)
Comparing:
Purchasing document number (EBELN) = NAST_OBJKY.
Retrieve data from table KONV (conditions (transaction data))
Comparing:
number of the document condition (KNUMV) = EKKO-KNUMV.

File Name:AP450 - PO form

Status: Draft

Page 8 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
Retrieve data from table EREV (version in purchasing)
Comparing:
object number in purchasing (EDOKN) = EKKO-EBELN.
Retrieve data from table T052U (own explanation for terms of Payment)
Comparing:
terms of payment key (ZTERM) = EKKO-EBELN.
Retrieve data from table EKPO (Purchasing Document Item)
Comparing:
purchasing document number (EBELN) = EKKO-EBELN
Deletion indicator (LOEKZ) = .
Retrieve data from table T007S (Tax Code Names)
Comparing:
procedure (KALSM) = TAXMM
Sales tax code (MWSKZ) = EKPO-MWSKZ.
Retrieve address number from T001
Comparing:
company code (BUKRS) = EKPO-BUKRS.
Retrieve data from table ADRC (addresses (Business Address service))
Comparing:
address number (ADDRNUMBER) = T001-ADRNR.
2. Get schedule agreement data
Retrieve data from table EKET (Scheduling Agreement Schedule Lines)
Comparing:
purchasing document number (EBELN) = EKPO-EBELN
Item number of purchasing document = EKPO-EBELP.
3. Get service package for every service type document in item
Retrieve data from table ESLL (Lines of Service Package)
Comparing:
package number (PACKNO) = EKPO-PACKNO
Deletion indicator (DEL) = .
Get sub item for service type item from ESLL table using previous data that retrieved from ESLL table.
Retrieve data from table ESLL (Lines of Service Package)
Comparing:
package number (PACKNO) = ESLL-SUB_PACKNO
Deletion indicator (DEL) = .
4. Get tax amount
Retrieve data from table T007A (Tax Keys)
Comparing:
Procedure (KALSM) = TAXMM
Sales tax code (MWSKZ) = EKPO-MWSKZ.
Retrieve data from table T007A (Tax Keys)
Comparing:
Procedure (KALSM) = TAXMM
Sales tax code (MWSKZ) = ESLL-MWSKZ.
Merge the two data retrieved into 1 internal table.
Retrieve data from table A003 (tax Clarification)
Comparing:
departure country (ALAND) = T007A-LSTML
Sales tax code (MWSKZ) = ESLL-MWSKZ.
Retrieve data from table KONP (condition (item))
File Name:AP450 - PO form
Status: Draft

Page 9 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
Comparing:

condition record number (KNUMH) = A003-KNUMH.

5. Get vendor data

Retrieve data from table LFA1 (vendor master)
Comparing:
account number of vendor (LIFNR) = EKKO-LIFNR
Retrieve data from table T005T (Country Names)
Comparing:
language key (SPRAS) = SY-LANGU
country key (LAND1) = LFA1-LAND1.
6. Get vendor master record for purchasing organization
Retrieve data from table LFM1 (Vendor master record purchasing organization data)
Comparing:
account number of vendor (LIFNR) = EKKO-LIFNR
7. Get personal data for document creator
Retrieve data from table USR21 (assign user name address key)
Comparing:
user name in master record (BNAME) = EKKO-ERNAM.
Retrieve data from table ADRP (Persons (business Address Service))
Comparing:
person number (PERSNUMBER) = USR21-PERSNUMBER.
8. Get address for every item (storage location address)
Retrieve data from table TWLAD (Determination of Address from Plant and Storage Location)
Comparing:
plant (WERKS) = EKPO-WERKS
Storage location (LGORT) = EKPO-LGORT.
Retrieve data from table ADRC (Addresses (Business Address Services))
Comparing:
address number (ADDRNUMBER) = TWLAD-ADRNR.
If there is no data, get address number from table EKPO and retrieve data from ADRC
Retrieve data from table ADRC (Addresses (Business Address Services))
Comparing:
address number (ADDRNUMBER) = EKPO-ADRNR
9. Get plants / branches
Retrieve data from table T001W (Plants / Branches)
Comparing:
plant (WERKS) = EKPO-WERKS.
10. Get material text description for material in item
Retrieve data from table MAKT (Material descriptions)
Comparing:
material number (MATNR) = EKPO-MATNR
11. Populate all data into header or item level structure of forms.
6.7

Output Detail/Layout

File Name:AP450 - PO form

Status: Draft

Page 10 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
Header Layout:

Item Structure:
Field
Name

Field Description

Field Type / Ref

Field to Data
Dictionary

Field
Length

Field
reference
(for
Currency
/Quantity
Field)

Conversion
routines

Comments

No

Increment number

If the item
is sub item
use format
X.Y where
X is the
item
number
and Y is
the sub
number.

material

Material
description

MAKT-MATNR
MAKT-MAKTX
EKPO-BANFN
EKPO-KONNR
Concatenate
(ADRC-STREET
and ADRCHOUSE_NUM1
and ADRCPOST_CODE1
and ADRCCITY1)

Contain
material
number,
description,
PR
number,
contract
no, and
shipment
destination
(storage
location
address)

Quantity

Quantity for every

item

EKPO-MENGE

EKPOMEINS

UoM

Unit measurement
of quantity

EKPO-MEINS

Delivery
date

Delivery date

EKET-EINDT

File Name:AP450 - PO form

Status: Draft

Page 11 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
Field
Name

Field Description

Field Type / Ref

Field to Data
Dictionary

Field
Length

Field
reference
(for
Currency
/Quantity
Field)

Conversion
routines

Comments

Unit
price

Price of a material

EKPO-NETPR

EKKOWAERS

Tax

Tax percentage of
the item

KONP-KBETR

Total
without
tax

Total price without

calculate tax

EKPO-NETPR *
EKPO-MENGE

EKKOWAERS

Total
with tax

Total price
including tax

(EKPO-NETPR *
EKPO-MENGE )
+ TAX

EKKOWAERS

use KONVKBETR *
total price
to get tax
amount

Footer Layout:

Breaking:
N/A

Totals:
1. Subtotal
2. Discount
3. Net price
4. Grand total

: total price without tax for all item listed.

: total discount for each item listed.
: price after calculated the discount.
: net price + tax for every item.

Sorting:
N/A
6.8

Interactive Capabilities
N/A
PERFORMANCE CONSIDERATIONS
N/A

File Name:AP450 - PO form

Status: Draft

Page 12 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
8

SET-UP PROCEDURE
Procedure to set up ME9F.
1. Open TCODE NACE
2. Choose application code EF Purchase Order and click output types

3. Choose output type ZPO and double click on Processing routines

File Name:AP450 - PO form

Status: Draft

Page 13 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form

4. Configure as shown in below picture

RECOVERY PROCEDURE / SPECIAL CONSIDERATIONS

N/A

10

EXCEPTIONS
N/A

11

UNIT TEST
Test Condition
Normal Processing
1.
2.
3.
4.

Expected Result

File Name:AP450 - PO form

Status: Draft

Test Result

Page 14 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved

Ooredoo
Material Management
AP450 Purchase Order Form
Error Processing
1.
2.
3.

12

DESIGN CHANGES / ISSUE DOCUMENTATION

Raised
by

Issue

Date
Needed

Resolution/Answer

File Name:AP450 - PO form

Status: Draft

Date
Completed

Resolved
by

Page 15 of 15
Copyright 2013 Ooredoo-Accenture. All Rights Reserved