SAP Configuration

This setting determines if your project connects to SAP. In order for this to work, you must be using SAP version 4.6c or newer.

Important These settings are not available in the Azure cloud environment.

Important The settings at the top of the form that are related to the connection to your SAP system are applied immediately. This ensure that a change in password or IP address of the server does not cause problems with documents that are already in-progress.

All other settings are applied to new documents only. Documents that are already in-progress use the settings that were in-place when their processing began.

Depending on the settings selected below, different settings become available.

Connect To SAP

If selected, Kofax AP Agility connects to SAP.

This setting is cleared by default.

Application Server

The name or IP address of the SAP application server. Use this setting when connecting to the application server only, and not the message server.

This setting is available only when the Connect To SAP setting is selected above.

System Number

The two digit SAP system number for connections to the application server. Use this setting when connecting to the application server only, and not the message server.

This setting is available only when the Connect To SAP setting is selected above.

Language

The two character language code for the SAP logon language.

This setting is available only when the Connect To SAP setting is selected above.

Client

The three-digit SAP client number.

This setting is available only when the Connect To SAP setting is selected above.

Message Server

The SAP message server. Use this setting when connecting to the message server only, and not the application server.

This setting is available only when the Connect To SAP setting is selected above.

Group Name

The SAP group name. Use this setting when connecting to the message server only, and not the application server.

This setting is available only when the Connect To SAP setting is selected above.

System Name

The three-character SAP system name.

This setting is available only when the Connect To SAP setting is selected above.

SAP Router

The SAP router web path.

This setting is available only when the Connect To SAP setting is selected above.

User

The SAP logon user name. This can be set within the project file for additional security.

This setting is available only when the Connect To SAP setting is selected above.

Password

The SAP logon user password. You can set this via the SetSAPPassword user exit.

Alternatively, leave this field blank and supply an encrypted password in the Encrypted SAP Password setting below.

This setting is available only when the Connect To SAP setting is selected above.

Use SNC

If selected, several other SNC settings available to configure SNC.

SNC SSO

If selected, SSO is used for SNC.

This setting is available only when the Use SNC setting is selected above.

SNC Library Path

Enter a value that reference a 64-bit library. The referenced DLL must be located in this path on all servers that host the Kofax TotalAgility Core Worker, Transformation Server, or the web server.

If this setting is left blank, the path is taken from the %SNC_LIB% environment variable.

This setting is available only when the Use SNC setting is selected above.

SNC My Name

Enter the name for your SNC connection. This setting is optional.

This setting is available only when the Use SNC setting is selected above.

SNC Partner Name

Enter a partner name for SNC. This setting is mandatory.

This setting is available only when the Use SNC setting is selected above.

SNC Quality of Service

Select one of the following values from the list.

  • Authentication only.

  • Authentication and integration protection.

  • Authentication, integrity protection, and privacy protection (encryption).

  • Default value defined by back-end system. This is the default value for this setting.

  • Maximum value that the current security product supports.

This setting is available only when the Use SNC setting is selected above.

PO Lookup

The name of the SAP BAPI/RFC-enabled function module used to lookup the purchase order. The interface of the function should match the BAPI_PO_GETDETAIL call.

This setting is available only when the Connect To SAP setting is selected above.

Invoice Post

The name of the SAP BAPI/RFC-enabled function module used to post an invoice. The interface of the function should match the BAPI_INCOMINGINVOICE_CREATE call.

This setting is available only when the Connect To SAP setting is selected above.

FB60 Invoice Park

The name of the SAP BAPI/RFC-enabled function module used to park an FI invoice via FB60/FV60. The interface of the function should match the BAPI_INCOMINGINVOICE_PARK call.

This setting is available only when the Connect To SAP setting is selected above.

Invoice Park

The name of the SAP BAPI/RCF-enabled function module used to park an invoice. The interface of the function should match the BAPI_INCOMINGINVOICE_PARK call.

