Mirage Pet Products as Source

Mirage Pet Products is a wholesale supplier of pet accessories, including collars, harnesses, apparel, toys, and grooming supplies. With a focus on high-quality, USA-made products, they cater to pet stores, boutiques, and online retailers looking for stylish and durable pet items.

 

How to Connect

Step 1: In Flxpoint, go to Connections → Fulfillment Sources, click + Add Source, name it “Mirage Pet Products,” and hit Save & Get Started.
Step 2: Select “Mirage Pet Products” and click Continue. Enter the Customer Email for order notifications, then click Save.
Step 3: Choose your Master SKU mapping: Inventory SKU → Master SKU → Listing SKU. (Optionally set a SKU prefix.) Click Continue.
Step 4: Toggle on the workflows you need—Get Inventory, Send Orders & Get Shipments—then click Save.
Step 5: 🎉 That’s it! You’ll see a “Supplier Was Connected!” confirmation—click Close and you’re ready to go.

 

 

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 and Pricing & Quantity

Supported | Mirage Pet Products - Get Inventory and Pricing & Quantity

Introduction to Mirage Pet Products Get Inventory and Pricing & Quantity Integration
This guide helps you set up the Mirage Pet Products integration on Flxpoint to sync product data, stock levels, and pricing. It ensures your catalog stays accurate and up to date. Let’s get started.

This integration syncs data from Mirage Pet Products:
  • Get Inventory: Imports product details like titles, descriptions, and SKUs.
  • Pricing & Quantity: Updates stock quantities and pricing, such as cost and MSRP.
It helps prevent overselling and ensures pricing accuracy.

This integration connects to Mirage Pet Products via Shopify to retrieve product data, stock levels, and pricing. It has two main parts:
  • Get Inventory: Retrieves product details like titles, descriptions, categories, and SKUs. Attributes are sourced from product tags.
  • Pricing & Quantity: Updates stock quantities and pricing, such as wholesale price and MSRP (calculated as 1.4 times the wholesale price).
  • Syncing: Data syncs to your system manually or on a schedule (e.g., daily at 8 AM UTC). Use the "Run Sync" option to start the sync.
Note: If the connection to Mirage Pet Products fails, the sync will not complete.

Customize the integration with these settings:
  • Enable/Disable Fields: Choose which fields to sync in the mapping template (e.g., enable/disable "Cost").
  • Automatically Pricing & Quantity: Enable to auto-update pricing and stock data.
  • Allow Create Variant: Enable to allow creating variants during inventory sync (default: disabled).
  • Scheduling: Run manually or schedule syncs (e.g., daily at 8 AM UTC) using the "Adjust Schedule" option.
  • Master SKU: Set SKU linking (Inventory SKU → Master SKU → Listing SKU) and optionally add a prefix (e.g., "MPP-").

Follow these steps to configure the integration:
  • 1 Access the Integration: Go to the Mirage Pet Products source and select "Get Inventory" and "Get Pricing & Quantity."
  • 2 Check Connection: Ensure the Mirage Pet Products connection is active (status: "Active"). No authentication is required.
  • 3 Enable Auto-Updates: Under "Pricing & Quantity," toggle on "Automatically Pricing & Quantity" to fetch updates.
  • 4 Configure Master SKU (Optional): Under "Master SKU," set the SKU linking:
    • Inventory SKU → Master SKU → Listing SKU
    Optionally, add an SKU prefix (e.g., "MPP-") to identify Mirage Pet Products items.
  • 5 Set Up Mapping: Use the "Manage Mapping" option to choose which fields to sync (details below).
  • 6 Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."

Pricing comes from Mirage Pet Products data:
  • Wholesale Price: Uses the Shopify variant price (e.g., $10).
  • MSRP: Calculated as 1.4 times the wholesale price (e.g., $14 for a $10 wholesale price).

Stock quantities are pulled from Mirage Pet Products (e.g., 50 units for SKU "MPP123").

