ReadSoft PROCESS DIRECTOR Accounts Payable Ariba Add ...

ReadSoft PROCESS DIRECTOR AccountsPayable Ariba Add-onInstallation and Configuration GuideVersion: 2.0

Date: 2018-11-14

Legal Notice

© 2018 Kofax. All rights reserved.

Kofax is a trademark of Kofax, Inc., registered in the U.S. and/or other countries. All other trademarksare the property of their respective owners. No part of this publication may be reproduced, stored, ortransmitted in any form without the prior written permission of Kofax.

2

Table of ContentsOverview........................................................................................................................................................ 4

About this guide..................................................................................................................................4Prerequisites....................................................................................................................................... 4ReadSoft PROCESS DIRECTOR Ariba Add-on transport................................................................ 5

Importing the transports...........................................................................................................5Licensing............................................................................................................................................. 5

Configuration..................................................................................................................................................6BAdI activation....................................................................................................................................6

BAdI for inbound mapping.......................................................................................................6BAdI for outbound mapping.................................................................................................... 6

Access cXML from User Exits........................................................................................................... 6ReadSoft PROCESS DIRECTOR Ariba Add-on configuration.......................................................... 7

Mandatory configuration.......................................................................................................... 7Optional configuration..............................................................................................................8

Upgrading from 1.0 to 2.0...........................................................................................................................11Appendix A – Mapping................................................................................................................................13

3

Overview

Kofax ReadSoft PROCESS DIRECTOR Accounts Payable™ supports the process of document entryinto SAP. The aim is to facilitate the automatic posting of error-free data records, as well as to supportaccounts payable personnel in the process of identifying and amending documents that contain errors.ReadSoft PROCESS DIRECTOR Accounts Payable is like an invoice entry ledger.

Ariba Network is a cloud-based, business-to-business solution for buying, selling, and managing cash. It istightly integrated with SAP, but also supports other back-end systems.

You can configure the ReadSoft PROCESS DIRECTOR Ariba Add-on to suit the requirements of yourorganization.

For more information on configuring Kofax ReadSoft PROCESS DIRECTOR™ and ReadSoft PROCESSDIRECTOR Accounts Payable, refer to the following guides:• ReadSoft PROCESS DIRECTOR Accounts Payable Configuration Guide• PROCESS DIRECTOR Import Guide• PROCESS DIRECTOR Configuration Guide• WORK CYCLE Configuration Guide• PROCESS DIRECTOR Web Application Configuration Guide

About this guideThis document describes how to configure the ReadSoft PROCESS DIRECTOR Ariba Add-on for the SAPBusiness Suite Integration component for Ariba.

PrerequisitesTo import the ReadSoft PROCESS DIRECTOR Ariba Add-on 2.0 into SAP, ensure that the followingprerequisites are met:• Integration component: Foundation for Ariba version 1.0, SP4 or higher.• OSS Note 2086629 - Reference PayloadID of cXML InvoiceStatusUpdateRequest Message cannot be

determined to be customer specific (included in SP5 or higher).• OSS Note 2088996 - InvoiceStatusUpdateRequest: Invoice status determination for FI invoice (included

in SP5 or higher).• ReadSoft PROCESS DIRECTOR and ReadSoft PROCESS DIRECTOR Accounts Payable 7.5 or

higher.• Using the Ariba integration for ReadSoft PROCESS DIRECTOR with ReadSoft PROCESS DIRECTOR

7.5 (without any SP) requires RSPDN006274, RSPDN006283, and RSPDN1151923.

4

ReadSoft PROCESS DIRECTOR Accounts Payable Ariba Add-on Installation and Configuration Guide

ReadSoft PROCESS DIRECTOR Ariba Add-on transportThe following is the ReadSoft PROCESS DIRECTOR Ariba Add-on transport.

Product Transport Description

Ariba Integration Q76K900129 PROCESS DIRECTOR AP Ariba integration v2.0

