Creating a new fulfillment via REST API.

Shopify Partner
1016 83 237

This topic was created here --> Although I don't recall seeing any feedback from the Shopify staff. Can someone there please respond?

We are close to pulling the trigger on Shopify POS, but run into an issue when it comes to fulfilling orders. We can't automatically flag all paid POS orders as being fulfilled. Since we have a fair amount of partially-paid orders (e.g. - layaways). So the inventory can't be flagged as adjusted out, since our state doesn't consider such until the orders are fully paid. And we can't rely on our sales staff to always remember to manually flag a fully-paid order as fulfilled in the Shopify POS UI. So I was going to create a routine to automatically flag any/all fully paid POS orders as fulfilled by utilizing the REST API. But in short, the API endpoint doesn't respond against any request body that I've tried. The details are in the link above...

Shopify Partner
1016 83 237

Here is another example below. I can try to include any/all of these parameters in the request body and wind up with the same 400 - Bad Request error in response. The X-Request-Id shown is ac3eebc2-c4c8-4655-b0a0-c7ca73a65a15 so hopefully it can be cross-referenced on the back-end.


POST https://{my-shop}{order_id}/fulfillments.json HTTP/1.1
Content-Type: application/json
Authorization: Basic {access_token}
User-Agent: PostmanRuntime/7.25.0
Accept: */*
Host: {my-shop}
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 517

"fullfillment": {
  "location_id": 203128,
  "tracking_number": "123456789",
  "tracking_numbers": ["123456789"],
  "service": "manual",
  "tracking_url": "",
  "tracking_urls": [""],
  "tracking_company": "Jack Black's Pack, Stack and Track",  
  "receipt": {},
  "line_items": [{"id": 5553278779554, "quantity": 1, "variant_id": 31620762828852, "fulfillment_service":"manual" }],
  "notify_customer": false
HTTP/1.1 400 Bad Request
Date: Mon, 15 Jun 2020 14:43:37 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive
Set-Cookie: __cfduid=da9a42ea5267ba05c401c5f0b5064479d1592232217; expires=Wed, 15-Jul-20 14:43:37 GMT; path=/;; HttpOnly; SameSite=Lax
X-Sorting-Hat-PodId: 161
X-Sorting-Hat-ShopId: 3036253
Referrer-Policy: origin-when-cross-origin
X-Frame-Options: DENY
X-ShopId: 3036253
X-ShardId: 161
X-Stats-ApiClientId: 309925
X-Stats-ApiPermissionId: 8304915
X-Shopify-API-Terms: By accessing or using the Shopify API you agree to the Shopify API License and Terms of Use at
X-Shopify-Shop-Api-Call-Limit: 1/40
X-Shopify-API-Version: 2020-04
Strict-Transport-Security: max-age=7889238
X-Shopify-Stage: production
Content-Security-Policy: default-src 'self' data: blob: 'unsafe-inline' 'unsafe-eval' https://* shopify-pos://*; block-all-mixed-content; child-src 'self' https://* shopify-pos://*; connect-src 'self' wss://* https://*; frame-ancestors 'none'; img-src 'self' data: blob: https:; script-src 'self' 'unsafe-inline' 'unsafe-eval'; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=create&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Forders%2Ffulfillments&source%5Bsection%5D=admin_api&source%5Buuid%5D=ac3eebc2-c4c8-4655-b0a0-c7ca73a65a15
X-Content-Type-Options: nosniff
X-Download-Options: noopen
X-Permitted-Cross-Domain-Policies: none
X-XSS-Protection: 1; mode=block; report=/xss-report?source%5Baction%5D=create&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Forders%2Ffulfillments&source%5Bsection%5D=admin_api&source%5Buuid%5D=ac3eebc2-c4c8-4655-b0a0-c7ca73a65a15
X-Dc: gcp-us-central1,gcp-us-east1,gcp-us-east1
X-Request-ID: ac3eebc2-c4c8-4655-b0a0-c7ca73a65a15
CF-Cache-Status: DYNAMIC
cf-request-id: 035a08a460000003bcf9a69200000001
Expect-CT: max-age=604800, report-uri=""
Server: cloudflare
CF-RAY: 5a3d10809f8c03bc-ORD
alt-svc: h3-27=":443"; ma=86400
Content-Length: 66

{"errors":{"fulfillment":"Required parameter missing or invalid"}}
Shopify Partner
1016 83 237

This is an accepted solution.

Had to figure out doing it via the GraphiQL API, which finally worked. Details here -->

48 0 15


Is the a custom app you are developing for Shopify POS to accept or handel Layaways?

If so i would be interesting in this buying a lic to use this app. 

We need the feature for our jewelry store as we have a lot of layaways.




Shopify Partner
1016 83 237

If this question was directed to me, we don't have a "custom app" per-se. All I do is rely on the Shopify API to export out the various partially-paid orders. I pipe those into a local SQL Server DB and then can assess "special orders," layaways, store credit, in-house charge account transactions, etc. Not really an app as much as having better visibility into what each customer has sitting there. Usually I whip up a Crystal Report for a specific request my users might have come up a lot