Sendcloud - new components (#18043)

Author: jcortes

components/sendcloud/actions/bulk-pdf-label-printing/bulk-pdf-label-printing.mjs

@@ -0,0 +1,42 @@
+import app from "../../sendcloud.app.mjs";
+import utils from "../../common/utils.mjs";
+
+export default {
+  key: "sendcloud-bulk-pdf-label-printing",
+  name: "Bulk PDF Label Printing",
+  description: "Bulk PDF label printing. [See the documentation](https://api.sendcloud.dev/docs/sendcloud-public-api/branches/v2/labels/operations/create-a-label)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    app,
+    parcels: {
+      type: "integer[]",
+      label: "Parcel IDs",
+      description: "IDs of parcels to print labels. Example: [1, 2, 3]",
+      propDefinition: [
+        app,
+        "parcelId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      parcels,
+    } = this;
+
+    const response = await app.bulkPDFLabelPrinting({
+      $,
+      data: {
+        label: {
+          parcels: utils.parseArray(parcels),
+        },
+      },
+    });
+
+    $.export("$summary", "Successfully triggered bulk label print");
+
+    return response;
+  },
+};
+

components/sendcloud/actions/create-a-parcel/create-a-parcel.mjs

@@ -4,7 +4,7 @@ export default {
   key: "sendcloud-create-a-parcel",
   name: "Create a Parcel",
   description: "Creates a new parcel under your Sendcloud API credentials. [See the documentation](https://api.sendcloud.dev/docs/sendcloud-public-api/parcels/operations/create-a-parcel)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     app,

components/sendcloud/actions/create-return/create-return.mjs

@@ -0,0 +1,120 @@
+import app from "../../sendcloud.app.mjs";
+import utils from "../../common/utils.mjs";
+
+export default {
+  key: "sendcloud-create-return",
+  name: "Create Return",
+  description: "Create a return. [See the documentation](https://api.sendcloud.dev/docs/sendcloud-public-api/returns/operations/create-a-return)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    app,
+    fromAddress: {
+      label: "From Address",
+      propDefinition: [
+        app,
+        "addressSetup",
+      ],
+    },
+    toAddress: {
+      label: "To Address",
+      propDefinition: [
+        app,
+        "addressSetup",
+      ],
+    },
+    shipWith: {
+      propDefinition: [
+        app,
+        "shipWith",
+      ],
+    },
+    dimensionsLength: {
+      propDefinition: [
+        app,
+        "dimensionsLength",
+      ],
+    },
+    dimensionsWidth: {
+      propDefinition: [
+        app,
+        "dimensionsWidth",
+      ],
+    },
+    dimensionsHeight: {
+      propDefinition: [
+        app,
+        "dimensionsHeight",
+      ],
+    },
+    dimensionsUnit: {
+      propDefinition: [
+        app,
+        "dimensionsUnit",
+      ],
+    },
+    weightValue: {
+      propDefinition: [
+        app,
+        "weightValue",
+      ],
+    },
+    weightUnit: {
+      propDefinition: [
+        app,
+        "weightUnit",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      fromAddress,
+      toAddress,
+      shipWith,
+      dimensionsLength,
+      dimensionsWidth,
+      dimensionsHeight,
+      dimensionsUnit,
+      weightValue,
+      weightUnit,
+    } = this;
+
+    const response = await app.createReturn({
+      $,
+      data: {
+        from_address: utils.parseJson(fromAddress),
+        to_address: utils.parseJson(toAddress),
+        ship_with: utils.parseJson(shipWith),
+        ...(dimensionsLength
+          && dimensionsWidth
+          && dimensionsHeight
+          && dimensionsUnit
+          ? {
+            dimensions: {
+              length: dimensionsLength,
+              width: dimensionsWidth,
+              height: dimensionsHeight,
+              unit: dimensionsUnit,
+            },
+          }
+          : undefined
+        ),
+        ...(weightValue && weightUnit
+          ? {
+            weight: {
+              value: weightValue,
+              unit: weightUnit,
+            },
+          }
+          : undefined
+        ),
+      },
+    });
+
+    $.export("$summary", "Successfully created return");
+
+    return response;
+  },
+};
+