This section provides key details about the Mirage Pet Products integration to help you understand how it works and what to expect:
  • Shopify Integration: This integration connects to Mirage Pet Products via Shopify. Product data is fetched using a GraphQL API endpoint, and inventory levels are retrieved using a separate REST API endpoint. Connection settings are hardcoded and not configurable through the UI, ensuring a seamless setup without manual adjustments.
  • Location-Specific Inventory: Inventory levels are fetched for a specific location with the Location ID 72937505057. Only products with a quantity greater than 0 at this location are synced, ensuring accurate stock availability in your catalog.
  • Pricing Rules: Pricing is set as follows:
    • Wholesale Price: Matches the Shopify variant price (e.g., $10).
    • MSRP: Calculated as 1.4 times the wholesale price (e.g., $14 for a $10 wholesale price).
  • Category Mappings: Categories are derived from the Shopify product type:
    • Category 1: Takes the first part of the product type (before the colon, if present). If the product type is empty, defaults to "General."
    • Category 2: Takes the second part of the product type (after the colon, if present). If there's no colon or the product type is empty, defaults to "General."
  • Description Fallback: If the Shopify product’s body HTML is empty, the product title is used as the description to ensure your listings always have a description.
  • Attributes Source: Product attributes (e.g., color, material) are pulled from the Shopify tags field, providing additional details for your catalog.
Tip: Understanding these settings helps you manage your inventory more effectively and ensures your product listings are accurate and consistent.

Mapping Template Overview
The mapping template lets you control which data to import. Enable fields to include them or disable to skip them. Required fields like "SKU" and "Master SKU" cannot be disabled.

  • The mapping screen is labeled “Mirage Pet Products → Flxpoint” with sections for “Get Inventory” and “Get Pricing & Quantity.”
  • Buttons: Cancel and Save Mapping.

Mapping Fields
Below are the fields you can map, with examples and purposes:
Get Inventory Mappings
Field Maps To Example Purpose Status
SKU Inventory Variant: SKU MPP123 Unique identifier for each product variant Required
Master SKU Inventory Variant: Master SKU MPP123-MASTER Links inventory to listings Required
Parent SKU Inventory Parent: Parent SKU MPP123-PARENT Links variants to their parent product Required
Title Inventory Parent: Title Pet Collar Identifies the product in your catalog Optional
Description Inventory Parent: Description A durable pet collar for all breeds Provides product details (uses title if empty) Optional
Vendor Inventory Parent: Brand Mirage Pet Products Categorizes by brand Optional
Product Type Inventory Parent: Category 1 Collar (or "General" if empty) Organizes by primary category Optional
Tags Inventory Parent: Category 2 Pet, Durable (or "General" if empty) Adds secondary categorization Optional
All Attributes Inventory Parent: All Attributes Color: Blue, Material: Nylon Imports all product attributes Optional
Images Inventory Parent: All Images (Product image URLs) Enhances listings with images Optional
Weight Inventory Variant: Weight 0.5 Used for shipping calculations Optional
Weight Unit Inventory Variant: Weight Unit pound Standardizes weight unit Optional

Pricing & Quantity Mappings
Field Maps To Example Purpose Status
Quantity Inventory Variant: Quantity 50 Updates stock quantity Optional
Cost Inventory Variant: Cost 10 Sets the base cost Optional
MSRP Inventory Variant: MSRP 14 Sets suggested retail price Optional
Barcode Inventory Variant: UPC 123456789012 Verifies product identity Optional

Try enabling or disabling the “Cost” field:

If issues arise:
  • Confirm the connection is active (status: "Active").
  • Ensure required fields like “SKU” and “Master SKU” are enabled.
  • Check logs using the "View Logs" option if the sync fails.
  • Contact Flxpoint support if needed.

Conclusion
With this integration, your system will sync product details, stock, and pricing from Mirage Pet Products, keeping your catalog accurate and current.
 
 

 

 

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 Order

Supported | Mirage Pet Products - Send Orders

Introduction to Mirage Pet Products Send Orders Integration
This guide walks you through setting up the Mirage Pet Products Send Orders integration on Flxpoint. It enables you to send order details to Mirage Pet Products, ensuring seamless order fulfillment. Let’s get started.