This setting is available only when the Connect To SAP setting is selected above.

Company Lookup

The name of the SAP BAPI/RFC-enabled function module used to lookup the purchase order. The interface of the function should match the BAPI_COMPANYCODE_GETDETAIL call.

This setting is available only when the Connect To SAP setting is selected above.

Entry Sheet Lookup

The name of the SAP BAPI/RFC-enabled function module used to lookup the service entry sheet for SR-IV purchase orders. The interface of the function should match the BAPI_ENTRYSHEET_GETDETAIL call.

This setting is available only when the Connect To SAP setting is selected above.

RFC Read Table Function

The name of the SAP RFC-enabled function that is used to perform SAP lookups. This should have the same interface as the RFC_READ_TABLE call. If no function is specified, RFC_READ_TABLE is used by default.

This setting is available only when the Connect To SAP setting is selected above.

Create SAP Documents

If selected, an SAP document is created during export. The system default is to try and post the invoice in SAP.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

Log SAP Export

If selected, tracking statements are added to the log file. These entries show data that passes to and from calls to the SAP document posting and parking BAPIs.

This setting is available only when the Connect To SAP setting is selected above.

This setting is selected by default.

Always Park Invoice

If selected, the system will always parks the invoice in SAP and never attempts a post.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

Park Invoice

If selected, parked invoices can be created in the event where a posted MM document cannot be created.

This setting is available only when the Connect To SAP setting is selected above.

This setting is selected by default.

Park With Lines

If selected, parked invoices are created with line item information found during the line pairing operation.

This setting is available only when the Connect To SAP setting is selected above.

This setting is selected by default.

Always Park FI

If selected, non-purchase order invoices (FI) are always parked.

This setting is available only when the Connect To SAP setting is selected above.

This setting is selected by default.

Park FI To FB60

If selected, documents are parked to FB60 using the custom BAPI_PO_GETDETAIL SAP function.

This setting is available only when the Connect To SAP setting is selected above.

This setting is selected by default.

Park MM If Downpayment

If selected, the system parks an MM invoice if the vendor has a down payment against it.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

MM Invoice Doc Type

The SAP document type for MM invoices, such as RE or RN.

This setting is available only when the Connect To SAP setting is selected above.

The value for this setting is set to RE by default.

FI Invoice Doc Type

The SAP document type for FI invoices, such as KR.

This setting is available only when the Connect To SAP setting is selected above.

The value for this setting is set to KR by default.

MM Credit Doc Type

The SAP document type for MM credit memos, such as RE or RN.

This setting is available only when the Connect To SAP setting is selected above.

The value for this setting is set to RE by default.

FI Credit Doc Type

The SAP document type for FI credit memos, such as KG.

This setting is available only when the Connect To SAP setting is selected above.

The value for this setting is set to KG by default.

Activate SAP Failure User Exit

If selected and the solution export involves creating a document in SAP, the export fails automatically if no SAP document is created beforehand.

The SAPPostingFailure user exit is available for a developer to create their own alternative export if the SAP posting/parking fails without sending the document to a failed export status.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

Read Entry Sheet

If selected, the system reads the service entry sheet details from SAP.

Important This setting must be selected if the implementation involves SR-IV purchase orders, or there are multiple account assignments on non SR-IV purchase orders.

This setting is available only when the Connect To SAP setting is selected above.

This setting is selected by default.

Valid Fiscal Markup Conditions

A comma-separated list of valid SAP condition types that indicate a fiscal markup. If the system books an invoice line to a purchase order line that has a condition in this list behind it, the system creates two invoice lines. For these lines, the amount is pro-rated based on the condition value, in relation to the total order value of the purchase order line.

This setting is available only when the Connect To SAP setting is selected above.

Create Link To External Archive

If selected, the link to the image in an external third-party archive is added as an attachment to a posted or parked invoice.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

