Magento 2 Integration


Overview

We offer the following types of integrations with Magento 2:

  • Order Syncing - the automated pushing of orders/shipments from Magento 2 into MachShip.
  • Live Pricing - the display of a live carrier price in the checkout to users based on the items they are purchasing.

You are not required to setup both integrations - it is not uncommon for customers to only opt for one of these integration types in their setup.

Order Syncing Integration

Order Syncing Workflow

  1. Customer places an order inside the Magento 2 Store
  2. We detect this has occurred, and filter out orders
    • Filters can allow for skipping of pick-ups and other orders not meant for MachShip
  3. We create a pending consignment in MachShip for each Magento 2 Order with:
    • Warehouse and customer details
    • Magento 2 order number as reference
    • If using our Live Rates integration, we also pass across:
      • SKUs with dimensions and weights
      • Selected Carrier & Service
      • Applicable Surcharges for tailgates and residentials
  4. Order is picked and packed by warehouse
  5. Warehouse opens MachShip and searches for the order using Magento 2 order number
  6. Warehouse team inputs boxes onto the consignment
  7. Pickers/Packers select a carrier service, or simply use cheapest
  8. Once consignment manifested, we update Magento 2 within 5 minutes and set Tracking Link
  9. Order is marked as completed

Order Syncing FAQs

Q: What options are there for grouping products into packages?

A: Please read our Packing Rules documentation here. It refers to the cart, but can be applied when syncing orders as well.

Q: Can you sync orders with/without certain parameters, shipping methods or locations?

A: Yes, we can set custom filters on each integration to include or exclude orders based on status, shipping methods, locations, custom values and a variety of other things.

Live Pricing Integration

Live Pricing Workflow

  1. A user adds some items to their cart and reaches the checkout
  2. The user inputs their address, and we are sent a warehouse (from location), the customer's address and the products in the user's cart
  3. We transform the products in the customers cart into packages using configured packing rules
  4. We generate a freight quote using these packages, and the warehouse and customer address with your carriers
  5. We return shipping options (carrier groups) to your checkout for the user to pay

Live Pricing FAQs

Q: What options are there for grouping products into packages?

A: Please read our Packing Rules documentation here. For Magento 2, the most common approach is grouping items into packages based on a weight limit.

Q: What types of shipping options can I show in the checkout?

A: We have a document explain our options for Carrier Grouping / Shipping Options here.

We can either show the carriers and services individually, or return simpler options factoring in surcharges. Common shipping groups include:

  • Residential Shipping
  • Business Shipping
  • Tailgate Delivery
  • Forklift Unload Available At Delivery Point

Q: How does the integration handle multi-source inventory (MSI)?

A: Our integration handles various MSI scenarios intelligently:

  • Single Product, Multiple Warehouses:
    • If one warehouse has enough stock: Quote from that warehouse
    • If no single warehouse has enough stock: Quote from warehouse with most stock
  • Multiple Products:
    • If one warehouse has all items: Quote from that warehouse
    • If stock is split across warehouses: Quote each item from best-stocked warehouse
    • If fully stocked in multiple warehouses: Quote all options, return cheapest

Important Info

  • Live pricing can cause issues with Google Advertising. Please read this article if you are running Google Shopping ads.
  • Our integration requires temporary admin access to complete the setup process.

Magento 2 FAQs

Q: How do I install the MachShip extension?

A: We will provide the extension via email along with installation instructions during the setup process.

Q: How do I configure shipping rates in Magento 2 admin based on MachShip?

A: Most of the configuration is done on our side. We will quote all your carriers and typically return the cheapest price as a single shipping option, though we can show all carrier service options if preferred.

Q: Are there any limitations or rate limits with the integration?

A: We have no limitation or rate limits.

Integration Setup Process

All integrations are completed by our in-house integrations team that specializes in setting up integrations with Magento 2.

The process for getting your integration setup is:

  1. Scoping - Reach out to our integrations team at clientintegrations@machship.com - note, if you're using MachShip via a broker, please include the account manager in CC.

Our specialist integrations team will work with you to confirm the scope of your integration and ensure it will perform how you expect.

  1. Approval - From there, you will be provided with a quote for any associated integration implementation costs for approval.

  2. Implementation - Once approved, implementation will begin:

    • We will provide our Magento 2 extension
    • You'll need to create an admin user for us (clientintegrations@machship.com)
    • We'll configure packing rules and carrier grouping
    • We'll complete the MachShip plugin configuration
  3. Handover & Testing - Once completed, we will let you know and you can conduct your own testing to confirm everything is working as expected.

Setup FAQs

Q: How long does it take to setup my integration?

Most Magento 2 integrations can be setup inside of 2-3 business days from when we receive admin access.

Q: Am I able to setup the integration myself?

We do not currently offer self-setup for our integrations due to the amount of customisation and testing required when linking your integration to your MachShip account.

Q: My requirements differ from what you've laid out, can you customise the integration?

We do have the ability to customise our integrations for each client to a large degree.

Simply reach out to our integrations team at clientintegrations@machship.com with your requirements and we will let you know what we can do.

Related Articles