EU ECatalogs Addendum v2

DMS Reference Guide
EU_eCatalogs_addendum v.2
oktober - 2008
After Sales eBusiness Services

Case New Holland - After Sales eBusiness Services
© 2008 Case New Holland
CNH disclaims all warranties, expressed or implied, with regard to this DMS reference guide provided by CNH to the
providers of Dealer Management Systems (DMS) and/or CNH dealers, including all implied warranties of
merchantability and fitness for a particular use.
CNH reserves the right to modify , revise or enhance this DMS Reference user guide.
This DMS Reference user Guide is property in which CNH has proprietary rights. CNH reserves all rights to this
document, which is not to be disclosed to persons or companies other than those authorized by CNH in writing. No
portion of this text may be reproduced without the written permission of CNH.
Printed: oktober 2008

Contents 3
Table of Contents
0
1 Introduction 4
1 About this
...................................................................................................................................
interface reference manual 4
2 Document
...................................................................................................................................
control 4
3 General ................................................................................................................................... 4
2 Additional Technical Information 5

1 System Requirements
................................................................................................................................... 5
2 Pricing Method
................................................................................................................................... 5
3 Group Transactions
................................................................................................................................... 6
4 Batch Limit
................................................................................................................................... 6
5 DMS-ID ................................................................................................................................... 7
Example without DMS-Id
..........................................................................................................................................................
String 8
Example with DMS-Id
..........................................................................................................................................................
String 10
3 Testing the interface 12

1 Installation
...................................................................................................................................
Instructions 12
Connecting to PAL..........................................................................................................................................................
/ SP2 On Line 12
Installation of PAL..........................................................................................................................................................
/ SP2 On Line 13
2 How to ...................................................................................................................................
configure PAL/SP2 On Line 14
3 Debugging
................................................................................................................................... 15
4 TCP Listener
................................................................................................................................... 17
4 Display PPL prices in PAL / SP2 Online 18

1 Configure
...................................................................................................................................
PAL / SP2 Online to show PPL prices 18
2 Importing
...................................................................................................................................
the PPL into PAL / SP2 Online 19
3
4 EU_eCatalogs_addendum v.2
1 Introduction
1.1 About this interface reference manual

THIS INTERFACE REFERENCE MANUAL IS :
This interface reference manual contains
v Important additional technical Specifications to the PVA IP to Business System Interface (see
EU_eCatalogs_PVA_IP_BSI_v2.pdf)
v Installation and configuration instructions
v Testing instructions
1.2 Document control

Version Revision Date Revision History Author
v.01 25/09/2008 First release Dirk Lagauw
v.02 16/10/2008 Included remark about new TCP listener Dirk Lagauw
Please ensure you replace old versions of interface specifications when you receive new versions.
The Revision History above will guide you to what has changed. Please inform your staff as
appropriate.
CNH is committed to the continuous improvement of Dealer communication systems and the
development of interfaces between the dealer management systems and the CNH Software. If you
have any suggestions to improve this document, please contact dleudmssupport@cnh.com
1.3 General
v PAL / SP2 has been launched in September 2008 to all European dealer and distributors
v On line PAL / SP2 is a new application written in dot NET 2.0 with new Graphical User Interface
and some new functionalities to meet the business needs of the CNH branded dealers.
v The On Line version of PAL / SP2 does not replace the DVD's but comes in addition to them.
v On Line PAL / SP2 has a different GUI versus the DVD's. At a later stage the DVD's will be
upgraded with the same GUI.
v The IP interface to PAL / SP2 On Line works also with the DVD versions of PAL and SP2
v The "old" interface that DMS Vendors have developed in the past to work with the DVD's will
continue to work until the DVD's will be upgraded with the new GUI (+/- mid 2009)
v The installation of PAL / SP2 On Line requires Microsoft .NET 2.0 Service Pack 1 being installed
on every computer that will use Online PAL/SP2 at the dealership. The installation procedure
prompts for this installation in case it was not found on the PC.

Additional Technical Information 5
2 Additional Technical Information
2.1 System Requirements

