Shopify connector

Carriyo integrates with Shopify in a few minutes. The connector covers the post-purchase lifecycle: orders flow into Carriyo, shipments are tracked back into Shopify, products and locations stay in sync, and approved returns are mirrored on the Shopify order.

Carriyo offers two ways to install:

• The Carriyo Shopify App from the Shopify App Store. This is the recommended path, locations and webhooks are configured for you and you can fulfill orders directly from Carriyo. See Installing the Carriyo Shopify App.
• The legacy connector with a Shopify custom app. Use this when you need the full set of configuration options or are migrating an existing setup. See Shopify connector setup.

To display carrier shipping rates on the Shopify checkout page, see Display carrier shipping rates on the Shopify checkout page.

What the integration does

Orders from Shopify to Carriyo

The connector activates the flow of customer orders from Shopify into Carriyo for fulfillment, shipping, and tracking. Two integration modes are available:

• Fulfillment Flow (recommended). When a customer order is fulfilled in Shopify, Carriyo creates a shipment. Each Shopify fulfillment becomes a separate Carriyo shipment, which enables multi-location fulfillment and pre-booked shipments.
• Order Flow. When a customer order is confirmed in Shopify, Carriyo creates a shipment. Carriyo becomes the fulfillment system and automatically fulfills the order in Shopify based on shipment status. You can choose to auto-fulfill on Booked or Shipped. Order Flow assumes one shipment and one fulfillment per order and that Carriyo books all labels.

Pre-booked fulfillments from Shopify to Carriyo

When Shopify (or another external system) books labels and Carriyo is used in a tracking-only capacity, Carriyo automatically tags incoming shipments as pre-booked when they arrive with an air-waybill number and carrier name.

Tracking updates from Carriyo to Shopify

As Carriyo tracks shipments with the carrier, it pushes status changes to Shopify to update the fulfillment. In Order Flow mode, tracking information also triggers the creation of fulfillments in Shopify.

Carriyo updates the Shopify order status using the following mapping:

Carriyo shipment status	Shopify order status
Draft or Booked (Order Flow only)	Confirmed
Booked, Shipped, In Transit	On its way
Out for Delivery	Out for Delivery
Delivered	Delivered
Failed Delivery Attempt	Attempted Delivery

Product information from Shopify to Carriyo

When product information sync is enabled, the connector captures the following fields from Shopify:

• Product code
• Product description
• Product image URL
• Harmonized Schedule Tariff Code (HS code)
• Country of origin

For cross-border shipping, make sure HS codes and country of origin are set in Shopify. If they are missing, you need to add them manually in Carriyo for each shipment before booking.

Location and shipping code mapping

• Locations. Imported from Shopify so you can map each Shopify fulfillment location to a Carriyo location.
• Shipping codes. Imported from Shopify so you can map Shopify shipping codes to Carriyo delivery types. Mapping is optional, set a default delivery type to apply when no mapping exists.

Returns from Carriyo to Shopify

When you approve a customer return request in Carriyo, Carriyo initiates a return on the Shopify order. As the return progresses, Carriyo mirrors the status on Shopify so you can identify returned orders and process refunds or exchanges from Shopify.

Integration options

The Shopify connector offers the following options in the connector editor in the Carriyo Dashboard.

• Order prefix (optional): prefix all incoming orders from a specific Shopify store.
• Cash on delivery payment types (optional): choose which Shopify payment types are classified as cash on delivery in Carriyo.
• Auto-book: when on, Carriyo books incoming shipments automatically. When off, Carriyo creates shipments in Draft status for manual booking.
• Auto-fulfill (Order Flow only): fulfill the Shopify order on Booked, on Shipped, or never.
• Location mapping: assign each Shopify fulfillment location to a Carriyo location.
• Delivery type mapping and default delivery type: map Shopify shipping codes to Carriyo delivery types. Carriyo applies the default delivery type when no mapping is found. If neither a mapping nor a default is set, Carriyo creates shipments with a blank delivery type.