Очередь предложений

Свежие сверху; страницы курсором (номер последнего предложения страницы).

Доступ: company.read.

Доступно по ключу API.

GET /v1/companies/{co}/proposals

Очередь предложений

cURL

curl --request GET \
  --url https://api.tungo.kz/v1/companies/{co}/proposals \
  --cookie tungo.session_token=

200

{
  "data": [
    {
      "id": "P-000123",
      "kind": "sale",
      "kind_title": "Реализация товаров и услуг",
      "status": "previewed",
      "status_title": "Ждёт решения",
      "created_at": "2026-07-10T09:15:00.000Z",
      "level": "L0",
      "level_title": "Предложение, одобряет человек",
      "title": "Реализация товаров и услуг от 2026-07-10 · ТОО «Пример»",
      "total": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "vat": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "line_count": 123,
      "warning_count": 123,
      "blocker_count": 123,
      "approval": {
        "allowed": true,
        "requires_right": "proposals.approve",
        "blocked_by_blockers": true,
        "reason": "<string>"
      },
      "approval_request": {
        "can_request": true,
        "requested": {
          "by": "<string>",
          "by_name": "Айгерим Сапарова",
          "at": "2023-11-07T05:31:56Z",
          "note": "<string>"
        },
        "href": "<string>"
      },
      "dialog_id": "<string>",
      "origin": {
        "source": "chat",
        "dialog_id": "<string>",
        "batch_id": "<string>",
        "run_id": "<string>"
      },
      "href": "/v1/companies/co_01jx0000000000000000000000/proposals/P-000123",
      "counterparty": {
        "ref": "00000000-0000-0000-0000-000000000000",
        "name": "ТОО «Пример»",
        "bin": "000000000000"
      },
      "document_number": "0000-000123"
    }
  ],
  "next_cursor": "aud_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "total": 123,
  "counts": {
    "previewed": 3,
    "verified": 12
  },
  "approval_requested_count": 123
}

Авторизации

sessionapiKeybearerKey

tungo.session_token · string · cookie · обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

co · string · обязательно

id компании, co_… — из GET /v1/companies

Параметры запроса

status · string

Только в этих статусах: один или несколько через запятую (previewed, approved, rejected, committed, posted, verified, mismatch, failed); без него — все. Неизвестный — 400

Пример:

"previewed,approved"

kind · string

Только этих видов: один или несколько через запятую (sale, purchase, bank_receipt, bank_payment, counterparty, contract, revert, inventory_writeoff, cash_order_in, cash_order_out, advance_report). Неизвестный — 400

Пример:

"sale,purchase"

date_from · string<date>

Созданные не раньше этого дня (ГГГГ-ММ-ДД, день по Алматы)

Пример:

"2026-07-01"

date_to · string<date>

Созданные не позже этого дня включительно (ГГГГ-ММ-ДД, день по Алматы)

Пример:

"2026-07-31"

q · string

Поиск без учёта регистра: номер предложения (P-…), номер документа 1С, контрагент (имя из превью), БИН/ИИН, сумма (как пишут: «150 000,50» или 150000.5) и другие реквизиты документа

Пример:

"Пример"

source · string

Только из этих источников (origin.source): один или несколько через запятую (chat, statement, esf, automation). Неизвестный — 400

Пример:

"statement"

approval_requested · enum<string>

true — только отправленные на одобрение и ещё не решённые; false — только остальные

Доступные опции: true, false

batch_id · string

Только документы одного задания пачки (bat_…) — тот же состав, что в сводке задания и у «Одобрить и отправить в 1С». Не id задания — 400; задания нет — пустой список

cursor · string

next_cursor из ответа прошлой страницы; без него — первая (самая свежая) страница. Остальные фильтры — те же, что у первой страницы.

limit · integer

Сколько на странице: 1–100, по умолчанию 20

Требуемый диапазон: 1 <= x <= 100

Ответ

200

application/json

Страница очереди

Страница очереди предложений, свежие сверху

data · object[] · обязательно

Предложения страницы, свежие сверху

Show child attributes

next_cursor · string | null · обязательно

Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и ?cursor=<это значение>. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор непрозрачный: не разбирать и не собирать самому, хранить только до следующего запроса. Пустой data с не-null курсором не бывает.

Пример:

"aud_01jz8x3m4n5p6q7r8s9t0v1w2x"

total · number · обязательно

Сколько предложений подходит под все фильтры (на всех страницах)

counts · object · обязательно

Сколько предложений в каждом статусе (ключ — ProposalStatus) — для бейджей вкладок; статусов без предложений нет. Считается в пределах source и batch_id (откуда и из какой пачки), остальные фильтры (status, kind, даты, q) на счётчики не влияют

Show child attributes

Пример:

{ "previewed": 3, "verified": 12 }

approval_requested_count · integer · обязательно

Сколько предложений ждёт решения по просьбе («Отправить на одобрение») — в тех же пределах, что counts