Skip to content

Store adapter — Shopify

The adapter object contains properties for connecting to the Shopify API.

Parent object: a store with property "platform" : "shopify"

Required properties

The following adapter properties are required for Shopify stores.

access_token

Propertyaccess_token
NameShopify API Access Token
Data typestring
Required?Yes

location_id

Propertylocation_id
NameFulfillment Location ID
DescriptionThe ID of the fulfillment location, as configured and enabled in Shopify. When DropStream exports the shipment, Shopify checks that the item/SKU is in stock at the specified location. If not, order processing fails in DropStream with an error.
Data typestring
Required?Yes

shop_name

Propertyshop_name
NameShopify Shop Name
DescriptionThe subdomain of the store URL
Data typestring
ExampleIf the URL is http://mystore.myshopify.com, the shop name is "mystore"
Required?Yes

Optional properties

The following adapter properties are optional for Shopify stores.

enable_sku_instance

Propertyenable_sku_instance
NameEnable SKU Instance
Data typeboolean
More infoBy default, DropStream will not attempt to update inventory for more than one match for a given SKU. However, if this value is true, DropStream updates inventory for all instances of the SKU. This attribute corresponds to the GUI option Include Duplicate SKUs.
Defaultfalse

exclude_empty_orders

Propertyexclude_empty_orders
NameExclude Empty Orders
DescriptionIf true, empty orders are not imported
Data typeboolean
Defaultfalse

filter_orders_by_location

Propertyfilter_orders_by_location
NameFilter Orders By Location
DescriptionIf true, import only orders assigned to the Fulfillment Location
Data typeboolean
Defaultfalse

fulfillment_service

Propertyfulfillment_service
NameFulfillment Service
DescriptionThe Fulfillment Service is the fulfillment provider, as configured and activated in Shopify. If this value is specified, DropStream imports only line items/SKUs that have been designated for this fulfillment service. If the order contains SKUs designated for a different fulfillment service, those SKUs are not imported.
Data typestring

include_partial_fulfillments

Propertyinclude_partial_fulfillments
NameInclude Partial Fulfillments
DescriptionIf true, import orders that are "partially" fulfilled, including virtual products such as gift cards
Data typeboolean
Defaultfalse

order_import_financial_status

Propertyorder_import_financial_status
NameOrder Import Financial Status
DescriptionOrders with the specified status(es) are imported
Data typearray of strings
Accepted values
  • "Paid"
  • "Pending"
  • "Authorized"
  • "Partially Paid"
  • "Partially Refunded"
  • "Refunded"
  • "Voided"
Default[ "Paid" ]
Example["Paid", "Partially Paid", "Refunded"]

order_import_fulfillment_status

Propertyorder_import_fulfillment_status
NameOrder Import Fulfillment Status
Data typestring
Default"unshipped"

return_magic_api_key

Propertyreturn_magic_api_key
NameReturn Magic API Key
DescriptionThe Return Magic API key if using Return Magic for custom returns workflow
Data typestring

use_local_currency

Propertyuse_local_currency
NameUse Local Currency
DescriptionIf set to true, money values are displayed in the buyer's local currency
Data typeboolean
Defaultfalse

Example

Example: create a new Shopify store
curl -X POST \
    -H "Authorization: Bearer $JWT_TOKEN" \
    -H "Content-Type: application/json" \
    https://api.getdropstream.com/stores \
    -d @- <<EOF
{ "customer_id": "3775",
  "name":"Your Shopify Store",
  "platform": "shopify",
  "adapter": {
    "shop_name": "abc123",
    "location_id": "abc123",
    "access_token": "abc123",
    "enable_sku_instance": false,
    "exclude_empty_orders": false,
    "filter_orders_by_location": false,
    "fulfillment_service": "abc123",
    "include_partial_fulfillments": false,
    "order_import_financial_status": [ "Paid", "Pending" ],
    "order_import_fulfillment_status": "abc123",
    "return_magic_api_key": "abc123",
    "use_local_currency": false
  }
}
EOF

For details about this request type, see: Create a new store.