SAP Product Technical Documentation

SAP PRODUCT TECHNICAL DOCUMENTATION LEVEL 3 FOR SETTLEMENT

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, LLC 501 Forrestal Road – Suite 324 Princeton, NJ 08540-6641 USA Telephone Number: 1-609-919-0700 Fax 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.

DISCLAIMER...... 2

INTRODUCTION...... 5

SOLUTION OVERVIEW...... 6

SOLUTION MANAGEMENT...... 7

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

INTENDED USERS...... 9

SAP OBJECTS...... 10

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

SAP CONFIGURATION...... 12

SAP STANDARD CONFIGURATION...... 12 MAINTAIN CARD CATEGORIES...... 12 SETTLEMENT CONFIGURATION...... 13 TABLES MAINTAINED VIA TABLE MAINTENANCE (TRANSACTION SM30)...... 14 /PPSCARD/L3CNTL – PPS LEVEL 3 FOR SETTLEMENT CONDITION CONTROL...... 14

PROCESSING LOGIC...... 15

FLOW DIAGRAMS...... 16

SELECTION SCREENS...... 17

ENHANCEMENT POINTS...... 18

Proprietary and Confidential © 2011 Princeton Payment Solutions Page 3 of 28 AVAILABLE ENHANCEMENT POINTS...... 18 1. INCLUDE /PPSCARD/FI10701_SETTLE_EXIT – LOOP AT INTERNAL TABLE T_SETEXD_H...... 18 2. INCLUDE /PPSCARD/FI10701_SETTLE_EXIT – LOOP AT INTERNAL TABLE T_SETEXD_I...... 18 3. INCLUDE /PPSCARD/FI10701_SETTLE_EXIT – LOOP AT INTERNAL TABLE I_KONV18 4. 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...... 26 WARNINGS...... 26 INFORMATION...... 26

ADDITIONAL NOTES...... 27

IMPORTANT NOTES...... 27

APPENDIX...... 28

PURCHASING CARD NUMBER RANGES (VISA AND MASTERCARD)...... 28 CREDIT CARD BIN RANGES (FIRST 6 DIGITS) FOR VISA PURCHASING CARDS...... 28 CREDIT CARD BIN RANGES (FIRST 6 DIGITS) FOR MASTERCARD PURCHASING CARDS...... 28

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.

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.

Versions This 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 PPS Settlement Wrap - FI105.01 01 DM0K900308 Patch 1 - Parent DM0K900131 PPS Level 3 for Settlement - 00 DM0K900210 FI107.01 PPS Level 3 - FI107.01 - Patch 1 - 01 DM0K900292 Parent DM0K900210 PPS Level 3 - FI107.01 - Patch 2 - 02 DM0K900589 Parent DM0K900210

Install Information To 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  Add 4. 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.

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

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 Settlement o /PPSCARD/SD50101_SETTLE_EXIT – Include shell – Not Applicable for this solution o /PPSSEC/TS20101_SETTLE_EXIT – Include shell – Not Applicable for this solution o /PPSCARD/FI41001_SETTLE_EXIT – Include shell – Not Applicable for this solution o /PPSCARD/SD20301UTL_RECON – Include shell – Not Applicable for this solution  Function Groups o /PPSCARD/FI10501 – Settlement Wrapper Function Group  Function Modules o /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 Date o /PPSCARD/CNDTYPE - Condition type o /PPSCARD/DSCAMT - Discount amount o /PPSCARD/DUTYAMT - Duty amount o /PPSCARD/FRTAMT - Freight amount o /PPSCARD/SFPSTCD1 - Ship-from postal code o /PPSCARD/STPSTCD1 - Ship-to postal code o /PPSCARD/UNITCOST - Unit cost  Tables o /PPSCARD/L3CNTL - PPS Level 3 for Settlement Condition Control  Structures o ZPPSCCSETEXD_H - PPS CCSETEXD_H - Append Structure for Level 3 Fields o ZPPSCCSETEXD_I - PPS CCSETEXD_I - Append Structure for Level 3 Fields  Programs o /PPSCARD/FI10701_SETTLE_EXIT – Level 3 for Settlement o ZPPS_FI10701_MOD_EXDH - Enhancement point # 1 - Loop at internal table T_SETEXD_H o 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 Groups

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 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 Categories 4. 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.

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.

/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:

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 code 3. Order Date – Sales order date. 4. Order Discount Amount – Total discount amount computed from the condition records 5. Freight Amount - Freight amount computed from the condition records 6. Duty Amount - Duty amount (Please see Additional Notes section.)

The following fields need to be appended to the end of CCSETEXD_I (after MWSBP): 1. Unit Cost - Item unit cost obtained from the condition records 2. 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.

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

PPS Level 3 for Settlement Solution m a r g

o Call to PPS Settlement r

P Function Module to Send

Response from Function t Settlement to

n Module processed by

e Clearinghouse Settlement Program (Determined by standard m e

l configuration) t t e S

P A S

n o i t c n u

F PPS Settlement PPS Settlement t e

l PPS Settlement Wrapper -

n Exit to include Wrapper - u

e Wrapper - PayWare FI105.01 –

d Level 3 data FI105.01 – RFC

m FI105.01 Processes o Call to PayWare e

l Response M t t e S

S P P

There are no selection screens contained within this solution.

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

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:

No table updates are made within this solution.

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.

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

No authorization checks are available for this solution.

No program texts exist for this solution.

Errors No error messages are contained within this solution.

Warnings No warning messages are contained within this solution.

Information No information messages are contained within this solution.

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.

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