SAP Function BAPI_INCOMINGINVOICE_GETLIST - Invoice Verification: List Incoming Invoices

Parameter Reference Type Length Default Optional Text
ERP_DOCUMENTS BAPIFLAG-BAPIFLAG C 1 'X' X Selection of ERP Invoice Documents
TM_DOCUMENTS BAPIFLAG-BAPIFLAG C 1 'X' X Selection of Invoice Documents Relating to Transportation Management

Parameter Reference Length Optional Text
CPUDATE_RA BAPI_INCINV_ENTRY_DATE_RA 19 X Select Options for Entry Date
DOCDATE_RA BAPI_INCINV_DOC_DATE_RA 19 X Select Options for Document Date
HEADERLIST BAPI_INCINV_GETLIST_HEADER 168 Header Data in Incoming Invoice
PERSON_EXT_RA BAPI_INCINV_PERSON_EXT_RA 27 X Select Options for External System Users
PSTNGDATE_RA BAPI_INCINV_PSTNG_DATE_RA 19 X Select Options for Posting Date
REFDOC_RA BAPI_INCINV_REF_DOC_RA 35 X Select Options for Incoming Invoice Reference Document Number (GetList)
RETURN BAPIRET2 548 Return Messages
STATUS_RA BAPI_INCINV_IV_STATUS_RA 5 X Select Options for Incoming Invoice Status
VENDOR_RA BAPI_INCINV_VENDOR_RA 23 X Select Options for Vendor

Functionality
This method allows you to find incoming invoices according to theselection criteria listed below.

Notes
The following authorization object is checked with activity 03:

  • M_RECH_WRK Plant authorization for entering
    • incoming invoices

    Input parameters
    You can use the following criteria to select invoices:

    • Vendor (Structure VendorRa)

    • Posting date (Structure PstngDateRa)

    • Document date (Structure DocDateRa)

    • Entry date (Structure CpuDateRa)

    • External creator (Structure PersonExtRa)

    • Invoice status (Structure StatusRa)

    • Reference Document Number (Structure RefDocRa)

      • If you do not enter many selection restrictions, performance may beaffected.
      IF &[SWITCH]MM_SFWS_TM& = 'X'.

      Integration
      The TM_DOCUMENTS parameter allows you to specify that the system shouldonly select invoice documents or header data that were created withreference to an external transport management system.
      ENDIF.

      Return messages
      INCLUDE BAPI_RETURN OBJECT DOKU ID TX

      Further information
      The method can only perform its function if no error messages weregenerated in the Return table. This is the case if it waspossible to process the header data and all items without errors.

      Description
      This parameter allows you to specify that the system only selectsinvoice documents or header data that were created in the ERP system,for example with reference to a purchase order or a G/L account.

      Description
      This parameter allows you to specify that the system should only selectinvoice documents or header data that were created with reference to SAPTM.

      Description
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX LANGUAGE EN
      Entry date

      Description
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX LANGUAGE EN
      Document date

      Description
      The table contains the header data for the invoices selected.
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX LANGUAGE EN

      Description
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX LANGUAGE EN
      Entered by external system user

      Description
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX LANGUAGE EN
      Posting date

      Description
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX
      Reference Document Number

      Description
      INCLUDE BAPI_TABLE OBJECT DOKU ID TX LANGUAGE EN

      Value range
      Type,,ID,,Number,,Message
      E,,M8,,530,,No invoice documents were selected
      E,,M8,,381,,List incomplete, as you have no authorization
      Other possible messages
      Messages from other function modules or programs could also appear,such as:
      Type,,ID,,Number,,Message
      A,,B1,,883,,Currency code & has no ISO code
      Default

      Description
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX LANGUAGE EN
      Invoice document status

      Value range
      If no values are transferred for the status of the invoice document, thesystem selects posted documents. These documents have the status ' ','4', or '5'. You can enter the following values for the status of theinvoice document:
      ' ': Posted (Online invoice verification)
      1: Planned for background verification (Background invoiceverification)
      2: Deleted (Background and online invoice verification)
      3: Contains errors (Background invoice verification)
      4: Correct (posted, not complete) (Background invoiceverification)
      5: Posted (Background and online invoice verification)
      A: Parked (Online invoice verification)
      B: Parked complete (Online invoice verification)
      C: Held parked (Online invoice verification)
      D: Held entered (Online invoice verification)
      E: Parked released (Online invoice verification)
      To list all parked documents, for example, table StatusRa mustcontain the following lines:
      SIGN--- OPTION --- LOW --- HIGH
      I---------- EQ ---------- E------- A -----
      I---------- EQ ---------- E------- B -----
      I---------- EQ ---------- E------- E -----

      Description
      INCLUDE BAPI_DATAELEMENT OBJECT DOKU ID TX LANGUAGE EN
      Vendor

1528384MRM_BAPI: Separation of corrections for TM integration
1528385MRM_BAPI: Separation of corrections for TM integration
381593MIRO/MIR7/MIRA: Batch Input is not possible