View as Markdown
sevDesk icon

sevDesk ACTION

Create Invoice

Creates a new invoice with optional details like invoice date, due date, discount amount, and invoice items. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's sevDesk account once, then configure and run Create Invoice from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "sevdesk-create-invoice",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    sevdesk: { authProvisionId: "apn_xxxxxxx" },
    invoiceNumber: "Invoice Number",
    contactId: "Contact ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Invoice inputs
Property Type Description
invoiceNumber Invoice Number string
The invoice number
Optional
contactId Contact ID string
The ID of the contact for the invoice.
Required Dynamic
invoiceDate Invoice Date string
Needs to be provided as timestamp or dd.mm.yyyy
Required
header Header string
Normally consist of prefix plus the invoice number.
Optional
headText Head Text string
Certain html tags can be used here to format your text.
Optional
footText Foot Text string
Certain html tags can be used here to format your text.
Optional
timeToPay Time To Pay integer
The time the customer has to pay the invoice in days.
Optional
discount Discount integer
If you want to give a discount, define the percentage here. Otherwise provide zero as value.
Required
address Address string
Complete address of the recipient including name, street, city, zip and country. * Line breaks can be used and will be displayed on the invoice pdf.
Optional
addressCountryId Address Country ID string
Can be omitted as complete address is defined in address attribute.
Required Dynamic
payDate Pay Date string
Needs to be timestamp or dd.mm.yyyy.
Optional
deliveryDate Delivery Date string
Timestamp. This can also be a date range if you also use Delivery Date Until.
Optional
deliveryDateUntil Delivery Date Until string
If the delivery date should be a time range, another timestamp can be provided in this attribute * to define a range from timestamp used in deliveryDate attribute to the timestamp used here.
Optional
status Status string
Please have a look in Sevdesk's Types and status of invoices to see what the different status codes mean.
Required
smallSettlement Small Settlement boolean
Defines if the client uses the small settlement scheme. If yes, the invoice must not contain any vat.
Optional
taxRate Tax Rate string
Is overwritten by invoice position tax rates.
Required
taxText Tax Text string
A common tax text would be 'Tax 19%'.
Required
taxType Tax Type string
Tax type of the invoice.
Required
taxSetId Tax Set Id string
Tax set of the invoice. Needs to be added if you chose the tax type custom.
Optional Dynamic
paymentMethodId Payment Method Id string
Payment method used for the invoice.
Optional Dynamic
sendDate Send Date string
The date the invoice was sent to the customer.
Optional
invoiceType Invoice Type string
Type of the invoice. For more information on the different types, check this section
Required
currency Currency string
Currency used in the invoice. Needs to be currency code according to ISO-4217.
Required
showNet Show Net boolean
If true, the net amount of each position will be shown on the invoice. Otherwise gross amount.
Optional
sendType Send Type string
Type which was used to send the invoice.
Optional
originId Origin Id string
The Id of the order.
Optional Dynamic
customerInternalNote Customer Internal Note string
Internal note of the customer. Contains data entered into field 'Referenz/Bestellnummer'.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
sevdesk-create-invoice
Version
0.0.3
App
sevDesk
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes