Your SlideShare is downloading. ×
Implementing lockbox
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×
Saving this for later? Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime – even offline.
Text the download link to your phone
Standard text messaging rates apply

Implementing lockbox

724
views

Published on

Published in: Economy & Finance, Business

0 Comments
1 Like
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
724
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
61
Comments
0
Likes
1
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. Implementing Lockbox Your step-by-step guide for implementing Oracle Receivables Lockbox functionality Product: Oracle Receivables Version: Release 12 Anil R. Patil
  • 2. Implementing Lockbox Contents Objective ....................................................................................................................................................... 3 Overview of Lockbox ..................................................................................................................................... 3 Implementing Oracle Receivables Lockbox functionality ............................................................................. 4 Setup Overview ......................................................................................................................................... 4 Bank and Bank Accounts ........................................................................................................................... 5 Receipt Class & Receipt Method ............................................................................................................... 7 Receipt Method – Bank Accounts ............................................................................................................. 9 Receipt Source ........................................................................................................................................ 10 Lockbox ................................................................................................................................................... 11 Transmission Formats ............................................................................................................................. 15 Transmission Fields ................................................................................................................................. 17 AutoCash Rule Sets ................................................................................................................................. 20 Control File .............................................................................................................................................. 21 Data File .................................................................................................................................................. 22 Lockbox Processing Steps ........................................................................................................................... 25 Submit Lockbox Process .............................................................................................................................. 26 Maintain Transmission Data ....................................................................................................................... 28 Identifying Customers for Receipts ............................................................................................................. 30 Conclusion ................................................................................................................................................... 31 oracle.anilrpatil.com Page 2
  • 3. Implementing Lockbox Objective The Objective of this document is to explain how to use the Oracle Receivables Lockbox functionality. This document will explain some of the key setups required for implementing Lockbox and will guide you for setting up the Lockbox format and also generating a sample lockbox file for testing purpose. Overview of Lockbox Lockbox is a service offered by banks to companies in which the company receives payments from their customers by mail to a post office box and the bank picks up the payments and deposits it in the company’s bank account. In a way, the company is outsourcing its AR function of collecting the checks and depositing it in the bank. The bank then informs the company of all the payments received. They normally send a Flat file (text file) to the company that gives all the details of the deposits made in the bank account. The details captured in the flat file depend on the arrangement between the bank and the company. This flat file is referred to as the Lockbox file. The company can then import this Lockbox file in their system to create receipts and apply these receipts to the open invoices. Oracle Receivables provide a standard functionality to import the lockbox file to create the receipts. It also provides you with the flexibility to define customized lockbox formats to enable you to accept the lockbox file in any format for any of the banks. The Oracle Lockbox functionality can also be extended to convert Receipts information from any other legacy system or from the remittance advice the company gets directly from their customers. Implementing a lockbox solution by importing a lockbox file from the bank goes beyond just Oracle Receivables configurations. You need to contact the bank, discuss and agree on the lockbox file format before you start your work on Oracle Receivables. You need to decide how much information you want the bank to capture, how the bank will capture the information and so on. In most cases, the bank captures the remittance information by scanning the scan-line included in the payment coupon. This payment coupon is sent to the customers along with the Invoice (Generally the bottom of the first page of the Invoice). The scan-line will include information such as Account number, remittance amount, invoice number and so on. This is how a typical payment coupon looks like Once the bank receives the payment along with the payment coupon, the bank scans the Scan line to capture the required information to be included in the Lockbox file. Each digit in the scan line indicates some important information. For e.g. the last 5 digits in the scan line above indicate the amount. oracle.anilrpatil.com Page 3
  • 4. Implementing Lockbox Implementing Oracle Receivables Lockbox functionality Setup Overview You need to setup the following before running the Lockbox process 1) Bank and Bank Accounts: You define your internal bank accounts in Accounts Receivables. This is the bank account where the customer payments are deposited. 2) Receipt Class: The Receipt Class determines the processing steps for the receipts and you assign Receipt Methods to your Receipt Class. The processing steps for any Receipt include confirmation, remittance and reconciliation. 3) Receipt Method: Receipt Method is assigned to a receipt class and it determines how to account for the receipts using the Receipt Class. For one Receipt Class, you can have more than one Receipt Methods. You associate bank accounts and the GL account combinations for Cash, Remittance, and Bank Charges etc with the Receipt Method. 4) Receipt Source: You define Receipt Batch Sources to provide default values for Receipt Class, Receipt Method and the Remittance Bank Account. Your Receipt Source also determines if the batch numbering system is manual or automatic. 5) Lockbox: Define a lockbox for your Lockbox service from each bank. The lockbox setup includes a Lockbox number (You get a Lockbox number from your bank). 6) Lockbox Transmission Formats: Oracle Receivables AutoLockbox uses the Transmission format while importing the data from the lockbox file into Receivables. Transmission formats indicate how the data in the Lockbox file is organized. 7) AutoCash Rule Sets: AutoCash Rule Sets determines the sequence of AutoCash Rules that Post QuickCash program uses to apply the receipt amount to the customer account open items. 8) Control file: A Control file is a sql loader file to load the lockbox file in Receivables payment interface table (ar_payments_interface_all). This file should have the ‘.ctl’ extension and should be placed in the $AR_TOP/bin directory. Input Data 1) Lockbox file: The only input data you need for the lockbox process is the Lockbox file (flat file). You receive this file from the bank. If you are using the Lockbox functionality to convert AR receipts from legacy system, you can generate this file yourself. oracle.anilrpatil.com Page 4
  • 5. Implementing Lockbox Bank and Bank Accounts Navigation: Setup => Receipts => Banks (You could also setup Banks from Cash Management responsibility) You define your internal bank accounts in Accounts Receivables. This is the bank account where the customer payments are deposited. Please note that the Bank setup and the bank security access have changed in Release 12. For more details on bank security access, you can refer the following metalink document NOTE:403975.1 - How to Setup Bank Account Access Security In Release 12 You also need to run the CE UMX Security Wizard to be able to provide Bank Account access to Legal entities. Follow the following steps to run the wizard 1) Log in as Sysadmin. 2) Go to the User Management Responsibility. 3) Path: Roles & Role Inheritance 4) In the Type field select Roles and Responsibilities 5) Wait until a new field appears, you will see the category field, please select Miscellaneous 6) In the Application select 'Cash Management' and click on GO button. 7) Search your Cash Management responsibility (Hit go) and look for role <Cash Management Responsibility Name> 8) Click on the update icon for role <Cash Management Responsibility Name> 9) A new window will be displayed, please click in the Security wizard Tab. Hit ‘Save and Proceed” 10) For CE UMX Security wizard click on the Run Wizard. 11) In this window you should add the legal entities that you want to grant the access to all the bank accounts within a legal entity and choose the privileges that you want to assign to this role on the bank accounts such as: USE, MAINTENANCE and BANK ACCOUNT TRANSFERS. oracle.anilrpatil.com Page 5
  • 6. Implementing Lockbox 12) Click “Add Legal Entities”. Click “Go” and then select the legal entities from the list. Next screen select all required options for the legal entities and hit “Apply”. On the next screen also hit “Apply” 13) Save and apply the changes and then verify in Cash management responsibility if you now are able to see that legal entity in the bank account creation form. oracle.anilrpatil.com Page 6
  • 7. Implementing Lockbox Receipt Class & Receipt Method Navigation: Setup => Receipts => Receipt Classes The Receipt Class determines the processing steps for the receipts and you assign Receipt Methods to your Receipt Class. The processing steps for any Receipt include confirmation, remittance and reconciliation. Receipt Method is assigned to a receipt class and it determines how to account for the receipts using the Receipt Class. For one Receipt Class, you can have more than one Receipt Methods. You associate bank accounts and the GL account combinations for Cash, Remittance, and Bank Charges etc with the Receipt Method. Receipt Class fields: Creation Method: • Use Creation method ‘Manual’ to use the Receipt Class for Lockbox. If the creation method is Manual, you can use the Receipt Class for creating manual receipts using the Receipts or Quickcash window or by importing the receipts using AutoLockbox. • Use Creation method ‘Automatic’ to create receipts using the Automatic receipt program. Since you want to use this receipt class for Lockbox, you will select the Clearance method ‘Manual’. Remittance Method: If the Creation method is Manual, set the Remittance method to ‘No Remittance’. Remittance Method is used only if the Creation Method is ‘Automatic’. The Remittance method determines the accounts to be used for automatic receipts. Clearance Method: oracle.anilrpatil.com Page 7
  • 8. Implementing Lockbox • Use Clearance Method ‘Directly’, if you want the receipts to be cleared at the time of receipt entry. • Use Clearance Method ‘By Automatic Clearing’, if you want to clear the receipt using the Automatic Clearing Program. • Use Clearance Method ‘By Matching’, if you want to clear the receipt by matching the receipt to Bank Statement line in Cash Management. For the Receipt Class, enter a Receipt Method name, printed name and effective dates and click ‘Bank Accounts’ to assign a Bank Account and GL Account Combinations to the Receipt Method. oracle.anilrpatil.com Page 8
  • 9. Implementing Lockbox Receipt Method – Bank Accounts Navigation: Setup => Receipts => Receipt Classes => (B) Bank Accounts Select the required bank account and provide the required GL Account combinations. These accounts are used in receipt accounting whenever a receipt is created using the Receipt Method. oracle.anilrpatil.com Page 9
  • 10. Implementing Lockbox Receipt Source Navigation: Setup => Receipts => Receipt Sources You define Receipt Batch Sources to provide default values for Receipt Class, Receipt Method and the Remittance Bank Account. Your Receipt Source also determines if the batch numbering system is manual or automatic. To be able to use Batch Source in Lockbox, the Batch Numbering should be set to ‘Automatic’. oracle.anilrpatil.com Page 10
  • 11. Implementing Lockbox Lockbox Navigation: Setup => Receipts => Lockboxes => Lockboxes Define a lockbox for your Lockbox service from each bank. You can also define a lockbox to convert receipt information from your legacy system. 1) Lockbox Number: You get a Lockbox Number from your bank. If you are implementing Lockbox for converting receipt information from other sources, you can specify your own Lockbox Number. 2) Batch Source: Select one of your pre-defined Batch Source. To be able to use Batch Source in Lockbox, the Batch Numbering should be set to ‘Automatic’. The Bank Account information is defaulted from the Batch Source definition. 3) Bank Origination Number: The Bank Origination Number is provided by your bank. This number uniquely identifies the bank branch that sends you the Lockbox information. If you are implementing Lockbox for converting receipt information from other sources, you can specify your own Bank Origination Number. 4) Accounting Flexfield: The Accounting Flexfield displays the Cash Account of the Receipt Method. oracle.anilrpatil.com Page 11
  • 12. Implementing Lockbox 1) Batch Size: Enter the batch size you want the Lockbox validation program to assign to each receipt batch. If there is more number of receipts in the lockbox file than the batch size, the receipts are created in more than one batch. 2) GL Date Source: This source determines the GL date for the receipts created by the Lockbox program. You can select one of the following values for the GL Date Source • Constant Date: The GL Date you enter while submitting the Lockbox process is used as the GL date for your receipts • Deposit Date: The deposit date from the Lockbox file will be considered as the GL date for your receipts • Import Date: The date on which you import the receipts becomes the GL date of the receipt. 3) Exchange Rate Type: If there are foreign currency receipts in your lockbox file without the exchange rate type, this Exchange Rate Type is used for conversion 4) Receipt Method: This defaults from the Batch Source you have assigned to the Lockbox. You can change the default Receipt Method. 5) Require Billing Location: If the system option ‘Require Billing Location for receipts’ is set to ‘Yes’, the ‘Require Billing Location’ check box should be checked, else the Lockbox process will display an error message. This option determines if Lockbox process should be able to create receipts with or without billing location. 6) Match Receipts By: This option determines how the receipts will be matched (to which number). You can select one of the following options oracle.anilrpatil.com Page 12
  • 13. Implementing Lockbox • Transaction Number: Receipts are matched using the transaction number • Balance Forward Billing Number: Receipts are matched using the Balance Forward Billing Number. The customer needs to be enabled for Balance Forward Billing if you want to use this option. • Sales Order Number: Receipts are matched using the Sales Order Numbers. The Lockbox process uses the Sales Order Number to determine the corresponding Invoice Number. • Purchase Order Number: Receipts are matched using the Sales Order Numbers. The Lockbox process uses the Purchase Order Number to determine the corresponding Invoice Number. • Hook: Hook is a custom matching method that you define. Using Hook, you can match the receipt using any other matching number that is passed in the lockbox file. The Lockbox process uses this Number to determine the corresponding Invoice Number. Oracle Receivables supplies the packaged procedure arp_lockbox_hook.cursor_for_matching_rule which you can use to add your own custom matching rule with AutoLockbox. 7) Match on Corresponding date: Determines if you want to match on corresponding date for transaction in the lockbox process. You can select one of the following options • Always: This option will always verify that the date of the transaction is the same as the date in the lockbox transmission • Duplicates Only: This option will verify the matching date only if there is duplicate matching numbers. • Never: The lockbox process never matches the date. This is the default option. oracle.anilrpatil.com Page 13
  • 14. Implementing Lockbox 1) Auto Associate: The Auto Associate option if checked determines the Customer based on the debit item number (Invoice number) mentioned in the Lockbox file. If there is no MICR number or Customer number in the lockbox file and if Auto Associate is set to Yes, Lockbox process will identify the Customer based on the debit item number given in the Lockbox file. This option is also useful when you have scenarios wherein customer A makes payment for Customer B’s invoices. If you are using Auto Associate, when applying payment from Customer A to open invoices of Customer B, the receipt will be identified as paid by Customer B. 2) Invalid Transaction Number Handling: This option determines how the lockbox process will handle receipts that were identified by the MICR or Customer number but could not be applied because of invalid transaction number • Post Partial Amount as Unapplied: If this option is enabled, Lockbox process applies the Receipt to valid transactions and the remaining receipt amount that could not be applied because of invalid transaction numbers is considered as unapplied amount. This option is generally set to Yes. • Reject Entire Receipt: If there are any invalid transaction numbers in the Lockbox file, the entire receipt is rejected. The receipts data remains in the ar_payments_interface_all table. You can update the invalid record using the Maintain Lockbox Transmission Data window. 3) Line Level Cash Application: Default value is set to None. oracle.anilrpatil.com Page 14
  • 15. Implementing Lockbox Transmission Formats Navigation: Setup => Receipts => Lockboxes => Transmission Formats Oracle Receivables AutoLockbox uses the Transmission Format while importing the data from the lockbox file into Receivables. Transmission formats indicate how the data in the Lockbox file is organized. A Lockbox file contains multiple types of records and each record has different fields. In the Transmission Format header screen, you define the different type of records your lockbox file will contain. Each record is identified by an Identifier. For each of these records, you define the Transmission Fields. You may define as many formats as you need. The various Record Types available are as follows 1) Batch Header: A Batch Header marks the beginning of a specific batch. Batch Headers usually contain information such as batch number, deposit date, and lockbox number. 2) Batch Trailer: A Batch Trailer marks the end of a specific batch. Batch Trailers usually contain information such as batch number, lockbox number, batch record count, and batch amount. 3) Lockbox Header: A Lockbox Header marks the beginning of a specific lockbox. Lockbox Headers usually contain information such as destination account and origination number. 4) Lockbox Trailer: A Lockbox Trailer marks the end of a specific lockbox. Lockbox Trailers usually contain information such as lockbox number, deposit date, lockbox amount, and lockbox record count. 5) Overflow Payment: An Overflow Payment usually contains invoice information for a specific payment such as batch number, item number, sequence number, overflow indicator, invoice number, debit memo number, or chargeback number, and debit item amounts. Oracle Receivables combines the overflow and payment records to create a logical record to submit payment applications. oracle.anilrpatil.com Page 15
  • 16. Implementing Lockbox 6) Payment: A Payment usually contains information such as MICR number, batch number, item number, check number, and remittance amount. 7) Service Header: Service Header records contain general information about your transmission. 8) Transmission Header: A Transmission Header marks the beginning of a specific data file. Transmission Headers usually contain information such as destination account, origination number, deposit date, and deposit time. 9) Transmission Trailer: A Transmission Trailer marks the end of a specific data file. Transmission Trailers usually contain information such as total record count. Note: Your bank file might not contain all of these record types. You should define your transmission format to only include the record types that are actually used in the transmission format. You will get the Lockbox file format details from your bank. If you are using Lockbox to convert AR Receipts from other source, you can define your own format. The Transmission format shown above is a custom format. Oracle Receivables provides you with the following seeded formats • Example (arxmpl.ctl): A format that contains an example of lockbox header information, several receipt records, and overflow receipt records. • Default (ardeft.ctl): A standard BAI (Bank Administration Institute) format used by most banks. • Convert (arconv.ctl): A standard format used for transferring payment information from other systems. • Cross Currency (arxcurr.ctl): A default format used for importing cross currency receipts. • Zengin (arzeng.ctl): A format used to import bank files in the Japanese Zengin format. These files are located in the $AR_TOP/bin directory and are compatible with corresponding standard SQL*Loader control files. oracle.anilrpatil.com Page 16
  • 17. Implementing Lockbox Transmission Fields Record Type = Lockbox Header Identifier = 2 Record Type = Overflow Payment Identifier = 4 Record Type = Payment Identifier = 6 You can choose one of the following Transmission fields in your format When defining your transmission fields, you can choose from the following field types: • Account: Your customer's bank account. The bank account number and the transit routing number make up your customer's MICR number. oracle.anilrpatil.com Page 17
  • 18. Implementing Lockbox • • • Alternate Name: The alternate name for this customer. Amount Applied 1 to 8: The amount applied to each invoice, debit memo, or chargeback. Each payment or overflow payment record can accommodate up to eight debit item numbers. For cross currency applications, this is the amount to apply in the transaction currency and corresponds to the Amount Applied field in the Applications window. Amount Applied From 1 to 8: Used for cross currency receipt applications, this is the amount applied to each transaction in the receipt currency. Each payment or overflow payment record can accommodate up to eight debit item numbers. This field corresponds to the Allocated Receipt Amount field in the Applications window. Attribute 1 to 15: Use attributes to enter Descriptive Flexfield segments. Attributes can only be assigned to Payment records, and they become the Descriptive Flexfield data in the QuickCash, Receipts, and Applications windows. Bank Transaction Code: A code defined for each account that is used by your bank to uniquely identify the kind of transaction in a bank statement (for example, debit, credit, void). This is also used by Oracle Cash Management to determine a receipt's effective date. Batch Amount: The total receipt batch amount for a specific bank batch. Batch Name: The name of the batch for a specific bank batch. Batch Record Count: The total number of payment records in a specific bank batch. The total number of all batch record counts equals the Lockbox Record Count. This does not include overflow payments, headers, or trailers. Billing Location: Your bank will be able to transmit the billing location of the payment. You must only specify the field name and the field positions that the billing location occupies in the transmitted data file. Comment: Any comments you want to associate with this transmission. Currency Code: The currency of the payment. For cross currency payments, you can also enter the Invoice Currency Code (see below). If you do not enter a value in this field, AutoLockbox derives the currency code from the information that is provided in the Amount Applied and Amount Applied From fields. Customer Bank Branch Name: The name of your customer's bank branch. Customer Bank Name: The name of your customer's bank. Customer Number: The identification number of the customer who submitted a payment. Customer Reason 1 to 8: The customer's reason why their payment shows a discrepancy (used by Oracle Trade Management). Customer Reference 1 to 8: Customer comments about this payment. Deposit Date: The date the bank receives and deposits your customer's payment. Deposit Time: The time at which the bank receives and deposits your customer's payment. Destination Account: Your business's bank account. Your business may have more than one bank account. Effective Date: The date on which the bank determines a customer's balance to apply interest (used by Oracle Cash Management's Cash Forecasting feature). Exchange Rate: The exchange rate associated with this payment if you are using AutoLockbox to import foreign currency receipts. Exchange Rate Type: The exchange rate type used to convert a foreign currency receipt to your functional currency. Values include Corporate, Spot, or User. Invoice 1 to 8: The invoices, debit memos, and chargebacks to which you apply your payment. Each payment or overflow payment record can accommodate up to eight debit item numbers. Invoice 1 to 8 Installment: The installment number for this invoice. Invoice Currency Code 1 to 8: The currency of the transaction. This field is used for cross currency receipt applications. This field is optional. Item Number: A sequence number that your bank assigns to a specific payment. This number associates an invoice with a receipt. Lockbox Amount: The total payment amount in a specific lockbox. • Lockbox Batch Count: The total number of bank batches in a specific lockbox. • Lockbox Number: The identification number for a specific lockbox. • • • • • • • • • • • • • • • • • • • • • • • • oracle.anilrpatil.com Page 18
  • 19. Implementing Lockbox • • • • • • • • • • • • • • • • • Lockbox Record Count: The number of payment records in a specific lockbox (this does not include overflow payments, headers, or trailers). Matching Date 1-8: The dates to use to match receipts with transactions if you are using the Match on Corresponding Date option for this Lockbox. Origination: The bank origination number provided by your bank. This number uniquely identifies the bank branch that sends you lockbox information. Overflow Indicator: This type indicates whether there are any additional overflow records for this payment. Overflow Sequence: A sequence number that your bank assigns to each overflow payment. Receipt Method: The receipt method associated to this lockbox. Payment Number: The identification number of a payment. For example, a check number. Receipt Date: The date your customer made a payment. Record Identifier: A number that identifies the kind of transmission record. You specify this number in the Identifier field in the Transmission Formats window. Remittance Amount: The amount of a payment. Remittance Bank Branch Name: The name of the bank branch from which this payment originated. Remittance Bank Name: The name of the bank from which this payment originated. Status: The status of this payment. Total Record Count: The total number of transmission records in a bank file. This includes headers, trailers, payments, and overflow records. Trans to Receipt Rate 1 to 8: The exchange rate used to convert the receipt amount from the receipt currency to the transaction currency. This field is used for cross currency receipt applications when the receipt and transaction currencies do not have a fixed exchange rate (the euro and all NCUs have fixed exchange rates with each other). If the currencies have a fixed rate, this field is optional (AutoLockbox derives the rate to use in this case). Transit Routing Number: The number that uniquely identifies your customer's bank. The transit routing number and the customer bank account number make up your customer's MICR number. Transmission Amount: The total amount of payments for a bank file. oracle.anilrpatil.com Page 19
  • 20. Implementing Lockbox AutoCash Rule Sets Navigation: Setup => Receipts => AutoCash Rule Sets AutoCash Rule Sets determines the sequence of AutoCash Rules that Post QuickCash program uses to apply the receipt amount to the customer account open items. If none of the AutoCash Rules apply, the remaining amount is placed as Unapplied or On-Account depending on the Remaining Remittance Amount option specified in your AutoCash Rule Set. You can provide more than one AutoCash Rule with a sequence number. Oracle Receivables will try to apply the AutoCash Rules in the order of the Sequence Number. The available AutoCash Rules are as follows • • • • • Clear the Account: Post QuickCash uses this rule only if your customer's account balance exactly matches the amount of the receipt. If the receipt amount does not exactly match this customer's account balance, Post QuickCash uses the next rule in the set. Apply to the Oldest Invoice First: This rule matches receipts to debit and credit items starting with the oldest item first. This rule uses the transaction due date when determining which transaction to apply to first. Clear Past Due Invoices: This rule is similar to the 'Clear the Account' rule because it applies the receipt to your customer's debit and credit items only if the total of these items exactly matches the amount of this receipt. However, this rule only applies the receipt to items that are currently past due. Clear Past Due Invoices Grouped by Payment Term: This rule is similar to the 'Clear Past Due Invoices' rule, but it first groups past due invoices by their payment term, and then uses the oldest transaction due date within the group as the group due date. When using this rule, Receivables can only apply the receipt if the receipt amount exactly matches the sum of your customer's credit memos and past due invoices. Match Payment with Invoice: This rule applies the receipt to a single invoice, debit memo, or chargeback that has a remaining amount due exactly equal to the receipt amount. oracle.anilrpatil.com Page 20
  • 21. Implementing Lockbox Control File There are several seeded control files provided by Oracle for each of the seeded Transmission formats. These control file are located in the $AR_TOP/bin directory. If you define your own Transmission Format, you must create a control file that matches with the Transmission format before you import data into Receivables. The control file should have an extension of .ctl Below is a sample Control File that matches with the Transmission Format mentioned above -- $Header: arplbox.ctl 120.1 2009/11/20 10:37:58 apatil noship $ -- Loads Lockbox flat file in to oracle /************************************************************************************************ --* arplbox.ctl script * ************************************************************************************************* --Program : Manual AutoLockBox US --Description : This is a Customized Control File for Auto Lockbox US.It Imports Receipt -data from the flat file in to ar_payments_interface_all table --Notes : This Control file should be in Sync with Transmission format defined. --Author : Anil Patil ************************************************************************************************* --Version Date Author Modifications --1.0 11/20/2009 Anil Patil Initial Version ************************************************************************************************/ LOAD DATA APPEND -- Type 2 - Lockbox Header INTO TABLE AR_PAYMENTS_INTERFACE WHEN RECORD_TYPE = '2' ( STATUS CONSTANT 'AR_PLB_NEW_RECORD' ,RECORD_TYPE POSITION(01:01) CHAR ,DESTINATION_ACCOUNT POSITION(02:11) CHAR ,ORIGINATION POSITION(12:21) CHAR ,LOCKBOX_NUMBER POSITION(22:27) CHAR ) -- Type 6 - Payment record INTO TABLE AR_PAYMENTS_INTERFACE WHEN RECORD_TYPE = '6' ( STATUS CONSTANT 'AR_PLB_NEW_RECORD' ,RECORD_TYPE POSITION(01:01) CHAR ,LOCKBOX_NUMBER POSITION(02:05) CHAR ,BATCH_NAME POSITION(06:08) CHAR ,ITEM_NUMBER POSITION(09:11) CHAR ,REMITTANCE_AMOUNT POSITION(12:21) DECIMAL external ,TRANSIT_ROUTING_NUMBER POSITION(22:30) CHAR ,ACCOUNT POSITION(31:44) CHAR ,CHECK_NUMBER POSITION(45:54) CHAR ,DEPOSIT_DATE POSITION(55:60) DATE 'YYMMDD' NULLIF DEPOSIT_DATE=BLANKS ) -- Type 4 - Overflow INTO TABLE AR_PAYMENTS_INTERFACE WHEN RECORD_TYPE = '4' ( STATUS CONSTANT 'AR_PLB_NEW_RECORD' ,RECORD_TYPE POSITION(01:01) CHAR ,LOCKBOX_NUMBER POSITION(02:05) CHAR ,BATCH_NAME POSITION(06:08) CHAR ,ITEM_NUMBER POSITION(09:11) CHAR ,OVERFLOW_SEQUENCE POSITION(12:14) CHAR ,OVERFLOW_INDICATOR POSITION(15:15) CHAR ,INVOICE1 POSITION(16:30) CHAR ,CUSTOMER_NUMBER POSITION(34:41) CHAR ,AMOUNT_APPLIED1 POSITION(42:51) DECIMAL external "DECODE(:AMOUNT_APPLIED1,0,NULL,:AMOUNT_APPLIED1)" ) oracle.anilrpatil.com Page 21
  • 22. Implementing Lockbox Data File If you have a Lockbox service arrangement with the bank, you get the Lockbox data file from the bank. If you are using Lockbox to convert Receipts data from other system, you can generate your own data file. Below is a sample data file that was manually generated. 2ANILRPATIL0123456789L820 6L820ZXC0010071935604 4L820ZXC001001015099 4L820ZXC001002015102 4L820ZXC001003015103 4L820ZXC001004015104 4L820ZXC001005060876151 4L820ZXC001006060876153 4L820ZXC001007060876155 4L820ZXC001008060876158 4L820ZXC001009060876159 4L820ZXC001010060876160 4L820ZXC001011060876163 4L820ZXC001012060876164 4L820ZXC001013060876165 4L820ZXC001014060876167 4L820ZXC001015060876169 4L820ZXC001016060876170 4L820ZXC001017060876171 4L820ZXC001018060876174 4L820ZXC001019060876175 4L820ZXC001020060876177 4L820ZXC001021060876178 4L820ZXC001022060876179 4L820ZXC001023060876180 4L820ZXC001024961019788 L13 0030000103148394 00300001031-77336 00300001031-13526 00300001031-56719 0030000103181406 0030000103181406 00300001031162812 0030000103181406 0030000103181406 0030000103181406 0030000103181406 0030000103181406 0030000103181406 0030000103181406 0030000103181406 0030000103181406 0030000103181406 00300001031162812 0030000103181406 00300001031158276 00300001031158276 0030000103181406 0030000103173658 0030000103181406 091120 See http://www.anilrpatil.com/oracle/lockbox_file_creation_template.xls for a sample lockbox data file creation template as per the Transmission Format mentioned above. You can use the Excel file to generate the Lockbox data file. In the Data Sheet of the Excel file, enter/copy your receipts data. This data will be converted in the transmission format in the Text sheet. (Note: Do not insert/delete any columns in the Data sheet as the formula in the Text sheet will become invalid. If you insert/delete any columns, you will have to update the formula in the Text sheet as well). You can change the data as required. After you enter your data, save the Text sheet as a .csv file. Open this .csv file in wordpad to make sure that that file has been created properly. oracle.anilrpatil.com Page 22
  • 23. Implementing Lockbox Reading the Data file: The data for record type 4 has been highlighted in different columns to explain how to make sure that the data in the Lockbox File and the Transmission Format are in sync. • The first column (Position 01:01) indicates the record identifier. In this case, the value is 4 since this is the value we gave to the record type Overflow Payment. oracle.anilrpatil.com Page 23
  • 24. Implementing Lockbox • The second column (Position 02:05) indicates the Lockbox Number. (Value = L820). • The third column (Position 06:08) indicates the Batch Name. (Value = ZXC). • The fourth column (Position 09:011) indicates Item Number. The Item Number would remain the same value for one receipt. • The fifth column (Position 12:14) indicates Overflow Sequence. The overflow sequence is normally a sequential numbering. • The sixth column (Position 15:15) indicates Overflow Indicator. This type indicates whether there are any additional overflow records for this payment. In this case the overflow indicator value is gives as 0. When the Lockbox process gets a value of 0, it will go to the next record for overflow payment application. A non-zero value (in this case 9) indicates end of Overflow Payments. • The seventh column (Position 16:30) indicates the Invoice number. Note that the Invoice number is Left justified and the fill symbol is Blank. Hence you see blank spaces after the Invoice number. • The eighth column contains data that you do not need in your Lockbox process and hence you have not included it in the Transmission Format. • The ninth column (Position 34:41) indicates the Customer Number. Note that the Customer number is Right justified and the fill symbol is Zero. The Customer Number in this case is 1031 and since it is right justified with zero fill symbol, the value in the file for the customer number should be 00001031. • The tenth column (Position 42:51) indicates the amount that needs to be applied to the Invoice. Note that the value of 48294 would actually mean 482.94 because the Format Amount is set to Yes. If the format amount is Yes, Oracle Receivables will round the amount to the same degree of precision and the same number of decimal places as your functional currency format. oracle.anilrpatil.com Page 24
  • 25. Implementing Lockbox Lockbox Processing Steps The following Flowchart shows the Lockbox Processing Steps Lockbox Processing Steps Start Copy Lockbox Data file in required folder Run Submit Lockbox Process Step 1: Import Data is imported in AR_PAYMENTS_INTERFACE_ALL table Rectify errors using Maintain Transmission Data window YES Run Submit Lockbox Process Step 2: Validation QuickCash Batch Created AR_INTERIM_CASH_RECEIPTS_ALL AR_INTERIM_CASH_RCPT_LINES_ALL Any Errors? NO Run Submit Lockbox Process Step 3: PostQuick Cash Receipts applied and Customer Balances updated AR_CASH_RECEIPTS_ALL AR_CASH_RECEIPT_HISTORY_ALL AR_DISTRIBUTIONS_ALL AR_RECEIVABLE_APPLICATIONS_ALL AR_PAYMENT_SCHEDULES_ALL End oracle.anilrpatil.com Page 25
  • 26. Implementing Lockbox Submit Lockbox Process Navigation: Interfaces => Lockbox You submit the Lockbox Process to create receipts and apply them as per the Lockbox data file. The Lockbox is a three step process. Step 1 is importing the data file into Oracle Receivables. Step 2 is validation of the data and Step 3 is the PostQuick Cash process. You can run all these three steps individually or at the same time. Step 1: Import Process • New Transmission: If you are importing a new file, check the New Transmission check box. If you are resubmitting an existing transmission, leave this check box unchecked. • Transmission Name: Provide a transmission name to your Lockbox Submission. If it is not a new transmission, select the Transmission Name from the List of values. • Submit Import: Check the Submit Import check box to import the lockbox file. • Data File: Provide the entire path of the location where the Lockbox file is placed. • Control File: Name of the control file. Do not suffix the file name with .ctl. The control file should be present in the $AR_TOP/bin directory • Transmission Format: Select the required Transmission Format from the List of values. Step 2: Validation Process • Submit Validation: Check this check box if you want to submit the Validation process. • Lockbox: Specify the lockbox number if Submit Validation is Yes and the lockbox number is not specified in your lockbox file. If your transmission format includes the Lockbox Number, Oracle Receivables skips this field. oracle.anilrpatil.com Page 26
  • 27. Implementing Lockbox • GL Date: Enter the date to post the receipt and batch records in this lockbox transmission to your general ledger in the GL Date field. If you defined your GL Date as 'Constant Date' in the Lockboxes window, you must enter a GL Date; if you specified a GL Date of 'Deposit Date' or 'Import Date', Receivables uses this as the GL date. • Report Format: Specify All if you want a detail validation report of all records. Specify Rejects Only if you only want details of the records that failed validation • Complete Batches Only: Check this option if you want Receivables to create receipts only if all the receipt records of the batch are valid. If this option is unchecked, receivables will create receipts for the valid records and the non valid records will be rejected. • Allow Payment of Unrelated Invoices: Check this option if you want Receivables to apply Payments to unrelated Invoices (Invoices belonging to unrelated Customers) • Post Partial Amount as unapplied: If this option is enabled, Lockbox process applies the Receipt to valid transactions and the remaining receipt amount that could not be applied because of invalid transaction numbers is considered as unapplied amount. This option is generally set to Yes. • Reject Entire Receipt: If there are any invalid transaction numbers in the Lockbox file, the entire receipt is rejected. The receipts data remains in the ar_payments_interface_all table. You can update the invalid record using the Maintain Lockbox Transmission Data window. Step 3: PostQuick Cash Process • Submit PostQuick Cash: Check the Submit PostQuick Cash check box, if you want the Lockbox process to run PostQuick Cash process. When Receipts are created using AutoLockbox, Receivables stores the receipt information in interim tables. Running PostQuick Cash applies the receipt and updates your customer’s receivable balance. oracle.anilrpatil.com Page 27
  • 28. Implementing Lockbox Maintain Transmission Data Navigation: Receipts => Lockbox => Maintain Transmission Data You use the Lockbox Transmission Data window to delete and edit transmission data imported into Receivables from your bank using Lockbox. You can correct your lockbox data in this window for receipts that fail validation, then resubmit the validation step to import these receipts. You can use the Lockbox Execution report to help you determine which transmission records you need to correct to ensure that your validation processes succeed. Within each transmission, Receivables displays the lockbox and batch records first, followed by the receipts and overflow records. The lockbox import program assigns a date to transmission records that you import into Receivables and displays transmissions by date when you query them in this window. Check the error messages in the Status field. If the error is contained in the control, receipt, or application information, you can make changes to the invalid records by selecting the record, then choosing one of the following: • Receipt : Choose this button to review and edit specific receipt information. You can change the values of fields that are included in your transmission format • Receipt Attributes: Choose this button to review and maintain receipt descriptive flexfield information imported with your lockbox transmission. You can change the values of fields that are included in your transmission format oracle.anilrpatil.com Page 28
  • 29. Implementing Lockbox • Applications: Choose this button to review and maintain application information for each receipt within this transmission. • Control: Choose this button to review the lockbox transmission control information that corresponds to this transmission record. You can change the values for fields that are included in your transmission format oracle.anilrpatil.com Page 29
  • 30. Implementing Lockbox Identifying Customers for Receipts Now that you are able to do the required setups and successfully import a Lockbox file to create Receipts, let’s look in detail how Receivables identifies Customers for the Receipts. There are several ways by which the lockbox process identifies the Customer for receipts that are imported into Receivables using the Lockbox process. Depending on the Transmission Format and the input data, AutoLockbox can identify and validate the customer and if no customer is identified, it can still create the receipt and assign it the status of Unidentified. Following are the different method 1) Customer Number If a Customer Number is provided in the Lockbox File that you import through AutoLockbox, Receivables will try to apply the receipts using whatever application information is provided in your Transmission Format. E.g. If you have a customer number in the Overflow Payment record type (Record Identifier = 6 in the example shown above), Receivables will apply the receipt to the Customer Number mentioned in your Lockbox File. 2) MICR Number MICR stands for Magnetic Ink Character Recognition). A MICR number consists of two segments. The first segment is the Transit Routing Number and the second segment is the Customer’s Account Number. The Transit Routing Number identifies the bank from which your Customer draws the Check. In Oracle Receivables, this number should be entered in the Bank Branch Number of the Banks window. The Customer Account Number should be entered in the Bank Account Number field of the Banks window. AutoLockbox uses the MICR number to identify and associate the Customer with a receipt only if both the following conditions are True • The MICR number is included in the transmission. • The Customer number is not included in the transmission. In the Transmission Format example shown above, you will notice that you have the Transit Routing Number and Account Number transmission fields included in your Payment record type. You also have the Customer Number field in your Overflow Payment record type. However in the Lockbox data file, you only have values for Customer Number and therefore Receivables associates the Customer based on the Customer Number mentioned in the Overflow Payment records. If you had values in the Lockbox data file for both i.e. MICR number of Payment record type (Transit Routing Number + Account Number) and Customer Number of Overflow Payment record type, Receivables will ignore the MICR number and associate the Customer based on the Customer Number of your Overflow Payment record. 3) AutoAssociate If Receivables cannot determine the Customer based on the MICR number or the Customer number, you can use AutoAssociate to determine the Customer based on the debit item number (Invoice number) mentioned in the Lockbox file. If there is no MICR number or Customer number in the lockbox file and if Auto Associate is set to Yes, Lockbox process will identify the Customer based on the debit item number given in the Lockbox file. This option is also useful when you have scenarios wherein customer A makes payment for Customer B’s invoices. If you are using Auto Associate, when applying payment from Customer A to open invoices of Customer B, the receipt will be identified as paid by Customer B. oracle.anilrpatil.com Page 30
  • 31. Implementing Lockbox If the MICR number and Customer number is not included with the receipt record and if AutoAssociate is set to No, the Receipts are created by Lockbox with a status of Unidentified. Conclusion This document gives you an overview of the Oracle Receivables Lockbox Process and also gives you step by step instructions on implementing Lockbox functionality from scratch. You should now be able to implement Lockbox either for a Lockbox service from Bank or for converting Receipts information from any other sources. Many companies do not utilize the Lockbox service from the bank but would still like to use the Lockbox functionality for the ease to use approach of the Lockbox design for converting Receipts. This document gives you all the required information for doing that. References Oracle Receivables User Guide Release 12 (Part No: B31211-01) Oracle Receivables Implementation Guide Release 12 (Part No: B31212-01) oracle.anilrpatil.com Implementing Lockbox Nov 2009 Author: Anil Patil Email: contact@oracle.anilrpatil.com Appreciate your feedback. Please leave your comments on http://oracle.anilrpatil.com oracle.anilrpatil.com Page 31