API-Changelog

Changes in /incomingGoods

Added property:

• itemGroup (string)

Changes in /party

• supplier no longer requires permission entity-party-featureSupplier for reading and filtering
• competitor no longer requires permission entity-party-featureCompetitor for reading and filtering

Changes in /tax

New value ‘IE_ADD_TAX_FREE_EU_SERVICES‘ for property taxKey

Changes in /articleSupplySource

New additional properties:

• lastPurchaseOrderDate
• currentPurchasePrice

Changes in /article

Added property lastModifiedDate for additional property currentSalesPrice.

Changes in /salesOrder

New method: /salesOrder/id/{id}/createProductionOrders

Available for: POST
Creates production orders from the sales order. The method returns the created production orders.

New method: /salesOrder/id/{id}/resetTaxes

Available for: POST
Reset taxes for all items of the SalesOrder. The method returns the updated SalesOrder.

Changes in /quotation

New method: /quotation/id/{id}/resetTaxes

Available for: POST
Reset taxes for all items of the Quotation. The method returns the updated Quotation.

Added property

• mergedToQuotationId (string)

New value ‘CANCELLED‘ for property status.

Changes in /salesInvoice

New method: /salesInvoice/id/{id}/resetTaxes

Available for: POST
Reset taxes for all items of the SalesInvoice. The method returns the updated SalesInvoice.

Changes in /purchaseInvoice

New method: /purchaseInvoice/id/{id}/resetTaxes

Available for: POST
Reset taxes for all items of the PurchaseInvoice. The method returns the updated PurchaseInvoice.

General changes

• Entities which have set an inactive value of a custom attribute from type LIST or MULTISELECT_LIST can now be changed. The inactive value must therefore remain unchanged or be changed to an active value. The behavior has therefore been adapted to the UI.
• It is now possible to filter custom attributes on entity item layer,
  e.g. /purchaseOrder?purchaseOrderItems.customAttribute0815-eq=some-value
• Many properties already allow filtering in deeper levels by path. These path filters now also support custom attributes.e.g. /party?parentParty.customAttribute0815-eq=some-value

Changes in /purchaseInvoice

Added property:

• createdViaOcr (boolean,readonly)

Breaking API changes

Changes in

• /contract
• /salesOrder
• /salesInvoice
• /quotation
• /purchaseInvoice
• /purchaseOrder

Added validation for “manualUnitPrice“-flag:

If an item or shipping cost item doesn’t reference an article, then the “manualUnitPrice“-flag is ignored.

If an article is present and one wants to change the price of the item or shipping cost item, then the “manualUnitPrice“-flag also needs to be true.

Setting the “manualUnitPrice“-flag to false will indicate that the article price calculated by the system should be used.

However, changing this to false will NOT automatically update the price.

Changes in /purchaseOrderRequest

Removed property purchaseOrderRequestItems.freeTextItem Added property purchaseOrderRequestItems.itemType Added property purchaseOrderRequestOffers.purchaseOrderRequestOfferItems.itemType If you set purchaseOrderRequestItems.itemType == ‘FREE_TEXT’, You must also pass purchaseOrderRequestOffers.purchaseOrderRequestOfferItems.itemType == ‘FREE_TEXT’

purchaseOrderRequestItems.priceScaleValues was renamed to purchaseOrderRequestItems.scaleValues. Furthermore, the array now has the form

"scaleValues":[{"scale":2},{"scale":4},{"scale":6},{"scale":8}]

instead of the previous

"priceScaleValues":[2,4,6,8]

Changes in /quotation

New method: /quotation/{id}/recalculateCosts

Available for: POST

Added property ecommerceOrderItemIds (list of string)

Changes in /salesOrder

New method: /salesOrder/{id}/recalculateCosts

Available for: POST

New method: /salesOrder/id/{id}/createContract

Available for: POST

Changes in /salesOrder/id/{id}/createCustomerReturn

Added optional parameter:

• itemIds (list of strings)

Changes in /salesInvoice

New method: /salesInvoice/{id}/recalculateCosts

Available for: POST

New method: /salesInvoice/id/{id}/createContract

Available for: POST

Changes in /purchaseOrder

New method: /purchaseOrder/id/{id}/createContract

Available for: POST

Changes in /purchaseInvoice

New method: /purchaseInvoice/id/{id}/createContract

Available for: POST

Changes in /inventoryItem

Added property:

• inboundDate (integer)

Changes in /warehouseStock

Added property:

• inboundDate (integer)

Changes in /party

Improved error responses for POST,PUT.

Changes in /purchaseOrderRequest

New method: /purchaseOrderRequest/id/{id}/exportItemsAsCsv

Available for: POST

Parameters:

• supplierId (string)

Changes in /recordEmailingRule

Added property:

• attachPurchaseOrderRequestCsvFile (boolean)

Changes in /shipment

Added properties:

• shippingReturnCarrierId
• dhlReceiverId

Changes in /opportunity

Added property:

• tags (array)

Changes in /document

Added new value PURCHASE_ORDER_REQUEST_OFFER_ITEM_CSV for documentType

Changes in /Tax

Edit property taxKey:
Property is not updatable anymore

Changes in /article

Improve error responses for validation of customerArticleNumbers.

Changes in /purchaseOrderRequest

Added property:

• purchaseOrderRequestItems.customAttributes (array)

Changes in /purchaseOrder/id/{id}/processDropshipping

Added optional parameter:

• shipmentParameters with fields
  • deliveryNoteNumber (string)
  • shippingDate (integer)
  • deliveryDate (integer)

New endpoint /articleCategoryClassification

Available for: GET, POST, PUT, DELETE.

Properties:

• active (boolean)
• description (string)
• name (string)
• positionNumber (integer)

Changes in /articleCategory

Added properties:

• articleAccountingCodeId (string)
• articleCategoryClassificationId (string)
• costTypeId (string)
• purchaseCostCenterId (string)
• salesCostCenterId (string)

Changes in /quotation

New method: /quotation/id/{id}/setCostsForItemsWithoutCost

Available for: POST

Required parameter:

• costUpdateMode (string)

Set unitCost of all quotationItems and shippingCostItems with empty unitCost to either the net unit price or zero, depending on costUpdateMode.

Changes in /salesOrder

New method: /salesOrder/id/{id}/setCostsForItemsWithoutCost

Available for: POST

Required parameter:

• costUpdateMode (string)

Set unitCost of all orderItems and shippingCostItems with empty unitCost to either the net unit price or zero, depending on costUpdateMode.

Changes in /salesInvoice

New method: /salesInvoice/id/{id}/setCostsForItemsWithoutCost

Available for: POST

Required parameter:

• costUpdateMode (string)

Set unitCost of all salesInvoiceItems and shippingCostItems with empty unitCost to either the net unit price or zero, depending on costUpdateMode.

General Improvements

Parameter “filter”: better handling of ID properties

In filter expressions ID properties (i.e. ones named “id” or “<soemthing>Id”) can now also be compared to string literals instead of only integers. This makes the behavior consistent with the type returned by the API.

All ReductionAdditionItems now offer the same fields for the API

position, type, source, value, specialPriceReduction and title, Title and specialPriceReduction being new API available fields for ReductionAdditionItems.

Added validation for commercialLanguage.

Affected Endpoints:

• /salesOrder
• /salesInvoice
• /quotation
• /shipment
• /incomingGoods
• /contract
• /purchaseInvoice
• /purchaseOrder
• /purchaseOrderRequest
• /blanketPurchaseOrder
• /performanceRecord

Changed endpoint /recordEmailingRule

attachReturnLabel (boolean) and recordEmailingRule allows the new event 'ATTACH_RETURN_LABEL' for type shipment, return and supplier return.

Changes in /recordEmailingRule/id/{id}

Added Properties:

attachShippingLabel(boolean)

attachReturnLabel (boolean)

New endpoint /priceCalculationParameter

Available for: GET, POST, PUT, DELETE
Properties:

• articleCategoryId (string)
• articleId (string)
• fixSurcharge (string)
• fromScale (string)
• lowerPurchasePriceBound (string)
• margin (string)
• percentSurcharge (string)
• profit (string)
• salesChannel (string (enum))

Changes in /quotation

Added properties:

• recordOpeningInheritance (boolean)
• recordFreeTextInheritance (boolean)
• recordCommentInheritance (boolean)
• quotationItems.scaleValues

New method: /quotation/id/{id}/addDefaultScalePricesToItems

New method: /quotation/id/{id}/createPurchaseOrderRequest

Available for: POST
Creates a supplier request from the quotation. The method returns the created supplier request.

Changes in /salesOrder

Added properties:

• recordOpeningInheritance (boolean)
• recordFreeTextInheritance (boolean)
• recordCommentInheritance (boolean)

New method: /salesOrder/id/{id}/createPurchaseOrderRequest

Available for: POST
Creates a supplier request from the sales order. The method returns the created supplier request.

Changes in /salesInvoice

Added properties:

• recordOpeningInheritance (boolean)
• recordFreeTextInheritance (boolean)
• recordCommentInheritance (boolean)
• commissionBlock (boolean)
• cancellationSlipCommissionBlock (boolean)
• commissionSettlementDone (boolean,readonly)
• cancellationSlipCommissionSettlementDone (boolean,readonly)

Changes in /party

Added property: commissionBlock (boolean)

Changes in /manufacturer

Added properties:

• address.city (string)
• address.company (string)
• address.company2 (string)
• address.countryCode (string)
• address.firstName (string)
• address.globalLocationNumber (string)
• address.lastName (string)
• address.middleName (string)
• address.phoneNumber (string)
• address.postOfficeBoxCity (string)
• address.postOfficeBoxNumber (string)
• address.postOfficeBoxZipCode (string)
• address.salutation (enum)
• address.state (string)
• address.street1 (string)
• address.street2 (string)
• address.titleId (string)
• address.titleId (string)
• address.zipcode (string)
• email (string)

 positionNumber is always null and description is always null

Changes in /system/licenses

Added property:

• permissions (array)

Changes in /articleSupplySource

Added property:

• ignoreInDropshippingAutomation (boolean)

Changes in /party

Added property:

• customerAllowDropshippingOrderCreation (boolean)

Changes in /salesInvoice

creditResetsOrderState is not readonly anymore

Changes in /quotation

New method /quotation/id/:id/createPublicPageLink

New method /quotation/id/:id/disablePublicPageLink

Available for: POST

Breaking API Changes

Changes in /salesOrder

Removed properties:

• orderItems.pickBatchNumber
• orderItems.pickSerialNumbers
• orderItems.pickStoragePlaceId
• orderItems.withdrawalTransportReferenceId

Instead it is now possible to use the property orderItems.picks to define one or multiple picks of a retail sale analogous to non-retail sale sales order.

Changes in /purchaseOrderRequest

Removed property:

purchaseOrderRequestOffers.purchaseOrderRequestOfferItem.orderedQuantity

Changes in /purchaseOrderRequest/id/:id/createBlanketPurchaseOrder

The method now returns the created blanket purchase order instead of just “true”.

Changes in /quotation/id/:id/accept

The method now returns the accepted quotation.

Changes in /article

Removed properties:

• articleCalculationPrices.positionNumber
• articlePrices.positionNumber

Changes in /articleSupplySource

Removed properties:

• articlePrices.positionNumber

Changes in /articlePrice