1. The installation of PAL / SP2 On Line requires Microsoft .NET 2.0 Service Pack 1 being installed on
every computer that will use Online PAL/SP2 at the dealership. The installation procedure prompts
for this installation in case it was not found on the PC.
2. Currently, the download size is 23,6 MB.
3. Fore reference , this list of supported Operating systems is derived from the Microsoft .NET 2.0
Service Pack 1 web page under the System Requirements section. Review the system requirements
on the Microsoft download site for any updates or changes :
Supported :
v Windows 2000 Service pack 4

v Windows XP Professional Service Pack 2
v Windows Server 2003
v Windows Vista
No longer supported :
v Windows 98
v Windows 98 second edition
v Windows Me
v Windows NT
2.2 Pricing Method

Within the PVA IP Business System Interface (Version 2) specification , two parts pricing methods are
outlined :
v Method 1 - Required for , and only compatible with, the current DVD version of PAL / SP2.
Method 1 parts pricing is only a temporary measure that will be phased out when the DVD
version is migrated in the near future to the new dot NET version currently used for Online PAL /
SP2
v Method 2 - Required for the Online PAL / SP2 and will be also required in the near future when
DVD is migrated to the new dot NET version currently used for Online PAL / SP2

2.3 Group Transactions

To assist with a DMS request to shorten response cycles , an enhancement has been put in place
where the Online Parts Catalog program is now 'grouping' the transaction requests together for multiple
pricing submissions. DMS's see a change in the way that the current version of Online PAL / SP2 is
requesting pricing from the DMS interface to the example shown below
BOT|107
GET|107|VALUES|Price|PriceCd=P0012|Manuf=001NHNA|PartNum=18
EOT|107|RCRDSSENT=4
2.4 Batch Limit

Under Tools / Options / DMS Tab - a new field is available called DMS BATCH LIMIT.
The batch limit will determine the maximum number of parts that are queried for On-Hand values in each
of the additional information windows, e.g. priors , substitutions, Kits, components, Gold Value and
Reman.
Example 1 : DMS Batch Limit = 10 (Default Value)
If a particular Part detail is displayed where that part has 15 priors and 3 substitutions, the submission
to the DMS would request the On-Hand value for the particular part plus the On-Hand values for the first
10 Priors and for all the Substitutions.
Example 2 : DMS Batch Limit = 0
If a particular Part detail is displayed where that part has 15 priors and 3 substitutions, the submission
to the DMS would only request the On-Hand value for the requested part.
This option is useful to limit the network traffic in case a dealer does not have enough bandwidth.

2.5 DMS-ID
Change to Online PAL / SP2 (version 1.08.09.26) , effective September 27, 2008 :
v The Dealer=<value> was not being submitted to the DMS in previous versions of the program. This
is because we had not provided a method to display/enter this value.
v The Tools / Options menu / DMS Tab now includes a field for entering this value and it is named
"DMS Id String"
v Default behaviour is that the Dealer=<Value> parameter is not included in the DMS communication
stream when there is no value in this field. This is also the current behavior today. See
WithOutDMSId for an example.
v However , if the field is populated with a value it will be submitted as per the specification. See
WithDMSId for an example.
v An example of where a DMS might want to use this new field :

Ø When one BSI Listener is utilized for multiple dealership locations, filling in this field will
determine which location is sending the transaction
Ø This is merely a suggestion as the DMS can direct the dealership to enter whatever value is
necessary

2.5.1 Example without DMS-Id String


2.5.2 Example with DMS-Id String


3 Testing the interface

In order for the DMS's to test this interface it is necessary to install PAL / SP2 On Line and connect to
the application as if you where a dealer. For this purpose user Id's and passwords are available.
In case you did not receive a User Id and Password or do not remember them please contact
dleudmssupport@cnh.com .
3.1 Installation Instructions
3.1.1 Connecting to PAL / SP2 On Line
The URL to connect to PAL / SP2 On Line is
https://webparts.pvassociates.net/cnh/
Note : You can click on the appropriate flag to choose a language
Use your user id and password to log into PAL / SP2 On Line
The user id and password necessary to connect to this website has been send to all DMS Vendors by
email.
If you do not have a user id and password please contact dleudmssupport@cnh.com

