This article will address some of the frequently asked questions from customers who have been upgraded to the Shopify GraphQL API.
What is GraphQL?
Information on GraphQL in Shopify, can be found on their Shopify Blog.
When will I be upgraded to GraphQL?
Shopify have asked us to do an upgrade to the latest ShopifyGraphQL API, we are rolling this out in phases to limit potential downtime. Please ensure you are integrated via the public app method using the Shopify Integration article.
Property mappings have stopped working?
If Property Mappings have stopped working since being upgraded to the GraphQL API, please ensure you have mapped the correct section as this has changed with the new API. The JSON data returned from Shopify will vary slightly depending on whether you’ve upgraded to the GraphQL API. If you have upgraded, the JSON will include a "customAttributes" section containing a Key and Value for mapping. If you haven’t upgraded, the JSON will instead have a "note_attributes" section with a Name and Value for mapping. More information can be found in our Property Mappings article.
I get an error when dispatching
If you encounter the following error when dispatching an order on Mintsoft (FulfilmentResponse: {"fulfillment":{"id":x,"order_id":x,"status":"success","created_at":"x","service":"manual","updated_at":"x","tracking_company":"x","shipment_status":null,"location_id":x,"origin_address":null,"line_items" [{"id":x,"variant_id":x,"title":"x","quantity":x,"sku":"x","variant_title":"x","vendor":"x","fulfillment_service":"manual","product_id":x,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"x","variant_inventory_management":"shopify","properties). This typically occurs because a tracking URL has not been provided.
Previously, Shopify accepted dispatch updates from Mintsoft even if a tracking number was missing. However, with the upgrade to GraphQL, Shopify now requires a tracking URL.
To resolve this issue:
Ensure a tracking URL is provided to each Courier Service in Mintsoft when dispatching orders.
If a tracking URL isn’t available, you can use your company’s website URL instead. The field must be filled with a value
By following these steps, you should be able to resolve the error.