Removed properties:

• positionNumber (read-only)

Changes in /purchaseOrder

The type BLANKET_PURCHASE_ORDER was removed.

Rename permission

entity-party-updateDataProtectionLink to entity-party-updatePublicPageUuid

Further API Changes

Changes in /party

Added properties:

• • publicPageExpirationDate (integer)
  • publicPageUuid (string)
  • regionID (string, read-only)

New endpoint /party/id/:id/createPublicPage

creates data protection link.

New endpoint /region

Supports: GET, PUT, POST, DELETE

Provided properties:

• name (string)
• matchCode (string)
• description (string)
• countryCode (string)
• responsibleUserId (string)
• responsibleUserUsername (string)

Changes in /purchaseOrder/id/{id}/processDropshipping

Added optional parameter:

• processPurchaseOrderItems (array of objects)
  • Each object has the property purchaseOrderItemId (string)

New endpoint /purchaseOrder/id/:id/cancelDropshippingShipments (POST)

with required parameter shipmentIds(array of strings) specifying the dropshipping shipment ids to be cancelled.

Cancels the provided dropshipping shipments as well as the corresponding incoming goods and reopens the dropshipping order afterwards.

Changes in /document

Changed property documentType

New value “ZUGFERD_VALIDATION” was added.

We want to inform you upfront about breaking API changes that will be released with Release 24.22.1 on November 14th, 2024:

Changes in /salesOrder

Removed properties:

• orderItems.pickBatchNumber
• orderItems.pickSerialNumbers
• orderItems.pickStoragePlaceId
• orderItems.withdrawalTransportReferenceId

Instead it is now possible to use the property orderItems.picks to define one or multiple picks of a retail sale analogous to non-retail sale sales order.

Changes in /purchaseOrderRequest

Removed property: purchaseOrderRequestOffers.purchaseOrderRequestOfferItem.orderedQuantity

Changes in /purchaseOrderRequest/id/:id/createBlanketPurchaseOrder

The method now returns the created blanket purchase order instead of just “true”.

Changes in /article

Removed properties:

• articleCalculationPrices.positionNumber
• articlePrices.positionNumber

Changes in /articleSupplySource

Removed properties:

• articlePrices.positionNumber

Changes in /articlePrice

Removed properties:

• positionNumber (read-only)

Changes in /purchaseOrder

The type BLANKET_PURCHASE_ORDER was removed.

Changes in /party

New endpoint /party/id/:id/createPublicPage

creates data protection link.

Added properties:

• publicPageExpirationDate (integer)
• publicPageUuid (string)

Rename permission

entity-party-updateDataProtectionLink to entity-party-updatePublicPageUuid

Changes in /quotation/id/:id/accept

The method now returns the accepted quotation.

Regular API Changes Release 24.21.1

Changes in /quotation

added properties

• expectedSignatureDate (Date)
• quotationItems.itScopeId (String) read-only

Changes in /pick

Added property:

• salesOrderItemId (string)

Changes in /productionOrder

Added property:

• productionOrderItem.picks (array)

relevant pick properties:

• • id (string)
  • transportationOrderId (string)
  • storagePlaceId (string)
  • internalTransportReferenceId (string)
  • batchNumber (string)
  • orderItemId (string)
  • quantity (decimal)
  • serialNumbers (array)

where serialNumbers consists of an array of string.

Changes in /salesOrder

Added property:

• orderItems.picks (array)

relevant pick properties:

• • id (string)
  • transportationOrderId (string)
  • storagePlaceId (string)
  • internalTransportReferenceId (string)
  • batchNumber (string)
  • orderItemId (string)
  • quantity (decimal)
  • serialNumbers (array)

where serialNumbers consists of an array of string.

Changes in /shipment

Added property:

• shipmentItem.picks (array)

relevant pick properties:

• • id (string)
  • transportationOrderId (string)
  • storagePlaceId (string)
  • internalTransportReferenceId (string)
  • batchNumber (string)
  • orderItemId (string)
  • quantity (decimal)
  • serialNumbers (array)

where serialNumbers consists of an array of string.

Changes in /shippingCarrier

Add property shippingServiceProviderType (string) as mandatory field with possible values:

• STANDARD
• SHIPCLOUD
• DHL
• SENDCLOUD

Changes in /party

PUT: If imageId is set to null then party image will be removed. If imageId is given by a new non-null value then it will throw an API validation exception which refers to the /uploadImage endpoint. If imageId is not provide in the payload then no changes to the party image.

New filter property: lead (boolean)

New additional properties:

• leadExpectedRevenueQuotations (string)
• leadQuotationVolume (string)
• leadExpectedRevenueOpportunities (string)
• leadChildrenExpectedRevenueQuotations (string)
• leadChildrenQuotationVolume (string)
• leadChildrenExpectedRevenueOpportunities (string)
• customerSalesRevenueCurrentYear (string)
• customerSalesRevenuePreviousYear (string)
• customerSalesOrderVolumeCurrentYear (string)
• customerSalesOrderVolumePreviousYear (string)
• customerQuotationAcceptancePercentage (string)
• customerQuotationAcceptanceTimeInDays (integer)
• customerSalesOpenItemSum (string)
• customerSalesOpenItemOverdueSum (string)
• customerReturnPercentagePreviousYear (string)
• customerReturnPercentageCurrentYear (string)
• customerChildrenSalesRevenueCurrentYear (string)
• customerChildrenSalesRevenuePreviousYear (string)
• customerChildrenSalesOrderVolumeCurrentYear (string)
• customerChildrenSalesOrderVolumePreviousYear (string)
• supplierPurchaseRevenueCurrentYear (string)
• supplierPurchaseRevenuePreviousYear (string)
• supplierPurchaseOrderVolumeCurrentYear (string)
• supplierPurchaseOrderVolumePreviousYear (string)
• supplierChildrenPurchaseRevenueCurrentYear (string)
• supplierChildrenPurchaseRevenuePreviousYear (string)
• supplierChildrenPurchaseOrderVolumeCurrentYear (string)
• supplierChildrenPurchaseOrderVolumePreviousYear (string)

Changes in /customAttributeDefinition

New possible value for attributeEntityType: purchaseOrderRequest

Changes in /currency

Now available for: POST, PUT, DELETE

Changes in /inventory

is now available for POST and PUT as well and has the added property inventoryGroupId (string).
The update functionality supports status changes to STARTED or CANCELLED.
Creating a new inventory is possible via POST, but there is an additional

New endpoint /inventory/create

for POST that provides a few additional options. The request can contain the following properties:

• inventory (an inventory like the POST request would use)
• storagePlaceIds (array of string)
• createEmptyPositionsForEmptyLevels (boolean)
• placeForArticlePositionsId (string)
• dryRun (boolean)
  The inventory is required, the others are optional and default to the values used in the general POST.

New endpoint /inventoryGroup

available for GET, mainly to find the group’s id that is needed to create a new inventory.

Properties

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• name (string)

Changes in /purchaseOpenItem

New method /purchaseOpenItem/id/{id}/updatePaymentState

Available for: POST

Parameters:

• datePaid (integer)
• paymentState (enum – values: “PAID”, “UNPAID”)

Changes in /salesOpenItem

New method /salesOpenItem/id/{id}/updatePaymentState

Available for: POST

Parameters:

• datePaid (integer)
• paymentState (enum – values: “PAID”, “UNPAID”)

Changes in /user

Added property: title (string)

Changes in /article

Added property:

•  useSalesBillOfMaterialSubitemCosts (boolean)

New general query parameter: filter (Beta feature)

Query parameter that can be used on all query requests to specify complex filter expressions. Example:

curl -H "AuthenticationToken:<TOKEN>" \
  ${url}/party \
  --get \
  --data-urlencode 'filter=(lower(contacts.firstName + " " + contacts.lastName) = "Ertan Özdil") and (lastModifiedDate >= 2022-01-01)'

Detailed documentation is in our API documentation.

Changes in /ticket

Added extra query property ticketStatus.

Changes in /quotation

Added property:

• quotationItems.plannedDeliveryDate (integer)
• quotationItems.plannedShippingDate (integer)

Changes in /salesOrder

Added property:

• orderItems.plannedDeliveryDate (integer)

Changes in /purchaseOrder

Added properties:

• formSettingsFromSalesChannel (string)

Changes in /job

Added properties:

• progress.failedCreateCount (integer)
• progress.failedUpdateCount (integer)
• progress.lastModifiedDate (integer)
• progress.succeededCreateCount (integer)
• progress.succeededUpdateCount (integer)
• progress.totalCount (integer)

New endpoint /reminder

Supports: GET, PUT, POST, DELETE.

Provided properties:

• ccMail (string)
• entityId (string, required)
• entityName (string, required)
• message (string)
• additionalRecipients (array)
• recurringEvent (object)
• reminderDate (integer, required)
• sendType (string, required)
• lastReminderSentDate (integer)
• subject (string, required)
• userId (string)

recurringEvent properties:

• endsOnDate (integer)
• eventType (string)
• repeatOn (string)
• eventInterval (integer)
• eventOccurrenceCount (integer)

Changes in /articleSupplySource

New additional property:

• currentPurchasePriceInCompanyCurrency (array)

Changes in /salesOrder

properties added:

• applyShippingCostsOnlyOnce (boolean)
• note (string)
• sepaDirectDebitMandateId (string)
• recordAsn (string)
• orderItems.contractChargeId (string)
• orderItems.withdrawalTransportReferenceId (string)
• payments.condition (string)
• payments.conditionMet (boolean)
• payments.dueDate (integer)
• payments.salesInvoices (array)
• statusHistory.creditLimitExceeded (boolean)

Changes in /article

Added translation to property:

• recordItemGroupName (String)

Breaking API changes:

Changes in /customAttributeDefinition/updateOrder

The request must contain all IDs of existing customAttributeDefinition entities for the given entityType.

Changes in /document/id/{id}/downloadDocumentVersion

Rename query parameter from id to versionId

Changes in /article

• POST: If articleType is empty, the default article type of the system (determined by the article settings) will be used, as opposed to always using BASIC like before.
• PUT: If articleType is empty, the endpoint will now throw an error with status code 400 because articleType is required. If articleType is empty and the optional parameter ignoreMissingProperties is enabled, articleType will stay untouched.

Changes in /salesOrder

Changed property:

• serviceItem is renamed to itemType and is not a boolean any more, but an enumeration value:
  • DEFAULT
  • SERVICE

Changes in /quotation

Changed property:

• serviceItem is renamed to itemType and is not a boolean any more, but an enumeration value:
  • DEFAULT
  • SERVICE

Further API changes:

Changes in /salesInvoice

Added properties:

• costCenterId (string)
• costTypeId (string)
• salesInvoiceItems.cost2CostCenterId (string)
• salesInvoiceItems.costTypeId (string)

Changes in /purchaseInvoice

Added properties:

• purchaseInvoiceItems.cost2CostCenterId (string)
• purchaseInvoiceItems.costTypeId (string)

Changes in /customAttributeDefinition

Added property: showAttributeEntityType (boolean), it may only be true if attributeType == ENTITY

Changes in /recordEmailingRule

new value for event available:

PURCHASE_ORDER_DROPSHIPPING_DELIVERY_NOTE_PRINTED

New endpoint /purchaseOrderRequest/id/:id/pushPurchasePrices

