FragranceX as a Source
Summary
FragranceX is a supplier of discounted fragrances and beauty products, integrated via API. The connection requires an API Key/Username and Password, both provided directly by FragranceX. The integration runs Get Inventory (Primary and Secondary), Send Fulfillment Requests, and Get Shipments; for account-specific operation availability and mapping guidance, contact support@flxpoint.com.
FragranceX requires API credentials — your API Access Key and API Access ID — only for Send Fulfillment Requests and Get Shipments; Get Inventory (Primary) and Get Inventory (Secondary) do not use this connection. Add a FragranceX source, start configuring Send Fulfillment Requests or Get Shipments, and when Flxpoint prompts you click + New Connection, enter the values, then Test Connection → Save Connection.
support@flxpoint.com.Credentials come from FragranceX — API Access Key and API Access ID are required for Send Fulfillment Requests and Get Shipments
The FragranceX connection requires an API Access Key and an API Access ID, both provided directly by FragranceX, used only when configuring Send Fulfillment Requests and Get Shipments — Get Inventory (Primary) and Get Inventory (Secondary) do not use this connection. These are distinct from your FragranceX website login. If you do not have API credentials, contact your FragranceX account representative to request them before attempting to configure the source in Flxpoint.
For Feed URL or extended operation details, contact Flxpoint Support
The FragranceX integration documentation covers connection setup only. For information about which operations are enabled for your account, Feed URL requirements, or advanced mapping guidance, email support@flxpoint.com. Flxpoint Support can confirm what operations are available and assist with configuration for your specific FragranceX account.
| Field | Maps To — Notes |
|---|---|
| ITEM | → Product / Variant → SKU. Required. Primary identifier for the catalog item. |
| NAME | → Product → Title. Product name used as the catalog title. |
| IMAGE | → Variant → Images. Product image, added automatically when present. |
| Size | → Variant → Weight. Parsed automatically (ounces or grams, including multi-pack and fractional sizes) and converted to pounds; left blank if the value can't be parsed. |
| Metric_Size | → Mapped via your mapping template, like any other field — the Attribute field type is not available for auto-mapping in FragranceX. |
| GENDER | → Mapped via your mapping template, the same way as Category 1 — the Attribute field type is not available for auto-mapping in FragranceX. |
| PRICE / RETAIL | → Pricing → Cost / MSRP. Mapped via your mapping template. |
| QTY | → Inventory → Quantity. Mapped via your mapping template. |
| UPC | → Identifiers → UPC / Barcode. Mapped via your mapping template. |
| DESCRIPTION, BRAND, TITLE, URL | → Mapped via your mapping template. Additional catalog fields (description, brand, an alternate title, and the product URL) — assign each to the target field you want. |
| Field | Maps To — Notes |
|---|---|
| ITEM | → Inventory Variant → SKU. Required. Primary identifier. |
| PRICE / QTY | → Pricing → Cost / Inventory → Quantity. Mapped via your mapping template; keeps cost and stock current between full catalog runs. |
| Size | → Variant → Weight. Parsed the same way as Get Inventory (Primary). |
| Full catalog fields | Not included in Secondary — title, brand, description, attributes and images come from Get Inventory Primary. Run Primary daily (or as scheduled) for the full catalog and Secondary more frequently to keep Cost and Quantity current. |
| Source Field | Maps To (FragranceX) — Notes |
|---|---|
| Fulfillment Request Item → SKU | → Order Item ID. Required. Sent to FragranceX per line item. |
| Fulfillment Request Item → Quantity | → Order Item Quantity. Required. Units requested. |
| Shipping address | → Ship To (name, address lines, city, state, zip, country, phone). Required. End-customer shipping address. |
| Source Shipping Method | → Ship Method. Mapped via your mapping template to FragranceX's shipping option (Ground, 2nd Day Air, International Standard, or International Premium). |
| PO / Order reference | → Reference ID. Mapped via your mapping template; used by FragranceX to reference the order. |
| Dropship / gift-wrap flags | → Is Dropship / Is Gift Wrapped / Gift Wrap Message. Optional — mapped via your mapping template if your account uses dropship or gift-wrap flags. |
| Field | Maps To — Notes |
|---|---|
| Carrier | → Shipment → Carrier. Mapped via your mapping template. |
| Service | → Shipment → Ship Method. Carrier service level returned by FragranceX. |
| TrackingNumber | → Shipment → Tracking Number. Required. Package tracking number. |
| DateShipped | → Shipment → Shipped At. When FragranceX marks the order shipped. |
| Shipment items | → Shipment Item → SKU / Quantity. FragranceX doesn't return line-level shipment detail — Flxpoint marks the full purchase order as shipped, using the original order's SKUs and quantities. |