TITLE PAGE - Princeton Payment Solutions Level 3.doc · Web viewSAP Product Technical Documentation Level 3 for Settlement Disclaimer PPS Level 3 for Settlement Solution is a product

SAP PRODUCT TECHNICAL DOCUMENTATIONLEVEL 3 FOR SETTLEMENT

Proprietary and Confidential © 2011 Princeton Payment Solutions Page 1 of 28

Disclaimer

PPS Level 3 for Settlement Solution is a product of Princeton Payment Solutions (PPS).

All other product and company names mentioned are the trademarks of their respective owners.

This publication is for information purposes only and its content does not represent a contract in any form. Princeton Payments Solutions reserves the right to alter product documentation and specifications without notice.

If you have any queries about this publication or the product it describes, or if you require any additional copies, contact Princeton Payment Solutions at:

Address: Princeton Payment Solutions, LLC501 Forrestal Road – Suite 324Princeton, NJ 08540-6641USATelephone Number: 1-609-919-0700Fax Number: 1-609-720-1188

Copyright © August 2010, Princeton Payment Solutions, LLC. All rights reserved, including those to reproduce this publication or parts thereof in any form without permission in writing from Princeton Payment Solutions.


Contents

DISCLAIMER..............................................................................2

INTRODUCTION..........................................................................5

SOLUTION OVERVIEW................................................................6

SOLUTION MANAGEMENT...........................................................7

VERSIONS....................................................................................7INSTALL INFORMATION....................................................................7

INTENDED USERS......................................................................9

SAP OBJECTS...........................................................................10

SETTLEMENT WRAPPER..................................................................10WORKBENCH OBJECTS..........................................................................10SAP MODIFICATIONS............................................................................10

LEVEL 3 FOR SETTLEMENT..............................................................10WORKBENCH OBJECTS..........................................................................10SAP MODIFICATIONS............................................................................11

SAP CONFIGURATION...............................................................12

SAP STANDARD CONFIGURATION.....................................................12MAINTAIN CARD CATEGORIES................................................................12SETTLEMENT CONFIGURATION................................................................13

TABLES MAINTAINED VIA TABLE MAINTENANCE (TRANSACTION SM30).......14/PPSCARD/L3CNTL – PPS LEVEL 3 FOR SETTLEMENT CONDITION CONTROL14

PROCESSING LOGIC.................................................................15

FLOW DIAGRAMS.....................................................................16

SELECTION SCREENS................................................................17

ENHANCEMENT POINTS............................................................18


AVAILABLE ENHANCEMENT POINTS....................................................181. INCLUDE /PPSCARD/FI10701_SETTLE_EXIT – LOOP AT INTERNAL TABLE T_SETEXD_H...................................................................................182. INCLUDE /PPSCARD/FI10701_SETTLE_EXIT – LOOP AT INTERNAL TABLE T_SETEXD_I.....................................................................................183. INCLUDE /PPSCARD/FI10701_SETTLE_EXIT – LOOP AT INTERNAL TABLE I_KONV............................................................................................184. INCLUDE /PPSCARD/FI10701_SETTLE_EXIT – INITIAL LOOP AT INTERNAL TABLE T_SETEXD_H...........................................................................18

ACTIVATING ENHANCEMENT POINTS..................................................18

TABLE UPDATES......................................................................21

RESULTS SCREENS...................................................................22

OUTPUT STRUCTURES....................................................................22

AUTHORIZATIONS....................................................................24

PROGRAM TEXTS.....................................................................25

MESSAGES..............................................................................26

ERRORS....................................................................................26WARNINGS.................................................................................26INFORMATION.............................................................................26

ADDITIONAL NOTES.................................................................27

IMPORTANT NOTES.......................................................................27

APPENDIX...............................................................................28

PURCHASING CARD NUMBER RANGES (VISA AND MASTERCARD)...........28CREDIT CARD BIN RANGES (FIRST 6 DIGITS) FOR VISA PURCHASING CARDS. . . .28Credit card bin ranges (first 6 digits) for MasterCard Purchasing cards...............................................................................................28


Introduction

Princeton Payment Solutions (PPS) is a leading provider of middleware, encryption/tokenization, and SAP enhancements for A/R payment card use. Our products include Payware for SAP certified payment card enablement, CardSecure and TokenSecure for PCI-DSS compliant encryption and tokenization of payment cards and other personal data, CardDeposit for deposit reconciliation, CardClear for invoice payment using a payment card, and CardSolutions. CardSolutions provides a wealth of reports and utilities to enhance and facilitate payment card implementation in any SAP environment.

