Zanders as a Source
Summary
Zanders is a firearms and accessories distributor. Inventory is delivered over FTP, while orders go out through a separate Zanders ordering API that uses up to three distinct account types (Main (ship-to-store), Accessory Direct Ship, and Firearm Direct Ship) because accessories and serialized firearms can never be combined in the same order.
Zanders uses two connections: a Zander FTP connection for inventory (Get Inventory jobs) and a Zander Integration order connection for Send Orders and Get Shipments. Add a source, start the relevant job, click + New Connection, enter the values, then Test Connection → Save Connection.
| Field | What to enter |
|---|---|
FTP HostRequired | The Zanders FTP server that hosts your inventory files. Entered on the Zander FTP connection.
Zanders FTP host is ftp2.gzanders.com. |
FTP PortRequired | The port for the FTP connection.
Port 21. |
FTP ProtocolRequired | The transfer protocol used for the FTP connection.
Confirm the protocol with Zanders. |
FTP UserRequired | Your FTP username for the Zanders inventory server.
Provided by Zanders. |
FTP PasswordRequired | The password paired with your FTP user.
Provided by Zanders. |
EnvironmentSetting | On the Zander Integration (order) connection, choose Sandbox or Production. Sandbox orders are accepted but never actually processed.
Always select Production for live order fulfillment. |
Zanders order account credentialsRequired | Each Zanders order account type: Main Account Username, Main Account Password, Accessory Account Username, Accessory Account Password, Firearm Account Username, Firearm Account Password: is a separate order connection using its own dedicated API credentials from Zanders.
These API credentials are separate from your Zanders dealer website login: request the correct set for each account type from your Zanders rep. |
52.44.101.151 and 52.1.186.211: give these to Zanders directly so you don't need to request them separately.Three separate API accounts: never mix accessories and firearms in one order
Zanders provides three distinct API credential sets for ordering, each with its own purpose and restriction: Main (ships to your store, accessories + firearms together), Accessory Direct Ship (non-serialized accessories to consumers), and Firearm Direct Ship (serialized firearms to FFL holders). Direct Ship accessories and firearms must be placed on separate accounts using separate Fulfillment Requests: mixing serialized firearms and non-serialized accessories in one Direct Ship order will be rejected.
Set the Custom Inventory Directory if Zanders uses a dealer-specific subfolder
Zanders may place your inventory files in a dealer-specific subfolder (e.g. Inventory/YourStoreName). If so, enter the relative path (no leading slash) in the Custom Inventory Directory setting in Get Inventory Primary. Without it, Flxpoint looks in the root FTP directory and finds no files. Primary reads zandersinv.csv and liveinv.csv from the subfolder; Secondary reads only liveinv.csv. Confirm with Zanders whether your account uses a subdirectory.
Select Production (not Sandbox) on the order connection
The Zanders order connection includes an environment selector. Sandbox orders are accepted without being processed. If orders submit successfully in Flxpoint but never appear in the Zanders dealer portal, confirm the connection is set to Production.
API credentials are not your Zanders website login
The three Zanders API accounts (Main, Accessory DS, Firearm DS) use dedicated API credentials issued by Zanders: these are separate from your Zanders dealer website username and password. Contact your Zanders account rep for the correct API credentials for each account type you need to activate.
Order routing logic and the DirectShip attribute
Flxpoint routes Fulfillment Requests based on the DirectShip attribute on your order line items. If the Main account is configured and any item is marked DirectShip: No, the entire order routes to the Main account (shiptoaddresses 0001). If no items are marked 'No' and the Firearm account is configured for a firearm product, Flxpoint automatically calls the Zanders API to generate the required ship-to address and instructions. Accessory orders route to the Accessory account only if the Main account is not configured and no items are marked 'DirectShip: No'.
Error: Main account required for non-dropship items
If an order contains a line item with the attribute DirectShip: No but you have not configured the Main account credentials in your Zanders source connection, Flxpoint will throw an error and fail to send the Fulfillment Request. Ensure your Main account is connected if you process any orders that must ship to your store rather than the consumer.
Preventing incorrect parent SKU merges
If Zanders shares a parent SKU with another source for different products, Flxpoint may merge them. In your Builder settings, enable 'Create New Product Parent' under parent attachment settings. This generates a unique 4-character hash (e.g., P123-a82j) to ensure the products remain distinct.
Retrieves full product data, pricing and quantity from the product file on the Zanders FTP
| Zanders Field | Maps To: Notes |
|---|---|
| Item Number | → Parent SKU, Variant SKU and Master SKU. Primary product identifier / linking key. |
| Serialized | There is no direct field for Serialized. First map Requires FFL to True or False, then set a rule for serialized products: for example: IF Zanders Product Serialized equals Yes, Then Incoming Value Set to True (mapping and rule can also go the other way). |
| UPC | Use a rule to remove the leading zero: Zanders includes a leading zero that causes UPC mismatch issues on channels. |
| Description1 + Description2 | Combine via a rule for the product title / description. |
| Firearm identification | No such field is available from Zanders. Flxpoint adds this as a custom field at the variant level using Direct Copy. |
| Bulk pricing | Supported, but must be mapped to the Price 2 or Price 3 fields. |
| Category | Only single-level categories are supported. |
zandersinv.csv (with liveinv.csv) on the FTP.Pulls just pricing and quantity from liveinv.csv to keep Cost, MAP, MSRP and Quantity fresh
liveinv.csv. Pre-configured default mapping templates are available for Zanders Secondary. Run it on a more frequent schedule than Primary (hourly if possible) to keep pricing and quantity current.Submits Fulfillment Requests through the matching Zanders account (Main, Accessory DS or Firearm DS)
itemNumber sent on the FR is default-mapped to SKU. Shipping method is mapped with a code such as UPS-GND: confirm valid codes with Zanders. Place accessory and firearm orders through their matching account (Accessory DS vs Firearm DS); they cannot share one FR. Flxpoint shows an error message if an FR cannot be processed.Pulls tracking back into Flxpoint at the Fulfillment Request level
Send FR fails with a null UseShipToResponse.getReturn() error
FTP connection failing despite correct credentials
Orders selling out of stock, or items no longer in the Zanders feed
liveinv.csv updates frequently, so schedule Secondary hourly if possible. For items no longer in the feed (discontinued), confirm Archive is enabled on Primary or Secondary so removed items are deactivated in Flxpoint.Products missing from the Zanders feed / inventory not loading
zandersinv.csv and liveinv.csv are present in the expected directory.What are the three Zanders API account types and when do I use each?
What is the Custom Inventory Directory and how do I configure it?
Inventory/YourStoreName), enter the relative path in the Custom Inventory Directory field in the Get Inventory Primary settings: do not include a leading slash. Primary will read both zandersinv.csv and liveinv.csv from that subfolder; Secondary reads only liveinv.csv from the same path. If Zanders does not use a subdirectory for your account, leave this field empty.What fields does Get Inventory Secondary return from Zanders?
liveinv.csv: variant-level SKU, Cost, MAP, MSRP and Quantity. Pre-configured default mapping templates are available for Zanders Secondary. Run it on a more frequent schedule than Primary to keep pricing and quantity current.What fields are required for Send Orders (Fulfillment Requests) to Zanders?
UPS-GND: check your Zanders account documentation for valid shipping method codes. The FR Lookback Period defaults to 90 days; adjust it in Advanced Settings if you need to retrieve shipments for older FRs.