Payments

[POST] .../v1/retailreport/payments

Returns retail sale and return amounts grouped by payment type. Use this method to retrieve retail sale and return amounts grouped by payment type for a selected reporting period. The request requires start_date and end_date as Unix time in seconds, optionally limits data by operating_cash_ids and returns result with sale_amount and return_amount per payment method. The method reads report data only and does not change documents; it requires the current request user to have retail report access, validates that start_date is before end_date and that the period is not longer than one month and returns validation, permission and storage failures as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
end_date Int64 Required Period end date as Unix time in seconds.
operating_cash_ids Array of Int64 Optional Operating cash register IDs.
start_date Int64 Required Period start date as Unix time in seconds.

Request Example

{
  "end_date": 1,
  "operating_cash_ids": [
    1
  ],
  "start_date": 1
}

Response Parameters

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

Response Example

{
  "ok": true,
  "result": [
    {
      "payment_type_name": "string",
      "return_amount": 1.0,
      "sale_amount": 1.0
    }
  ]
}