Logic4

Logic4 API - New v3.0 endpoints

Terug naar beginpagina

Introduction

All endpoints are now available with v3.0. Differences compared to the old endpoints (versions v1.0 to v2.0) include:

Problem details

Responses to unsuccessful requests are now provided in the problem details format. Problem details are a standardized response for unsuccessful requests, providing information for computers to parse as well as for humans to understand.

For more information, see the response format documentation.

No wrappers

Successful results are no longer wrapped in Logic4Response or Logic4ResponseList objects. This simplifies processing the response.

Formatted JSON format

All v3.0 endpoints (and higher versions) use the most compact JSON possible. The following is stripped from the response:

This saves up to 30% of bandwidth, resulting in faster responses.

Request body changes

Request body parsing for V3 endpoints more closely adheres to standards.

Notable changes include:

Dates must follow ISO 8601

No longer allowed: "DateTime": "19-3-2026", "DateTime": "2026-3-19 9:28" (and many other variations)

Replacement: "DateTime": "2026-03-19", "DateTime": "2026-03-19T09:28:00"

Numbers or boolean literals may not be used in place of strings

No longer allowed: "Text": 12, "Text": true

Replacement: "Text": "12", "Text": "true"

Property names and string must be surrounded by double quotes

No longer allowed: 'Property': 'value', Property: "value"

Replacement: "Property": "value"

Comments are no longer permitted

Examples: // I am a comment, /* I am also a comment */

These must be removed before sending the request.

Changes in new endpoints

Some endpoints have been modified during their transition to v3. The existing endpoints are unchanged. Details of the new functionality can be found in the documentation for the new endpoints.

Notable changes include:

Some success responses have been optimised

Endpoints which used to always return 'true' or a hardcoded string upon success now return an empty body instead. Some information which was already present in the request body is no longer returned in responses. More endpoints now return the ID of newly created entities.

Validation has been improved

Various requests which used to return HTTP 500 now return a HTTP 400 response instead.

Stricter requirement for TakeRecords/SkipRecords

The fields TakeRecords/SkipRecords are now required on more endpoints.

Move to HTTP method DELETE

Some endpoints which provide delete functionality have been moved to using the HTTP method DELETE, and their arguments have been moved from the request body to the query string.

/v3/Orders/AddOrderRowSerialNumbers no longer allows partial successes

If any order row ID is invalid, the request is cancelled and a HTTP 400 response is returned.

/v3/Orders/GetOrderRows and /v3/Orders/GetInvoiceRows have refined responses

These endpoints now correctly return only order rows or invoice rows respectively. /v3/Orders/GetOfferRows has been added to provide results which are no longer returned by GetOrderRows or GetInvoiceRows.

Obsoleted endpoints

Some redundant endpoints do not have a v3.0 version as the same functionality is provided by different endpoints.

/Pickbons/ProcessPickbon

/v3/Pickbons/ProcessPickbons can be used instead.

/Pickbons/GetOrderHeadPickbonRowsForMultiplePickbons

/v3/Pickbons/GetOrderHeadPickbonRows can be used instead as this new version supports multiple pickbons in one request.

/Shipments/AddShipmentForInvoiceOrOrderWithEmailing

/v3/Shipments/AddShipmentForInvoiceOrOrder can be used instead as this new version contains identical functionaliy to optionally send emails.

Backwards compatibility

The old endpoints with versions v1.0 to v2.0 are still supported, but for a limited time. We have not yet determined when these endpoints will be removed. We strongly recommend switching to v3.0 endpoints.