You are on page 1of 26

ProCash/DDC

V3.1/00

Message Protocol Extensions

User Guide

Important Note:
This document may only be used by the individual or entity to which it is addressed. This document
may contain information that is privileged, confidential and may not be made public by law or
agreement . If the recipient of this document is not the intended individual or entity, you are hereby
notified that any further dissemination, distribution or copying of this information is strictly prohibited.

All hardware and software names mentioned in this document are trade names and/or trademarks of their respective
manufacturers

® All rights reserved by Wincor Nixdorf International GmbH 2000 - 2015

Edition November 2015


Copyright and Trademarks

Copyright © Wincor Nixdorf GmbH 2015.


All rights, including rights of translation by printing, copying or similar methods, even of parts, are reserved.
All rights, including rights created by patent grants or registration of a utility model or design, are reserved. Delivery
subject to availability; right of technical modifications reserved.
All names of hardware and software products mentioned in this manual are trade names and/or trademarks of
their respective manufacturers.
All hardware and software names used are trademarks of their respective manufacturers.
Reliant® is a registered trademark of Pyramid Technology Corporation.
SINIX is the UNIX® System derivative of Wincor Nixdorf GmbH
UNIX is a registered trademark in the United States and other countries, licensed exclusively through
X/Open Company Limited.
Base: OSF/Motif™, Copyright © Open Software Foundation, Inc.
X Window System™, Copyright © Massachusetts Institute of Technology.
OSF/Motif is a trademark of Open Software Foundation, Inc.
X Window System is a registered trademark of Massachusetts Institute of Technology.
MS-DOS® and Windows® are registered trademarks of Microsoft Corporation in the United States and other
countries.
BLK Cash Messages Extension

BLK Cheque Messages Extension


4 November 2015
Contents

Contents
Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

BLK Cash Messages Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1


Function Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Supported Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Wincor Nixdorf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Other Vendors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
– NCR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
– DIEBOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Host To Terminal messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
– Write Command 3 Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
– Write Command 20 Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
– Basic Operational Command Message . . . . . . . . . . . . . . . . . . . . . . . . 3
– Enhanced Function Command Message (ID 7) . . . . . . . . . . . . . . . . . 4
Terminal To Host messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
– Solicited Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
– Unsolicited Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
– Transaction Request Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Exceptions and Reject Reasons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Terminal Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

BLK Cheque Messages Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1


