ALMS Marketplace as a Source
Summary
ALMS Marketplace is a pre-built supplier integration in Flxpoint that uses a dual credential model: inventory operations (Get Inventory Primary and Secondary) connect via a Feed URL, while order operations (Send Fulfillment Requests and Get Shipments) connect via a separate API Token generated in your ALMS Marketplace account. You'll need to create both connection types before configuring all four supported operations; for operation-level mapping guidance contact support@flxpoint.com.
ALMS Marketplace uses two separate connections — a Feed URL connection for inventory operations and an API Token connection for order operations. Add an ALMS Marketplace source, start configuring an operation, and when Flxpoint prompts you click + New Connection, enter the credential for that operation's connection type, then Test Connection → Save Connection. Repeat for the second connection type before configuring the remaining operations.
support@flxpoint.com.Two separate connections required — Feed URL for inventory, API Token for order operations
GIP and GIS use a connection with a Feed URL (the URL to ALMS Marketplace's inventory feed API). Send FR and Get Shipments use a connection with an API Token from your ALMS Marketplace account (Settings → API Access → generate or copy your token). Create both connections before configuring all four operations.
GIP imports a full catalog: SKU, Title, Description, UPC, MPN, Manufacturer, Quantity, Cost, MSRP, Price, Categories, Dimensions, Images
GIP retrieves a full product record per SKU including: Product Sku (Parent SKU), Title, Description, UPC, EAN, MPN, Manufacturer, Category 1/2/3, Image URLs, Quantity, Cost, MSRP, Price, Estimated Dropship Fee, Estimated Shipping Cost, Height, Length, Width, Weight. GIS is a delta feed focused on variant-level updates: SKU, Cost, MAP, MSRP, Price, Quantity, Shipping Cost. Enable Allow Create Variant in GIS settings if new variants may appear.
Send FR: State or State Code must be mapped — at least one is required
When configuring Send FR, the shipping address requires either State (full name, e.g., "California") or State Code (abbreviation, e.g., "CA") — at least one must be mapped. If neither is present in the mapping template, the order submission will fail with a validation error. Also map: Order Number (FR Number), SKU, Quantity, Address Line 1, City, Postal Code, Country.
Get Shipments: Return PO Number links shipment back to the FR — required mapping
Get Shipments retrieves: Carrier, Method, Note, Return PO Number, Shipped At, Shipping Cost, Tracking Number, Tracking URL, Shipment ID. The critical linking field is Return PO Number → Fulfillment Request Number — this connects the incoming shipment record to the correct FR in Flxpoint. Without this mapping, shipments will not associate to orders. Shipment item fields: SKU, Quantity, External Order Item ID.
| Field | Maps To — Notes |
|---|---|
| Product Sku | → Product → Parent SKU. Groups variants under one catalog product. |
| Sku | → Variant → SKU. Required. Primary identifier for the catalog item. |
| Title / Description | → Product → Title / Description. Product-level catalog copy. |
| UPC / EAN / MPN | → Identifiers. Barcode and manufacturer part reference fields. |
| Manufacturer / Category 1-3 | → Product → Manufacturer / Categories. Brand and category classification. |
| Cost / MSRP / Price | → Pricing. Your ALMS Marketplace cost and suggested resale pricing. |
| Quantity | → Inventory → Quantity. Available units for the variant. |
| Images / Height, Length, Width, Weight | → Product/Variant → Images, Dimensions. Catalog images and shipping dimensions. |
| Field | Maps To — Notes |
|---|---|
| Sku | → Variant → SKU. Required. Primary identifier. |
| Cost | → Pricing → Cost. Current dealer cost. |
| MAP | → Pricing → MAP. Minimum advertised price. |
| Msrp | → Pricing → MSRP. |
| Price | → Pricing → Price. |
| Quantity | → Inventory → Quantity. Current available units. |
| Estimated Shipping Cost | → Shipping → Estimated Shipping Cost. |
| Full catalog fields | Not included in Secondary — title, categories and identifiers come from Get Inventory Primary. Run Primary daily for the full catalog and Secondary more frequently to keep Cost, MAP, MSRP, Price and Quantity current. |
| Source Field | Maps To (ALMS Marketplace) — Notes |
|---|---|
| Fulfillment Request Number | → Order Number. Required. Sent to ALMS Marketplace as the order reference. |
| Fulfillment Request line → SKU | → Order Item → SKU. Required. Sent per line item. |
| Fulfillment Request line → Quantity | → Order Item → Quantity. Required. Units requested per line. |
| Shipping address → Address Line 1, City, Postal Code, Country | → Ship To. Required. End-customer shipping address fields. |
| Shipping address → State or State Code | → Ship To → State / State Code. Required — at least one. Order submission fails validation if neither is mapped. |
| Ship-to contact / company name | → Ship To Contact. Contact name/company for the shipment. |
| Field | Maps To — Notes |
|---|---|
| Tracking Number | → Shipment → Tracking Number. Required. Package tracking number. |
| Return PO Number | → Shipment → Fulfillment Request Number. Required. Critical linking field — connects the shipment back to the FR; without it, shipments import as orphaned records. |
| Carrier / Method | → Shipment → Carrier / Ship Method. Carrier and shipping method returned by ALMS Marketplace. |
| Shipped At | → Shipment → Shipped At. When ALMS Marketplace marks the shipment shipped. |
| Shipping Cost | → Shipment → Shipping Cost. Cost of the shipment. |
| Item SKU | → Shipment Item → SKU. Required. Associates the shipped line to your catalog. |
| Item Quantity / External Order Item ID | → Shipment Item → Quantity / External Order Item ID. Required (Quantity). Units shipped and channel order-item reference. |