Integrated Currency Manager (ICM) DNAapp. DNAX Name: ICM.dnax Application ID: 5d48c147-f32c dcdcf4fab

Transcription

1 DNAX Name: ICM.dnax Application ID: 5d48c147-f32c dcdcf4fab

2 , Inc. or its affiliates. All rights reserved. This work is confidential and its use is strictly limited. Use is permitted only in accordance with the terms of the agreement under which it was furnished. Any other use, duplication, or dissemination without the prior written consent of, Inc. or its affiliates is strictly prohibited. The information contained herein is subject to change without notice. Except as specified by the agreement under which the materials are furnished,, Inc. and its affiliates do not accept any liabilities with respect to the information contained herein and is not responsible for any direct, indirect, special, consequential or exemplary damages resulting from the use of this information. No warranties, either express or implied, are granted or extended by this document. is a registered trademark of, Inc. Other brands and their products are trademarks or registered trademarks of their respective holders and should be noted as such. Integrated Currency Manager (ICM) Page 2 September 2017

3 Overview The Integrated Currency Manager (ICM) DNAapp is a cash supply chain management and optimization tool that automates precise cash forecasts for various cash points, e.g., ATMs, branches, vendors, and vaults. Key Benefits This app combines complex forecasting with historical trends to reduce currency outages and expensive emergency deliveries to restock empty ATMs. It also optimizes your institution's transportation schedules so you can balance the cost of currency with the cost of delivery. Processing When the ICM app is integrated with DNA, the non-updating ICM Extract (ICM_EXTRACT) report generates an extract of historical cash usage data to import into the ICM application to forecast future cash demands. The application generates extracts for teller-level and/or consolidated transactions for each cash point type (e.g., teller, ATM, and vault) based on the Report Type (RTYP) parameter value. The Use Cash Count Processing (USCC) institution option captures the cash currency type data required by ICM and must be set to Y to prompt the user for the cash currency type. Exclusions The following transactions are excluded: Transactions between cash points such as Cashbox to Vault/ATM or Vault to Cashbox/ATM or ATM to Vault/Cashbox are excluded from both the consolidated and teller-level extract. These types of internal transfers are excluded from the shipin and shipout tags. Non-currency transactions are excluded from the extract. Parameters The following parameters are used to select the transactions for cash forecasting in the ICM_EXTRACT file: Parameter Req d Default Description of Value(s) Output File Path (COUP) No Null Complete path name of the output file location. The trailing backslash is optional, e.g., C:\TEMP\ Report Type (RTYP) No BOTH Type of report. TELLER = Only include teller-level transactions CONSOLIDATED = Only include consolidated transactions BOTH = Include both teller-level and consolidated transactions EffectiveDate (EFF) No Null Effective date of the report Report Option (ROPT) No DENOM Indicates which report to generate. DENOM = Denomination report AGGREGATE = Aggregate report Company Code (6CCD) Yes Null Company code provided by ICM Integrated Currency Manager (ICM) Page 3 September 2017

4 Parameter Req d Default Description of Value(s) Exclude Cashbox Nbr(s) (6ECN) Variables No Null Comma-separated cashbox number(s) to exclude from reporting (consolidated and teller level) The following external interface variables map DNA values to the ICM external interface values the extract file uses to import data into ICM for cash forecasting. Variable setup is completed on the External Interface Cross Reference screen: External Interface Interface Variable Description ICM Interface (6ICM) ICM Denominations (6IDC) Maps the DNA denomination codes to the ICM denomination codes ICM Till Type (6ITT) Maps the DNA cashbox type code to the ICM till types The values of the FROM VALUE and TO VALUE fields on the External Interface CrossReference system table must be set for the ICM Interface (6ICM) external interface variables as shown in the table below. Interface Variable From Value To Value ICM Denominations (6IDC) DNA denomination code, e.g., HUND ICM denomination code, e.g., USDN10000 ICM Till Type (6ITT) DNA cashbox type code, e.g., ATM ICM till type, e.g., Dispenser Sample Data The following table includes sample data for mapping the variable values. External Interface Code Interface Variable Code From Value To Value 6ICM 6IDC HUND USDN ICM 6IDC FIFT USDN ICM 6IDC TWNT USDN ICM 6IDC TENS USDN ICM 6IDC FIVE USDN ICM 6IDC DOL2 USDN ICM 6IDC DOL1 USDN ICM 6IDC DOLC USDL ICM 6IDC HALF USDL ICM 6IDC QUAR USDL ICM 6IDC DIME USDL00010 Integrated Currency Manager (ICM) Page 4 September 2017