This integration allows you to:
  • Send Orders: Transmit order details, including shipping information, variant IDs, and quantities, to Mirage Pet Products for fulfillment.
It ensures orders are processed efficiently and tracked accurately.

This integration connects to Mirage Pet Products via Shopify to send order data. Here’s how it operates:
  • Order Transmission: Orders are sent using a POST request to a Shopify API endpoint. The request includes shipping details, variant ID, and quantity.
  • Order Tracking: The Shopify order ID returned from the API is saved against the processed Fulfillment Request (FR) in Flxpoint for tracking purposes.
Note: If the connection to Mirage Pet Products fails, orders will not be sent, and you’ll need to troubleshoot the connection.

This integration uses predefined settings:
  • Draft Orders: Set to "no" (orders are not created as drafts).
  • Create Customer: Configured to use the "account_owner_address" for customer creation.
  • Scheduling: Orders can be sent manually or scheduled (e.g., every hour) using the "Adjust Schedule" option in Flxpoint.

Follow these steps to configure the Send Orders integration:
  • 1 Access the Integration: Navigate to the Mirage Pet Products source in Flxpoint and select "Send Orders."
  • 2 Verify Connection: Ensure the Mirage Pet Products connection is active (status: "Active"). No manual authentication is required as settings are hardcoded.
  • 3 Configure Scheduling (Optional): Set up a schedule for sending orders (e.g., hourly) using the "Adjust Schedule" option, or send orders manually with the "Send Orders" action.
  • 4 Monitor Order Submission: After sending orders, check the processed Fulfillment Requests in Flxpoint to confirm the Shopify order ID has been saved for tracking.

This section provides key details about the Send Orders integration to help you understand the process:
  • Shopify Integration: This integration connects to Mirage Pet Products via Shopify. Orders are sent using a POST request to the Shopify API endpoint /admin/api/version/orders.json. Connection settings are hardcoded and not configurable through the UI, ensuring a streamlined setup.
  • Request Details: The order request body includes:
    • Shipping Details: Customer shipping address for delivery.
    • Variant ID: Identifies the specific product variant being ordered.
    • Quantity: Specifies the number of units ordered.
  • Location-Specific Orders: Orders are processed for the location with the Location ID 72937505057, ensuring inventory is managed correctly at this location.
  • Hardcoded Configurations: The integration uses the following predefined settings:
    • Draft Orders: Set to "no," meaning orders are created directly, not as drafts.
    • Create Customer: Uses the "account_owner_address" to associate orders with the account owner’s address for customer creation.
  • Order Tracking: After an order is sent, the Shopify order ID is saved against the processed Fulfillment Request (FR) in Flxpoint, allowing you to track the order status.
Tip: Regularly check the status of processed Fulfillment Requests to ensure orders are being sent and tracked successfully.

Mapping Fields
Below are the fields used to send orders to Mirage Pet Products, with examples and purposes:
Send Orders Mappings
Field Maps To Example Purpose Status
Shipping Details Shopify Order: Shipping Address 123 Main St, City, Country Specifies the customer’s shipping address for delivery Required
Variant ID Shopify Order: Line Item Variant ID 789456123 Identifies the specific product variant being ordered Required
Quantity Shopify Order: Line Item Quantity 5 Specifies the number of units ordered for the variant Required

If issues arise when sending orders:
  • Confirm the Mirage Pet Products connection is active (status: "Active").
  • Check the order details (shipping details, variant ID, quantity) for accuracy before sending.
  • Review logs using the "View Logs" option in Flxpoint if orders fail to send.
  • Contact Flxpoint support if you encounter persistent issues.

Conclusion
With the Send Orders integration set up, you can efficiently transmit orders to Mirage Pet Products, ensuring smooth fulfillment and accurate tracking within Flxpoint.
 
 

Get Shipments

Supported | Mirage Pet Products - Get Shipments

Introduction to Mirage Pet Products Get Shipments Integration
This guide walks you through setting up the Mirage Pet Products Get Shipments integration on Flxpoint. It allows you to retrieve shipment details for orders fulfilled by Mirage Pet Products, ensuring you can track and manage deliveries effectively. Let’s get started.