Add or update purchase prices for articles with provided supplierIds (array(string)) to given purchaseOrderRequest.

Changes in /ticket

New additional properties:

• tasksCompleted(boolean)
• tasksCompletedPercentage(string)

Changes to /article

Improve the initialization logic of articles. The articleType will now be evaluated first, using the specific default settings of the provided articleType to ensure that certain values will be initialized.

Example:

POST:
{ "serialNumberRequired" : true, "articleNumber" : "1234", "name" : "testArticle1234", "articleType": 'STORABLE', "unitName": "h" }

Example ERP settings defaults for articles:

Default article type = SERVICE
Default unit for type “STORABLE” = “Stk.”
BatchNumberRequired = true
SerialNumberRequired = false

Upon creation of the article via API the field articleType will initialize all default settings of that type meaning unitName will be “Stk.”, batchNumberRequired will be true and serialNumberRequired will be false.
Afterwards, the remaining properties will overwrite the provided default settings.
In this example the unitName will be changed to “h” and the serialNumberRequired will be changed to true.
Finally, the article will be validated and “speaking” error messages will be provided as to what field needs to be adjusted to make a create article.

The difference to the old behavior is that the default article type is “SERVICE” and the initialization logic would have initialized the default settings for articles of type “SERVICE” instead of the ones for article type “STORABLE“, which could cause issues if a default values of type “SERVICE” would initialize something that couldn’t be set for article type “STORABLE“.

General changes

Addition of the optional property errorCode to the error response object. In the future, the errorCode will improve the interpretation of business errors in machine-readable form.

Changes in /salesOrder

New method /salesOrder/id/{id}/activateProjectView

Available for: POST

Changes in /article

The article property commissionRate will be set to the default settings value (defaultArticleCommissionRate) for new articles if not set in the request.

Changes in /purchaseOrderRequest

Just like in the UI, the following supplier request fields are now validated if the status OFFER_RECEIVED is targeted:

• purchaseOrderRequestOffers.startDate
• purchaseOrderRequestOffers.endDate
• purchaseOrderRequestOffers.validFrom
• purchaseOrderRequestOffers.validTo

Changes in /purchaseInvoice

New method /purchaseInvoice/id/{id}/saveDuplicateInvoiceAsOriginal

Available for: POST

Method for changing the duplicate purchase invoice as original which takes the purchase invoice id as parameter.

Changes in /incomingGoods

Added properties:

• dropshippingShipmentId (string, read-only)
• incomingGoodsItems.dropshippingShipmentItemId (string, read-only)

Changes in /quotation

New method: /quotation/{id}/updatePrices

Available for: POST
Updates all prices of the Quotation. The method returns the updated Quotation.

Changes in /salesOrder

New method: /salesOrder/{id}/updatePrices

Available for: POST
Updates all prices of the SalesOrder. The method returns the updated SalesOrder.

Changes in /salesInvoice

New method: /salesInvoice/{id}/updatePrices

Available for: POST
Updates all prices of the SalesInvoice. The method returns the updated SalesInvoice.

Changes in /customAttributeDefinition/readOrder

Previously this method only returned those IDs of customAttributeDefinition entities, which were explicitly set via /customAttributeDefinition/updateOrder before. Now this method’s response will contain all IDs of existing customAttributeDefinition entities for the given entityType. This especially means:

• The response always includes entities with active set to false.
• The response never contains entities with systemCustomAttribute set to true.
• The response never contains entity IDs of deleted entities.

Changes in /salesOrder/id/{id}/createDropshipping

Added optional parameter:

• orderItemIds (list of strings)

Changes in /blanketPurchaseOrder

Added property:

• reductionAdditionItems (array)

A reductionAdditionItems element consists of

• position (number, read-only)
• source (string, read-only)
• type (string, read-only)
• value (string, read-only)

Changes in /purchaseOrder

The properties packageTrackingNumber and shippingCarrierId are now editable in any purchase order status, just like in the UI.

Changes in /incomingGoods

New method /incomingGoods/id/{id}/createPurchaseInvoice

Available for: POST

New endpoint /accountingTransaction/batchBooking

Available for: POST

Request properties:

• batchBookingRecords (array)
• bookingText (string)
• costCenterId (string)
• currencyId (string)
• externalRecordNumber (string)
• transactionDate (integer)

batchBookingRecord properties:

• amount (string)
• creditAccountId (string)
• debitAccountId (string)
• description (string)
• taxId (string)

Changes in /party

Added property:

• allowPurchaseOrderCreation (boolean)

Changes in /purchaseOrder

Added property:

• invoiced (boolean, read-only)
• paid (boolean, read-only)

Changes in /purchaseInvoice

Added properties:

• cancellationDate (date), read-only
• deliveryDate (date)
• shippingDate (date)
• paymentBlock (boolean)
• costTypeId (string)
• grossAmountOfHeaderTaxes (integer), read-only
• grossAmountOfHeaderTaxesInCompanyCurrency (integer), read-only
• paymentBlock (string), read-only
• paymentBlockNote (string), read-only
• purchaseInvoiceItems.deliveryDate (date)
• purchaseInvoiceItems.shippingDate (date)
• purchaseInvoiceItems.contractItemId (string), read-only

New endpoint /inventory

Available for: GET
Allows to query existing inventories. They have the following properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• inventoryNumber (string)
• description (string)
• warehouseId (string)
• levelOfDetail (enum)
• managerId (string)
• counter (string)
• recorder (string)
• startDate (integer)
• endDate (integer)
• status (enum)
• statusHistory (array)

where levelOfDetail can be STORE or LEVEL and the possible values for status are NEW, PLANNED, DOCUMENTS_PRINTED, STARTED, COMPLETE, DIFFERENCE_CHECKED, BOOKED, CLOSED and CANCELLED.

New endpoint /inventoryItem

Available for: GET, POST, PUT, DELETE
Allows working with inventory items. Changes are only possible while the corresponding inventory is in status STARTED. They have the following properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• positionNumber (string)
• inventoryId (string)
• manualPosition (boolean)
• expectedQuantity (decimal)
• countedQuantity (decimal)
• expirationDate (integer)
• inventorySerialNumbers (array)
• replacementValue (decimal)
• comment (string)
• articleId (string)
• storagePlaceId (string)
• batchNumber (string)
• orderItemId (string)
• inventoryTransportReferenceId (string)

where the inventorySerialNumbers have the properties

• serialNumber (string)
• status (enum)

with the allowed values EXPECTED, MISSING, CHECKED and MANUALLY for status.

New endpoint /inventoryTransportReference

Available for: GET, PUT
There is no delete because unused ones are removed automatically when the corresponding inventory is booked. They have the following properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• inventoryId (string)
• manualReference (boolean)
• internalTransportNumber (string)
• loadingEquipmentIdentifierId (string)
• loadingEquipmentArticleId (string)

Changes in /storagePlace

Added property:

• currentInventoryId (string)

Changes in /shipment

New method /shipment/id/{id}/createReturnLabels

Available for: POST

New method /shipment/id/{id}/createShippingLabels

Available for: POST

Changes in /salesOrder

New method /salesOrder/id/{id}/createReturnLabels

Available for: POST

New method /salesOrder/id/{id}/createShippingLabels

Available for: POST

Changes in /incomingGood

New method /incomingGood/id/{id}/createReturnLabels

Available for: POST

Changes in /article

It is now possible to remove price calculation parameters from an article.

New endpoint: /purchaseRequisition

Available for: GET, PUT.

Properties:

• articleId (string, read-only)
• customAttributes (array)
• earliestRequiredDate (integer, read-only)
• internalShipmentId (string, read-only)
• latestRequiredDate (integer, read-only)
• packagingUnitToOrderId (string)
• productionOrderId (string, read-only)
• productionOrderItemId (string, read-only)
• proposedDate (integer, read-only)
• proposedQuantity (string)
• purchaseOrderId (string, read-only)
• requirementQuantity (string, read-only)
• requisitionNumber (string, read-only)
• salesOrderItemId (string, read-only)
• status (string)
• statusHistory (array, read-only)
• supplierId (string)
• warehouseId (string, read-only)

New method: /deleteAllRequisitions
POST /purchaseRequisition/deleteAllRequisitions: deletes all purchase requisitions

New method: /startMaterialPlanningRun
POST /purchaseRequisition/startMaterialPlanningRun: start a new material planning run which will generate purchase requisitions.

• Parameter: warehouseIds (String)

Changes in /opportunity

New method /opportunity/id/{id}/linkQuotation

Available for: POST

Can be used to link an opportunity to a quotation.

Changes in /salesOrder

Added property:

• template (boolean)

Changes in /salesOrder/id/{id}/createShipment

The method takes the optional new parameter additionalSalesOrderIds, a list of String ids of sales orders. It can be used to create a collective shipment, using the id specified in the path as main sales order.

Changes in /shipment

The shipments have the new property salesOrders, a list of onlyId elements. It is not editable and contains the ids of all connected sales order. For non-collective shipments, this essentially duplicates salesOrderId; for collective shipments, the salesOrderId refers to the main sales order that was used during creation.

Shipments can now be cancelled by using the status “CANCELLED”.

Changes in /incomingGoods

The shipments have the new property salesOrders, a list of onlyId elements. It contains the id of the connected sales order (if present).

Changes in /purchaseOrder

Added property:

• senderCountryCode (String)

Changes in /blanketPurchaseOrder

Added property:

• senderCountryCode (String)

Changes in /article

It is now possible to create a price calculation parameter with both percentSurcharge and fixSurcharge (or both margin and profit) equal to zero, just like in the UI.

New endpoint /transportationOrder/id/{id}/createPick

Available for: POST
required parameter:

• packagingUnitBaseArticleId (string)
• storagePlaceId (string)
• quantity (string)

optional parameter:

• internalTransportReferenceId (string)
• batchNumber (string)
• orderItemId (string)
• serialNumbers (array)
• existingReservations (array)

An existingReservations element consists of:
required properties:

• orderItemId (string)
• quantity (string)
  optional properties:
• serialNumbers (array)

Both serialNumbers properties are a arrays of strings.

Creates a new pick and adds it to the transportionOrder. See API documentation for further information regarding existingReservations.

Changes in/salesInvoice

Added properties:

• bookingText (string)
• commissionBlock (boolean)
• creditResetsOrderState (boolean), read-only
• directDebitFileCreated (boolean)
• directDebitFileLatestDate (integer), read-only
• dunningBlockDateUntilDate (integer), read-only
• dunningBlockNote (string), read-only
• dunningBlockState (string), read-only
• sepaDirectDebitMandateId (string)
• salesInvoiceItems.contractItemId (string), read-only
• salesInvoiceItems.deliveryDate (integer)
• salesInvoiceItems.shippingDate (integer)

Changes in /termOfPayment

Added properties:

• dueDateOption (String – possible values: ‘IMMEDIATE’, ‘PERIOD’, ‘FIX’, ‘END_OF_MONTH’)
• numberOfDays (number)
• fixedDay (number)

Changes in /externalConnection

Remove unused values ‘FIGO_REG_SHIELD_PROD’ and ‘FIGO_REG_SHIELD_STAGING’ for connectionType.

Changes in /recordEmailingRule

Added property:

• bccRecipients (String)
• paymentMethodTypes (array)

Changes in /salesOrder

