Skip to content

Import Order Fulfillments to Shopify

This task will insert fulfillments to your Shopify store, using the product data in an XML file. If an ID is provided, the existing shipment will be updated, if not, a new one will be created.

Important

This task uses Shopify's REST API, which is now deprecated. We recommend migrating to the equivalent GraphQL API task. See here for more information.

Settings

Connection

Required
The Shopify connection to use. See Shopify Connection if you require more information on how to create/manage connections.

Fail File

Required
The XML file to output any failed imports to. See Shopify Fulfillment XML for more details.

Input File

Required
The XML file containing the fulfillments. They should be stored in the same format as shown below.

Success File

Required
The XML file to output successful imports to.

Prevent Reprocessing

Required
Optionally prevent reprocessing the same records by providing an in the XML you provide.

Timeout

Optional
The length of time to wait (in seconds) for Shopify to respond to each API request. If left blank, or set to 0 or less, a default value of 100 seconds will be applied.

Zynk Settings

See Common Task Settings.

Permissions

This task requires the following permissions in your Shopify app:

  • read_locations
  • read_orders
  • read_assigned_fulfillment_orders
  • write_assigned_fulfillment_orders
  • read_merchant_managed_fulfillment_orders
  • write_merchant_managed_fulfillment_orders

Examples

A sample input file is shown below, showing an order with a single product. See Shopify Fulfillment XML for more details.

<?xml version="1.0" encoding="utf-8"?>
<fulfillments>
  <fulfillment>
    <order-id>4751371664</order-id>
    <order-name>#10523</order-name>
    <location-id>3972354144</location-id>
    <location-name>Newcastle</location-name>
    <notify-customer>false</notify-customer>
    <tracking-company>Fedex</tracking-company>
    <tracking-numbers>
      <tracking-number>67890</tracking-number>
    </tracking-numbers>
    <tracking-urls>
      <tracking-url>https://fedex.com/track?no=67890</tracking-url>
    </tracking-urls>
    <line-items>
      <line-item>
          <id>7152391860</id> <!-- Matches items based on the order line item ID -->
          <fulfillment-line-item-id>9874017354</fulfillment-line-item-id> <!-- Matches items based on the fulfilment order line item ID -->
          <sku>TFD0121</sku> <!-- Matches items based on the order line item SKU -->
          <quantity>2</quantity>
      </line-item>
   </line-items>
  </fulfillment>
</fulfillments>