3/8/2015

UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusesanddeadlinesABAPDevelopmentSCNWiki

GettingStarted Newsletters

Welcome,Guest

Login

Register

Store

SearchtheCommunity

Products

Services&Support

AboutSCN

Downloads

Industries

Training&Education

Partnership

DeveloperCenter

LinesofBusiness

UniversityAlliances

Events&Webinars

Innovation

ABAPDevelopment / ABAPDevelopmentandProgramming

UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusesanddeadlines
AddedbyAndreaOlivieri,lasteditedbySmrutiRanjanMohantyonOct28,2013
Author:AndreaOlivieri
Submitted:22October2010
Highlights
ThisisanextractoftheOSSNote531207UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusescreatedasanswertothisthread

Symptom
ThisnotecomplementsthedocumentationfortheinterfaceoffunctionmoduleBAPI_SHIPMENT_CREATEconcerningdatesandtransportationplanningstatus.
FunctionmoduleBAPI_SHIPMENT_CREATEisabletogenerateshipmentdocumentsincludingpreassignedplannedandactualdatesfortheindividualshippingstatusesplanning,registration,loadingstart,
loadingend,shipmentcompletion,shipmentstartandshipmentend.
Ontheonehand,BAPI_SHIPMENT_CREATEcanbeusedasaremoteenabledmodule.Ontheotherhand,youhavetheoptionofusingthefunctionwithintheEDIwithfunctionmodule
IDOC_INPUT_SHIPMENT_CREATEFROMorIDocbasictypeSHIPMENT_CREATEFROMDATA01(IDOC_INPUT_SHIPMENT_CREATEFROMonlyconvertsSHIPMENT_CREATEFROMDATA01and
thencallsBAPI_SHIPMENT_CREATEforfurtherprocessing)

Otherterms
Alternativeforidoc_input_shpmnt

ReasonandPrerequisites
Whenyouusebapi_shipment_create,therearedifferentwaysofsettingthedifferentdatesoftheshipmentheader.Thefollowingstatementscanbeunderstoodbymeansoftheattachedreport
ZTEST_BAPI_SHIPMENT_CREATE2.
Onlythefields
bapishipmentheaderstatus_plan
bapishipmentheaderstatus_checkin
bapishipmentheaderstatus_load_start
bapishipmentheaderstatus_load_end
bapishipmentheaderstatus_compl
bapishipmentheaderstatus_shpmnt_start
bapishipmentheaderstatus_shpmnt_end
ofstructurebapishipmentheaderaresetwiththecallofbapi_shipment_create(value='X'):Inthiscasethecorrespondingstatusesofthenewshipmentarealsoset,therespectiveDATAandTIMES
1. VTTKDTDIS>Dateofendofplanning
2. VTTKUZDIS>Schedulingendtime
3. VTTKDAREG>Actualdateofcheckin
4. VTTKUAREG>Currenttimeofcheckin
5. VTTKDALBG>Currentdateforstartofloading
6. VTTKUALBG>Actualloadingstarttime
7. VTTKDALEN>Actualdateforendofloading
8. VTTKUALEN>Actualloadingendtime
9. VTTKDTABF>Currentdateofshipmentcompletion
10. VTTKUZABF>Timeoftransportationprocessing
11. VTTKDATBG>Currentdateforstartofshipment
12. VTTKUATBG>Actualtransportstarttime
13. VTTKDATEN>Actualdateforendofshipment
14. VTTKUATEN>Actualshipmentendtime
correspondtotheSYSTEMDATEortheSYSTEMTIME,atwhichthefunctionmodulewasimported.TherespectivePLANNEDdataandPLANNEDtimesremainempty.
FillingthesevenabovementionedBAPISHIPMENTHEADERfieldsisnotnecessaryifyouassigntheHEADERDEADLINEinterfacetothefunctionmodule.IfHeaderdeadlineisfilledcorrectly,the
statusesoftheshipmentWITHdateandtimearetakenfromthisstructure.(SettingthefieldsfromBapishipmentheaderisnotnecessaryinthiscase,butalsonotincorrect).ThePLANNEDdatacan
alsobesetwithstructureHEADERDEADLINE.
However,structureHEADERDEADLINEmustbefilledinaccordancewiththefollowingrule:
TIME_TYPE=logicaltime>tobefilledwithfixedvalues:

