We have noticed that some of our validations for orders, invoices, vouchers and credit notes are returning a HTTP status code of 500 instead of 422. This is a bug that will be addressed. Status Quo: Some validation errors return a HTTP status code of 500. Future: All validation errors will return a HTTP status code of 422. Affected endpoints: All PUT / POST endpoints of orders, invoices, vouchers and credit notes.

To better distinguish between open, partially paid and paid invoices we, will introduce a new status. Status Quo: Invoices that are partially paid have the status “Open / Due” (200). Future: Invoices that are partially paid will have the status “Partially paid” (750). This change is backward compatible. This means that the endpoint GET /api/v1/Invoice/{invoiceId}/getIsPartiallyPaid will still return true for invoices with the status “Open / Due” (200) that already have transactions.

In the future, we will provide our customers with more guidance and help them to avoid error in their accounting. To this end, we are introducing fundamental changes to our software, which will take the form of a major update. In addition, new functions will be made available that offer our customers even more insights & therefore opportunities for their company. In the documents linked below we will focus on the changes of the sevDesk-Update 2.

It will no longer be possible to change the status of invoices and credit notes manually. Instead, the respective endpoints must be used. Status Quo: Invoice: It is possible to create an invoice with a status other than “Draft” (100) via /api/v1/Invoice/Factory/saveInvoice It is possible to reset or elevate the status of an invoice e.g. to “Open” (200) or “Paid” (1000) via /api/v1/Invoice/Factory/saveInvoice or /api/v1/Invoice/{invoiceId}/changeStatus Credit note: It is possible to create a credit note with a status other than “Draft” (100) via /api/v1/CreditNote/Factory/saveCreditNote It is possible to reset or elevate the status of a credit note e.

Saving proposals (aka estimates) / orders / delivery notes with a negative total will result in a validation exception. This is necessary so that the resulting invoices can be booked correctly. Status Quo: Proposals (aka estimates) / orders / delivery notes with a negative total are valid. Future: Proposals (aka estimates) / orders / delivery notes with a negative total are invalid. Affected endpoint: /api/v1/Order/Factory/saveOrder Release: 14.11.2023 (4.167)

Status Quo: The invoice date of a final invoice can be earlier than the date of an associated partial invoice. Future: The invoice date of a final invoice must be on the same day or later than the highest date of the associated partial invoices. Affected endpoints: POST /api/v1/Voucher/Factory/saveInvoice/ If you want to create invoices from orders you should use POST /api/v1/Invoice/Factory/createInvoiceFromOrder Release: 05.09.2023 (4.162)

Vouchers will be validated more strongly in the future. The endpoint affected is /api/v1/Voucher/Factory/saveVoucher/ Validation can be tested during a transition period using the HTTP header X-Version: 1.1. Status Quo: Many inputs are accepted via the API that are not correct from an accounting point of view. Invalid values are accepted and mandatory information that is required for correct accounting is missing. Future: Validation and error message in case of invalid input based on API documentation.

The Doc Server (docreactor.sevdesk.de), which can be used to generate PDFs for invoices among other things, will no longer be directly accessible. Status Quo: PDF files can be generated using the Doc Server via docreactor.sevdesk.de. Future: The Doc Server (docreactor.sevdesk.de) will no longer be accessible. Instead, PDFs can be generated using the documented API endpoints. For example, see the endpoints below: https://api.sevdesk.de/#tag/Invoice/operation/invoiceGetPdf https://api.sevdesk.de/#tag/Layout/operation/updateInvoiceTemplate Release: 24.07.2023 (4.

The creation of documents without positions will no longer be allowed in the future. This concerns the creation of these new documents: Offers - Estimate / Proposal order_type = 'AN' Orders - Order confirmation order_type = 'AB' Delivery notes order_type = 'LI' Credit notes This is mandatory to create a correct accounting entry and to guarantee clean data in the export. The following endpoints are affected: /api/v1/CreditNote/Factory/saveCreditNote creditNotePosSave must contain at least one item when creating new credit notes.