HeavyTruckParts XML Export - Revision history

Broy: Added fitment year ranges

2020-10-20T16:45:37Z

Added fitment year ranges

← Older revision		Revision as of 11:45, 20 October 2020
Line 32:		Line 32:
	<!-- The optional year of manufacture for the part -->		<!-- The optional year of manufacture for the part -->
	[<year>123</year>]		[<year>123</year>]

			<!-- The optional range of fitment years for the part.
			If fitsyearfrom is set to a year but fitsyearto is unset or 0, the item will
			be assumed to fit starting from fitsyearfrom to the current day.
			If fitsyearto is set to a year, but fitsyearfrom is unset or 0, the item will
			be assumed to fit from the earliest possible year up to fitsyearto. -->
			[<fitsyearfrom>123</fitsyearfrom>]
			[<fitsyearto>123</fitsyearto>]

	<!-- The optional make of the vehicle the part came off of -->		<!-- The optional make of the vehicle the part came off of -->

Broy: Added image rank attribute.

2020-04-21T17:05:16Z

Added image rank attribute.

← Older revision		Revision as of 12:05, 21 April 2020
Line 92:		Line 92:
	<!-- If images for this item are hosted elsewhere, any number of		<!-- If images for this item are hosted elsewhere, any number of
	hosted image URLs may be provided. These should be valid		hosted image URLs may be provided. These should be valid
	URLs to an image file: http://www.imagehost.com/myimages/image01.jpg -->		URLs to an image file: http://www.imagehost.com/myimages/image01.jpg
	[<image>ABC123</image>]		Optionally, a "rank" attribute can be provided to enforce an "importance"
			or ordering to the images. -->
			[<image [rank=123]>ABC123</image>]
	</item>		</item>
	</inventory>		</inventory>

Broy: Spoke with Drew, the description is technically optional.

2015-01-27T18:46:09Z

Spoke with Drew, the description is *technically* optional.

← Older revision		Revision as of 13:46, 27 January 2015
Line 45:		Line 45:
	[<partmodel>ABC123</partmodel>]		[<partmodel>ABC123</partmodel>]

	<!-- A description of this part -->		<!-- A description of this part; technically optional but HIGHLY RECOMMENDED -->
	<description>ABC123</description>		[<description>ABC123</description>]

	<!-- The category this part falls under, such as "USED", "OEM", "NEW", or "REMAN" -->		<!-- The category this part falls under, such as "USED", "OEM", "NEW", or "REMAN" -->

Jmckinstry: Updated to reflect the change of quantity from required to optional

2014-11-11T17:22:59Z

Updated to reflect the change of quantity from required to optional

← Older revision		Revision as of 12:22, 11 November 2014
Line 75:		Line 75:
	[<serialnumber>ABC213</serialnumber>]		[<serialnumber>ABC213</serialnumber>]

	<!-- The ~~REQUIRED~~ quantity of this item on hand. -->		<!-- The optional quantity of this item on hand. If unspecified, will be set to 1 -->
	<quantity>123</quantity>		<quantity>123</quantity>

Broy: Added image URLs to the XML spec, this increases spec version to 1.1

2014-06-25T22:07:51Z

Added image URLs to the XML spec, this increases spec version to 1.1

← Older revision		Revision as of 17:07, 25 June 2014
Line 9:		Line 9:
	<!-- Begin the list of inventory; the version is the version of this XML specification you're using.		<!-- Begin the list of inventory; the version is the version of this XML specification you're using.
	The exporttype is an advisory request as to whether this is a complete export, or a partial export. -->		The exporttype is an advisory request as to whether this is a complete export, or a partial export. -->
	<inventory version="1.0" exporttype="partial/complete">		<inventory version="1.1" exporttype="partial/complete">

	<!-- Begin an inventory item. Both the inventory id and the store id are optional but strongly recommended.		<!-- Begin an inventory item. Both the inventory id and the store id are optional but strongly recommended.
Line 89:		Line 89:
	<!-- The REQUIRED retail price to be shown to users -->		<!-- The REQUIRED retail price to be shown to users -->
	<retailprice>123.123</retailprice>		<retailprice>123.123</retailprice>

			<!-- If images for this item are hosted elsewhere, any number of
			hosted image URLs may be provided. These should be valid
			URLs to an image file: http://www.imagehost.com/myimages/image01.jpg -->
			[<image>ABC123</image>]
	</item>		</item>
	</inventory>		</inventory>
Line 125:		Line 130:
	<wholesaleprice>800.00</wholesaleprice>		<wholesaleprice>800.00</wholesaleprice>
	<retailprice>1100.00</retailprice>		<retailprice>1100.00</retailprice>
			<image>http://imagehost.isoftdata.com/phpThumb.php?productcode=12345&id=56178</image>
			<image>http://imagehost.isoftdata.com/phpThumb.php?productcode=12345&id=54312</image>
	</item>		</item>
	<item inventoryid="2" storeid="1">		<item inventoryid="2" storeid="1">

Broy: Added the missing XML header to the sample file

2014-03-14T21:08:56Z

Added the missing XML header to the sample file