Level 3 for Settlement is a CardSolution available through PPS.


Solution Overview

During the Settlement Process, select information needs to be sent to clearinghouse for Purchase cards, which are usually for government and large corporations. This extra data needed is called Level 3, or Line Item Detail.

Unfortunately, the SAP settlement structures fall short in supplying all the necessary data required by the clearinghouse. Although these structures are sufficient to provide Level 2 data for Corporate and Business cards, and much of the Level 3 data, some required Level 3 fields are missing. Thus, the experts at PPS have developed the solution PPS Level 3 for Settlement.

Our solution ensures that all the necessary fields required for purchasing card transactions are sent from SAP to the clearinghouse. Including these fields benefits your company with lower fees charged by the clearinghouse for Purchase Card transactions.


Solution Management

VersionsThis document is valid for the following versions of the listed PPS product or solution:

ID Product/Solution Namespace

FI105.01 Settlement Wrapper /PPSCARD/

FI107.01 PPS Level 3 for Settlement /PPSCARD/

The following levels are available for this product version:

Level Change Request Description

00 DM0K900131 PPS Settlement Wrapper - FI105.01

01 DM0K900308 PPS Settlement Wrap - FI105.01 Patch 1 - Parent DM0K900131

00 DM0K900210 PPS Level 3 for Settlement - FI107.01

01 DM0K900292 PPS Level 3 - FI107.01 - Patch 1 - Parent DM0K900210

02 DM0K900589 PPS Level 3 - FI107.01 - Patch 2 - Parent DM0K900210

Install InformationTo install this solution on your system, please follow these steps:1. Add the PPS supplied transport files to the necessary SAP transport

directories. Reminder: K* files go to the COFILES directory. R* files go to the DATA directory. In a non-Windows environment, FTP the files to the necessary directories using ASCII for the COFILE and Binary for the DATA file.

2. Within SAP, go to your target system transport queue.3. Go to Extras Other Requests Add4. Enter the transport number given above. Add each of the transports to the

transport queue in the order listed top to bottom within this section. Omit any transports not included in your install package.

Important: import the requests in the level order given above. Start with level 00 and progress ascending level by level in the list for those transports with multiple levels.

5. Select the transports just added and import to the target system with options to overwrite originals.


6. After successful import of the solution, follow the steps within the configuration section in order to correctly configure your PPS solution.

If there are any issues or questions with the installation of your PPS solution, please contact us at 609-919-0700.


Intended Users

This solution is designed to be used by those who are responsible for the settlement processes within SAP.


SAP Objects

The following objects are included within the solution:

Settlement Wrapper

Workbench Objects Programs

o /PPSCARD/FI10201_SETTLE_EXIT – Include shell – Not Applicable for this solution o /PPSCARD/FI10701_SETTLE_EXIT – Include shell – Level 3 for Settlemento /PPSCARD/SD50101_SETTLE_EXIT – Include shell – Not Applicable for this solutiono /PPSSEC/TS20101_SETTLE_EXIT – Include shell – Not Applicable for this solutiono /PPSCARD/FI41001_SETTLE_EXIT – Include shell – Not Applicable for this solutiono /PPSCARD/SD20301UTL_RECON – Include shell – Not Applicable for this solution

Function Groupso /PPSCARD/FI10501 – Settlement Wrapper Function Group

Function Moduleso /PPSCARD/FI10501_SETTLEMENT – PPS Settlement Wrapper

SAP Modifications No SAP modifications are necessary for this solution.

Level 3 for Settlement

Workbench Objects Data Elements

o /PPSCARD/AUDAT - Document Dateo /PPSCARD/CNDTYPE - Condition typeo /PPSCARD/DSCAMT - Discount amounto /PPSCARD/DUTYAMT - Duty amounto /PPSCARD/FRTAMT - Freight amounto /PPSCARD/SFPSTCD1 - Ship-from postal codeo /PPSCARD/STPSTCD1 - Ship-to postal codeo /PPSCARD/UNITCOST - Unit cost

Tableso /PPSCARD/L3CNTL - PPS Level 3 for Settlement Condition Control

