Formatting - [Date/Time] Add/Subtract Time with Pipedream Utils API on New Client (Instant) from neetoinvoice API

Pipedream makes it easy to connect APIs for Pipedream Utils, neetoinvoice and 2,900+ other apps remarkably fast.

Trigger workflow on

New Client (Instant) from the neetoinvoice API

Next, do this

Formatting - [Date/Time] Add/Subtract Time with the Pipedream Utils API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a neetoinvoice trigger and Pipedream Utils action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Client (Instant) trigger
1. Connect your neetoinvoice account
Configure the Formatting - [Date/Time] Add/Subtract Time action
1. Connect your Pipedream Utils account
2. Configure Input Date
3. Optional- Select a Input Format
4. Select a Operation
5. Configure Duration
6. Optional- Select a Output Format
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Client (Instant) on neetoinvoice

Description:Emit new event every time there is a new client in neetoInvoice. [See the documentation](https://help.neetoinvoice.com/articles/neetoinvoice-zapier-integration)

Version:0.0.1

Key:neetoinvoice-new-client

View on GitHub

neetoinvoice Overview#

The neetoinvoice API facilitates the creation and management of invoices, allowing users to seamlessly generate, send, and track invoices directly through their API. Integrating neetoinvoice with Pipedream opens up a realm of possibilities for automating your invoice-related workflows. With Pipedream, you can connect neetoinvoice to a multitude of apps to create custom, serverless workflows that can handle events like invoice creation, payment updates, and sending reminders, all managed with a user-friendly interface.

Trigger Code#

import common from "../common/base.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...common,
  key: "neetoinvoice-new-client",
  name: "New Client (Instant)",
  description: "Emit new event every time there is a new client in neetoInvoice. [See the documentation](https://help.neetoinvoice.com/articles/neetoinvoice-zapier-integration)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    http: "$.interface.http",
    db: "$.service.db",
  },
  methods: {
    ...common.methods,
    getEvent() {
      return "new_client";
    },
    getFunction() {
      return this.neetoinvoice.listClients;
    },
    getDataToEmit(body) {
      return {
        id: body.id,
        summary: `A new client with Id: ${body.id} has been created!`,
        ts: new Date(body.createdAt),
      };
    },
  },
  sampleEmit,
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
neetoinvoice	`neetoinvoice`	`app`	This component uses the neetoinvoice app.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.

Trigger Authentication#

neetoinvoice uses API keys for authentication. When you connect your neetoinvoice account, Pipedream securely stores the keys so you can easily authenticate to neetoinvoice APIs in both code and no-code steps.

About neetoinvoice#

Simple invoicing and time tracking tool. It's forever free.

Action#

Formatting - [Date/Time] Add/Subtract Time on Pipedream Utils

Description:Add or subtract time from a given input

Version:0.0.6

Key:pipedream_utils-add-subtract-time

View on GitHub

Pipedream Utils Overview#

The Pipedream Utils app is a set of pre-built functions that streamline common tasks in your workflows. It acts like a Swiss Army knife for developers, providing essential tools such as format conversion, date manipulation, and text processing. By leveraging these functions, you can reduce the boilerplate code needed for routine operations, speeding up the development of intricate automations. The Helper Functions API can be a game changer when it comes to tasks like parsing dates in user-friendly formats, encoding and decoding data, or generating UUIDs, making them more efficient and less error-prone.

Action Code#

