Testing your uShip Shopify Integration

Updated
After setting up the uShip Shopify App and configuring your shipping methods, it's crucial to thoroughly test the integration before going live. This guide will walk you through the steps to ensure your uShip integration is working correctly with your Shopify store.

Prerequisites

Before testing, make sure you have:

  • Installed and configured the uShip Shopify App
  • Set up metafields for product dimensions
  • Created a uShip shipping profile in Shopify
  • Added products to your store with weights and dimensions

Step 1: Test Rate Calculation

  1. Go to your Shopify storefront (not the admin panel)
  2. Add a product to your cart that you've set up for uShip shipping
  3. Proceed to checkout
  4. Enter a shipping address within the continental United States
  5. Verify that uShip appears as a shipping option with a calculated rate

If uShip rates don't appear:

  • Check that the product is assigned to the uShip shipping profile
  • Verify that the product has weight and dimensions (metafields) set correctly
  • Ensure the shipping address is within the uShip service area (continental US)

Step 2: Place a Test Order

  1. Complete the checkout process with uShip as the shipping method
  2. Use a test credit card number for payment 
  3. Confirm the order

Step 3: Verify Order in Shopify

  1. Go to your Shopify admin panel
  2. Navigate to Orders
  3. Find your test order
  4. Confirm that uShip is listed as the shipping method

Step 4: Check uShip Listing Creation

  1. Log in to your uShip account
  2. Go to your listings or shipments dashboard
  3. Verify that a new listing has been created for your test order
  4. Check that the listing details (items, dimensions, pickup location) are correct

If the listing isn't created:

  • Ensure your uShip account is correctly linked to the Shopify app
  • Check the app's settings for any error messages

Step 5: Test Manual Order Sending

  1. In Shopify, create a new order and select a non-uShip shipping method
  2. Go to the order details
  3. Look for the option to "Send to uShip"
  4. Follow the process to manually create a uShip listing
  5. Verify the listing appears in your uShip account

Step 6: Test Updating Order Details

  1. Start the process to manually send an order to uShip
  2. Try changing the pickup location
  3. Adjust the items included in the shipment
  4. Complete the process and verify changes in the uShip listing

Step 7: Check Shopify Order Fulfillment

  1. In Shopify, go to an order that's been sent to uShip
  2. Verify that the order status reflects that it's been sent to uShip for shipping
  3. Check if any tracking information is properly synced (note: this may not occur until a carrier accepts the shipment on uShip)

Common Issues and Solutions

  • Rates not appearing: Check product dimensions, weight, and shipping profile assignment
  • Incorrect rates: Verify your markup settings in the uShip app
  • Listings not creating in uShip: Ensure your uShip account is properly connected and authorized
  • Wrong pickup location: Check your Shopify locations settings and default shipping origin

Final Checks

  • Test with various product combinations to ensure accurate multi-item shipments
  • Verify that any customizations (like markup or UPP) are applied correctly
  • Check that your confirmation emails include the correct shipping information

If you encounter any issues during testing that you can't resolve, don't hesitate to contact our support team for assistance. It's crucial to have everything working correctly before relying on the integration for your live orders.

Was this helpful?