Structureso ZPPSCCSETEXD_H - PPS CCSETEXD_H - Append Structure for Level 3 Fieldso ZPPSCCSETEXD_I - PPS CCSETEXD_I - Append Structure for Level 3 Fields

Programso /PPSCARD/FI10701_SETTLE_EXIT – Level 3 for Settlemento ZPPS_FI10701_MOD_EXDH - Enhancement point # 1 - Loop at internal table

T_SETEXD_Ho ZPPS_FI10701_MOD_EXDI - Enhancement point # 2 - Loop at internal table

T_SETEXD_I o ZPPS_FI10701_MOD_COND - Enhancement point # 3 - Loop at internal table

I_KONV


o ZPPS_FI10701_FILL_L3T - Enhancement point # 4 – Initial loop at internal table T_SETEXD_H to fill Level 3 internal table I_LEVEL3_INFO

Function Groupso /PPSCARD/L3CNTL - /PPSCARD/L3CNTL Maintenance Screen

SAP Modifications Structure CCSETEXD_H – Settlement Header Structure for Additional Data

o ZPPSCCSETEXD_H appended to the end of the structure for level 3 fields Structure CCSETEXD_I – Settlement Item Structure for Additional Data

o ZPPSCCSETEXD_I appended to the end of the structure for level 3 fields


SAP Configuration

SAP Standard Configuration

Maintain Card Categories (Please see Additional Notes before proceeding)

1. Go to transaction SPRO.2. Follow the path:

Sales and Distribution Billing Payment Cards Maintain Card Categories

3. Choose Define Card Categories4. Review the entries. If no proper entry exists for Purchasing Cards or you

need to create a new entry, click on New Entries.

5. Define a proper card category for Purchasing Cards. Check the boxes: One card per trans. and Additional data.

6. Save your entry and go back to the following screen.

7. Choose Determine Card Categories.


8. Click on New Entries.

9. Assign the proper Card Type, Sequence Number, and Purchasing Card category defined in the previous steps.

10. Click on the green check box on Limit. 11. Define the number ranges for the Purchase Card ranges in the Appendix.

12. Repeat the process for each range.13. Save your entries.

Settlement Configuration

1. Go to transaction SPRO.2. Follow the path:

Sales and Distribution Billing Payment Cards Authorization and Settlement Maintain Clearinghouse Set Authorization/Settlement Control Per Account

3. Choose an active line within the configuration screen and click Details.

4. Enter the following information as viewed in the screen. * Please note, your screen image or texts may differ depending on your version of SAP and configuration, but the field names will be the same.


Tables Maintained via Table Maintenance (Transaction SM30)

/PPSCARD/L3CNTL – PPS Level 3 for Settlement Condition Control

This configuration is used to indicate which condition types will be used to calculate the required values for Level 3: Unit Cost, Discounts, and Freight/Handling.

Please enter your relevant condition types into the table as shown in the screen shot below to configure this table:


Processing Logic

SAP configuration of the Payment Card Category determines if additional data is to be sent along with the Settlement. If the configuration indicates to include Additional Data, structures CCSETEXD_H (provides additional order level data) and CCSETEXD_I (provides item level data) are filled and included within the Settlement Process and data to be sent to the clearinghouse.

The information SAP fills in the two structures suffice for Level 2 requirements. However, Level 3 needs additional information to be included. Therefore, the following fields need to be appended to the end of CCSETEXD_H (after TAXJ4):1. Ship-To Postal Code - One Ship-To Postal Code is needed for the entire

order. (Purchase card order items are required to be restricted to a single Ship-To.)

2. Ship-From Postal Code – Shipping location postal code3. Order Date – Sales order date.4. Order Discount Amount – Total discount amount computed from the

condition records5. Freight Amount - Freight amount computed from the condition records6. Duty Amount - Duty amount (Please see Additional Notes section.)

The following fields need to be appended to the end of CCSETEXD_I (afterMWSBP):1. Unit Cost - Item unit cost obtained from the condition records2. Discount Amount - Item discount amount obtained from the condition

records

*** Please note – The fields above are determined from the standard solution. Custom work may need to be done to accurately represent the necessary fields based on your business. PPS includes Enhancement Points and append structures customer name space. After working with your team, PPS can then make local modifications of these objects on your system to account for your special needs.

