v1

latestOpenAPI 3.0.02026-07-2455104.8 MB
Purchase Order

Update purchase order

Updates an existing purchase order as long as no writing protection is active. When the writing protection is active only isConfirmed, confirmedVia, confirmedDeliveryDate and salesOrderConfirmationReference can be updated.

patch/api/v1/purchaseOrders/{id}

Path parameters

idstring required

Resource identifier.

Example:17

The resource's identifier.

Request body

datestring date

Date of the purchase order.

bodyIntroductionstring

Text above the position table in the PDF.

bodyOutroductionstring

Text below the position table in the PDF.

salesOrderConfirmationReferencestring

Reference of the sales order confirmation. Can be updated even if the write protection is active.

isConfirmationRequestedboolean

Shows if a confirmation is requested.

suppliersOfferReferencestring

Offer reference of the supplier.

internalDesignationstring

Internal designation of the purchase order.

isConfirmedboolean

Shows if the purchase order is confirmed. Can be updated even if the write protection is active.

confirmedVia'Internet' | 'E-Mail' | 'Telephone' | 'Telefax' | 'Letter' | 'Other'

Determines how the purchase order was confirmed. Can be updated even if the write protection is active.

internalCommentstring

Internal comment about the purchase order.

liabilitiesInfostring

Information for liabilities.

Example request

{
  "project": {
    "id": "1337"
  },
  "supplier": {
    "id": "17"
  },
  "requestForQuotation": {
    "id": "1337"
  },
  "salesOrderConfirmationReference": "SO-123456",
  "language": {
    "iso2": "DE"
  },
  "financials": {
    "paymentMethod": {
      "id": "1337"
    },
    "currency": "PLN"
  },
  "delivery": {
    "deliveryTerms": {
      "id": "1337"
    }
  },
  "positions": [
    {
      "id": "17",
      "project": {
        "id": "1337"
      },
      "product": {
        "id": "17",
        "sku": "SKU1",
        "externalReferenceNumber": "REF2"
      },
      "price": {
        "amount": "13.37",
        "currency": "EUR"
      }
    }
  ]
}

Response

Operation completed successfully, no response body