Fulfillments

The fulfillment flow inserts shipment data on Shopify and thus notifies the customer.

In the example we can see the fields regarding shipped product data and tracking information.

The system allows partial fulfillments.

{
    "orderName": "#1049",
    "lineItems": [
        {
            "sku": "0001BK",
            "qty": 1
        }
    ],
    "trackingInfo": {
        "company": "UPS",
        "number": "1Z001985YW99744790",
        "url": "https://www.myshipping.com/track/?tracknumbers=TRACKING_NUMBER"
    },
    "notifyCustomer": true // Default to true
}

Destination configuration

Configure a Shopify destination and associate it with the flow, in addition to the basic data flow configuration.

Field	Value	Notes
Destination Type	Shopify
Operation	Fulfillment	POST /egress/sync-fulfillment-to-shopify
GraphQL endpoint URL	https://SHOPIFYURL.myshopify.com/	Shopify Admin GraphQL endpoint URL
Admin API access token	shpat_CODICEALFANUMERICO	Or Client ID (API key) + Client secret — see Authentication
Client ID (API key)	YOUR_CLIENT_ID
Client secret	YOUR_CLIENT_SECRET
Allow duplicate SKUs	true / false	When true, allows fulfillment line items that reference duplicate SKUs (default: false, required)

Deprecated — previous configuration (HTTP Adapter)

Deprecated

Configuration via HTTP Adapter with Base Url, Resource Path, and x-api-key header in Settings Override is deprecated. Use the Shopify destination configuration described above.

In addition to the basic data flow configuration, the following Settings Override settings were required:

Field	Value	Notes
Base Url	https://adapter.flowlyze.io	Adapter URL
Resource Path	/api/adp/shopify/egress/sync-fulfillment-to-shopify	Adapter path for fulfillment
Headers :: x-api-key	**********	API key for endpoint interaction verification
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	Shopify shop URL to connect to
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret of the custom app created for integration
Headers :: x-allow-duplicate-skus	true/false	Indicates whether duplicate SKUs are allowed among line items in the request (default false)