This integration enables you to:
  • Get Shipments: Retrieve shipment details, such as tracking numbers, shipment status, and shipment dates, for orders fulfilled by Mirage Pet Products.
It ensures you have up-to-date information on order deliveries for better customer service.

This integration connects to Mirage Pet Products via Shopify to retrieve shipment data. Here’s how it operates:
  • Shipment Retrieval: Shipment details are fetched using a GET request to a Shopify API endpoint. The response includes tracking numbers, shipment status, and shipment dates.
  • Data Storage: Retrieved shipment details are saved in Flxpoint, linked to the corresponding Fulfillment Request (FR) for easy tracking and reference.
Note: If the connection to Mirage Pet Products fails, shipment details will not be retrieved, and you’ll need to troubleshoot the connection.

This integration uses predefined settings:
  • Draft Orders: Set to "no" (orders are not treated as drafts).
  • Create Customer: Configured to use the "account_owner_address" for customer association.
  • Scheduling: Shipment retrieval can be performed manually or scheduled (e.g., daily at 8 AM UTC) using the "Adjust Schedule" option in Flxpoint.

Follow these steps to configure the Get Shipments integration:
  • 1 Access the Integration: Navigate to the Mirage Pet Products source in Flxpoint and select "Get Shipments."
  • 2 Verify Connection: Ensure the Mirage Pet Products connection is active (status: "Active"). No manual authentication is required as settings are hardcoded.
  • 3 Configure Scheduling (Optional): Set up a schedule for retrieving shipments (e.g., daily at 8 AM UTC) using the "Adjust Schedule" option, or retrieve shipments manually with the "Run Sync" action.
  • 4 Monitor Shipment Data: After retrieval, check the Fulfillment Requests in Flxpoint to confirm shipment details (e.g., tracking numbers) have been saved.

This section provides key details about the Get Shipments integration to help you understand the process:
  • Shopify Integration: This integration connects to Mirage Pet Products via Shopify. Shipment details are retrieved using a GET request to the Shopify API endpoint /admin/api/version/orders/{order_id}/fulfillments.json. Connection settings are hardcoded and not configurable through the UI, ensuring a seamless setup.
  • Shipment Details: The integration fetches:
    • Tracking Number: The tracking number assigned to the shipment.
    • Shipment Status: The current status of the shipment (e.g., "shipped").
    • Shipment Date: The date the shipment was sent.
  • Location-Specific Data: Shipment details are associated with the location with the Location ID 72937505057, ensuring accuracy for inventory at this location.
  • Hardcoded Configurations: The integration uses the following predefined settings:
    • Draft Orders: Set to "no," meaning orders are not treated as drafts during shipment retrieval.
    • Create Customer: Uses the "account_owner_address" to associate shipments with the account owner’s address for customer records.
  • Shipment Tracking: Retrieved shipment details are saved in Flxpoint and linked to the processed Fulfillment Request (FR), allowing you to monitor delivery status.
Tip: Regularly check the shipment details in Flxpoint to provide accurate delivery updates to your customers.

Mapping Fields
Below are the fields retrieved from Mirage Pet Products for shipments, with examples and purposes:
Get Shipments Mappings
Field Maps To Example Purpose Status
Tracking Number Flxpoint FR: Tracking Number 1Z9999W99999999999 Provides the tracking number for the shipment Optional
Shipment Status Flxpoint FR: Shipment Status Shipped Indicates the current status of the shipment Optional
Shipment Date Flxpoint FR: Shipment Date 2025-05-07 Specifies the date the shipment was sent Optional

If issues arise when retrieving shipments:
  • Confirm the Mirage Pet Products connection is active (status: "Active").
  • Verify that the order IDs linked to the Fulfillment Requests are correct and exist in Shopify.
  • Review logs using the "View Logs" option in Flxpoint if shipment retrieval fails.
  • Contact Flxpoint support if you encounter persistent issues.

Conclusion
With the Get Shipments integration set up, you can retrieve and track shipment details from Mirage Pet Products, ensuring you have the latest delivery information for your orders.