Files
dashback/docs/api/routes/order/list.md
2026-10-12 19:48:04 +02:00

3.1 KiB

GET /order

Protected. Requires a valid session cookie (credentials: 'include').

List orders

Lists sales orders (manifest rows with type = 'order') for the authenticated user's selected company. Results are paged, include line items, shipping, payment, and provide total unpaged count.

Query parameters

Param Required Type Description
offset no integer Number of orders to skip
limit no integer Number of orders to return

Response 200

Order list

{
  "orders": [
    {
      "id": 1,
      "number": "…",
      "type": "order",
      "entityId": 1,
      "date": "2026-08-10T00:00:00.000Z",
      "createdAt": "2026-08-10T00:00:00.000Z",
      "lines": [
        {
          "id": 1,
          "sku": "…",
          "name": "…",
          "pu": 1,
          "amount": 1,
          "net": 1,
          "rebate": 1,
          "taxrate": 1,
          "comment": "…"
        }
      ],
      "shipping": {
        "id": 1,
        "manifestId": 1,
        "number": "…",
        "trackingCode": "…",
        "carrier": "…",
        "type": "…",
        "state": "…"
      },
      "shippings": [
        {
          "id": 1,
          "manifestId": 1,
          "number": "…",
          "trackingCode": "…",
          "carrier": "…",
          "type": "…",
          "state": "…"
        }
      ],
      "payment": {
        "id": 1,
        "accountId": 1,
        "manifestId": 1,
        "type": "…",
        "amount": 1
      },
      "payments": [
        {
          "id": 1,
          "accountId": 1,
          "manifestId": 1,
          "type": "…",
          "amount": 1
        }
      ],
      "paid": true,
      "shipped": true,
      "delivered": true,
      "orderTotal": 1,
      "paidTotal": 1,
      "orderedQuantity": 1,
      "shippedQuantity": 1,
      "shipments": [
        {
          "id": 1,
          "number": "…",
          "type": "shipment",
          "entityId": 1,
          "externalNumber": "…",
          "date": "…",
          "createdAt": "…",
          "lineCount": 1,
          "packageCount": 1,
          "lines": [
            {
              "id": 1,
              "sku": "…",
              "name": "…",
              "pu": 1,
              "amount": 1,
              "net": 1,
              "rebate": 1,
              "taxrate": 1,
              "comment": "…"
            }
          ],
          "shippings": [
            {
              "id": 1,
              "manifestId": 1,
              "number": "…",
              "trackingCode": "…",
              "carrier": "…",
              "type": "…",
              "state": "…"
            }
          ]
        }
      ]
    }
  ],
  "total": 1,
  "offset": 1,
  "limit": 1
}

Errors

Status Description
400 Invalid offset, invalid limit, or no company selected — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized — {"error":"…"}
404 Company not found — {"error":"…"}

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.