Required | Element Name | Attribute | Data Type | Length | CDATA | Description/Usage | Example(s) |
---|---|---|---|---|---|---|---|
Y | itemlist | VendorCode | string (GUID) | 36 | N/A |
Root Element - wraps all item elements. The attribute [vendor_code] is set to the vendor code assigned to you. This is a 36 digit GUID (globally unique identifier) string. |
<itemlist VendorCode="da185c9e-f942-42f3-8c68-6fa30e93d87c"> |
Y | item | type | string | 10 | N/A |
Item element - Wraps all elements describing product. The attribute [type] is set to the type of product. Currently, this will always be set to "ammo". |
<item type="ammo"> |
Y | product_id | string | 50 | Optional |
Unique identifier for your product. Can be anything you wish such as a SKU or a database index, so long as it is unique. NOTE: If duplicate product ids are found, errors will occur and your feed will be rejected. |
<product_id>10001-X45GSHP</product_id>
<product_id><![CDATA[10001-X45GSHP]]></product_id> |
|
Y | product_name | string | 200 | Required |
Short name/title of your product. HTML & JavaScript are not allowed in product names for loading time and security reasons. |
<product_name><![CDATA[Winchester 45 GAP 185 Grain Silvertip Hollow Point, 50 Round Box, X45GSHP]]></product_name> | |
Y | product_description | string | 2000 | Required |
Full description of your product. HTML & JavaScript are not allowed in descriptions for loading time and security reasons. |
<product_description><![CDATA[ Offers a unique combination of power, precision, reliable functioning, and on target performance. Delivers optimum penetration and rapid energy release with virtually no weight loss or bullet fragmentation. Caliber: 45 Glock Automatic Pistol (GAP) Bullet Type: Silvertip HPBullet Weight:185 GR Muzzle Energy: 411 ft lbsMuzzle Velocity:1000 fps Rounds/box: 50 Rounds Per Box, 10 Boxes Per Case ]]></product_description> | |
Y | product_link | string | 400 | Optional |
Complete direct link to product description page beginning with http:// or https:// Links to popups, popovers, popunders, Javascript, frames, ads of any kind, email/phone links, or redirects are not allowed for security and legal reasons. |
<product_link><![CDATA[http://store.goammo.com/winchester-45-gap-185-grain-silvertip-hollow-point-50-round-box-x45gshp]]></product_link>
<product_link>http://store.goammo.com/winchester-45-gap-185-grain-silvertip-hollow-point-50-round-box-x45gshp</product_link> |
|
N | product_image_link | string | 400 | Optional |
Complete direct link to product image beginning with http:// or https:// Images are resized automatically, so this link can be the largest image. For best results, use a link to the main image on your product details page. Links to popups, popovers, popunders, Javascript, frames, ads of any kind, email/phone links, or redirects are not allowed for security and legal reasons. |
<product_image_link><![CDATA[http://store.goammo.com/content/images/medium/0000006_winchester-45-gap-185-grain-silvertip-hollow-point-50-round-box-x45gshp_550.jpeg]]></product_image_link>
<product_image_link>http://store.goammo.com/content/images/medium/0000006_winchester-45-gap-185-grain-silvertip-hollow-point-50-round-box-x45gshp_550.jpeg</product_image_link> |
|
Y | manufacturer | string | 50 | Required |
Manufacturer name. This is the manufacturer of the actual product, not what the product is used in. For example, ammo manufactured by Federal that is designed to be used in a Remington rifle, put "Federal" here (not "Remington"). |
<manufacturer><![CDATA[Federal]]></manufacturer> | |
N | brand | string | 50 | Required |
Optional brand name, sub-brand name or product line. For example: You can have "Federal" in the manufacturer field and then put "American Eagle" here (which is a brand of Federal ammo). |
<brand><![CDATA[American Eagle]]></brand> | |
Y | ammo_section | string | 50 | N/A |
Allowed values for sections: "handgun","rifle","rimfire","shotgun" |
<ammo_section>handgun</ammo_section> | |
C | caliber | string | 50 | Optional | This is required for all ammo sections except "shotgun". |
<caliber><![CDATA[.45 GAP]]></caliber>
<caliber>.45 GAP</caliber> |
|
C | grains_weight | string | 50 | N/A | This is required for all ammo sections except "shotgun". | <grains_weight>185</grains_weight> | |
N | bullet_type | string | 50 | Optional | Optional: bullet type. |
<bullet_type><![CDATA[Silvertip HP]]></bullet_type>
<bullet_type>Silvertip HP</bullet_type> |
|
N | primer_no | string | 10 | N/A | Optional: primer number. | <primer_no>1</primer_no> | |
N | muzzle_energy | integer | N/A | Optional: muzzle energy in foot pounds. | <muzzle_energy>411</muzzle_energy> | ||
N | muzzle_velocity | integer | N/A | Optional: muzzle velocity in feet per second. | <muzzle_velocity>1000</muzzle_velocity> | ||
C | gauge_bore | string | 25 | N/A | This is required for "shotgun" ammo sections | <gauge_bore>12 Gauge</gauge_bore> | |
N | shot_material | string | 50 | Optional | <shot_material><![CDATA[Steel]]></shot_material> | ||
C | shot_type_size | string | 50 | Optional | This is required for "shotgun" ammo sections | <shot_type_size><![CDATA[BBB]]></shot_type_size> | |
C | shell_length | string | 10 | Required | This is required for "shotgun" ammo sections | <shell_length><![CDATA[3 1/2]]></shell_length> | |
N | shot_ounces | string | 10 | Required | <shot_ounces><![CDATA[1 1/2]]></shot_ounces> | ||
N | shot_grains | integer | N/A | <shot_grains>375</shot_grains> | |||
N | pellet_count | integer | N/A | <pellet_count>9</pellet_count> | |||
N | is_leadfree | string | 0-1 | N/A |
Optional: If Lead-Free ammunition, set this to "Y". Set it to "N" or leave empty if unknown or not-applicable. |
<is_leadfree>Y</is_leadfree>
<is_leadfree>N</is_leadfree> <is_leadfree></is_leadfree> <is_leadfree/> |
|
N | is_blank | string | 0-1 | N/A |
Optional: If this is Blank ammunition, set this to "Y". Set it to "N" or leave empty if unknown or not-applicable. |
<is_blank>Y</is_blank>
<is_blank>N</is_blank> <is_blank></is_blank> <is_blank/> |
|
N | is_less_lethal | string | 0-1 | N/A |
Optional: If this is Less Lethal ammunition, set this to "Y". Set it to "N" or leave empty if unknown or not-applicable. |
<is_less_lethal>Y</is_less_lethal>
<is_less_lethal>N</is_less_lethal> <is_less_lethal></is_less_lethal> <is_less_lethal/> |
|
Y | sold_by_units | string | 2 | N/A |
Units abbreviations available - Box: "BX", Tin: "TN", Each: "EA", Bag: "BG", Case: "CS", Carton (or Can): "CN" If selling by the round, use "EA" and make sure the <price_per_box> & <rounds_per_box> is set (for a "box" of 1). If selling by the box, tin or bag, make sure the <price_per_box> & <rounds_per_box> is set. If selling by the case, carton, or can, make sure the <price_per_case> & <rounds_per_case> is set. |
<sold_by_units>BX</sold_by_units> | |
C | price_per_box | decimal | N/A | Required, if selling by the box, tin, bag, or each. | <price_per_box>13.02</price_per_box> | ||
C | rounds_per_box | integer | N/A | Required, if selling by the box, tin, bag, or each. | <rounds_per_box>25</rounds_per_box> | ||
C | price_per_case | decimal | N/A | Required, if selling by the case or carton | <price_per_case>192.30</price_per_case> | ||
C | rounds_per_case | integer | N/A | Required, if selling by the case or carton | <rounds_per_case>250</rounds_per_case> | ||
C | boxes_per_case | integer | N/A | Required, if selling by the case or carton and rounds_per_case is not specified (and rounds_per_box is specified) | <boxes_per_case>50</boxes_per_case> | ||
Y | stock_status | string | 1 | N/A |
Abbreviations available - "I", "O", "B", "P", "C", "S" I=In Stock,O=Out Of Stock,B=Back Ordered,P=Pre Order,C=Call,S=Special Order |
<stock_status>I</stock_status> | |
N | stock_expected_date | string | 10 | Optional |
Optional expected future date that item will be in stock. A 10 character string in the format MM/DD/YYYY |
<stock_expected_date>12/25/2017</stock_expected_date> | |
N | usage1 | string | 50 | Optional |
Optional usage for this type of ammo. "hunting","target","defense","tactical","duck hunting","big game", etc. NOTE: There are no restrictions on what can be put here, but common phrases used in searching for ammo are most ideal. |
<usage1>target</usage1>
<usage1><![CDATA[target]]></usage1> |
|
N | usage2 | string | 50 | Optional |
Optional usage for this type of ammo. "hunting","target","defense","tactical","duck hunting","big game", etc. NOTE: There are no restrictions on what can be put here, but common phrases used in searching for ammo are most ideal. |
<usage2>big game hunting</usage2>
<usage2><![CDATA[big game hunting]]></usage2> |
|
N | usage3 | string | 50 | Optional |
Optional usage for this type of ammo. "hunting","target","defense","tactical","duck hunting","big game", etc. NOTE: There are no restrictions on what can be put here, but common phrases used in searching for ammo are most ideal. |
<usage3>bird hunting</usage3>
<usage3><![CDATA[bird hunting]]></usage3> |
|
N | usage4 | string | 50 | Optional |
Optional usage for this type of ammo. "hunting","target","defense","tactical","duck hunting","big game", etc. NOTE: There are no restrictions on what can be put here, but common phrases used in searching for ammo are most ideal. |
<usage4>military</usage4>
<usage4><![CDATA[military]]></usage4> |
|
N | mpn | string | 50 | Optional |
Optional manufacturer part number. This is the part number usually located on the product package. NOTE: Please do not use a distributor's part number here. |
<mpn><![CDATA[12OOB]]></mpn>
<mpn>12OOB</mpn> |
|
N | upc | string | 24 | N/A |
Optional UPC - Universal Product Code. NOTE: Many manufacturers do not assign UPCs to their products. If this is the case, leave blank. |
<upc>645611121104</upc> | |
N | unit_ship_weight | decimal | N/A |
Shipping weight, in lbs, for the [sold_by_units] specified. If sold by the case, for example, put the total case weight (including packaging) here. If sold by the box, put the box weight (including packaging) here. NOTE: You may use fractional lbs (29 1/2 lbs would be entered as 29.5) |
<unit_ship_weight>29.5</unit_ship_weight> |