Importing the transportsSee the PROCESS DIRECTOR Import and Upgrade Guide for more information on how to import atransport into SAP.

LicensingYou have to order a license to activate the ReadSoft PROCESS DIRECTOR Ariba Add-on. It can be usedonly when a valid license has been activated. The following guides explain how to install licenses.• PROCESS DIRECTOR License Installation Guide• PROCESS DIRECTOR Configuration Guide• PROCESS DIRECTOR Accounts Payable Configuration Guide

5

Configuration

BAdI activationTo use the ReadSoft PROCESS DIRECTOR Ariba Add-onDOCPROPERTY "RS: Product Name (short)",BAdIs need to be activated; one for the inbound mapping and one for the outbound mapping.

BAdI for inbound mappingTo route Ariba documents to ReadSoft PROCESS DIRECTOR Accounts Payable, you need to activatethe inbound mapping BAdI for the SAP Business Suite Integration component for Ariba.

To activate the BAdI for inbound mapping, complete the following steps.1. Go to transaction SPRO > SAP Reference IMG.2. Go to Integration with Other mySAP.com Components > SAP Business Suite Integration

Component for Ariba > Application-Specific Settings > SAP ERP Integration Component forAriba > Business Add-Ins (BAdIs) > BAdI: Inbound Mapping.

3. Activate the Enhancement Implementation with the name, /EBY/CL_RB_INBOUND_MAPPING.

BAdI for outbound mappingTo send status updates of ReadSoft PROCESS DIRECTOR Accounts Payable documents to the AribaNetwork, you need to activate the outbound mapping BAdI for the SAP Business Suite Integrationcomponent for Ariba.

To activate the BAdI for outbound mapping, complete the following steps.1. Go to transaction SPRO > SAP Reference IMG.2. Go to Integration with Other mySAP.com Components > SAP Business Suite Integration

Component for Ariba > Application-Specific Settings > SAP ERP Integration Component forAriba > Business Add-Ins (BAdIs) > BAdI: Outbound Mapping.

3. Activate the Enhancement Implementation with the name, /EBY/CL_RB_OUTBOUND_MAPPING.

Access cXML from User ExitsIn cases where the standard mapping in ReadSoft PROCESS DIRECTOR Accounts Payable is limited,you can use the /EBY/CL_RB_TOOLS=>GET_DCXML method to access the Ariba cXML in the User Exitsthat are called during the data transfer.

The export parameter must be mapped to a variable of the arberp_xinvc_s_cxml type.

6


ExampleDATA: ls_dcxml TYPE arberp_xinvc_s_cxml.

CALL METHOD /eby/cl_rb_tools=>get_dcxml IMPORTING es_dcxml = ls_dcxml.

ReadSoft PROCESS DIRECTOR Ariba Add-on configurationThe IMG for the PROCESS DIRECTOR Ariba Add-on configuration can be accessed through the /EBY/RB transaction.

Mandatory configuration

MappingIn the /EBY/PDBOC transaction (process type, IV – Incoming invoice), a mapping needs to be entered.The default mapping is provided in Appendix A, and the default XML mapping is provided in the transportfile.

Create the environment

In case the RB – ARIBA Integration environment does not exist in SAP, it needs to be created in the /EBY/PDBOC transaction.

To create the RB – ARIBA Integration environment, complete the following steps.1. For the Incoming Invoice object type, go to Default system settings > Model > Environments

and external data models > Environments.2. Enter the following values.

Environment Environment Interactive

RB ARIBA Integration <space>

3. Save the changes.

Create the external data model

If no external data model has been created for the RB – ARIBA Integration environment, a new modelneeds to be created in the /EBY/PDBOC transaction.

To create the new external data model, complete the following steps.1. For the Incoming Invoice object type, go to Default system settings > Model > Environments

and external data models > External data models.2. Enter the following values.

Origin Node ID Parent Logical level

RB DESCRIPTION INVOICE_DETAIL_ITEM_REFERENCE ITEM