Added property:

• advancePaymentAmount (string)
  • Can only be set in salesOrders of type “ADVANCE_PAYMENT” and is otherwise ignored
  • Can be used to adjust the amount of the advance payment invoice of a sales order
• payments (array)
  • Can only be set in salesOrders of type “PART_PAYMENT” and is otherwise ignored
  • Can be used to manage part payments for sales orders

payment properties:

• amount (string)
• positionNumber (integer, read-only)
• salesInvoiceId (string, read-only)

Changes in /user

Creating a new user doesn’t send an invitation email anymore. Instead use the new endpoint /user/id/{id}/invite to send an invitation email if needed.

New method /user/id/{id}/invite

Available for: POST

Sends an invitation email to the given user. Response object is the user.

Changes in /article

New method /article/id/{id}/changeUnit

Available for: POST

Method for changing the unit of an article which takes the unit’s id as a parameter.

Changes in /purchaseInvoice

It is now possible to change the value of dueDate, just like in the UI.

Changes in /user

Add property licenses(array[string]). For possible values see endpoint /system/licenses.

Adding values to licenses on /user is limited by the licenses booked in the tenant.

Changes in /system

New method /system/licenses

Available for: GET

Returns all licenses visible to the tenant as array[string].

These are licenses, which are either available for booking, available for assignment to users or assigned to users. Only available for admin users.

New endpoint: /job

Technical endpoint (not entity related), contains 2 GET methods:

New method: /job/status

GET /job/status?type=<type> : Query the status of the given job

• Parameter: “type” (type of job to query)

New method: /job/abort

GET /job/abort?type=<type> : Abort the given job

• Parameter: “type” (type of job to abort)

All methods return the job status object:

• result
  • type (string) : use as parameter “type” for methods “status” and “abort”
  • status (enum)
  • lastActivity (timestamp)
  • totalSteps (integer)
  • finishedSteps (integer)
  • errors (array of strings)
  • logMessages (array)
    • userId (integer, optional) : ID of the user who triggered the message
    • severity (enum)
    • message (string)
    • summary (string, optional)
    • entityName (string, optional) : name of the entity the message is referring to
    • entityId (integer, optional) : ID of the entity the message is referring to

Async job usage

The common pattern of working with asynchronous jobs in the API is as follows:

1. Start the job via the correct REST method in the semantically appropriate endpoint
2. Poll /job/status with the “type” parameter from the returned status object until the job is finished (status == NOT_EXECUTING)
3. Optionally abort it via /job/abort (with the same “type” parameter)
4. Optionally fetch the computed results with another provided REST method

Jobs are started via methods on the respective associated endpoints. These will be added over time.

Changes in /ticketType

Added property:

• articleId (string)
  • References a service article as default article for a ticket type

Changes in /article

New additional property:
averagePrice

Changes in /salesOrder

To prevent a discrepancy between sales order and sales invoice, it is not possible anymore to change taxId, taxName and discountPercentage for an order item linked to an uncancelled sales invoice item, just like in the UI.

Changes in /shipment

New method /shipment/id/{id}/createPickingList

Available for: POST

Changes in /productionOrder

New method /productionOrder/id/{id}/createPickingList

Available for: POST

Changes in /transportationOrder

New method /transportationOrder/id/{id}/createPickingList

Available for: POST

Changes in /purchaseInvoice

New method /purchaseInvoice/id/{id}/downloadLatestPurchaseInvoiceDocument

Available for: GET

Changes in /article

It is now possible to remove quantity conversions from an article.

General changes

New UI for API documentation

Performance has been significantly improved with the new UI and the layout has been optimized. In addition, it is now possible to search for endpoints using a filter function.

Changes in /customAttributeDefinition

The endpoint also supports POST, PUT and DELETE in addition to GET now.

Added properties:

• permissions (array)
• conditions (array)

customAttributeDefinitionPermission:

• userRoleId (string)
• permissionType (string)

customAttributeDefinitionConditions:

• ignoreConditionsIfValueIsSet (boolean)
• conditionsForEntityType (array)

conditionsForEntityType:

• entityType (string)
• propertyConditions (array)

customAttributeDefinitionPropertyCondition:

• propertyName (string)
• propertyValue (string)
• conditionOperator (string)
• propertyType (string)

Further information:

• the defaultValue for the attributeType ‘URL’ gets also displayed by defaultStringValue now and can be updated by this. (previously the value wasn’t displayed at all)

New endpoint /customAttributeDefinition/id/{id}/readOrder

Available for: GET
required parameter: entityType (string)
returns a list of order objects with two properties:

• id (string)
• overrideGroupName (string, optional)

New endpoint /customAttributeDefinition/id/{id}/updateOrder

Available for: POST
required parameter:

• entityType (string)
• order (array)
  order properties:
• id (string)
• overrideGroupName (string, optional)

Changes in /purchaseOrder/id/:id/createPurchaseInvoice

added properties

• invoiceNumber (string)
• allowExistingInvoiceNumber (boolean)

Changes in /purchaseInvoice

Added property:

• vatRegistrationNumber (string)

Changes in /document

New value ‘PURCHASE_INVOICE_ZUGFERD‘ for property documentType

Changes in /warehouseStockMovement

Breaking API Change:

All endpoints for POST return a more meaningful response: instead of a generic success object, they return a (non-empty) list of warehouse stock movements that were created while processing the requested booking.

Changes in /warehouseStock

Added property

packagingUnits (array) – with elements consisting of:

• articleId (string)
• packagingUnitQuantity (int)
• baseArticleQuantity (long)

Breaking API Change:

Removed properties:

• packagingUnitArticleId (string)
• packagingUnitQuantity (decimal)

Changes to /article

Breaking API Change:

If an article or any of the related packaging units has a supply source, the property primarySupplySourceId is required regardless of the article type. Before, this was only the case for storable articles.

Changed property:

• plannedWorkingTimePerUnit (string) is now of type (integer)

Changed endpoint /purchaseOrderRequest/id/{id}/createPurchaseOrder

Breaking API Change:

Changed property:

• offerItemToUpdateSupplierInformation.updatePurchasePrice is not a boolean anymore, but a string with values
  • NO_UPDATE
  • UPDATE_GENERAL_PURCHASE_PRICE
  • UPDATE_PURCHASE_PRICE_ONLY_FOR_CUSTOMER

Changes in/unit

Breaking API Change:

Removed property:

• defaultUnitHourAmount (string): use timeUnitAmount (integer) instead

Added property:

• timeUnitAmount (integer)

Changes in/quotation

Breaking API Change:

Changed property:

• quotationItems.plannedWorkingTimePerUnit (string) is now of type (integer)

Changes in/salesOrder

Breaking API Change:

Changed property:

• orderItems.plannedWorkingTimePerUnit (string) is now of type (integer)

Changes in /archivedEmail

Breaking API Change:

id is now a “real” entity id instead of the previously combined id of the linked entities

Remove method DELETE /archivedEmail/id/{id}

New method POST /archivedEmail/id/{id}/removeReference

required body properties:

• entityName (string)
• entityId (string)

Changes in /contract

Breaking API Change:

Changed property:

• billingTargetInvoiceStatus (string)

the type ‘BOOKED‘ no longer exists (existing occurences replaced by ‘OPEN_ITEM_CREATED‘). Invoices created by a contract will now be automatically booked according to the setting enableAutomaticBooking

Changes in /incomingGoods, /shipment

Breaking API Change:

The status “INCOMING_GOODS_MOVEMENT_PRINTED” was removed.

Changes in /accountingTransaction

Breaking API Change:

Removed properties from transactionDetails :

• id
• version
• createdDate
• lastModifiedDate
• accountNumber
• currencyId
• currencyName
• taxName
• transactionDetailType

Changes in /opportunity

Breaking API Change:

Removed properties:

• leadId (string): use customerId (string) instead
• leadNumber (string): use customerNumber (string) instead

Changes in /shipment/{id}/createShippingLabelPdf

Using this endpoint requires shipment update permissions now.

Changes in /purchaseOrder

Added property:

• plannedShippingDate(integer)

General changes

Introduce dry-run functionality

Support the functionality for generic PUT, POST and DELETE endpoints to perform operations in a “dry-run-mode”. Where possible, business logic is executed and the data submitted by the requester is validated.
To use this functionality the requester can set the optional query parameter “dryRun” (boolean, default: false). The return is as far as possible as with a productive execution, except that 200 “ok” is returned in case of success.
The meta properties (id, version, createdDate, lastModifiedDate) are not included in “dry-run-responses”.

Changes for error handling

Unify the base error message during validation to “Validation failed” (400) for all generic entity endpoints. For more information, see the error message details.

For DELETE requests, an error response of the type “validation” (400) is now also returned if possible. In this case, this error object contains the referenced entities that block the deletion. The previous error message “Conflict” (409) can still be returned in some cases.

Extend endpoint /salesOrder

New additional properties:

• plannedBillableEffort
• bookedBillableWork
• plannedEffort
• bookedWork
• invoicedServices
• invoiceableServices
• notInvoicedServices
• costOfServices

Extend endpoint /ticket

New additional properties:

costOfServices

Changes in /transportationOrder

It is now allowed to create transportation orders of type STOCK_TRANSFER without any picks. This can be used to create an internal transport reference for them before specifying the article to be transferred. A pick can be added later via PUT.

New endpoint /ticketPoolingGroup

Available for: GET

Properties:

• name (string)
• description (string)
• ticketCategories (array)
• ticketPoolingGroupMembers (array)

ticketPoolingGroupMember properties:

• userId (string)
• ticketPoolingGroupId (string)

Changes in /ticket, /ticketAssignmentRule

Added property: assignedPoolingGroupId (string)

ticketAssigneeType & internalTicketStatus allow the new value “POOL”

Changes in /purchaseOrderRequest

The property purchaseOrderRequestOffers.purchaseOrderRequestOfferItems.procurementLeadDays is now nullable and the new default value is null instead of 0.

Changes in /externalConnection

Modified property value:

• connectionType (ENUM)
  • Changed from SENDINBLUE to BREVO

Changes in /article

Breaking API Change:

Removed query parameters:

• salesBillOfMaterialArticle (boolean): for true, use “articleType”: “SALES_BILL_OF_MATERIAL” instead
• serviceArticle (boolean): for true, use “articleType”: “SERVICE” instead
• shippingCostArticle (boolean): for true, use “articleType”: “SHIPPING_COST” instead
• storable (boolean): for true, use “articleType”: “STORABLE” instead

Changes in /articlePrice

Breaking API Change:

Removed properties:

• distributionChannel (string, read-only): use salesChannel instead

Changes in /articleSupplySource

property:
articlePrices.customerId can now be set, allowing the creation of customer purchase prices.

Changes in /purchaseInvoice

added properties

• importSalesTaxAmount (string)
• importSalesTaxId (string, readonly)
• bookingDate (integer)
• creatorId(string) (readonly)

purchaseInvoiceItem.supplierArticleId cannot be filtered anymore.

Changes in /salesInvoice

Added property:

• bookingDate (integer)
• creatorId(string) (readonly)

For a sales invoice, switching from status OPEN_ITEM_CREATED to CANCELLED is only possible if no uncancelled credit notes linked to the sales invoice exist.

Changes in