http://wiki.scn.sap.com/wiki/display/ABAP/Use+of+BAPI_SHIPMENT_CREATE+concerning+shipping+statuses+and+deadlines

1/6

3/8/2015

UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusesanddeadlinesABAPDevelopmentSCNWiki

1. TIME_TYPE=HDRSTPLDT>Date/timeofendofplanning
2. TIME_TYPE=HDRSTCIPDT>PLANNEDdate/timeofcheckin
3. TIME_TYPE=HDRSTCIADT>ACTUALdate/timeofcheckin
4. TIME_TYPE=HDRSTLSPDT>PLANNEDdate/timeofloadingstart
5. TIME_TYPE=HDRSTLSADT>ACTUALdate/timeofloadingstart
6. TIME_TYPE=HDRSTLEPDT>PLANNEDdate/timeofloadingend
7. TIME_TYPE=HDRSTLEADT>ACTUALdate/timeofloadingend
8. TIME_TYPE=HDRSTCPDT>PLANNEDdate/timeofshipmentcompletion
9. TIME_TYPE=HDRSTCADT>ACTUALdate/timeofshipmentcompletion
10. TIME_TYPE=HDRSTSSPDT>PLANNEDdate/timeofshipmentstart
11. TIME_TYPE=HDRSTSSADT>ACTUALdate/timeofshipmentstart
12. TIME_TYPE=HDRSTSEPDT>PLANNEDdate/timeofshipmentend
13. TIME_TYPE=HDRSTSEADT>ACTUALdate/timeofshipmentend
TheseequivalentscanalsobefoundinfunctiongroupV56I_BAPI>IncludeLV56I_BAPITOP
TIME_STAMP_UTC=UTCtimestampinshortform(YYYYMMDDhhmmss)
TIME_ZONE=timezone

Remark
Ifyousetsomefields,whichdonothaveanyequivalentinHeaderdeadline,inBapishipmentheader,systemdateandsystemtimearesetagainforthese(current)shippingstatuses.Theplanneddata
staysemptyforthese(additional)statuses.

Solution
HereyoucanfindthespecifiedSAMPLEreport.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

REPORTZTEST_BAPI_SHIPMENT_CREATE2.
***************************************************************
*Thisreportisprovidedtohelpunderstandingtheinterface*
*offunctionmodule'BAPI_SHIPMENT_CREATE'withregardto*
*itsabilitytofillthedifferentshipmentdeadlines*
*Withrunningthisreport,newshipmentsarecreated*
***************************************************************
*filltheinterfaceforbapi
DATA:HEADERDATALIKEBAPISHIPMENTHEADER,
HEADERDEADLINELIKEBAPISHIPMENTHEADERDEADLINE
OCCURS0WITHHEADERLINE,
ITEMDATALIKEBAPISHIPMENTITEMOCCURS0WITHHEADERLINE,
STAGEDATALIKEBAPISHIPMENTSTAGEOCCURS0WITHHEADERLINE,
STAGEDEADLINELIKEBAPISHIPMENTSTAGEDEADLINE
OCCURS0WITHHEADERLINE,
ITEMONSTAGELIKEBAPISHIPMENTITEMONSTAGE
OCCURS0WITHHEADERLINE,
ADDRESSLIKEBAPISHIPMENTADDRESS
OCCURS0WITHHEADERLINE,
HDUNHEADERLIKEBAPISHIPMENTHDUNHEADER
OCCURS0WITHHEADERLINE,
HDUNITEMLIKEBAPISHIPMENTHDUNITEM
OCCURS0WITHHEADERLINE,
RETURNLIKEBAPIRET2OCCURS0WITHHEADERLINE.

