Releases · xentral/api-spec-public

The Created At field will now be filled with the current date for new sales orders, and with the earliest logged date from the protocol for existing orders.

### List sales orders
# @name salesOrder.list
GET {{base_url}}/salesOrders?page[number]=1&page[size]=10
Accept: application/vnd.xentral.default.v1-beta+json
Authorization: Bearer {{auth_token}}

### Response
...
      "log": {
        "createdAt": "2022-02-23 11:09:50",
        "createdBy": {
          "id": "1",
          "name": "Administrator"
        }
      }
    }

Assets 2

24 Mar 13:49

MarkRatFelt

v23.0.30

284ea34

Webhooks and Sales Order API

You can now subscribe to an event that will be generated whenever the product is created using webhooks.
External developers can now create, read, update and delete a product's purchase prices via the API.
We have streamlined the statuses in the sales order API's LIST and VIEW endpoints to be consistent with other document types like invoices.
We have improved the structure of the LIST and GET endpoints for sales orders.

{
  "data": {
    "id": "string",
    "orderNumber": "string",
    "externalOrderNumber": "string",
    "customerOrderNumber": "string",
    "date": "2023-03-22",
    "status": "completed",
    "customer": {
      "id": "string",
      "number": "string"
    },
    "comment": "string",
    "project": {
      "id": "string"
    },
    "description": "string",
    "language": "string",
    "payment": {
      "method": "string",
      "currency": "string",
      "paymentTerms": {
        "earlyPaymentDiscount": 0,
        "dueDate": 0,
        "earlyPaymentDate": 0
      },
      "billingAddress": {
        "name": "string",
        "department": "string",
        "subDepartment": "string",
        "street": "string",
        "zipCode": "string",
        "city": "string",
        "state": "string",
        "country": "string",
        "gln": "string"
      }
    },
    "delivery": {
      "email": "string",
      "conditions": "string",
      "autoShipping": true,
      "fastLane": true,
      "shippingAddress": {
        "name": "string",
        "department": "string",
        "subDepartment": "string",
        "street": "string",
        "zipCode": "string",
        "city": "string",
        "state": "string",
        "country": "string",
        "gln": "string"
      }
    },
    "positions": [
      {
        "id": "string",
        "quantity": 0,
        "comment": "string",
        "product": {
          "id": "string",
          "number": "string",
          "name": "string",
          "description": "string"
        },
        "tax": {
          "rate": 0,
          "vatCategory": "string",
          "fiscalText": "string"
        },
        "price": {
          "amount": "string",
          "currency": "EUR",
          "discount": "string"
        }
      }
    ]
  }
}