Get

[POST] .../v1/docadditionalexpensesoperation/get

Returns operation additional expenses. Use this method to retrieve operation rows of a single additional expenses document, including service item details, quantity, order, cost, price, VAT and update time. The request requires the additional expenses operation select permission; the document_id filter is required, while id, item_id, search, sort_orders, limit and offset narrow and order the returned rows. The response returns a paged list with next_offset and total and the method is typically used after DocAdditionalExpenses/Get or before editing, deleting or posting additional expenses rows. Business errors such as missing body, missing or invalid document_id, oversized filter selections, denied access, invalid filters or sort_orders, database failures or persistent lookup errors are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
filters Array of Filter Required Filters by fields available for this API method. Required filter fields: document_id.
limit Int32 Optional Returned data limit for the request. The default and maximum values are defined by the server-side query_limit setting.
offset Int32 Optional Offset from the beginning of the result set.
search String Optional Search by item name, article, code and barcode.
sort_orders Array of DocumentOperationSortOrder Optional Sort orders. Supported columns are document_id, id, item_id, item_name, quantity, cost, price, vat_value, order and last_update.

Filterable Fields

Field Type Required Description
document_id int Required
id int Optional
item_id int Optional

Request Example

{
  "filters": [
    {
      "field": "document_id",
      "operator": "Equal",
      "value": "56"
    }
  ],
  "sort_orders": [
    {
      "column": "order",
      "direction": "ASC"
    },
    {
      "column": "id",
      "direction": "ASC"
    }
  ],
  "limit": 50,
  "offset": 0
}

Response Parameters

Name Type Description
next_offset Int32 Offset for the next data page.
ok Boolean Indicates whether the request completed successfully.
result Array of DocAdditionalExpensesOperation Result array.
total Int64 Total number of result items.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 5001,
      "document_id": 56,
      "item": {
        "id": 901,
        "code": "SRV-FREIGHT",
        "name": "Freight service",
        "type": "Service"
      },
      "quantity": 1.000,
      "order": 10,
      "cost": 250000.000,
      "price": 250000.000,
      "vat_value": -1.00,
      "vat_calculation_type": "No",
      "last_update": 1714553600
    }
  ],
  "next_offset": 0,
  "total": 1
}