SELECTIONSCREENCOMMENT/1(83)COM1.
SELECTIONSCREENCOMMENT/1(83)COM2.
SELECTIONSCREENCOMMENT/1(83)COM3.
SELECTIONSCREENCOMMENT/1(83)COM4.
SELECTIONSCREENCOMMENT/1(83)COM5.
SELECTIONSCREENCOMMENT/1(83)COM6.
SELECTIONSCREENCOMMENT/1(83)COM7.
SELECTIONSCREENSKIP1.
SELECTIONSCREENULINE.

SELECTIONSCREENBEGINOFBLOCKHEADERWITHFRAMETITLETEXTHRD.
*Headerdateobligatory
SELECTIONSCREENCOMMENT/1(79)COM8FORFIELDTPLST.
PARAMETER:TPLSTLIKEVTTKTPLST.
SELECTIONSCREENCOMMENT/1(79)COM9FORFIELDTPLST.

http://wiki.scn.sap.com/wiki/display/ABAP/Use+of+BAPI_SHIPMENT_CREATE+concerning+shipping+statuses+and+deadlines

2/6

3/8/2015
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusesanddeadlinesABAPDevelopmentSCNWiki
PARAMETER:SHTYPLIKEVTTKSHTYP.
SELECTIONSCREENENDOFBLOCKHEADER.
SELECTIONSCREENULINE.
SELECTIONSCREENBEGINOFBLOCKSTATUSWITHFRAMETITLECOM10.
*Plan
PARAMETER:PLANLIKEBAPISHIPMENTHEADERSTATUS_PLAN.
*checkin
PARAMETER:CHECKLIKEBAPISHIPMENTHEADERSTATUS_CHECKIN.
*loadstart
PARAMETER:LOAD_SLIKEBAPISHIPMENTHEADERSTATUS_LOAD_START.
*loadend
PARAMETER:LOAD_ELIKEBAPISHIPMENTHEADERSTATUS_LOAD_END.
*Completion
PARAMETER:COMPLLIKEBAPISHIPMENTHEADERSTATUS_COMPL.
*trabegin
PARAMETER:SHIP_SLIKEBAPISHIPMENTHEADERSTATUS_SHPMNT_START.
*traend
PARAMETER:SHIP_ELIKEBAPISHIPMENTHEADERSTATUS_SHPMNT_END.
SELECTIONSCREENENDOFBLOCKSTATUS.
*Headerdeadline
SELECTIONSCREENBEGINOFBLOCKH_DEADLINEWITHFRAMETITLECOM11.
PARAMETERS:TTYPE(10)
DEFAULT'HDRSTPLDT',"=Endofplanning
UTCLIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONELIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE2(10)
DEFAULT'HDRSTCIPDT',"=planneddateofcheckin
UTC2LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE2LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE3(10)
DEFAULT'HDRSTCIADT',"=actualdateofcheckin
UTC3LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE3LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE4(10)
DEFAULT'HDRSTLSPDT',"=planneddatef.startloading
UTC4LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE4LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE5(10)
DEFAULT'HDRSTLSADT',"=currentdatef.startloading
UTC5LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE5LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE6(10)
DEFAULT'HDRSTLEPDT',"=planneddatef.endloading
UTC6LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE6LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE7(10)
DEFAULT'HDRSTLEADT',"=actualdatef.endloading
UTC7LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE7LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE8(10)
DEFAULT'HDRSTCPDT',"=planneddatef.shpmntcompletion
UTC8LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE8LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE9(10)
DEFAULT'HDRSTCADT',"=actualdatef.shpmntcompletion
UTC9LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE9LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE10(10)
DEFAULT'HDRSTSSPDT',"=planneddatef.startshpmnt
UTC10LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE10LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE11(10)
DEFAULT'HDRSTSSADT',"=actualdatef.startshpmnt
UTC11LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE11LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.

