Orchid
POS integration with GUNS.COM
This program,
printed documentation and documents should not be used as a substitute for
professional advice in specific situations. The procedures, images and examples
in this document are for illustrative purposes only and may not be applicable
in your setting due to differences in preference, settings and/or state and
local regulations.
The Guns.com
integration connects your Orchid POS account with their environment, for the
listing of selected inventory and reporting of online sales through their
marketplace. The following procedure will guide you through the steps for integrating
their platform with Orchid POS.
Overview
Guns.com is
an online marketplace specializing in the sale of new and used firearms,
suppressors, and related products. This integration allows for seamless
synchronization of selected inventory via toggles located in the Managed
Products > Inventory > Sales Channel section of Orchid POS.
When enabled,
any available firearm inventory is automatically synced with the
Guns.com portal. Inventory reserved for layaway, online orders, pending sales,
or similar purposes will not be transmitted to Guns.com.
Additionally,
items sold in-store after being listed on the Guns.com platform are
automatically removed from their environment. Likewise, changes to Orchid POS stock
quantity also sync in real time such that newly received, unreserved inventory will
increase the quantity shown in Guns.com, and sales and other Orchid POS dispositions
will decrease the quantity shown in Guns.com.
How Can I Get Help With This Procedure?
Preliminary Account Review
New
integrations with Guns.com require a review and approval of your account, and generalized
evaluation of UPC quality prior to being enabled. To initiate this process, submit
a support ticket in the Orchid support portal or contact a Guns.com
representative. Guns.com will request an
export of your firearm inventory to review your UPCs and pricing, as a
protective measure to ensure that your products are not accidentally listed at
an abnormally low price such as $0 or $1, etc. Once your account has been cleared,
an Orchid support representative will enable the Guns.com integration portal inside
of Orchid POS. Note, this does not initiate the flow of inventory but makes the
integration settings and account activation area available to you.
Account Activation
Once approved,
navigate to Manage > Store Configuration > Integration > eCommerce.
There, you will find that the Guns.com integration API tool will now be
enabled, allowing you to enter your API Key and API Secret provided by Guns.com.
Please see below.
1. Turn
the toggle to “On”
Enabling the
test mode will sync inventory with your Guns.com sandbox in lieu of the
production environment 2. Enter
in the API Key and API Secret provided by Guns.com
a. The
API Key is your Guns.com username
b. The
API Secret is your Guns.com password
3. Click
Save and DO NOT hit sync inventory yet
Now that you
have enabled the integration, a Guns.com toggle will appear in the Manage
Products > Inventory > Sales Channel area for any item that has
returned in your item search. The next step in the process is to enable the
sync with a handful of UPCs for testing purposes.
Pre-Launch Test
Before
sending your entire inventory, we recommend that you turn on the Guns.com
toggles for 3 to 4 UPCs with available stock. To do so, navigate
to Manage Products > Inventory > Sales Channel area for each item,
and turn on the toggle.
Next, return
to Manage > Store Configuration > Integration > eCommerce and
click the Sync Inventory button. If your credentials are accurate and your
inventory is indeed in stock, you should instantly see them flow into your
Guns.com dashboard. If they do not, please submit a ticket in the Orchid
Support Portal.
Once you’ve
confirmed that the sync is working, you can return to your inventory, add all
of the items that you wish. There are three ways to list inventory online:
• In
Manage Products > Inventory (one at a time)
In
Manage Products > Inventory (in a group)
In
the Taxonomy > By Category
Managing Listings in Manage Settings >
Inventory
1. Filter
and Edit Individual Items:
a. Navigate
to the Manage Products page and use the Customize Visibility Filter (located below the search bar) to filter items specifically for Guns.com
visibility.
b. To
edit an individual item, click the pencil icon or the Part Number hyperlink to access its details.
c. In
the Sales Channel tab, toggle Guns.com visibility on or off as needed.
d. Only
items with a quantity of 1 or more and those registered on Guns.com will
appear as active listings in your Guns.com account.
e. When
an item sells, the available inventory on Guns.com will update automatically,
while the POS adjusts the quantity, moving the item to the Held for Online
Order category.
2. Bulk
Actions and Table View:
a. On
the Manage Products screen, switch the table view to StoreFront to access bulk actions such as Turn On Guns.com Visibility or Turn
Off Guns.com Visibility.
b. Similar
to individual items:
c. Only
items with a quantity of 1 or more and those registered on Guns.com will
appear as active listings.
d. Sold
items automatically update inventory on Guns.com and adjust POS quantities,
moving them to the Held for Online Order category.
Managing Listings with Your Taxonomy
Activate
Categories for Guns.com Listings:
1. Navigate
to Manage > Store Configuration > Table Editor > Taxonomy to
activate entire subcategories of inventory for Guns.com listings.
2. Rules
for visibility and updates:
a. Only
items with a quantity of 1 or more and those registered on Guns.com will
appear as active listings.
b. When
sold, inventory updates are handled automatically as described above
Final Inventory Sync
Once you’ve
selected all of the products that you wish to sync, return to the to Manage > Store Configuration > Integration >
eCommerce and follow this procedure
1. Hit
the “Reset” button. This action will allow you to re-enter your credentials one
more time and re-enable the Sync Inventory button.
2. You
may depress the Sync button to complete the full synchronization of all
selected items in your inventory. You will not need to do this again in the
future.
3. You’re now
live!
Orders
Once your
inventory is synced with Guns.com, orders will start appearing in your POS. The
POS queries Guns.com every 5 minutes to retrieve new orders.
• When
an item is sold:
Guns.com
inventory updates immediately.
• POS
inventory adjusts as soon as the order is retrieved.
• To
manually sync orders, navigate to POS > Sell > Invoices and Online
Orders > Sync Orders.
1. Processing
Guns.com Orders
a. Navigate
to POS > Sell > Invoices and Online Orders and select an invoice
marked as received.
b. Use
the truck icon to mark items as delivered:
c. If
the customer is picking up in-store.
d. If
the item is being shipped (ensure the alternative shipping address is correct).
e. Use
the Action dropdown in the top-right corner to print a packing list for
the shipment.
2. Firearm
Orders:
a. If the order involves a firearm for in-store pickup:
b. Assign
the serial number and initiate a Paper 4473, e4473, or bypass the
4473 requirements by clicking Checkout (only if the firearm was
previously disposed of manually).
c. For
all Guns.com orders:
d. Product
details and price paid (pre-selling fees) will be included in the invoice.