Перейти к содержимому
BILLZ для разработчиков

Прибыли и убытки

GET
/v1/profit-and-lose
curl --request GET \
  --url 'https://api-admin.billz.ai/v1/profit-and-lose?start_date=2026-08-01&end_date=2026-08-31&shop_ids=09737a5c-19ee-4eb2-af02-4bdabf8a15e5%2Cb03661ba-731a-4e50-8f37-d220b89d718e&currency=UZS' \
  --header 'Authorization: Bearer <token>' \
  --header 'accept-language: ru' \
  --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'

Требуемые права: «Прибыль и убытки».

Коды ошибок: 400 — ошибка валидации входных данных; 404 — объект не найден; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.

Authorizations

Заголовок раздела «Authorizations»

Parameters

Заголовок раздела «Parameters»

Query Parameters

Заголовок раздела «Query Parameters»
start_date
string format: date
Example
2026-08-01

Формат YYYY-MM-DD, без времени

end_date
string format: date
Example
2026-08-31

Формат YYYY-MM-DD, без времени

shop_ids
Array<string>

При пустом — все магазины компании

Example
[
  "09737a5c-19ee-4eb2-af02-4bdabf8a15e5",
  "b03661ba-731a-4e50-8f37-d220b89d718e"
]
currency
string

Валюта сумм отчёта

Example
UZS

Header Parameters

Заголовок раздела «Header Parameters»
accept-language
string
default: ru

Uz|ru|en, иначе ru

platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Идентификатор платформы. Для интеграций используется статичное значение.

Responses

Заголовок раздела «Responses»

200

Заголовок раздела «200»

Успешный ответ

Media typeapplication/json
object
shops

Данные отчёта по магазинам

Array<object>
object
account_id
string
account_name
string
income
object
sale_price

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
discount

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
returned_price

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
net_revenue

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
total

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
categories
Array<object>
object
rounding_amount

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
net_revenue_without_rounding

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
expense
object
import

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
write_off

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
total

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
margin_profit

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
margin_profit_percent

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
categories
Array<object>
object
profit

Суммы по периодам: ключ — начало периода, total — итог за весь интервал

object
total
number
key
additional properties
number
dates

Список периодов, служащих ключами всех map-полей

Array<string>
Examplegenerated
{
  "shops": [
    {
      "account_id": "example",
      "account_name": "example",
      "income": {
        "sale_price": {
          "total": 1
        },
        "discount": {
          "total": 1
        },
        "returned_price": {
          "total": 1
        },
        "net_revenue": {
          "total": 1
        },
        "total": {
          "total": 1
        },
        "categories": [
          {}
        ],
        "rounding_amount": {
          "total": 1
        },
        "net_revenue_without_rounding": {
          "total": 1
        }
      },
      "expense": {
        "import": {
          "total": 1
        },
        "write_off": {
          "total": 1
        },
        "total": {
          "total": 1
        },
        "margin_profit": {
          "total": 1
        },
        "margin_profit_percent": {
          "total": 1
        },
        "categories": [
          {}
        ]
      },
      "profit": {
        "total": 1
      }
    }
  ],
  "dates": [
    "example"
  ]
}