feat: implement, prototype, tests, resources

Author: aldochaconc

resources/fulfillment-order.js

@@ -127,4 +127,19 @@ FulfillmentOrder.prototype.fulfillments = function fulfillments(id) {
   return this.shopify.request(url, 'GET', 'fulfillments');
 };
 
+/**
+ * Halts all fulfillment work on a fulfillment order with
+ * status OPEN and changes the status of the fulfillment order to ON_HOLD.
+ *
+ * @param {Number} id Order ID
+ * @return {Promise} Promise that resolves with the result
+ * @public
+ */
+FulfillmentOrder.prototype.hold = function hold(id, params) {
+  const url = this.buildUrl(`${id}/hold`);
+  return this.shopify
+    .request(url, 'POST', undefined, params)
+    .then((body) => body[this.key]);
+};
+
 module.exports = FulfillmentOrder;

test/fixtures/fulfillment-order/req/hold.json

@@ -0,0 +1,7 @@
+{
+  "fulfillment_hold": {
+    "reason": "inventory_out_of_stock",
+    "reason_notes": "Not enough inventory to complete this work.",
+    "fulfillment_order_line_items": [{ "id": 1058737493, "quantity": 1 }]
+  }
+}

test/fixtures/fulfillment-order/req/index.js

@@ -4,3 +4,4 @@ exports.cancel = require('./cancel');
 exports.close = require('./close');
 exports.move = require('./move');
 exports.setFulfillmentOrdersDeadline = require('./set-fulfillment-orders-deadline');
+exports.hold = require('./hold');

test/fixtures/fulfillment-order/res/hold.json

@@ -0,0 +1,61 @@
+{
+  "fulfillment_order": {
+    "id": 1046000789,
+    "shop_id": 548380009,
+    "order_id": 450789469,
+    "assigned_location_id": 24826418,
+    "request_status": "unsubmitted",
+    "status": "on_hold",
+    "fulfill_at": null,
+    "supported_actions": ["release_hold"],
+    "destination": {
+      "id": 1046000789,
+      "address1": "Chestnut Street 92",
+      "address2": "",
+      "city": "Louisville",
+      "company": null,
+      "country": "United States",
+      "email": "bob.norman@mail.example.com",
+      "first_name": "Bob",
+      "last_name": "Norman",
+      "phone": "+1(502)-459-2181",
+      "province": "Kentucky",
+      "zip": "40202"
+    },
+    "line_items": [
+      {
+        "id": 1058737493,
+        "shop_id": 548380009,
+        "fulfillment_order_id": 1046000789,
+        "quantity": 1,
+        "line_item_id": 518995019,
+        "inventory_item_id": 49148385,
+        "fulfillable_quantity": 1,
+        "variant_id": 49148385
+      }
+    ],
+    "international_duties": null,
+    "fulfillment_holds": [
+      {
+        "reason": "inventory_out_of_stock",
+        "reason_notes": "Not enough inventory to complete this work."
+      }
+    ],
+    "fulfill_by": null,
+    "created_at": "2024-07-24T06:26:32-04:00",
+    "updated_at": "2024-07-24T06:26:33-04:00",
+    "delivery_method": null,
+    "assigned_location": {
+      "address1": null,
+      "address2": null,
+      "city": null,
+      "country_code": "DE",
+      "location_id": 24826418,
+      "name": "Apple Api Shipwire",
+      "phone": null,
+      "province": null,
+      "zip": null
+    },
+    "merchant_requests": []
+  }
+}

test/fixtures/fulfillment-order/res/index.js

@@ -7,3 +7,4 @@ exports.close = require('./close');
 exports.list = require('./list');
 exports.move = require('./move');
 exports.get = require('./get');
+exports.hold = require('./hold');

test/fulfillment-order.test.js

@@ -134,4 +134,17 @@ describe('Shopify#fulfillmentOrder', () => {
       .fulfillments(1046000823)
       .then((data) => expect(data).to.deep.equal(output.fulfillments));
   });
+
+  it('applies a fulfillment hold on an open fulfillment order', () => {
+    const input = fixtures.req.hold;
+    const output = fixtures.res.hold;
+
+    scope
+      .post('/admin/fulfillment_orders/1046000789/hold.json', input)
+      .reply(200, output);
+
+    return shopify.fulfillmentOrder.hold(1046000789).then((data) => {
+      expect(data).to.deep.equal(output.fulfillment_order);
+    });
+  });
 });

types/index.d.ts

@@ -389,6 +389,7 @@ declare class Shopify {
     fulfillments: (
       id: number
     ) => Promise<Shopify.IPaginatedResult<Shopify.IFulfillment>>;
+    hold: (id: number, params: any) => Promise<Shopify.IFulfillmentOrder>;
   };
   fulfillmentRequest: {
     accept: (