twoarte Document 13497521 Statement Generation Program (ARXSGP): Over 1349752.1) w, Setup and Troubleshooting (Doc ID In this Document Details 1. Overview of Statement Generation 2. Setup Requirements for Statement Printing a, Statement Cycles b. Standard messages cc. Statement Aging buckets d. Finance Charge Receivable Activity e. Customer Profile Classes f. Customers g. Defining a Statement Site h. Profile Option: AR: Use Statement Site & Dunning Site 3. Print Statements Form 4. Multi-Language (or Multi-Lingual) Support (MLS) for Statements. Finan char¢ nly for Rel Ai. 6. Process Flow for Statement Generation 7. Debugging Statement Generation 8 Sample Output 9, Diagnostics 10. Troubleshooting Tips. 11. Known bugs/issues 12, Community Discussions 13, Feedback References Oracle Receivables - Version 11.5.10.0 and later Information in this document applies to any platform. ve Checked for Relevance 02-Jan-2014 *** Form: ARXSUPST.FMB - Print Statements Report: ARXSGPO.RDF - Print Statements Executable: ARXSGP - Statement Generation Program Oracle Receivables (AR): Transactions Workbench Information Center > Note 1349752.1 hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adctwoarte Document 13497521 This document provides an overview of the Statement Generation Process in Release 11.5 and Release 12.0. It contains information on the various components that make up the Statement Printing process, including setup requirements, how to run statements and sample output. For Known Issues, Patches and Enhancement Requests on the Statement Generation process, please review Note 1352529,1 1. Overview of Statement Generation In Oracle Receivables, itis important to have the ability to provide information to your customers on their outstanding balance and transaction/receipt activity on a regular basis. The Statement is a document which you can send to your customers to give them a current status of their account. ‘Statement Generation in Oracle Receivables is comprised of multiple processes: 1, ARXSUPST.fmb Note: This is the only supported way of running the Statement Generation process. You should not run Statement Generation directly from the SRS. This is the Print Statements form you access via Responsibility: Receivables Manager Navigation: Print > Documents > Statements Through this form you can specify whether you want to print for: = a Statement Cycle = a Customer Name/Number Range = a Customer Site 2, ARXSGP This executable handles the actual gathering of information/data to print in a statement. This process is coded in Pro*C and comprises of multiple c code files which make up the executable $AR_TOP/bin/ARXSGP. This executable is invoked only through the Print Statements form above. ‘This process takes care of populating the following interim tables: = AR_STATEMENT_HEADERS = AR_STATEMENT_LINE_CLUSTERS = AR_STATEMENTS_HISTORY After the statement printing is completed, the AR_STATEMENT_HEADERS and ‘AR_STATEMENT_LINE_CLUSTERS tables are deleted (Unless you have enabled debugging as detailed in Note 436733.1 Statements: How to Enable Debugging for Statement IMPORTANT NOTES: Finance Charges Release 11.5: The calculation of finance charges was possible only via the Statement or Dunning Process. If in the Print Statements form, you clicked on the checkbox Calculate Finance Charges, the executable would then invoke the process to calculate finance charges for overdue transactions. Release 12.0: The calculation of finance charges module was replaced by Late Charges. This process is no longer linked to Statements or Dunning, and can be called on its own via hhip/iuppart oracle. comlepmesifacesiDocumentDigply? adctwoarte Document 13497521 Responsibility: Receivables Manager Navigation: Late Charges > Generate Late Charges For more information on Late Charges, please review Note 1269062.1, Late Charges Calculation and Set Up: A Guide for Oracle Receivables Users Output Format Release 11.5: the seeded output of the Statement Generation process is in TEXT. Release 12.0.4: From this release, the process was enhanced to incorporate output in PDF format for European localizations. This output is called the Customer Balance Statement Letter. For more information on this change in behavior, please review Note 565507.1 Release 12 Issues in Statement Printing and AR Customer Balance Statement Letter If you want to print in PDF format in R12, please review Note 603338.1, How To Get Statement Output in PDF in Release 12? Is There A Sample Template For AR Statements? 3, ARXSGPO.rdf This report handles the formatting of statement data into output you can send to your customer. This report pulls data from the temporary tables populated by ARXSGP above. The seeded format for Statement Output is TEXT, and it uses this report definition to format the output. But you can choose to have the output in XML for use in BI Publisher, or PDF. If you want to print in PDF format in R12, please review Note 603338.1, How To Get Statement Output in PDF in Release 12? Is There A Sample Template For AR Statements? 2. Setup Requirements for Statement Printing a. Statement Cycles This setup step is mandatory, Statement cycles allow you to define the intervals in which you want to send statements to your customers. Responsibility: Receivables Manager Navigation: Setup > Print > Statement Cycles hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adctwoarte Document 13497521 Name Description {25th day of every month Interval. [Monthly Active (1 Cycle Dates Operating Unit Statement Date Skin Date Printed [vision Operations 25-AUG-2011 Oo “ Vision Operations 25-JUL-2011 o Vision Operations 25-JUN-2011 o Vision Operations 25-MAY-2011 o Vision Operations 25-APR-2011 o Vision Operations 25-MAR-2011 o Vision Operations 25-FEB-2011 o Vision Operations 25-JAN-2011 o Vision Operations 25-DEC-2010 o Vision Operations 26-NOV-2010 o e The above shows an example of a statement cycle defined with the Interval = Monthly. You have the option to pick: Monthly, Quarterly or Weekly. Then you define the actual statement cycle dates. Note: Please take care in defining the statement cycle dates, as the form does not perform interval validation on it, For example, if you pick an Interval of Weekly, the form will not raise errors even if your statement cycle dates are not 1 week apart. Following explains the use/meaning of the fields: + Skip: you can click on the Skip checkbox if for any reason you want to bypass the statement generation for that Cycle Date.If you tag a particular Cycle date as skipped, this value will no longer be available in the list of value for Statement Date when you run Print Statements, this is discussed in more detail below. Note: Checking the Skip checkbox for a particular statement date cycle is not equivalent to actually running a statement for a cycle. This means that the Printed flag and the Date Printed fields will not be populated with the values that the code checks when retrieving the Last Statement Date. More on the impact of Last Statement Date in the troubleshooting section below + Date Printed: This field only gets populated if in the Print Statement form, you submit the process without filling in Customer Name/Number or Location. This is discussed in more detail below. hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adc‘wenzo1e Doooument 13497524 b. Standard messages This setup step is optional, Standard Messages allow you to include a custom message to be included in your statement output. This could be seasonal messages, such as holiday greetings, or promotional messages. The text you define for standard messages appears at the bottom of the Statement. Responsibility: Receivables Manager Navigation: Setup > Print > Standard Messages Sewanee ire Type Stat Date End Date er [FRONOT —[Prometoral |r7-auez071 | Dont rrpetto check ou weber cd) [rourari —oisey —araucannn | Statement Aging Buckets define how you want to categorize the Outstanding items of a customer depending on the number of days it is overdue. Statement Aging requires you to define 5 age group buckets, Responsibility: Receivables Manager Navigation in R12: Setup > Collections > Aging Buckets and Interest Tiers Navigation in R11i: Setup > Collections > Aging Buckets ErIrEnmrEnin Name Description Statement fve-hucket aging ype [BitementAsing Staus. Ade ren Sequeree Number bey ay « eye 38 lurin Heacings re TE ret eee ig (Curent ‘se cumert 2 Pastbue 1 20 1-30 Days [ a PastDue at 0 120 Days [ 4 PastDue 61 0 6120 Days o E Paste at 6990008 Ove 0 Dayo o Oracle Receivables seeds one Statement Aging Bucket shown above. You can modify the seeded hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1‘wenzo1e Doooument 13497524 Statement Aging bucket, or define as many new ones as you require, d. Finance Charge Receivable Activity If you do not intend to calculate finance charges or late charges, this step is optional. ‘Whether you run Finance Charge calculation in Release 11i, or Late Charges in Release 12, you will need to define a Receivable Activity for Finance Charges to provide the default accounting information. Following are screenshots for Release 12 Responsibility: Receivables Manager Navigation: Setup > Receipts > Receivable Activities Operating Unit Vision Operations Neme (iiteneekenet Description [Finance Charges @ betive ini Accounting Tax Rete Code Source R CL Account Souce (SGgiSUASt=n EN =) [Nene Actiity GL Account 1740781000000 Distribution Set GL Account Description [Operations-Controllers Office-Interest Income.No Sub Once defined, you need to associate it at the System Options level, as shown below: Respon: : Receivables Manager Navigation: Setup > System > System Options navigate to the Trans and Customers tab hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1‘Wrano1 Document 13497521 Transactions I Alow Chango ta Printed Trancacions 1 Allow Transactisn Delotion 17 Aw Baynus of Unltd ranean show Bling Nama Taxtnecice Printing Options ftemize Wah Recap Documet Naber Generation Lee (Wn competed =) Late Charger goss Late Charges ‘vorage Dally Balance Inert noice Transaction Typ [ice Debit Memo Charge Transaction Type Balanoe Calculation [Exclude Past Bling Usb here Torest Changs Aeity Finance tgs Celestion Paid Outset Runste Penalty Chome Act Lie Charge Batch Source [nisrect nace Following are screenshots for Release 111 Respon: ity: Receivables Manager Navigation: Setup > Receipts > Receivable Activities Operating Unit Name Description Finance Charges Type (Finance Charge +] <_ Active iD Accounting BL Account Source Tax Cede Souve (None Activty GL Account Distribution Set GL Account Description [Operations.Controllers Office.Interest Income-No Once defined, you need to associate it at the System Options level, as shown below: Responsibility: Receivables Manager Navigation: Setup > System > System Options hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1‘Wrano1 Document 13497521, navigate to the Accounting tab Seta Se ern i Operting tit SEAMEN Accourting Watrod Accrual ——=~S*S*S*«ame fon Operon (USA) Finance Cherge Actwiy [Finance Charges Realized Gains Account Realized Losses Account (01-740-7840-0000-000 Tay Accoun [OF0002520-0000000 Unallocated Revenue Account Cross Curtency Rate Type [Spot Cross Currency Rounding Account (01-740.7826-0000.000 Header Rounding Account. (01-740-7827 0000-000 automatic Journal Ingert Header Level Rounding Days per Posting Cycle AO) — Accounting Floxfield Description [ e. Customer Profile Classes This setup step is optional. Customer Profile classes is a time-saving feature, wherein you can define general settings that you apply to a specific customer. When you use a customer profile class, all the settings you defined in the profile lass default into the customer record, which saves you time during setup. Responsibility: Receivables Manager Navigation: Customers > Profile Classes Following are screenshots from a Release 12 instance, fields impacting statements are enclosed in the red bo» hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1‘Wrano1 (EEG) seers ca an ae sen Eyable ‘Bil Laval | ‘Tax Printing [Surwmarize By Tae Name 7 Type | ‘Grouping Rue [DEFAULT © Se Stoert # Send Cred laos 1 Sane Dar atats Cycle Gusts Payrort Tome 130 lew ica 7 Dre Tens cout Grae Days 2 Coleco: ecopes en Rect By Name amieJones ‘to cath Rule Set [Stored Ceeeatan flew Custer PavosicRavew Cle Moar ead ‘PutoRecep cud isp tens Torres (0) creat check Wyo In the following page, you can set thresholds for various currencies. inne OEFAULT Owes Used sy Cuter ieeien went Maen Pls ses ate ha Pa Ceuteney Caney Rata Lint EUR, ret Lint on Fn Roce eran oor car eC Lint am Mi Seen 100 ur 25 ere ee se Exchange Rate Te Tolsmes Nim Cnt Baars not | vain a8 Ieenennenee cela Saal +I Voie, SDM ‘Minera Charge Prince] ‘Matimurn Chage Por Ino 1) ct Chage Pealy Change “pe [Fa Rae 7 Tye E vaul a va cro Sea cra Sema Following are screenshots from a Release 11i instance, fields impacting statements are enclosed in the red box: hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1‘Wrano1 Document 13497521, Name nd by Custom (MMM etter Petes trees Callectors Torms Name [amie Rocoipts Math Recsins Ey —__] fo Gash Rule Set (Standard Ato Cash Fle Set Finance Charges Rocrsindat Re Set nage hiewest UawtoRoceips Include Disputod home Peyrment Terms "@ Oyerrise Terms Discount Grace Daye Receipt Grace Days Compound Interest Days In Period BO) (2 Send Statement (2 Sond Cro Balance Tex Pinting [Summarize By Tax Name -) oyete [Quaneny Grouping Rule [DEFAULT Daaing Send Ltrs Constdated Bling Formats toner ser (STANDARD) [ee Type 3 ‘Statements Tnvoteing In the following screenshot, you can set thresholds for various currencies, Finance Charges interest Rate Max Inerest Pe Invoice Min Customer elance For Finanes Charges Min Inoice Balance For Finance Charges Min Recelot Amount Min Statement Amount ‘ain Dunring Amount Min Dunning insice Amount Credit Lim (Onde Credit Limit f. Customers This setup step is mandatory, After you create your customers, you can use the profile class defined above to associate the settings hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1‘Wrano1 Document 13497521, ‘you defined above to the customer. When you attach a profile class to a customer, you are defaulting the values into the customer record, but you can change the settings in any of the fields defaulted by the profile class if necessary. Receivables Manager Navigation for R12: Customers > Customers Navigation for R11.5: Customers > Standard You can associate a Customer Profile Class at the Account Level as shown below: ene vat CotnertypeOREAMZATIN Teac @ racaecass J cxtone sot (ak —] cone ae wl ss [RR] stay Comin. mabinaips_serAbepaa_at ae_Atchcns otc [SANT a set cet coer Or at the Site Level as shown below. If you define a profile at the Site level, the settings here override the settings at the Account level. Note that this screenshot also demonstrates, that even though this customer is associated to the Customer Profile Class = Default, you can change the Statement Cycle from the value in the profile class = Quarterly, to Monthly. “earns Sma secrets ie cn pete omen Sas sts | see Pons | comet | payin ae rote [eran is) semen Elsner (ss se Stem ei) (ed re If you have a multi-language installation, you can also associate a preferred language to a customer, by setting the Language field value in the Address at the Account or Site Level. hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1 1128Document 13497521, (Site Detais | usiness rurposes | Communication | Fayment Detais Profle | Profle Amounts _ tate charges | count Site Address Personalize “Account Ste Act Ste umber country > address ine 1 ‘dress une 2 ess tine 3 ‘ress Line 4 ay ‘county sue Adress ocotionSite.odcressCresteUpdoteStac) [unted Sates] [sat statement ve | po [Redwood chy | sen waieo cal Postal Code saressee Status 065 {fT ave Te ieentfing Address | [econ ais] Geography Code Overide Tenguage Notes: + In Release 12, the language field is not exposed in the Customer form, for more details on how to show this field, please review Note 1086165.1, Customer Form Issue: Language Field Not Visible At The Site Address Level ‘+ If your installation only has one language, you can bypass this step. All customers will use the base language. + If you would like the customer to receive customer facing documents, for exampl statements in their language, you should provide the proper language value. In the Profile Amounts tab (at either the Account or Site level), you would also set up the minimum amount to generate a Statement in the Profile Amount tab. Sites Account Profile | Profile Amounts | Payment Details | Communication | Relationships | Order Management [a nro ar vee Deals curency Debts Gis cD 7 Min Receipt amount ‘credit ure Order Crect Lit ‘Min Statement Amount Mn Dunning Amount '5 Min Dunning Invoice Amount 50 In addition for Release 11.5, if you were going to calculate finance charges, you need the following setup: If you have defined multiple Finance Charge Receivable Activities and you want to associate different activities to each customer, you can assign the Charges Activity at the customer level. If there is only one hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1 1208‘Wrano1 Document 13497521, Finance Charge Receivable Activity defined, you can skip this step. 7 Receivables Manager Customers > Standard Respot Navigation: ‘+ Query up the customer for whom you are running statements. + Under Addresses tab, pick the address associated with transactions in the statement, and click Open + Navigate to the Bill To or Ship to site associated with the transactions in the statement, and click Open + Ensure that you have provided a value for Charges Activity eer ceis Usage [Bill Te Loestion [10348 Bl To Location Taw Code acti Tax Rogitration Number sic Code Payment Tes contact Saloo Tenory I Demand Class Salesperson > charges Activity [Finance Charges Next, you would also setup thresholds and the finance charge rate: Cun Cunteney Rates and Limits CAD fee Finance Charyes Interest Rate EUR Max interest Per Inoice a BP Min Customer Balance Fer Finance Charges a Min nice Balance For Finance Charges Min Receipt Areunt Min Stetement Amcunt Min Dunning Amount Min Dunning kvcice Arncunt Credt Limit 10,000.00 Order Creeit Lint 10,000.00 oe @ Following explains the various settings that impact Statements: ‘+ Send Statements: If checked enables the Statement Generation code to include this customer in the processing for statements + Send Credit Balance: If checked statements will be sent even if the Qutstanding balance is a Credit. Also check the value you set for Min Statement Amount below, because the code validates Send Credit Balance and Min Statement amount individually. + Cycle: Identifies what statement cycle is associated to this customer. + Charge Interest (Release 11.5 only); Indicates whether finance charges should be calculated against this customer/site ‘+ Finance Charges Interest Rate (Release 11.5 only): Indicates the finance charge rate to use in calculating charges against overdue items. + Max Interest Per Invoice (Release 11.5 only): Sets the threshold for maximum interest per transaction, hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1 128hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adc twoarte Document 13497521 ‘+ Min Customer Balance for Finance Charges (Release 11.5 only): Sets the minimum total outstanding balance at the customer/site level for which finance charges should be calculated ‘+ Min Invoice Balance for Finance Charges (Release 11.5 only): Sets the minimum total outstanding balance at the invoice level for which finance charges should be calculated ‘+ Min Statement Amount: Sets the minimum total outstanding balance at the customer/site level for statements to be sent. If you do not want zero balance statements to get sent out to your customers, you should put a non-zero amount in the Min Statement Amount field. Also check the value you set for Send Credit Balance above, because the code validates Send Credit Balance and Min Statement amount individually. g. Defining a Statement Site This setup step is optional, and is dependent upon your business requirements. A.customer site can have multiple business purposes. One business purpose = Statements. Defining a Statements site for a particular customer allows you to send one consolidated statement of all the outstanding transactions/activities across all the Bill To sites of that customer to the site designated as having the Statements business purpose. Notes: + If you do not need to consolidate and send statements of all Bil-to sites to one site, then you do not need to define a Statements site. + Ifyou create a Statement site for particular customers, these customers will receive statements that consolidate all transactions across all their sites into one statement. The consolidated statement will contain a Summary page that lists an outstanding balance per site as well as a total of all open on-account receipts or credit memos that are associated to the customer at the account level, rather than at a particular site level. + On-Account Receipts and Credit memos, that are not associated or linked to a particular customer site, will be included in a statement generated against a Statement site. h, Profile Option: AR: Use Statement Site & Dunning This setup step is optional, and is dependent on whether or not you are using a Statements Site. When you define a Statements Site for your Customer, you need to setup the Profile Option: AR: Use Statements Site & Dunning Site, to instruct the Statement Generation code, on which profile settings you would like it to use. When not defined, the default value for this profile is No, which means use the settings defined at the account level. To illustrate, a customer has 3 Bill-To Sites, profiles are set at the Account Level, and each of the 3 sites: Row Level Statement cycle 1 Account Quarterly 2 Site1 Monthly 3 Site2 BillTo & | Monthly Statements 4 Site3 Bill To Quarterly If you set this profile option to: westwoarte Document 13497521 + Yes: You want the statement generation code to use the profile settings at the Site Level, for the site you have designated with business purpose = Statements, In the example above, the value = Monthly (from Row 3) + No: You want the statement generation code to use the profile settings at the Account Level, for the example above, the value = Quarterly (from Row 1) 3. Print Statements Form ‘After completing the above setup and creating a combination of invoices, debit memos, credit memos, adjustments, receipt applications for a particular customer, you have sufficient data to generate a statement. Responsibility: Receivables Manager Navigation: Print > Documents > Statements Statement Operating Unit [Vision Operations Option [Print Statements Bucket Blatement Customer Name Customer Number Location Cycle [Moataly As Of Date Transection Type Statement Date pre een CEmeppe Ping Gon.) Submit) Request Id Standard Messages Name Message Following discusses the various fields in the form: (Release 12 only) This field is defaulted from the Operating Unit value associated to the responsibility you have used to log into the application. If the responsibilty you used has access to multiple operating units, the list of values will present you with the other operating unit values you are allowed to access. 2. Option: You have multiple options in the Print Statements form: oP it Statements: This option allows you to run the process for a : = Statement cycle: This option will print statements for all customers that have profiles defined to use the Statement Cycle you specified, After printing for a statement cycle, the code will tag the Date Printed field in the Statement Cycles form.Only Statement Cycle Dates that have Date Printed populated are available for the option Reprint Statements. hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adc 1628twoarte 10. 11 4, Multi-Language (or Multi Document 13497521 To run statements for a cycle, you leave the Customer Name/Number and Location fields empty. = A particular customer or range of customers: This option will print statements for all the bill-to sites of all the customers you specified. To run statements for a customer range, you would provide either a Customer Name range or a Customer Number range, and you would leave Location empty. * A specific customer site: This option will print statements for one specific bil-to site. To run statements for a particular site, you would enter a value in Customer name or Customer number to identify one customer, and then enter the Location value for the site you want to print statements for. © Print a Draft Statement: This option will print statements using an As Of Date that you provide instead of a Statement Cycle date. Printing in Draft gives you the option of reviewing what the statement ‘output would be, prior to actually printing it and sending it to the customer, If you are print in Draft for a Statement Cycle, the code will not tag the Date Printed field in the Statement Cycles form. When printing a Draft, the Statement Date is disabled and the As Of Date is enabled. © Reprint Statements: This option allows you to reprint statements for which you have already processed a Statement Cycle for (i.e. you have previously submitted a Print Statements request and entered a Statement Cycle and left customer name/number/location empty). The list of values for the Statement Date only show Statement Cycle Dates for which the Date Printed field is populated in the Statement Cycles form. Bucket: Provide the Statement Aging Bucket here. You would use the value you set up in 2.c above. Customer Name Customer Number Location ‘As explained above in Option, you can limit the statement generation to a specific range of customers via name or number or a specific location. You can limit the scope by providing either a Name or Number range and an optional Location. Cycle: Provide the Statement Cycle to use. You would use the value you set up in 2.2 above. It is important that if you limit the scope of statements to a particular customer or site, you need to make sure that the Cycle you specify matches the Cycle defined for the customer you chose. This form does not do any validation to check whether the value you entered is valid for the customer chosen. The process will run as normal and not pick up any data if there is a mismatch in the Customer+Cycle value you provided. Statement Date (disabled for Print a Draft Statement) Provide the Statement Date to use. The values available here would be the same values you defined in step 2.a above. For Print Statements: Only Statement Dates that do not have Date Printed populated will be available in this list For Reprint Statements: Only Statement Dates that have Date Printed populated will be available in this list As of Date (only enabled for Print a Draft Statement) Provide the cut-off date you would like to use for the draft statement, ‘Transaction Type: If you want to limit statement output to a particular transaction type only, enter a value here. Primary Salesperson: If you want to limit statement output to transactions associated to a particular salesperson, enter a value here. Calculate Finance Charges and Charge Finance Charges on Disputed Items (only for Release 11i, enabled only for Print Statements). If you would like to calculate finance charges on overdue transactions and/or calculate finance charges on puted items, check these boxes. Standard Messages: To include messages at the bottom of the statement, indicate the message names here. You would use values you created in step 2.b above. ingual) Support (MLS) for Statements Since a customer is the end-user of a statement, you would want them to understand the contents of the statement. This requirement is fulfilled by the multi-language functionality available in Statement Generation. In an Oracle Receivables environment, there are two language levels: hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adc 1628twoarte Document 13497521 + Base Language: This is the default language for the installation, in an instance there can only be one base language. ‘+ Installed Language: In a multi-language environment, there can be many installed languages. In such a case you would have directories such as $AR_TOP/reports/ For example: $AR_TOP/reports/US - for American English $AR_TOP/reports/FR - for French ‘As mentioned above in step 2.f, you can define the Language associated to a customer, The behavior of the statement output is as follows: + If you associate a language to your customer, the statement will be printed in that language. + If you do not associate a language to your customer, the statement will be printed in the Base Language. + You cannot print a statement for a customer in multiple languages. More details on the impact of MLS in the Process Flow for Statement Generation section below. 5. ‘nance Charges (only for Release 11.5) ‘As mentioned above, in Release 11.5, the calculation of finance charges for overdue transactions can only be done from within Statement Generation or the Dunning Process. If in the Print Statements form (section 3 above) you checked the Calculate Finance Charges checkbox, you are instructing the Statement Generation code to make a call to the finance charge module. For each transaction included in the statement, the code will calculate Finance Charges if necessary, Finance charges are then recorded as adjustments against overdue transactions. The finance charge module keeps track of when it calculated finance charges on a customer site level. It updates the following fields in HZ_CUST_SITE_USES: + LAST_ACCRUE_CHARGE_DATE: stores the latest date of when finance charges were calculated (For example: 01-AUG-2011) ‘+ SECOND_LAST_ACCRUE_CHARGE_DATE : stores the date of when finance charges were calculated prior to the LAST_ACCRUE_CHARGE_DATE (For example: fiannce charges are run every first of the month, if last_accrue_CHARGE_DATE = 01-AUG-2011, then SECOND_LAST_ACCRUE_CHARGE_DATE = 01-JUL-2011) + LAST_UNACCRUE_CHARGE_DATE: gets same value as LAST_ACCRUE_CHARGE_DATE + SECOND_LAST_UNACCRUE_CHARGE_DATE: gets same value as SECOND_LAST_ACCRUE_CHARGE_DATE 6. Process Flow for Statement Generation Once you click on the Submit button, the concurrent process takes care of spawning as many requests as there are installed languages in your instance. If you only have one language installed, then only one request will be spawned. If ‘you have 3 languages installed, 3 requests will be spawned, one for each language. The Print Statements form will display the spawned requests in the Request Id field, in the format: Language: Request Id. Each language specific process takes care of setting environment variables so that each process runs and gathers data that applies only to that language. In some cases, a language will not pick up any data. Note: Regardless of whether you have data or not for a particular installed language, Statement Generation will still spawn a request for it. You cannot control or change this behavior. For example: hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adctwoarte Document 13497521 + Your installation has 4 languages installed: US (American English), KO (Korean) , AR (Arabic), German (DE) + You have 400 customers in your customer base, equally split up across the 4 languages. + The German installation is the newest langugae added, and the customers associated to this language do not have any transactions yet. + All customers are associated with the same statement cycle ‘+ When you run statements for that cycle, it will spawn 4 concurrent requests: one for each language. ‘+ The output for the US concurrent request will contain statements in English, for the customers whose preferred language is American English. + The output for the Korean concurrent request will contain statements in Korean, for the customers whose preferred language is Korean. + The output for the Arabic concurrent request will contain statements in Arabic, for the customers whose preferred language is Arabic, + The output of the German concurrent request will be empty. Each concurrent request will sweep through the data to find items against customer sites associated to its language setting, that should be included in the Statement, for example: + Transactions (invoice, credit memo, debit memo, deposit/guarantee, chargeback, bills receivable) that are stil outstanding, or were closed after the last statement was run All credit memo applications that happened after the last statement was run ‘All receipt applications, including receipt reversals with Status of STOP or NSF since the last statement was run All on-account or unapplied receipts since the last statement was run Cross-site or Cross-payment receipt applications since the last statement was run All adjustments against transactions above since the last statement was run For Release 11.5, if when you submitted Print Statements you checked the Calculate Finance Charges, then an additional call is made to the code that calculates Finance Charges. 7. Debugging Statement Generation ‘As mentioned in the overview, the Statement Generation program is comprised of multiple pieces of code. It is important to identify, precisely which area is failing, Some issues occur in the Print Statements form, most issues occur in the Statement Generation process, and some issues occur in the creation of the output, Majority of issues encountered in Statement processing occurs while running the executable ARXSGP. To enable additional debug messages, please review Note 436733.1 Statements: How to Enable Debugging for Statement Generation Program ARXSGP, for more information on how to enable debugging, ‘The executable ARXSGP generates both a log file and an output. A review of the log file typically shows the area where the error was raised. Following shows an example of a log file generated for Release 11.5, it shows the flow of the code and is very useful for debugging purposes.Click here\#. for a complete log example. hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adc 1928twoarte ance area: arse: anisye: anieyee areeyee anesge: inegp: ahs and ange ans em) Sarge Soman Bent Eanent arent Sanent anent Sramene Sanene Samene Shiner statement Generacten program risa: ange asd Sree: arab: anep: eanat oe RES A leer inisye shes: ante: citrate Seog argo argo argo siege areca: cal Ving, get_statenentdate, gysten Pine Te 34 aue 304 fasta sa7 SGotement date fs 25-07-7011 Statemm Gite last }= 25-02-2000, Suldae ge haces Syseenclng 1324 Aus 2001 a8c44sa7 From a4ss7er to a4gs7o8 ~ 1-30 bays From a4ss/a7 co a4gszaa ~ 3-60 mays Fram 248sar7 to “7e4er31 — aver So! cae Returning. gex_bucers = type cunnenr ype hae Bie" base = whe east “ype Fast ibisqp: ans and ange ans ange ange ang asd arse areas seatenanes: pebus) code Hanes date 12 Sra. Bequest a 4 3130302, Gaeta 's Loco. Stevenee cage ain 4 25-02-2002. lgtenes ued fares Sata Parson iz". elefene” nate fob 4 viecst, Customer nom tenis . Godtoner nam nigh ds Mtsgp: calling finance charges Seong EEE ae i: sn eg ite edna trae Shige Geeieerathyy ok von Cea argo eens vo Hance Bayne tare area, 0') eens Seis is! cnleuse. tnrerest_charges), Frat 2 p_ouct aayaare gr ze_days, 0D), Document 13497521 “his socian sieseys he parameters passectt the process. “Thiccastondepiye date nim aion “Tis secon shows clas efthe Sateen Aging cat ‘This secin summanzas he paramates te coda is gong useic| process slsemerts ‘This cocton neicates he catothe Finance cisige mod, Thi oly run whan be chectnosCeloulot Finance Cherpes i check veg get_statement _stte(cust_acct.cust_accourt Ad), cp_cust.cust_accoune td If you don't see this many debug messages in the log please review your setting for Profile Option AR: Enable Debug Message Output, see Note 436733.1 8. Sample Output Release 11.5 output: Following is a sample of the TEXT output generated by the Seeded Statement Generation program in Release 11. . The first page will show an alignment page of X's and 9's. This page was originally created to help in aligning the output of dot matrix printers with the pre-printed Statements form, Today, most customers us laser printers and this alignment page is no longer useful, however you cannot disable the printing of this page. hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1 1928‘Wrano1 Document 13497521, hip:support oracle. comepmesifacesiDocumertDisplay?_adl ct state=roQetS74_7BBid=134752.1twoarte Document 13497521 Hen Finance ohg Finance cnaraeo 172.38 4,482.00 sas7e Finance cog ‘Finance Charges 1,398.92 20,100.42 The total amounts shown at the bottom of the statement are picked up from the data in interim table ‘AR_STATEMENT_HEADERS.BUCKET1 to BUCKETS. These fields are populated by the process as it evaluates each transaction to include in the Statement. Release 12.x output: In Release 12, the seeded Statement Generation program will output in TEXT format similar to the example above. However, following is a sample of the outputs generated by the Customer Statement Balance Letter in Release 12. This output is generated in 2 phases: ‘+ Submit Print Statements to generate output in XML, click here” to see the complete XML output file generated. + Invoke Publisher to use the XML output + Customer Statement Balance Letter template, click herel#.! to see view the output in pdf format hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adc 21128twoarte Document 13497521 ORACLE Receivables Date 25-AUG-2011 Poe 4/4 Supplier Address Tax Payer ID Contact Statement aaaress vestnt 4221 Statement Drve Redwood City CA Us 94055, Statement Date -25JUL1 ‘Statement Leter Dear Partner Aczording to our records, your account with us contains tho folowing balances a¢ of he statement cate | THO “Transaction —| Tavoice Date | Due Date currency “Ammount | Amount Doe Number | Type 102833 voice CRE [orsuLr EOSZOO, EOSZOD, T3877" Deot hemo | CaJUNETT | O20 3345.00 E345 00, 102300 voice ‘O7-JON-1O | 22JUN-10 57-80 THES ‘Credit Mama —| 07 JUN-11 OJON SEED OO Unepptied —| Payment AIL 260.00 250.00 100307 Trvoice ACIORE10 | PTO 5,000.00, 102880, voice TEMAY-1 | TSUNETT 1306.0 THO 120 Payne 7EIUL-70 “31048 00 TET Payment ETON, 7 102301 ‘Adjsiment | 30D C-10 =¥5;000.00 ooo [Rinount OT Oper vos. [USD 1 1 [Balance [OSD I T 1 Curent [90 Days [S50 Days [Or S0 Days | Over SO Das 0.00 3,787 00 | 7.167 00 060 0.00, Please noi us within 8 days ifyou do not agroe wih our records Uinloss we hear othe contrary, we shall regard the above data accopied. 25 August 2011 ‘Sionatare For more information on how to set this up, please review Note 603338.1 How To Get Statement Output in PDF Release 12? Is There A Sample Template For AR Statements? 9. Diagnostics There are diagnostics available to collect for Statement setup related information. Review the Diagnostics Catalogs: + Release 11,5 Note 179661,1 + Release 12.x Note 421245.1 hhipieuppartorecle.comiepmesifacen;DocumentDisplay? adcsa02018 Document 13497524 In Release 12, there is a separate catalog for each point release. Once you've located the correct diagnostics catalog for your release, look for the Product Name = Oracle Receivables, Then within the list of diagnostics for Oracle Receivables, you should see a Diagnostic under the sub-section Collections, called Statements. This diagnostic lists setup information pertaining to Statements. 10. Troubleshooting Tips 1, You are not getting any output in the statement © Verify that the customer profile setup is correct, because this controls a lot of factors such as: whether your customer will get statements what cycle your customer will use whether finance charges should be calculated and what rate to use whether a credit balance statement should be sent = whether a statement should only be sent if the balance is a certain amount © If you are running for a particular customer/site, make sure that you picked the right staternent cycle in Print Statements form that matches the statement cycle at the customer/site profile © If you are running the statement process for an entire Statement Cycle (i.e. you are not limiting the criteria to a particular customer / site), and it fails, you should try to enter a customer range to limit the data processed, to see if limiting it will allow the process to run for some customers. By doing this you can isolate the particular data that is causing the process to fail 2. You are not seeing a particular transaction/receipt in the statement © If you are expecting an On-Account Receipt or On-Account Credit memo to appear in the statement, check whether the transaction is associated to a Bill-To site. If not, there is no way the statement code can associate it to a particular site's statement, If however, your customer is using a Statement site, then you should be able to see all On-Account Receipts and Credit Memos. © Check that the transaction date of the invoice that is missing from the statement is on of after the statement date. 3. You are seeing closed transactions appear on the statement © Statement generation uses the Last Statement Date when checking for what to include in a statement. Anything that was closed between the current statement date and the last statement date is included in the statement. To determine the Last Statement Date, you can go to the Statement Cycles form, and query up the cycle. The greatest date that has Date Printed field populated is the Last Statement Date. This field only gets populated if you run the Statement process for an entire Statement cycle (i.e. you do not limit to a customer name/number range). To ensure that subsequent statements do not keep on picking up transactions that were already closed even prior to the last statement date, it is advisable to submit the Statement process for an entire cycle, so that the Date Printed gets populated. 4, You notice there are discrepancies between the totals shown in the Statement versus the Aging report, If you have transactions where the transaction date is not the same as the GL date, then this is the likely cause for the difference. The Aging report picks up data based on GL date whereas the statements pick up data based on TRX date. 5, In Release 11,5, you are encountering issues regarding Finance Charges hhip/ieuppart oracle. comlepmesifacesiDocumentDisply? adc 228twoarte Document 13497521 The concurrent log generated by the Statement Generation process contains many debug messages if you enable debug properly. See Note 436733.1 Statements: How to Enable Debugging for Statement Generation Program ARXSGP. Once enabled, you should see debug messages that expose data being used by Finance Charge process. For example, text such as: ayment schedule 316. balance 3714969 balance : redit 1. ered 21199. balance <= 0 finance charge : 0 difgere 0 ‘The above shows that the transaction has a negative balance, so naturally Finance charge won't be calculated against it. The log will also show information such as: Previous finance date : 01-AUG-2011 art Finance date before last finance da No arfcef: return successful. are: nance charge created. This indicates that for this transaction, the last finance charge calculation was done on 01-Aug-2011, If you are running statements again with Calculate Finance Charges checked, for the same date, finance charges won't re~ calculate. Reading through the log file typically identifies the reason for failure. 6, In Release 11.5.10.2 when running the Statement Master Generation Program, the program errors while printing the output: feng: (FATAL ERROR) ABP-END-00500: AFP ogram exited w. Bad queue or dev RN received a status 64 .e EDUERN fzom Cause: AFPPRN rece Peogsam exited » ved a return code of om the OSD x status 64 ‘Apply Patch 12973925, which provides the file ARSTMTPB.pls having version 115.0.15104.5 14. Known bugs/issues Please review Note 1352529.1, Statement Generation Program (ARXSGP): Known Issues, Patches and Enhancement Requests - which is a compilation of all reported issues and existing patches for the statements module. 42. Community Discussions Still have questions? Use the live My Oracle Support Receivables Community window below, to search for similar discussions or start a new discussion on this subject. hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adcswears ‘Document 1349752:1 All Places > My Oracle Support Community > Oracle E-Business Suite (MOSC) > Receivables - Receivables - EBS (MOSC) Overview Content People Subspaces YOUR COMMUNITIES ASK RECEIVABLES - EBS (MOSC) Spaces ‘Type your question Find Space ASK IT ‘Type to begin your search ORACLE RECEIVABLES Welcome to the Oracle Receivables Communi ‘The Oracle Receivables (AR) Community provides ‘expertise through colaboration with Oracle employ topics relating othe setup & use of and best pract ‘you to contribute by responding to questions from Practices and acknowledging Correct or Helpful re ‘Community useful and informative, | SS i » 13. Feedback To provide feedback on this note, click on the Rate this document link. REFERENCES npstsupportoracte com/epmastaces!DocumenDisplay?_ad ct state=r}0tS74 T6RiG=1349752.1 2508twoarte Document 13497521 NOTE:1086165.1 - Customer Form, Address Issue: Language Field Not Visible At The Site Address Level NOTE:179661,1 - E-Business Suite Diagnostics 111 Test Catalog NNOTE:421245.1 - E-Business Suite Diagnostics References for R12 ‘NOTE:436733.1 - Statements: How to Enable Debugging for Statement Generation Program ARXSGP ‘NOTE: 1269062.1 - Late Charges Calculation and Set Up: A Guide for Oracle Receivables Users NOTE:1320546.1 - Information Center: Overview of the Transactions Workbench in Oracle Receivables (AR) 11.5 and later ‘NOTE: 1349752.1 - Statement Generation Program (ARXSGP): Overview, Setup and Troubleshooting NOTE: 1352529.1 - Statement Generation Program (ARXSGP): Known Issues, Patches and Enhancement Requests, NOTE:565507.1 - Release 12 Issues in Statement Printing and AR Customer Balance Statement Letter NOTE:603338.1 - How To Get Statement Output in PDF? Is There A Sample Template For AR Statements? 228 hnipes/ieuppart oracle. comlepmesifacesiDocumentDigply? adc