Testing the interface 13
3.1.2 Installation of PAL / SP2 On Line
Once you have successfully logged in you should see the following options on the left side of the screen
Click on <<Documentation>> under Online PAL / SP2 , then click on PAL Installation Guide to
download a detailed installation reference guide. Please follow carefully the instructions from this
installation guide and install the program.
The link <<Quick reference Card>> gives basic information on how to use PAL / SP2 Online.
Note : The installation procedure creates a desktop icon which can be used once you have installed
PAL / SP2 Online successfully to launch the application any time in the future

3.2 How to configure PAL/SP2 On Line

In order to link a DMS with PAL / SP2 Online
· Click on <<Tools>> / <<Options>>

· Click on the <<DMS>> Tab
· Uncheck the "disabled" checkbox
· Enter IP address and port
· Modify the Batch limit if required (see DMS Batch Limit)
· Enter DMS Id String if required (See DMS-ID)
· Click on <<TEST>> to verify if the connection is working

· Click on <<SAVE>> to save the configuration

3.3 Debugging
A Debug mode has been foreseen to help the testing of the interface.
To activate the debug mode PAL / SP2 Online has to be started with a switch as follows:
"C:\Program Files\PowerView.NET\powerview.exe" /DMSDEBUG:1
In this mode a log file will be created containing only the interface information.
The log files are generated in the user directory defined in the help – About option :
Example of a log file
Application Name : PowerView

Application Version : 1.0.0.0826
Command Line : "C:\Program Files\PowerView.NET\powerview.exe" /DMSDEBUG:1
Current Directory : C:\Program Files\PowerView.NET
OS Version : Microsoft Windows NT 5.1.2600 Service Pack 2
.NET Version : 2.0.50727.1433
System NewLine Char :
Boot Mode : Normal

Double Byte Char Enabled : False
Computer Name : DUSXPE2097295
Monitors on System :2
Primary Max Window Size : {Width=1032, Height=712}
Primary Monitor Size : {Width=1024, Height=768}
Processor Count :1
08:23:10 D 15 CommThread PV Writes : BOS
08:23:11 D 15 CommThread PV Reads: BOS
08:23:11 D 15 CommThread PV Writes : BOT|100
08:23:11 D 15 CommThread PV Writes : GET|100|VALUES|OnHandAllLbl|Manuf=001CSC
08:23:11 D 15 CommThread PV Writes : EOT|100|RCRDSSENT=1
08:23:11 D 15 CommThread PV Writes : GET|101|VALUES|BinLocLbl1,BinLocLbl2,BinLocLbl3,BinLocLbl4,BinLocLbl5,

BinLocLbl6,BinLocLbl7,BinLocLbl8,BinLocLbl9,BinLocLbl10|Manuf=001CSC
08:23:11 D 15 CommThread PV Writes : GET|102|VALUES|AvailPriceCd,PriceCdLbl,Currency|Manuf=001CSC
08:23:11 D 15 CommThread PV Reads:

08:23:11 D 15 CommThread PV Reads: BOT|100
08:23:12 D 15 CommThread PV Reads: PUT|100|Values|OnHandAllLbl|Total On-Hand|Manuf=001CSC


08:23:12 D 15 CommThread PV Reads: EOT|100|RcrdsRcvd=1|RcrdsSent=1
BOT|101
PUT|101|Values|BinLocLbl1,BinLocLbl2,BinLocLbl3,BinLocLbl4,BinLocLbl5,BinLocLbl6,BinLocLbl7,BinLocLbl8,BinLocLbl9,
BinLocLbl10|Bin Description 1|Bin Description 2|Bin Description 3|Bin Description 4|Bin Description 5|Bin Description 6|Bin
Description 7|Bin Description 8|Bin Description 9|Bin Description 10|Manuf=001CSC
EOT|101|RcrdsRcvd=1|RcrdsSent=1
BOT|102
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0012|CAN Net|CAD|Manuf=001CSC
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0021|US List|USD|Manuf=001CSC
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0022|CAN List|CAD|Manuf=001CSC
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0011|US Net|USD|Manuf=001CSC
08:23:39 D 15 CommThread PV Writes : EOS
08:23:40 D 15 CommThread PV Reads: EOS|TransRcvd=3|TransSent=3
08:25:19 D 15 CommThread PV Writes : GET|100|VALUES|OnHandAllLbl|Manuf=001CSC
08:25:19 D 15 CommThread PV Writes : GET|101|VALUES|BinLocLbl1,BinLocLbl2,BinLocLbl3,BinLocLbl4,BinLocLbl5,

