Get

[POST] .../v1/itempricelog/get

Returns history change prices items. Use this method to read item price change history after ItemPrice/Get shows only the current price. The response returns ItemPriceLog records with document type, document code, translated document type name, price type, value and last_update; the request supports item_id and price_type_id filters while item_ids and price_type_ids fields. The caller must have item price log select permission 392 and the request must provide at least one item_id or price_type_id filter. Missing body, missing or empty required filters, denied access, translation lookup failures and database errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.

Filterable Fields

Field Type Description
item_id int Item IDs. Optional when price_type_ids is provided; if sent, the array must not be empty.
price_type_id int Price type IDs. Optional when item_ids is provided; if sent, the array must not be empty.

Request Example

{
  "filters": [
    {
      "Field": "item_id",
      "Operator": "In",
      "Value": "24"
    },
    {
      "Field": "price_type_id",
      "Operator": "In",
      "Value": "1"
    }
  ]
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Array of ItemPriceLog Result array.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 9001,
      "item_id": 24,
      "document_date": 1712345600,
      "document_type_id": 1,
      "document_id": 7001,
      "document_type_name": "Purchase",
      "document_type_name_var": "app_doc_type_name_1",
      "document_code": "PUR-00007001",
      "doc_date": 1712345600,
      "doc_type_name": "Purchase",
      "doc_type_name_var": "app_doc_type_name_1",
      "doc_code": "PUR-00007001",
      "value": 42000,
      "price_type": {
        "id": 1,
        "name": "Retail",
        "round_to": 100,
        "markup": 0,
        "max_discount": 0,
        "last_update": 1712345600
      },
      "last_update": 1712345600
    }
  ]
}