• /opportunity
• /quotation
• /salesOrder
• /shipment
• /blanketPurchaseOrder
• /performanceRecord
• /incomingGoods
• /purchaseOrderRequest
• /contract

Added property:

• creatorId(string) (readonly)

Changes to /purchaseOrder

purchaseOrderItem.supplierArticleId cannot be filtered anymore.

Added property:

• creatorId(string) (readonly)

New endpoint /article/id/{id}/packagingUnitStructure

Available for: GET

Returns a list of articles that have the same packagingUnitBaseArticleId as the article with the specified id.

Changes in /user

Property status is now editable. Possible values:

• ACTIVE
• NOT_ACTIVE

New endpoint /mailTemplate

Available for: GET, POST, PUT, DELETE.

Properties:

• bccEmailAddresses (string)
• ccEmailAddresses (string)
• creatorId (string, read-only)
• name (string)
• subject (string)
• text (string)
• toEmailAddresses (string)
• type (string)
• useAsDefault (boolean)

New endpoint /recordEmailingRule

Available for: GET, PUT, POST, DELETE.

Properties:

• active (boolean)
• attachRecordDocument (boolean)
• ccRecipients (string)
• event (string, required)
• mailAccountId (string)
• name (string)
• otherRecipients (string)
• recipientType (string, required)
• salesChannels (array)
• salesInvoiceTypes (array)
• salesInvoiceOrigin (string)
• templateId (string, required)

Changes in /ticket

Changed endpoint:

• /ticket/id/{id}/linkSalesOrder
  • Linking to salesOrders that have no services is now possible.
  • Linking to salesOrders that are in their final states (CLOSED, CANCELED, MANUALLY_CLOSED) is no longer possible.

Changed endpoint /shippingCarrier

internalShippingCarrier allows the new value ‘DHL_EXPRESS_ECONOMY_SELECT

Changes in /document

added properties

• documentSize (integer)
• versions.documentSize (integer)
• versions.userId (string)

New endpoint /document/id/{id}/downloadDocumentVersionsZipped

Available for: GET

Query parameters:

• filename (string, optional)
• ids (array, optional)

Changes in /purchaseOrder

Added property:

• supplierQuotationNumber (string)

Changes in /blanketPurchaseOrder

Added property:

• supplierQuotationNumber (string)

Changes in /article

Added property:

•  commissionRate (string)

Create article with the unit that is set in the request (if valid) and not the default unit for the article type.

Changes in /ticket

New additional properties:

• billableTime
• invoiceableTime

Changed endpoint /shippingCarrier

internalShippingCarrier allows the new value ‘DHL_EXPRESS_ECONOMY_SELECT‘

We want to inform you upfront about breaking API changes that will be introduced with the warehouse management release 23.18.1 on September 21st, 2023. All sections titled “Changed endpoint…” contain breaking changes.

New dispositionInfoAvailabilityType

The new type ‘TRANSFER_REQUIRED‘ can show up wherever disposition availability is used. This affects the fields availability and availabilityForAllWarehouses in the following endpoints:

• /productionOrder
• /salesOrder
• /shipment

Changed endpoint /article

Renamed properties:

• defaultWarehouseLevels to defaultStoragePlaces

Added properties:

• defaultLoadingEquipmentIdentifierId (string)
• loadingEquipmentArticleId (string)
• packagingQuantity (integer)
• packagingUnitBaseArticleId (string)
• packagingUnitParentArticleId (string)
• primarySupplySourceId (string)

and articleType allows the new values ‘LOADING_EQUIPMENT‘, ‘LOADING_EQUIPMENT_STORABLE‘ and ‘PACKAGING_UNIT‘.

Changed endpoint /incomingGoods

Added properties: the elements of the incomingGoodsItem array now have a salesOrderItemId (string).

Changes in /incomingGoods/id/{id}/incomingBookings and /incomingGoods/id/{id}/updateIncomingBookings

Renamed properties:

• confirmedByUserId to confirmedByUserIdDeprecated
• confirmedDate to confirmedDateDeprecated
• confirmedQuantity to confirmedQuantityDeprecated
• levelId to storagePlaceId

Note that confirmed by user and confirmed date do exist again (see below), but have a different meaning from before.

Added properties:

• bookIntoWarehouse (boolean)
• confirmedByUserId (string)
• confirmedDate (integer)
• internalTransportReferenceId (string)
• loadingEquipmentIdentifierId (string)

At the end of the update steps, all incoming bookings that were marked with bookIntoWarehouse as true will be booked to the respective storage places.

New endpoint /internalTransportReference

Available for: GET, POST, PUT, DELETE.

Creating and updating internal transport references is only possible for permanent ones. Update can currently only be used to deactivate internal transport references.

Properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• active (boolean)
• internalTransportReferenceNumber (string)
• loadingEquipmentArticleId (string)
• loadingEquipmentIdentifierId (string)
• permanent (boolean)
• warehouseId (string)

New endpoint /internalTransportReference/id/{id}/createLabel (POST)

New endpoint /internalTransportReference/id/{id}/downloadLatestLabel (GET)

New endpoint /loadingEquipmentIdentifier

Available for: GET, POST, PUT, DELETE.

Properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• description (string)
• loadingEquipmentArticles (array)
• name (string)

where loadingEquipmentArticles is an array of id properties referencing articles.

Removed endpoints /migrationStoragePlace, /warehouse/id/{id}/updateStoreMigration

and /warehouseLevel

These are no longer needed as the warehouse migration is complete. The former levels, now storage places, can be found and updated via the storageLocation or shelf endpoint, respectively. For a more direct acess, there also is the (read-only) endpoint storagePlace.

New endpoint /pick (GET)

Provides direct (read-only) access to all picks used in production orders, shipments and transportation orders.

Properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (string)
• version (string)
• batchNumber (string)
• confirmedByUserId (string)
• confirmedDate (integer)
• internalTransportReferenceId” (string)
• quantity (string)
• serialNumbers (array)
• storagePlaceId (string)
• bookedDate (integer)
• orderItemId (string)
• packagingUnitBaseArticleId (string)
• positionNumber (integer)
• productionOrderItemId (string)
• shipmentItemId (string)
• sourceInternalTransportReferenceId (string)
• sourceStoragePlaceId (string)
• transportationOrderId (string)

where serialNumbers is an array of strings (the string values of the repsective serial numbers).

New endpoint /pickCheckReason

Available for: GET, POST, PUT, DELETE.

Properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (string)
• version (string)
• active (boolean)
• description (string)
• name (string)
• positionNumber (integer)

Changed endpoint /productionOrder

Renamed properties:

• withdrawalsComplete to picksComplete
• in the productionOrderItem array
  • actualWithdrawalDate to actualPickDate
  • actualWithdrawalQuantity to actualQuantity
  • targetWithdrawalDate to targetPickDate
  • targetWithdrawalQuantity to targetQuantity

Removed properties:

• allWithdrawalsConfirmed
• assignedPickingUserId
• assignedPickingUserUpdateDate
• assignedPickingUserUsername

can all be managed via the corresponding picking orders.

Added properties:

• assemblyStoragePlaceId (string)

Changed endpoint /salesOrder

Renamed properties:

• in orderItems array
  • withdrawalBatchNumber to pickBatchNumber
  • withdrawalSerialNumbers to pickSerialNumbers
  • withdrawalWarehouseLevelId to pickStoragePlaceId

Added property:

• in orderItems array
  • returnedQuantity (string)

Changed endpoint /salesOrder/id/{id}/addItem

Changes as in the orderItems array above. The added property is not actually relevant for this endpoint. It is a read-only field providing additional information when reading existing sales order items.

Changed endpoint /shipment

Renamed properties:

• destinationWarehouseLevelId to destinationStoragePlaceId
• withdrawalsComplete to picksComplete

Removed properties:

• allWithdrawalsConfirmed
• assignedPickingUserId
• assignedPickingUserUpdateDate
• assignedPickingUserUsername

can all be managed via the corresponding picking orders.

Added properties:

• consolidationStoragePlaceId (string)
• in the shipmentItems array
  • purchaseOrderItemId (string)

Changed endpoint /shelf

that was only for GET is now available for POST, PUT and DELETE as well.

Removed properties: the elements of storagePlaces no longer contain shelfId, storageLocationId and warehouseId as these just duplicated the id, storageLocationId and warehouseId of the respective shelf.

Added properties: the elements of storagePlaces show the new properties as described in the storagePlace endpoint.

New endpoints /shelf/id/{id}/activate (POST) and /shelf/id/{id}/deactivate (POST)

Changed endpoint /storageLocation

that was only for GET is now available for POST, PUT and DELETE as well.

Removed properties: the elements of blockStoragePlaces no longer contain storageLocationId and warehouseId as these just duplicated the id and warehouseId of the respective location.

Added properties:
The elements of storagePlaces show the new properties as described in the storagePlace endpoint.

• customAttributes (array)
• storagePlaceTypeSettingsBlocked (object)
• storagePlaceTypeSettingsPicking (object)
• storagePlaceTypeSettingsStock (object)
  where the three settings properties each have the properties
  • allowMixedStoring (boolean)
  • automaticPlaceAssignment (boolean)
  • multiplePlacesPerBaseArticle (boolean)
  • transportationOrderRequiresFreeSegment (boolean)

New endpoints /storageLocation/id/{id}/activate (POST) and /storageLocation/id/{id}/deactivate (POST)

New endpoint /storagePlace

available for GET

This replaces the old warehouseLevel endpoint and shows the information from there combined with the corresponding migrationStoragePlace. Updates are possible via the storageLocation or shelf endpoint, respectively.

Properties:

• id (string)
• version (string)
• active (boolean)
• barcode (string)
• blockedForResupply (boolean) +
• blockedForResupplyReasonId (string) +
• createdDate (integer)
• customAttributes (array) +
• customerId (string)
• fieldNumber (integer)
• lastModifiedDate (integer)
• levelNumber (integer)
• name (string)
• shelfId (string)
• shelfStorageLocationId (string) +
• storageLocationId (string)
• storagePlaceSizeId (string) +
• storagePlaceType (enum)
• warehouseId (string)

Compared to warehouseLevel, we removed the properties

• deleted does not exist anymore
• deleteInLogisticsMigration as it only was relevant for migration
• parentLevelId of the old warehouse structure roughly corresponds to storageLocationId or shelfId
• forPicking and stockable are replaced by a suitable storagePlaceType
• height, length, width and weight have been migrated to custom attributes

Compared to migrationStoragePlace, the property migratedLevelId is removed as it only was relevant for migration and numberOfField is renamed to fieldNumber, numberOfLevel to levelNumber.

The properties marked with a plus are new, i.e., were present in neither of the two old endpoints.

New endpoint /storagePlaceBlockingReason

Available for: GET, POST, PUT, DELETE.

Properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (string)
• version (string)
• active (boolean)
• description (string)
• name (string)
• positionNumber (integer)

New endpoint /storagePlaceSize

Available for: GET, POST, PUT, DELETE.

Properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• description (string)
• loadingEquipmentIdentifierId (string)
• name (string)
• segmentQuantity (integer)

New endpoint /transportationOrder

Available for: GET, POST, PUT, DELETE.

Properties:

• id (string)
• createdDate (integer)
• lastModifiedDate (integer)
• version (string)
• assignedUserId (string)
• customAttributes (array)
• destinationStoragePlaceId (string)
• internalTransportReferenceId (string)
• loadingEquipmentArticleId (string)
• loadingEquipmentIdentifierId (string)
• picks (array)
• productionOrderId (string)
• shipmentId (string)
• status (string)
• statusHistory (array)
• transportationOrderNumber (string)
• transportationOrderType (string)

where picks is an arry of picks (see /pick endpoint), except they do not repeat the transportationOrderId property.
The possible values for status are ‘NEW‘, ‘IN_TRANSIT‘, ‘IN_INTERIM‘, ‘COMPLETED‘ and ‘CANCELLED‘. transportationOrderType can be ‘PICKING‘ or ‘STOCK_TRANSFER‘.

New endpoint /transportationOrder/id/{id}/createTransportationOrderFromUnpickedRecords (POST)

Properties:

• loadingEquipmentArticleId (string)
• loadingEquipmentIdentifierId (string)

New endpoint /transportationOrder/id/{id}/internalTransportReferencesForPickUp (GET)

Parameters:

• ignoreCurrentLoadingEquipment (boolean)

New endpoint /transportationOrder/id/{id}/pickPick (POST)

Properties:

• pickId (string)
• inputQuantity (string)
• inputSerialNumbers (array)
• preferredPackagingUnitId (string)
• bookLoadingEquipmentOnDissolveOfPreferred (boolean)

New endpoint /transportationOrder/id/{id}/putDownInternalTransportReference (POST)

Properties:

• targetStoragePlaceId (string)
• targetTransportReferenceId (string)
• targetLoadingEquipmentIdentifierId (string)

Changed endpoint /warehouse

that was only for GET is now available for POST, PUT and DELETE as well.

Renamed properties:

• defaultLevelId to defaultStoragePlaceId
• defaultProductionLevelId to defaultProductionStoragePlaceId
• defaultReturnsLevelId to defaultReturnsStoragePlaceId

Removed properties:

• defaultOutgoingGoodsLevelId

Added properties:

• customAttributes (array)
• defaultConsolidationStoragePlaceId (string)
• directBookingInternalTransportReferenceId (string)
• loadingEquipmentStoragePlace (object) with properties
  • id (string)
  • createdDate (integer)
  • lastModifiedDat}e (integer)
  • version (string)
  • customAttributes (array)
  • name (string)
• shortIdentifier (string)
• standard (boolean)
• transitStoragePlace (object) with same properties as the loadingEquipmentStoragePlace above

The warehouse type ‘CONTAINER‘ no longer exists. Note that the warehouse of type ‘DROP_SHIPPING‘ is no longer visible.

New endpoints /warehouse/id/{id}/activate (POST) and /warehouse/id/{id}/deactivate (POST)

Changed endpoint /warehouseStock (GET)

Removed properties:

• reservations, use picks instead
• serialNumber
• serialNumberId, there now is the array of serial number ids

Renamed properties:

• warehouseLevelId to storagePlaceId

Added properties:

• internalTransportReferenceId (string)
• packagingUnitArticleId (string)
• packagingUnitQuantity (string)
• picks (array)
• serialNumbers (array)

Changed endpoint /warehouseStockMovement

Changes for GET

Removed properties:

• serialNumber
• serialNumberId, there now is the array of serial number ids

Renamed properties:

• warehouseLevelId to storagePlaceId

Added properties:

• internalTransportReferenceId (string)
• serialNumbers (array)
• transportationOrderId (string)

There are additional values for the type: ‘IN_DISABLE_TRANSPORT_REFERENCE‘, ‘IN_PACKAGING_UNIT_TRANSFORMATION‘, ‘IN_REPACK_ON_TRANSPORT_REFERENCE‘, ‘IN_TRANSFER‘, ‘OUT_DISABLE_TRANSPORT_REFERENCE‘, ‘OUT_PACKAGING_UNIT_TRANSFORMATION‘, ‘OUT_REPACK_ON_TRANSPORT_REFERENCE‘, ‘OUT_TRANSFER‘
Conversely, the type ‘TRANSFER‘ no longer exists (replaced by ‘IN_TRANSFER‘ and ‘OUT_TRANSFER‘).

New endpoint /warehouseStockMovement/bookDirectStockTransfer (POST)

Properties:

• articleId (string)
• quantity (string)
• sourceStoragePlaceId (string)
• internalTransportReferenceId (string)
• destinationStoragePlaceId (string)
• batchNumber (string)
• serialNumbers (array)
• customAttributes (array)

This is for the simplified direct booking functionality using the direct booking internal transport reference. For more flexibility, explicitly use transportation orders. This new endpoint replaces the following removed endpoint.

Removed endpoint /warehouseStockMovement/bookTransferMovement (POST)

New endpoint /warehouseStockMovement/bookFromLoadingEquipmentPlace (POST)

Properties:

• loadingEquipmentArticleId (string)
• quantity (string)
• targetStoragePlaceId (string)
• targetInternalTransportReferenceId (string)
• movementNote (string)
• customAttributes (array)

Changed endpoint /warehouseStockMovement/bookIncomingMovement (POST)

Renamed properties:

• targetWarehouseLevelId to targetStoragePlaceId

Added properties:

• internalTransportReferenceId (string)
• loadingEquipmentIdentifierId (string)

New endpoint /warehouseStockMovement/bookOntoInternalTransportReference (POST)

Properties:

• articleId (string)
• baseArticleQuantity (string)
• sourceInternalTransportReferenceId (string)
• sourceStoragePlaceId (string)
• targetInternalTransportReferenceId (string)
• loadingEquipmentArticleId (string)
• loadingEquipmentIdentifierId (string)
• bookFromLoadingEquipmentPlace (boolean)
• bookLoadingEquipmentOnDissolveOfPreferred (boolean)
• movementNote (string)
• batchNumber (string)
• serialNumbers (array)
• customAttributes (array)

Changed endpoint /warehouseStockMovement/bookOutgoingMovement (POST)

Renamed properties:

• sourceWarehouseLevelId to sourceStoragePlaceId

Added properties:

• internalTransportReferenceId (string)

New endpoint /warehouseStockMovement/bookToLoadingEquipmentPlace (POST)

Properties:

• loadingEquipmentArticleId (string)
• quantity (string)
• sourceStoragePlaceId (string)
• sourceInternalTransportReferenceId (string)
• movementNote (string)
• customAttributes (array)

Changes in /purchaseOrderRequest

The field disableEmailTemplate is now editable for any status of the supplier request, just like in the UI.

Changes in /shipment

The fields disableEmailTemplate and sentToRecipient are now editable for any status of the shipment, just like in the UI.

Changes in /incomingGoods

The field disableEmailTemplate is now editable for any status of the incoming goods, just like in the UI.

Changes in /purchaseOrder

The fields disableEmailTemplate and sentToRecipient are now editable for any status of the purchase order, just like in the UI.

Changes in /salesOrder

The fields disableEmailTemplate and sentToRecipient are now editable for any status of the sales order, just like in the UI.

Changes in /blanketPurchaseOrder

The fields which can be adjusted for a certain status are now aligned with the UI:

• In status NEW, all fields are editable.
• In status DOCUMENT_PRINTED, only the fields confirmationNumber, description, sentToRecipient and supplierBlanketPurchaseOrderNumber are editable.
• In all other status, only the fields description, sentToRecipient and supplierBlanketPurchaseOrderNumber are editable.

Changes in /userRole

Complementary to the new permission management with user roles (currently in beta) there is a simplified mode for permission management without user roles available during a tenant’s evaluation period. You can enter that simplified mode by disabling user roles (/disableUserRolesDuringTrial) and leave that simplified mode again by enabling user roles (/enableUserRolesDuringTrial).

New endpoints:

• /userRole/enableUserRolesDuringTrial (POST)
• /userRole/disableUserRolesDuringTrial (POST)

Added property:

• allPermissionsEnabled (boolean, read-only)

Changes in /ticket

Changed endpoint:

• /ticket/id/{id}/linkSalesOrder
  • optional property taskIdToOrderItemId (object)

Changes in /document

Add property documentType (string) with possible values:

• ARTICLE_DATASHEET
• ARTICLE_LABEL
• BLANKET_PURCHASE_ORDER
• CONTRACT
• CRM_EVENT_LETTER
• CUSTOMER_ARTICLE_PRICE_LIST
• DUNNING
• INCOMING_GOODS
• INCOMING_GOODS_FROM_RETURN
• INCOMING_GOODS_RETURNS_PICKUP_NOTE
• INVENTORY_TAKING
• PERFORMANCE_RECORD
• PRODUCTION_ORDER
• PURCHASE_INVOICE
• CREDIT_ADVICE
• CREDIT_ADVICE_CANCELLATION
• CREDIT_ADVICE_PRELIMINARY_INVOICE
• CREDIT_ADVICE_UBL
• CREDIT_ADVICE_XR
• PURCHASE_INVOICE_FATTURAPA
• PURCHASE_ORDER
• PURCHASE_ORDER_CANCELLATION
• PURCHASE_ORDER_DEFAULT
• PURCHASE_ORDER_REQUEST
• PURCHASE_ORDER_REQUEST_SUPPLIER_DOCUMENT
• QUOTATION
• QUOTATION_DEFAULT
• SALES_INVOICE
• SALES_INVOICE_CANCELLATION
• SALES_INVOICE_DEFAULT
• SALES_INVOICE_FATTURAPA
• SALES_INVOICE_PRELIMINARY
• SALES_INVOICE_QR
• SALES_INVOICE_UBL
• SALES_INVOICE_XR
• SALES_ORDER
• SALES_ORDER_DEFAULT
• SHIPMENT_CUSTOMS_DECLARATION
• SHIPMENT_DELIVERY_LABEL
• SHIPMENT_DELIVERY_NOTE
• SHIPMENT_DELIVERY_NOTE_DEFAULT
• SHIPMENT_PICKING_LIST
• SHIPMENT_PROFORMA_INVOICE
• SHIPMENT_RETURN_DELIVERY_NOTE
• SHIPMENT_RETURN_LABEL
• SHIPMENT_SERIAL_NUMBERS_CSV
• TICKET

This new property can only be updated for purchaseInvoice documents by using one of the following operations:

• POST /document/upload
• PUT /document/id/ {id}

Sales partners are found under CRM Suppliers instead of CRM Customers from now on

Renamed properties:

• salesPartnerCustomerId to salesPartnerSupplierId
• salesPartnerCustomerNumber to salesPartnerSupplierNumber

Affected endpoints:

• /salesOrder
• /quotation
• /incomingGoods
• /performanceRecord
• /salesInvoice
• /shipment
• /contract
• /party
• /customer
• /lead

Changes in /party

Renamed properties:

• customerFormerSalesPartner to formerSalesPartner
• customerSalesPartner to salesPartner
• customerSalesPartnerDefaultCommissionFix to salesPartnerDefaultCommissionFix
• customerSalesPartnerDefaultCommissionPercentage to salesPartnerDefaultCommissionPercentage
• customerSalesPartnerDefaultCommissionType to salesPartnerDefaultCommissionType

Changes in /customer

Removed properties:

• salesPartner
• salesPartnerDefaultCommissionFix
• salesPartnerDefaultCommissionPercentage
• salesPartnerDefaultCommissionType

Additional Breaking changes:

Changes in /quotation

Removed properties:

• leadId (string): use customerId (string) instead
• leadNumber (string): use customerNumber (string) instead

Changes in /purchaseInvoice

Changed property:

• status (Changed value: “VOID” to “CANCELLED”)

Changes in /salesInvoice

Changed property:

• status (Changed value: “VOID” to “CANCELLED”)

Non-breaking changes:

Changes in /purchaseInvoice

Added property:

• grossPrices (boolean)

Changes in /salesOrder

New endpoint:

/salesOrder/id/{id}/toggleServicesFinished (POST)

Additional properties

In addition to the common properties, there are additional properties that can be optionally queried. These are calculated or complexly determined and must therefore be explicitly queried.
To use this function, only the parameter ‘additionalProperties’ and the names of the additional properties must be specified as a comma-separated list. The response then contains the additional object ‘additionalProperties’ with the property and an array of values. The index of the value object in this list also represents the reference to the respective entity.

See the official API documentation for more information and examples.

Changes in /article

Added additional properties:

• currentSalesPrice
• pickableStockQuantity
• reservedStockQuantity
• totalStockQuantity

Changes in /ticket

Added additional properties:

• • processTime
  • assignmentTime
  • resolutionTime
  • responseTime

Trying to accept the same request item in more than one request offer now yields a dedicated error message instead of an “unexpected exception”.

Changes in /purchaseInvoice

• purchaseInvoiceItemRelationship in purchaseInvoiceItem is now editable
• new properties in purchaseInvoiceItemRelationship:
  • id (string, readonly)
  • version (string, readonly)
  • createDate (integer, readonly)
  • lastModifiedDate (integer, readonly)
• purchaseInvoiceItems are now deletable

Changes in /shippingCarrier

Remove deprecated internal shipment types

• Changed properties:
  • inernalShippingCarrier (string)
  • Removed values: DHL Same Day, Deutsche Post Warenpost, Deutsche Post Warenpost Untracked (international), Deutsche Post Warenpost Signature (international), SWISS_POST, SITTNAK, EKOL, MGH, DACHSER, Seven Senders, Liefery Express, ZWECKFORM

Changes in /purchaseInvoice

New endpoint:

• /purchaseInvoice/id/{id}/createCreditNote (POST)
  • optional property itemIds (array)

Added properties:

• precedingPurchaseInvoiceId (string, read-only)
• creditResetsOrderState (boolean)

When trying to cancel an invoice which is part of a payment run, instead of an internal server error you now get status 400 and an appropriate error message.

Changes in /purchaseOrder

Added property:

• advancePaymentStatus (string, read-only)

Changes in /purchaseOrder/id/:id/createPurchaseInvoice

Added properties:

• invoiceType (string) [Optional, “STANDARD_INVOICE” if not set]
  • Possible values: “STANDARD_INVOICE”, “PART_PAYMENT_INVOICE”, “PREPAYMENT_INVOICE”, “ADVANCE_PAYMENT_INVOICE”, “FINAL_INVOICE”
• paymentAmount (number) [Optional]
• isGross (boolean) [Optional, false if not set]
• invoiceDate (integer) [Optional, now if not set]

Changes for header “Content-Disposition”

Instead of “inline” as before, the Content-Disposition header now contains the value “attachment” for all download endpoints.

New endpoint /articleItemGroup

Available for: GET, POST, PUT, DELETE

Properties:

• name (string)
• items (array)

articleItemGroupItem properties:

• items.articleId (string)
• items.quantity (string)
• items.positionNumber (integer)

Changes in /purchaseInvoice

Initialization of senderCountryCode on POST is corrected: If senderCountryCode is provided, use it (unchanged), else use the recordAddress’ country to determine senderCountryCode (new). If recordAdress is null, use the supplier’s primary address’ country (new).

Changes in /purchaseOrder

Added properties:

• purchaseOrderItem.batchSerialNumbers (array)

batchSerialNumber properties:

• batchNumber (string)
• expirationDate (integer)
• quantity (string, required)
• serialNumbers (array)

Changes in /salesOrder

Add functionality of sales setting ‘Allow changes to items after sales order confirmation’.

Added properties:

• orderItems.manualPlannedWorkingTimePerUnit (boolean)

Changed properties:

• onlyServices (boolean) is now editable (formerly read-only)

Changes in /quotation

Added properties:

• quotationItems.manualPlannedWorkingTimePerUnit (boolean)

Changes in /incomingGoods

Added validations:

• senderPartyId uses the same restrictions as the UI now

Changes in /salesOrder/id/:id/createPurchaseOrder

• Breaking change: Result change from single reference to array reference.
• Changed properties:
  • supplierId (string) is now optional

• Added properties:
  • multiplePurchaseOrders (boolean) [Optional]

Changes in /salesInvoice

Added property:

• precedingSalesInvoiceId (string, read-only)

Validation for inactive articles in records

It is not possible anymore to set inactive articles in records / record items.

Affected endpoints:

• /contract
• /incomingGoods
• /purchaseInvoice
• /purchaseOrder
• /purchaseOrderRequest
• /purchaseOrderRequestOffer
• /quotation
• /salesInvoice
• /salesOrder
• /shipment
• /performanceRecord
• /productionOrder

Field unitCost can now be updpated regardless of status of main entity

The field unitCost can now be updated for items of the entities SalesInvoice, PurchaseInvoice, SalesOrder – regardless of the status (i.e. any status not NEW) of main entity. In this regard the API offers now the same functionality as the UI.

In case the entity does not allow for other fields to be updates – only the unitCost field may be sent as an update – otherwise the update is still prohibited. This is to prevent undesired updates of other fields that should be prohibited

Changes in /ticket

Added properties:

• billableStatus (boolean)
• performanceRecordedStatus (String)
• invoicingStatus (String)

Extend filter

In addition to the default behavior of linking filter expressions via “and” you can also link individual filter expressions via “or” by prefixing their parameter name with “or-“. See the official API documentation for more information and examples.

Remove accountType “GOOGLE_PLUS”

After the service was stopped some time ago, the type “GOOGLE_PLUS” was removed.

Affected endpoints:

• /contact
• /customer
• /lead
• /party
• /supplier

Affected property:

• onlineAccount.accountType

Changes in /paymentRun

Breaking API Change:

Removed property:

• paymentRunItem.purchaseOpenItemId.id (string, read-only)

Added property:

• paymentRunItem.purchaseOpenItemId (string, read-only)

Changes in /paymentRunItem

Removed property:

• purchaseOpenItemId.id (string, read-only)

Added property:

• purchaseOpenItemId (string, read-only)

Changes for ticket

New endpoint /ticketCategory

Available for: GET

Properties:

• active (boolean)
• name (string)
• parentTicketCategoryId (string)
• pseudoCategory (boolean)
• published (boolean)
• visibleInCustomerPortal (boolean)

New endpoint /ticketChannel

Available for: GET,POST,PUT,DELETE

Properties:

• active (boolean)
• positionNumber (integer)
• name (string)
• description (string)

New endpoint /ticketType

Available for: GET,POST,PUT,DELETE

Properties:

• active (boolean)
• positionNumber (integer)
• name (string)
• description (string)

New endpoint /ticketStatus

Available for: GET,POST,PUT,DELETE

Properties:

• name (string)
• color (string)
• positionNumber (integer)
• internalTicketStatus (string)
• defaultForInternal (boolean)
• targetStatusId (string)
• autoChangeDays (integer)
• autoChangeTicketStatusId (string)

New endpoint /ticketServiceLevelAgreement

Available for: GET,POST,PUT,DELETE

Properties:

• active (boolean)
• degreeOfPerformance (integer)
• customers (array)
• types (array)
• categories (array)
• ratingId (string)
• name (string)
• active (boolean)
• visible (boolean)
• includeNoTicketType (boolean)
• targets (array)

New endpoint /ticketFaq

Available for: GET,POST,PUT,DELETE

Properties:

• question (string)
• answer (string)
• positionNumber (integer)
• active (boolean)
• visibility (string)
• ticketCategories (array)
• createdById (string)
• customers (array)

New endpoint /propertyTranslation

Methods:
get /readPropertyTranslations
post /updatePropertyTranslations

Properties:

• propertyName (string)
• values (array)
• values.locale (string)
• values.text (string)

New endpoint /translation

Supported methods: GET, POST, PUT, DELETE

Properties:

• key (string)
• values (array)
• values.locale (string)
• values.text (string)

Changes for document

New endpoint /document/copy

Available for: POST

Properties:

• sourceDocumentId (String)
• entityName (String)
• entityId (String)

New endpoint /document/id/{id}/copy

Available for: POST

Properties:

• sourceDocumentId (String)
• comment (String)

Changes in /customAttributeDefinition

Added property:

• label (string)

Changes in /salesOrder

The description property can now be edited even if the SalesOrder is already completed.

Changes in /salesInvoice

Affected property: salesInvoiceType
Added value: “RETAIL_INVOICE”

Important: To use the below new properties, the new dropshipping logic must be enabled (request via ideas@weclapp.com).

Changes in /party

Added property:

• enableDropshippingInNewSupplySources (boolean)

Changes in /articleSupplySource

Added property:

• dropshippingPossible (boolean)

Changes in /purchaseOrderRequest/id/{id}/createPurchaseOrder

Added property:

• offerItemToUpdateSupplierInformation.updatePurchasePrice (boolean), false only possible for dropshipping requests

Changes in /purchaseOrderRequest

Added property:

• purchaseOrderRequestItems.freeTextItem (boolean)

Changes in /salesOrder/id{id}/createDropshipping

If the ERP setting “Allow selection of articles without supply sources” is inactive, the sales order only contains article items and none of them has a supply source at supplier S, an error message is issued when trying to create a dropshipping purchase order at S, just like in the UI.

Changes in /purchaseOrder/id/{id}/createPurchaseInvoice

Added optional parameter invoiceDate (integer)

Changes in /party

Added properties:

• supplierInternalNote (string)
• customerInternalNote (string)

Changes in /tax

Added property:

• depositAccountId (string)

Changes in /shipment

Property shippingLabelsCount can be updated regardless of shipment status.

Changes in /ticket

Contacts can be changed via API consistent to UI.

Changes in /costCenter

The endpoint also supports PUT, POST and DELETE now.

Changes in /warehouseStockMovement

Added property:

• costCenterId (string)

Changes in /purchaseOrder

Added property:

• confirmationNumber (string)

If any item in the purchase order is linked to a blanket purchase order, trying to change the supplier will produce the error message “blanket purchase order has a different supplier”.

Changes in /salesOrder

Order item property plannedWorkingTimePerUnit is now validated to be equal to the order item unit’s amount of hours in default unit for hour if invoicing type is “EFFORT” (also: unit has to be a time unit).

Changes in /salesOrder/id/{id}/createDropshipping

The endpoint behavior is now aligned with the UI:

• The description is inherited from the sales order.
• If sales order and purchase order have common additional fields, the values are inherited from the sales order.
• The shipment type is set according to the purchase setting “Shipment type for sales order commissions / dropshipping purchase orders”
• It is not possible to create a dropshipping purchase order if the sales order
  • is a retail sale or a consignment order,
  • has been manually closed or cancelled,
  • is without weclapp shipment,
  • only contains free-text items or
  • only contains items which are already included in shipments with full order quantity.
