--- title: "Send invoice via email" method: POST path: "/Invoice/{invoiceId}/sendViaEmail" tags: ["Invoice"] --- # Send invoice via email `POST /Invoice/{invoiceId}/sendViaEmail` This endpoint sends the specified invoice to a customer via email.
This will automatically mark the invoice as sent.
Please note, that in production an invoice is not allowed to be changed after this happened! ## Path parameters - `invoiceId` integer, required ## Request body - object - `toEmail` string, required — The recipient of the email. - `subject` string, required — The subject of the email. - `text` string, required — The text of the email. Can contain html. - `copy` boolean — Should a copy of this email be sent to you? - `additionalAttachments` string — Additional attachments to the mail. String of IDs of existing documents in your * sevdesk account separated by ',' - `ccEmail` string — String of mail addresses to be put as cc separated by ',' - `bccEmail` string — String of mail addresses to be put as bcc separated by ',' - `sendXml` boolean — If true, the XML of the e-invoice is attached to the email instead of the PDF ## Response `201` Created - Returns created mail object - ModelEmail — Email model - `id` integer — The email id - `objectName` string — The email object name - `create` string, date-time — Date of mail creation - `update` string, date-time — Date of last mail update - `object` ModelInvoiceResponse — Invoice model - `id` string — The invoice id - `objectName` string — The invoice object name - `invoiceNumber` string — The invoice number - `contact` object — The contact used in the invoice - `id` string, required — Unique identifier of the contact - `objectName` string, required — Model name, which is 'Contact' - `create` string, date-time — Date of invoice creation - `update` string, date-time — Date of last invoice update - `sevClient` object — Client to which invoice belongs. Will be filled automatically - `id` string, required — Unique identifier of the client - `objectName` string, required — Model name, which is 'SevClient' - `invoiceDate` string — The invoice date. - `header` string — Normally consist of prefix plus the invoice number - `headText` string — Certain html tags can be used here to format your text - `footText` string — Certain html tags can be used here to format your text - `timeToPay` string — The time the customer has to pay the invoice in days - `discountTime` string — If a value other than zero is used for the discount attribute, you need to specify the amount of days for which the discount is granted. - `discount` string — If you want to give a discount, define the percentage here. Otherwise provide zero as value - `addressCountry` object — Can be omitted as complete address is defined in address attribute - `id` string, required — Unique identifier of the country - `objectName` string, required — Model name, which is 'StaticCountry' - `payDate` string, date-time — Needs to be timestamp or dd.mm.yyyy - `createUser` object — Will be filled automatically by our system and can't be changed - `id` string, required — Unique identifier of the user - `objectName` string, required — Model name, which is 'SevUser' - `deliveryDate` string, date-time — Timestamp. This can also be a date range if you also use the attribute deliveryDateUntil - `status` '50' | '100' | '200' | '750' | '1000' — Please have a look in our Types and status of invoices to see what the different status codes mean - `smallSettlement` boolean — Defines if the client uses the small settlement scheme. If yes, the invoice must not contain any vat - `contactPerson` object — The user who acts as a contact person for the invoice - `id` string, required — Unique identifier of the user - `objectName` string, required — Model name, which is 'SevUser' - `taxRate` string — This is not used anymore. Use the taxRate of the individual positions instead. - `taxRule` object — **Use this in sevdesk-Update 2.0 (replaces taxType / taxSet).** See [list of available VAT rules](#section/sevdesk-Update-2.0/Tax-Rules). - `id` '1' | '2' | '3' | '4' | '5' | '11' | '17' | '18' | '19' | '20' | '21', required - `objectName` 'TaxRule', required — Name of the object. Must always be TaxRule - `taxText` string — A common tax text would be 'Umsatzsteuer 19%' - `dunningLevel` string — Defines how many reminders have already been sent for the invoice. Starts with 1 (Payment reminder) and should be incremented by one every time another reminder is sent. - `taxType` 'default' | 'eu' | 'noteu' | 'custom' — **Use this in sevdesk-Update 1.0 (instead of taxRule).** Tax type of the invoice. There are four tax types: 1. default - Umsatzsteuer ausweisen 2. eu - Steuerfreie innergemeinschaftliche Lieferung (Europäische Union) 3. noteu - Steuerschuldnerschaft des Leistungsempfängers (außerhalb EU, z. B. Schweiz) 4. custom - Using custom tax set 5. ss - Not subject to VAT according to §19 1 UStG Tax rates are heavily connected to the tax type used. - `paymentMethod` object — Payment method used for the invoice - `id` string, required — Unique identifier of the payment method - `objectName` string, required — Model name, which is 'PaymentMethod' - `costCentre` object — Cost centre for the invoice - `id` string, required — Unique identifier of the cost centre - `objectName` string, required — Model name, which is 'CostCentre' - `sendDate` string, date-time — The date the invoice was sent to the customer - `origin` object — Origin of the invoice. Could f.e. be an order - `id` string, required — Unique identifier of the object - `objectName` string, required — Model name. Could f.e. be 'Order'' - `invoiceType` 'RE' | 'WKR' | 'SR' | 'MA' | 'TR' | 'AR' | 'ER' — Type of the invoice. For more information on the different types, check this section - `accountIntervall` string — The interval in which recurring invoices are due as ISO-8601 duration.
Necessary attribute for all recurring invoices. - `accountNextInvoice` string — Timestamp when the next invoice will be generated by this recurring invoice. - `reminderTotal` string — Total reminder amount - `reminderDebit` string — Debit of the reminder - `reminderDeadline` string, date-time — Deadline of the reminder as timestamp - `reminderCharge` string — The additional reminder charge - `taxSet` object — **Use this in sevdesk-Update 1.0 (instead of taxRule).** Tax set of the invoice. Needs to be added if you chose the tax type custom - `id` string, required — Unique identifier of the object - `objectName` string, required — Model name, which is 'TaxSet' - `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. - `currency` string — Currency used in the invoice. Needs to be currency code according to ISO-4217 - `sumNet` string — Net sum of the invoice - `sumTax` string — Tax sum of the invoice - `sumGross` string — Gross sum of the invoice - `sumDiscounts` string — Sum of all discounts in the invoice - `sumNetForeignCurrency` string — Net sum of the invoice in the foreign currency - `sumTaxForeignCurrency` string — Tax sum of the invoice in the foreign currency - `sumGrossForeignCurrency` string — Gross sum of the invoice in the foreign currency - `sumDiscountsForeignCurrency` string — Discounts sum of the invoice in the foreign currency - `sumNetAccounting` string — Net accounting sum of the invoice. Is usually the same as sumNet - `sumTaxAccounting` string — Tax accounting sum of the invoice. Is usually the same as sumTax - `sumGrossAccounting` string — Gross accounting sum of the invoice. Is usually the same as sumGross - `paidAmount` number, float — Amount which has already been paid for this invoice by the customer - `customerInternalNote` string — Internal note of the customer. Contains data entered into field 'Referenz/Bestellnummer' - `showNet` boolean — If true, the net amount of each position will be shown on the invoice. Otherwise gross amount - `enshrined` string, date-time — Enshrined invoices cannot be changed. Can only be set via [Invoice/{invoiceId}/enshrine](#tag/Invoice/operation/invoiceEnshrine). This operation cannot be undone. - `sendType` 'VPR' | 'VPDF' | 'VM' | 'VP' — Type which was used to send the invoice. IMPORTANT: Please refer to the invoice section of the * API-Overview to understand how this attribute can be used before using it! - `deliveryDateUntil` 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. - `datevConnectOnline` object — Internal attribute - `sendPaymentReceivedNotificationDate` string — Internal attribute - `from` string, required — The sender of the email - `to` string, required — The recipient of the email - `subject` string, required — The subject of the email - `text` string, nullable — The text of the email - `sevClient` object — Client to which mail belongs. Will be filled automatically - `id` integer, required — Unique identifier of the client - `objectName` string, required — Model name, which is 'SevClient' - `cc` string, nullable — A list of mail addresses which are in the cc - `bcc` string, nullable — A list of mail addresses which are in the bcc - `arrived` string, date-time, nullable — Date the mail arrived ## Other responses - `400` — Bad request - `401` — Authentication required - `500` — Server Error --- [API](https://skmtc.net/sevdesk/apis/sevdesk-api.md) · [All operations](https://skmtc.net/sevdesk/apis/sevdesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sevdesk/sevdesk-api/revisions/a32cec0fecea/schema)