Sex Toy Distributing is a wholesale supplier of adult toys, lingerie, lubricants, and wellness products, offering retailers an extensive inventory of top brands, discreet shipping, and bulk pricing. Their distribution services support both brick-and-mortar stores and e-commerce businesses.
How to connect
Important: Sex Toy Distributing (STD) and XR Direct work together in this integration:
- STD provides your inventory feed and product catalog
- XR Direct handles order placement and fulfillment
- You'll need credentials for both systems to complete the setup
📋 Phase 1: Initial Source Setup
+
Access Fulfillment Sources
Log into your Flxpoint account and navigate to the Connections tab, then select Fulfillment Sources.
Create a New Source
Under the Sources section, click on + Add Source to begin creating a new source for your Sex Toy Distributing connection.
Tip: Having both your STD and XR Direct account credentials ready will make this process smoother. You'll need your STD API credentials for inventory and XR Direct API access for orders.
Configure Source Details
In the Create Source popup:
- Enter the source name as "Sex Toy Distributing" or "STD"
- Select the appropriate type from the dropdown (typically "Vendor Warehouse")
- Click Save to proceed
Start the Integration Process
After saving, you'll see a message that says "You have not created any integrations yet." Click Get Started to set up the integration.
🔐 Phase 2: Supplier Connection & Authentication
+
Select Connection Method
In the Setup Integrations popup, select Flx Supplier Directory (recommended) to proceed with the Sex Toy Distributing integration.
Find Your Supplier
In the Let's Find Your Supplier popup, search for "Sex Toy Distributing" or "STD" in the Search Suppliers field. Select Sex Toy Distributing from the list and click Select.
Confirm Relationship
In the Confirm Your Relationship With Supplier popup, check the box to confirm that you have a reseller account with Sex Toy Distributing. Click Continue.
Important: You must have active accounts with both Sex Toy Distributing and XR Direct before proceeding with this integration.
Enter Authentication Details
In the Authenticate With Supplier popup, enter your Sex Toy Distributing API credentials:
API Key: Your STD API key (Required to authenticate with Sex Toy Distributing API for integration)
API Login: Your STD API login (Required to authenticate with Sex Toy Distributing API for integration)
Click Continue to proceed.
XR Direct API Access: For automated order processing, you'll also need your XR Direct API credentials. These are configured in Phase 3. The XR Direct API endpoint is:
https://api.xrdirect.com/
🔄 Phase 3: Configuration & Feature Setup
+
Configure Product Feed URL
In the Default Settings section, you'll find the Product Feed URL field. This URL is automatically provided to each customer by Sex Toy Distributing and contains your specific product catalog.
Product Feed: The product feed URL is unique to your account and provides access to STD's inventory data, pricing, and product information.
Set Up SKU Mapping
In the Master SKU section, set up your SKU mapping (Inventory SKU → Master SKU → Listing SKU). Optionally, set an SKU prefix (e.g., "STD-") if needed for better organization.
Pro Tip: Using a prefix like "STD-" helps you quickly identify products sourced from Sex Toy Distributing in your inventory listings.
Configure Order Processing with XR Direct
Set up automated order processing through XR Direct:
- Enable Auto Send Orders: Toggle this on to automatically send orders to XR Direct
- XR Direct API Key: Enter your XR Direct API key for order automation
- Order Volume Requirements: Note that automated ordering may require achieving certain order volume/GMV thresholds
- Manual Order Option: Initially, you may need to place orders manually through the XR Direct portal
Shipping Method Note: If you encounter the error "Best/Cheapest Way is not a valid shipping method," ensure you're using the correct shipping codes accepted by XR Direct.
Configure Additional Features
Complete your integration setup:
- Inventory Sync: Enable to keep stock levels updated from STD's feed
- Price Updates: Configure automatic price synchronization
- Dropshipping: Set up dropship preferences if shipping directly to customers
- Accepted Codes: Ensure you're using the new accepted codes for product categories and shipping methods
Complete Setup
Review all your settings and click Save to finalize your Sex Toy Distributing / XR Direct integration.
Next Steps: After completing the setup:
- STD will provide your inventory feed and product data
- Orders will be sent to XR Direct for fulfillment
- Monitor your order volume to qualify for fully automated ordering
- Use the XR Direct portal for manual order placement if needed initially
×
![]()
Product Operations
The primary operation handles the bulk of your inventory management needs, while the secondary operation allows for more detailed control, such as focusing on specific products or updates
Get Inventory
Supported | Sex Toy Distributing - Get Inventory and Pricing & Quantity
Introduction to Sex Toy Distributing - Get Inventory and Pricing & Quantity Integration
This guide helps you set up the Sex Toy Distributing - Get Inventory and Pricing & Quantity integration. It syncs product data (e.g., attributes, SKUs) and updates stock levels and pricing, ensuring your catalog stays accurate. Let’s get started!
This integration imports and updates product data from Sex Toy Distributing:
- Get Inventory: Imports product details like attributes (e.g., brand, description), identifiers (e.g., SKU), and custom fields (e.g., Color, Scent).
- Pricing & Quantity: Updates stock quantities and pricing (e.g., cost, MAP, MSRP) as part of the Get Inventory sync.
The integration follows these steps:
- Authentication: Authenticates using your Sex Toy Distributing ordering credentials (e.g., login and password) to ensure access.
-
Download Product Feed: Downloads the client-specific Product Feed URL configured in the integration settings (e.g.,
http://www.sextoydistributing.com/feeds/LOGIN/PASSWORD/xrproducts4.xml). If this fails, the process exits with an error message. -
Download Generic Files: Downloads two cached files for additional data:
-
Image File:
https://www.sextoydistributing.com/feeds/LOGIN/PASSWORD/XML_ALL_IMAGES.xml(contains Variant SKUs and multiple images per SKU). Cached for 1440 minutes (24 hours) in the S3 Assets Bucket at/integration-files/sex-toy-distributing/images.xml. -
Inventory File:
https://feeds.xrllcsystems.com/inventory.csv(CSV file with SKU and Quantity). Cached for 60 minutes in the S3 Assets Bucket at/integration-files/sex-toy-distributing/inventory.csv.
-
Image File:
- Data Processing: Combines data from the Product Feed, Image File, and Inventory File to create comprehensive product records, including specifications, images, pricing, and inventory data.
- Field Mapping: Maps Sex Toy Distributing fields to Flxpoint’s product structure for parent and variant inventory items. If Direct Copy is enabled for images or options, these are mapped accordingly.
- Syncing: Data is processed and synced to your system, either manually or on a schedule (e.g., daily at 8 AM UTC). You can run the sync using the Run Sync option from the integration menu.
Important Note: If authentication fails or any file download fails, the process will exit with an error. Ensure your credentials and Product Feed URL are correct.
You can customize the integration with these settings:
- Enable/Disable Fields: Choose which fields to import in the mapping template (e.g., enable/disable "MAP").
- Copy Variant Images to Product: Enable this to copy (instead of move) shared variant images to the parent product. If disabled (default), shared images are moved to the parent.
- Direct Copy Options: Enable to directly copy variant options (e.g., Color, Size) from the feed. Note that some options may be blank (see Variations in Key Details).
- Scheduling: Run manually or schedule (e.g., daily at 8 AM UTC) using the "Adjust Schedule" option.
Follow these steps to configure the integration:
- 1 Access the Integration: Go to the Sex Toy Distributing source and select "Get Inventory."
-
2 Configure Credentials: Under "Authentication Details," enter:
- Login: Your Sex Toy Distributing login (e.g., invsource).
- Password: Your Sex Toy Distributing password (e.g., p@ssw0rd).
-
3 Configure Product Feed URL: Enter your client-specific Product Feed URL (e.g.,
http://www.sextoydistributing.com/feeds/LOGIN/PASSWORD/xrproducts4.xml). Test the URL in a browser to ensure it downloads correctly. -
4 Configure Advanced Settings: Adjust:
- Copy Variant Images to Product: Enable if you want to copy (not move) shared variant images to the parent product.
- Direct Copy Options: Enable to copy variant options directly, or disable if options are incomplete (see Variations in Key Details).
- 5 Create a Mapping Template: Use the "Manage Mapping" option to define which fields to import (see Mapping Templates section).
- 6 Run the Integration: Start manually using Run Sync or schedule via "Adjust Schedule."
Pricing and quantity data are included in the Get Inventory sync:
- Pricing: Sourced from the client-specific Product Feed URL (e.g., Price, MAP, Suggested Retail). Pricing may be custom for the client or generic, depending on the feed.
-
Quantity: Sourced from the “Qty Available” field in
https://feeds.xrllcsystems.com/inventory.csv(e.g., 50 units for SKU “AG472-Large”). Updated hourly.
Note: Since Sex Toy Distributing does not support a separate Pricing & Quantity integration, both pricing and quantity data are updated during the Get Inventory sync.
A mapping template controls how data is imported. In this version, you can only enable or disable fields.
Interface Overview
- The mapping screen is labeled “Sex Toy Distributing → Flxpoint” under “Get Inventory.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Sex Toy Distributing fields), Right (your system’s fields).
Mapping Options
- Enable: Import the field (e.g., enable “Cost”).
- Disable: Ignore the field (e.g., disable “MAP”).
- Required fields like “SKU” cannot be disabled.
Available Source Fields
- Sex Toy Distributing Inventory: Qty Available (Quantity).
- Sex Toy Distributing Item: All Attributes, All Images, Brand, Primary Category, Category, Price, Custom Field 1 Name (Color), Custom Field 10 Name (Scent), Custom Field 11 Name (Size), Custom Field 12 Name (Special Handling), Custom Field 13 Name (UOM), Custom Field 14 Name (Video), Custom Field 2 Name (Discontinued), Custom Field 3 Name (Flavor), Custom Field 4 Name (Location), Custom Field 5 Name (Manufacturer), Custom Field 6 Name (Master Product ID), Custom Field 7 Name (Option), Custom Field 8 Name (Packaging), Custom Field 9 Name (Recommended Categories), Description, Short Description, Dimension Unit, MAP, Model, Manufacturer Code, Suggested Retail, Title, UPC, Weight, Weight Unit.
Get Inventory Mapping Fields
These mappings cover product details like attributes, identifiers, custom fields, pricing, and quantities from Sex Toy Distributing files:
| Sex Toy Distributing Field | Maps To | Example | Purpose | Status |
|---|---|---|---|---|
| Qty Available | Inventory Variant: Quantity | 50 | Sets the inventory quantity | Enabled |
| All Attributes | Inventory Parent: All Attributes | Material: Silicone | Imports all product attributes | Enabled |
| All Images | Inventory Variant: All Images | https://www.sextoydistributing.com/.../ag994-black-bulk-002-b.jpg | Imports all variant images | Enabled |
| All Images | Inventory Parent: All Images | https://www.sextoydistributing.com/.../ag994-black-bulk-002-b.jpg | Imports all parent images | Enabled |
| Brand | Inventory Parent: Brand | XR Brands | Identifies the product’s brand | Enabled |
| Primary Category | Inventory Parent: Category 1 | FetishClothing | Primary category for organization | Enabled |
| Category | Inventory Parent: Category 2 | Clothing and Lingerie;Master Series | Secondary category for organization | Enabled |
| Price | Inventory Variant: Cost | 15.99 | Sets the primary cost of the item | Enabled |
| Custom Field 1 Name | Inventory Variant: Custom Field 1 Name | Color | Defines the name of Custom Field 1 | Enabled |
| Color | Inventory Variant: Custom Field 1 Value | Black | Specifies the product color | Enabled |
| Custom Field 10 Name | Inventory Variant: Custom Field 10 Name | Scent | Defines the name of Custom Field 10 | Enabled |
| Scent | Inventory Variant: Custom Field 10 Value | Vanilla | Specifies the product scent | Enabled |
| Custom Field 11 Name | Inventory Variant: Custom Field 11 Name | Size | Defines the name of Custom Field 11 | Enabled |
| Size | Inventory Variant: Custom Field 11 Value | Large | Specifies the product size | Enabled |
| Custom Field 12 Name | Inventory Variant: Custom Field 12 Name | Special Handling | Defines the name of Custom Field 12 | Enabled |
| Special Handling | Inventory Variant: Custom Field 12 Value | Fragile | Specifies special handling instructions | Enabled |
| Custom Field 13 Name | Inventory Variant: Custom Field 13 Name | UOM | Defines the name of Custom Field 13 | Enabled |
| UOM | Inventory Variant: Custom Field 13 Value | Each | Specifies the unit of measure | Enabled |
| Custom Field 14 Name | Inventory Variant: Custom Field 14 Name | Video | Defines the name of Custom Field 14 | Enabled |
| Video | Inventory Variant: Custom Field 14 Value | https://www.sextoydistributing.com/videos/AG472.mp4 | Provides a video link for the product | Enabled |
| Custom Field 2 Name | Inventory Variant: Custom Field 2 Name | Discontinued | Defines the name of Custom Field 2 | Enabled |
| Discontinued | Inventory Variant: Custom Field 2 Value | No | Indicates if the product is discontinued | Enabled |
| Custom Field 3 Name | Inventory Variant: Custom Field 3 Name | Flavor | Defines the name of Custom Field 3 | Enabled |
| Flavor | Inventory Variant: Custom Field 3 Value | Strawberry | Specifies the product flavor | Enabled |
| Custom Field 4 Name | Inventory Variant: Custom Field 4 Name | Location | Defines the name of Custom Field 4 | Enabled |
| Location | Inventory Variant: Custom Field 4 Value | Warehouse A | Specifies the inventory location | Enabled |
| Custom Field 5 Name | Inventory Variant: Custom Field 5 Name | Manufacturer | Defines the name of Custom Field 5 | Enabled |
| Manufacturer | Inventory Variant: Custom Field 5 Value | XR Brands | Specifies the manufacturer | Enabled |
| Custom Field 6 Name | Inventory Variant: Custom Field 6 Name | Master Product ID | Defines the name of Custom Field 6 | Enabled |
| Master Product ID | Inventory Variant: Custom Field 6 Value | AG472 | Links variants to a master product | Enabled |
| Custom Field 7 Name | Inventory Variant: Custom Field 7 Name | Option | Defines the name of Custom Field 7 | Enabled |
| Option | Inventory Variant: Custom Field 7 Value | Large | Specifies variant options (often blank) | Enabled |
| Custom Field 8 Name | Inventory Variant: Custom Field 8 Name | Packaging | Defines the name of Custom Field 8 | Enabled |
| Packaging | Inventory Variant: Custom Field 8 Value | Retail Box | Specifies the packaging type | Enabled |
| Custom Field 9 Name | Inventory Variant: Custom Field 9 Name | Recommended Categories | Defines the name of Custom Field 9 | Enabled |
| Recommended Categories | Inventory Variant: Custom Field 9 Value | Clothing and Lingerie;XR Brands | Provides additional category suggestions | Enabled |
| Description | Inventory Parent: Description | High-quality fetish clothing... | Sets the product description | Enabled |
| Short Description | Inventory Variant: Description | Black fetish clothing, size Large | Sets the variant description | Enabled |
| Dimension Unit | Inventory Variant: Dimension Unit | Not provided | Standardizes dimension unit (not supported) | Enabled |
| MAP | Inventory Variant: MAP | 19.99 | Sets the minimum advertised price | Enabled |
| Model | Inventory Variant: Master SKU | AG472-Large | Sets the master identifier for listings | Enabled |
| Manufacturer Code | Inventory Variant: MPN | STD-AG472 | Sets the manufacturer’s part number | Enabled |
| Suggested Retail | Inventory Variant: MSRP | 24.99 | Sets the suggested retail price | Enabled |
| Model | Inventory Parent: Parent SKU | AG472 | Links variant to parent record | Enabled |
| Model | Inventory Variant: SKU | AG472-Large | Sets the primary product identifier | Enabled |
| Title | Inventory Parent: Title | Fetish Clothing Set | Sets the product title | Enabled |
| Title | Inventory Variant: Title | Fetish Clothing Set - Large | Sets the variant title | Enabled |
| UPC | Inventory Variant: UPC | 012345678905 | Sets the universal product code | Enabled |
| Weight | Inventory Variant: Weight | 0.5 | Sets the product weight | Enabled |
| Weight Unit | Inventory Variant: Weight Unit | lb | Standardizes weight unit (assumed pounds) | Enabled |
Practice Mapping
Try enabling or disabling the “Cost” field:
Here are some essential details about the Sex Toy Distributing integration:
- Current Date and Time: As of 11:04 PM -04 on Tuesday, May 20, 2025, this integration is fully operational for retrieving inventory and pricing data from Sex Toy Distributing.
- Custom Fields: Supports multiple custom fields by default (e.g., Video, Color, Scent, Size), with others optionally mappable (e.g., Flavor, Packaging).
- Variations/Options: Variation support exists but is imperfect. Variants (e.g., AG472-Small, AG472-Large) share a Master Product ID (e.g., AG472), but options like Size may be blank in the feed. To disable variation support, map Model → Parent SKU instead of Master Product ID → Parent SKU, and consider enabling “Copy Variant Images to Product” (see Setup Instructions).
- Images: Multi-image support is available. By default, shared variant images are moved to the parent product. Enable “Copy Variant Images to Product” to copy instead of move.
- Categories: Supports two category fields: Primary Category (hierarchical) and Category (non-hierarchical, suitable for tags).
-
Limitations:
- Inventory updates are cached hourly (adjustable via developer code changes).
- Images are cached daily (adjustable via developer code changes).
- No support for dimensions (only weights in pounds).
- No multiple warehouse support.
Pro Tip: Schedule the Get Inventory sync to run daily to ensure your catalog stays updated, and consider running it more frequently (e.g., every few hours) to capture hourly inventory updates.
If issues arise:
-
Authentication Failure:
- Verify your Sex Toy Distributing login and password.
- Test the connection using the Test Connection button.
-
Failed to Download Product File:
- Check the Product Feed URL to ensure it’s valid. Try accessing it via a browser (e.g.,
http://www.sextoydistributing.com/feeds/invsource/p@ssw0rd/xrproducts4.xml) to see if it downloads. - Compare the file against a generic URL for differences:
http://www.sextoydistributing.com/feeds/invsource/p@ssw0rd/xrproducts4.xml.
- Check the Product Feed URL to ensure it’s valid. Try accessing it via a browser (e.g.,
-
Failed to Download Generic Files:
- Verify access to the Image File (
https://www.sextoydistributing.com/feeds/LOGIN/PASSWORD/XML_ALL_IMAGES.xml) and Inventory File (https://feeds.xrllcsystems.com/inventory.csv). - Check logs using the "View Logs" option to identify specific errors.
- Verify access to the Image File (
-
Variation Mapping Issues: If variants are not mapping correctly (e.g., missing Size options):
- In the mapping template, change Master Product ID → Parent SKU to Model → Parent SKU to treat each variant as a unique parent/product.
- Disable “Direct Copy Options” in the integration settings if options are incomplete.
- Enable “Copy Variant Images to Product” to ensure images are copied to the parent product.
-
Image Mapping Issues: If images are not appearing as expected:
- Check the “Copy Variant Images to Product” setting. If disabled, shared images are moved to the parent; if enabled, they are copied.
- Verify that the Image File has been downloaded and cached correctly.
-
Sync Failure:
- Review logs using the "View Logs" option to identify errors.
- Contact Flxpoint support if needed.
Diagnostic Tip: The "View Logs" option provides detailed information about each step of the process. Check these logs first to identify where the process might be failing.
Conclusion
With this integration set up, your system will sync product details, stock levels, and pricing from Sex Toy Distributing, keeping your catalog accurate and up-to-date.
Order Operations
It submits orders to vendors for fulfillment and subsequently imports the shipment details, ensuring an integration between order processing and shipment tracking.
Send Orders
Supported | Sex Toy Distributing - Send Orders
Introduction to Sex Toy Distributing - Send Orders Integration
This guide helps you set up the Sex Toy Distributing - Send Orders integration (also referred to as XR Direct). It automates sending purchase orders to Sex Toy Distributing, ensuring efficient order fulfillment. Let’s get started!
This integration sends purchase orders to Sex Toy Distributing via their API, ensuring they can process and ship your orders:
- Automates submission of order details like SKUs, quantities, and shipping addresses.
- Uses Sex Toy Distributing’s API for secure communication.
The integration follows these steps to send fulfillment requests:
- Initiation: Receives a list of purchase orders ready to send to Sex Toy Distributing.
- Authentication: Authenticates using the same ordering credentials (e.g., login and password) used in the Get Inventory integration.
-
Connection Test: Tests the API connection to an endpoint like
https://api.sextoydistributing.com/orders. If it fails, the process halts. - Order Processing: Maps order data (e.g., SKUs, quantities, shipping address, shipping method) into Sex Toy Distributing’s required format, submits via HTTP POST to the API, and processes responses.
- Response Handling: Updates successful orders with a confirmation number (e.g., XR Direct order ID) or logs errors for failed ones.
- Syncing: Updates order statuses in your system (e.g., "Sent"). Run manually with Run Sync or schedule via "Adjust Schedule."
Important Note: You’ll need the same login and password used in the Get Inventory integration to authenticate requests. Contact your Sex Toy Distributing support team if you don’t have these credentials.
You can customize the integration with these settings:
- Enable/Disable Fields: Choose which fields to send in the mapping template (e.g., enable/disable "Zip Code").
- Hold for X Hours: Set a delay (e.g., 24 hours) to review orders before sending.
- Send During Business Hours: Enable to send requests only during business hours.
- Scheduling: Run manually or schedule (e.g., daily at 8 AM UTC) using "Adjust Schedule."
Follow these steps to configure the integration:
- 1 Access the Integration: Go to the Sex Toy Distributing source and select "Send Orders."
-
2 Configure API Connection: Enter:
- Login: Your Sex Toy Distributing login (e.g., invsource).
- Password: Your Sex Toy Distributing password (e.g., p@ssw0rd).
- 3 Configure Shipping Details: Set up the Shipping Method mapping (see Configuring Shipping for XR Direct section).
-
4 Configure Settings: Adjust:
- Hold for X Hours: Set a delay if needed (e.g., 24 hours).
- Send During Business Hours: Enable if desired.
- 5 Create a Mapping Template: Use the "Manage Mapping" option to define which fields to send (see Mapping Templates section).
- 6 Run the Integration: Start manually with Run Sync or schedule via "Adjust Schedule."
XR Direct (Sex Toy Distributing) requires a valid shipping method for all orders. Below are the accepted shipping codes and instructions for mapping them in Flxpoint.
Accepted Shipping Codes for XR Direct
Important Note: "Best/Cheapest Way" is not a valid shipping method for XR Direct. Please use one of the following approved methods:
| Shipping Method Code | Description |
|---|---|
| UPS GROUND | UPS Ground Shipping |
| UPS 2 DAY AIR | UPS 2 Day Air Shipping |
| UPS NEXT DAY AIR | UPS Next Day Air Shipping |
| FEDEX GROUND | FedEx Ground Shipping |
| FEDEX PRIORITY | FedEx Priority Overnight Shipping |
| FEDEX 2 DAY | FedEx 2 Day Shipping |
| USPS PRIORITY | USPS Priority Mail |
| USPS FIRST CLASS | USPS First Class Mail |
Mapping Instructions
- Shipping Method: In Flxpoint, map the “Source Shipping Method: Shipping Code” or “Source Shipping Method: Method” field to the “Shipping Method” field under “XR Direct Purchase Order” in the mapping template. Set the value to one of the accepted Shipping Method Codes listed above (e.g., “UPS GROUND”, “FEDEX PRIORITY”).
- Validation: Ensure the shipping method is populated with a valid code before submission. XR Direct’s API will reject orders with invalid or unsupported shipping methods, resulting in a 501 Not Implemented error.
Resolving “501 Not Implemented” Error
-
Issue Overview: The “501 Not Implemented” error occurs when an invalid shipping method is used in the order submission to XR Direct. This includes unsupported methods like “Best/Cheapest Way” or any method not in the accepted list above. It can also occur due to:
- Incorrect Mapping: The Shipping Method field is not correctly mapped or is sending a null/unsupported value.
- Formatting Issues: Extra spaces, incorrect capitalization, or typos (e.g., “ups ground” instead of “UPS GROUND”).
-
Resolution Steps:
- Verify that the “Shipping Method” field in your mapping template is enabled and mapped to “Source Shipping Method: Shipping Code” or “Source Shipping Method: Method.”
- Ensure the value matches one of the accepted Shipping Method Codes listed above exactly (e.g., “UPS GROUND”).
- Check for formatting issues in your data (e.g., remove extra spaces, correct capitalization).
- Review the API response in the "View Logs" section to confirm what shipping method was sent to XR Direct.
- If the issue persists, contact Flxpoint support with the Order ID and Fulfillment Request Number (FR #) for assistance.
Tip: Always double-check your Shipping Method value against XR Direct’s accepted codes before running the sync to avoid the 501 Not Implemented error.
A mapping template controls how order data is sent to Sex Toy Distributing. You can only enable or disable fields.
Interface Overview
- The mapping screen is labeled “Flxpoint → Sex Toy Distributing” under “Send Orders.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (your system’s fields), Right (Sex Toy Distributing fields).
Mapping Options
- Enable: Send the field (e.g., enable “SKU”).
- Disable: Ignore the field (e.g., disable “Zip Code”).
- Required fields like “SKU” and “Shipping Method” cannot be disabled.
Available Source Fields
- XR Direct Purchase Order: Fulfillment Request Number, Order Date, Note, Ship To Email Address, Ship To Phone Number, Shipping Method.
- XR Direct Purchase Order Address: Address Line 1, Address Line 2, City, State, Postal Code (Zip Code), Country, Full Name.
- XR Direct Purchase Order Item: SKU, Quantity, Cost.
Complete Field Mappings
| Flxpoint Field | Maps To (Sex Toy Distributing Field) | Example | Purpose | Status |
|---|---|---|---|---|
| Fulfillment Request Number | XR Direct Purchase Order: Order ID | FR-12345 | Identifies the purchase order | Enabled |
| Generated At | XR Direct Purchase Order: Order Date | 2025-05-20 | Specifies the order date | Enabled |
| Note | XR Direct Purchase Order: Order Notes | Please ship ASAP | Adds notes to the order | Enabled |
| XR Direct Purchase Order: Ship To Email Address | customer@example.com | Provides the shipping email address | Enabled | |
| Phone | XR Direct Purchase Order: Ship To Phone Number | 123-456-7890 | Provides the shipping phone number | Enabled |
| Shipping Code | XR Direct Purchase Order: Shipping Method | UPS GROUND | Specifies the shipping method (required) | Enabled |
| Address Line 1 | XR Direct Purchase Order Address: Address Line 1 | 123 Main St | Primary shipping address (≤ 30 characters) | Enabled |
| Address Line 2 | XR Direct Purchase Order Address: Address Line 2 | Apt 4B | Secondary shipping address | Enabled |
| City | XR Direct Purchase Order Address: City | New York | Part of the shipping address | Enabled |
| State | XR Direct Purchase Order Address: State | NY | Ensures the correct state for shipping | Enabled |
| Postal Code | XR Direct Purchase Order Address: Zip Code | 12345-6789 | Ensures accurate delivery (≤ 10 characters) | Enabled |
| Country | XR Direct Purchase Order Address: Country | US | Specifies the country for shipping | Enabled |
| Full Name | XR Direct Purchase Order Address: Full Name | John Doe | Specifies the recipient’s name | Enabled |
| SKU | XR Direct Purchase Order Item: SKU | AG472-Large | Identifies the product for Sex Toy Distributing | Enabled |
| Quantity | XR Direct Purchase Order Item: Quantity | 10 | Specifies how many units to ship | Enabled |
| Cost | XR Direct Purchase Order Item: Cost | 15.99 | Specifies the cost per unit | Enabled |
Practice Mapping
Try enabling or disabling the “Zip Code” field:
If issues arise:
-
Authentication Failure:
- Verify your Sex Toy Distributing login and password.
- Test the connection using the Test Connection button.
-
Missing or Incorrect Data:
- Ensure required fields like “SKU” and “Shipping Method” are enabled.
- Check address fields (e.g., Address Line 1 ≤ 30 characters, Zip Code ≤ 10 characters).
- Shipping Method Errors (501 Not Implemented): See the “Configuring Shipping for XR Direct” section for details on resolving the “501 Not Implemented” error caused by invalid shipping methods.
-
Sync or Order Failure:
- Review errors in logs using the "View Logs" option to identify specific issues, such as API rejection messages or validation errors.
- Contact Flxpoint support if problems persist, providing the Order ID and Fulfillment Request Number (FR #) for investigation.
Diagnostic Tip: The "View Logs" option provides detailed information about each step of the process, including API responses and error messages. Check these logs first to troubleshoot issues like failed orders or connection problems.
Conclusion
With this integration set up, your orders will be sent to Sex Toy Distributing seamlessly, ensuring efficient fulfillment.
Get Shipments
Supported | Sex Toy Distributing - Get Shipments
Introduction to Sex Toy Distributing - Get Shipments Integration
This guide helps you set up the Sex Toy Distributing - Get Shipments integration (also referred to as XR Direct). It retrieves shipment data like tracking numbers and carrier details, keeping your system updated. Let’s get started!
This integration fetches shipment data from Sex Toy Distributing:
- Retrieves details like tracking numbers, carrier codes, and shipment dates.
- Identifies carriers and methods based on tracking numbers.
The integration follows these steps to retrieve shipment data:
- Initiation: Connects to Sex Toy Distributing’s API using the same credentials (e.g., login and password) used for the Send Orders and Get Inventory integrations.
-
Connection Test: Tests the API connection to an endpoint like
https://api.sextoydistributing.com/shipments. If it fails, the process halts. -
Retrieve Shipments: Queries Sex Toy Distributing’s API for shipment data associated with orders, using the order ID (e.g., XR Direct order ID) received during the Send Orders process (e.g., via
https://api.sextoydistributing.com/shipments?orderId=XR-12345). - Parse Data: Extracts details like Carrier Code, Tracking Number, and Date Shipped.
- Carrier and Method Identification: Identifies carriers and methods based on tracking numbers and carrier codes, matching them against known XR Direct shipping methods (e.g., “UPS GROUND”).
- Map Data: Maps data to your system’s fields (e.g., Carrier, Tracking Number).
- Syncing: Saves the data to your system. Run manually with Run Sync or schedule via "Adjust Schedule."
-
Shipment Status Handling:
- Shipped Status: When Sex Toy Distributing marks an order as "shipped," this integration retrieves the associated shipment data (e.g., tracking number, carrier, shipment date) and updates your Flxpoint system to reflect the "Shipped" status.
- Update Behavior: The "shipped" status triggers the synchronization of tracking information to your system, enabling you to notify customers with accurate delivery details.
- Subsequent Statuses to Watch For: After "shipped," monitor for statuses like "Delivered" (indicating the package has reached the customer) or "In Transit" (indicating the package is en route). These may appear in subsequent API responses and will update in Flxpoint if mapped and enabled in the template.
Important Note: You’ll need the same login and password used in the Send Orders and Get Inventory integrations to authenticate requests. Contact your Sex Toy Distributing support team if you don’t have these.
You can customize the integration with these settings:
- Enable/Disable Fields: Choose which fields to import in the mapping template (e.g., enable/disable "Method").
- Scheduling: Run manually or schedule (e.g., daily at 8 AM UTC) using "Adjust Schedule."
Note: No additional settings are required beyond the API credentials, making setup straightforward.
Follow these steps to configure the integration:
- 1 Access the Integration: Go to the Sex Toy Distributing source and select "Get Shipments."
-
2 Configure API Connection: Enter:
- Login: Your Sex Toy Distributing login (e.g., invsource).
- Password: Your Sex Toy Distributing password (e.g., p@ssw0rd).
- 3 Create a Mapping Template: Use the "Manage Mapping" option to define which fields to import (see Mapping Templates section).
- 4 Run the Integration: Start manually with Run Sync or schedule via "Adjust Schedule."
A mapping template controls how shipment data is imported. You can only enable or disable fields.
Interface Overview
- The mapping screen is labeled “Sex Toy Distributing → Flxpoint” under “Get Shipments.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Sex Toy Distributing fields), Right (your system’s fields).
Mapping Options
- Enable: Import the field (e.g., enable “Tracking Number”).
- Disable: Ignore the field (e.g., disable “Method”).
- Required fields like “Tracking Number” cannot be disabled.
Available Source Fields
- XR Direct Shipment: Order ID, Carrier Code, Service Code, Tracking Number, Date Shipped.
Complete Field Mappings
| Sex Toy Distributing Field | Maps To | Example | Purpose | Status |
|---|---|---|---|---|
| Order ID | Shipment: Order ID | XR-12345 | Links shipment to the original order | Required |
| Carrier Code | Shipment: Carrier | UPS | Identifies the carrier for tracking | Enabled |
| Service Code | Shipment: Method | UPS GROUND | Specifies the shipping method | Enabled |
| Tracking Number | Shipment: Tracking Number | 1Z12345YW67890 | Provides tracking for customers | Required |
| Date Shipped | Shipment: Shipped At | 2025-05-21 | Updates shipment date | Enabled |
Practice Mapping
Try enabling or disabling the “Method” field:
Here are some essential details about the Sex Toy Distributing Get Shipments integration:
- Current Date and Time: As of 11:10 PM -04 on Tuesday, May 20, 2025, this integration is fully operational for retrieving shipment data from Sex Toy Distributing.
- API Dependency: The integration relies on the order ID (e.g., XR Direct order ID) received during the Send Orders process to query shipment data.
-
Supported Features:
- Retrieval of carrier codes, tracking numbers, and shipment dates.
- Carrier and method identification based on XR Direct’s shipping method values (e.g., “UPS GROUND”).
- Status updates for orders (e.g., Shipped, In Transit, Delivered).
Pro Tip: Schedule the Get Shipments integration to run frequently (e.g., every few hours) to ensure tracking information is updated promptly for customer notifications.
If issues arise:
-
Authentication Failure:
- Verify your Sex Toy Distributing login and password.
- Test the connection using the Test Connection button.
-
Missing Shipment Data:
- Ensure required fields like “Tracking Number” are enabled.
- Verify that the order ID matches an order in Sex Toy Distributing’s system (check the order ID received during Send Orders).
- Check if Sex Toy Distributing’s API is returning data by reviewing logs using "View Logs."
-
Incorrect Carrier or Method:
- Verify that Carrier Code and Service Code mappings are enabled and correctly configured.
- Confirm that Sex Toy Distributing’s tracking number format is compatible with your system’s carrier identification logic.
-
Sync Failure:
- Review logs using the "View Logs" option to identify specific errors, such as API rate limits or authentication failures.
- Contact Flxpoint support if problems persist, providing the order ID (XR Direct order ID) for investigation.
Diagnostic Tip: The "View Logs" option provides detailed information about API responses and parsing errors. Check these logs first to troubleshoot missing or incorrect shipment data.
Conclusion
With this integration set up, your system will sync shipment data from Sex Toy Distributing, keeping your tracking information accurate and ensuring your customers are informed.