AmmoSeek Feed Specifications & Knowledge
What is the feed specification of AmmoSeek?
The data feed format isn't as important as the data it contains. However, a feed in their format will get your products added to AmmoSeek quickly, whereas other formats will require time for them to parse it properly.
To meet AmmoSeek requirements:
- The feed must be real-time or updated at least every 5 minutes.
- The feed should include only in-stock/available products, or clearly indicate whether the product is in-stock or not by a field like <qty_available>72</qty_available> or <availability>in stock</availability>. *
- Each record in the feed should contain an indicator of the product type the record contains. The product types we support, as described below, are:
- "ammunition"
- "magazines"
- "guns"
- "bullets"
- "brass"
- "primers"
- "powder"
- "reloading_misc" - dies, presses, etc.
This product type indicator can be omitted if you only sell one product type and do not plan to expand in the future.
- Our system is designed to read in one feed per retailer. Therefore, if you are going to list multiple product types (e.g. ammunition, magazines, primers, etc.), all products should appear in the same data feed (with the main difference being the value of the <type> field indicating the product type).
- When one exists, each product should include a UPC or MPN, either in the <upc> field or in the product title (<title>) somewhere.
- All items listed in the feed should be purchasable by the general public without qualification (i.e. no "membership" or any other purchase required). If you offer a lower price with a membership, the higher (non-member) price should appear in the data feed.
- The <manufacturer> field should contain the name of the manufacturer who assembled the ammunition. If it contains Federal Brass and Nosler bullets, but your company remanufactured/reloaded it, then the <manufacturer> field should contain your company's name or "factory reload".
- Purchase limits (for ammo): if there is a limit to the number of boxes that a customer can purchase, and the limit corresponds to less than 1000 rounds, the XML record should include a <purchaselimit> field containing an integer equal to the maximum number of boxes one may purchase. (A <purchaselimit> of 0 (or absence of this field) would indicate no limit). Alternatively, you can put "N box limit" in the product title (where N is the maximum number of boxes one can purchase). Remember, this rule only applies to limits of less than 1,000 rounds where the limit is set by policy, not simply by a low supply in stock.
- Minimum purchases (for ammo): if the customer must purchase a minimum number of units, it's best to simply fill in the <numrounds> and <price> fields with the total number of rounds and the total price that constitutes the minimum. For example, if you have a 50rd box for $9.99 but you require a minimum purchase of 10 boxes, then the <numrounds> should be set to "500 and the <price> set to "99.90". Alternatively, you can populate a <minpurchase> field with the minimum number of units (in this case, 10), and we'll do the math for you before posting the item to our listings. (Instead of using a <minpurchase> field, you can add "N box minimum" to the product title, where N is the minimum number of boxes the customer must purchase).
- Ammo condition: if the ammunition is not considered 'factory new', the XML record should contain a field called <condition> which would have a value of "remanufactured", "factory seconds" or "new". (A condition of "new" is assumed if not otherwise specified). Alternatively, the terms 'remanufactured' or 'factory seconds' (or "blemished") can be added to the product <title>. NOTE: The terms "reloaded" and "remanufactured" are synonymous for their purposes.
- Ammo casing: if the case is not made of brass, there should be a <casing> field (valid values are 'aluminum', 'steel', 'brass', 'NAS3', or 'plastic'). Alternatively, the words 'steel case' or 'aluminium case' can be added to the product <title>. Note that our system will assume that ammunition has a brass case unless your feed indicates otherwise.
- Each record in the feed should contain, at minimum, the information listed in the tabs below for each product type.
Let's see what values and attributes are required for each product type in the AmmoSeek.
These are a mandatory value that needs to be available in the feed if the users want their data feed to work on the AmmoSeek.
Ammunition:
Bullets:
Brass:
Primers:
Magazines:
Here is an example of one XML feed:
For more reference and detailed information, please visit this page from AmmoSeek.