Developer News

 

Commercial Flag and Price Changes in Unit Datafeed

Wednesday, 25 November 2020

Updated Business Export and Import request and response formats to version 21, with the following changes:

  • Added commercial response attribute to the unit export.
  • Added gross response attribute to the unit export.
  • The price attribute in the unit export has been deprecated for non-trade feeds. Use gross and/or nett instead.

 

Price, Manufacturer Code and Model Code in Unit Datafeed

Tuesday, 25 August 2020

Updated Business Export and Import request and response formats to version 20, with the following changes:

  • The price attribute in the unit export will now always either be the VAT-inclusive (gross) or VAT-exclusive (nett) price depending on the partner’s account type, rather than varying per-unit in the business’s system. See the unit export documentation for more details.
  • Added modelCode response attribute to the unit export.
  • Added manufacturerCode response attribute to the unit export.

 

Vehicle Renamed to Unit in Datafeeds

Monday, 20 May 2019

Updated Business Export and Import request and response formats to version 19, with the following changes:

  • Renamed “vehicle” to “unit” throughout the API and this documentation to reflect the renaming of our “Vehicle Sales” module to “Unit Sales”. All functionality remains unchanged.
  • This affects the following elements:
  • Business Export: vehicles -> units, vehicle-types -> unit-types, new-vehicles -> new-units.
  • Business Export CSV format: field vehicle-code -> unit-code, heading Vehicle Code -> Unit Code, heading Vehicle Type -> Unit Type.
  • Business Import: vehicle -> unit.

 

Legacy Datafeed URLs Retired

Monday, 17 September 2018

We announced in 2014 that all download feeds and uploads should now be sent to our server at https://www.catalyst-data.co.uk.

We then announced earlier this year that the download.php and upload.php scripts on our server at https://www.catalyst-findit.co.uk would be retired and taken offline in September.

This is now complete.

Any requests to download.php or upload.php on https://www.catalyst-findit.co.uk will now be responding with a 404 Not Found. If this is affecting your website then:

  • Update the domain from which you take datafeeds (download.php) from https://www.catalyst-findit.co.uk to https://www.catalyst-data.co.uk
  • Check the request version number (version=”…” in the <download> element). If you have not specified it then it will be version 3.
  • Note that the old domain supported versions 3 to 8 only, so if you were requesting a newer version you were in fact only getting version 8, and so that is the version you should request if you want to keep the same response format.
  • Note that the new domain supports versions 6 and above only, so if you were requesting an older version then you will no longer be able to get the same format and will need to check for any breaking changes in the datafeed documentation (see link below).
  • Update the domain to which you submit updates (upload.php) from https://www.catalyst-findit.co.uk to https://www.catalyst-data.co.uk
  • Note that we are only talking about the URL you are connecting to. The XML namespace in the request is unchanged.
  • Finally just to clarify: any “real-time” requests you send directly to the client are unchanged.

The latest datafeed documentation can always be found at https://www.catalyst-uk.com/dev/CMS Datafeed.pdf using the login credentials originally given to you.

 

Stock and Customer Datafeeds Updated

Wednesday, 04 July 2018

Updated Business Export request and response formats to version 18, with the following changes:

  • Added stock barcodes to the stock export.
  • Added stock associations to the stock export.
  • Added stock components to the stock export.
  • Added stock alternatives to the stock export.
  • Added customer delivery addresses to the customer export.

 

Vehicle Subtitle

Monday, 25 June 2018

Updated Business Export request and response formats to version 17, with the following changes:

  • Added subtitle response element to the vehicle export.

 

Loyalty Card Sales

Wednesday, 09 May 2018

Added Loyalty Card Sales Requests.

 

Retirement of Legacy Datafeed URLs

Friday, 26 January 2018

We announced in 2014 that all download feeds and uploads should now be sent to our server at https://www.catalyst-data.co.uk. We have continued to support the legacy URLs on https://www.catalyst-findit.co.uk up to now but have taken the decision to retire them from Monday 3rd September this year (03/09/2018).

If you still use the old domains then ensure they have been updated before the retirement date:

  • Update the domain from which you take datafeeds (download.php) from https://www.catalyst-findit.co.uk to https://www.catalyst-data.co.uk
  • Check the request version number (version=”…” in the <download> element). If you have not specified it then it will be version 3.
  • Note that the old domain supported versions 3 to 8 only, so if you were requesting a newer version you were in fact only getting version 8, and so that is the version you should request if you want to keep the same response format.
  • Note that the new domain supports versions 6 and above only, so if you were requesting an older version then you will no longer be able to get the same format and will need to check for any breaking changes in the datafeed documentation (see link below).
  • Update the domain to which you submit updates (upload.php) from https://www.catalyst-findit.co.uk to https://www.catalyst-data.co.uk
  • Note that we are only talking about the URL you are connecting to. The XML namespace in the request is unchanged.
  • From 03/09/2018 any requests to download.php or upload.php on https://www.catalyst-findit.co.uk will respond with a 404 Not Found.
  • Finally just to clarify: any “real-time” requests you send directly to the client are unchanged.

