BAPI_ACC_DOCUMENT_POST

转关于BAPI BAPI_ACC_DOCUMENT_POST  的几篇网文, 备查

 

原文地址:http://community.kingdee.com/pages/carllu/blog/archive/2010/04/28/420713.aspx

 

1.    举个我们这次系统中的一个业务场景

前面讲到我们需要把一个Oracle应付发票的凭证导入到SAP中，但是导入的字段比较多，就会出现如下的问题：
SAP系统中把凭证中的[分支号]作为不同系统的来源，例如凭证来源于Oracle，金蝶，用友，那么分支号分别是'001','002','003'。
我们这里使用BAPI_ACC_DOCUMENT_POST来导入凭证，
大家可以看一下在BKPF表中存在[分支号]字段       

但是在BAPIACHE09(操作代码SE37)结构中却没有[分支号]这个字段，BAPIACHE09是BAPI_ACC_DOCUMENT_POST导入凭证头的入口结构        
        
那么标准API没有[分支号]，SAP采用何种方法才能将[分支号]导入系统哪？

很高兴看到SAP提供了增强BAdi(客户化创建BAdi)来导入标准API没有的字段
一般情况下，不需要对BAdi作增强，但是当需要将某个不常用的字段导入到SAP，但是标准的BAPI又不能够支持这个字段，则需要对BAdi作增强，那么如何对BAdi作增强那？
下面简单做个讲解：
1)首先需要我们对标准的BAdi(操作代码SE19)做个实例化，本场景中，我们对ACC_DOCUMENT这个标准的BAdi实例化      

        

        
关键是上图中的CHANGE部分，双击就可以进入BAdi的ABAP程序源代码，是不是感觉很爽，不过别高兴太早，因为进入源代码的编辑器之后，是空的，当然，源代码是需要自己添加的，请看下图：
        
上面的代码看不懂没关系，我来解释一下：
DATA部分是定义变量，liw_accit TYPE accit就是定义一个accit的结构类型的变量liw_accit；
LOOP部分就是对BAPI中的extension2的数据作循环
Liw_accit-bschl就是对bschl这个字段根据实际传入的数据作赋值，当然，bschl就是类似[分支号]的字段；
MODIFY就是将bashl等字段写入到c_accit结构中，相当于更新accit表中的数据


大家看到这里，可能已经明白了BAdi是怎么回事。但是大家可能会问，BAPI怎么会去调用BAdi来做这个事情哪？这个问题可能比较复杂，但是我把他简化了说：
在下图中，BAPI一般会有
[Import]传入参数
[Export]传出参数
[Tabellen]这个是table类型的，用来传入和传出数组类型或table类型的数据，在table类型的数据中有个参数是extension2，作为扩展导入的字段，只要在extension2中作了定义，那么就会执行所有实例化的BAdi，所以这也算是SAP的一个缺点，因为假设你定义了2个相同类型的BAdi，它们都会被执行，假设这两个BAdi逻辑相悖，则会导致所无的数据，所以要在SAP的开发中避免
        

 

1.    SAP导入多个凭证

 

不过讲到这里，我们也只是一个凭证，但是在我们实际的业务场景中，我们大部分都需要导入多个凭证，那么如果想要导入多个凭证，使用SAP的API如何来实现那？

既然可以使用BAPI_ACC_DOCUMENT_POST可以导入单个凭证，只要对它循环操作就可以实现多个凭证的导入了，大家看了下面的代码就会理解，红色的部分就是循环调用BAPI_ACC_DOCUMENT_POST就可以批量导入凭证

