Одобрить пачку предложений
curl --request POST \
--url https://api.tungo.kz/v1/companies/{co}/proposals/approve-batch \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"ids": [
"<string>"
],
"batch_id": "<string>",
"exclude": [
"<string>"
],
"post": true,
"note": "<string>",
"idempotency_key": "<string>",
"async": true
}
'import requests
url = "https://api.tungo.kz/v1/companies/{co}/proposals/approve-batch"
payload = {
"ids": ["<string>"],
"batch_id": "<string>",
"exclude": ["<string>"],
"post": True,
"note": "<string>",
"idempotency_key": "<string>",
"async": True
}
headers = {
"cookie": "tungo.session_token=",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
body: JSON.stringify({
ids: ['<string>'],
batch_id: '<string>',
exclude: ['<string>'],
post: true,
note: '<string>',
idempotency_key: '<string>',
async: true
})
};
fetch('https://api.tungo.kz/v1/companies/{co}/proposals/approve-batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ok": true,
"message": "Одобрено 12 из 14, исключено 1, с блокерами 1.",
"requested": 123,
"approved": 123,
"excluded": 123,
"failed": 123,
"limit": 123,
"counts": {
"approved": 12,
"excluded": 1,
"blocked": 1
},
"results": [
{
"id": "P-000123",
"outcome": "approved",
"title": "Одобрено и записано",
"message": "<string>",
"error": "<string>",
"retry_after": 123,
"document_number": "<string>",
"mismatches": [
"<string>"
]
}
],
"batch_id": "<string>",
"unknown_excluded": [
"<string>"
],
"stopped": {
"reason": "<string>",
"remaining": 123
}
}{
"id": "bat_01h455vb4pex5vsknk084sn02q",
"kind": "bank_statement",
"title": "выписка statement.txt, строк 42",
"started_at": "2023-11-07T05:31:56Z",
"running": true,
"events": 123,
"async": true,
"message": "<string>",
"requested": 123,
"finished_at": "2023-11-07T05:31:56Z",
"error": "<string>",
"report": {
"total": 123,
"created": 123,
"skipped": 123,
"failed": 123,
"unknown": 123,
"manual": 123,
"duplicates": 123,
"pending": 123,
"rows": [
{
"key": "<string>",
"title": "10.07.2026 ТОО «Пример» 1 200 000 ₸",
"status": "created",
"proposal_id": "<string>",
"document_ref": "<string>",
"reason": "<string>",
"warnings": [
"<string>"
],
"blockers": [
"<string>"
],
"question": {
"id": "<string>",
"text": "<string>",
"options": [
{
"label": "<string>",
"description": "<string>"
}
]
}
}
],
"min_concurrency": 123,
"stopped": true,
"gateway": {
"asked": 123,
"passed": 123
},
"approval": {
"ok": true,
"message": "Одобрено 12 из 14, исключено 1, с блокерами 1.",
"requested": 123,
"approved": 123,
"excluded": 123,
"failed": 123,
"limit": 123,
"counts": {
"approved": 12,
"excluded": 1,
"blocked": 1
},
"results": [
{
"id": "P-000123",
"outcome": "approved",
"title": "Одобрено и записано",
"message": "<string>",
"error": "<string>",
"retry_after": 123,
"document_number": "<string>",
"mismatches": [
"<string>"
]
}
],
"batch_id": "<string>",
"unknown_excluded": [
"<string>"
],
"stopped": {
"reason": "<string>",
"remaining": 123
}
}
}
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}ИИ-бухгалтер: предложения
Одобрить пачку предложений
Цикл по одиночным одобрениям: право, политика и журнал — на каждое предложение; один отказ пачку не валит. Либо ids, либо batch_id (задание пачки). Больше 2000 — 413, ничего не одобрено. Задание ещё идёт — 409. Больше 50 предложений (или async: true) — 202 и задание вида approve_batch. Ошибки — единым видом с полем error.code (ApproveError): 400 onec_rejected (1С отклонила документ), 403 missing_permission / onec_read_only / policy_blocked / key_write_limit, 404 proposal_not_found, 409 wrong_status / payload_changed / job_running / onec_conflict (объект в 1С занят или такой документ уже есть) / onec_not_found, 422 has_blockers (error.blockers), 503 onec_unavailable / onec_failed (документ не записан, повторите позже) / write_unknown (1С не ответила на запись: неизвестно, создан ли документ; error.marker — метка для поиска в 1С, повтор безопасен — сначала найдёт документ по метке; повтор раньше чем через 2 минуты после обрыва в 1С не пишет и отвечает тем же кодом с error.retry_after и Retry-After — сколько секунд ждать). В ошибке записи есть error.status и error.document: «записан черновиком, но не проведён» видно без карточки, повтор «Записать» проведёт тот же документ.
Idempotency-Key: повтор с тем же ключом и тем же телом отдаёт прежний ответ (статус и тело) с заголовком Idempotent-Replayed: true и ничего не делает второй раз; тот же ключ с другим адресом или телом — 422 (error.code = idempotency_key_reused); первый запрос с этим ключом ещё идёт — 409 (error.code = idempotency_in_progress). Запоминается только удачный ответ (2xx): после отказа повтор с тем же ключом выполнится заново. Ключ живёт сутки (настройка idempotency.keys), область — организация и тот, кто прислал (ключ API или человек).
Доступ: proposals.approve.
Доступно по ключу API.
POST
/
v1
/
companies
/
{co}
/
proposals
/
approve-batch
Одобрить пачку предложений
curl --request POST \
--url https://api.tungo.kz/v1/companies/{co}/proposals/approve-batch \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"ids": [
"<string>"
],
"batch_id": "<string>",
"exclude": [
"<string>"
],
"post": true,
"note": "<string>",
"idempotency_key": "<string>",
"async": true
}
'import requests
url = "https://api.tungo.kz/v1/companies/{co}/proposals/approve-batch"
payload = {
"ids": ["<string>"],
"batch_id": "<string>",
"exclude": ["<string>"],
"post": True,
"note": "<string>",
"idempotency_key": "<string>",
"async": True
}
headers = {
"cookie": "tungo.session_token=",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
body: JSON.stringify({
ids: ['<string>'],
batch_id: '<string>',
exclude: ['<string>'],
post: true,
note: '<string>',
idempotency_key: '<string>',
async: true
})
};
fetch('https://api.tungo.kz/v1/companies/{co}/proposals/approve-batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ok": true,
"message": "Одобрено 12 из 14, исключено 1, с блокерами 1.",
"requested": 123,
"approved": 123,
"excluded": 123,
"failed": 123,
"limit": 123,
"counts": {
"approved": 12,
"excluded": 1,
"blocked": 1
},
"results": [
{
"id": "P-000123",
"outcome": "approved",
"title": "Одобрено и записано",
"message": "<string>",
"error": "<string>",
"retry_after": 123,
"document_number": "<string>",
"mismatches": [
"<string>"
]
}
],
"batch_id": "<string>",
"unknown_excluded": [
"<string>"
],
"stopped": {
"reason": "<string>",
"remaining": 123
}
}{
"id": "bat_01h455vb4pex5vsknk084sn02q",
"kind": "bank_statement",
"title": "выписка statement.txt, строк 42",
"started_at": "2023-11-07T05:31:56Z",
"running": true,
"events": 123,
"async": true,
"message": "<string>",
"requested": 123,
"finished_at": "2023-11-07T05:31:56Z",
"error": "<string>",
"report": {
"total": 123,
"created": 123,
"skipped": 123,
"failed": 123,
"unknown": 123,
"manual": 123,
"duplicates": 123,
"pending": 123,
"rows": [
{
"key": "<string>",
"title": "10.07.2026 ТОО «Пример» 1 200 000 ₸",
"status": "created",
"proposal_id": "<string>",
"document_ref": "<string>",
"reason": "<string>",
"warnings": [
"<string>"
],
"blockers": [
"<string>"
],
"question": {
"id": "<string>",
"text": "<string>",
"options": [
{
"label": "<string>",
"description": "<string>"
}
]
}
}
],
"min_concurrency": 123,
"stopped": true,
"gateway": {
"asked": 123,
"passed": 123
},
"approval": {
"ok": true,
"message": "Одобрено 12 из 14, исключено 1, с блокерами 1.",
"requested": 123,
"approved": 123,
"excluded": 123,
"failed": 123,
"limit": 123,
"counts": {
"approved": 12,
"excluded": 1,
"blocked": 1
},
"results": [
{
"id": "P-000123",
"outcome": "approved",
"title": "Одобрено и записано",
"message": "<string>",
"error": "<string>",
"retry_after": 123,
"document_number": "<string>",
"mismatches": [
"<string>"
]
}
],
"batch_id": "<string>",
"unknown_excluded": [
"<string>"
],
"stopped": {
"reason": "<string>",
"remaining": 123
}
}
}
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"blockers": [
"<string>"
],
"status": "<string>",
"status_title": "<string>",
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"retry_safe": true,
"marker": "<string>",
"retry_after": 123,
"level": "<string>",
"batch_id": "<string>",
"gateway": "<string>",
"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>"
},
"dialog_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>"
}
],
"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>"
]
}
},
"limit": 123,
"requested": 123
},
"request_id": "<string>"
}Авторизации
sessionapiKeybearerKey
Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.
Заголовки
Ключ повтора (например, UUID): повтор с тем же ключом и тем же телом не выполняет действие второй раз, а отдаёт прежний ответ
Maximum string length:
255Параметры пути
id компании, co_… — из GET /v1/companies
Тело
application/json
Что одобрить: либо ids, либо batch_id — ровно одно из двух. Неизвестные поля — 400.
Явный список предложений. Взаимоисключающе с batch_id.
Minimum array length:
1Required string length:
1 - 64Задание пачки (bat_… — id из ответа на загрузку выписки или ЭСФ): все предложения этого задания
Что снято галочками — эти предложения не одобряются (не больше 2000)
Maximum array length:
2000Maximum string length:
64Проводить документы после записи (по умолчанию true)
Комментарий к решению: попадёт в журнал по каждому предложению
Maximum string length:
1000То же, что заголовок Idempotency-Key
Maximum string length:
200Одобрить заданием в фоне: ответ 202 с номером задания сразу, прогресс — …/batch/:id/events, итог — …/batch/:id (report.approval). Пачка больше 50 предложений идёт заданием всегда.
Ответ
Итог по каждому предложению — пачка до 50 предложений без async
Итог одобрения пачкой — по каждому предложению
true — всё, что не снято галочкой, одобрено (или уже было записано); false — есть отказы, смотрите results
Итог одной фразой для человека
Пример:
"Одобрено 12 из 14, исключено 1, с блокерами 1."
Сколько предложений в пачке (со снятыми галочкой)
Одобрено, включая уже записанные раньше
Снято галочкой
Не одобрено по любой причине
Предел пачки (2000)
Сколько предложений с каждым исходом (ключ — outcome из results)
Show child attributes
Show child attributes
Пример:
{
"approved": 12,
"excluded": 1,
"blocked": 1
}
Исход по каждому предложению, в порядке пачки
Show child attributes
Show child attributes
Номер задания, если одобряли по batch_id
Номера из exclude, которых нет в пачке
Пачка остановлена раньше конца (1С трижды не ответила, база только для чтения, отозвали право, нажали «Остановить»)
Show child attributes
Show child attributes