---
title: "Send order via email"
method: POST
path: "/Order/{orderId}/sendViaEmail"
tags: ["Order"]
---

# Send order via email

`POST /Order/{orderId}/sendViaEmail`

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

## Path parameters

- `orderId` 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 ','

## Response `201`

Created - Returns created mail object

- object
  - `objects` ModelEmailOrder[]
    - `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` ModelOrderResponse — Order model
      - `id` string — The order id
      - `objectName` string — The order object name
      - `create` string, date-time — Date of order creation
      - `update` string, date-time — Date of last order update
      - `orderNumber` string — The order number
      - `contact` object — The contact used in the order
        - `id` string, required — Unique identifier of the contact
        - `objectName` string, required — Model name, which is 'Contact'
      - `orderDate` string, date-time — Needs to be provided as timestamp or dd.mm.yyyy
      - `status` '100' | '200' | '300' | '500' | '750' | '1000' — Please have a look in <a href='#tag/Order/Types-and-status-of-orders'>status of orders</a> to see what the different status codes mean
      - `header` string — Normally consist of prefix plus the order number
      - `headText` string, nullable — Certain html tags can be used here to format your text
      - `footText` string, nullable — Certain html tags can be used here to format your text
      - `addressCountry` object, nullable — 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'
      - `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'
      - `sevClient` object — Client to which order belongs. Will be filled automatically
        - `id` string, required — Unique identifier of the client
        - `objectName` string, required — Model name, which is 'SevClient'
      - `deliveryTerms` string, nullable — Delivery terms of the order
      - `paymentTerms` string, nullable — Payment terms of the order
      - `origin` object, nullable — Object from which the order was created. For example an offer.
        - `id` string, required — Unique identifier of the object
        - `objectName` string, required — Model name of the object. Could be 'Order'.
      - `version` string — Version of the order.<br> Can be used if you have multiple drafts for the same order.<br> Should start with 0
      - `smallSettlement` boolean — Defines if the client uses the small settlement scheme. If yes, the order must not contain any vat
      - `contactPerson` object — The user who acts as a contact person for the order
        - `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
      - `taxSet` object, nullable — **Use this in sevdesk-Update 1.0 (instead of taxRule).** Tax set of the order. 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'
      - `taxText` string — A common tax text would be 'Umsatzsteuer 19%'
      - `taxType` string — **Use this in sevdesk-Update 1.0 (instead of taxRule).** Tax type of the order. 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.
      - `orderType` 'AN' | 'AB' | 'LI' — Type of the order. For more information on the different types, check <a href='#tag/Order/Types-and-status-of-orders'>this</a>
      - `sendDate` string, date-time, nullable — The date the order was sent to the customer
      - `address` string, nullable — Complete address of the recipient including name, street, city, zip and country.<br> Line breaks can be used and will be displayed on the invoice pdf.
      - `currency` string — Currency used in the order. Needs to be currency code according to ISO-4217
      - `sumNet` string — Net sum of the order
      - `sumTax` string — Tax sum of the order
      - `sumGross` string — Gross sum of the order
      - `sumDiscounts` string — Sum of all discounts in the order
      - `sumNetForeignCurrency` string — Net sum of the order in the foreign currency
      - `sumTaxForeignCurrency` string — Tax sum of the order in the foreign currency
      - `sumGrossForeignCurrency` string — Gross sum of the order in the foreign currency
      - `sumDiscountsForeignCurrency` string — Discounts sum of the order in the foreign currency
      - `customerInternalNote` string, nullable — 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 order. Otherwise gross amount
      - `sendType` 'VPR' | 'VPDF' | 'VM' | 'VP', nullable — Type which was used to send the order. IMPORTANT: Please refer to the order section of the * API-Overview to understand how this attribute can be used before using it!
    - `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)