Fuel Economy Labels

Overview

This section describes how to retrieve and render fuel economy labels for vehicles in the MotorWeb system, in compliance with government regulations.

• Fuel Economy Label Information: Retrieves the label data in XML format. This data is also included in VIR reports.

• Fuel Economy Label Render: Provides the label as a loss-less PNG image. An optional parameter allows you to specify the image width.

Both transactions require an existing vehicle in the MotorWeb system and have additional error codes for handling various issues.

MotorWeb-Error-Code	Situation
NO-FUEL	There is no Government fuel economy information for this vehicle
BAD-VEHICLE	This vehicle does not have a VIN or chassis number

The vehicle to retrieve the label for can be specified in different ways with different parameters (all require an existing vehicle in the MotorWeb system):

• vehicleId : Retrieves up-to-date fuel economy label for the vehicle with this ID (most probably this ID will have been retrieved from a previous transaction).

• stockNumber : Retrieves up-to-date fuel economy label for the vehicle with this stock number. In the possible (but silly) case where multiple vehicles have the same stock number the vehicle that most recently had a transaction performed against it will be used.

Fuel economy label in Text Format

Returns data for the label in XML (text/xml) format. The schema for the response is fuel-economy-label-1.0.xsd.

This information is also contained in VIR reports.

Current version: 1.0 Example URL: https://robot.motorweb.co.nz/action/robotFuelEconomyLabel/1.0?vehicleId=12345678

Fuel economy label in PNG Format

Returns the label as a loss-less PNG image.

This transaction takes an additional parameter:

• width: width of the image in pixles (optional, default is 680).

Current version: 1.0 Example URL: https://robot.motorweb.co.nz/action/robotFuelEconomyLabelRender/1.0?vehicleId=12345678&width=800