SEsevdesk
Invoice

Send invoice via email

Changed on

This endpoint sends the specified invoice to a customer via email.<br> This will automatically mark the invoice as sent.<br> Please note, that in production an invoice is not allowed to be changed after this happened!

post/Invoice/{invoiceId}/sendViaEmail

Request

  • Base URL
    https://my.sevdesk.de/api/v1
  • Auth
    API key in header Authorization

Path parameters

invoiceIdinteger required

ID of invoice to be sent via email

Request body

toEmailstring required

The recipient of the email.

subjectstring required

The subject of the email.

textstring required

The text of the email. Can contain html.

copyboolean

Should a copy of this email be sent to you?

additionalAttachmentsstring

Additional attachments to the mail. String of IDs of existing documents in your * sevdesk account separated by ','

ccEmailstring

String of mail addresses to be put as cc separated by ','

bccEmailstring

String of mail addresses to be put as bcc separated by ','

sendXmlboolean

If true, the XML of the e-invoice is attached to the email instead of the PDF

Response

Created - Returns created mail object

idinteger

The email id

objectNamestring

The email object name

createstring date-time

Date of mail creation

updatestring date-time

Date of last mail update

fromstring required

The sender of the email

tostring required

The recipient of the email

subjectstring required

The subject of the email

textstring nullable

The text of the email

ccstring nullable

A list of mail addresses which are in the cc

bccstring nullable

A list of mail addresses which are in the bcc

arrivedstring date-time nullable

Date the mail arrived

Example response

{
  "create": "01.01.2020",
  "update": "01.01.2020",
  "object": {
    "id": "1",
    "objectName": "Invoice",
    "invoiceNumber": "RE-1000",
    "contact": {
      "id": "1",
      "objectName": "Contact"
    },
    "create": "2024-04-08T00:00:00+02:00",
    "update": "2024-04-08T00:00:00+02:00",
    "sevClient": {
      "id": "1",
      "objectName": "SevClient"
    },
    "invoiceDate": "2024-04-08T00:00:00+02:00",
    "header": "My RE-1000",
    "headText": "header information",
    "footText": "footer information",
    "timeToPay": "10",
    "discountTime": "0",
    "discount": "0",
    "addressCountry": {
      "id": "1",
      "objectName": "StaticCountry"
    },
    "payDate": "2024-04-08T00:00:00+02:00",
    "createUser": {
      "id": "1",
      "objectName": "SevUser"
    },
    "deliveryDate": "2024-04-08T00:00:00+02:00",
    "status": "100",
    "contactPerson": {
      "id": "1",
      "objectName": "SevUser"
    },
    "taxRate": "0",
    "taxText": "Umsatzsteuer 19%",
    "dunningLevel": "0",
    "taxType": "default",
    "paymentMethod": {
      "id": "1",
      "objectName": "PaymentMethod"
    },
    "costCentre": {
      "id": "1",
      "objectName": "CostCentre"
    },
    "sendDate": "2024-04-08T00:00:00+02:00",
    "origin": {
      "id": "1"
    },
    "invoiceType": "RE",
    "accountIntervall": "2022-03-14",
    "accountNextInvoice": "1647259198",
    "reminderTotal": "0",
    "reminderDebit": "0",
    "reminderDeadline": "01.01.2020",
    "reminderCharge": "0",
    "taxSet": {
      "id": "1",
      "objectName": "TaxSet"
    },
    "address": "name\nstreet\npostCode city",
    "currency": "EUR",
    "sumNet": "100",
    "sumTax": "19",
    "sumGross": "119",
    "sumDiscounts": "0",
    "sumNetForeignCurrency": "0",
    "sumTaxForeignCurrency": "0",
    "sumGrossForeignCurrency": "0",
    "sumDiscountsForeignCurrency": "0",
    "sumNetAccounting": "0",
    "sumTaxAccounting": "0",
    "sumGrossAccounting": "0",
    "enshrined": "2024-04-08T00:00:00+02:00",
    "deliveryDateUntil": "2024-04-08T00:00:00+02:00",
    "sendPaymentReceivedNotificationDate": "0"
  },
  "arrived": "01.01.2020"
}

Changes

  • a32cec0feceaRevision changes
    • warning

      added the new 17 enum value to the // response property for the response status

    • warning

      added the new 18 enum value to the // response property for the response status

    • warning

      added the new 19 enum value to the // response property for the response status

    • warning

      added the new 20 enum value to the // response property for the response status

    • warning

      added the new 21 enum value to the // response property for the response status

    • warning

      added the new AR enum value to the / response property for the response status

    • info

      added the new optional request property

  • a12897a73d08Revision changes
    • warning

      added the new 750 enum value to the / response property for the response status

    • info

      added the optional property / to the response with the status