凭证导入程序开发，ZBAPI_ACC_DOCUMENT_POST。                    
代码：                    
Import：               
Export：               
Changing：               
Tables：               
T_DOCUMENT    LIKE    ZDOCUMENT   凭证内容
Exceptions：               
Source Code：   
FUNCTION ZBAPI_ACC_DOCUMENT_POST.
*"----------------------------------------------------------------------
*"*"Local interface:
*"  TABLES
*"      T_DOCUMENT STRUCTURE  ZDOCUMENT
*"----------------------------------------------------------------------
  DATA: WA_DOCUMENTHEADER    TYPE BAPIACHE09,                    "待传凭证抬头 工作区

    WA_ACCOUNTGL         TYPE BAPIACGL09,                    "总帐科目项 工作区
    IT_ACCOUNTGL         TYPE STANDARD TABLE OF BAPIACGL09,  "总帐科目项 内表
    WA_ACCOUNTRECEIVABLE TYPE BAPIACAR09,                    "客户项目 工作区
    IT_ACCOUNTRECEIVABLE TYPE STANDARD TABLE OF BAPIACAR09,  "客户项目 内表
    WA_ACCOUNTPAYABLE    TYPE BAPIACAP09,                    "供应商项目 工作区
    IT_ACCOUNTPAYABLE    TYPE STANDARD TABLE OF BAPIACAP09,  "供应商项目 内表
    WA_CURRENCYAMOUNT    TYPE BAPIACCR09,                    "货币项目 工作区
    IT_CURRENCYAMOUNT    TYPE STANDARD TABLE OF BAPIACCR09,  "货币项目 内表
    WA_EXTENSION2        TYPE BAPIPAREX,                     "参考结构 工作区
    IT_EXTENSION2        TYPE STANDARD TABLE OF BAPIPAREX,   "参考结构 内表
    WA_RETURN            TYPE BAPIRET2,                      "返回参数 工作区
    IT_RETURN            TYPE STANDARD TABLE OF BAPIRET2,    "返回参数 内表
    WA_ZBKPF_SEND        TYPE ZBKPF_SEND,                    "已导凭证 工作区
    IT_ZBKPF_SEND        TYPE STANDARD TABLE OF ZBKPF_SEND.  "已导凭证 内表

  DATA: W_DOCUMENT  TYPE ZDOCUMENT,        "凭证头 工作区
    LW_DOCUMENT TYPE ZDOCUMENT.        "临时 凭证头 工作区

  DATA: CNS_DR_R TYPE CHAR2 VALUE 'DR',    "凭证借方标识
    CNS_CR_R TYPE CHAR2 VALUE 'CR',    "凭证贷方标识
    CNS_X    TYPE CHAR1 VALUE 'X',     "确认标识
    CNS_RFBU TYPE CHAR4 VALUE 'RFBU',  "业务事务
    CNS_SA   TYPE CHAR2 VALUE 'SA',    "总分类账凭证
    CNS_KR   TYPE CHAR2 VALUE 'KR',    "供应商发票
    CNS_40   TYPE CHAR2 VALUE '40',    "总账-借
    CNS_50   TYPE CHAR2 VALUE '50',    "总账-贷
    CNS_01   TYPE CHAR2 VALUE '01',    "应收-借
    CNS_11   TYPE CHAR2 VALUE '11',    "应收-贷
    CNS_21   TYPE CHAR2 VALUE '21',    "应付-借
    CNS_31   TYPE CHAR2 VALUE '31',    "应付-贷
  DATA: L_RETURN_TABCOUNT TYPE I,
    L_BELNR           TYPE BKPF-BELNR.
  CHECK T_DOCUMENT IS NOT INITIAL.

  SORT T_DOCUMENT BY BELNR ASCENDING.

  LOOP AT T_DOCUMENT INTO W_DOCUMENT.

    LW_DOCUMENT = W_DOCUMENT.
*------------------------转换表头------------------------------------
    AT NEW BELNR.
      WA_DOCUMENTHEADER-BUS_ACT    = CNS_RFBU.           "业务事务
      WA_DOCUMENTHEADER-USERNAME   = SY-UNAME.           "系统当前用户
      WA_DOCUMENTHEADER-COMP_CODE  = LW_DOCUMENT-BUKRS.  "公司代码
      WA_DOCUMENTHEADER-DOC_DATE   = LW_DOCUMENT-BLDAT.  "凭证中的凭证日期
      WA_DOCUMENTHEADER-PSTNG_DATE = LW_DOCUMENT-BUDAT.  "凭证中的记帐日期
      WA_DOCUMENTHEADER-FISC_YEAR  = LW_DOCUMENT-GJAHR.  "会计年度
      WA_DOCUMENTHEADER-FIS_PERIOD = LW_DOCUMENT-MONAT.  "会计期间
      WA_DOCUMENTHEADER-DOC_TYPE   = LW_DOCUMENT-BLART.  "凭证类型
      WA_DOCUMENTHEADER-REF_DOC_NO = LW_DOCUMENT-XBLNR.  "参考凭证号
      WA_DOCUMENTHEADER-HEADER_TXT = LW_DOCUMENT-BKTXT.  "凭证抬头文本
    ENDAT.

    CASE LW_DOCUMENT-BLART.
*------------------------总账科目------------------------------------
      WHEN CNS_SA.
*------------------------总帐科目项----------------------------------
    WA_ACCOUNTGL-ITEMNO_ACC = LW_DOCUMENT-BUZEI.            "会计凭证中的行项目数
    WA_ACCOUNTGL-GL_ACCOUNT = LW_DOCUMENT-HKONT.            "总分类帐帐目
    WA_ACCOUNTGL-COMP_CODE  = LW_DOCUMENT-BUKRS.            "公司代码
    WA_ACCOUNTGL-COSTCENTER = LW_DOCUMENT-KOSTL.            "成本中心
    WA_ACCOUNTGL-PROFIT_CTR = LW_DOCUMENT-PRCTR.            "利润中心
    APPEND WA_ACCOUNTGL TO IT_ACCOUNTGL.
    CLEAR WA_ACCOUNTGL.