BinLocLbl6,BinLocLbl7,BinLocLbl8,BinLocLbl9,BinLocLbl10|Manuf=001CSC
08:25:19 D 15 CommThread PV Writes : GET|102|VALUES|AvailPriceCd,PriceCdLbl,Currency|Manuf=001CSC

08:25:19 D 15 CommThread PV Reads: PUT|100|Values|OnHandAllLbl|Total On-Hand|Manuf=001CSC

BOT|101
PUT|101|Values|BinLocLbl1,BinLocLbl2,BinLocLbl3,BinLocLbl4,BinLocLbl5,BinLocLbl6,BinLocLbl7,BinLocLbl8,BinLocLbl9,
BinLocLbl10|Bin Description 1|Bin Description 2|Bin Description 3|Bin Description 4|Bin Description 5|Bin Description 6|Bin
Description 7|Bin Description 8|Bin Description 9|Bin Description 10|Manuf=001CSC
BOT|102
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0012|CAN Net|CAD|Manuf=001CSC
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0021|US List|USD|Manuf=001CSC
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0022|CAN List|CAD|Manuf=001CSC
PUT|102|Values|AvailPriceCd,PriceCdLbl,Currency|P0011|US Net|USD|Manuf=001CSC
08:25:34 D 15 CommThread PV Writes : GET|103|VALUES|OnHandAll,BinLoc1,BinLoc3,BinLoc4,OnHand1,OnHand3,

OnHand4|PartNum=710281024R|Manuf=001CSC
08:25:34 D 15 CommThread PV Writes : GET|104|VALUES|OnHandAll|PartNum=710281024|Manuf=001CSC

GET|104|VALUES|OnHandAll|PartNum=710281024C|Manuf=001CSC

08:25:34 D 15 CommThread PV Reads: PUT|103|Values|OnHandAll,BinLoc1,BinLoc3,BinLoc4,OnHand1,OnHand3,

OnHand4|10|Bin Loc 1|Bin Loc 3|Bin Loc 4|0|2|3|PartNum=710281024R|Manuf=001CSC

BOT|104
PUT|104|Values|OnHandAll|40|PartNum=710281024|Manuf=001CSC
PUT|104|Values|OnHandAll|35|PartNum=710281024C|Manuf=001CSC
08:26:34 D 15 CommThread PV Writes : EOS
08:26:34 D 15 CommThread PV Reads: EOS|TransRcvd=5|TransSent=5
3.4 TCP Listener

A complete compile-able version of the TCP Listener that supports this interface
(EU_BSV_TCP_Service.zip) - has been published on the DMS Reference website :
https://dmsreference.cnh.com/
This listener has been updated to include :
· demonstrations of more of the transactions that exist in the IP Version 2 specification.
· demonstrations of the recent change to group multiple Pricing inquiries within one transaction.
note: This listener does listen for both the method 1 and method 2 pricing. Only use the method 2
pricing transactions from the IP Version 2 specification for the Online Parts Catalog interface.
Legacy method 1 pricing is only included until such time as the legacy DVD format remains in
existence.
In case you do not have access to the DMS Reference Website please contact
dleudmssupport@cnh.com

4 Display PPL prices in PAL / SP2 Online
4.1 Configure PAL / SP2 Online to show PPL prices