← Older revision		Revision as of 16:08, 14 March 2014
Line 100:		Line 100:
	A sample export file with three items:		A sample export file with three items:
	<pre>		<pre>
			<?xml version="1.0"?>
	<export companyid="12345">		<export companyid="12345">
	<inventory version="1.0">		<inventory version="1.0">

Broy: Created the first draft specification for the XML export to HTP.

2014-03-14T21:08:11Z

Created the first draft specification for the XML export to HTP.

New page

We support a generalized XML export file for importing inventory into HeavyTruckParts.Net.

The commented specification. Tags are marked with brackets ([]) if they are optional. Contents and attributes are identified with "123" if they take numbers and "ABC123" for text strings.

<pre>
<?xml version="1.0" ?>

<export companyid="123">

<inventory version="1.0" exporttype="partial/complete">


<item [inventoryid="123"] [storeid="123"]>


[<tagnumber>ABC123</tagnumber>]


[<vehiclestocknumber>123</vehiclestocknumber>]


<parttype typeid="123">ABC123</parttype>


[<year>123</year>]


[<vehiclemake>ABC123</vehiclemake>]


[<vehiclemodel>ABC123</vehiclemodel>]


[<partmanufacturer>ABC123</partmanufacturer>]


[<partmodel>ABC123</partmodel>]


<description>ABC123</description>


[<category>ABC123</category>]


[<condition>ABC123</condition>]


[<notes>ABC123</notes>]


[<side>ABC123</side>]


[<qa label="ABC123">ABC123</qa>]


[<vin>ABC123</vin>]


[<oemnumber>ABC123</oemnumber>]


<quantity>123</quantity>


[<cost>123.123</cost>]


[<coreprice>123.123</coreprice>]


[<wholesaleprice>123.123</wholesaleprice>]


<retailprice>123.123</retailprice>
</item>
</inventory>
</export>
</pre>

For the best results, specify at least the partmanufacturer and partmodel or vehiclemake and vehiclemodel. When a field is optional, it may be omitted, or included with empty contents. If you do not specify inventoryid values for all items, we only support complete exports, where all of your inventory will be removed from HeavyTruckParts.Net and replaced with the contents of the export file. If inventoryid values are specified for all items in the export, ISoft supports the concept of a "partial export," which can update items already listed, or add new items without affecting already uploaded inventory.

A sample export file with three items:
<pre>
<export companyid="12345">
<inventory version="1.0">
<item inventoryid="1" storeid="1">
<tagnumber>1</tagnumber>
<vehiclestocknumber></vehiclestocknumber>
<parttype typeid="3000">Engine Assembly</parttype>
<year>2003</year>
<vehiclemake>Freightliner</vehiclemake>
<vehiclemodel>FLD120</vehiclemodel>
<partmanufacturer>CAT</partmanufacturer>
<partmodel>3306C</partmodel>
<description>Good runner</description>
<category>USED</category>
<condition>Excellent</condition>
<qa label="Jake">No</qa>
<qa label="HP">230</qa>
<vin>1234567890ABCDEF</vin>
<oemnumber>ABC123</oemnumber>
<serialnumber>123456789</serialnumber>
<quantity>2</quantity>
<cost>600.00</cost>
<coreprice>200.00</coreprice>
<wholesaleprice>800.00</wholesaleprice>
<retailprice>1100.00</retailprice>
</item>
<item inventoryid="2" storeid="1">
<tagnumber>2</tagnumber>
<vehiclestocknumber>4</vehiclestocknumber>
<parttype typeid="4000">Transmission Assembly</parttype>
<year>1996</year>
<vehiclemake>Freightliner</vehiclemake>
<vehiclemodel>FLD120</vehiclemodel>
<partmanufacturer>ROCKWELL</partmanufacturer>
<partmodel>RM0-12A</partmodel>
<description>Good runner</description>
<category>USED</category>
<condition>Excellent</condition>
<notes></notes>
<side></side>
<qa label="Speed"></qa>
<qa label="INPUT SHAFT"></qa>
<qa label="pump"></qa>
<qa label="BM#"></qa>
<vin>1234567890ABCDEF</vin>
<oemnumber>ABC123</oemnumber>
<serialnumber>123456789</serialnumber>
<quantity>1</quantity>
<cost>575.00</cost>
<coreprice></coreprice>
<wholesaleprice>650.00</wholesaleprice>
<retailprice>800.00</retailprice>
</item>
<item inventoryid="3" storeid="1">
<tagnumber>TG123</tagnumber>
<vehiclestocknumber></vehiclestocknumber>
<parttype typeid="1200">Door Assembly, Front</parttype>
<year></year>
<vehiclemake>Ford</vehiclemake>
<vehiclemodel>L7000</vehiclemodel>
<partmanufacturer></partmanufacturer>
<partmodel></partmodel>
<description>LH door, ding in side</description>
<category>USED</category>
<condition>Good</condition>
<notes></notes>
<side>Left</side>
<qa label="Color">Yellow</qa>
<qa label="Power Window">No</qa>
<vin></vin>
<oemnumber></oemnumber>
<serialnumber></serialnumber>
<quantity>1</quantity>
<cost>330.00</cost>
<coreprice>0.00</coreprice>
<wholesaleprice>500.00</wholesaleprice>
<retailprice>600.00</retailprice>
</item>
</inventory>
</export>
</pre>