*------------------------供应商发票OR供应商贷项凭证----------------
      WHEN CNS_KR OR CNS_KG.
*      统驭科目
    IF LW_DOCUMENT-MITKZ = CNS_X.
*------------------------供应商项目----------------------------------
      WA_ACCOUNTPAYABLE-ITEMNO_ACC = LW_DOCUMENT-BUZEI.       "会计凭证中的行项目数
      WA_ACCOUNTPAYABLE-VENDOR_NO  = LW_DOCUMENT-LIFNR.       "供应商
      APPEND WA_ACCOUNTPAYABLE TO IT_ACCOUNTPAYABLE.
      CLEAR WA_ACCOUNTPAYABLE.
*      非统驭科目
    ELSE.
*------------------------总帐科目项----------------------------------
      WA_ACCOUNTGL-ITEMNO_ACC = LW_DOCUMENT-BUZEI.            "会计凭证中的行项目数
      WA_ACCOUNTGL-GL_ACCOUNT = LW_DOCUMENT-HKONT.            "总分类帐帐目
      WA_ACCOUNTGL-COMP_CODE  = LW_DOCUMENT-BUKRS.            "公司代码
      WA_ACCOUNTGL-COSTCENTER = LW_DOCUMENT-KOSTL.            "成本中心
      WA_ACCOUNTGL-PROFIT_CTR = LW_DOCUMENT-PRCTR.            "利润中心
      APPEND WA_ACCOUNTGL TO IT_ACCOUNTGL.
      CLEAR WA_ACCOUNTGL.
    ENDIF.
    ENDCASE.

