Одобрить и записать в 1С
curl --request POST \
--url https://api.tungo.kz/v1/companies/{co}/proposals/{id}/approve \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"post": true,
"note": "<string>",
"idempotency_key": "<string>"
}
'import requests
url = "https://api.tungo.kz/v1/companies/{co}/proposals/{id}/approve"
payload = {
"post": True,
"note": "<string>",
"idempotency_key": "<string>"
}
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({post: true, note: '<string>', idempotency_key: '<string>'})
};
fetch('https://api.tungo.kz/v1/companies/{co}/proposals/{id}/approve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ok": true,
"repeated": true,
"message": "<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>"
]
}
},
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"postings": [
{
"debit": "1210",
"credit": "6010",
"amount": {
"amount": 1234.5,
"amount_tiyn": 123450,
"formatted": "1 234,50 ₸"
},
"label": "<string>",
"computed_by_1c": true
}
],
"mismatches": [
"<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>"
}{
"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": "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": "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>"
}ИИ-бухгалтер: предложения
Одобрить и записать в 1С
Ключ повтора — заголовок Idempotency-Key или поле idempotency_key. Тело не обязательно; непустое не-JSON тело — 400 (error.code = invalid_json). Ошибки — единым видом с полем 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
/
{id}
/
approve
Одобрить и записать в 1С
curl --request POST \
--url https://api.tungo.kz/v1/companies/{co}/proposals/{id}/approve \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"post": true,
"note": "<string>",
"idempotency_key": "<string>"
}
'import requests
url = "https://api.tungo.kz/v1/companies/{co}/proposals/{id}/approve"
payload = {
"post": True,
"note": "<string>",
"idempotency_key": "<string>"
}
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({post: true, note: '<string>', idempotency_key: '<string>'})
};
fetch('https://api.tungo.kz/v1/companies/{co}/proposals/{id}/approve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"ok": true,
"repeated": true,
"message": "<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>"
]
}
},
"document": {
"number": "<string>",
"ref": "<string>",
"posted": true
},
"postings": [
{
"debit": "1210",
"credit": "6010",
"amount": {
"amount": 1234.5,
"amount_tiyn": 123450,
"formatted": "1 234,50 ₸"
},
"label": "<string>",
"computed_by_1c": true
}
],
"mismatches": [
"<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>"
}{
"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": "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": "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
Номер предложения внутри компании: P- и шесть цифр (P-000123). У двух компаний номера могут совпадать
Пример:
"P-000123"
Тело
application/json
Тело одобрения; можно не присылать — тогда «записать и провести»
true (по умолчанию) — записать и провести; false — записать черновиком без проведения. Только true/false: другое — 400
Комментарий к решению — в журнал (до 1000 знаков)
То же, что заголовок Idempotency-Key: свой UUID, тот же при повторе нажатия
Maximum string length:
200Ответ
Записано (или уже было записано: repeated: true)
Итог одобрения или отклонения
Всегда true: отказ приходит ошибкой ApproveError
Доступные опции:
true true — решение уже было принято раньше, повтор ничего не изменил (второй документ не создан)
Итог для человека — показать как есть («Документ № … проведён, проводки совпали»)
Свежая карточка предложения после решения — заменить ею открытую
Show child attributes
Show child attributes
Только у одобрения: документ в 1С
Show child attributes
Show child attributes
Только у одобрения: фактические проводки 1С
Show child attributes
Show child attributes
Только у одобрения: расхождения фактических проводок с ожидаемыми; пусто — совпали