• It is not possible to create a dropshipping purchase order if the sales order workflow action “Start dropshipping” is inactive.

Changes in /salesOrder/id/{id}/createPurchaseOrder

The endpoint behavior is now aligned with the UI:

• The description is inherited from the sales order.
• The warehouse is inherited from the sales order if no warehouseId is provided as a parameter.
• If sales order and purchase order have common additional fields, the values are inherited from the sales order.
• The shipment type is set according to the purchase setting “Shipment type for sales order commissions / dropshipping purchase orders”
• It is not possible to create a purchase order if the sales order
  • is a retail sale or a consignment order,
  • has been manually closed or cancelled,
  • has a fulfillment provider != “weclapp shipment” set
  • only contains free-text items or
  • only contains items which are already included in shipments with full order quantity.
• It is not possible to create a purchase order if the sales order workflow action “Create sales order commission” is inactive.

Changes in /unit

Added property:

• defaultUnitHourAmount (string)

Changes in /termOfPayment

Added property:

• datevTermOfPaymentNumber (integer)

Changes in /contract

The differing shipping address and the differing inovice address can be changed via API consistent to UI.

Changes for /purchaseOrderRequest

Added property:

• purchaseOrderRequestOffers.purchaseOrderRequestOfferItems.useSupplierArticleNumber (boolean)

Changes in /purchaseOrderRequest/id/{id}/createPurchaseOrder

Added property:

• offerItemToUpdateSupplierInformation.createOrUpdateArticleSupplySource (boolean)

Like in the UI, it is now possible to create multiple purchase orders from one supplier request offer, provided that, at the time of creation, there are still accepted offer items not yet included in purchase orders or blanket purchase orders.

Changes in /salesOrder/id/{id}/createDropshipping

To ensure a fluent dropshipping workflow, tax rules of a foreign country are initialized automatically before dropshipping purchase order creation, just like in the UI.

Changes in /blanketPurchaseOrder

Omitting the required property discountPercentage on PUT now triggers the error message “discountPercentage is required” (with status code 400) instead of the generic “persistence error” (with status code 409).

Changes in /purchaseOrder/id/{id}/createIncomingGoods

It is not possible anymore to create an incoming goods for a purchase order which only contains service items.

Changes in /contracts

Added property contractCostItems (array) with following sub-properties:

• articleId (string)
• title (string)
• description (string)
• descriptionFixed (string)
• quantity (string)
• unitPrice (string)
• unitPriceInCompanyCurrency (string)
• manualUnitPrice (boolean)
• note (string)
• discountPercentage (string)
• netAmount (string)
• netAmountInCompanyCurrency (string)
• interval (string)
• intervalType (string)
• unitId (string)
• servicePeriodFrom (integer)
• servicePeriodTo (integer)

Changes in /article

Added property defineIndividualTaskTemplates (boolean).

Changes in /ticket

Added properties:

• language (string)
• room (string)

Changes in /blanketPurchaseOrder

• It is not possible anymore to create a blanket purchase order for a supplier with order stop, just like in the UI.
• Omitting articleId or supplierId on PUT/POST now triggers a dedicated error message.

Changes in /purchaseOrderRequest/id/:id/createPurchaseOrder

• Purchase order creation now works for types SALES_ORDER_COMMISSION_REQUEST and DROP_SHIPPING_REQUEST.
• Before the purchase order creation, the supplier request offer is validated like in the UI:
  • one order item cannot be linked to multiple offer items,
  • all offer items must be linked to a sales order item (if purchaseOrderRequestType = DROP_SHIPPING_REQUEST),
  • at least one sales order item must be selected for each purchase order (if purchaseOrderRequestType = SALES_ORDER_COMMISSION_REQUEST).

Changes in /quotation

In systems that didn’t work with projects in the last half year it is no longer possible to create quotations with the type ‘PROJECT’ or change current quotations to the type ‘PROJECT’. Working with or accepting already present quotations of that type is still possible.

New endpoint /quotation/id/{id}/inquire (POST)

Body parameter:

• taskId (string, optional)

New endpoint /quotation/id/{id}/accept (POST)

Body parameters (optional):

• quotationItems.quotationItemId (string)
• quotationItems.quantity (string)

Provide support for open items

Changes to /paymentRun

Breaking API Change:

Removed property:

• paymentRunItem.openItem (object)

Added property:

• paymentRunItem.purchaseOpenItemId (string)

New endpoint /purchaseOpenItem

Available for: GET.

Properties:

• amount (string)
• amountDiscount (string)
• amountOpen (string)
• amountPaid (string)
• cleared (boolean)
• clearanceDate (integer)
• openItemNumber (string)
• openItemType (string)
• paymentApplications (array, object)
• purchaseInvoiceId (string)

Additional endpoint: /purchaseOpenItem/id/{id}/createPaymentApplication

Available for: POST.

New endpoint /salesOpenItem

Available for: GET.

Properties:

• amount (string)
• amountDiscount (string)
• amountOpen (string)
• amountPaid (string)
• cleared (boolean)
• clearanceDate (integer)
• openItemNumber (string)
• openItemType (string)
• paymentApplications (array object)
• salesInvoiceId (string)

Additional endpoint: /salesOpenItem/id/{id}/createPaymentApplication

Available for: POST.

Changes for article

Changes in /article

It is not possible anymore to add an article of type “SHIPPING_COST” to productionBillOfMaterialItems.

Added property:

•  defaultPriceCalculationType (string)

Possible values: [“MARGIN_CALCULATION”, “PURCHASE”, “RECOMMENDED_RETAIL_PRICE”, “SALES”]

Changes in /article/id/{id}/createLabelPdf

Creation of labels for shipping cost articles is not possible, just like in the UI.

Provide support for ticketing

New endpoint /ticket

Available for: GET, POST, PUT, DELETE.

Properties:

• assignedUserId (string)
• billable (boolean)
• ccEmailAddresses (string)
• contactId (string)
• contractId (string)
• description (string)
• disableEmailTemplates (boolean)
• email (string)
• entityReferences (array)
• finishedDate (integer, readonly)
• firstName (string)
• lastName (string)
• legacyArticleId (string)
• legacyTimeAndMaterialTicket (boolean)
• mail2TicketId (string, readonly)
• mobilePhoneNumber (string)
• note (string)
• partyId (string)
• phoneNumber (string)
• publicPageExpirationDate (integer, readonly)
• publicPageUuid (string, readonly)
• resolvedYourIssue (boolean, readonly)
• responsibleUserId (string)
• solutionDueDate (integer)
• subject (string, mandatory)
• tags (array)
• ticketCategoryId (string)
• ticketChannelId (string)
• ticketNumber (string)
• ticketPriorityId (string, mandatory)
• ticketRating (string) – possible values: [“STARS_1”, … “STARS_5”]
• ticketRatingComment (string, readonly)
• ticketRatingDate (integer, readonly)
• ticketServiceLevelAgreementId (string)
• ticketStatusId (string)
• ticketTypeId (string)

The following property cannot be changed or set to “true” if legacy time and material tickets are generally not possible in the system:

• legacyTimeAndMaterialTicket

New endpoint /ticket/id/{id}/createPublicPage

Available for: POST.

New endpoint /ticket/id/{id}/disablePublicPage

Available for: POST.

Improvements for custom attributes

Provide the support for custom attributes of type REFERENCE to be able to filter by the id of the referenced entity.

Example query parameter: ?customAttribute<id1>.entityReferences.entityId-eq=<id2>

Changes in /purchaseOrderRequest

Trying to add more than ten offers to the purchase order request now triggers a dedicated error message intead of the generic “unexpected exception”.

Trying to add offers with the same supplier used more than once now triggers a dedicated error message intead of the generic “unexpected exception”.

Create/download contract document

New endpoint /contract/id/{id}/createContractDocument

Available for: POST.

New endpoint /contract/id/{id}/downloadLatestContractDocumentPdf

Available for: GET.

Changes in /salesOrder

The following properties are now validated to be null if fulfillmentProviderId is null:

• defaultShippingCarrierId
• shipmentMethodId

Changes for Supplier Request

Changes in /purchaseOrderRequest

It is not possible anymore to create a supplier request offer for a supplier with order stop, just like in the UI.

Changes in /purchaseOrderRequest/id/{id}/createPurchaseOrder

It is not possible anymore to create a purchase order from a supplier request offer whose supplier is order-stopped, just like in the UI.

Changes in /purchaseOrderRequest/id/{id}/createBlanketPurchaseOrder

It is not possible anymore to create a blanket purchase order from a supplier request offer whose supplier is order-stopped, just like in the UI.

Changes in /shipment

Added property:

• responsibleUserId (string)

Changes in /incomingGoods

Added property:

• responsibleUserId (string)

Download purchase order documents and create/download dropshipping delivery note

Provides support to download purchase order documents and to create/download dropshipping delivery note.

New endpoints:

• /purchaseOrder/id/{id}/createDropshippingDeliveryNotePdf (POST)
• /purchaseOrder/id/{id}/downloadLatestPurchaseOrderPdf (GET)
• /purchaseOrder/id/{id}/downloadLatestDropshippingDeliveryNotePdf (GET)

Changes in /salesOrder

Affected property:

• /salesOrder/id/{id}/createDropshipping, /salesOrder/id/{id}/createPurchaseOrder

It is not possible anymore to create (dropshipping) purchase orders for a supplier with order stop.

Changes in /salesInvoice

Added property:

• salesInvoiceItems.serialNumbers (string, read-only)

Changes in /article

Added properties:

• contractBillingMode (string)
• contractBillingCycle (string)

Changed property:

• articlePrices.reductionAdditions.type

Possible values: [“ADDITIONAL_ABS”, “REDUCTION_ABS”, “ADDITION_PERCENT”, “REDUCTION_ABSOLUTE”]
Removed values: [“REBATE_PERCENT”]

Changes in

• /quotation
• /salesOrder
• /salesInvoice
• /purchaseOrder
• /purchaseInvoice
• /contract
• /purchaseOrderRequest

Affected property:

• {their respective items list}.reductionAdditionItems.type

Possible values: [“ADDITION_ABSOLUTE”, “REDUCTION_ABSOLUTE”, “ADDITION_PERCENT”, “REDUCTION_ABSOLUTE”]
Removed values: [“REBATE_PERCENT”]

Changes in /accountingTransaction

Affected property: type

Added value: “CARRY_FORWARD”

Changes in /articleSupplySource

Absence/nullness of the property articleNumber now produces a dedicated error message instead of the generic “persistence error”.

Changes in /article, /articleSupplySource

Added property:

• internalNote (string)

Changes in /priceCalculationParameter

Added properties:

• margin (string)
• profit (string)

Changes in /salesOrder

Added properties:

• projectGoals (string)
• plannedProjectStartDate (integer)
• plannedProjectEndDate (integer)
• servicesFinished (boolean, readOnly)
• onlyServices (boolean, readOnly)

Changes in /tax

Added property:

• taxKey (string)

New endpoint /taxDeterminationRule

Available for: GET, POST, PUT, DELETE.

Added properties:

• accountingCodeId (string)
• customerDebtorAccountingCodeId (string)
• dispatchCountryCode (string)
• endDate (integer)
• partyType (string)
• recipientCountryCode (string)
• sales (boolean)
• startDate (integer)
• taxId (string)
• taxRateType (string)
• validVatId (boolean)