Отправить на одобрение

Человек, который готовит документы, но не вправе записывать их в 1С, просит решения у тех, у кого право proposals.approve: им уходит письмо «документы ждут решения», просьба видна в карточке и списке (approval_request, фильтр approval_requested). Статус предложения не меняется; одобряют и отклоняют обычными POST …/approve и …/reject. Повтор, пока просьба действует, — repeated: true без второго письма. Письма одному получателю по одной компании уходят не чаще раза в 15 минут (настройка платформы): просьба записывается всегда, придержанное письмо — notified: false. Отказы: 409 error.code = approval_not_needed (у вас самого есть право одобрять) и wrong_status (решение уже принято, нынешний статус — error.status); 422 has_blockers (есть блокеры — одобрить нельзя, список — error.blockers). Чужая компания и неизвестное предложение — 404, участник без права — 403.

Доступ: proposals.create.

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

POST /v1/companies/{co}/proposals/{id}/request-approval

Отправить на одобрение

cURL

curl --request POST \
  --url https://api.tungo.kz/v1/companies/{co}/proposals/{id}/request-approval \
  --header 'Content-Type: application/json' \
  --cookie tungo.session_token= \
  --data '
{
  "note": "<string>"
}
'

200

{
  "ok": true,
  "repeated": true,
  "notified": true,
  "proposal": {
    "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",
    "source": {
      "channel": "mcp",
      "note": "<string>"
    },
    "intent": {},
    "header": {
      "document_title": "Реализация товаров и услуг",
      "entity_set": "Document_РеализацияТоваровУслуг",
      "date": "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 ₸"
      },
      "net": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "accounts": [
        {
          "field": "СчетУчетаБУ",
          "title": "Счёт учёта (БУ)",
          "code": "1330",
          "ref": "00000000-0000-0000-0000-000000000000"
        }
      ],
      "organization": {
        "ref": "00000000-0000-0000-0000-000000000000",
        "name": "ТОО «Пример»",
        "bin": "000000000000"
      },
      "counterparty": {
        "ref": "00000000-0000-0000-0000-000000000000",
        "name": "ТОО «Пример»",
        "bin": "000000000000"
      },
      "contract": {
        "ref": "00000000-0000-0000-0000-000000000000",
        "name": "<string>",
        "number": "<string>",
        "date": "<string>",
        "kind": "<string>"
      },
      "prices_include_vat": true,
      "comment": "<string>",
      "payment_purpose": "<string>"
    },
    "lines": [
      {
        "no": 123,
        "section": "goods",
        "item": {
          "ref": "<string>",
          "name": "<string>"
        },
        "quantity": 2,
        "price": {
          "amount": 1234.5,
          "amount_tiyn": 123450,
          "formatted": "1 234,50 ₸"
        },
        "sum": {
          "amount": 1234.5,
          "amount_tiyn": 123450,
          "formatted": "1 234,50 ₸"
        },
        "vat_rate_title": "<string>",
        "vat": {
          "amount": 1234.5,
          "amount_tiyn": 123450,
          "formatted": "1 234,50 ₸"
        },
        "total": {
          "amount": 1234.5,
          "amount_tiyn": 123450,
          "formatted": "1 234,50 ₸"
        },
        "accounts": [
          {
            "field": "СчетУчетаБУ",
            "title": "Счёт учёта (БУ)",
            "code": "1330",
            "ref": "00000000-0000-0000-0000-000000000000"
          }
        ],
        "description": "<string>",
        "vat_rate": 12
      }
    ],
    "postings": [
      {
        "debit": "1210",
        "credit": "6010",
        "amount": {
          "amount": 1234.5,
          "amount_tiyn": 123450,
          "formatted": "1 234,50 ₸"
        },
        "label": "<string>",
        "computed_by_1c": true
      }
    ],
    "warnings": [
      "<string>"
    ],
    "blockers": [
      "<string>"
    ],
    "actions": [
      {
        "action": "approve",
        "label": "<string>",
        "method": "POST",
        "href": "<string>",
        "enabled": true,
        "effect": "<string>",
        "body": {
          "post": true,
          "idempotency_key": "<uuid от клиента>"
        },
        "disabled_reason": "<string>"
      }
    ],
    "history": [
      {
        "at": "2023-11-07T05:31:56Z",
        "status": "previewed",
        "status_title": "<string>",
        "actor": "<string>",
        "note": "<string>",
        "code": "<string>"
      }
    ],
    "summary": "<string>",
    "counterparty": {
      "ref": "00000000-0000-0000-0000-000000000000",
      "name": "ТОО «Пример»",
      "bin": "000000000000"
    },
    "document_number": "0000-000123",
    "advance_offset": {
      "amount": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "to_pay": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "debit": "<string>",
      "credit": "<string>",
      "note": "<string>"
    },
    "result": {
      "number": "<string>",
      "ref": "00000000-0000-0000-0000-000000000000",
      "postings": [
        {
          "debit": "1210",
          "credit": "6010",
          "amount": {
            "amount": 1234.5,
            "amount_tiyn": 123450,
            "formatted": "1 234,50 ₸"
          },
          "label": "<string>",
          "computed_by_1c": true
        }
      ],
      "mismatches": [
        "<string>"
      ]
    }
  }
}

Авторизации

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

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

Номер предложения внутри компании: P- и шесть цифр (P-000123). У двух компаний номера могут совпадать

Пример:

"P-000123"

Тело

application/json

Просьба одобрить

note · string | null

Пояснение для того, кто одобряет, до 1000 знаков; попадёт в историю предложения и журнал

Maximum string length: 1000

Ответ

200

application/json

Просьба записана (или уже была: repeated: true)

Итог просьбы одобрить и свежая карточка

ok · enum<boolean> · обязательно

Всегда true

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

repeated · boolean · обязательно

true — просьба уже действовала, новой записи и письма нет

notified · boolean · обязательно

true — письмо тем, кто одобряет, поставлено в очередь; false — повтор, письмо поставить не удалось или оно придержано: всем одобряющим по этой компании недавно уже писали (настройка notify.approval_request_interval_minutes, по умолчанию 15 минут) — оно уйдёт позже одним письмом. Просьба в любом случае записана и видна в очереди

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

Полная карточка предложения: шапка, строки, проводки, блокеры, кнопки и история

Show child attributes