SEsevdesk
Invoice

Book an invoice

Changed on

Booking the invoice with a transaction is probably the most important part in the bookkeeping process.<br> There are several ways on correctly booking an invoice, all by using the same endpoint.<br> for more information look <a href='#tag/Invoice/How-to-book-an-invoice'>here</a>.

put/Invoice/{invoiceId}/bookAmount

Request

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

Path parameters

invoiceIdinteger required

ID of invoice to book

Request body

amountnumber required

Amount which should be booked. Can also be a partial amount.

dateinteger required

The booking date. Most likely the current date.

type'FULL_PAYMENT' | 'N' | 'CB' | 'CF' | 'O' | 'OF' | 'MTC' required

Define a type for the booking.<br> The following type abbreviations are available (abbreviation <-> meaning).<br> <ul>

<li>FULL_PAYMENT <-> Normal booking</li><li>N <-> Partial booking (historically used for normal booking)</li> <li>CB <-> Reduced amount due to discount (skonto)</li> <li>CF <-> Reduced/Higher amount due to currency fluctuations (deprecated)</li> <li>O <-> Reduced/Higher amount due to other reasons</li> <li>OF <-> Higher amount due to reminder charges</li> <li>MTC <-> Reduced amount due to the monetary traffic costs</li> </ul>
createFeedboolean

Determines if a feed is created for the booking process.

Example request

{
  "checkAccount": {
    "objectName": "CheckAccount"
  },
  "checkAccountTransaction": {
    "objectName": "CheckAccountTransaction"
  }
}

Response

Successful operation - Returns changed invoice log entry

idstring
objectNamestring
additionalInformationstring
createstring date-time

Date of email creation

fromStatusstring
toStatusstring
ammountPayedstring
bookingDatestring date-time

Example response

{
  "objectName": "InvoiceLog",
  "create": "2023-04-18T15:45:38+02:00",
  "creditNote": {
    "id": 2,
    "objectName": "Invoice"
  },
  "bookingDate": "2023-04-18T15:45:38+02:00",
  "sevClient": {
    "id": 1,
    "objectName": "SevClient"
  }
}

Changes