Skip to content

Amazon

List your Amazon-eligible accessories with an Inventory Loader feed

Updated View as Markdown

Amazon Integration

Export the part of your catalog Amazon actually allows into an Inventory Loader feed for Seller Central.


What Amazon Will and Will Not List

This is the important part, and it makes the Amazon feed different from every other feed FirearmCart produces.

Amazon prohibits most of what a firearms retailer sells. Rather than let Amazon reject your feed — or worse, put your seller account at risk — FirearmCart filters restricted products out before the feed is generated. They are never included, regardless of their status or stock.

Excluded automatically:

Category Examples
Firearms Handguns, rifles, shotguns, long guns, receivers and frames, muzzleloaders and black powder guns
Suppressors Suppressors, suppressor parts and accessories, and other NFA items
Gun parts Barrels, handguards, triggers, muzzle brakes and flash hiders, bolt carriers, charging handles, gas blocks, buffer tubes, slides, parts kits, foregrips and conversion kits
Ammunition All ammunition, including handgun, rifle, rimfire and shotgun
Magazines Handgun and rifle magazines, and magazine extensions, releases and tubes
Reloading components Primers, percussion caps, smokeless powder and black powder substitutes, bullets (including muzzleloader bullets and sabots), brass, bullet casting

What remains — optics, cases, cleaning supplies, apparel, general accessories — is what the feed carries.

Some accessory types mix items Amazon allows with items it doesn’t, so they stay in the feed: Amazon allows handgun grips, fixed stocks, single rails, choke tubes without spikes and two-point slings, but not pistol grips for rifles, folding or collapsible stocks, pistol braces, quad rails or single-point slings. Check products typed as grips, stocks, rails, chokes or slings before uploading the feed.

Because of this, the Amazon feed is usually much smaller than your other feeds. That is expected, not a misconfiguration.

Two further exclusions are structural rather than an Amazon rule: event-backing products, which are sold through the event registration flow rather than as catalogue items, and any product with no product type set at all — an unclassified product is held back so a mis-typed firearm can never leak into the feed.


Features

  • Inventory Loader format - Tab-separated, Amazon Seller Central compatible
  • Auto-updates - Feed refreshes every 5 minutes
  • Restricted-product filtering - Prohibited categories removed automatically
  • UPC and brand matching - Both are required to match Amazon’s catalogue. The UPC comes from the product’s Barcode field and the brand from its specifications

Setting Up

  1. Navigate to Plugins > Marketplace
  2. Find Amazon and click Activate
  3. Click Configure and copy the feed URL shown in the modal
  4. In Seller Central, use the URL with an Inventory Loader upload, or download the file and upload it manually

Your feed is served at /amazon.txt on your storefront domain.


Feed Fields

The tab-separated file carries these twelve columns, in this order:

Field Description
sku Your product SKU, or the internal ID when there is no SKU
product-id The product’s UPC or EAN, from its Barcode (ISBN, UPC, GTIN, etc.) field. When that field is empty, a UPC, Barcode, GTIN or EAN specification is used instead
product-id-type 3, Amazon’s code for a 12-digit UPC, or 4 for a 13-digit EAN
price Product price
item-condition Always 11, Amazon’s code for New
quantity Available stock
add-delete Always a — every row adds or updates a listing. The feed never deletes
will-ship-internationally Always n
expedited-shipping Always n
item-note Product description, HTML stripped
fulfillment-center-id Always DEFAULT
product-tax-code Always A_GEN_NOTAX — override it in Seller Central if your products are taxed

Troubleshooting

A Product Is Missing

Check its product type first. If it falls into any restricted category above, it is excluded deliberately and no setting will include it. A product with no type set at all is excluded too.

Otherwise, confirm the product is active, in stock, not soft-deleted, and has both a valid UPC in its Barcode (ISBN, UPC, GTIN, etc.) field and a Brand or Manufacturer specification. Amazon needs both to match an existing listing, and a product missing either is skipped.

The plugin’s Configure modal counts how many products are blocked by type, missing a valid UPC, and missing a brand, which is the quickest way to see which of these is affecting you.

A Product Has a Barcode but Is Missing a Valid UPC

Amazon matches products by a 12-digit UPC or a 13-digit EAN, and the feed only sends a barcode that is one of those with a correct check digit, the last digit, which is calculated from the others. A product’s barcode is left out when it:

  • Has the wrong check digit, which usually means a mistyped digit
  • Is a part number, SKU or placeholder such as 000000000000 rather than a barcode
  • Is a 14-digit GTIN that doesn’t start with 0, which identifies a case or inner pack rather than the item
  • Is an 8-digit code

Some barcodes are corrected rather than left out. An 11-digit barcode is a UPC that lost its leading zero, often in a spreadsheet, so it is sent with the zero put back. A 13- or 14-digit code that starts with 0 is a UPC or EAN with padding in front, so it is sent without the padding.

To include the product, enter the UPC or EAN printed on its packaging in the Barcode field.

Feed Not Updating

Feeds are cached for 5 minutes. Wait for the cache to expire, then re-check the conditions above.

Feed URL Not Available

Ensure the Amazon plugin is still active — the URL 404s when it is not — and that you have an active domain configured in Settings > Domains.


Navigation

Type to search…

↑↓ navigate↵ selectEsc close