The latest datafeed documentation can always be found at https://www.catalyst-uk.com/dev/CMS Datafeed.pdf using the login credentials originally given to you.

 

Stock Item Applications

Tuesday, 15 August 2017

Updated Business Export request and response formats to version 16, with the following changes:

  • Added stock applications to the stock export.

 

Vehicle Videos and New Vehicle Types

Thursday, 03 November 2016

Updated Business Export request and response formats to version 15, with the following changes:

  • Added title response element to the vehicle export.
  • Added videos to the vehicle export.
  • Added new vehicle type codes for bicycle and electric assisted pedal cycle.
  • Added a new vehicle type code for trailer.

 

Requesting Alternative Image Sizes

Tuesday, 05 May 2015

Updated request and response formats to version 13, with the following changes:

  • Added image-length request attribute for specifying the maximum image size to retrieve.

 

Increased Model Description Length

Friday, 12 December 2014

Updated request and response formats to version 12, with the following changes:

  • Vehicle export description, model and stdModel may now contain up to four lines of up to 40 characters each split over successive lines.

 

Dimensions, Weights in Vehicle Feed

Tuesday, 08 July 2014

Updated request and response formats to version 11, with the following changes:

  • Added dimensions response element to the vehicle export.
  • Added weights response element to the vehicle export.

 

stdManufacturer, stdModel in Vehicle Feed

Thursday, 26 June 2014

Updated request and response formats to version 10, with the following changes:

  • Added stdManufacturer response element to the vehicle export.
  • Added stdModel response element to the vehicle export.

 

Change of URL

Thursday, 10 April 2014

The Catalyst CMS Datafeed documentation has been updated:

  • All download feeds and uploads should now be sent to our server at https://www.catalyst-data.co.uk.
  • Requests sent to https://www.catalyst-findit.co.uk will continue to work for now, but will only support feed versions from 3 up to 8 and will no longer be updated with new features.
  • Requests sent to https://www.catalyst-data.co.uk supports feed versions from 6 to 9 and any future versions.

Updated request and response formats to version 9, with the following changes:

  • Added model response element to the vehicle export.
  • Added site request attribute to the e-commerce order import.

 

Real-Time Logistics Export

Tuesday, 05 November 2013

The Catalyst CMS Datafeed documentation has been updated:

  • Supplying a customer for the Real-Time Logistics Export is no longer mandatory.

 

Real-Time Logistics – Extra Legs

Friday, 16 November 2012

The Catalyst CMS Datafeed documentation has been updated:

  • You can now import/export extra legs and trailer information using the Real-Time Logistics Import and the Real-Time Logistics Export.

 

Real-Time Logistics Updates

Thursday, 02 August 2012

The Catalyst CMS Datafeed documentation has been updated:

  • We have added the Real-Time Logistics Export and Real-Time Logistics Import requests that allows third party websites to post, update and enquire about jobs in the Platinum Logistics in Real-Time.

 

Acceptable Use Policy

Tuesday, 29 May 2012

The Catalyst CMS Datafeed documentation has been updated:

  • We now have a new section outlining our Acceptable Use Policy (“AUP”) when using our Data Severs. We haven’t changed any of the rules for using our severs, just grouped all the rules together under one section to help prevent any confusion on what you can and can’t do.

 

Datafeed Documentation Update

Wednesday, 23 May 2012

The Catalyst CMS Datafeed documentation has been updated:

Updated Dealer Export request and response formats to version 8, with the following changes:

  • Customer country code added.
  • Customer vatRegNo VAT registration number added.

Updated Dealer Import request and response formats (all versions) with the following changes:

  • Order custOrderNo attribute added.
  • Added explanatory note about delivery name/address.

Updated Real-Time Stock Enquiry request and response formats (all versions) with the following changes:

  • Added customer request attribute.
  • Added nett and gross response attributes.
  • Added availability request and response attributes.

General

  • Added a usage section with brief run-down of how requests are intended to be used.

 

New Vehicle Types

Wednesday, 11 January 2012

Vehicle export changes:

  • Added new vehicle type codes for quad bike or ATV, truck, commercial vehicle, tricycle or quadricycle, and caravan accessory.

 

Dealer Import Request Format

Monday, 19 December 2011

The Catalyst CMS Datafeed documentation has been updated:

Updated Dealer Import request format (all versions) with the following changes:

  • Customer ref attribute maximum length increased from 15 to 30.
  • Customer attributes codes added.
  • Customer country code added.
  • Customer vatRegNo VAT registration number added.