http://wiki.scn.sap.com/wiki/display/ABAP/Use+of+BAPI_SHIPMENT_CREATE+concerning+shipping+statuses+and+deadlines

3/6

3/8/2015
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170

UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusesanddeadlinesABAPDevelopmentSCNWiki
PARAMETERS:TTYPE12(10)
DEFAULT'HDRSTSEPDT',"=planneddatef.endshpmnt
UTC12LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE12LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
PARAMETERS:TTYPE13(10)
DEFAULT'HDRSTSEADT',"=actualdatef.endshpmnt
UTC13LIKEBAPISHIPMENTHEADERDEADLINETIME_STAMP_UTC,
ZONE13LIKEBAPISHIPMENTHEADERDEADLINETIME_ZONE.
SELECTIONSCREENENDOFBLOCKH_DEADLINE.
***********************************************************************
*Formattheselectoptions*
***********************************************************************
INITIALIZATION.
COM1='Thisreportwasprovidedtohelpunderstandingthebehaviour'.
COM2='offunctionmoduleBAPI_SHIPMENT_CREATEwithregardtoits'.
COM3='abilitytofillthenewshipmentsdeadlines:'.
COM4='Planning,CheckIn,LoadingStart,Loadingend,'.
COM5='Shpmntcompletion,Shipmentstartandshipmentend.'.
COM6='Thisreportcreatesnewshipmentswhichcanbe'.
COM7='viewede.g.withtransactionVT03n'.
COM8='TransportationPlanningPoint(obligatory)'.
COM9='Shipmenttype(obligatory)'.
COM10='BAPISHIPMENTHEADERFlags>seenote531207'.
COM11='HEADERDEADLINEStructure>seenote531207'.
***********************************************************************

STARTOFSELECTION.
******************headbegin***********************************
HEADERDATATRANS_PLAN_PT=TPLST.
HEADERDATASHIPMENT_TYPE=SHTYP.
*changePlanstatus
*HEADERDATASHIPMENT_NUM=tknum.
IFPLAN<>SPACE.
HEADERDATASTATUS_PLAN=PLAN.
ENDIF.
*ChangeCheck_instatus
IFCHECK<>SPACE.
HEADERDATASTATUS_CHECKIN=CHECK.
ENDIF.
*loadbeginn
IFLOAD_S<>SPACE.
HEADERDATASTATUS_LOAD_START=LOAD_S.
ENDIF.
*loadend
IFLOAD_E<>SPACE.
HEADERDATASTATUS_LOAD_END=LOAD_E.
ENDIF.
*completion
IFCOMPL<>SPACE.
HEADERDATASTATUS_COMPL=COMPL.
ENDIF.
*trabeginn
IFSHIP_S<>SPACE.
HEADERDATASTATUS_SHPMNT_START=SHIP_S.
ENDIF.
*trabeginn
IFSHIP_E<>SPACE.
HEADERDATASTATUS_SHPMNT_END=SHIP_E.
ENDIF.
*****HEADERDEADLINEENDOFPLANNING
IFTTYPE<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE.
HEADERDEADLINETIME_STAMP_UTC=UTC.
HEADERDEADLINETIME_ZONE=ZONE.
APPENDHEADERDEADLINE.

http://wiki.scn.sap.com/wiki/display/ABAP/Use+of+BAPI_SHIPMENT_CREATE+concerning+shipping+statuses+and+deadlines

4/6

3/8/2015
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235

UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusesanddeadlinesABAPDevelopmentSCNWiki
ENDIF.
*****HEADERDEADLINEPLANNEDDATEOFCHECKIN
IFTTYPE2<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE2.
HEADERDEADLINETIME_STAMP_UTC=UTC2.
HEADERDEADLINETIME_ZONE=ZONE2.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEACTUALDATEOFCHECKIN
IFTTYPE3<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE3.
HEADERDEADLINETIME_STAMP_UTC=UTC3.
HEADERDEADLINETIME_ZONE=ZONE3.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEPLANNEDDSTARTOFLOADING
IFTTYPE4<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE4.
HEADERDEADLINETIME_STAMP_UTC=UTC4.
HEADERDEADLINETIME_ZONE=ZONE4.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINECURRENTDSTARTOFLOADING
IFTTYPE5<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE5.
HEADERDEADLINETIME_STAMP_UTC=UTC5.
HEADERDEADLINETIME_ZONE=ZONE5.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEPLANNEDDENDOFLOADING
IFTTYPE6<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE6.
HEADERDEADLINETIME_STAMP_UTC=UTC6.
HEADERDEADLINETIME_ZONE=ZONE6.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEACTUALDENDOFLOADING
IFTTYPE7<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE7.
HEADERDEADLINETIME_STAMP_UTC=UTC7.
HEADERDEADLINETIME_ZONE=ZONE7.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEPLANNEDDSHIPMENTCOMPLETION
IFTTYPE8<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE8.
HEADERDEADLINETIME_STAMP_UTC=UTC8.
HEADERDEADLINETIME_ZONE=ZONE8.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEACTUALDSHIPMENTCOMPLETION
IFTTYPE9<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE9.
HEADERDEADLINETIME_STAMP_UTC=UTC9.
HEADERDEADLINETIME_ZONE=ZONE9.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEPLANNEDDSTARTOFSHIPMENT
IFTTYPE10<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE10.
HEADERDEADLINETIME_STAMP_UTC=UTC10.
HEADERDEADLINETIME_ZONE=ZONE10.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEACTUALDSTARTOFSHIPMENT

http://wiki.scn.sap.com/wiki/display/ABAP/Use+of+BAPI_SHIPMENT_CREATE+concerning+shipping+statuses+and+deadlines

5/6

236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273

UseofBAPI_SHIPMENT_CREATEconcerningshippingstatusesanddeadlinesABAPDevelopmentSCNWiki
IFTTYPE11<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE11.
HEADERDEADLINETIME_STAMP_UTC=UTC11.
HEADERDEADLINETIME_ZONE=ZONE11.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINEPLANNEDDENDOFSHIPMENT
IFTTYPE12<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE12.
HEADERDEADLINETIME_STAMP_UTC=UTC12.
HEADERDEADLINETIME_ZONE=ZONE12.
APPENDHEADERDEADLINE.
ENDIF.
*****HEADERDEADLINECURRENTDENDOFSHIPMENT
IFTTYPE13<>SPACE.
HEADERDEADLINETIME_TYPE=TTYPE13.
HEADERDEADLINETIME_STAMP_UTC=UTC13.
HEADERDEADLINETIME_ZONE=ZONE13.
APPENDHEADERDEADLINE.
ENDIF.
************************************************************
************************************************************
CALLFUNCTION'BAPI_SHIPMENT_CREATE'
EXPORTING
HEADERDATA=HEADERDATA
TABLES
HEADERDEADLINE=HEADERDEADLINE
ITEMDATA=ITEMDATA
STAGEDATA=STAGEDATA
STAGEDEADLINE=STAGEDEADLINE
ITEMONSTAGE=ITEMONSTAGE
ADDRESS=ADDRESS
HDUNHEADER=HDUNHEADER
HDUNITEM=HDUNITEM
RETURN=RETURN.
LOOPATRETURN.
WRITE:RETURN.
ENDLOOP.
InfoAds

InfoAds

3/8/2015

vt02n
ContactUs
Privacy

SAPHelpPortal
TermsofUse

LegalDisclosure

deadlines

Copyright

http://wiki.scn.sap.com/wiki/display/ABAP/Use+of+BAPI_SHIPMENT_CREATE+concerning+shipping+statuses+and+deadlines

shipment

update

bapi

FollowSCN

6/6