SEsevdesk
Order

Create a new order

Changed on

Creates an order to which positions can be added later.

post/Order/Factory/saveOrder

Request

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

Request body

Example request

{
  "order": {
    "orderNumber": "Offer-1000",
    "contact": {
      "objectName": "Contact"
    },
    "orderDate": "01.01.2020",
    "status": 100,
    "header": "My Offer-1000",
    "headText": "header information",
    "footText": "footer information",
    "addressCountry": {
      "objectName": "StaticCountry"
    },
    "deliveryTerms": "delivery terms",
    "paymentTerms": "payment terms",
    "contactPerson": {
      "objectName": "SevUser"
    },
    "taxSet": {
      "objectName": "TaxSet"
    },
    "taxText": "Umsatzsteuer 19%",
    "taxType": "default",
    "orderType": "AN",
    "sendDate": "26.07.2022",
    "address": "name\\nstreet\\npostCode city",
    "currency": "EUR",
    "customerInternalNote": "customer internal note",
    "sendType": "VPR"
  },
  "orderPosSave": [
    {
      "order": {
        "objectName": "Order"
      },
      "part": {
        "objectName": "Part"
      },
      "quantity": 1,
      "price": 100,
      "name": "Dragonglass",
      "unity": {
        "objectName": "Unity"
      },
      "positionNumber": 1,
      "taxRate": 19
    }
  ]
}

Response

Created - Returns created voucher

Example response

{
  "order": {
    "id": "0",
    "objectName": "Order",
    "orderNumber": "Offer-1000",
    "contact": {
      "id": "0",
      "objectName": "Contact"
    },
    "orderDate": "01.01.2020",
    "status": "100",
    "header": "My Offer-1000",
    "createUser": {
      "id": "0",
      "objectName": "SevUser"
    },
    "sevClient": {
      "id": "0",
      "objectName": "SevClient"
    },
    "origin": {
      "id": "0",
      "objectName": "Order"
    },
    "version": "0",
    "contactPerson": {
      "id": "0",
      "objectName": "SevUser"
    },
    "taxRate": "0",
    "taxSet": {
      "id": "0",
      "objectName": "TaxSet"
    },
    "taxText": "Umsatzsteuer 19%",
    "taxType": "default",
    "orderType": "AN",
    "currency": "EUR"
  },
  "orderPos": [
    {
      "id": "0",
      "objectName": "OrderPos",
      "create": "01.01.2020",
      "update": "01.01.2020",
      "order": {
        "id": "0",
        "objectName": "Order"
      },
      "part": {
        "id": "0",
        "objectName": "Part"
      },
      "quantity": "1",
      "price": "100",
      "priceNet": "100",
      "priceTax": "19",
      "priceGross": "119",
      "name": "Dragonglass",
      "unity": {
        "id": "0",
        "objectName": "Unity"
      },
      "sevClient": {
        "id": "0"
      },
      "positionNumber": "1",
      "taxRate": "19"
    }
  ]
}

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

    • info

      added the new 17 enum value to the request property //

    • info

      added the new 18 enum value to the request property //

    • info

      added the new 19 enum value to the request property //

    • info

      added the new 20 enum value to the request property //

    • info

      added the new 21 enum value to the request property //

  • a12897a73d08Revision changes
    • breaking

      added the new required request property /

    • breaking

      the // request property type changed from number to string

    • info

      the endpoint scheme security api_key was added to the API

    • info

      added the optional property / to the response with the status