Destination Archive

The SAP archive or content repository ID as displayed in SAP transaction OAC0. This represents the archive where the image resides in an early archiving scenario, or the image that needs archived in a late archiving scenario.

If the archive ID varies dramatically depending on the document, rather than processing that document, the destination archive ID is mapped from the image filename via the Settings > Invoice Processing > Global Settings > Import Settings.

If a destination archive retrieved from the filename can be obtained through the mapping in the Settings > Invoice Processing > Global Settings > Import Settings, it overrides this setting.

This setting is available only when the Connect To SAP setting is selected above.

Archive Via SAP

Select this in a late archiving scenario where Kofax AP Agility is responsible for placing the image into an archive via SAP. The following prerequisite is mandatory.

  • The archiving function is installed on the client SAP system.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

Archive As PDF

If selected, the system archives a document as a PDF, regardless of the original document file type.

This setting is available only when the Connect To SAP and Archive Via SAP settings are selected above.

This setting is cleared by default.

SAP Archiving Function

The name of the SAP RFC enabled function module provided by Kofax AP Agility. It is used to archive the image into the destination archive. This is used in the late archiving scenario.

This setting is available only when the Connect To SAP and Archive Via SAP settings are selected above.

Activate SAP Archiving User Exit

If selected, the system runs the code in the SAPArchiving user exit in order to archive the image via SAP, instead of the standard system function.

A destination archive is needed for this to occur, either derived from the filename mapping in the Settings > Invoice Processing > Global Settings > Import Settings, or the value in the Destination Archive setting above.

The Archive As PDF and SAP Archiving Function settings above do not apply if the user exit is being used.

This setting is available only when the Connect To SAP and Archive Via SAP settings are selected above.

This setting is cleared by default.

MM Invoice Object

The SAP workflow document type that is used for MM invoices when creating an invoice attachment.

The value for this setting is set to MMILOGINV by default.

This setting is available only when the Connect To SAP setting is selected above.

MM Credit Object

The SAP workflow document type used for MM invoices when creating an invoice attachment.

The value for this setting is set to MMILOGCRD by default.

This setting is available only when the Connect To SAP setting is selected above.

FI Invoice Object

The SAP workflow document type used for FI invoices when creating an invoice attachment.

The value for this setting is set to FIINVOICE by default.

This setting is available only when the Connect To SAP setting is selected above.

FI Credit Object

The SAP workflow document type used for FI invoices when creating an invoice attachment.

The value for this setting is set to FICREDIT by default.

This setting is available only when the Connect To SAP setting is selected above.

Always Send Withholding Tax

If selected, withholding tax information is always be sent to SAP via the BAPI call at the time or export, regardless if a withholding tax amount has been captured from the document. If more than one active withholding tax code exists on the vendor master, the document is parked.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

Convert WBS Elements

If selected, the system converts the external WBS element retrieved from the lookup, to the purchase order account assignment in SAP, to the internal WBS element required for invoice posting.

The call to SAP uses the RFC_READ_TABLE BAPI call, although this can be changed using the RFC Read Table Function setting above. This parameter is called once per WBS element that needs converted. Hence, for an invoice with multiple account assignments with multiple WBS elements, it will be called once per WBS element.

This setting is available only when the Connect To SAP setting is selected above.

This setting is cleared by default.

Downpayment SGL Codes

This is a list of the single character SAP special general ledger indicators that are used to denote a down-payment. The list does not need to be separated by any special characters.

The value for this setting is set to A by default.

This setting is available only when the Connect To SAP setting is selected above.

The following buttons are available at the bottom of the window.

Save

Saves your changes and the window is closed.

Reload

Deletes any unsaved changes and resets the field values back to the last saved settings.

Test

Uses the values entered above to test your SAP connection.

For successful connections, a Test Passed window indicates if the connection is successful.

If there are any issues with the connection, a Connection Failed message with further details is displayed.