7


Origin Node ID Parent Logical level

RB DUE_AMOUNT INVOICE_DETAIL_SUMMARY HEADER

RB INVOICE_DETAIL_ITEM INVOICE_DETAIL_ORDER ITEM

RB INVOICE_DETAIL_ITEM_REFERENCE INVOICE_DETAIL_ITEM ITEM

RB INVOICE_DETAIL_ORDER INVOICE_DETAIL_REQUEST HEADER

RB INVOICE_DETAIL_ORDER_INFO INVOICE_DETAIL_ORDER HEADER

RB INVOICE_DETAIL_REQUEST REQUEST HEADER

RB INVOICE_DETAIL_REQUEST_HEADER INVOICE_DETAIL_REQUEST HEADER

RB INVOICE_DETAIL_SUMMARY INVOICE_DETAIL_REQUEST HEADER

RB MONEY DUE_AMOUNT HEADER

RB MONEY NET_AMOUNT ITEM

RB MONEY SHIPPING_AMOUNT HEADER

RB MONEY SPECIAL_HANDLING_AMOUNT HEADER

RB MONEY SUBTOTAL_AMOUNT HEADER

RB MONEY TAX_AMOUNT TAX

RB NET_AMOUNT INVOICE_DETAIL_ITEM ITEM

RB ORDER_REFERENCE INVOICE_DETAIL_ORDER_INFO HEADER

RB REQUEST HEADER

RB SHIPPING_AMOUNT INVOICE_DETAIL_SUMMARY HEADER

RB SPECIAL_HANDLING_AMOUNT INVOICE_DETAIL_SUMMARY HEADER

RB SUBTOTAL_AMOUNT INVOICE_DETAIL_SUMMARY HEADER

RB TAX INVOICE_DETAIL_SUMMARY TAX

RB TAX_AMOUNT TAX_DETAIL TAX

RB TAX_DETAIL TAX TAX

RB UNIT_OF_MEASURE INVOICE_DETAIL_ITEM ITEM

3. Save the changes.

Optional configuration

Status mappingThe statuses in ReadSoft PROCESS DIRECTOR Accounts Payable need to be mapped to the Aribastatuses. The default mapping is delivered with the ReadSoft PROCESS DIRECTOR Ariba Add-on;however, it can be customized.

To map the statuses, complete the following steps.1. Go to /EBY/RB1.2. Add entries for the ReadSoft PROCESS DIRECTOR statuses or change an existing mapping.

8


Allowed Ariba statuses are processing, approved or reconciled (depending on theAriba version), rejected, and paid.Example

Filter documentsFor the Ariba integration, it is possible to filter incoming documents, which means that only thosedocuments that meet a certain criteria are routed to ReadSoft PROCESS DIRECTOR Accounts Payable.

To filter documents, complete the following steps.1. Go to the /EBY/PDBO_EPC_CHECKS or /EBY/PDBOC transaction, process type IV, and select

Initial settings > process parameters > Checks.2. Search for the process parameter environment, ARIBA integration, Action name, Data Reception,

and click the parameters icon.3. The following parameters can be entered:

Structure: Select the structure that contains the field for the filtering.Internal field name: Select the field name for the filtering.Field value: Enter the value for the filtering criteria.Exclude: If selected, documents with this value will be excluded; otherwise, only the documents thathave this value will be included.

Create imagesFor the Ariba integration, it is possible to generate an image (PDF) from the transferred data.

To generate an image, complete the following configuration steps.1. Go to the /EBY/PDBO_EPC_ARCHIV or /EBY/PDBOC transaction, process type IV, and select

Initial Settings > Process Parameters > Archiving .

9


2. Search for the process parameter environment, ARIBA integration, and click the parameters icon.

3. The following parameters can be entered:FI/MM: FI or MM documentCont.Rep.ID: Content Repository IDArchDocType: Archive document typeForm: /COCKPIT/EDI_FI or /COCKPIT/EDI_MM

