GunBroker Listing Integration Guide

How to export GunBroker listings, request UPC data, map category IDs, and import into Orchid eCommerce.

Updated Jun 04, 2026 9 views
GunBroker Integration
Orchid eCommerce Integration: This guide covers how to export your existing GunBroker listings and prepare them for import into Orchid eCommerce. Your Orchid implementation consultant will provide the import template and walk you through the reconciliation process.

Overview

If you sell on GunBroker and are migrating to Orchid eCommerce, your existing GunBroker listings need to be exported, enriched with UPC data, mapped to GunBroker's category taxonomy, and reconciled against your POS inventory before Orchid can sync them.

Before You Start

  • Confirm you have a GunBroker seller account with active listings.
  • Request your Orchid implementation workbook from your consultant — the GunBroker import tab will be included.
  • Allow 1–2 business days for GunBroker to return UPC data after you request it (see Step 2).
  • Webhooks must be configured correctly in Orchid before listings will sync. Your consultant handles this.

Step-by-Step Instructions

Step 1: Export Your Listings from GunBroker

  1. Sign in to your GunBroker account.
  2. Navigate to the Selling section.
  3. Find the option to Export All Listings.
  4. Download the export file. This file contains all required columns except UPC (GunBroker does not include UPC in the standard export).

Step 2: Request UPC Data from GunBroker

  1. Email your exported listing file to api@gunbroker.com.
  2. Request the UPC for each item in your export.
  3. GunBroker typically responds within 1–2 business days.
Tip: Request the UPC early in your migration timeline. Waiting until the last minute can delay your go-live date.

Step 3: Reconcile Listings Against POS Inventory

Before importing into Orchid, verify that every GunBroker listing matches an item in your POS inventory:

  • Confirm the item exists in your POS system with matching UPC.
  • Confirm quantities are accurate — GunBroker listings should not exceed physical on-hand inventory.
  • Use UPC as the source of truth, not SKU. Some sellers create custom SKUs in GunBroker that do not match their POS SKU.

Step 4: Map GunBroker Category IDs

The import template requires a Category ID column. This must use GunBroker's own taxonomy — not Orchid's category system.

Critical: Category assignment must be exact. A single character difference will cause the import to fail. For example, "Pistol" is not the same as "Pistols." Use the subcategory ID number from GunBroker's taxonomy, not the category name.

GunBroker's taxonomy has 28 parent categories with hundreds of subcategories. Only subcategories marked as "Listable" can contain items. Here are the most common parent categories for firearms retailers:

  • Guns & Firearms (Handguns, Rifles, Shotguns)
  • Ammo (Rifle, Handgun, Shotgun, Rimfire)
  • Gun Parts (AR, AK, 1911, Glock, etc.)
  • Scopes & Optics
  • NFA Guns & Silencers
  • Holsters
  • Reloading (Equipment & Supplies)
  • Shooting Supplies
  • Knives & Swords
  • Archery & Bow Hunting

Your Orchid consultant will provide the full GunBroker category directory with IDs. Use the subcategory ID (e.g., 3026 for "Semi Auto Pistols") in the Category ID column.

Step 5: Complete the Import Template

The Orchid implementation workbook includes a GunBroker import tab with the following column requirements:

  • Always required: Item title, description, category ID, quantity, condition, and images.
  • Required for Fixed Price listings: Fixed Price field.
  • Required for Auction listings: Starting Bid field.

Common Pitfalls

  • Do not trust exported SKUs blindly. Some sellers create unique SKUs in GunBroker that differ from their POS. Always use UPC as the source of truth.
  • Category IDs must be exact GunBroker subcategory IDs. Using Orchid category IDs or misspelled category names will fail the import.
  • Webhooks must be configured before listings go live. If webhooks are not set up correctly, listings will not sync between Orchid and GunBroker. Your consultant handles webhook configuration.
  • Request UPCs early. GunBroker takes 1–2 business days to return UPC data. Plan ahead.
Need help? Your Orchid implementation consultant will walk you through the GunBroker import template and category mapping. Submit a support ticket for assistance.

Was this article helpful?

Thanks for your feedback!