Mirage Pet Products as Source

Mirage Pet Products is a wholesaler of pet apparel, accessories, and supplies. Flxpoint enables inventory and order automation.

 

How to Connect

Step 1: Go to Sources and click + Add Source. Name it “Mirage Pet Products” and click Save & Continue.
Step 2: In the setup wizard:
No credentials required.
Enable Get Inventory, Send Fulfillment Requests & Get Shipments.
Click Next.
Step 3: Enter the Customer Email for notifications, then click Save Connection.
Step 4: Under Master SKU, map Inventory SKU → Master SKU → Listing SKU, then click Save & Continue.
Step 5: Review settings and click Finish. You’ll see “Supplier Was Connected!”—click Close to start syncing.

 

 

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 (Primary)

Supported | Mirage Pet Products - Get Inventory [Primary]

Introduction to Mirage Pet Products Get Inventory [Primary] Integration
This guide helps you set up the Mirage Pet Products Get Inventory [Primary] integration to sync product data and stock levels. 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, categories, and SKUs.
It helps maintain an accurate inventory catalog for your business.

This integration connects to Mirage Pet Products via Shopify to retrieve product data and stock levels. It has the following steps:
  • Product Fetch: Retrieves a list of products with quantity greater than 0 using a GraphQL API endpoint (`https://mirage-pet-products.com/admin/api/2024-07/graphql.json`).
  • Inventory Levels: Fetches inventory levels for Location ID 72937505057 using the REST API endpoint (`/admin/api/2023-10/inventory_levels.json?location_ids=72937505057`).
  • Data Storage: Saves the quantity and other product details in the Global Inventory Platform (GIP).
  • Attributes: Pulls product attributes like color and material from the Shopify tags field.
  • 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 "Brand").
  • 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 [Primary]."
  • 2 Check Connection: Ensure the Mirage Pet Products connection is active (status: "Active"). No authentication is required as settings are hardcoded.
  • 3 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.
  • 4 Set Up Mapping: Use the "Manage Mapping" option to choose which fields to sync (details below).
  • 5 Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."

  • The mapping screen is labeled "Mirage Pet Products - Get Inventory [Primary]" with sections for field mappings.
  • Buttons: Delete, Duplicate, and Save.

This section provides key details about the Get Inventory [Primary] integration to help you understand how it works:
  • Shopify Integration: Connects to Mirage Pet Products via Shopify. Products are fetched using a GraphQL API endpoint (`https://mirage-pet-products.com/admin/api/2024-07/graphql.json`), and inventory levels are retrieved using a REST API endpoint (`/admin/api/2023-10/inventory_levels.json?location_ids=72937505057`). Settings are hardcoded for simplicity.
  • Location-Specific Inventory: Inventory levels are fetched for Location ID 72937505057, ensuring only products with quantity greater than 0 at this location are synced.
  • Pricing Rules:
    • Wholesale Price: Set as 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:
    • Category 1: Extracts the first part of the Shopify product type (before the colon, if present). Defaults to "General" if empty.
    • Category 2: Extracts the second part of the Shopify product type (after the colon, if present). Defaults to "General" if empty or no colon.
  • Description Fallback: If the Shopify body HTML is empty, the product title is used as the description.
  • Attributes Source: Product attributes (e.g., color, material) are pulled from the Shopify tags field.
Tip: Review the mapping template to ensure the fields align with your catalog requirements.

Mapping Fields
Below are the fields you can map, with examples and purposes:
Get Inventory [Primary] Mappings
Field Maps To Example Purpose Status
Parent SKU Inventory Parent: Parent SKU MPP123-PARENT Links variants to their parent product (from Shopify Product Handle) Required
All Attributes Inventory Parent: All Attributes Color: Blue, Material: Nylon Imports all product attributes from Shopify tags Optional
All Custom Fields Inventory Parent: All Custom Fields CustomField1: Value1 Imports custom fields defined for the product Optional
All Images Inventory Parent: All Images (Product image URLs) Enhances listings with images Optional
All Options Inventory Parent: All Options Size: Small, Color: Blue Imports all variant options (e.g., size, color) Optional
Brand Inventory Parent: Brand Mirage Pet Products Categorizes by brand (from Shopify Vendor) Optional
Category 1 Inventory Parent: Category 1 Collar (or "General" if empty) Organizes by primary category (from Shopify Product Type) Optional
Category 2 Inventory Parent: Category 2 Pet, Durable (or "General" if empty) Adds secondary categorization (from Shopify Product Type) Optional
Description Inventory Parent: Description A durable pet collar for all breeds Provides product details (uses title if Shopify Body HTML is empty) Optional
Title Inventory Parent: Title Pet Collar Identifies the product in your catalog (from Shopify Variant Title) Optional
UPC Inventory Variant: UPC 123456789012 Verifies product identity (from Shopify Variant Barcode) Optional
Reference Identifier Inventory Variant: Reference Identifier MPN123 Matches source variants to virtual variants (similar to UPC or MPN) Optional
Shipping Cost Inventory Variant: Shipping Cost 5.00 Specifies the shipping cost for the variant Optional
Source List Price Inventory Variant: Source List Price 20.00 Sets the original list price from the source Optional
Weight Inventory Variant: Weight 0.5 Used for shipping calculations (from Shopify Variant Weight) Optional
Weight Unit Inventory Variant: Weight Unit pound Standardizes weight unit (options: pound, ounce, gram, kilogram; prioritized over abbreviated unit) Optional
Weight Unit (Abbreviated) Inventory Variant: Weight Unit (Abbreviated) lb Alternative abbreviated weight unit (used if Weight Unit is not set) Optional
Width Inventory Variant: Width 10 Specifies the width of the product for shipping calculations Optional
Custom Fields (100) Inventory Parent: Custom Fields Field1: Value1 Allows mapping of up to 100 custom fields for additional product data Optional
Custom Aggregate Fields (10) Inventory Parent: Custom Aggregate Fields AggregateField1: CombinedValue Allows mapping of up to 10 aggregate fields for combined data Optional

If issues arise:
  • Confirm the connection is active (status: "Active").
  • Ensure required fields like "Parent SKU" are enabled in the mapping template.
  • Check logs using the "View Logs" option if the sync fails.
  • Contact support if needed.

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

Get Inventory (Secondary)

Supported | Mirage Pet Products - Get Inventory [Secondary]

Introduction to Mirage Pet Products Get Inventory [Secondary] Integration
This guide helps you set up the Mirage Pet Products Get Inventory [Secondary] integration to sync variant-level data such as pricing and stock quantities. It ensures your inventory details are accurate and up to date. Let’s get started.

This integration syncs variant data from Mirage Pet Products:
  • Get Inventory [Secondary]: Imports variant-level details like SKU, cost, MSRP, and quantity.
It helps maintain accurate pricing and stock levels for your product variants.

This integration connects to Mirage Pet Products via Shopify to retrieve variant data and stock levels. It has the following steps:
  • Product Fetch: Retrieves a list of products with quantity greater than 0 using a GraphQL API endpoint (`https://mirage-pet-products.com/admin/api/2024-07/graphql.json`).
  • Inventory Levels: Fetches inventory levels for Location ID 72937505057 using the REST API endpoint (`/admin/api/2023-10/inventory_levels.json?location_ids=72937505057`).
  • Data Storage: Saves the quantity and other variant details in the Global Inventory Platform (GIP).
  • 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 "MAP").
  • 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 [Secondary]."
  • 2 Check Connection: Ensure the Mirage Pet Products connection is active (status: "Active"). No authentication is required as settings are hardcoded.
  • 3 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.
  • 4 Set Up Mapping: Use the "Manage Mapping" option to choose which fields to sync (details below).
  • 5 Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."

  • The mapping screen is labeled "Mirage Pet Products - Get Inventory [Secondary]" with sections for variant field mappings.
  • Buttons: Delete, Duplicate, and Save.
  • Rules Section: Includes options to Test Rules, New Rule, and View All Rules for customizing field mappings (e.g., MSRP rule).