5 External Interface Code Interface Variable Code From Value To Value 6ICM 6IDC NIKL USDL ICM 6IDC PENY USDL ICM 6IDC MISC USDL ICM 6ITT VLT Vault 6ICM 6ITT VLT1 Vault 6ICM 6ITT LTV Vault 6ICM 6ITT ATM Dispenser 6ICM 6ITT ATM2 Dispenser 6ICM 6ITT CDM Dispenser Notes: Till types other than the ones listed above are considered regular cash points. The FROM VALUE is based on your financial institution s requirements. The values shown above represent sample data. All cashbox type codes mapped to Dispenser are provided to ICM in the consolidated type report. Scheduling and Re-Run Information Run the ICM app after cashbox proofing and end-of-day processing. This application can be rerun. File Layouts The ICM Extract (ICM_EXTRACT) report generates the following files: ICM_Extract.lis ITRIM_cccc_YYYYMMDDHHMMSS.xml, where CCCC = Company code YYYYMMDD = File creation date HHMMSS = File creation time Integrated Currency Manager (ICM) Page 5 September 2017

6 ICM_Extract.lis This file has the following output when the Report Type (RTYP) parameter is set to TELLER: Output File [file name] created Description Name and location of the extract file Confirmation that the extract file was created Cash Position Summary Total Branches Total Tellers Total ATMs Total Vaults Total number of branches Total number of tellers Total number of ATMs Total number of vaults ITRIM_cccc_YYYYMMDDHHMMSS.xml The layout for XML file extract is below: Field Name filecreateddate companyreferenceid entityreferenceid transactiontype transactiondate tellerreferenceid tilltype Currency code Denomination code fitness hopper beginningbalance cashin Description Date and time the file was generated Company reference ID Entity reference ID for entity-generating transactions Transaction type for the report: Aggregate or Denomination Date the transaction was sent Unique identifier (cashbox number) for the teller machine; displays only if transactions generate at the teller level. Teller till type; displays only if transactions generate at the teller level. Type of cash point: ATM = Dispenser Vault = Vault Teller = Regular Currency code defined for the currency element Denomination code defined for the denomination element DNA does not maintain fitness value data; N/A displays DNA does not maintain hopper value data; this field displays no data Beginning balance count and amount values for the cash point Cash in count and amount values for the cash point Integrated Currency Manager (ICM) Page 6 September 2017

7 Field Name cashout shipin shipout endingbalance amount count comments Description Cash out count and amount values for the cash point Ship in count and amount values for the cash point Ship out count and amount values for the cash point Ending balance count and amount values for the cash point Amount values for elements such as BEGINNINGBALANCE, SHIPIN, SHIPOUT, CASHIN, CASHOUT, and ENDINGBALANCE Denomination unit count values for elements such as BEGINNINGBALANCE, SHIPIN, SHIPOUT, CASHIN, CASHOUT, and ENDINGBALANCE DNA does not capture this data; this field displays no data Installation Instructions If you are an in-house client, follow the installation instructions available in the "DNAapps" section of the DNA Help files available on the extranet at DNA In-House. If you are a data center client, a Compass case is automatically created when you order a trial or paid version of a DNAapp and routed to the Data Center team for installation. Data center DNAapp installation typically takes two weeks; however, the time frame varies depending on the complexity of the app, case load, and the responsiveness of the client and/or third parties. Check the app installation status in Compass or contact your Client Service Partner. What You Should Do To integrate the ICM DNAapp, you must: Install the ICM.dnax. See the Installation Instructions section in this document. Set the Use Cash Count Processing (USCC) institution option to Y. See the "Institution Options" online Help topic for detailed instructions. Navigate to System > Institution > Institution Options. Set the values of the FROM VALUE and TO VALUE fields in the External Interface CrossReference system table for the ICM Interface (6ICM) external interface variables. See the External Interface CrossReference Maintenance Procedures online Help topic for detailed instructions. Navigate to System > System Tables > C-G Tables > External Interface CrossReference. Assign the ICM Extract (ICM_EXTRACT) report to the appropriate daily batch queue. See the Assigning and Maintaining Queue Applications online Help topic for detailed instructions. Navigate to Batch > Manage Queues. Integrated Currency Manager (ICM) Page 7 September 2017

8 Configuration Checklist Item Test Environment Production Environment Install Integrated Currency Manager DNAapp (ICM.dnax) Set Institution Option Configure variables Assign the extract report to the appropriate daily batch queue Revisions Date App Version # Change 6/1/ Initial version 08/17/ Internal transactions between cash points are excluded from both the consolidated and teller-level extract Integrated Currency Manager (ICM) Page 8 September 2017