2122122, 10:27 PM Help! How Do | Set Up Reason Codes? | SAP Blogs °-—-unity Follow Like Blog Post A) RSS Feed Technical Articles Viola Kaiser September 13, 2021 | 6 minute read Help! How Do I Set Up Reason Codes? BO 5 @986 In recent months we have received several requests for support with setting up reason codes for communication with external entities, such as banks, We realize that this is still an issue for our customers. So, we decided why not describe the general process in a blog post? If the description in this post still leaves you with questions, don't hesitate to ask them in the comments, We'll try to address them ina timely fashion Use Reason codes are codes that contain additional information regarding the status ofa payment. You can assign descriptions to internal reason codes and map the external reason codes to internal reason codes. The external reason codes are received from external entities, such as banks. You use reason codes to keep a better overview of the statuses of your payments. This way you can react more quickly if issues arise, such as rejected payments or only partially accepted payments, Your reason codes could look like this’ Status ReasonCode Reason _ Reason Description Acc ACC Credited hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setup-eason-codes! ano2122122, 10:27 PM Like 3 RSS Feed Help! How Do | Set Up Reason Codes? | SAP Blogs G001 Gur Has left go’ Go005 co8 Delivered to ABC bank as gpi Goos GDN Delivered to ABC bank as non-gpi RJCT RUT Rejected In this table the “Status Reason Code” refers to the external reason code, the Reason” to the internal reason code and the “Description” is the description you configured in your back-end system. Corresponding statuses would be accepted, rejected, partially accepted and so on. Prerequisites If you want to work with reason codes, process the following SAP Notes in your back-end system’ + 2793365 - BNK_MONI: GPI Reason Codes + 2827208 - FIN_FSCM_GPI_Reason Codes Correction 1 + 3002631 - CPON BCM: Rejection Reason with Proprietary (Prtry) Node in Pain.002 + 3035754 - CPON BCM: Missing Reason Code Node (Rsn) not Considered in Pain.002 Setting Up Reason Codes Let's look at some examples to determine how to set up reason codes in your back-end system. Use Case 1: Displaying Reason Codes for a Payment Batch Let us assume you have sent a payment batch with four payments. Your payment data looks like this: Fl Document Batch MessageID Payment — Amount Number ‘SHE119000006232020 1894 1001576525 Ol uu EUR hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setup-eason-codes! 2102122122, 10:27 PM Help! How Do | Set Up Reason Codes? | SAP Blogs SHE119000006242020 1894 1001576525 02 98.80 Foll wr Like SHE119000006252020 1894 1001576525 03 107.00 USD A) RSS Feed SHE119000006262020 1894 1001576525 04 55.50 USD In the payment status report (pain.002) from the bank, we can see that two. payments have been accepted and two payments have been rejected, The overall status for the payment batch is PART, which stands for "Partial meaning partially accepted. Additionally, reason code GOOS is assigned in the formation section of the report. This reason code contains status reasor additional information, ~ 1001576525 ‘Pain.004 <2020-10-15T00:07:51 4 -372.41. = ENbOFTK=Perste> ‘2 <ACSC ~ ENBOFTxePerSte> 2 RICT = ‘ 1001576626 <2 <209.94. ‘PART = ‘01-SHE120000006562020- 2000000656 ACSC=/TxSts> ~ = G008 // GPYTEST // PARTIAL/SHAR« < Based on this information, we can now check our maintained reason codes in transaction SM30 with maintenance view V_TBN_RSN_EXT. Here, we see the following: Status ReasonCode — Reason Reason Description hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setup-eason-codes! ano2122122, 10:27 PM Follow x Like A) RSS Feed Help! How Do | Set Up Reason Codes? | SAP Blogs ACSC ACC. Credited Goo1 GLT Has left go! 005 cps Delivered to ABC bank as gpi coos GDN Delivered to ABC bank as non-gpi RJCT RUT Rejected Reason code GO05 has the description “Delivered to ABC bank as gpi” assigned, meaning the payments were delivered to the bank as SWIFT gpi. Since we now received a payment batch with this code, but a different meaning, we'll change the description to match the payment status report and make sure that our back- end system correctly displays the data in transaction BNK_MONI We can check the reason codes for past payments in transaction BNK_MONI in the back-end system or on the SAP Fiori launchpad using the Monitor Payments app depending on the set-up of your SAP system. Option 1: Checking Reason Codes in BNK_MONI Go to transaction BNK_MONI and search for payment batch 1894, It should display “Partially Accepted by Bank" as the status, since these are the details provided in the payment status report from the bank. The batch could look like this in the back-end system: You can also double-click the payment batch to see the details for each payment, The status for the individual payments is either “Accepted by Bank” or “Rejected by Bank" as indicated in the payment status report: Pyente Warmpary Frome oe arom | > Soitpsene presen Otani matt se Going back to the main screen, we can now check the reason codes provided in the report. For this, right-click the payment batch and select “Recent Status Reason Codes”. The next screen displays the recent status reason codes. The reason codes could look like this: hitps:ologs.sap.com2021/08/13Ihelp-how-do--setup-eason-codes! 4n02122122, 10:27 PM Follow Like 3 RSS Feed Help! How Do I Set Up Reason Codes? | SAP Blogs Recent Status Reason Codes (ES) a er) TT) eS =)! () Rstlo steascte statis Ifo Reason Descpton 1 RCT //Mesing Cred Rajectad 1 6003 /ISHAR/ALL ACCOUNTS: 1 GOOS /)GPITEST//PARTIAL/SHAR Delivered to bane bank as gpi TRICT —_ /JAccountnot found Relected hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setp-eason-codes! Option 2: Checking Reason Codes in Monitor Payments Go to the Monitor Payments app and search for payment batch 1894. Double- click the payment batch to display the details. In the details screen you see the overall status of the payment batch, which in this case is “Partially Accepted by Bank”: Baten 31696 Accepted by Bank Below the status is a link to the status reason codes. Select the link to open the overview of the most recent status reason codes. The reason codes could look like this: Partially Accepted by Bank Use Case 2: Add More Information with XSL Transformation Note: Use case 2 is an exceptional use case that is usually not needed by customers. If you still want to make changes such as the ones described, use the description provided. You want to include more information into your payment status reports by leveraging XSL Transformation. This allows you to add more information in the status reason information section of the report. This might come in sn2122122, 10:27 PM Follow x Like A) RSS Feed Help! How Do | Set Up Reason Codes? | SAP Blogs handy especially if you want to include longer descriptions, since the reason code is restricted to only 4 characters. Here's how to set this up. Use the template PAINO02_V3_TO_CPON for adding the status reason information section. The template looks like this: SO PRA EZ Bveousong EET YH teolbay PrettyPmmter Laat Tanfomston [rmanaoa_vazo cron] avo sparen nane=vwelue™ selecr=70%/> tvalas-of select="coneat (ocnogt("'Svaius),*1)%/> ‘eligor-eseh select=t+ [Local name ()='tafientnt')*> ‘ ‘cealiceli-tesplate nane="recuraiver> “cxaltwiek param sane~ovaise” seleste*.0/> ecal-nane )~Ca} ‘cealiceli-tenplate same-"secursive> cixaiscani-vempisce> cenlivacianie naneerueascncedeDreey"> ‘cealsseen.cast*heapontodeCd te ‘To display the status reason info section, you first need to process such files with ‘the connector for SAP Multi-Bank Connectivity. Afterwards you can match the values between the outgoing file and the payment status report and the status reason information section is displayed: hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setp-eason-codes! ano2122122, 10:27 PM Help! How Do | Set Up Reason Codes? | SAP Blogs Follow x Like A) RSS Feed ‘And again, we can check the most recent status reason codes in the BNK_MON! transaction. The reason codes could look like this: Here the column “Status Info” corresponds to the status reason information section in the payment status report The same works on payment item level. Right-click the payment and select “Recent Status Reason Codes”. The reason codes could look like thi Use Case 3: Processing pain.002 files without Status Reason Codes Note: Use case 3 is an exceptional use case that is usually not needed by customers. If you still want to make changes such as the ones described, use the hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setp-eason-codes! 7102122122, 10:27 PM Follow x Like A) RSS Feed Help! How Do | Set Up Reason Codes? | SAP Blogs description provided, You receive a payment status report in which the status reason section is missing and only the additional information section is included. For this, use the XSL transformation template PAINOO2_V3_TO_CPON. After processing the file with the connector for SAP Multi-Bank Connectivity, you can match the values from the outgoing file to the payment status report, in which you can see the status reason information section starting with line 44 Checking the “Recent Status Reason Codes” in BNK_MONI provides reason codes that could look like this: cae fo \Rensen Dasrpton = sing - ACQO1D- Customer reference nat ungue?940000001 405504781 This means that while no status reason codes were provided, the status information provides all the necessary information about the payments, such as whether the payment was rejected, completed or is still being processed. Do you have questions or comments? Don't hesitate to post them in the comments. We'd love to hear from you! Alert Moderator hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setp-eason-codes! ano2122122, 10:27 PM Help! How Do | Set Up Reason Codes? | SAP Blogs Assigned Tags SAP S/ARARIK Cloud {ti-Bank Connectivity SAP alk LE nui tion Management or Finance A) RSS Feed Reason Codes ‘Similar Blog Posts V Flexible Workflow in SAP S/4HANA Sales Scenarios By Alexander Shipiloy Feb 16, 2021 S/4HANA Business Partner - Customer-Vendor Integration By Ajeet Kumar Agarwal Feb 22, 2017 How do | set up the “Test Automation Tool” in SAP S/4HANA Cloud? By Nidhi Choudhary May 27, 2019 Related Que: ns VY CoPilot - developing your own skills? How much can you do with S4HC? By Clare Campbell-Smith Jan 10, 2019 How do | get custom fields in standard reports? By Rahul Shah Oct 14, 2019 Custom Analytical Query - How to change order of filter parameters By Former Member Oct 14, 2019 Join the Conversation V SAP TechEd Tune in for tech talk, Stay for inspiration, Upskill your future. SAP |, = © SAPBTP Learning Group 29" =H SAP Business Technology Platform Learning Journeys. hitps:ologs.sap.com2021/08/13Inelp-how-do-i-setp-eason-codes! sno2122122, 10:27 PM Help! How Do | Set Up Reason Codes? | SAP Blogs + fa, Catioe Comer ~ +5,|\doin the new Coffee Corner Discussion Group. Like 3 RSS Feed Be the first to leave a comment You must be Logged on to comment or reply to a post. Find us on Privacy Terms of Use Legal Disclosure Copyright ‘Trademark Cookie Preferences hitps:ologs.sap.com2021/08/13Ihelp-how-do-i-setp-eason-codes! 10110