Please Note: You must be a 'Trusted' Upload Tool user to set up a feed.
| Type | Parent | Element | Description |
|---|---|---|---|
| Listings* | listings | The container for every listing element | |
| Listing* | listings | listing | 1 or more containers. 1 for each Listing you wish to add/edit |
| Category* | listing | category | The DOTmed Category in which to place the listing. Browse for your categories on DOTmed, or view the 2nd sheet in your downloaded listings excel spreadsheet for reference. Be sure to use the name exactly as given. You can also use the category ID. You can also get a list here: https://www.dotmed.com/ajax/requests/api/v2/descriptions.json |
| System Model* | listing | model | The model of the equipment. This is the name given by the manufacturer to this product. Examples from the automobile world include Corvette, 735i, E500 or CTS. If the listing is for a part, this is the model of the equipment that the part fits into. While a part may fit more than one model, you can only list one model per part listing. Maximum 128 characters, no HTML. |
| System Mfg* | listing | mfg | The OEM of the equipment in the listing. Examples, again from the auto world, would include Chevrolet, BMW, Mercedes or Cadillac. For parts this is the OEM of the equipment that the part fits. |
| Part Mfg* | listing | part_mfg | Only for part listings, this is the manufacturer of the part in the listing. While many OEM parts will be manufacturered by the OEM of the machine, there may be cases when there will be a different (third party) manufacturer of a part for a different equipment manufacturer. Exact manufacturer name only, no HTML. |
| Comments* | listing | comments | A long form description of your listing. Simple HTML for formatting is allowed, but no external links, images or design elements are allowed. No colors, bold or otherwise styled text is allowed. |
| Part Number* | listing | part_number | Applicable only to part listings, this is the OEM part number of the part. Maximum 128 characters, no HTML. |
| Part/Item Name | listing | part_description_or_item_name | For service listings: more info to describe the type of service. For part listings: this is the name of the part. Examples include: circuit board, switch, hard drive, etc. For equipment listings: certain categories allow an item name if the category includes multiple types of items. Examples of this include "Accessory", "General" or "Other" categories. Maximum 128 characters, no HTML. The 3rd worksheet on the download will have an asterisk(*) next to their name if they need an item name. |
| Condition* | listing | condition | Condition: The condition of the item in the listing. Allowed values include: New, Excellent, Good, Fair, Poor, Parts or Unknown. |
| Listing Type* | listing | type | Either "equipment", "part" or "service". You cannot change a listing type once the listing is created. |
| Request Type | listing | wanted | "For Sale" or "Wanted" only |
| Price | listing | price | The Asking price for a "For Sale" listing or the Offer price for a "Wanted" listing. Integer or XX.XX format. Currency symbol not necessary (see Currency Column). (Optional) |
| D2D Price | listing | dealer_price | For our Dealer2Dealer users, the price that they will sell this equipment at wholesale. (Optional) |
| VTS Friend Price | listing | vts_price | For our Dealer2Dealer users, an optional price that you will offer this listing to for your VTS "Friends" (Optional) |
| Currency | listing | currency | The currency that the prices above are in. Possible values include US Dollars, Canadian Dollars, British Pounds, or Euros |
| Quantity | listing | quantity | The quantity available (defaults to 1). Integer. |
| Buy Now Activate? | listing | paypal | Whether or not to include a "Buy Now" button on this "For Sale" listing. "y" or "n". |
| Buy Now Shipping | listing | paypal_shipping | The shipping price if paying with Buy Now button. This overrides your Buy Now Account shipping setup. Use '0' for free shipping. |
| Ships Within (days) | listing | ships_within | A shipping timeframe. e.g. 3 days |
| Make an Offer? | listing | make_offer | If you want the 'Make An Offer' button on this listing where users can submit their own prices. 'y' or 'n' |
| Auto-Accept Offers above | listing | offer_accept | Automatically accept offers that are above the amount provided in this column. All other offers will be sent to you by email. This is optional |
| Auto-Reject Offers below | listing | offer_reject | Automatically reject offers that are below teh amount provided in this column. All other offers will be sent to you by email. This is optional |
| Weight | listing | weight | The weight of the item for shipping calculations. Only integer or decimal in the units given in the next column. (Optional) |
| Weight Units (1 = 'Lbs', 2= 'Kg') | listing | weight_units | 1 = 'Lbs', 2 = 'Kg' |
| Height | listing | height | The height of the item. Place a 0 in the column to remove the current value |
| Width | listing | width | The Width of the item. Place a 0 in the column to remove the current value |
| Depth | listing | depth | The Depth of the item. Place a 0 in the column to remove the current value |
| Sale % | listing | onsale | Add a Sale % tag to your listing |
| Bulk Shipping Eligible | listing | bulk_shipping | This listing will be eligible for your bulk shipping discount rules. |
| Available as Parts? | listing | parts | Will you consider selling this equipment listing as a parts unit or selling parts from the unit individually? y/n |
| In Stock | listing | in_stock | If you have physical control of the item in your inventory, then indicate "y". Otherwise "n" if the item is not in your inventory (for "For Sale" Listings only) |
| Item ID | listing | gtin | A universal identification code for this equipment. Very helpful for buyers comparing different listings, or to verify that a seller has the item you need (Optional but recommended) |
| Item ID Type (SKU/EAC/JAN/MPN/MMN) | listing | gtin_type | (SKU/EAC/JAN/MPN/MMN) |
| Your Item ID | listing | sku | If you use an inventory management system and would like to assign a unique ID to your listings (for instance, to find the right item for shipment) enter it here. Each entry must be unique throughout the history of your listings. Maximum of 64 alphanumic characters, no HTML. (Optional) |
| Your Item ID 2 | listing | sku2 | A second identifying ID. Maximum of 64 alphanumic characters, no HTML. (Optional) |
| Alt. Address | listing | alt_address | Ultimate Only. Use the Short Name of the alternate address you created in your Ultimate Settings. eg. 'Ohio Warehouse' |
| Youtube URL | listing | youtube | The URL of the youtube video you want to embed on the listing. Equipment Only. |
| Video URL | listing | video | The URL of the video you want to show on your listing. Equipment Only. |
| Listing ID (Leave Blank to Add) | listing | id | DOTmed's Listing ID - used to update an existing Listing. Integer only. PLEASE NOTE: If the mfg, category, part number and model match a current listing of yours, It will use that instead of adding a new one. |
| Delete | listing | delete | put a Y to delete this listing. |
| Auto-Renew | listing | auto_renew | Auto renew this listing. Ultimate Upgrade Only |
| Specifications | listing | specs | Specification Container |
| Specification Name | specs | name | The Specification Name |
| Specification Value | specs | value | The Specification Value |
| Photos | listing | photos | Photos Container |
| Photo | photos | photo | Photos URL. Images must be to a fully qualified url on a public server. There can be up to the max photos children allowed for your upgrade in the <photos> container |
| Remove Photos | listing | remove_images | 'y' or 'n', default 'n'. Will remove non-passed in images from your listings. eg. If you had 3 photos before, but only pass in 2 photos, the 3rd photo will be deleted |
| Userid | listing | userid | The userid of the store you want this listing associated with. Only needed if you are using the same API token for multiple stores. Each store must be associated with the main API token user account and must also have DOTmed API access (an API token). Please contact your DOTmed sales rep for more information. |
<?xml version="1.0" encoding="UTF-8"?>
<listings>
<listing>
<mfg>ACUSON</mfg>
<model>SOlgar</model>
<comments>A Acuson Solgar Minute Volume Tester. Hardly used</comments>
<category>Minute Volume Tester</category>
<condition>Good</condition>
<price>60.00</price>
<type>equipment</type>
<width>23 Inches</width>
<specs>
<specname1>Expiration Date</specname1>
<specvalue1>12/12/2021</specvalue1>
</specs>
<photos>
<photo>http://www.example.com/images/1.jpg</photo>
<photo>http://www.example.com/images/2.jpg</photo>
</photos>
</listing>
<listing>
<mfg>ACUSON</mfg>
<model>test</model>
<comments>This is a thorough description of the part</comments>
<category>Minute Volume Tester</category>
<condition>Good</condition>
<part_number>35-252</part_number>
<part_mfg>ACUSON</part_mfg>
<part_description_or_item_name>Handle</part_description_or_item_name>
<paypal>y</paypal>
<wanted>Wanted</wanted>
<type>part</type>
<width>23 Inches</width>
<photos>
<photo>http://www.example.com/images/1.jpg</photo>
</photos>
</listing>
</listings>
{
"listings": {
"listing": [
{
"mfg": "ACUSON",
"model": "SOlgar",
"comments": "A Acuson Solgar Minute Volume Tester. Hardly used",
"category": "Minute Volume Tester",
"price": "60.00",
"condition":"Good",
"type": "equipment",
"width": "23 Inches",
"id": 23523,
"photos": {
"photo": [
"http://www.example.com/images/1.jpg",
"http://www.example.com/images/2.jpg"
]
},
"specs": [
{ "name": "width", "value": "19 inches" },
{"name": "height","value": "20 inches"}
]
},
{
"mfg": "ACUSON",
"model": "test",
"comments": "This is a thorough description of the part",
"category": "Minute Volume Tester",
"part_number": "35-252",
"condition":"Good",
"part_mfg": "ACUSON",
"part_description_or_item_name": "Handle",
"paypal": "y",
"wanted": "Wanted",
"type": "part",
"width": "23 Inches",
"photos": {
"photo": "https://www.example.com/images/1.jpg"
},
"userid": "515352",
}
]
}
}
| Category | The DOTmed Category in which to place the listing. Browse for your categories on DOTmed, or view the 2nd sheet in your downloaded listings excel spreadsheet for reference. Be sure to use the name exactly as given. You can also use the category ID. You can also get a list here: https://www.dotmed.com/ajax/requests/api/v2/descriptions.json |
| System Model | The model of the equipment. This is the name given by the manufacturer to this product. Examples from the automobile world include Corvette, 735i, E500 or CTS. If the listing is for a part, this is the model of the equipment that the part fits into. While a part may fit more than one model, you can only list one model per part listing. Maximum 128 characters, no HTML. |
| System Mfg | The OEM of the equipment in the listing. Examples, again from the auto world, would include Chevrolet, BMW, Mercedes or Cadillac. For parts this is the OEM of the equipment that the part fits. |
| Part Mfg | Only for part listings, this is the manufacturer of the part in the listing. While many OEM parts will be manufacturered by the OEM of the machine, there may be cases when there will be a different (third party) manufacturer of a part for a different equipment manufacturer. Exact manufacturer name only, no HTML. |
| Comments | A long form description of your listing. Simple HTML for formatting is allowed, but no external links, images or design elements are allowed. No colors, bold or otherwise styled text is allowed. |
| Part Number | Applicable only to part listings, this is the OEM part number of the part. Maximum 128 characters, no HTML. |
| Part/Item Name | For service listings: more info to describe the type of service. For part listings: this is the name of the part. Examples include: circuit board, switch, hard drive, etc. For equipment listings: certain categories allow an item name if the category includes multiple types of items. Examples of this include "Accessory", "General" or "Other" categories. Maximum 128 characters, no HTML. The 3rd worksheet on the download will have an asterisk(*) next to their name if they need an item name. |
| Condition | Condition: The condition of the item in the listing. Allowed values include: New, Excellent, Good, Fair, Poor, Parts or Unknown. |
| Listing Type | Either "equipment", "part" or "service". You cannot change a listing type once the listing is created. |
| Request Type | "For Sale" or "Wanted" only |
| Price | The Asking price for a "For Sale" listing or the Offer price for a "Wanted" listing. Integer or XX.XX format. Currency symbol not necessary (see Currency Column). (Optional) |
| D2D Price | For our Dealer2Dealer users, the price that they will sell this equipment at wholesale. (Optional) |
| VTS Friend Price | For our Dealer2Dealer users, an optional price that you will offer this listing to for your VTS "Friends" (Optional) |
| Currency | The currency that the prices above are in. Possible values include US Dollars, Canadian Dollars, British Pounds, or Euros |
| Quantity | The quantity available (defaults to 1). Integer. |
| Buy Now Activate? | Whether or not to include a "Buy Now" button on this "For Sale" listing. "y" or "n". |
| Buy Now Shipping | The shipping price if paying with Buy Now button. This overrides your Buy Now Account shipping setup. Use '0' for free shipping. |
| Ships Within (days) | A shipping timeframe. e.g. 3 days |
| Make an Offer? | If you want the 'Make An Offer' button on this listing where users can submit their own prices. 'y' or 'n' |
| Auto-Accept Offers above | Automatically accept offers that are above the amount provided in this column. All other offers will be sent to you by email. This is optional |
| Auto-Reject Offers below | Automatically reject offers that are below teh amount provided in this column. All other offers will be sent to you by email. This is optional |
| Weight | The weight of the item for shipping calculations. Only integer or decimal in the units given in the next column. (Optional) |
| Weight Units (1 = 'Lbs', 2= 'Kg') | 1 = 'Lbs', 2 = 'Kg' |
| Height | The height of the item. Place a 0 in the column to remove the current value |
| Width | The Width of the item. Place a 0 in the column to remove the current value |
| Depth | The Depth of the item. Place a 0 in the column to remove the current value |
| Sale % | Add a Sale % tag to your listing |
| Bulk Shipping Eligible | This listing will be eligible for your bulk shipping discount rules. |
| Available as Parts? | Will you consider selling this equipment listing as a parts unit or selling parts from the unit individually? y/n |
| In Stock | If you have physical control of the item in your inventory, then indicate "y". Otherwise "n" if the item is not in your inventory (for "For Sale" Listings only) |
| Item ID | A universal identification code for this equipment. Very helpful for buyers comparing different listings, or to verify that a seller has the item you need (Optional but recommended) |
| Item ID Type (SKU/EAC/JAN/MPN/MMN) | (SKU/EAC/JAN/MPN/MMN) |
| Your Item ID | If you use an inventory management system and would like to assign a unique ID to your listings (for instance, to find the right item for shipment) enter it here. Each entry must be unique throughout the history of your listings. Maximum of 64 alphanumic characters, no HTML. (Optional) |
| Your Item ID 2 | A second identifying ID. Maximum of 64 alphanumic characters, no HTML. (Optional) |
| Alt. Address | Ultimate Only. Use the Short Name of the alternate address you created in your Ultimate Settings. eg. 'Ohio Warehouse' |
| Youtube URL | The URL of the youtube video you want to embed on the listing. Equipment Only. |
| Video URL | The URL of the video you want to show on your listing. Equipment Only. |
| Listing ID (Leave Blank to Add) | DOTmed's Listing ID - used to update an existing Listing. Integer only. PLEASE NOTE: If the mfg, category, part number and model match a current listing of yours, It will use that instead of adding a new one. |
| Delete | put a Y to delete this listing. |
| Auto-Renew | Auto renew this listing. Ultimate Upgrade Only |
| Image Columns | You can include additional columns (up to the maximum allowed for your account type) referencing images online for these listings. HTML Links only, each cell should start with 'http://' or 'https://'. Verify that these files are accessible publicly online and do not require authentication. Provide links to the image file only, not an HTML page on which the image is embedded. JPG/PNG/GIF filetypes only. If you have your files saved locally on your computer (and not stored online) then you will need to upload the listings and add the images to them later through our My DOTmed Individual Listing Editor. Do not use this tool to reorder existing photographs on an existing listing, use the Individual Listing Editor instead. |
| System Model* | The name of your variant. E.G. Expires 6/24 or Color: Green |
| Listing Type* | value must be 'VARIANT' |
| Price* | The Price of your variant |
| Quantity* | The Quantity of your variant |
| Buy Now Shipping | The shipping price if paying with Buy Now button. This overrides your Buy Now Account shipping setup. Use '0' for free shipping |
| Weight | Weight of the variant. If blank then it will use the value in the 'Weight' field of the parent listing |
| Weight Units | 1 = 'Lbs', 2 = 'Kg'. If blank then it will use the value in the 'Weight Units' field of the parent listing |
| Height | The Height of the variant. If blank then it will use the value in the 'Height' field of the parent listing. Place a 0 in the column to remove the current value variant. |
| Width | The Width of the variant. If blank then it will use the value in the 'Width' field of the parent listing. Place a 0 in the column to remove the current value variant. |
| Depth | The Depth of the variant. If blank then it will use the value in the 'Depth' field of the parent listing. Place a 0 in the column to remove the current value variant. |
| Your Item ID* | A Unique ID for the variant. |
| Your Item ID 2 | The Unique ID for the 'Parent' listing. Optional if 'Listing ID' is filled out |
| Listing ID | The Listing ID for the 'Parent' listing. Optional if 'Your Item ID 2' is filled out with the Parent Unique ID |
| Delete | 'y' will remove this variant from the listing |