This section provides key details about the Get Inventory [Secondary] integration to help you understand how it works:
  • Shopify Integration: Connects to Mirage Pet Products via Shopify. Products are fetched using a GraphQL API endpoint (`https://mirage-pet-products.com/admin/api/2024-07/graphql.json`), and inventory levels are retrieved using a REST API endpoint (`/admin/api/2023-10/inventory_levels.json?location_ids=72937505057`). Settings are hardcoded for simplicity.
  • Location-Specific Inventory: Inventory levels are fetched for Location ID 72937505057, ensuring only products with quantity greater than 0 at this location are synced.
  • Pricing Rules:
    • Wholesale Price (Cost): Set as the Shopify variant price (e.g., $10).
    • MSRP: Calculated as 1.4 times the wholesale price (e.g., $14 for a $10 wholesale price, using the rule "Multiply Price by 1.4").
Tip: Review the mapping template to ensure the fields align with your pricing and inventory requirements.

Mapping Fields
Below are the fields you can map, with examples and purposes:
Get Inventory [Secondary] Mappings
Field Maps To Example Purpose Status
SKU Inventory Variant: SKU MPP123-VAR Identifies the specific variant (from Shopify Variant SKU) Required
Cost Inventory Variant: Cost (Wholesale Price) 10.00 Sets the wholesale price (from Shopify Variant Price) Optional
MAP Inventory Variant: MAP 12.00 Sets the Minimum Advertised Price for the variant Optional
MSRP Inventory Variant: MSRP 14.00 Sets the Manufacturer's Suggested Retail Price (from Shopify Variant Price, multiplied by 1.4) Optional
Quantity Inventory Variant: Quantity 50 Specifies the available stock quantity (from Shopify Variant Quantity) Optional

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

Conclusion
With this integration, your system will sync variant-level details like pricing and stock quantities from Mirage Pet Products, ensuring accurate inventory management.
 
 

 

 

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 Fulfillment Requests

Supported | Mirage Pet Products - Send Fulfillment Requests

Introduction to Mirage Pet Products Send Fulfillment Requests Integration
This guide walks you through setting up the Mirage Pet Products Send Fulfillment Requests integration. It enables you to send purchase orders to Mirage Pet Products, ensuring seamless order fulfillment. Let’s get started.

This integration allows you to:
  • Send Fulfillment Requests: Transmit purchase order details, including shipping details, 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 fulfillment request data. Here’s how it operates:
  • Order Transmission: Fulfillment requests are sent using a POST request to the Shopify API endpoint /admin/api/version/orders.json. 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) for tracking purposes.
Note: If the connection to Mirage Pet Products fails, fulfillment requests 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: Fulfillment requests can be sent manually or scheduled (e.g., every hour) using the "Adjust Schedule" option.

Follow these steps to configure the Send Fulfillment Requests integration:
  • 1 Access the Integration: Navigate to the Mirage Pet Products source and select "Send Fulfillment Requests."
  • 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 fulfillment requests (e.g., hourly) using the "Adjust Schedule" option, or send requests manually with the "Send Fulfillment Requests" action.
  • 4 Monitor Request Submission: After sending fulfillment requests, check the processed Fulfillment Requests to confirm the Shopify order ID has been saved for tracking.

  • The integration screen is labeled "Mirage Pet Products - Send Fulfillment Requests" with sections for order submission settings.
  • Buttons: Delete, Duplicate, and Save.

This section provides key details about the Send Fulfillment Requests integration to help you understand the process:
  • Shopify Integration: Connects to Mirage Pet Products via Shopify. Fulfillment requests 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 fulfillment 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 a fulfillment request is sent, the Shopify order ID is saved against the processed Fulfillment Request (FR), 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 fulfillment requests to Mirage Pet Products, with examples and purposes:
Send Fulfillment Requests Mappings
Field Maps To Example Purpose Status
Address 1 Shopify Billing Address: Address 1 123 Main St Specifies the first line of the billing address (from Billing Address: Address Line 1) Optional
Address 2 Shopify Billing Address: Address 2 Apt 4B Specifies the second line of the billing address (from Billing Address: Address Line 2) Optional
Province Code Shopify Billing Address: Province Code CA Specifies the state or province code for the billing address (from Billing Address: State Code) Optional
Zip Shopify Billing Address: Zip 90210 Specifies the postal code for the billing address (from Billing Address: Postal Code) Optional
Variant ID Shopify Line Item: Variant ID 789456123 Identifies the specific product variant being ordered (from Fulfillment Request Item) Required
Quantity Shopify Line Item: Quantity 5 Specifies the number of units ordered for the variant (from Fulfillment Request Item) Required

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

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

Get Shipments

Supported | Mirage Pet Products - Get Shipments

Introduction to Mirage Pet Products Get Shipments Integration
This guide helps you set up the Mirage Pet Products Get Shipments integration to sync shipment details such as tracking information and shipped quantities. It ensures your shipment records are accurate and up to date. Let’s get started.

This integration syncs shipment data from Mirage Pet Products:
  • Get Shipments: Imports shipment details like tracking numbers, carrier, method, and shipped quantities.
It helps maintain accurate shipment tracking and fulfillment records.

This integration connects to Mirage Pet Products via Shopify to retrieve shipment data. It has the following steps:
  • Shipment Fetch: Retrieves shipment details using a GET request to the Shopify API endpoint /admin/api/version/orders/{order_id}/fulfillments.json.
  • Data Storage: Saves shipment details, including shipped quantity per item and tracking details (carrier, method, tracking number), in your system.
  • 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 "Note").
  • Scheduling: Run manually or schedule syncs (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 Mirage Pet Products source and select "Get Shipments."
  • 2 Check Connection: Ensure the Mirage Pet Products connection is active (status: "Active"). No authentication is required as settings are hardcoded.
  • 3 Set Up Mapping: Use the "Manage Mapping" option to choose which fields to sync (details below).
  • 4 Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."

  • The mapping screen is labeled "Mirage Pet Products - Get Shipments" with sections for shipment field mappings.
  • Buttons: Delete, Duplicate, and Save.

This section provides key details about the Get Shipments integration to help you understand how it works:
  • Shopify Integration: Connects to Mirage Pet Products via Shopify. Shipments are fetched using a GET request to the Shopify API endpoint /admin/api/version/orders/{order_id}/fulfillments.json. Settings are hardcoded for simplicity.
  • Shipment Details: Saves shipment data based on shipped quantity per item and includes tracking details such as carrier, method, and tracking number.
Tip: Review the mapping template to ensure the fields align with your shipment tracking requirements.

Mapping Fields
Below are the fields you can map, with examples and purposes:
Get Shipments Mappings
Field Maps To Example Purpose Status
Carrier Shipment: Carrier UPS Identifies the shipping carrier (from Shopify Fulfillment: Tracking Company) Optional
Fulfillment Request Number Shipment: Fulfillment Request Number 123456 Associates the shipment with the fulfillment request (from Shopify Fulfillment: Order ID) Optional
Method Shipment: Method Ground Specifies the shipping method used (from Shopify Fulfillment: Service) Optional
Note Shipment: Note Handle with care Adds additional notes for the shipment (from Shopify Order: Note) Optional
Shipped At Shipment: Shipped At 2025-05-01T10:00:00Z Records the date and time the shipment was created (from Shopify Fulfillment: Created At) Optional
Shipping Cost Shipment: Shipping Cost 15.00 Specifies the shipping cost for the shipment (from Shopify Order: Shipping Cost) Optional
Tracking Number Shipment: Tracking Number 1Z9999W99999999999 Provides the tracking number for the shipment (from Shopify Fulfillment: Tracking Number) Optional
Tracking URL Shipment: Tracking URL https://www.ups.com/track?tracknum=1Z9999W99999999999 Provides a URL to track the shipment (from Shopify Fulfillment: Tracking URL) Optional

If issues arise:
  • Confirm the connection is active (status: "Active").
  • Ensure the order IDs used in the API request are valid.
  • Check logs using the "View Logs" option if the sync fails.
  • Contact support if needed.

Conclusion
With this integration, your system will sync shipment details from Mirage Pet Products, keeping your tracking and fulfillment records accurate and current.
 
 

 

 

How can I help?