import { ConfigurationError } from "@pipedream/platform";
import pipedream_utils from "../../pipedream_utils.app.mjs";
import commonDateTime from "../../common/date-time/commonDateTime.mjs";
import {
  DATE_FORMAT_PARSE_MAP, DEFAULT_FORMAT_VALUE,
} from "../../common/date-time/dateFormats.mjs";
import { DATE_TIME_UNITS } from "../../common/date-time/dateTimeUnits.mjs";
import sugar from "sugar";
const OPERATION_OPTIONS = {
  ADD: "Add",
  SUBTRACT: "Subtract",
};
export default {
  ...commonDateTime,
  name: "Formatting - [Date/Time] Add/Subtract Time",
  description: "Add or subtract time from a given input",
  key: "pipedream_utils-add-subtract-time",
  version: "0.0.6",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  type: "action",
  props: {
    ...commonDateTime.props,
    operation: {
      label: "Operation",
      description: "Whether to add or subtract time.",
      type: "string",
      options: Object.values(OPERATION_OPTIONS),
    },
    duration: {
      label: "Duration",
      description: "The duration for the operation. You can use the shorthand duration, for example: `1s`, `1m`, `1h`, `1d`, `1w`, `1y` equal one second, minute, hour, day, week, and year respectively",
      type: "string",
    },
    outputFormat: {
      propDefinition: [
        pipedream_utils,
        "outputFormat",
      ],
    },
  },
  methods: {
    ...commonDateTime.methods,
    getOperationMilliseconds(str) {
      let result = 0;
      const {
        second, minute, hour, day, week, year,
      } = DATE_TIME_UNITS;
      Object.entries({
        s: second,
        m: minute,
        h: hour,
        d: day,
        w: week,
        y: year,
      }).forEach(([
        identifier,
        multiplier,
      ]) => {
        const substr = str.match(new RegExp(`[0-9]+\\s*${identifier}`))?.[0];
        if (substr) {
          const value = Number(substr.match(/[0-9]+/));
          result += value * multiplier;
        }
      });
      return result;
    },
  },
  async run({ $ }) {
    const {
      operation, duration, outputFormat,
    } = this;
    const dateObj = this.getDateFromInput();
    const value = dateObj.valueOf();
    let amount = this.getOperationMilliseconds(duration);
    if (operation === OPERATION_OPTIONS.SUBTRACT)
      amount *= -1;
    const result = value + amount;
    const format = outputFormat ?? this.inputFormat ?? DEFAULT_FORMAT_VALUE;
    try {
      const { outputFn } = DATE_FORMAT_PARSE_MAP.get(format);
      const output = outputFn(sugar.Date.create(result));
      $.export("$summary", `Successfully ${operation === OPERATION_OPTIONS.SUBTRACT
        ? "subtracted"
        : "added"} time`);
      return output;
    }
    catch (err) {
      console.log("Error parsing date", err);
      throw new ConfigurationError("**Parse error** - check your input and if the selected format is correct.");
    }
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Pipedream Utils	`pipedream_utils`	`app`	This component uses the Pipedream Utils app.
Input Date	`inputDate`	`string`	A valid date string, in the format selected in Input Format. If the format is not set, Pipedream will attempt to infer it using the parser from Sugar Date library
Input Format	`inputFormat`	`string`	Select a value from the drop down menu:`Sun Jan 22 23:04:05 +0000 2006January 22 2006 23:04:05January 22 2006Jan 22 20062006-01-22T23:04:052006-01-22T23:04:05+00002006-01-22 23:04:05 +00002006-01-22 23:042006-01-2201-22-200601/22/200601/22/0622-01-200622/01/200622/01/06Unix time (seconds) Eg. 1137971045Unix time (milliseconds) Eg. 1137971045000`
Operation	`operation`	`string`	Select a value from the drop down menu:`AddSubtract`
Duration	`duration`	`string`	The duration for the operation. You can use the shorthand duration, for example: `1s`, `1m`, `1h`, `1d`, `1w`, `1y` equal one second, minute, hour, day, week, and year respectively
Output Format	`outputFormat`	`string`	Select a value from the drop down menu:`Sun Jan 22 23:04:05 +0000 2006January 22 2006 23:04:05January 22 2006Jan 22 20062006-01-22T23:04:052006-01-22T23:04:05+00002006-01-22 23:04:05 +00002006-01-22 23:042006-01-2201-22-200601/22/200601/22/0622-01-200622/01/200622/01/06Unix time (seconds) Eg. 1137971045Unix time (milliseconds) Eg. 1137971045000`