SAP BAPI_DOCUMENT_CREATENEWVERSION Function Module for Create new document version
BAPI_DOCUMENT_CREATENEWVERSION is a standard bapi document createnewversion SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Create new document version processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.
See here to view full function module documentation and code listing for bapi document createnewversion FM, simply by entering the name BAPI_DOCUMENT_CREATENEWVERSION into the relevant SAP transaction such as SE37 or SE38.
Function Group: CVBAPI
Program Name: SAPLCVBAPI
Main Program: SAPLCVBAPI
Appliation area: C
Release date: 03-Jul-1998
Mode(Normal, Remote etc): Remote-Enabled
Update:

Function BAPI_DOCUMENT_CREATENEWVERSION pattern details
In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.CALL FUNCTION 'BAPI_DOCUMENT_CREATENEWVERSION'"Create new document version.
EXPORTING
REFDOCUMENTTYPE = "Document Type (Original Document)
REFDOCUMENTNUMBER = "Document Number (Original Document)
REFDOCUMENTPART = "Document Part (Original Document)
REFDOCUMENTVERSION = "Document Version (Original Document)
* NEWDOCUMENTVERSION = "New Document Version
* DOCFILE1 = "New File Name if not Checked In
* DOCFILE2 = "New File Name if not Checked In
* COPYORIGINALS = 'X' "Copy Original
* CAD_MODE = ' ' "CAD FLag for Document Structure
IMPORTING
DOCTYPE = "Document Type
DOCNUMBER = "Document Number
DOCPART = "Document Part
DOCVERSION = "Document Version
RETURN = "BAPI Return
TABLES
* COPYOBJECTLINKS = "List of Object Links to be Copied
IMPORTING Parameters details for BAPI_DOCUMENT_CREATENEWVERSION
REFDOCUMENTTYPE - Document Type (Original Document)
Data type: BAPI_DOC_AUX-DOCTYPEOptional: No
Call by Reference: No ( called with pass by value option)
REFDOCUMENTNUMBER - Document Number (Original Document)
Data type: BAPI_DOC_AUX-DOCNUMBEROptional: No
Call by Reference: No ( called with pass by value option)
REFDOCUMENTPART - Document Part (Original Document)
Data type: BAPI_DOC_AUX-DOCPARTOptional: No
Call by Reference: No ( called with pass by value option)
REFDOCUMENTVERSION - Document Version (Original Document)
Data type: BAPI_DOC_AUX-DOCVERSIONOptional: No
Call by Reference: No ( called with pass by value option)
NEWDOCUMENTVERSION - New Document Version
Data type: BAPI_DOC_AUX-DOCVERSIONOptional: Yes
Call by Reference: No ( called with pass by value option)
DOCFILE1 - New File Name if not Checked In
Data type: BAPI_DOC_DRAW-DOCFILE1Optional: Yes
Call by Reference: No ( called with pass by value option)
DOCFILE2 - New File Name if not Checked In
Data type: BAPI_DOC_DRAW-DOCFILE2Optional: Yes
Call by Reference: No ( called with pass by value option)
COPYORIGINALS - Copy Original
Data type: BAPI_DOC_AUX-FLAGDefault: 'X'
Optional: Yes
Call by Reference: No ( called with pass by value option)
CAD_MODE - CAD FLag for Document Structure
Data type: CSDATA-XFELDDefault: SPACE
Optional: Yes
Call by Reference: No ( called with pass by value option)
EXPORTING Parameters details for BAPI_DOCUMENT_CREATENEWVERSION
DOCTYPE - Document Type
Data type: BAPI_DOC_AUX-DOCTYPEOptional: No
Call by Reference: No ( called with pass by value option)
DOCNUMBER - Document Number
Data type: BAPI_DOC_AUX-DOCNUMBEROptional: No
Call by Reference: No ( called with pass by value option)
DOCPART - Document Part
Data type: BAPI_DOC_AUX-DOCPARTOptional: No
Call by Reference: No ( called with pass by value option)
DOCVERSION - Document Version
Data type: BAPI_DOC_AUX-DOCVERSIONOptional: No
Call by Reference: No ( called with pass by value option)
RETURN - BAPI Return
Data type: BAPIRET2Optional: No
Call by Reference: No ( called with pass by value option)
TABLES Parameters details for BAPI_DOCUMENT_CREATENEWVERSION
COPYOBJECTLINKS - List of Object Links to be Copied
Data type: BAPI_DOC_DRAD_SELECTOptional: Yes
Call by Reference: No ( called with pass by value option)
Copy and paste ABAP code example for BAPI_DOCUMENT_CREATENEWVERSION Function Module
The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.| DATA: | ||||
| lv_doctype | TYPE BAPI_DOC_AUX-DOCTYPE, " | |||
| lt_copyobjectlinks | TYPE STANDARD TABLE OF BAPI_DOC_DRAD_SELECT, " | |||
| lv_refdocumenttype | TYPE BAPI_DOC_AUX-DOCTYPE, " | |||
| lv_docnumber | TYPE BAPI_DOC_AUX-DOCNUMBER, " | |||
| lv_refdocumentnumber | TYPE BAPI_DOC_AUX-DOCNUMBER, " | |||
| lv_docpart | TYPE BAPI_DOC_AUX-DOCPART, " | |||
| lv_refdocumentpart | TYPE BAPI_DOC_AUX-DOCPART, " | |||
| lv_docversion | TYPE BAPI_DOC_AUX-DOCVERSION, " | |||
| lv_refdocumentversion | TYPE BAPI_DOC_AUX-DOCVERSION, " | |||
| lv_return | TYPE BAPIRET2, " | |||
| lv_newdocumentversion | TYPE BAPI_DOC_AUX-DOCVERSION, " | |||
| lv_docfile1 | TYPE BAPI_DOC_DRAW-DOCFILE1, " | |||
| lv_docfile2 | TYPE BAPI_DOC_DRAW-DOCFILE2, " | |||
| lv_copyoriginals | TYPE BAPI_DOC_AUX-FLAG, " 'X' | |||
| lv_cad_mode | TYPE CSDATA-XFELD. " SPACE |
|   CALL FUNCTION 'BAPI_DOCUMENT_CREATENEWVERSION' "Create new document version |
| EXPORTING | ||
| REFDOCUMENTTYPE | = lv_refdocumenttype | |
| REFDOCUMENTNUMBER | = lv_refdocumentnumber | |
| REFDOCUMENTPART | = lv_refdocumentpart | |
| REFDOCUMENTVERSION | = lv_refdocumentversion | |
| NEWDOCUMENTVERSION | = lv_newdocumentversion | |
| DOCFILE1 | = lv_docfile1 | |
| DOCFILE2 | = lv_docfile2 | |
| COPYORIGINALS | = lv_copyoriginals | |
| CAD_MODE | = lv_cad_mode | |
| IMPORTING | ||
| DOCTYPE | = lv_doctype | |
| DOCNUMBER | = lv_docnumber | |
| DOCPART | = lv_docpart | |
| DOCVERSION | = lv_docversion | |
| RETURN | = lv_return | |
| TABLES | ||
| COPYOBJECTLINKS | = lt_copyobjectlinks | |
| . " BAPI_DOCUMENT_CREATENEWVERSION | ||
ABAP code using 7.40 inline data declarations to call FM BAPI_DOCUMENT_CREATENEWVERSION
The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.| "SELECT single DOCTYPE FROM BAPI_DOC_AUX INTO @DATA(ld_doctype). | ||||
| "SELECT single DOCTYPE FROM BAPI_DOC_AUX INTO @DATA(ld_refdocumenttype). | ||||
| "SELECT single DOCNUMBER FROM BAPI_DOC_AUX INTO @DATA(ld_docnumber). | ||||
| "SELECT single DOCNUMBER FROM BAPI_DOC_AUX INTO @DATA(ld_refdocumentnumber). | ||||
| "SELECT single DOCPART FROM BAPI_DOC_AUX INTO @DATA(ld_docpart). | ||||
| "SELECT single DOCPART FROM BAPI_DOC_AUX INTO @DATA(ld_refdocumentpart). | ||||
| "SELECT single DOCVERSION FROM BAPI_DOC_AUX INTO @DATA(ld_docversion). | ||||
| "SELECT single DOCVERSION FROM BAPI_DOC_AUX INTO @DATA(ld_refdocumentversion). | ||||
| "SELECT single DOCVERSION FROM BAPI_DOC_AUX INTO @DATA(ld_newdocumentversion). | ||||
| "SELECT single DOCFILE1 FROM BAPI_DOC_DRAW INTO @DATA(ld_docfile1). | ||||
| "SELECT single DOCFILE2 FROM BAPI_DOC_DRAW INTO @DATA(ld_docfile2). | ||||
| "SELECT single FLAG FROM BAPI_DOC_AUX INTO @DATA(ld_copyoriginals). | ||||
| DATA(ld_copyoriginals) | = 'X'. | |||
| "SELECT single XFELD FROM CSDATA INTO @DATA(ld_cad_mode). | ||||
| DATA(ld_cad_mode) | = ' '. | |||
Search for further information about these or an SAP related objects