*------------------------增强字段-----------------------------------
    IF LW_DOCUMENT-BRNCH IS NOT INITIAL.
      WA_EXTENSION2-STRUCTURE  = 'BRNCH'.              "分支号
      WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.    "行项目数
      WA_EXTENSION2-VALUEPART2 = LW_DOCUMENT-BRNCH.    "分支号值

      APPEND WA_EXTENSION2 TO IT_EXTENSION2.
      CLEAR WA_EXTENSION2.
    ENDIF.

    IF LW_DOCUMENT-UMSKZ IS INITIAL.
      CASE LW_DOCUMENT-BLART.
    WHEN CNS_SA.
      IF LW_DOCUMENT-SHKZG = CNS_DR_R.
        WA_EXTENSION2-STRUCTURE  = 'BSCHL'.
        WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.
        WA_EXTENSION2-VALUEPART2 = CNS_40.
      ELSEIF LW_DOCUMENT-SHKZG = CNS_CR_R.
        WA_EXTENSION2-STRUCTURE  = 'BSCHL'.
        WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.
        WA_EXTENSION2-VALUEPART2 = CNS_50.
      ENDIF.
       ENDCASE.

      APPEND WA_EXTENSION2 TO IT_EXTENSION2.
      CLEAR WA_EXTENSION2.
    ELSE.
      WA_EXTENSION2-STRUCTURE  = 'UMSKZ'.              "特别总/分类帐指示符
      WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.    "行项目数
      WA_EXTENSION2-VALUEPART2 = LW_DOCUMENT-UMSKZ.    "特别总/分类帐值

      APPEND WA_EXTENSION2 TO IT_EXTENSION2.
      CLEAR WA_EXTENSION2.

      CASE LW_DOCUMENT-BLART.
    WHEN CNS_KR OR CNS_KG.
      IF LW_DOCUMENT-SHKZG = CNS_DR_R.
        WA_EXTENSION2-STRUCTURE  = 'BSCHL'.
        WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.
        WA_EXTENSION2-VALUEPART2 = CNS_29.
      ELSEIF LW_DOCUMENT-SHKZG = CNS_CR_R.
        WA_EXTENSION2-STRUCTURE  = 'BSCHL'.
        WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.
        WA_EXTENSION2-VALUEPART2 = CNS_39.
      ENDIF.
    WHEN CNS_DR OR CNS_DG.
      IF LW_DOCUMENT-SHKZG = CNS_DR_R.
        WA_EXTENSION2-STRUCTURE  = 'BSCHL'.
        WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.
        WA_EXTENSION2-VALUEPART2 = CNS_09.
      ELSEIF LW_DOCUMENT-SHKZG = CNS_CR_R.
        WA_EXTENSION2-STRUCTURE  = 'BSCHL'.
        WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.
        WA_EXTENSION2-VALUEPART2 = CNS_19.
      ENDIF.
      ENDCASE.

      APPEND WA_EXTENSION2 TO IT_EXTENSION2.
      CLEAR WA_EXTENSION2.
    ENDIF.


    IF LW_DOCUMENT-SGTXT IS NOT INITIAL.
      WA_EXTENSION2-STRUCTURE  = 'SGTXT'.              "项目文本
      WA_EXTENSION2-VALUEPART1 = LW_DOCUMENT-BUZEI.    "行项目数
      WA_EXTENSION2-VALUEPART2 = LW_DOCUMENT-SGTXT.    "项目文本值
      APPEND WA_EXTENSION2 TO IT_EXTENSION2.
      CLEAR WA_EXTENSION2.
    ENDIF.

    AT END OF BELNR.

                        CALL FUNCTION 'BAPI_ACC_DOCUMENT_POST'
    EXPORTING
      DOCUMENTHEADER          = WA_DOCUMENTHEADER     "录入凭证头
    TABLES
      ACCOUNTGL               = IT_ACCOUNTGL          "总帐科目项
      ACCOUNTRECEIVABLE       = IT_ACCOUNTRECEIVABLE  "客户项目
      ACCOUNTPAYABLE          = IT_ACCOUNTPAYABLE     "供应商项目
      CURRENCYAMOUNT          = IT_CURRENCYAMOUNT     "货币项目
      EXTENSION2              = IT_EXTENSION2         "扩展字段
      RETURN                  = IT_RETURN.            "返回值

      DESCRIBE TABLE IT_RETURN LINES L_RETURN_TABCOUNT.

      IF L_RETURN_TABCOUNT = 1.                           "凭证导入成功
    CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'.
                        *      记录已导入的凭证号
    READ TABLE IT_RETURN INTO WA_RETURN INDEX 1.
    IF SY-SUBRC IS INITIAL.
      L_BELNR = WA_RETURN-MESSAGE_V2+0(10).

      WA_ZBKPF_SEND-BELNR = L_BELNR.
      WA_ZBKPF_SEND-CPUDT = SY-DATUM.
      WA_ZBKPF_SEND-CPUTM = SY-UZEIT.
      WA_ZBKPF_SEND-USNAM = SY-UNAME.

      APPEND WA_ZBKPF_SEND TO IT_ZBKPF_SEND.
    ENDIF.
      ELSE.                                               "凭证导入失败

      ENDIF.
      CLEAR: L_RETURN_TABCOUNT,
         WA_ZBKPF_SEND,
         WA_DOCUMENTHEADER,
         IT_ACCOUNTGL,
         IT_ACCOUNTPAYABLE,
         IT_CURRENCYAMOUNT,
         IT_EXTENSION2,
         IT_RETURN.
    ENDAT.
    CLEAR: W_DOCUMENT,LW_DOCUMENT.
  ENDLOOP.
*------------------------往表ZBKPF_SEND插入已导凭证数据-------------------
  IF IT_ZBKPF_SEND IS NOT INITIAL.
    INSERT ZBKPF_SEND FROM TABLE IT_ZBKPF_SEND ACCEPTING DUPLICATE KEYS.
    CLEAR IT_ZBKPF_SEND.            
  ENDIF.            
ENDFUNCTION.           

===========================

原文地址: http://hi.baidu.com/gaoyl2007/blog/item/8fc078fb0cfd0362034f5682.html/cmtid/93c148ec437f23dd2e2e2117

前天测试程序的发现了一个问题，主要关于BAPI_ACC_DOCUMENT_POST的用法，懂ABAP的人都知道这是用于过账的，而BAPI_ACC_DOCUMENT_CHECK是用于做过账前的Check处理的。

我程序里明明设置好了参数，但是Debug测试时只看到Post Successfully的消息，却看不到我要的会计凭证号，当时很奇怪。百翻思考，网上查资料，后来问题终于得到解决。原来是因为我在 documentheader里多传进去了三个参数：OBJ_TYPE， OBJ_KEY，OBJ_SYS。如果删除这三个参数的话就能在返回的内部table里抓去我想要的凭证号码了。呵呵！问题搞定，当时真的很兴奋！

如果谁对BAPI_ACC_DOCUMENT_POST和BAPI_ACC_DOCUMENT_CHECK这两个BAPI不太熟悉的话，那麽在 SAP ECC6.0以上的版本上有一本系统程序ACC_BAPI_TEST_DOCUMENT，可供参考。里面有关于他们的用法以及参数设置。。。