10

Upgrading from 1.0 to 2.0

Ariba integration 2.0 for ReadSoft PROCESS DIRECTOR Accounts Payable is not compatible with Aribaintegration 1.0 for ReadSoft PROCESS DIRECTOR Accounts Payable.

Therefore, to upgrade from version 1.0 to 2.0, complete the following steps.1. Import the transport for Ariba integration 2.0 for ReadSoft PROCESS DIRECTOR Accounts Payable.2. Go to transaction SPRO > SAP Reference IMG > Integration with Other mySAP.com

Components > SAP Business Suite Integration Component for Ariba > Application-Specific Settings> SAP ERP Integration Component for Ariba > Business Add-Ins (BAdIs) > BAdI: Inbound Mappingand deactivate the old BAdI.

3. Go to transaction SPRO > SAP Reference IMG Integration with Other mySAP.comComponents > SAP Business Suite Integration Component for Ariba > Application-SpecificSettings > SAP ERP Integration Component for Ariba > Business Add-Ins (BAdIs) > BAdI:Outbound Mapping and deactivate the old BAdI..

4. Run the /EBY/RB_MIGRATION report.

11


This report migrates the data from the Ariba integration 1.0 tables to the Ariba integration 2.0 tables.5. Perform the steps described in the configuration section.

12

Appendix A – Mapping

Origin MappingID

Node ID Parent Logicallevel

Field name

External Mapping

RB ARIBA DESCRIPTIONINVOICE_DETAIL_ITEM_REFERENCE

ITEM ITEM_TEXT CONTENT N/A

RB ARIBA INVOICE_DETAIL_ITEM

INVOICE_DETAIL_ORDER

HEADER INVOICE_ITEM

INVOICE_LINE_NUMBER

RB ARIBA INVOICE_DETAIL_ITEM

INVOICE_DETAIL_ORDER

HEADER QUANTITY QUANTITY RB_TO_POS

RB ARIBA INVOICE_DETAIL_REQUEST

REQUEST HEADER ORIGIN RBORIGIN

RB ARIBA INVOICE_DETAIL_REQUEST_HEADER

INVOICE_DETAIL_REQUEST

HEADER DOC_DATE INVOICE_DATE

RBDOCDATE



HEADER INVOICE_IND

PURPOSE RBINVIND



HEADER REF_DOC_NO

INVOICE_ID

RB ARIBA MONEY DUE_AMOUNT HEADER CURRENCY CURRENCY

RB ARIBA MONEY DUE_AMOUNT HEADER GROSS_AMOUNT

CONTENT RB_TO_POS

RB ARIBA MONEY NET_AMOUNT ITEM ITEM_AMOUNT

CONTENT RB_TO_POS

RB ARIBA MONEY SHIPPING_AMOUNT

HEADER FREIGHT_AMOUNT

CONTENT

RB ARIBA MONEY SPECIAL_HANDLING_AMOUNT

HEADER PACKAGE_AMOUNT

CONTENT

RB ARIBA MONEY SUBTOTAL_AMOUNT

HEADER NET_AMOUNT

RB_TO_POS

13


Origin MappingID

Node ID Parent Logicallevel

Field name

External Mapping

RB ARIBA MONEY TAX_AMOUNT TAX TAX_AMOUNT

RB_TO_POS

RB ARIBA ORDER_REFERENCE

INVOICE_DETAIL_ORDER_INFO

HEADER PO_NUMBER

RB ARIBA TAX_AMOUNT

TAX_DETAIL TAX TAX_RATE

RB ARIBA UNIT_OF_MEASURE

INVOICE_DETAIL_ITEM

ITEM PO_UNIT_ISO

14

ReadSoft PROCESS DIRECTOR Accounts Payable Ariba Add ...

Documents

Transcript of ReadSoft PROCESS DIRECTOR Accounts Payable Ariba Add ...