Function Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Supported Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Wincor Nixdorf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Other Vendors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
– NCR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
– DIEBOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Deposit State (C) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Enhanced States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Depositor State (DP ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Image Character Recognition State (IC ) . . . . . . . . . . . . . . . . . . . . . . . . . 3
Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Display Control Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

November 2015 1
Contents

Host To Terminal messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5


– Write Command 3 Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
– Function Command Message (ID 4) . . . . . . . . . . . . . . . . . . . . . . . . . . 5
– Enhanced Function Command Message (ID 7) . . . . . . . . . . . . . . . . . . 6
Terminal To Host messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
– Solicited Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
– Unsolicited Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
– Transaction Request Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Exceptions and Reject Reasons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Terminal Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 November 2015
BLK Cash Messages Extension

Function Overview
Since release 3.0/10 ProCash/DDC supports Diebold’s Bulk Notes Acceptor
(BLK) message protocol. The following sub sections give detailed instructions
about the DDC message format extensions and parameters which are
necessary for the host programmer to integrate the Diebold’s Bulk Notes
Acceptor support in the DDC network. It will also be described how to setup
ProCash/DDC on the client side for Bulk Notes Acceptor message processing.

This document describes following areas:


• Supported hardware systems
• Messages and field extensions
• Parameters and options related to BLK message processing
• Restrictions

November 2015 1
Supported Hardware BLK Cash Messages Extension

Supported Hardware
Diebold’s Bulk Notes Acceptor messages are supported on the following pure
cash deposit devices and cash recycling systems which are released by
ProCash/DDC.

Wincor Nixdorf

• CINEO systems RM3 (Recycling Module 3)


• PC4000 systems RM2 (Recycling Module 2)
• CCDM V1/V2 (Cash Cheque Deposit Module V1/V2)
• CRS systems (old series)

Other Vendors

NCR

• BNA (Bank Note Acceptor)


• SDM (Scalable Deposit Module)
• GBRU (Global Bill Recycling Unit)

DIEBOLD

• ENA (Enhanced Note Acceptor)


• BNA (Bulk Note Acceptor)
• BCR (Bulk Cash Recycler)

Messages
The following sections describe the DDC host to terminal and terminal to host
messages which are involved if Diebold’s Bulk Notes Acceptor message
processing is enabled.

2 November 2015
BLK Cash Messages Extension Messages

Host To Terminal messages

This chapter describes the host to terminal messages and relevant extensions
for BLK message processing.

Write Command 3 Message

The Write Command 3 message configures terminal parameters and timers.


Bit 5 (value 32) of Miscelleaneous Features 4 specifies if expanded MDS status
information of a Bulk Cash Recycler should be reported. This feature is not
supported by ProCash/DDC. For format and field details please refer to
documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

Write Command 20 Message

The Write Command 20 message is used to enable or disable selected note


types. For format and field details please refer to documents ProCash/DDC
3.1/00 User Guide and Agilis 91x® XV Terminal Programming Manual.

Basic Operational Command Message

This message has different command codes which specify the type of the
operational command message.
Involved Command Codes for BLK information:
• Code 3 - Configuration Information Request
The host sends terminal command 1|||3 to retrieve the terminal
configuration.
• Code ; - Retrieve Enhanced Supply Counts
The host sends terminal command 1|||; to retrieve the terminal
supply counters.
• Code < - Retrieve Then Set or Clear Enhanced Supply Counts
The host sends terminal command 1|||< to retrieve the terminal
supply counters.
For format and field details please refer to documents ProCash/DDC 3.1/00 User
Guide and Agilis 91x® XV Terminal Programming Manual

November 2015 3
Messages BLK Cash Messages Extension

Enhanced Function Command Message (ID 7)

The host sends an Enhanced Function Command Message with function data
(CI ) for the Currency acceptor to the terminal. For format and field details
please refer to documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV
Terminal Programming Manual.

Terminal To Host messages

This chapter describes the terminal to host messages and relevant extensions
for the BLK message processing.

Solicited Status

Hardware Configuration Status (DID = B)


In response to the Basic Operational Command Message 1|||3 "Configuration
Information Request", the terminal sends the Hardware Configuration
Status (DID = B) message to the central. For format and field description please
refer to documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

Retrieve Enhanced Supply Counts


In response to the Basic Operational Command Message message 1|||;
"Retrieve Enhanced Supply Counts", the terminal sends the supply counters of
the terminal, which includes the cash deposit counters, to the central. For format
and field description please refer to documents ProCash/DDC 3.1/00 User Guide
and Agilis 91x® XV Terminal Programming Manual.

Retrieve Then Set or Clear Enhanced Supply Counts


In response to the Basic Operational Command Message message 1|||<
"Retrieve Then Set or Clear Enhanced Supply Counts", the terminal sends the
new supply counters of the terminal, which includes the cleared cash deposit
counters, to the central. For format and field description please refer to
documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

4 November 2015
BLK Cash Messages Extension Exceptions and Reject Reasons

Enhanced Status (solicited) (Status Descriptor = J)


Currency Acceptor device status solicited messages are sent as Enhanced
Status via four digit Device ID ’CI01’. For format and field description please
refer to documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

Unsolicited Status

Enhanced Status (unsolicited) (Status Descriptor = J)


Currency Acceptor device status unsolicited messages are sent as Enhanced
Status via four digit Device ID ’CI01’. For format and field description please
refer to documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

Transaction Request Message

The terminal sends multiple Buffer ID’s with cash deposit data to the central.
For format and field description please refer to documents ProCash/DDC 3.1/00
User Guide and Agilis 91x® XV Terminal Programming Manual.

Exceptions and Reject Reasons


This section desribes the Exceptions and Restrictions of BLK message
processing.
• The BLK message processing does not support coin deposits
• Mixed Media processing of Cheques and notes is not supported

November 2015 5
Terminal Configuration BLK Cash Messages Extension

Terminal Configuration
The following table lists the local terminal parameters which are involved to
enable BLK message processing. Please refer to the ProCash/DDC 3.1/00
Installation & Configuration manual for detailed parameter description.
Table 1: Registry cross link [CCCASHINTRANSACTIONFW]
USER AREA in"CUSTOM.PPF" REGISTRY LOCATION
[CCCASHINTRANSACTIONFW] [HKEY_LOCAL_MACHINE\SOFTWARE\
Wincor Nixdorf\ProTopas\CurrentVersion\LYNXCAIN\
CCCASHINTRANSACTIONFW]
USER NAME REGISTRY PARAMETER
MESSAGE_MODE MESSAGE_MODE

6 November 2015
BLK Cheque Messages Extension

Function Overview
Since release 3.0/20 ProCash/DDC supports Diebold’s Bulk Cheque Deposit
(BLK) message protocol. The following sub sections give detailed instructions
about the DDC message format extensions and parameters which are
necessary for the host programmer to integrate the Diebold’s Bulk Cheque
Deposit support in the DDC network. It will also be described how to setup
ProCash/DDC on the client side for Bulk Cheque Deposit message processing.
The BLK Cheque Messages Extension also has included the description for
Single Cheque processing on single Cheque deposit devices.

This document describes following areas:


• Supported hardware systems
• States (without ProFlex)
• Screens (without ProFlex)
• Messages and field extensions
• Parameters and options related to BLK message processing
• Restrictions

November 2015 1
Supported Hardware BLK Cheque Messages Extension

Supported Hardware
Diebold’s Bulk Cheque Deposit messages are supported on the following
Cheque deposit devices which are released by ProCash/DDC.

Wincor Nixdorf

• CCDM V1/V2 (Cash Cheque Deposit Module V1/V2) (bundle Cheque)


• SEAC Scanner (single Cheque)
• Reiner Scanner (single Cheque)

Other Vendors

NCR

• CPM (Single Cheque Accept Module)


• BCA (Bunch Cheque Acceptor)
• SDM (Scalable Deposit Module) (bundle Cheque)

DIEBOLD

• IDM4 (Intelligent Deposit Module fourth-generation)


• IDM5 (Intelligent Deposit Module fifth-generation)
• IDM(BD) Bulk Document IDM

2 November 2015
BLK Cheque Messages Extension States

States
Cheque Deposit transactions can be built either via multiple states or via
multiple function commands sent via Function Command Message sent by the
host. This section describes the relevant states which are needed to perform
Cheque Deposit transactions via the navigation through the state table. In the
Diebold protocol there are defined several basic and extended states, where the
switch provider can decide which of those states are needed to be used for the
Single or/and Bundle Cheque deposit processing.

Deposit State (C)

The Deposit State (C) tells the terminal how to process a deposit operation.
For format and field details please refer to document ProCash/DDC 3.1/00 User
Guide and Agilis 91x® XV Terminal Programming Manual.

Enhanced States

Depositor State (DP )

The Deposit State (DP ) can be used for Single and Bulk Cheque deposit
processing. The deposit state data directs the terminal to perform specific
deposit operations. For format and field details please refer to document
ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal Programming
Manual.

Image Character Recognition State (IC )

The Image Character Recognition State (IC ) determines how a given document
is interpreted, which fields on the document to recognize and where to store the
information found in those field locations. Using this state requires the
installation of Image recognition software (e.g. A2iA Check Reader). The fields
and zones which are needed to be recognized have to be defined in the
customer project. For format and field details please refer to document
ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal Programming
Manual.

November 2015 3
Screens BLK Cheque Messages Extension

Screens
This section describes just the part how to display Check images on consumer
screens. For more information about screen control sequences and how to
setup consumer screens refer to ProCash/DDC 3.1/00 User Guide and Agilis
91x® XV Terminal Programming Manual.

Display Control Sequences

Check Images on the consumer screen can be displayed via escape control
sequence ESC Q or ESC @ nnn.
ESC Q
This control sequence displays a front side Cheque image on screen, which is
locally configured via parameter CHQ_FRONT_IMG, where file name and file
path is specified. The width and height of the image can be defined via
parameter CHQ_SIZE. Refer to ProChequeIn 3.1/00 Installation & Configuration
Manual for detailed parameter descriptions.
ESC @ nnn
This control sequence can display either a front side or back side Cheque image
on screen in two resolutions, 640x240 or 320x120 pixels. The types of images
are locally configured via parameters CHQ_FRONT_IMG and
CHQ_BACK_IMG, where the file names and file paths are specified. Refer to
ProChequeIn 3.1/00 Installation & Configuration Manual for detailed parameter
descriptions.

4 November 2015
BLK Cheque Messages Extension Messages

Messages
The following sections describe the DDC host to terminal and terminal to host
messages which are involved if Diebold’s Bulk Cheque Deposit message
processing is enabled.

Host To Terminal messages

This chapter describes the host to terminal messages and relevant extensions
for BLK Cheque Deposit message processing.

Write Command 3 Message

The Write Command 3 message configures terminal parameters and timers.


Bit 5 (value 32) of Miscelleaneous Features 4 specifies if expanded MDS status
information of a Bulk Cash Recycler should be reported. This feature is not
supported by ProCash/DDC. For format and field details please refer to
documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

Function Command Message (ID 4)

The host can send following Function Commands in a Function Command


Message (ID 4) for Cheque Deposit processing to the terminal:
• Deposit Check to Escrow (R) (not supported)
• Return Check if on Escrow (S) (rollback and Eject Cheque)
• Retain Check if on Escrow (T) (deposit Cheque)

For format and field details please refer to documents ProCash/DDC 3.1/00 User
Guide and Agilis 91x® XV Terminal Programming Manual.

November 2015 5
Messages BLK Cheque Messages Extension

Enhanced Function Command Message (ID 7)

The host sends an Enhanced Function Command Message with function data
(DP ) for Cheque Deposit processing to the terminal. For format and field details
please refer to documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV
Terminal Programming Manual.

Terminal To Host messages

This chapter describes the terminal to host messages and relevant extensions
for the BLK Cheque Deposit message processing.

Solicited Status

Hardware Configuration Status (DID = B)


In response to the Basic Operational Command Message 1|||3 "Configuration
Information Request", the terminal sends the Hardware Configuration
Status (DID = B) message to the central. For format and field description please
refer to documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

6 November 2015
BLK Cheque Messages Extension Exceptions and Reject Reasons

Enhanced Status (solicited) (Status Descriptor = J)


Cheque Deposit device status solicited messages are sent as Enhanced Status
via four digit Device ID ’DP01’. For format and field description please refer to
documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

Unsolicited Status

Enhanced Status (unsolicited) (Status Descriptor = J)


Cheque Deposit device status unsolicited messages are sent as Enhanced
Status via four digit Device ID ’DP01’. For format and field description please
refer to documents ProCash/DDC 3.1/00 User Guide and Agilis 91x® XV Terminal
Programming Manual.

Transaction Request Message

The terminal sends multiple Buffer ID’s with Cheque deposit data to the central.
For format and field description please refer to documents ProCash/DDC 3.1/00
User Guide and Agilis 91x® XV Terminal Programming Manual.

Exceptions and Reject Reasons


This section desribes the Exceptions and Restrictions of BLK Cheque message
processing.
• Mixed Media processing of Cheques and notes is not supported

November 2015 7
Terminal Configuration BLK Cheque Messages Extension

Terminal Configuration
The following table lists the local terminal parameters which are involved to
enable BLK message processing. Please refer to the ProCash/DDC 3.1/00
Installation & Configuration manual for detailed parameter description.
Table 1: Registry cross link [CCCASHINTRANSACTIONFW]
USER AREA in"CUSTOM.PPF" REGISTRY LOCATION
[CCCASHINTRANSACTIONFW] [HKEY_LOCAL_MACHINE\SOFTWARE\
Wincor Nixdorf\ProTopas\CurrentVersion\LYNXCAIN\
CCCASHINTRANSACTIONFW]
USER NAME REGISTRY PARAMETER
MESSAGE_MODE MESSAGE_MODE

8 November 2015
Abbreviations
API Application Program Interface

ARC Application Return Code

ASCII American Standard Code for Information Interchange

ATM Automated Teller Machine

ADRS Automatic Device Repair System

CI Customization Image

CRS Cash Recycling System

CRT Cathode Ray Tube

CSC Customer Service Center

EBCDIC Extended Binary Coded Decimal Interchange Code

FDK Function Display Key

FIT Financial Institution Table

ID IDentification

IDCU ID Card Unit

MDS Modular Delivery System

NCR National Cash Register

DDC Diebold Direct Connect

PC Personal Computer

PPF Parac Parameter File

November 2015 9
Abbreviations

10 November 2015
Tables

Tables
Table 1: Registry cross link [CCCASHINTRANSACTIONFW] . . . . 6

Table 1: Registry cross link [CCCASHINTRANSACTIONFW] . . . . 8

November 2015 1
Tables

2 November 2015
Related publications

Available manuals

ProCash/DDC manuals
DESIGNATION VERSION ORDER NUMBER
ProCash/DDC User Guide manual 3.1/00 (PDF file)
ProCash/DDC Installation & Configuration 3.1/00 (PDF file)
Wincor Nixdorf NDC/Diebold D91x 1.53 (PDF file)
Message Format Extension for Cash In

ProCash/DDC User Guide manual


Provides detailed function description about ProCash/DDC operation and DDC
Host to terminal and Terminal to Host messages (Download Commands, Trans-
action Request and Reply messages, Terminal Commands, Status messages,
etc.).
ProCash/DDC Installation & Configuration manual
This manuals contains detailed descriptions of configuration parameters of
ProCash/DDC, which are stored in the Windows registry. Further contents are
descriptions about several Utilities which are additionally delivered.
Wincor Nixdorf NDC/Diebold D91x
Message Format Extension for Cash In
Specifies protocol extensions (State tables, messages) for cash in functions
defined by Wincor Nixdorf.

Documents from other Vendors


DESIGNATION VENDOR
Agilis 91x® XV Terminal Programming Manual Diebold

Agilis 91x® XV Terminal Programming Manual


Specifies Diebolds’s DDC message protocol in detail.

November 2015 3
Related publications

4 November 2015

You might also like