Create Invoice with Fortnox API

Pipedream makes it easy to connect APIs for Fortnox and 3,000+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Create Invoice with the Fortnox 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#

Create a workflow to Create Invoice with the Fortnox API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Create Invoice action
1. Connect your Fortnox account
2. Select a Customer Number
3. Optional- Configure Address 1
4. Optional- Configure Address 2
5. Optional- Configure City
6. Optional- Configure Postal Code
7. Optional- Configure Country
8. Optional- Configure Due Date
9. Optional- Configure Invoice Rows
10. Optional- Select a Type
11. Optional- Configure Email Address From
12. Optional- Configure Email Address To
13. Optional- Configure Email Subject
14. Optional- Configure Email Body
15. Optional- Configure Freight
16. Optional- Configure Terms of Delivery
17. Optional- Configure Terms of Payment
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Integrations#

Create Invoice with Fortnox API on New Requests (Payload Only) from HTTP / Webhook API

HTTP / Webhook + Fortnox

Try it

Create Invoice with Fortnox API on New Submission from Typeform API

Typeform + Fortnox

Try it

Create Invoice with Fortnox API on New Submission (Instant) from Jotform API

Jotform + Fortnox

Try it

Create Invoice with Fortnox API on New Download Counts from npm API

npm + Fortnox

Try it

Create Invoice with Fortnox API on New Activity Created Event from Strava API

Strava + Fortnox

Try it

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is 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.

Create Invoice on Fortnox

Description:Creates a new invoice in the Fortnox API. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Invoices/operation/create_23).

Version:0.0.1

Key:fortnox-create-invoice

View on GitHub

Code#

import fortnox from "../../fortnox.app.mjs";
import { parseObject } from "../../common/utils.mjs";

export default {
  key: "fortnox-create-invoice",
  name: "Create Invoice",
  description: "Creates a new invoice in the Fortnox API. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Invoices/operation/create_23).",
  version: "0.0.1",
  type: "action",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  props: {
    fortnox,
    customerNumber: {
      propDefinition: [
        fortnox,
        "customerNumber",
      ],
    },
    address1: {
      propDefinition: [
        fortnox,
        "address1",
      ],
    },
    address2: {
      propDefinition: [
        fortnox,
        "address2",
      ],
    },
    city: {
      propDefinition: [
        fortnox,
        "city",
      ],
    },
    zipCode: {
      propDefinition: [
        fortnox,
        "zipCode",
      ],
    },
    country: {
      propDefinition: [
        fortnox,
        "country",
      ],
    },
    dueDate: {
      type: "string",
      label: "Due Date",
      description: "The due date of the invoice",
      optional: true,
    },
    invoiceRows: {
      type: "string[]",
      label: "Invoice Rows",
      description: "An array of invoice row objects. [See the documentation](https://api.fortnox.se/apidocs#tag/fortnox_Invoices/operation/create_23) for invoice row properties.",
      optional: true,
    },
    type: {
      type: "string",
      label: "Type",
      description: "The type of the invoice",
      options: [
        "INVOICE",
        "AGREEMENTINVOICE",
        "INTRESTINVOICE",
        "SUMMARYINVOICE",
        "CASHINVOICE",
      ],
      optional: true,
    },
    emailAddressFrom: {
      type: "string",
      label: "Email Address From",
      description: "The email address to send the invoice from",
      optional: true,
    },
    emailAddressTo: {
      type: "string",
      label: "Email Address To",
      description: "The email address to send the invoice to",
      optional: true,
    },
    emailSubject: {
      type: "string",
      label: "Email Subject",
      description: "The subject of the email",
      optional: true,
    },
    emailBody: {
      type: "string",
      label: "Email Body",
      description: "The body of the email",
      optional: true,
    },
    freight: {
      type: "string",
      label: "Freight",
      description: "The freight of the invoice",
      optional: true,
    },
    termsOfDelivery: {
      type: "string",
      label: "Terms of Delivery",
      description: "The terms of delivery of the invoice",
      optional: true,
    },
    termsOfPayment: {
      type: "string",
      label: "Terms of Payment",
      description: "The terms of payment of the invoice",
      optional: true,
    },
  },
  async run({ $ }) {
    const response = await this.fortnox.createInvoice({
      $,
      data: {
        Invoice: {
          CustomerNumber: this.customerNumber,
          Address1: this.address1,
          Address2: this.address2,
          City: this.city,
          ZipCode: this.zipCode,
          Country: this.country,
          DueDate: this.dueDate,
          InvoiceRows: this.invoiceRows && parseObject(this.invoiceRows),
          InvoiceType: this.type,
          EmailInformation:
            (this.emailAddressFrom || this.emailAddressTo || this.emailSubject || this.emailBody)
            && {
              EmailAddressFrom: this.emailAddressFrom,
              EmailAddressTo: this.emailAddressTo,
              EmailSubject: this.emailSubject,
              EmailBody: this.emailBody,
            },
          Freight: this.freight
            ? +this.freight
            : undefined,
          TermsOfDelivery: this.termsOfDelivery,
          TermsOfPayment: this.termsOfPayment,
        },
      },
    });
    $.export("$summary", `Successfully created invoice with ID \`${response.Invoice.InvoiceNumber}\``);
    return response;
  },
};

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
Fortnox	`fortnox`	`app`	This component uses the Fortnox app.
Customer Number	`customerNumber`	`string`	Select a value from the drop down menu.
Address 1	`address1`	`string`	The first line of the address
Address 2	`address2`	`string`	The second line of the address
City	`city`	`string`	The city of the address
Postal Code	`zipCode`	`string`	The postal code of the address
Country	`country`	`string`	The country of the address
Due Date	`dueDate`	`string`	The due date of the invoice
Invoice Rows	`invoiceRows`	`string[]`	An array of invoice row objects. See the documentation for invoice row properties.
Type	`type`	`string`	Select a value from the drop down menu:`INVOICEAGREEMENTINVOICEINTRESTINVOICESUMMARYINVOICECASHINVOICE`
Email Address From	`emailAddressFrom`	`string`	The email address to send the invoice from
Email Address To	`emailAddressTo`	`string`	The email address to send the invoice to
Email Subject	`emailSubject`	`string`	The subject of the email
Email Body	`emailBody`	`string`	The body of the email
Freight	`freight`	`string`	The freight of the invoice
Terms of Delivery	`termsOfDelivery`	`string`	The terms of delivery of the invoice
Terms of Payment	`termsOfPayment`	`string`	The terms of payment of the invoice

Authentication#

Fortnox uses OAuth authentication. When you connect your Fortnox account, Pipedream will open a popup window where you can sign into Fortnox and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Fortnox API.

Pipedream requests the following authorization scopes when you connect your account:

articleinvoicecustomerorderpaymentprofile