Level 3 applies specifically to Purchase cards, which can be identified by the card range (see Appendix). The solution relies on the SAP configuration of the proper assignment of card category to the number ranges defined in this document. If the configuration indicates to include additional data and the structures are filled from standard SAP. Assignment of the PPS Settlement Function Module within the configuration will enable the PPS Level 3 for Settlement to fill the remaining Level 3 fields required. Once done, the settlement is sent to PayWare and continues with standard SAP settlement processing.


Flow Diagrams

The following is the flow diagram for the PPS Level 3 for Settlement.


Selection Screens

There are no selection screens contained within this solution.


Enhancement Points

There are # enhancement points available within the PPS Level 3 for Settlement solution to enable customizing the solution for a customer much easier and not require additional transports from PPS. As well, similar to SAP Modifications within user exits, our enhancement points will not be overwritten after initial delivery of the solution.

Available Enhancement Points

1. Include /PPSCARD/FI10701_SETTLE_EXIT – Loop at internal table T_SETEXD_H* PPS Enhancement Point # 1 include zpps_fi10701_mod_exdh.This include may be used to add, modify, or delete information within the settlement header internal table.

*** Please note: Duty Amount is not determined by the PPS Solution. If Duty Amount is necessary due to the type of transactions, you must modify this enhancement point to include the specific Duty Amount to include within the Settlement.

2. Include /PPSCARD/FI10701_SETTLE_EXIT – Loop at internal table T_SETEXD_I* PPS Enhancement Point # 2 include zpps_fi10701_mod_exdi. This include may be used to add, modify, or delete information within the settlement item internal table.

3. Include /PPSCARD/FI10701_SETTLE_EXIT – Loop at internal table I_KONV * PPS Enhancement Point # 3 include zpps_fi10701_mod_cond. This include may be used to add, modify, or delete information during the loop of condition records.

4. Include /PPSCARD/FI10701_SETTLE_EXIT – Initial loop at internal table T_SETEXD_H

* PPS Enhancement Point # 4 include zpps_fi10701_fill_l3t. This include may be used to select or limit records to be entered into the Level 3 internal storage table that will be used for processing within the solution.

Activating Enhancement Points

To make the Enhancement Points available to use, you must add the ZPPS Development Package (Class) to your system.


To do this, you will need to follow these instructions:1. Go to transaction STMS

2. Click on button Transport Routes

3. Follow the path:Environment Packages

4. Click on button Create Package

5. Enter the following information in the screen as shown:

For Transport Layer, enter your transport layer that is applicable to your company.


6. Assign change to a transport.

7. Ensure the settings are as follows:

8. Click Save


Table Updates

No table updates are made within this solution.


Results Screens

Output Structures

There are no result screens visible to the user.

Output structures T_SETEXD_H and T_SETEXD_I are filled when additional data is required as per the SAP configuration.

Validation of the results must be done within PayWare and with the coordination of PPS.


External Connection Types and Details

For the entire settlement process, you must have a connection to the Payment Process Interface middleware in order to process the settlements.


Authorizations

No authorization checks are available for this solution.


Program Texts

No program texts exist for this solution.


Messages

ErrorsNo error messages are contained within this solution.

WarningsNo warning messages are contained within this solution.

InformationNo information messages are contained within this solution.


Additional Notes

Important Notes

PPS recommends setting the Additional Data Flag for all Visa and MasterCard card categories. This does not apply to American Express, Discover, and other card types. This ensures all Visa and MasterCard will send Level 2 data to the clearinghouse and avoids having to configure the exact purchase card number ranges defined in the Appendix. If you have questions on this, please contact PPS.

Duty Amount is not calculated within this solution. It is defaulted to $0. If Duty Amount needs to be included within the Settlement Data, please use an Enhancement Point available within this solution to correctly calculate the Duty value and include that within the Settlement header structure. If you have questions on this, please contact PPS.


Appendix

Purchasing Card Number Ranges (VISA and MASTERCARD)

Credit card bin ranges (first 6 digits) for Visa Purchasing cards 405501-405504 405550-405554 415928 424604-424605 427533 428800-428899 443085 448400-448699 471500-471699

Credit card bin ranges (first 6 digits) for MasterCard Purchasing cards 540500-540599 555000-556999


Documents

TITLE PAGE - Princeton Payment Solutions Level 3.doc · Web viewSAP Product Technical Documentation Level 3 for Settlement Disclaimer PPS Level 3 for Settlement Solution is a product