Create Voucher with E-conomic API on New Download Counts from npm API

Pipedream makes it easy to connect APIs for E-conomic, npm and 3,000+ other apps remarkably fast.

Trigger workflow on

New Download Counts from the npm API

Next, do this

Create Voucher with the E-conomic 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 npm trigger and E-conomic action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Download Counts trigger
1. Connect your npm account
2. Configure timer
3. Select a Period
4. Optional- Configure Package
Configure the Create Voucher action
1. Connect your E-conomic account
2. Select a Journal Number
3. Configure Accounting Year
4. Configure Customer Payment Amount
5. Configure Customer Payment Date
6. Configure Finance Voucher Amount
7. Configure Finance Voucher Date
8. Configure Manual Customer Invoice Amount
9. Configure Manual Customer Invoice Date
10. Configure Supplier Invoice Amount
11. Configure Supplier Invoice Date
12. Configure Supplier Payment Amount
13. Configure Supplier Payment Date
14. Optional- Select a Supplier Number
15. Optional- Select a Customer Number
16. Optional- Select a Currency Code
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 Download Counts on npm

Description:Emit new event with the latest count of downloads for an npm package. [See the documentation](https://github.com/npm/registry/blob/main/docs/download-counts.md).

Version:0.1.0

Key:npm-download-counts

View on GitHub

Trigger Code#

import app from "../../npm.app.mjs";

export default {
  key: "npm-download-counts",
  name: "New Download Counts",
  description: "Emit new event with the latest count of downloads for an npm package. [See the documentation](https://github.com/npm/registry/blob/main/docs/download-counts.md).",
  version: "0.1.0",
  type: "source",
  props: {
    app,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      description: "One day interval time is recommended because NPM only update metrics once a day. [See the documentation](https://github.com/npm/registry/blob/main/docs/download-counts.md#data-source).",
      default: {
        intervalSeconds: 60 * 60 * 24,
      },
    },
    period: {
      type: "string",
      label: "Period",
      description: "Select last-day, last-week or last-month.",
      optional: false,
      default: "last-day",
      options: [
        "last-day",
        "last-week",
        "last-month",
      ],
    },
    packageName: {
      type: "string",
      label: "Package",
      description: "Enter an npm package name. Leave blank for all",
      optional: true,
    },
  },
  methods: {
    getDownloadCounts({
      period, packageName, ...args
    } = {}) {
      const basePath = `/downloads/point/${encodeURIComponent(period)}`;
      return this.app.makeRequest({
        path: packageName
          ? `${basePath}/${encodeURIComponent(packageName)}`
          : basePath,
        ...args,
      });
    },
  },
  async run({ timestamp: ts }) {
    const {
      getDownloadCounts,
      period,
      packageName,
    } = this;

    const response = await getDownloadCounts({
      period,
      packageName,
    });

    this.$emit(response, {
      id: ts,
      summary: `New Download Count ${response.downloads}`,
      ts,
    });
  },
};

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
npm	`app`	`app`	This component uses the npm app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`	One day interval time is recommended because NPM only update metrics once a day. See the documentation
Period	`period`	`string`	Select a value from the drop down menu:`last-daylast-weeklast-month`
Package	`packageName`	`string`	Enter an npm package name. Leave blank for all

Trigger Authentication#

The npm API does not require authentication.

About npm#

Node package manager

Action#

Create Voucher on E-conomic

Description:Creates a new voucher. [See the documentation](https://restdocs.e-conomic.com/#get-journals-journalnumber-vouchers)

Version:0.0.1

Key:e_conomic-create-voucher

View on GitHub

E-conomic Overview#

The E-conomic API allows for the automation of accounting tasks, enabling seamless integration of financial data into custom workflows. With Pipedream's capability to connect to the E-conomic API, you can trigger actions based on invoice creation, update financial records in real-time, and sync data across various business tools. By harnessing this API, businesses can streamline their financial processes, reduce manual data entry, and gain clearer insights into their financial health.

Action Code#

import economic from "../../e_conomic.app.mjs";

export default {
  key: "e_conomic-create-voucher",
  name: "Create Voucher",
  description: "Creates a new voucher. [See the documentation](https://restdocs.e-conomic.com/#get-journals-journalnumber-vouchers)",
  version: "0.0.1",
  type: "action",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  props: {
    economic,
    journalNumber: {
      propDefinition: [
        economic,
        "journalNumber",
      ],
    },
    accountingYear: {
      type: "string",
      label: "Accounting Year",
      description: "The accounting year of the voucher",
    },
    customerPaymentAmount: {
      type: "string",
      label: "Customer Payment Amount",
      description: "The amount of the customer payment",
    },
    customerPaymentDate: {
      type: "string",
      label: "Customer Payment Date",
      description: "The date of the customer payment",
    },
    financeVoucherAmount: {
      type: "string",
      label: "Finance Voucher Amount",
      description: "The amount of the finance voucher",
    },
    financeVoucherDate: {
      type: "string",
      label: "Finance Voucher Date",
      description: "The date of the finance voucher",
    },
    manualCustomerInvoiceAmount: {
      type: "string",
      label: "Manual Customer Invoice Amount",
      description: "The amount of the manual customer invoice",
    },
    manualCustomerInvoiceDate: {
      type: "string",
      label: "Manual Customer Invoice Date",
      description: "The date of the manual customer invoice",
    },
    supplierInvoiceAmount: {
      type: "string",
      label: "Supplier Invoice Amount",
      description: "The amount of the supplier invoice",
    },
    supplierInvoiceDate: {
      type: "string",
      label: "Supplier Invoice Date",
      description: "The date of the supplier invoice",
    },
    supplierPaymentAmount: {
      type: "string",
      label: "Supplier Payment Amount",
      description: "The amount of the supplier payment",
    },
    supplierPaymentDate: {
      type: "string",
      label: "Supplier Payment Date",
      description: "The date of the supplier payment",
    },
    supplierNumber: {
      propDefinition: [
        economic,
        "supplierNumber",
      ],
      optional: true,
    },
    customerNumber: {
      propDefinition: [
        economic,
        "customerNumber",
      ],
      optional: true,
    },
    currencyCode: {
      propDefinition: [
        economic,
        "currencyCode",
      ],
      optional: true,
    },
  },
  async run({ $ }) {
    const response = await this.economic.createVoucher({
      $,
      journalNumber: this.journalNumber,
      data: {
        accountingYear: {
          year: this.accountingYear,
        },
        entries: {
          customerPayments: [
            {
              amount: this.customerPaymentAmount,
              date: this.customerPaymentDate,
              customer: this.customerNumber
                ? {
                  customerNumber: this.customerNumber,
                }
                : undefined,
              currency: this.currencyCode
                ? {
                  code: this.currencyCode,
                }
                : undefined,
            },
          ],
          financeVouchers: [
            {
              amount: this.financeVoucherAmount,
              date: this.financeVoucherDate,
              currency: this.currencyCode
                ? {
                  code: this.currencyCode,
                }
                : undefined,
            },
          ],
          manualCustomerInvoices: [
            {
              amount: this.manualCustomerInvoiceAmount,
              date: this.manualCustomerInvoiceDate,
              customer: this.customerNumber
                ? {
                  customerNumber: this.customerNumber,
                }
                : undefined,
              currency: this.currencyCode
                ? {
                  code: this.currencyCode,
                }
                : undefined,
            },
          ],
          supplierInvoices: [
            {
              amount: this.supplierInvoiceAmount,
              date: this.supplierInvoiceDate,
              supplier: this.supplierNumber
                ? {
                  supplierNumber: this.supplierNumber,
                }
                : undefined,
              currency: this.currencyCode
                ? {
                  code: this.currencyCode,
                }
                : undefined,
            },
          ],
          supplierPayments: [
            {
              amount: this.supplierPaymentAmount,
              date: this.supplierPaymentDate,
              supplier: this.supplierNumber
                ? {
                  supplierNumber: this.supplierNumber,
                }
                : undefined,
              currency: this.currencyCode
                ? {
                  code: this.currencyCode,
                }
                : undefined,
            },
          ],
        },
      },
    });
    $.export("$summary", "Successfully created voucher.");
    return response;
  },
};

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
E-conomic	`economic`	`app`	This component uses the E-conomic app.
Journal Number	`journalNumber`	`integer`	Select a value from the drop down menu.
Accounting Year	`accountingYear`	`string`	The accounting year of the voucher
Customer Payment Amount	`customerPaymentAmount`	`string`	The amount of the customer payment
Customer Payment Date	`customerPaymentDate`	`string`	The date of the customer payment
Finance Voucher Amount	`financeVoucherAmount`	`string`	The amount of the finance voucher
Finance Voucher Date	`financeVoucherDate`	`string`	The date of the finance voucher
Manual Customer Invoice Amount	`manualCustomerInvoiceAmount`	`string`	The amount of the manual customer invoice
Manual Customer Invoice Date	`manualCustomerInvoiceDate`	`string`	The date of the manual customer invoice
Supplier Invoice Amount	`supplierInvoiceAmount`	`string`	The amount of the supplier invoice
Supplier Invoice Date	`supplierInvoiceDate`	`string`	The date of the supplier invoice
Supplier Payment Amount	`supplierPaymentAmount`	`string`	The amount of the supplier payment
Supplier Payment Date	`supplierPaymentDate`	`string`	The date of the supplier payment
Supplier Number	`supplierNumber`	`integer`	Select a value from the drop down menu.
Customer Number	`customerNumber`	`integer`	Select a value from the drop down menu.
Currency Code	`currencyCode`	`string`	Select a value from the drop down menu.

Action Authentication#

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

To retrieve your API tokens,

Navigate to your E-conomic account and sign in
Create a app under “Apps” to get your AppSecretToken
Follow the installationURL to get your AgreementGrantToken
To see more details, please see Connecting to the APIs using tokens