The dealers can choose whether they want to see the Sales prices coming from the DMS OR the list
prices coming from the PPL disc supplied by CNH to their dealers. It is not possible to display both
prices at the same time.
To choose between both options the dealer has to click on <<TOOLS>> / <<OPTIONS>> /
<<PRICING>> and select the relevant option.
If the dealer chooses to display the PPL prices in PAL / SP2 Online then he will first have to import the
PPL file into PAL / SP2 OnLine .

Display PPL prices in PAL / SP2 Online 19
4.2 Importing the PPL into PAL / SP2 Online

The instructions shown below on how to import the PPL prices into PAL / SP2 Online
are explained to the dealers in the PAL / SP2 Installation User guide.


EU ECatalogs Addendum v2

Diunggah oleh

Informasi Dokumen

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

EU ECatalogs Addendum v2

Diunggah oleh

Hak Cipta:

Format Tersedia

DMS Reference Guide

After Sales eBusiness Services

Case New Holland - After Sales eBusiness Services

© 2008 Case New Holland

Printed: oktober 2008

2 Additional Technical Information 5

3 Testing the interface 12

4 Display PPL prices in PAL / SP2 Online 18

© 2008 Case New Holland

1.1 About this interface reference manual

1.2 Document control

© 2008 Case New Holland

2 Additional Technical Information

2.1 System Requirements

2. Currently, the download size is 23,6 MB.

v Windows 2000 Service pack 4

2.2 Pricing Method

© 2008 Case New Holland

2.3 Group Transactions

2.4 Batch Limit

Example 1 : DMS Batch Limit = 10 (Default Value)

Example 2 : DMS Batch Limit = 0

© 2008 Case New Holland

v An example of where a DMS might want to use this new field :

© 2008 Case New Holland

© 2008 Case New Holland

© 2008 Case New Holland

© 2008 Case New Holland

© 2008 Case New Holland

3 Testing the interface

3.1 Installation Instructions

3.1.1 Connecting to PAL / SP2 On Line

The URL to connect to PAL / SP2 On Line is

Note : You can click on the appropriate flag to choose a language

© 2008 Case New Holland

3.1.2 Installation of PAL / SP2 On Line

© 2008 Case New Holland

3.2 How to configure PAL/SP2 On Line

· Click on <<Tools>> / <<Options>>

· Click on <<TEST>> to verify if the connection is working

© 2008 Case New Holland

"C:\Program Files\PowerView.NET\powerview.exe" /DMSDEBUG:1

Example of a log file

Application Name : PowerView

Boot Mode : Normal

08:23:10 D 15 CommThread PV Writes : BOS

08:23:11 D 15 CommThread PV Reads: BOS

08:23:11 D 15 CommThread PV Writes : BOT|100

08:23:11 D 15 CommThread PV Writes : GET|100|VALUES|OnHandAllLbl|Manuf=001CSC

08:23:11 D 15 CommThread PV Writes : EOT|100|RCRDSSENT=1

08:23:11 D 15 CommThread PV Writes : BOT|101

08:23:11 D 15 CommThread PV Writes : GET|101|VALUES|BinLocLbl1,BinLocLbl2,BinLocLbl3,BinLocLbl4,BinLocLbl5,

08:23:11 D 15 CommThread PV Writes : EOT|101|RCRDSSENT=1

08:23:11 D 15 CommThread PV Writes : BOT|102

08:23:11 D 15 CommThread PV Writes : GET|102|VALUES|AvailPriceCd,PriceCdLbl,Currency|Manuf=001CSC

08:23:11 D 15 CommThread PV Writes : EOT|102|RCRDSSENT=1

08:23:11 D 15 CommThread PV Reads:

08:23:12 D 15 CommThread PV Reads: PUT|100|Values|OnHandAllLbl|Total On-Hand|Manuf=001CSC

© 2008 Case New Holland

08:23:12 D 15 CommThread PV Reads:

08:23:39 D 15 CommThread PV Writes : EOS

08:23:40 D 15 CommThread PV Reads: EOS|TransRcvd=3|TransSent=3

08:23:40 D 15 CommThread PV Writes : BOS

08:23:40 D 15 CommThread PV Reads: BOS