Interface Between EWM and KiSoft Packmaster1
Interface Between EWM and KiSoft Packmaster1
com
Development Order
C903A
3011
FRICE-ID:
KNAPP IT Solutions GmbH • Parkring 1 • 8074 Grambach bei Graz • Austria • +43 50 495 - 9100
Uni Credit Bank Austria AG • BIC: BKAUATWW • IBAN: AT611200052959159109 • FN: 383109 x • UID: ATU67349648 • DVR number: 4017059
www.KNAPP.com
Change log
Content
1 Introduction 4
2 US 1: Interface SAP EWM <--> KiSoft Packmaster 4
2.1 Acceptance criteria 4
2.2 Execution flows 4
2.3 Mockups / Use Cases / Processes 4
2.4 Additional information 4
3 US 2: Providing data for KiSoft Packmaster 4
3.1 Acceptance criteria 5
3.2 Execution flows 5
3.3 Mockups / Use Cases / Processes 6
3.4 Additional information 6
3.4.1 ArticleGroup 6
3.4.2 Determination of ArticleGroup Content 7
4 US 3: Receive calculation result from KiSoft Packmaster 8
4.1 Acceptance criteria 8
4.2 Execution flows 9
4.3 Mockups / Use Cases / Processes 10
4.4 Additional information 10
5 US 4: Calculation of palletizing starting date and time (PST) 11
5.1 Acceptance criteria 11
5.2 Execution flows 11
5.3 Mockups / Use Cases / Processes 12
5.4 Additional information 12
6 US 5: Calculation of physical palletizing start date and time (PPS) 15
6.1 Acceptance criteria 15
6.2 Execution flows 15
6.3 Mockups / Use Cases / Processes 16
6.4 Additional information 16
7 US 6: Calculation of physical palletizing end date and time (PPE) 16
7.1 Acceptance criteria 16
7.2 Execution flows 16
7.3 Mockups / Use Cases / Processes 17
7.4 Additional information 17
8 Architecture 17
9 Technical implementation 17
9.1 Entry point 17
9.2 Packages 17
9.3 Implemented BAdI’s 17
9.4 Important classes / function modules 18
9.5 Database tables 18
9.6 Checkpoint groups 18
9.7 Others 18
1 Introduction
The KiSoft Packmaster calculates how many pallets are required for palletizing according to the pack-
ing pattern based on the result of the cartonization and the given restrictions. This calculation will be
triggered automatically in background as soon as a specific moment in time is reached. The triggering
is based on a background job, which will run regularly. The result of the calculation is a whole struc-
ture about how to pack the cartons on the pallets, which are assigned to a specific TU.
For creating a request to Packmaster and saving the request to the outbound queue, the
entry point /knapp/if_pm_telegram_facade~get_pack_image needs to be used.
For working off the outbound queue to the Packmaster server, the entry point /knapp/
if_pm_telegram_facade~work_off_export_queue needs to be used.
The system provides a program to work off the outbound queue via a scheduled job.
o The program needs the warehouse number as well as the Packmaster id as parame-
ter
Interface method /knapp/if_pm_process_import_tg needs to be implemented in order to
handle inbound telegrams.
All Packmaster related customizing and master data tables need to be available in SPRO
(see chapter 2.4).
XML logging table must be included in warehouse management monitor (/KNAPP/D_PM005)
All interface related information are located in document Technical Documentation Packmaster.docx
on ELC sharepoint and the Packmaster business blue print.
TUs with a “Packmaster planning date and time” equal to the current time or already in the past, with
an empty z-field for the “KiSoft Packmaster planning status” (= unplanned) on the header level and
with at least one entry in the z-table “ZTLGT_O_CAR”, which has the status “1 (initial)” or “3 (KiSoft
Packmaster calculation completed)”. If at least one entry has status “2 (KiSoft Packmaster calculation
started)”, the corresponding TU will not be taken into consideration for a calculation during this run.
As soon as all convenient TUs were determined, the status of the corresponding carton entries in the
z-table will be set to “2 (KiSoft Packmaster calculation started)”. All required information about the
corresponding PSHUs or already existing HUs will then be provided to the KiSoft Packmaster inter-
face via a structure and the Packmaster outbound queue.
Option 2:
1. The user schedules a background job, which runs regularly.
2. The system starts the background job.
3. The system determines all Outbound-TUs with an empty z-field for the “KiSoft Packmaster
planning status” (= unplanned) on the header level and a “Packmaster planning date and
For further information regarding the z-table “ZTLGT_O_CAR” see document “C903A_2011_A_Ex-
tension of KNAPP Cartonization”.
The following table shows, which fields in the structure need to be filled with which values by the sys -
tem and how to determine the value if needed:
Structure Structure field Value Determination
level
WPO WpoNo TU number value in field “TU_NUM” on TU
header (/SCWM/DE_TU_NUM)
CONTAINER ContTypeId Packaging 3-digit code in z-field “ZZ_PKINS” on
instruction ODO header
CONTAINER Length/Width/Height/Weight Dimensions dimensions in z-table
and weight ZTLGT_PACK_INST based on the
3-digit code in z-field “ZZ_PKINS” on
ODO header
WS ItemNo Carton HU value in field “SSCC number” in z-
number table ZTLGT_O_CAR
WS ItemDescription Packaging value in field “PMAT_NO” on HU
material of header
carton
WS ArticleGroup Division Combined string. See chapter 3.4.1
WS Weight Weight of value in field “G_WEIGHT” of either
carton PSHU or HU
WS MatchingCode Allowed same value as in structure-field
packaging “ContTypeId”
material for
pallet
WS Qty 1 No determination, always 1
3.4.1 ArticleGroup
Full example:
Pallet string | Division | Material (Product) + Batch | Purchase Order | Loose Pick Flag
H 0000338288|01|16810200000000236505|7694259781|LP
H 0000338288|01|1681020000|7694259781|LP
H 0000338288|01|1681020000|7694259781|~
<CombineMatrix>
</CombineMatrix>
<CombineMatrix>
</CombineMatrix>
The palletizing can be controlled via specific criteria. It is possible to send KiSoft Packmaster the in-
formation, that product- and batch-clean pallets should be built. Additionally, it is possible to pack
loose pick cartons on a separate pallet.
To determine if the document type of the either linked ODO in combination with the shipping point
and ship-to partner or the linked IMST is marked for product / batch clean palletizing or loose picks
separately, the z-table “ZTLGT_DOC_TYPE_RLT” needs to be extended with the following two col-
umns:
For further information regarding this z-table see document “C903A_2011_A_Extension of KNAPP
Cartonization_v2”.
k. The system writes an alert in the standard transaction /SAPAPO/AMON1 in case an error
occurred including all needed information dependent from the kind of error (e.g. TU number,
PSHU number, executed and failed checks, error code based on handbook, …).
Option 2:
1. The KiSoft Packmaster sends the calculation result via the Packmaster inbound queue to
SAP EWM.
2. The system receives the calculation result and deletes all related entries from the structure in
the Packmaster outbound queue.
3. The system checks that there are already captured pallets numbers (= SSCC) for the corre-
sponding TU.
4. The system creates a SSCC number for all required pallets, which are not yet captured in the
z-table “ZTLGT_O_PAL”.
5. The system captures the SSCC number, the category based on the category of the related
cartons as well as the status “3 (KiSoft Packmaster calculation completed)” and the packag-
ing material (based on packaging instruction of the KiSoft Packmaster result
(ContTypeID) in the z-table “ZTLGT_O_PAL”.
6. The system assigns the new pallet number (= SSCC) to the corresponding carton and
changes the status to “3 (KiSoft Packmaster calculation completed)” in the z-table
“ZTLGT_O_CAR”.
7. The system updates the assignment of a pallet number (= SSCC) to a carton and changes
the status to “3 (KiSoft Packmaster calculation completed)” in the z-table “ZTLGT_O_CAR” if
needed.
8. The system updates the “PGI readiness indicator” on the TU header based on the number of
finally planned pallets and the sum of their weight.
9. The system changes the “KiSoft Packmaster planning status” on the TU header to “X” (=
planned).
10. The system saves the corresponding received XML-file in background for later usage.
11. The system writes entries in the standard transaction /SCWM/SLG1.
Option 3:
1. The KiSoft Packmaster sends the calculation result to SAP EWM.
2. The system receives the calculation result including cartons that are not able to be packed on
a pallet (WS_NOT_LOADED).
3. The system executes all updates for the correctly packed cartons like in case it receives the
calculation result without not-packed cartons.
4. The system changes the status of all cartons that could not be packed onto a pallet to “1 (ini-
tial)” and sets the “Packmaster planning date and time” to the current time plus a custom
additional time based on the z-table “ZTLGT_WH_DFLT”.
5. The system saves the corresponding received XML-file in background for later usage.
6. The system writes an alert in the standard transaction /SAPAPO/AMON1.
The z-table “ZTLGT_O_PAL” is needed to save all pallet-related outbound process information, which
can occur or be changed within the whole process. The table will look like this e.g.:
WH SSCC Reference num- Cate- Sta- Assign. KiSoft PM cal-
no. ber gory tus WC culation time
CHG1 45678965 1
4
CHG1 12345678 02 3 20190424143711
8
CHG1 95123541 05 4 MPS1 20190423131107
1
The following table shows the potential categories a pallet can get assigned to depended on the cate-
gory of the cartons linked to the pallet:
Category Description Carton categories
no.
01 Non-mech cartons 01
02 Oversized cartons 02
03 M2P cartons 03
04 OSR cartons 04
05 M2P & OSR cartons 03 + 04
The following table shows the potential statuses that can be assigned to a pallet in the column “sta-
tus” in the above-mentioned table:
Status Description
1 initial
2 KiSoft Packmaster calculation started
3 KiSoft Packmaster calculation completed
4 Palletizing started
5 Palletizing finished
For further information regarding the custom status for “Packmaster planning status” on the TU
header see document “C903A_2008_A_PPF-action for creation of a TU and assignment of ODO to
TU”.
For further information regarding the new setting of the “Packmaster planning date and time” see
document “C903A_2014_A_Logic for G2P station”.
For further information regarding the z-table “ZTLGT_O_CAR” as well as the extension of the stan-
dard transaction /SCWM/AMON1 to write an alert in case of an error see document
“C903A_2011_A_Extension of KNAPP Cartonization”.
The weight restrictions per customer are maintained in the z-table “ZTLGT_WEIGHT_CUST”. For
further information regarding the z-table see document “C903A_5010_A_MON Extension for TU
split”.
The calculated PST will be saved in the corresponding fields on the TU header, which need to be
implemented additionally. As soon as the planned date and time for GI changes or the calculation of
the KiSoft Packmaster is retriggered, the calculation of the PST will automatically be executed again
too. This can happen in several steps during the whole outbound process.
2. The system calculates the palletizing starting date and time based on the corresponding for-
mulas.
3. The system captures the calculated date and time in the corresponding z-fields.
Option 2:
1. The user updated the planned date and time for GI.
4. The system calculates the palletizing starting date and time based on the corresponding for-
mulas.
2. The system captures the calculated date and time in the corresponding z-fields.
As soon as the PST changes, the calculation of the LSD will automatically be executed again. For
more information regarding the calculation of the latest starting date and time (LSD) see document
“C903A_2011_A_Extension of KNAPP Cartonization”.
The following table describes the single parameter of the formula for the PST:
PGI date for the Time, when all pallets from one TU need to be TU header level z-fields:
TU (PGI) ready in the HBW or staging area for PGI and ZZ_PLAN_GI_DATE
creation of the shipment. ZZ_PLAN_GI_TIME
Carton retrieval Average time to retrieve a carton from the Z-table ZTLGT_PST_TIMES
(CR) OSR and transport it to the palletizing station.
Will only be considered once, as an average
value for automated (incl. FastBox) and man-
ual stations.
To be able to get the time for palletizing all cartons the following formula applies:
The following table describes the single parameter of the formula for the PAL:
03/04/2023 753422992.docx 12/18
www.KNAPP.com
Time for carton Average time for palletizing one carton manu- Z-table ZTLGT_PST_TIMES
palletizing manu- ally by the user
ally (Tcar_m)
Time for carton Average time for palletizing one carton auto- Z-table ZTLGT_PST_TIMES
palletizing auto- matically by the robot
matically
(Tcar_a)
Pallet changing Average time how long the pallet exchange Z-table ZTLGT_PST_TIMES
time manual sta- takes at the manual station (time for releasing
tion (PCTm) the finished pallet and transport the new pallet
to the station)
Pallet changing Average time how long the pallet exchange Z-table ZTLGT_PST_TIMES
time automatic takes at the automatic station (time for releas-
station (PCTa) ing the finished pallet and transport the new
pallet to the station)
Factor for simul- Factor to reduce 100% of workstation avail- Z-table ZTLGT_PST_FACTORS
taneity (FAC) ability to reflect parallel usage of workstations
for different TUs. Different values depending
on time of the day. The PGI date will be com-
pared with the according customized value for
that timeslot (from-to).
Palletizing station Factor to increase the capacity of the worksta- Z-table ZTLGT_PST_FACTORS
availability (PSA) tions and to reduce therefore the time for pal-
letizing. Workstation availability to reflect par-
allel usage of different workstations. Different
values depending on time of the day.
The PGI date will be compared with the ac-
cording customized value for that timeslot
(from-to).
To be able to get the time for pallet finishing the following formula applies:
The following table describes the single parameter of the formula for the PFT:
Pallet finishing Average time how long the finishing per pallet Z-table ZTLGT_PST_TIMES
time (Tpft) takes (incl. labeling, hooding, re-storage in
HBW, …)
Pallet finishing Factor to increase the capacity of the worksta- Z-table ZTLGT_PST_FACTORS
station availability tions and to reduce therefore the time for pal-
(FSA) let finishing. Workstation availability to reflect
parallel usage of different workstations. Differ-
ent values depending on time of the day.
The PGI date will be compared with the ac-
cording customized value for that timeslot
(from-to).
The z-table “ZTLGT_PST_TIMES” will be integrated in the customizing as an application table and
therefore maintainable if needed. This table will look like this e.g.:
Activity Required time
Carton retrieval (CR) 00:05:00
Time for carton palletizing manually (Tcar_m) 00:00:20
Time for carton palletizing automatically (Tcar_a) 00:00:10
Pallet changing time manual station (PCTm) 00:02:00
Pallet changing time automatic station (PCTa) 00:01:00
Pallet finishing time (Tpft) 00:05:00
The z-table “ZTLGT_PST_FACTORS” will contain values per weekday and time ranges to capture
the different needed factors for the calculation, will be integrated in the customizing as an application
table and therefore maintainable if needed. This table will look like this e.g.:
Weekday From time To time FAC PSA FSA
1 00:00:00 05:59:59 1.00 02 02
1 06:00:00 11:59:59 0.25 10 10
1 12:00:00 17:59:59 0.50 08 08
1 18:00:00 23:59:59 1.00 02 02
2 00:00:00 05:59:59 1.00 02 02
2 06:00:00 11:59:59 0.25 10 10
2 12:00:00 17:59:59 0.50 08 08
2 18:00:00 23:59:59 1.00 02 02
3 00:00:00 05:59:59 1.00 02 02
The calculated PPS will be saved in the corresponding fields on the TU header, which need to be
implemented additionally. As soon as the planned date and time for GI changes or the calculation of
the KiSoft Packmaster is retriggered, the calculation of the PPS will automatically be executed again
too. This can happen in several steps during the whole outbound process.
Option 2:
1. The user updated the planned date and time for GI.
2. The system calculates the physical palletizing start date and time based on the corresponding
formula.
3. The system captures the calculated date and time in the corresponding z-fields.
For further information regarding the single parameters of the formula for the PPS see chapter 5.
The calculated PPE will be saved in the corresponding z-fields on the TU header. As soon as the
planned date and time for GI changes or the calculation of the KiSoft Packmaster is retriggered, the
calculation of the PPE will automatically be executed again too. This can happen in several steps
during the whole outbound process.
1. The system receives the calculation result from the KiSoft Packmaster.
2. The system calculates the physical palletizing end date and time based on the corresponding
formula.
3. The system captures the calculated date and time in the corresponding z-fields.
Option 2:
1. The user updated the planned date and time for GI.
2. The system calculates the physical palletizing end date and time based on the corresponding
formula.
3. The system captures the calculated date and time in the corresponding z-fields.
For further information regarding the single parameters of the formula for the PPS see chapter 5.
8 Architecture
to be filled in by the developer before implementation
<This part describes the implementation concept for the whole Development Order. It consists of
textual and/or tabular descriptions as well as diagrams of process flows and components which are
produced. In case of modification only the change is documented. There could be:
- (optional) description of implemented parameters
- (optional) diagram of classes
- (optional) description of implemented configuration tables, inputs, etc. …
For this chapter it is needed to create a ‘task’ in JIRA, which is linked to the ‘epic’.>
9 Technical implementation
9.2 Packages
to be filled in by the developer during or after implementation
9.7 Others
to be filled in by the developer during or after implementation
<Enumeration of other development objects like authorization objects, number ranges, change docu-
ments, etc.>