ЕХ: правки финального ревью — пробелы Q1…Q4, проценты без ограничения, поля выгрузок, Ref в updated_by, заморозка КФО, согласованные примеры (#208)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Andrey Epifancev 2026-11-06 23:16:47 +04:00
parent 7ef8c1c04d
commit 50cafe571c
12 changed files with 1094 additions and 274 deletions

View File

@ -1198,7 +1198,7 @@ OQ — менять по ответу.
| VERIFICATION_RF | CONSOLIDATION_RF | РКА РФ | вернул (комментарий обязателен) | | VERIFICATION_RF | CONSOLIDATION_RF | РКА РФ | вернул (комментарий обязателен) |
| CONSOLIDATION_GO | CONSOLIDATION_RF | КА ГО | вернул на доработку (комментарий) | | CONSOLIDATION_GO | CONSOLIDATION_RF | КА ГО | вернул на доработку (комментарий) |
| CONSOLIDATION_GO | VERIFICATION_GO | КА ГО | если инициатор — КА ГО, верифицирует РКА ГО [открыто] | | CONSOLIDATION_GO | VERIFICATION_GO | КА ГО | если инициатор — КА ГО, верифицирует РКА ГО [открыто] |
| CONSOLIDATION_GO / VERIFICATION_GO | VERIFIED | КА ГО / РКА ГО | внесены № и дата решения УОБ; версия read-only; пишется `ex_snapshot` | | CONSOLIDATION_GO / VERIFICATION_GO | VERIFIED | КА ГО / РКА ГО | внесены № и дата решения УОБ; версия read-only; пишется `ex_snapshot` (§14) |
| любой нефинальный | INITIATED | КА | нужен другой периметр/сценарий/комплект | | любой нефинальный | INITIATED | КА | нужен другой периметр/сценарий/комплект |
| любой нефинальный | CANCELLED | КА | аннулировано | | любой нефинальный | CANCELLED | КА | аннулировано |
| VERIFIED | — | — | только «новая версия» (`previous_version_id`) | | VERIFIED | — | — | только «новая версия» (`previous_version_id`) |
@ -1696,9 +1696,6 @@ OQ-92 (пустые «Организация»/«Группа компаний»
Все мутации пишут `audit_event` (`GROUP_CHANGE`, `ASSIGNMENT_CHANGE`, `MEMBERSHIP_CHANGE`, `LEGAL_ENTITY_CHANGE` — v5.14, `DIRECTORY_IMPORT`) с `before/after`. Все мутации пишут `audit_event` (`GROUP_CHANGE`, `ASSIGNMENT_CHANGE`, `MEMBERSHIP_CHANGE`, `LEGAL_ENTITY_CHANGE` — v5.14, `DIRECTORY_IMPORT`) с `before/after`.
---
--- ---
## §14. Срез ЕХ при верификации (DOC-274687, DOC-274686, DOC-274685; ЕХ ТЗ 5.2, 6.2–6.4; AURORA-1560 — запись, AURORA-2001 — чтение и архив, AURORA-2002 — переход; ещё не реализовано) ## §14. Срез ЕХ при верификации (DOC-274687, DOC-274686, DOC-274685; ЕХ ТЗ 5.2, 6.2–6.4; AURORA-1560 — запись, AURORA-2001 — чтение и архив, AURORA-2002 — переход; ещё не реализовано)
@ -1731,8 +1728,15 @@ OQ-92 (пустые «Организация»/«Группа компаний»
сопоставления свода, строки ОСВ агрегатов, сводка корректировок КФО) — срез выгружается на лету из payload и должен сопоставления свода, строки ОСВ агрегатов, сводка корректировок КФО) — срез выгружается на лету из payload и должен
совпадать с выгрузкой рабочей версии. Шахматка — режим «все счета», пресет каждого правила ББ версии правил и совпадать с выгрузкой рабочей версии. Шахматка — режим «все счета», пресет каждого правила ББ версии правил и
результирующая таблица; ручной выбор счетов не замораживается. Корректировки — только применённые (`APPLIED`; результирующая таблица; ручной выбор счетов не замораживается. Корректировки — только применённые (`APPLIED`;
`REVOKED` нет, `DRAFT` не пишется). Карточка версии (`version_card`) — участники маршрута с ФИО, решение УОБ, причины `REVOKED` нет, `DRAFT` не пишется; агрегат с неприменённой корректировкой — с `correction = null`). Сводная ОСВ —
отклонений, состав с ИНН: версия КФО удаляется раньше среза. весь свод без фильтров и страниц, в порядке API. Карточка версии (`version_card`) — участники маршрута с ФИО,
решение УОБ, причины отклонений, состав с ИНН: версия КФО удаляется раньше среза. Пользователи в DTO — как в API
(`Ref {id, name}`, ФИО на дату верификации); в карточке — `UserRef {user_id, full_name}`.
**Ошибка экрана при сборке.** Пресет правила, для которого экран отвечает 422 (`INVALID_RULE`,
`ACCOUNTS_REQUIRED`), в `chess.presets` не пишется; любая другая ошибка сборки обязательного элемента (в том числе
`RESULT_ACCOUNTS_MISSING` результирующей таблицы) — сбой записи среза (п. 9).
**Проверка.** Писатель проверяет каждый payload схемой `ex-payload-v1` с проверкой форматов (`uuid`, `date`,
`date-time`); ядро держит копию схемы у себя, как схемы контракта распознавания (копия + проверка идентичности).
5. **Не входят:** строки форм без кода (документ — целиком, ссылкой; решение 17.10.2026), документы, не привязанные к 5. **Не входят:** строки форм без кода (документ — целиком, ссылкой; решение 17.10.2026), документы, не привязанные к
версии, и документы заменённых файлов, черновики корректировок. версии, и документы заменённых файлов, черновики корректировок.
6. **Самодостаточность.** Ссылки допускаются только на то, что живёт не меньше среза: `document`, `legal_entity`, 6. **Самодостаточность.** Ссылки допускаются только на то, что живёт не меньше среза: `document`, `legal_entity`,

View File

@ -444,7 +444,7 @@
"string", "string",
"null" "null"
], ],
"pattern": "^-?\\d{1,5}\\.\\d{2}$", "pattern": "^-?\\d+\\.\\d{2}$",
"description": "deviation_total / base_amount × 100; null при нулевой базе" "description": "deviation_total / base_amount × 100; null при нулевой базе"
}, },
"exceeded": { "exceeded": {
@ -687,154 +687,196 @@
] ]
}, },
"KfoBalanceData": { "KfoBalanceData": {
"type": "object", "allOf": [
"properties": { {
"version_id": { "type": "object",
"type": "string", "properties": {
"format": "uuid" "version_id": {
}, "type": "string",
"computed_at": { "format": "uuid"
"type": "string", },
"format": "date-time" "computed_at": {
}, "type": "string",
"is_frozen": { "format": "date-time"
"type": "boolean" },
}, "is_frozen": {
"units": { "type": "boolean"
"type": "string", },
"const": "thousand_rub" "units": {
}, "type": "string",
"companies": { "const": "thousand_rub"
"type": "array", },
"items": { "companies": {
"$ref": "#/$defs/KfoCompanyOut" "type": "array",
} "items": {
}, "$ref": "#/$defs/KfoCompanyOut"
"requisites": { }
"$ref": "#/$defs/KfoRequisitesOut" },
}, "requisites": {
"summary": { "$ref": "#/$defs/KfoRequisitesOut"
"$ref": "#/$defs/KfoSummaryOut" },
}, "summary": {
"justification_required": { "$ref": "#/$defs/KfoSummaryOut"
"type": "boolean" },
}, "justification_required": {
"threshold_justification": { "type": "boolean"
"type": [ },
"string", "threshold_justification": {
"null" "type": [
"string",
"null"
],
"maxLength": 4000
},
"goodwill": {
"$ref": "#/$defs/KfoGoodwillOut"
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/KfoWarningOut"
}
},
"balance": {
"$ref": "#/$defs/KfoStatementOut"
}
},
"required": [
"version_id",
"computed_at",
"is_frozen",
"units",
"companies",
"requisites",
"summary",
"justification_required",
"threshold_justification",
"goodwill",
"warnings",
"balance"
], ],
"maxLength": 4000 "additionalProperties": true,
}, "description": "KfoResultOut без editable/read_only_reason, только отчёт ББ",
"goodwill": { "not": {
"$ref": "#/$defs/KfoGoodwillOut" "required": [
}, "income"
"warnings": { ]
"type": "array",
"items": {
"$ref": "#/$defs/KfoWarningOut"
} }
}, },
"balance": { {
"$ref": "#/$defs/KfoStatementOut" "properties": {
"is_frozen": {
"const": true
},
"companies": {
"minItems": 1
},
"requisites": {
"properties": {
"version_status": {
"const": "VERIFIED"
}
}
}
}
} }
}, ]
"required": [
"version_id",
"computed_at",
"is_frozen",
"units",
"companies",
"requisites",
"summary",
"justification_required",
"threshold_justification",
"goodwill",
"warnings",
"balance"
],
"additionalProperties": true,
"description": "KfoResultOut без editable/read_only_reason, только отчёт ББ",
"not": {
"required": [
"income"
]
}
}, },
"KfoIncomeData": { "KfoIncomeData": {
"type": "object", "allOf": [
"properties": { {
"version_id": { "type": "object",
"type": "string", "properties": {
"format": "uuid" "version_id": {
}, "type": "string",
"computed_at": { "format": "uuid"
"type": "string", },
"format": "date-time" "computed_at": {
}, "type": "string",
"is_frozen": { "format": "date-time"
"type": "boolean" },
}, "is_frozen": {
"units": { "type": "boolean"
"type": "string", },
"const": "thousand_rub" "units": {
}, "type": "string",
"companies": { "const": "thousand_rub"
"type": "array", },
"items": { "companies": {
"$ref": "#/$defs/KfoCompanyOut" "type": "array",
} "items": {
}, "$ref": "#/$defs/KfoCompanyOut"
"requisites": { }
"$ref": "#/$defs/KfoRequisitesOut" },
}, "requisites": {
"summary": { "$ref": "#/$defs/KfoRequisitesOut"
"$ref": "#/$defs/KfoSummaryOut" },
}, "summary": {
"justification_required": { "$ref": "#/$defs/KfoSummaryOut"
"type": "boolean" },
}, "justification_required": {
"threshold_justification": { "type": "boolean"
"type": [ },
"string", "threshold_justification": {
"null" "type": [
"string",
"null"
],
"maxLength": 4000
},
"goodwill": {
"$ref": "#/$defs/KfoGoodwillOut"
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/KfoWarningOut"
}
},
"income": {
"$ref": "#/$defs/KfoStatementOut"
}
},
"required": [
"version_id",
"computed_at",
"is_frozen",
"units",
"companies",
"requisites",
"summary",
"justification_required",
"threshold_justification",
"goodwill",
"warnings",
"income"
], ],
"maxLength": 4000 "additionalProperties": true,
}, "description": "KfoResultOut без editable/read_only_reason, только отчёт ОФР",
"goodwill": { "not": {
"$ref": "#/$defs/KfoGoodwillOut" "required": [
}, "balance"
"warnings": { ]
"type": "array",
"items": {
"$ref": "#/$defs/KfoWarningOut"
} }
}, },
"income": { {
"$ref": "#/$defs/KfoStatementOut" "properties": {
"is_frozen": {
"const": true
},
"companies": {
"minItems": 1
},
"requisites": {
"properties": {
"version_status": {
"const": "VERIFIED"
}
}
}
}
} }
}, ]
"required": [
"version_id",
"computed_at",
"is_frozen",
"units",
"companies",
"requisites",
"summary",
"justification_required",
"threshold_justification",
"goodwill",
"warnings",
"income"
],
"additionalProperties": true,
"description": "KfoResultOut без editable/read_only_reason, только отчёт ОФР",
"not": {
"required": [
"balance"
]
}
}, },
"Ref": { "Ref": {
"type": "object", "type": "object",
@ -1030,9 +1072,13 @@
"missing_quarters": { "missing_quarters": {
"type": "array", "type": "array",
"items": { "items": {
"type": "integer", "type": "string",
"minimum": 1, "enum": [
"maximum": 4 "Q1",
"Q2",
"Q3",
"Q4"
]
} }
} }
}, },
@ -1085,6 +1131,14 @@
"CorrectionEntryOut": { "CorrectionEntryOut": {
"type": "object", "type": "object",
"properties": { "properties": {
"entry_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"minItems": 1
},
"legal_entity_id": { "legal_entity_id": {
"type": "string", "type": "string",
"format": "uuid" "format": "uuid"
@ -1112,6 +1166,7 @@
} }
}, },
"required": [ "required": [
"entry_ids",
"legal_entity_id", "legal_entity_id",
"counterparty_id", "counterparty_id",
"account_code", "account_code",
@ -1173,6 +1228,154 @@
], ],
"additionalProperties": true "additionalProperties": true
}, },
"CorrectionBalanceOut": {
"type": "object",
"properties": {
"debit_total": {
"type": "string",
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
},
"credit_total": {
"type": "string",
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
},
"difference": {
"type": "string",
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
},
"difference_percent": {
"type": [
"string",
"null"
],
"pattern": "^-?\\d+\\.\\d{2}$"
},
"remainder_1": {
"type": [
"string",
"null"
],
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
},
"remainder_2": {
"type": [
"string",
"null"
],
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
}
},
"required": [
"debit_total",
"credit_total",
"difference",
"difference_percent",
"remainder_1",
"remainder_2"
],
"additionalProperties": true
},
"CorrectionPairOut": {
"type": "object",
"properties": {
"side_1": {
"$ref": "#/$defs/AggregateSideOut"
},
"side_2": {
"$ref": "#/$defs/AggregateSideOut"
},
"deviation_amount": {
"type": "string",
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
},
"deviation_percent": {
"type": [
"string",
"null"
],
"pattern": "^-?\\d+\\.\\d{2}$"
}
},
"required": [
"side_1",
"side_2",
"deviation_amount",
"deviation_percent"
],
"additionalProperties": true
},
"CorrectionRuleOut": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"rule_no": {
"type": "integer"
},
"article_1_line": {
"type": [
"string",
"null"
]
},
"article_2_line": {
"type": [
"string",
"null"
]
},
"side_1": {
"type": "string",
"enum": [
"D",
"K"
]
},
"measure": {
"type": "string"
},
"company_1_accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"company_2_accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"company_1_excluded": {
"type": "array",
"items": {
"type": "string"
}
},
"company_2_excluded": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"rule_no",
"article_1_line",
"article_2_line",
"side_1",
"measure",
"company_1_accounts",
"company_2_accounts",
"company_1_excluded",
"company_2_excluded"
],
"additionalProperties": true,
"description": "Правило элиминации на дату верификации (CorrectionRuleOut)"
},
"CorrectionOut": { "CorrectionOut": {
"type": "object", "type": "object",
"properties": { "properties": {
@ -1200,7 +1403,19 @@
"comment": { "comment": {
"type": "string" "type": "string"
}, },
"updated_by": {}, "balance": {
"$ref": "#/$defs/CorrectionBalanceOut"
},
"updated_by": {
"anyOf": [
{
"$ref": "#/$defs/Ref"
},
{
"type": "null"
}
]
},
"updated_at": { "updated_at": {
"type": "string", "type": "string",
"format": "date-time" "format": "date-time"
@ -1212,6 +1427,7 @@
"debit", "debit",
"credit", "credit",
"comment", "comment",
"balance",
"updated_by", "updated_by",
"updated_at" "updated_at"
], ],
@ -1236,6 +1452,12 @@
"side_2": { "side_2": {
"$ref": "#/$defs/AggregateSideOut" "$ref": "#/$defs/AggregateSideOut"
}, },
"pairs": {
"type": "array",
"items": {
"$ref": "#/$defs/CorrectionPairOut"
}
},
"deviation_amount": { "deviation_amount": {
"type": "string", "type": "string",
"pattern": "^-?\\d{1,16}\\.\\d{2}$" "pattern": "^-?\\d{1,16}\\.\\d{2}$"
@ -1245,7 +1467,7 @@
"string", "string",
"null" "null"
], ],
"pattern": "^-?\\d{1,5}\\.\\d{2}$" "pattern": "^-?\\d+\\.\\d{2}$"
}, },
"exceeds_threshold": { "exceeds_threshold": {
"type": "boolean" "type": "boolean"
@ -1280,6 +1502,7 @@
"company_2", "company_2",
"side_1", "side_1",
"side_2", "side_2",
"pairs",
"deviation_amount", "deviation_amount",
"deviation_percent", "deviation_percent",
"exceeds_threshold", "exceeds_threshold",
@ -1292,6 +1515,14 @@
"UnallocatedEntryOut": { "UnallocatedEntryOut": {
"type": "object", "type": "object",
"properties": { "properties": {
"entry_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"minItems": 1
},
"owner": { "owner": {
"$ref": "#/$defs/Ref" "$ref": "#/$defs/Ref"
}, },
@ -1320,6 +1551,7 @@
} }
}, },
"required": [ "required": [
"entry_ids",
"owner", "owner",
"counterparty", "counterparty",
"account_code", "account_code",
@ -1376,6 +1608,13 @@
"rules_version_no": { "rules_version_no": {
"type": "integer" "type": "integer"
}, },
"rules": {
"type": "array",
"items": {
"$ref": "#/$defs/CorrectionRuleOut"
},
"minItems": 1
},
"aggregates": { "aggregates": {
"type": "array", "type": "array",
"items": { "items": {
@ -1395,6 +1634,7 @@
"required": [ "required": [
"statement_type", "statement_type",
"rules_version_no", "rules_version_no",
"rules",
"aggregates", "aggregates",
"unallocated", "unallocated",
"totals" "totals"
@ -1497,13 +1737,16 @@
"string", "string",
"null" "null"
], ],
"pattern": "^-?\\d{1,5}\\.\\d{2}$" "pattern": "^-?\\d+\\.\\d{2}$"
}, },
"exceeds_threshold": { "exceeds_threshold": {
"type": "boolean" "type": "boolean"
}, },
"one_sided": { "one_sided": {
"type": "boolean" "type": "boolean"
},
"skipped_osv_entry_count": {
"type": "integer"
} }
}, },
"required": [ "required": [
@ -1514,7 +1757,8 @@
"variance_amount", "variance_amount",
"variance_percent", "variance_percent",
"exceeds_threshold", "exceeds_threshold",
"one_sided" "one_sided",
"skipped_osv_entry_count"
], ],
"additionalProperties": true "additionalProperties": true
}, },
@ -1525,18 +1769,41 @@
"type": "array", "type": "array",
"items": { "items": {
"$ref": "#/$defs/Ref" "$ref": "#/$defs/Ref"
} },
"minItems": 1
}, },
"cells": { "cells": {
"type": "array", "type": "array",
"items": { "items": {
"$ref": "#/$defs/MatrixCellOut" "$ref": "#/$defs/MatrixCellOut"
} }
},
"total_debit": {
"type": "object",
"propertyNames": {
"format": "uuid"
},
"additionalProperties": {
"type": "string",
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
}
},
"total_credit": {
"type": "object",
"propertyNames": {
"format": "uuid"
},
"additionalProperties": {
"type": "string",
"pattern": "^-?\\d{1,16}\\.\\d{2}$"
}
} }
}, },
"required": [ "required": [
"companies", "companies",
"cells" "cells",
"total_debit",
"total_credit"
], ],
"additionalProperties": true, "additionalProperties": true,
"description": "IntercompanyMatrixOut; osv_entry_ids_* — справочно" "description": "IntercompanyMatrixOut; osv_entry_ids_* — справочно"
@ -1617,12 +1884,28 @@
"rule_no": { "rule_no": {
"type": "integer" "type": "integer"
}, },
"statement_type": {
"type": "string",
"enum": [
"balance",
"income"
]
},
"rules_version_no": {
"type": "integer"
},
"rule": {
"$ref": "#/$defs/CorrectionRuleOut"
},
"matrix": { "matrix": {
"$ref": "#/$defs/IntercompanyMatrixOut" "$ref": "#/$defs/IntercompanyMatrixOut"
} }
}, },
"required": [ "required": [
"rule_no", "rule_no",
"statement_type",
"rules_version_no",
"rule",
"matrix" "matrix"
], ],
"additionalProperties": true "additionalProperties": true
@ -1929,9 +2212,13 @@
"type": "integer" "type": "integer"
}, },
"quarter": { "quarter": {
"type": "integer", "type": "string",
"minimum": 1, "enum": [
"maximum": 4 "Q1",
"Q2",
"Q3",
"Q4"
]
}, },
"version_no": { "version_no": {
"type": "integer" "type": "integer"
@ -1961,6 +2248,7 @@
}, },
"members": { "members": {
"type": "array", "type": "array",
"minItems": 1,
"items": { "items": {
"type": "object", "type": "object",
"properties": { "properties": {
@ -1989,6 +2277,7 @@
}, },
"history": { "history": {
"type": "array", "type": "array",
"minItems": 1,
"items": { "items": {
"type": "object", "type": "object",
"properties": { "properties": {

View File

@ -32,11 +32,58 @@
"one_sided": false, "one_sided": false,
"skipped_osv_entry_count": 0 "skipped_osv_entry_count": 0
} }
] ],
"total_debit": {
"11111111-1111-4111-8111-111111111111": "102000000.00",
"22222222-2222-4222-8222-222222222222": "0.00",
"33333333-3333-4333-8333-333333333333": "0.00"
},
"total_credit": {
"11111111-1111-4111-8111-111111111111": "0.00",
"22222222-2222-4222-8222-222222222222": "100000400.50",
"33333333-3333-4333-8333-333333333333": "0.00"
}
}, },
"presets": [ "presets": [
{ {
"rule_no": 6, "rule_no": 6,
"statement_type": "balance",
"rules_version_no": 1,
"rule": {
"id": "66666666-6666-4666-8666-000000000006",
"rule_no": 6,
"article_1_line": "1230",
"article_2_line": "1520",
"side_1": "D",
"measure": "closing",
"company_1_accounts": [
"60.02",
"60.22",
"60.32",
"62.01",
"62.03",
"62.21",
"62.31",
"76"
],
"company_2_accounts": [
"60.01",
"60.03",
"60.21",
"60.31",
"62.02",
"62.22",
"62.32",
"76"
],
"company_1_excluded": [
"76.7.5",
"76.7.9"
],
"company_2_excluded": [
"76.7.1"
]
},
"matrix": { "matrix": {
"companies": [ "companies": [
{ {
@ -64,7 +111,17 @@
"one_sided": false, "one_sided": false,
"skipped_osv_entry_count": 0 "skipped_osv_entry_count": 0
} }
] ],
"total_debit": {
"11111111-1111-4111-8111-111111111111": "102000000.00",
"22222222-2222-4222-8222-222222222222": "0.00",
"33333333-3333-4333-8333-333333333333": "0.00"
},
"total_credit": {
"11111111-1111-4111-8111-111111111111": "0.00",
"22222222-2222-4222-8222-222222222222": "100000400.50",
"33333333-3333-4333-8333-333333333333": "0.00"
}
} }
} }
], ],
@ -87,15 +144,19 @@
{ {
"code": "1230", "code": "1230",
"name": "Дебиторская задолженность", "name": "Дебиторская задолженность",
"group_total": "112000000.00", "group_total": "142000000.00",
"amounts": [ "amounts": [
{ {
"company_id": "11111111-1111-4111-8111-111111111111", "company_id": "11111111-1111-4111-8111-111111111111",
"amount": "102000000.00" "amount": "132000000.00"
}, },
{ {
"company_id": "22222222-2222-4222-8222-222222222222", "company_id": "22222222-2222-4222-8222-222222222222",
"amount": "10000000.00" "amount": "10000000.00"
},
{
"company_id": "33333333-3333-4333-8333-333333333333",
"amount": "0.00"
} }
] ]
} }

View File

@ -6,41 +6,6 @@
"source_version_no": 1, "source_version_no": 1,
"data": { "data": {
"items": [ "items": [
{
"statement_type": "balance",
"rule_no": 6,
"company_1": {
"id": "22222222-2222-4222-8222-222222222222",
"name": "ООО «Бета»"
},
"company_2": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "ООО «Альфа»"
},
"correction": {
"status": "APPLIED",
"version_no": 1,
"debit": [
{
"line_code": "1230",
"amount": "10000000.00"
}
],
"credit": [
{
"line_code": "1520",
"amount": "10000000.00"
}
],
"comment": "Сверка Бета → Альфа: разница — аванс, исключаем подтверждённое",
"reason_code": null,
"updated_by": {
"user_id": "44444444-4444-4444-8444-444444444444",
"full_name": "Петрова Мария Ивановна"
},
"updated_at": "2025-11-12T14:30:00Z"
}
},
{ {
"statement_type": "balance", "statement_type": "balance",
"rule_no": 6, "rule_no": 6,
@ -73,12 +38,63 @@
], ],
"comment": "Часть долга Гаммы переведена в займ — разнесено по статьям", "comment": "Часть долга Гаммы переведена в займ — разнесено по статьям",
"reason_code": null, "reason_code": null,
"balance": {
"debit_total": "25000000.00",
"credit_total": "22500000.00",
"difference": "2500000.00",
"difference_percent": "11.11",
"remainder_1": "5000000.00",
"remainder_2": "6600000.00"
},
"updated_by": { "updated_by": {
"user_id": "44444444-4444-4444-8444-444444444444", "id": "44444444-4444-4444-8444-444444444444",
"full_name": "Петрова Мария Ивановна" "name": "Петрова Мария Ивановна"
}, },
"updated_at": "2025-11-13T09:10:00Z" "updated_at": "2025-11-13T09:10:00Z"
} }
},
{
"statement_type": "balance",
"rule_no": 6,
"company_1": {
"id": "22222222-2222-4222-8222-222222222222",
"name": "ООО «Бета»"
},
"company_2": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "ООО «Альфа»"
},
"correction": {
"status": "APPLIED",
"version_no": 1,
"debit": [
{
"line_code": "1230",
"amount": "10000000.00"
}
],
"credit": [
{
"line_code": "1520",
"amount": "10000000.00"
}
],
"comment": "Сверка Бета → Альфа: разница — аванс, исключаем подтверждённое",
"reason_code": null,
"balance": {
"debit_total": "10000000.00",
"credit_total": "10000000.00",
"difference": "0.00",
"difference_percent": "0.00",
"remainder_1": "0.00",
"remainder_2": "40000000.00"
},
"updated_by": {
"id": "44444444-4444-4444-8444-444444444444",
"name": "Петрова Мария Ивановна"
},
"updated_at": "2025-11-12T14:30:00Z"
}
} }
] ]
} }

View File

@ -28,8 +28,8 @@
"has_investments": true, "has_investments": true,
"warnings": [], "warnings": [],
"updated_by": { "updated_by": {
"user_id": "44444444-4444-4444-8444-444444444444", "id": "44444444-4444-4444-8444-444444444444",
"full_name": "Петрова Мария Ивановна" "name": "Петрова Мария Ивановна"
}, },
"updated_at": "2025-11-12T11:00:00Z" "updated_at": "2025-11-12T11:00:00Z"
} }

View File

@ -7,7 +7,9 @@
"data": { "data": {
"rows": [ "rows": [
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000013"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111", "legal_entity_id": "11111111-1111-4111-8111-111111111111",
"legal_entity_name": "ООО «Альфа»", "legal_entity_name": "ООО «Альфа»",
"legal_entity_inn": "7701000001", "legal_entity_inn": "7701000001",
@ -33,7 +35,9 @@
"warnings": [] "warnings": []
}, },
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000014"
],
"legal_entity_id": "22222222-2222-4222-8222-222222222222", "legal_entity_id": "22222222-2222-4222-8222-222222222222",
"legal_entity_name": "ООО «Бета»", "legal_entity_name": "ООО «Бета»",
"legal_entity_inn": "7701000002", "legal_entity_inn": "7701000002",
@ -59,7 +63,9 @@
"warnings": [] "warnings": []
}, },
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000012"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111", "legal_entity_id": "11111111-1111-4111-8111-111111111111",
"legal_entity_name": "ООО «Альфа»", "legal_entity_name": "ООО «Альфа»",
"legal_entity_inn": "7701000001", "legal_entity_inn": "7701000001",
@ -96,7 +102,7 @@
"legal_entity_name": "ООО «Гамма»", "legal_entity_name": "ООО «Гамма»",
"account_code": "76", "account_code": "76",
"missing_quarters": [ "missing_quarters": [
1 "Q1"
] ]
} }
], ],

View File

@ -15,7 +15,7 @@
}, },
"reporting_date": "2025-10-01", "reporting_date": "2025-10-01",
"year": 2025, "year": 2025,
"quarter": 3, "quarter": "Q3",
"version_no": 1, "version_no": 1,
"scenario": "CREATE", "scenario": "CREATE",
"approach": "BASIC", "approach": "BASIC",

View File

@ -9,8 +9,170 @@
"version_id": "99999999-9999-4999-8999-999999999999", "version_id": "99999999-9999-4999-8999-999999999999",
"statement_type": "balance", "statement_type": "balance",
"rules_version_no": 1, "rules_version_no": 1,
"rules": [], "rules": [
{
"id": "66666666-6666-4666-8666-000000000002",
"rule_no": 2,
"article_1_line": "1170",
"article_2_line": "1310/1350/1370",
"side_1": "D",
"measure": "closing",
"company_1_accounts": [
"58.01"
],
"company_2_accounts": [
"80",
"83"
],
"company_1_excluded": [],
"company_2_excluded": []
},
{
"id": "66666666-6666-4666-8666-000000000006",
"rule_no": 6,
"article_1_line": "1230",
"article_2_line": "1520",
"side_1": "D",
"measure": "closing",
"company_1_accounts": [
"60.02",
"60.22",
"60.32",
"62.01",
"62.03",
"62.21",
"62.31",
"76"
],
"company_2_accounts": [
"60.01",
"60.03",
"60.21",
"60.31",
"62.02",
"62.22",
"62.32",
"76"
],
"company_1_excluded": [
"76.7.5",
"76.7.9"
],
"company_2_excluded": [
"76.7.1"
]
}
],
"aggregates": [ "aggregates": [
{
"rule_id": "66666666-6666-4666-8666-000000000002",
"rule_no": 2,
"company_1": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "ООО «Альфа»"
},
"company_2": {
"id": "22222222-2222-4222-8222-222222222222",
"name": "ООО «Бета»"
},
"side_1": {
"article_line": "1170",
"accounts": [
"58.01"
],
"amount": "50000000.00",
"entries": [
{
"entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000003"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111",
"counterparty_id": "22222222-2222-4222-8222-222222222222",
"account_code": "58.01",
"side": "D",
"amount": "50000000.00",
"decision": "AUTO",
"candidate_rule_ids": []
}
]
},
"side_2": {
"article_line": "1310/1350/1370",
"accounts": [
"80"
],
"amount": "40000000.00",
"entries": [
{
"entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000004"
],
"legal_entity_id": "22222222-2222-4222-8222-222222222222",
"counterparty_id": "11111111-1111-4111-8111-111111111111",
"account_code": "80",
"side": "K",
"amount": "40000000.00",
"decision": "AUTO",
"candidate_rule_ids": []
}
]
},
"pairs": [],
"deviation_amount": "10000000.00",
"deviation_percent": "25.00",
"exceeds_threshold": false,
"status": "AUTO",
"eliminated_amount": "40000000.00",
"composition_changed": false,
"correction": null
},
{
"rule_id": "66666666-6666-4666-8666-000000000002",
"rule_no": 2,
"company_1": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "ООО «Альфа»"
},
"company_2": {
"id": "33333333-3333-4333-8333-333333333333",
"name": "ООО «Гамма»"
},
"side_1": {
"article_line": "1170",
"accounts": [
"58.01"
],
"amount": "15000000.00",
"entries": [
{
"entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000005"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111",
"counterparty_id": "33333333-3333-4333-8333-333333333333",
"account_code": "58.01",
"side": "D",
"amount": "15000000.00",
"decision": "AUTO",
"candidate_rule_ids": []
}
]
},
"side_2": {
"article_line": "1310/1350/1370",
"accounts": [],
"amount": "0.00",
"entries": []
},
"pairs": [],
"deviation_amount": "15000000.00",
"deviation_percent": null,
"exceeds_threshold": false,
"status": "ONE_SIDED",
"eliminated_amount": "15000000.00",
"composition_changed": false,
"correction": null
},
{ {
"rule_id": "66666666-6666-4666-8666-000000000006", "rule_id": "66666666-6666-4666-8666-000000000006",
"rule_no": 6, "rule_no": 6,
@ -30,7 +192,9 @@
"amount": "102000000.00", "amount": "102000000.00",
"entries": [ "entries": [
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000001"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111", "legal_entity_id": "11111111-1111-4111-8111-111111111111",
"counterparty_id": "22222222-2222-4222-8222-222222222222", "counterparty_id": "22222222-2222-4222-8222-222222222222",
"account_code": "62.01", "account_code": "62.01",
@ -49,7 +213,9 @@
"amount": "100000400.50", "amount": "100000400.50",
"entries": [ "entries": [
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000002"
],
"legal_entity_id": "22222222-2222-4222-8222-222222222222", "legal_entity_id": "22222222-2222-4222-8222-222222222222",
"counterparty_id": "11111111-1111-4111-8111-111111111111", "counterparty_id": "11111111-1111-4111-8111-111111111111",
"account_code": "60.01", "account_code": "60.01",
@ -60,6 +226,54 @@
} }
] ]
}, },
"pairs": [
{
"side_1": {
"article_line": "1230",
"accounts": [
"62.01"
],
"amount": "102000000.00",
"entries": [
{
"entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000001"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111",
"counterparty_id": "22222222-2222-4222-8222-222222222222",
"account_code": "62.01",
"side": "D",
"amount": "102000000.00",
"decision": "AUTO",
"candidate_rule_ids": []
}
]
},
"side_2": {
"article_line": "1520",
"accounts": [
"60.01"
],
"amount": "100000400.50",
"entries": [
{
"entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000002"
],
"legal_entity_id": "22222222-2222-4222-8222-222222222222",
"counterparty_id": "11111111-1111-4111-8111-111111111111",
"account_code": "60.01",
"side": "K",
"amount": "100000400.50",
"decision": "AUTO",
"candidate_rule_ids": []
}
]
},
"deviation_amount": "1999599.50",
"deviation_percent": "2.00"
}
],
"deviation_amount": "1999599.50", "deviation_amount": "1999599.50",
"deviation_percent": "2.00", "deviation_percent": "2.00",
"exceeds_threshold": false, "exceeds_threshold": false,
@ -68,6 +282,102 @@
"composition_changed": false, "composition_changed": false,
"correction": null "correction": null
}, },
{
"rule_id": "66666666-6666-4666-8666-000000000006",
"rule_no": 6,
"company_1": {
"id": "11111111-1111-4111-8111-111111111111",
"name": "ООО «Альфа»"
},
"company_2": {
"id": "33333333-3333-4333-8333-333333333333",
"name": "ООО «Гамма»"
},
"side_1": {
"article_line": "1230",
"accounts": [
"62.01"
],
"amount": "30000000.00",
"entries": [
{
"entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000006"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111",
"counterparty_id": "33333333-3333-4333-8333-333333333333",
"account_code": "62.01",
"side": "D",
"amount": "30000000.00",
"decision": "AUTO",
"candidate_rule_ids": []
}
]
},
"side_2": {
"article_line": "1520",
"accounts": [
"60.01"
],
"amount": "29100000.00",
"entries": [
{
"entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000007"
],
"legal_entity_id": "33333333-3333-4333-8333-333333333333",
"counterparty_id": "11111111-1111-4111-8111-111111111111",
"account_code": "60.01",
"side": "K",
"amount": "29100000.00",
"decision": "AUTO",
"candidate_rule_ids": []
}
]
},
"pairs": [],
"deviation_amount": "900000.00",
"deviation_percent": "3.09",
"exceeds_threshold": false,
"status": "AUTO",
"eliminated_amount": "29100000.00",
"composition_changed": false,
"correction": {
"status": "APPLIED",
"version_no": 2,
"debit": [
{
"line_code": "1230",
"amount": "20000000.00"
},
{
"line_code": "1170",
"amount": "5000000.00"
}
],
"credit": [
{
"line_code": "1520",
"amount": "22500000.00"
}
],
"comment": "Часть долга Гаммы переведена в займ — разнесено по статьям",
"reason_code": null,
"balance": {
"debit_total": "25000000.00",
"credit_total": "22500000.00",
"difference": "2500000.00",
"difference_percent": "11.11",
"remainder_1": "5000000.00",
"remainder_2": "6600000.00"
},
"updated_by": {
"id": "44444444-4444-4444-8444-444444444444",
"name": "Петрова Мария Ивановна"
},
"updated_at": "2025-11-13T09:10:00Z"
}
},
{ {
"rule_id": "66666666-6666-4666-8666-000000000006", "rule_id": "66666666-6666-4666-8666-000000000006",
"rule_no": 6, "rule_no": 6,
@ -87,7 +397,9 @@
"amount": "10000000.00", "amount": "10000000.00",
"entries": [ "entries": [
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000008"
],
"legal_entity_id": "22222222-2222-4222-8222-222222222222", "legal_entity_id": "22222222-2222-4222-8222-222222222222",
"counterparty_id": "11111111-1111-4111-8111-111111111111", "counterparty_id": "11111111-1111-4111-8111-111111111111",
"account_code": "62.01", "account_code": "62.01",
@ -107,7 +419,9 @@
"amount": "50000000.00", "amount": "50000000.00",
"entries": [ "entries": [
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000009"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111", "legal_entity_id": "11111111-1111-4111-8111-111111111111",
"counterparty_id": "22222222-2222-4222-8222-222222222222", "counterparty_id": "22222222-2222-4222-8222-222222222222",
"account_code": "60.01", "account_code": "60.01",
@ -117,7 +431,9 @@
"candidate_rule_ids": [] "candidate_rule_ids": []
}, },
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000010"
],
"legal_entity_id": "11111111-1111-4111-8111-111111111111", "legal_entity_id": "11111111-1111-4111-8111-111111111111",
"counterparty_id": "22222222-2222-4222-8222-222222222222", "counterparty_id": "22222222-2222-4222-8222-222222222222",
"account_code": "76.05", "account_code": "76.05",
@ -128,6 +444,7 @@
} }
] ]
}, },
"pairs": [],
"deviation_amount": "40000000.00", "deviation_amount": "40000000.00",
"deviation_percent": "400.00", "deviation_percent": "400.00",
"exceeds_threshold": true, "exceeds_threshold": true,
@ -151,9 +468,17 @@
], ],
"comment": "Сверка Бета → Альфа: разница — аванс, исключаем подтверждённое", "comment": "Сверка Бета → Альфа: разница — аванс, исключаем подтверждённое",
"reason_code": null, "reason_code": null,
"balance": {
"debit_total": "10000000.00",
"credit_total": "10000000.00",
"difference": "0.00",
"difference_percent": "0.00",
"remainder_1": "0.00",
"remainder_2": "40000000.00"
},
"updated_by": { "updated_by": {
"user_id": "44444444-4444-4444-8444-444444444444", "id": "44444444-4444-4444-8444-444444444444",
"full_name": "Петрова Мария Ивановна" "name": "Петрова Мария Ивановна"
}, },
"updated_at": "2025-11-12T14:30:00Z" "updated_at": "2025-11-12T14:30:00Z"
} }
@ -161,7 +486,9 @@
], ],
"unallocated": [ "unallocated": [
{ {
"entry_ids": [], "entry_ids": [
"aaaaaaaa-0000-4000-8000-000000000011"
],
"owner": { "owner": {
"id": "33333333-3333-4333-8333-333333333333", "id": "33333333-3333-4333-8333-333333333333",
"name": "ООО «Гамма»" "name": "ООО «Гамма»"
@ -174,17 +501,20 @@
"line_code": null, "line_code": null,
"side": "D", "side": "D",
"amount": "350000.00", "amount": "350000.00",
"candidate_rule_ids": [], "candidate_rule_ids": [
"66666666-6666-4666-8666-000000000002",
"66666666-6666-4666-8666-000000000006"
],
"reason": "MULTIPLE_RULES", "reason": "MULTIPLE_RULES",
"excluded": true "excluded": true
} }
], ],
"totals": { "totals": {
"amount_1": "112000000.00", "amount_1": "207000000.00",
"amount_2": "150000400.50", "amount_2": "219100400.50",
"deviation_amount": "41999599.50", "deviation_amount": "67899599.50",
"correction_debit": "10000000.00", "correction_debit": "35000000.00",
"correction_credit": "10000000.00" "correction_credit": "32500000.00"
} }
}, },
"income": null "income": null

View File

@ -1559,7 +1559,7 @@ Table ex_snapshot {
superseded_by_snapshot_id uuid [ref: > ex_snapshot.id, note: 'v5.12: для ARCHIVE — ссылка на актуальный срез, который его заместил'] superseded_by_snapshot_id uuid [ref: > ex_snapshot.id, note: 'v5.12: для ARCHIVE — ссылка на актуальный срез, который его заместил']
verified_at timestamptz [not null] verified_at timestamptz [not null]
written_at timestamptz [not null] written_at timestamptz [not null]
written_by uuid [ref: > app_user.id, note: 'инициатор записи'] written_by uuid [ref: > app_user.id, note: 'инициатор записи = пользователь, выполнивший переход «Верифицирован» (v5.26, §14)']
archived_at timestamptz archived_at timestamptz
data_lake_ref varchar [note: 'ссылка на архив в data lake'] data_lake_ref varchar [note: 'ссылка на архив в data lake']
Indexes { Indexes {

View File

@ -69,7 +69,7 @@ proposal, AURORA-1562). Обязательные поля задаёт схем
| `goodwill` | `rub` | только при `goodwill_enabled`: `GoodwillTableOut` (`dev/api-contract-goodwill.*`) без `editable`/`read_only_reason` — строки, группы, итоги | | `goodwill` | `rub` | только при `goodwill_enabled`: `GoodwillTableOut` (`dev/api-contract-goodwill.*`) без `editable`/`read_only_reason` — строки, группы, итоги |
| `corrections` | `rub` | применённые корректировки (`APPLIED`; `REVOKED` нет, `DRAFT` не пишется): `{items: [{statement_type, rule_no, company_1: Ref, company_2: Ref, correction: CorrectionOut}]}` — `CorrectionOut` как в контракте корректировок (`updated_by`/`updated_at` — кто и когда сохранил) | | `corrections` | `rub` | применённые корректировки (`APPLIED`; `REVOKED` нет, `DRAFT` не пишется): `{items: [{statement_type, rule_no, company_1: Ref, company_2: Ref, correction: CorrectionOut}]}` — `CorrectionOut` как в контракте корректировок (`updated_by`/`updated_at` — кто и когда сохранил) |
| `other_report` | `thousand_rub` | только при `scenario = CONFIRM`: `{report_kind: "client_kfo_comparison", lines[] {statement_type, line_code, line_name, client_amount, client_vgo_amount, bank_amount, bank_vgo_amount, deviation_amount, deviation_percent, deviation_reason, comment}}` по `client_kfo_line` (контракта API ещё нет — AURORA-1549; имена — как в DBML) | | `other_report` | `thousand_rub` | только при `scenario = CONFIRM`: `{report_kind: "client_kfo_comparison", lines[] {statement_type, line_code, line_name, client_amount, client_vgo_amount, bank_amount, bank_vgo_amount, deviation_amount, deviation_percent, deviation_reason, comment}}` по `client_kfo_line` (контракта API ещё нет — AURORA-1549; имена — как в DBML) |
| `version_card` | `none` | один на срез, **новый тип**: `company_group {id, name}`, `related_group {id, name}`, `reporting_date`, `year`, `quarter`, `version_no`, `scenario`, `approach`, `goodwill_enabled`, `initiator` (UserRef), `initiator_office {id, name}`, `members[]` `{legal_entity_id, name, inn, is_head_entity}`, `history[]` как `VersionCard.history` (`{from_status, to_status, changed_by (UserRef), changed_at, comment}`), `verified_by` (UserRef), `verified_at`, `uob_decision_no`, `uob_decision_date`, `methodology_deviations` | | `version_card` | `none` | один на срез, **новый тип**: `company_group {id, name}`, `related_group {id, name}`, `reporting_date`, `year`, `quarter`, `version_no`, `scenario`, `approach`, `goodwill_enabled`, `initiator` (UserRef); `quarter` — `"Q1"…"Q4"`, `initiator_office {id, name}`, `members[]` `{legal_entity_id, name, inn, is_head_entity}`, `history[]` как `VersionCard.history` (`{from_status, to_status, changed_by (UserRef), changed_at, comment}`), `verified_by` (UserRef), `verified_at`, `uob_decision_no`, `uob_decision_date`, `methodology_deviations` |
`UserRef {user_id, full_name}` — ФИО на дату верификации (пользователь может быть отключён, но не удаляется). `UserRef {user_id, full_name}` — ФИО на дату верификации (пользователь может быть отключён, но не удаляется).
@ -122,4 +122,8 @@ proposal, AURORA-1562). Обязательные поля задаёт схем
| 9 | 06.11.2026 | Payload покрывает и выгрузку xlsx рабочей версии (пробелы, способ сопоставления, строки ОСВ агрегатов, сводка корректировок), не только экран | Срез выгружается на лету из payload, выгрузка должна совпасть с рабочей (1562); ответ на вопрос проверки исполнителем 1 | Срез заметно больше (строки ОСВ агрегатов) | | 9 | 06.11.2026 | Payload покрывает и выгрузку xlsx рабочей версии (пробелы, способ сопоставления, строки ОСВ агрегатов, сводка корректировок), не только экран | Срез выгружается на лету из payload, выгрузка должна совпасть с рабочей (1562); ответ на вопрос проверки исполнителем 1 | Срез заметно больше (строки ОСВ агрегатов) |
| 10 | 06.11.2026 | `data` — DTO API без изменений имён и вложенности; таблица §4.2 подчинена принципу | Рендер и выгрузка ЕХ переиспользуют виджеты и выгрузки рабочей версии без маппинга; вопрос проверки 2 | Изменение DTO API после 1.0 требует новой версии схемы или совместимого расширения | | 10 | 06.11.2026 | `data` — DTO API без изменений имён и вложенности; таблица §4.2 подчинена принципу | Рендер и выгрузка ЕХ переиспользуют виджеты и выгрузки рабочей версии без маппинга; вопрос проверки 2 | Изменение DTO API после 1.0 требует новой версии схемы или совместимого расширения |
| 11 | 06.11.2026 | Нумерация среза — по ГСК; «один актуальный» и `superseded_by` — по ГК и дате | Как в DBML и DOC-274686 (решения Р-35/Р-36 по ГК); вопрос проверки 3 | При ключе «ГСК» у заказчика — правка правила связи и проверки 2002 | | 11 | 06.11.2026 | Нумерация среза — по ГСК; «один актуальный» и `superseded_by` — по ГК и дате | Как в DBML и DOC-274686 (решения Р-35/Р-36 по ГК); вопрос проверки 3 | При ключе «ГСК» у заказчика — правка правила связи и проверки 2002 |
| 12 | 06.11.2026 | Схема обязывает то, что читают выгрузки xlsx рабочей версии: итоги шахматки `total_debit`/`total_credit`, правило пресета и `rules` таблицы корректировок, `pairs`, `balance` корректировки, `entry_ids` строк | Ревью C/I: без них выгрузка среза не совпадёт с рабочей (решение #9) | Больше обязательных полей — писателю нельзя «урезать» DTO |
| 13 | 06.11.2026 | Проценты к меньшей стороне (шахматка, агрегаты, корректировки) — без ограничения разрядов; квартал — `"Q1"…"Q4"`; `updated_by` — `Ref`, как в DTO | Ревью C-1, C-2, I-2: настоящие ответы API не проходили схему | — |
| 14 | 06.11.2026 | КФО в срезе — только замороженная и `VERIFIED`; карточка — непустые состав и история | Ревью M-1: пустой или незамороженный payload не должен проходить | Срез версии без истории маршрута (миграция старых данных) схему не пройдёт |
| 15 | 06.11.2026 | Ошибка пресета правила (422 `INVALID_RULE`/`ACCOUNTS_REQUIRED`) — пресет пропускается; другая ошибка сборки — сбой записи среза | Ревью M-5 | Срез без пресета правила, которое на экране тоже не строится |
| 8 | 06.11.2026 | Без отдельного согласования дизайна с владельцем: схема описана в чате 06.11 («все так»), владелец сказал «делай схему» | Срок 12.11, владелец просил не останавливаться | Расхождение с ожиданием владельца видно только в PR | | 8 | 06.11.2026 | Без отдельного согласования дизайна с владельцем: схема описана в чате 06.11 («все так»), владелец сказал «делай схему» | Срок 12.11, владелец просил не останавливаться | Расхождение с ожиданием владельца видно только в PR |

View File

@ -17,9 +17,12 @@ import gen_kfo_openapi as kfo # noqa: E402
MONEY_RE = r"^-?\d{1,16}\.\d{2}$" MONEY_RE = r"^-?\d{1,16}\.\d{2}$"
M = {"type": "string", "pattern": MONEY_RE} M = {"type": "string", "pattern": MONEY_RE}
MN = {"type": ["string", "null"], "pattern": MONEY_RE} MN = {"type": ["string", "null"], "pattern": MONEY_RE}
PN = {"type": ["string", "null"], "pattern": r"^-?\d{1,5}\.\d{2}$"} PN = {"type": ["string", "null"], "pattern": r"^-?\d{1,5}\.\d{2}$"} # доля, % (ограничена)
PF = {"type": ["string", "null"], "pattern": r"^-?\d+\.\d{2}$"} # процент к меньшей стороне — не ограничен
QUARTER = {"type": "string", "enum": ["Q1", "Q2", "Q3", "Q4"]}
UUID = {"type": "string", "format": "uuid"} UUID = {"type": "string", "format": "uuid"}
UUIDN = {"type": ["string", "null"], "format": "uuid"} UUIDN = {"type": ["string", "null"], "format": "uuid"}
UUIDS1 = {"type": "array", "items": UUID, "minItems": 1}
STR = {"type": "string"} STR = {"type": "string"}
STRN = {"type": ["string", "null"]} STRN = {"type": ["string", "null"]}
DATE = {"type": "string", "format": "date"} DATE = {"type": "string", "format": "date"}
@ -76,9 +79,13 @@ def defs():
out["KfoBalanceData"] = obj({**base, "balance": d("KfoStatementOut")}, out["KfoBalanceData"] = obj({**base, "balance": d("KfoStatementOut")},
desc="KfoResultOut без editable/read_only_reason, только отчёт ББ") desc="KfoResultOut без editable/read_only_reason, только отчёт ББ")
out["KfoBalanceData"]["not"] = {"required": ["income"]} out["KfoBalanceData"]["not"] = {"required": ["income"]}
frozen = {"properties": {"is_frozen": {"const": True}, "companies": {"minItems": 1},
"requisites": {"properties": {"version_status": {"const": "VERIFIED"}}}}}
out["KfoBalanceData"] = {"allOf": [out["KfoBalanceData"], frozen]}
out["KfoIncomeData"] = obj({**base, "income": d("KfoStatementOut")}, out["KfoIncomeData"] = obj({**base, "income": d("KfoStatementOut")},
desc="KfoResultOut без editable/read_only_reason, только отчёт ОФР") desc="KfoResultOut без editable/read_only_reason, только отчёт ОФР")
out["KfoIncomeData"]["not"] = {"required": ["balance"]} out["KfoIncomeData"]["not"] = {"required": ["balance"]}
out["KfoIncomeData"] = {"allOf": [out["KfoIncomeData"], frozen]}
out["Ref"] = obj({"id": UUID, "name": STR}) out["Ref"] = obj({"id": UUID, "name": STR})
out["UserRef"] = obj({"user_id": UUIDN, "full_name": STR}, out["UserRef"] = obj({"user_id": UUIDN, "full_name": STR},
desc="Пользователь с ФИО на дату верификации (user_id — справочно, app_user не удаляется)") desc="Пользователь с ФИО на дату верификации (user_id — справочно, app_user не удаляется)")
@ -94,35 +101,46 @@ def defs():
"closing_debit": MN, "closing_credit": MN, "closing_debit": MN, "closing_credit": MN,
}, desc="ConsolidatedRowOut (dev/api-contract-slice-4.md §3); entry_ids, warnings — справочно, необязательны") }, desc="ConsolidatedRowOut (dev/api-contract-slice-4.md §3); entry_ids, warnings — справочно, необязательны")
out["OsvGapOut"] = obj({"legal_entity_id": UUID, "legal_entity_name": STR, "account_code": STR, out["OsvGapOut"] = obj({"legal_entity_id": UUID, "legal_entity_name": STR, "account_code": STR,
"missing_quarters": arr({"type": "integer", "minimum": 1, "maximum": 4})}) "missing_quarters": arr(QUARTER)})
out["OsvSummaryOut"] = obj({"rows_total": {"type": "integer"}, "gaps": arr(d("OsvGapOut"))}) out["OsvSummaryOut"] = obj({"rows_total": {"type": "integer"}, "gaps": arr(d("OsvGapOut"))})
out["SummaryOsvData"] = obj({"rows": arr(d("ConsolidatedRowOut")), "summary": d("OsvSummaryOut")}) out["SummaryOsvData"] = obj({"rows": arr(d("ConsolidatedRowOut")), "summary": d("OsvSummaryOut")})
# Таблица корректировок — dev/api-contract-corrections.* # Таблица корректировок — dev/api-contract-corrections.*
out["CorrectionEntryOut"] = obj({"legal_entity_id": UUID, "counterparty_id": UUID, "account_code": STR, out["CorrectionEntryOut"] = obj({"entry_ids": UUIDS1, "legal_entity_id": UUID, "counterparty_id": UUID, "account_code": STR,
"side": {"type": "string", "enum": ["D", "K"]}, "amount": M, "decision": STR}, "side": {"type": "string", "enum": ["D", "K"]}, "amount": M, "decision": STR},
desc="строка ОСВ агрегата (нужна выгрузке таблицы корректировок)") desc="строка ОСВ агрегата (нужна выгрузке таблицы корректировок)")
out["AggregateSideOut"] = obj({"article_line": STRN, "accounts": arr(STR), "amount": M, out["AggregateSideOut"] = obj({"article_line": STRN, "accounts": arr(STR), "amount": M,
"entries": arr(d("CorrectionEntryOut"))}) "entries": arr(d("CorrectionEntryOut"))})
out["CorrectionLineOut"] = obj({"line_code": STR, "amount": M}) out["CorrectionLineOut"] = obj({"line_code": STR, "amount": M})
out["CorrectionBalanceOut"] = obj({"debit_total": M, "credit_total": M, "difference": M, "difference_percent": PF,
"remainder_1": MN, "remainder_2": MN})
out["CorrectionPairOut"] = obj({"side_1": d("AggregateSideOut"), "side_2": d("AggregateSideOut"),
"deviation_amount": M, "deviation_percent": PF})
out["CorrectionRuleOut"] = obj({"id": UUID, "rule_no": {"type": "integer"}, "article_1_line": STRN,
"article_2_line": STRN, "side_1": {"type": "string", "enum": ["D", "K"]},
"measure": STR, "company_1_accounts": arr(STR), "company_2_accounts": arr(STR),
"company_1_excluded": arr(STR), "company_2_excluded": arr(STR)},
desc="Правило элиминации на дату верификации (CorrectionRuleOut)")
out["CorrectionOut"] = obj({"status": {"type": "string", "enum": ["APPLIED"]}, "version_no": {"type": "integer"}, out["CorrectionOut"] = obj({"status": {"type": "string", "enum": ["APPLIED"]}, "version_no": {"type": "integer"},
"debit": arr(d("CorrectionLineOut")), "credit": arr(d("CorrectionLineOut")), "debit": arr(d("CorrectionLineOut")), "credit": arr(d("CorrectionLineOut")),
"comment": STR, "updated_by": {}, "updated_at": DT}, "comment": STR, "balance": d("CorrectionBalanceOut"),
"updated_by": {"anyOf": [d("Ref"), {"type": "null"}]}, "updated_at": DT},
desc="CorrectionOut; в срезе только APPLIED") desc="CorrectionOut; в срезе только APPLIED")
out["CorrectionAggregateOut"] = obj({ out["CorrectionAggregateOut"] = obj({
"rule_no": {"type": "integer"}, "company_1": d("Ref"), "company_2": d("Ref"), "rule_no": {"type": "integer"}, "company_1": d("Ref"), "company_2": d("Ref"),
"side_1": d("AggregateSideOut"), "side_2": d("AggregateSideOut"), "side_1": d("AggregateSideOut"), "side_2": d("AggregateSideOut"), "pairs": arr(d("CorrectionPairOut")),
"deviation_amount": M, "deviation_percent": PN, "exceeds_threshold": {"type": "boolean"}, "deviation_amount": M, "deviation_percent": PF, "exceeds_threshold": {"type": "boolean"},
"status": {"type": "string", "enum": ["AUTO", "DISCREPANCY", "ONE_SIDED", "MANUAL"]}, "status": {"type": "string", "enum": ["AUTO", "DISCREPANCY", "ONE_SIDED", "MANUAL"]},
"eliminated_amount": M, "eliminated_amount": M,
"correction": {"anyOf": [d("CorrectionOut"), {"type": "null"}]}, "correction": {"anyOf": [d("CorrectionOut"), {"type": "null"}]},
}) })
out["UnallocatedEntryOut"] = obj({"owner": d("Ref"), "counterparty": d("Ref"), "account_code": STR, out["UnallocatedEntryOut"] = obj({"entry_ids": UUIDS1, "owner": d("Ref"), "counterparty": d("Ref"), "account_code": STR,
"side": {"type": "string", "enum": ["D", "K"]}, "amount": M, "side": {"type": "string", "enum": ["D", "K"]}, "amount": M,
"reason": STR, "excluded": {"type": "boolean"}}) "reason": STR, "excluded": {"type": "boolean"}})
out["CorrectionTotalsOut"] = obj({"amount_1": M, "amount_2": M, "deviation_amount": M, out["CorrectionTotalsOut"] = obj({"amount_1": M, "amount_2": M, "deviation_amount": M,
"correction_debit": M, "correction_credit": M}) "correction_debit": M, "correction_credit": M})
out["CorrectionTableData"] = obj({ out["CorrectionTableData"] = obj({
"statement_type": {"type": "string", "enum": ["balance", "income"]}, "rules_version_no": {"type": "integer"}, "statement_type": {"type": "string", "enum": ["balance", "income"]}, "rules_version_no": {"type": "integer"},
"rules": {"type": "array", "items": d("CorrectionRuleOut"), "minItems": 1},
"aggregates": arr(d("CorrectionAggregateOut")), "unallocated": arr(d("UnallocatedEntryOut")), "aggregates": arr(d("CorrectionAggregateOut")), "unallocated": arr(d("UnallocatedEntryOut")),
"totals": d("CorrectionTotalsOut"), "totals": d("CorrectionTotalsOut"),
}, desc="CorrectionTableOut без editable/read_only_reason") }, desc="CorrectionTableOut без editable/read_only_reason")
@ -133,14 +151,19 @@ def defs():
"company_1": d("Ref"), "company_2": d("Ref"), "correction": d("CorrectionOut")}))}) "company_1": d("Ref"), "company_2": d("Ref"), "correction": d("CorrectionOut")}))})
# Шахматка — dev/frontend-api-guide.md §5.7.1 # Шахматка — dev/frontend-api-guide.md §5.7.1
out["MatrixCellOut"] = obj({"company_a_id": UUID, "company_b_id": UUID, "amount_a": M, "amount_b": M, out["MatrixCellOut"] = obj({"company_a_id": UUID, "company_b_id": UUID, "amount_a": M, "amount_b": M,
"variance_amount": M, "variance_percent": PN, "exceeds_threshold": {"type": "boolean"}, "variance_amount": M, "variance_percent": PF, "exceeds_threshold": {"type": "boolean"},
"one_sided": {"type": "boolean"}}) "one_sided": {"type": "boolean"}, "skipped_osv_entry_count": {"type": "integer"}})
out["IntercompanyMatrixOut"] = obj({"companies": arr(d("Ref")), "cells": arr(d("MatrixCellOut"))}, totals = {"type": "object", "propertyNames": {"format": "uuid"}, "additionalProperties": M}
out["IntercompanyMatrixOut"] = obj({"companies": {"type": "array", "items": d("Ref"), "minItems": 1},
"cells": arr(d("MatrixCellOut")), "total_debit": totals,
"total_credit": totals},
desc="IntercompanyMatrixOut; osv_entry_ids_* — справочно") desc="IntercompanyMatrixOut; osv_entry_ids_* — справочно")
out["ResultTableOut"] = obj({"companies": arr(d("Ref")), "articles": arr(obj({ out["ResultTableOut"] = obj({"companies": arr(d("Ref")), "articles": arr(obj({
"code": STR, "name": STR, "amounts": arr(obj({"company_id": UUID, "amount": M})), "group_total": M}))}) "code": STR, "name": STR, "amounts": arr(obj({"company_id": UUID, "amount": M})), "group_total": M}))})
out["ChessData"] = obj({"matrix_all": d("IntercompanyMatrixOut"), out["ChessData"] = obj({"matrix_all": d("IntercompanyMatrixOut"),
"presets": arr(obj({"rule_no": {"type": "integer"}, "matrix": d("IntercompanyMatrixOut")})), "presets": arr(obj({"rule_no": {"type": "integer"}, "statement_type": {"type": "string", "enum": ["balance", "income"]},
"rules_version_no": {"type": "integer"}, "rule": d("CorrectionRuleOut"),
"matrix": d("IntercompanyMatrixOut")})),
"result_table": d("ResultTableOut")}) "result_table": d("ResultTableOut")})
# Гудвилл — dev/api-contract-goodwill.* # Гудвилл — dev/api-contract-goodwill.*
out["GoodwillTotalsOut"] = obj({"financial_investment_amount": MN, "charter_capital_amount": MN, out["GoodwillTotalsOut"] = obj({"financial_investment_amount": MN, "charter_capital_amount": MN,
@ -161,14 +184,15 @@ def defs():
statuses = kfo.SCHEMAS["KfoRequisitesOut"]["properties"]["version_status"]["enum"] statuses = kfo.SCHEMAS["KfoRequisitesOut"]["properties"]["version_status"]["enum"]
out["VersionCardData"] = obj({ out["VersionCardData"] = obj({
"company_group": d("Ref"), "related_group": d("Ref"), "reporting_date": DATE, "company_group": d("Ref"), "related_group": d("Ref"), "reporting_date": DATE,
"year": {"type": "integer"}, "quarter": {"type": "integer", "minimum": 1, "maximum": 4}, "year": {"type": "integer"}, "quarter": QUARTER,
"version_no": {"type": "integer"}, "scenario": {"type": "string", "enum": ["CREATE", "CONFIRM"]}, "version_no": {"type": "integer"}, "scenario": {"type": "string", "enum": ["CREATE", "CONFIRM"]},
"approach": {"type": "string", "enum": ["BASIC", "EXTENDED"]}, "goodwill_enabled": {"type": "boolean"}, "approach": {"type": "string", "enum": ["BASIC", "EXTENDED"]}, "goodwill_enabled": {"type": "boolean"},
"initiator": d("UserRef"), "initiator_office": d("Ref"), "initiator": d("UserRef"), "initiator_office": d("Ref"),
"members": arr(obj({"legal_entity_id": UUID, "name": STR, "inn": STR, "is_head_entity": {"type": "boolean"}})), "members": {"type": "array", "minItems": 1, "items": obj({"legal_entity_id": UUID, "name": STR, "inn": STR,
"history": arr(obj({"from_status": {"type": ["string", "null"], "enum": statuses + [None]}, "is_head_entity": {"type": "boolean"}})},
"history": {"type": "array", "minItems": 1, "items": obj({"from_status": {"type": ["string", "null"], "enum": statuses + [None]},
"to_status": {"type": "string", "enum": statuses}, "to_status": {"type": "string", "enum": statuses},
"changed_by": d("UserRef"), "changed_at": DT, "comment": STRN})), "changed_by": d("UserRef"), "changed_at": DT, "comment": STRN})},
"verified_by": d("UserRef"), "verified_at": DT, "verified_by": d("UserRef"), "verified_at": DT,
"uob_decision_no": STRN, "uob_decision_date": {"type": ["string", "null"], "format": "date"}, "uob_decision_no": STRN, "uob_decision_date": {"type": ["string", "null"], "format": "date"},
"methodology_deviations": STRN, "methodology_deviations": STRN,
@ -225,51 +249,86 @@ def examples():
ki = {k: v for k, v in res.items() if k != "balance"} ki = {k: v for k, v in res.items() if k != "balance"}
out = {"kfo_balance": env("kfo_balance", kb), "kfo_income": env("kfo_income", ki)} out = {"kfo_balance": env("kfo_balance", kb), "kfo_income": env("kfo_income", ki)}
eid = iter(f"aaaaaaaa-0000-4000-8000-{n:012d}" for n in range(1, 1000))
R2 = "66666666-6666-4666-8666-000000000002"
R6 = "66666666-6666-4666-8666-000000000006"
REFU = {"id": USER["user_id"], "name": USER["full_name"]} # updated_by — Ref, как в DTO API
def entry(c, cp, acc, side, amt): def entry(c, cp, acc, side, amt):
return {"entry_ids": [], "legal_entity_id": IDS[c], "counterparty_id": IDS[cp], "account_code": acc, return {"entry_ids": [next(eid)], "legal_entity_id": IDS[c], "counterparty_id": IDS[cp], "account_code": acc,
"side": side, "amount": amt, "decision": "AUTO", "candidate_rule_ids": []} "side": side, "amount": amt, "decision": "AUTO", "candidate_rule_ids": []}
def side(line, accs, amt, entries):
return {"article_line": line, "accounts": accs, "amount": amt, "entries": entries}
def bal(dt, kt, a1, a2):
from decimal import Decimal as Dd
dt, kt, a1, a2 = Dd(dt), Dd(kt), Dd(a1), Dd(a2)
diff = abs(dt - kt)
return {"debit_total": f"{dt:.2f}", "credit_total": f"{kt:.2f}", "difference": f"{diff:.2f}",
"difference_percent": f"{diff / min(dt, kt) * 100:.2f}" if min(dt, kt) > 0 else None,
"remainder_1": f"{a1 - dt:.2f}", "remainder_2": f"{a2 - kt:.2f}"}
corr_ba = {"status": "APPLIED", "version_no": 1, "debit": [{"line_code": "1230", "amount": "10000000.00"}], corr_ba = {"status": "APPLIED", "version_no": 1, "debit": [{"line_code": "1230", "amount": "10000000.00"}],
"credit": [{"line_code": "1520", "amount": "10000000.00"}], "credit": [{"line_code": "1520", "amount": "10000000.00"}],
"comment": "Сверка Бета → Альфа: разница — аванс, исключаем подтверждённое", "reason_code": None, "comment": "Сверка Бета → Альфа: разница — аванс, исключаем подтверждённое", "reason_code": None,
"updated_by": USER, "updated_at": "2025-11-12T14:30:00Z"} "balance": bal("10000000", "10000000", "10000000", "50000000"),
"updated_by": REFU, "updated_at": "2025-11-12T14:30:00Z"}
corr_ac = {"status": "APPLIED", "version_no": 2, corr_ac = {"status": "APPLIED", "version_no": 2,
"debit": [{"line_code": "1230", "amount": "20000000.00"}, {"line_code": "1170", "amount": "5000000.00"}], "debit": [{"line_code": "1230", "amount": "20000000.00"}, {"line_code": "1170", "amount": "5000000.00"}],
"credit": [{"line_code": "1520", "amount": "22500000.00"}], "credit": [{"line_code": "1520", "amount": "22500000.00"}],
"comment": "Часть долга Гаммы переведена в займ — разнесено по статьям", "reason_code": None, "comment": "Часть долга Гаммы переведена в займ — разнесено по статьям", "reason_code": None,
"updated_by": USER, "updated_at": "2025-11-13T09:10:00Z"} "balance": bal("25000000", "22500000", "30000000", "29100000"),
"updated_by": REFU, "updated_at": "2025-11-13T09:10:00Z"}
def agg(rule_id, rule_no, c1, c2, s1, s2, dev, pct, exc, status, elim, corr):
return {"rule_id": rule_id, "rule_no": rule_no, "company_1": REF[c1], "company_2": REF[c2], "side_1": s1,
"side_2": s2, "pairs": [], "deviation_amount": dev, "deviation_percent": pct,
"exceeds_threshold": exc, "status": status, "eliminated_amount": elim, "composition_changed": False,
"correction": corr}
ab_1 = side("1230", ["62.01"], "102000000.00", [entry("A", "B", "62.01", "D", "102000000.00")])
ab_2 = side("1520", ["60.01"], "100000400.50", [entry("B", "A", "60.01", "K", "100000400.50")])
a_ab = agg(R6, 6, "A", "B", ab_1, ab_2, "1999599.50", "2.00", False, "AUTO", "100000400.50", None)
a_ab["pairs"] = [{"side_1": ab_1, "side_2": ab_2, "deviation_amount": "1999599.50", "deviation_percent": "2.00"}]
aggs = [ aggs = [
{"rule_id": "66666666-6666-4666-8666-000000000006", "rule_no": 6, "company_1": REF["A"], "company_2": REF["B"], agg(R2, 2, "A", "B", side("1170", ["58.01"], "50000000.00", [entry("A", "B", "58.01", "D", "50000000.00")]),
"side_1": {"article_line": "1230", "accounts": ["62.01"], "amount": "102000000.00", side("1310/1350/1370", ["80"], "40000000.00", [entry("B", "A", "80", "K", "40000000.00")]),
"entries": [entry("A", "B", "62.01", "D", "102000000.00")]}, "10000000.00", "25.00", False, "AUTO", "40000000.00", None),
"side_2": {"article_line": "1520", "accounts": ["60.01"], "amount": "100000400.50", agg(R2, 2, "A", "C", side("1170", ["58.01"], "15000000.00", [entry("A", "C", "58.01", "D", "15000000.00")]),
"entries": [entry("B", "A", "60.01", "K", "100000400.50")]}, side("1310/1350/1370", [], "0.00", []), "15000000.00", None, False, "ONE_SIDED", "15000000.00", None),
"deviation_amount": "1999599.50", "deviation_percent": "2.00", "exceeds_threshold": False, "status": "AUTO", a_ab,
"eliminated_amount": "100000400.50", "composition_changed": False, "correction": None}, agg(R6, 6, "A", "C", side("1230", ["62.01"], "30000000.00", [entry("A", "C", "62.01", "D", "30000000.00")]),
{"rule_id": "66666666-6666-4666-8666-000000000006", "rule_no": 6, "company_1": REF["B"], "company_2": REF["A"], side("1520", ["60.01"], "29100000.00", [entry("C", "A", "60.01", "K", "29100000.00")]),
"side_1": {"article_line": "1230", "accounts": ["62.01"], "amount": "10000000.00", "900000.00", "3.09", False, "AUTO", "29100000.00", corr_ac),
"entries": [entry("B", "A", "62.01", "D", "10000000.00")]}, agg(R6, 6, "B", "A", side("1230", ["62.01"], "10000000.00", [entry("B", "A", "62.01", "D", "10000000.00")]),
"side_2": {"article_line": "1520", "accounts": ["60.01", "76.05"], "amount": "50000000.00", side("1520", ["60.01", "76.05"], "50000000.00",
"entries": [entry("A", "B", "60.01", "K", "12000000.00"), entry("A", "B", "76.05", "K", "38000000.00")]}, [entry("A", "B", "60.01", "K", "12000000.00"), entry("A", "B", "76.05", "K", "38000000.00")]),
"deviation_amount": "40000000.00", "deviation_percent": "400.00", "exceeds_threshold": True, "40000000.00", "400.00", True, "DISCREPANCY", "0.00", corr_ba),
"status": "DISCREPANCY", "eliminated_amount": "0.00", "composition_changed": False, "correction": corr_ba},
] ]
vgo = {"balance": {"version_id": kfo.VERSION, "statement_type": "balance", "rules_version_no": 1, "rules": [], rule2 = {"id": R2, "rule_no": 2, "article_1_line": "1170", "article_2_line": "1310/1350/1370", "side_1": "D",
"aggregates": aggs, "measure": "closing", "company_1_accounts": ["58.01"], "company_2_accounts": ["80", "83"],
"unallocated": [{"entry_ids": [], "owner": REF["C"], "counterparty": REF["A"], "company_1_excluded": [], "company_2_excluded": []}
rule6 = {"id": R6, "rule_no": 6, "article_1_line": "1230", "article_2_line": "1520", "side_1": "D",
"measure": "closing",
"company_1_accounts": ["60.02", "60.22", "60.32", "62.01", "62.03", "62.21", "62.31", "76"],
"company_2_accounts": ["60.01", "60.03", "60.21", "60.31", "62.02", "62.22", "62.32", "76"],
"company_1_excluded": ["76.7.5", "76.7.9"], "company_2_excluded": ["76.7.1"]}
vgo = {"balance": {"version_id": kfo.VERSION, "statement_type": "balance", "rules_version_no": 1,
"rules": [rule2, rule6], "aggregates": aggs,
"unallocated": [{"entry_ids": [next(eid)], "owner": REF["C"], "counterparty": REF["A"],
"account_code": "76.09", "line_code": None, "side": "D", "amount": "350000.00", "account_code": "76.09", "line_code": None, "side": "D", "amount": "350000.00",
"candidate_rule_ids": [], "reason": "MULTIPLE_RULES", "excluded": True}], "candidate_rule_ids": [R2, R6], "reason": "MULTIPLE_RULES", "excluded": True}],
"totals": {"amount_1": "112000000.00", "amount_2": "150000400.50", "totals": {"amount_1": "207000000.00", "amount_2": "219100400.50",
"deviation_amount": "41999599.50", "correction_debit": "10000000.00", "deviation_amount": "67899599.50", "correction_debit": "35000000.00",
"correction_credit": "10000000.00"}}, "correction_credit": "32500000.00"}},
"income": None} "income": None}
out["vgo_pairs"] = env("vgo_pairs", vgo) out["vgo_pairs"] = env("vgo_pairs", vgo)
out["corrections"] = env("corrections", {"items": [ out["corrections"] = env("corrections", {"items": [
{"statement_type": "balance", "rule_no": 6, "company_1": REF["B"], "company_2": REF["A"], "correction": corr_ba},
{"statement_type": "balance", "rule_no": 6, "company_1": REF["A"], "company_2": REF["C"], "correction": corr_ac}, {"statement_type": "balance", "rule_no": 6, "company_1": REF["A"], "company_2": REF["C"], "correction": corr_ac},
{"statement_type": "balance", "rule_no": 6, "company_1": REF["B"], "company_2": REF["A"], "correction": corr_ba},
]}) ]})
def row(c, acc, cp, ctype, cd=None, cc=None): def row(c, acc, cp, ctype, cd=None, cc=None):
return {"entry_ids": [], "legal_entity_id": IDS[c], "legal_entity_name": kfo.ex.NAMES[c], return {"entry_ids": [next(eid)], "legal_entity_id": IDS[c], "legal_entity_name": kfo.ex.NAMES[c],
"legal_entity_inn": kfo.ex.INN[c], "account_code": acc, "account_root": acc.split(".")[0], "legal_entity_inn": kfo.ex.INN[c], "account_code": acc, "account_root": acc.split(".")[0],
"period": "2025 Q3", "is_cumulative": False, "row_number": None, "period": "2025 Q3", "is_cumulative": False, "row_number": None,
"counterparty_name": kfo.ex.NAMES.get(cp, cp), "counterparty_inn": kfo.ex.INN.get(cp), "counterparty_name": kfo.ex.NAMES.get(cp, cp), "counterparty_inn": kfo.ex.INN.get(cp),
@ -285,16 +344,22 @@ def examples():
"rows": [row("A", "62.01", "B", "GSK", cd="102000000.00"), row("B", "60.01", "A", "GSK", cc="100000400.50"), ext], "rows": [row("A", "62.01", "B", "GSK", cd="102000000.00"), row("B", "60.01", "A", "GSK", cc="100000400.50"), ext],
"summary": {"rows_total": 3, "unmapped_total": 0, "auto_matched_total": 0, "documents_total": 9, "summary": {"rows_total": 3, "unmapped_total": 0, "auto_matched_total": 0, "documents_total": 9,
"gaps": [{"legal_entity_id": IDS["C"], "legal_entity_name": kfo.ex.NAMES["C"], "gaps": [{"legal_entity_id": IDS["C"], "legal_entity_name": kfo.ex.NAMES["C"],
"account_code": "76", "missing_quarters": [1]}], "counter_pairs": []}}) "account_code": "76", "missing_quarters": ["Q1"]}], "counter_pairs": []}})
cell = {"company_a_id": IDS["A"], "company_b_id": IDS["B"], "amount_a": "102000000.00", cell = {"company_a_id": IDS["A"], "company_b_id": IDS["B"], "amount_a": "102000000.00",
"amount_b": "100000400.50", "variance_amount": "1999599.50", "variance_percent": "2.00", "amount_b": "100000400.50", "variance_amount": "1999599.50", "variance_percent": "2.00",
"exceeds_threshold": False, "one_sided": False, "skipped_osv_entry_count": 0} "exceeds_threshold": False, "one_sided": False, "skipped_osv_entry_count": 0}
matrix = {"companies": [REF[c] for c in kfo.ex.COMPANIES], "cells": [cell]} tot_d = {IDS["A"]: "102000000.00", IDS["B"]: "0.00", IDS["C"]: "0.00"}
out["chess"] = env("chess", {"matrix_all": matrix, "presets": [{"rule_no": 6, "matrix": matrix}], tot_k = {IDS["A"]: "0.00", IDS["B"]: "100000400.50", IDS["C"]: "0.00"}
"result_table": {"companies": [REF[c] for c in kfo.ex.COMPANIES], "articles": [ matrix = {"companies": [REF[c] for c in kfo.ex.COMPANIES], "cells": [cell], "total_debit": tot_d,
{"code": "1230", "name": "Дебиторская задолженность", "group_total": "112000000.00", "total_credit": tot_k}
"amounts": [{"company_id": IDS["A"], "amount": "102000000.00"}, out["chess"] = env("chess", {
{"company_id": IDS["B"], "amount": "10000000.00"}]}]}}) "matrix_all": matrix,
"presets": [{"rule_no": 6, "statement_type": "balance", "rules_version_no": 1, "rule": rule6, "matrix": matrix}],
"result_table": {"companies": [REF[c] for c in kfo.ex.COMPANIES], "articles": [
{"code": "1230", "name": "Дебиторская задолженность", "group_total": "142000000.00",
"amounts": [{"company_id": IDS["A"], "amount": "132000000.00"},
{"company_id": IDS["B"], "amount": "10000000.00"},
{"company_id": IDS["C"], "amount": "0.00"}]}]}})
gw_tot = {"financial_investment_amount": "50000000.00", "charter_capital_amount": "40000000.00", gw_tot = {"financial_investment_amount": "50000000.00", "charter_capital_amount": "40000000.00",
"participation_amount": "32000000.00", "goodwill_amount": "18000000.00", "participation_amount": "32000000.00", "goodwill_amount": "18000000.00",
"goodwill_in_kfo_amount": "18000000.00"} "goodwill_in_kfo_amount": "18000000.00"}
@ -305,12 +370,12 @@ def examples():
"additional_capital_amount": "0.00", "participation_amount": "32000000.00", "additional_capital_amount": "0.00", "participation_amount": "32000000.00",
"goodwill_amount": "18000000.00", "include_in_kfo": True, "goodwill_amount": "18000000.00", "include_in_kfo": True,
"comment": "Доля 80 % по выписке ЕГРЮЛ на 01.10.2025", "has_investments": True, "warnings": [], "comment": "Доля 80 % по выписке ЕГРЮЛ на 01.10.2025", "has_investments": True, "warnings": [],
"updated_by": USER, "updated_at": "2025-11-12T11:00:00Z"}], "updated_by": REFU, "updated_at": "2025-11-12T11:00:00Z"}],
"groups": [{"head_legal_entity": REF["A"], "totals": gw_tot}], "totals": gw_tot}) "groups": [{"head_legal_entity": REF["A"], "totals": gw_tot}], "totals": gw_tot})
out["version_card"] = env("version_card", { out["version_card"] = env("version_card", {
"company_group": {"id": "77777777-7777-4777-8777-777777777777", "name": "ГК «Альфа»"}, "company_group": {"id": "77777777-7777-4777-8777-777777777777", "name": "ГК «Альфа»"},
"related_group": {"id": "88888888-8888-4888-8888-888888888888", "name": "ГСК «Альфа»"}, "related_group": {"id": "88888888-8888-4888-8888-888888888888", "name": "ГСК «Альфа»"},
"reporting_date": "2025-10-01", "year": 2025, "quarter": 3, "version_no": 1, "scenario": "CREATE", "reporting_date": "2025-10-01", "year": 2025, "quarter": "Q3", "version_no": 1, "scenario": "CREATE",
"approach": "BASIC", "goodwill_enabled": True, "initiator": USER, "approach": "BASIC", "goodwill_enabled": True, "initiator": USER,
"initiator_office": {"id": "99999999-0000-4000-8000-000000000001", "name": "Ростовский РФ"}, "initiator_office": {"id": "99999999-0000-4000-8000-000000000001", "name": "Ростовский РФ"},
"members": [{"legal_entity_id": IDS[c], "name": kfo.ex.NAMES[c], "inn": kfo.ex.INN[c], "members": [{"legal_entity_id": IDS[c], "name": kfo.ex.NAMES[c], "inn": kfo.ex.INN[c],

View File

@ -10,6 +10,8 @@ from pathlib import Path
from jsonschema import Draft202012Validator from jsonschema import Draft202012Validator
ROOT = Path(__file__).resolve().parents[2] ROOT = Path(__file__).resolve().parents[2]
sys.path.insert(0, str(ROOT / "scripts"))
from validate_contracts import make_format_checker # noqa: E402 — та же проверка форматов, что в make check
SCHEMA = ROOT / "contracts" / "ex-payload-v1.schema.json" SCHEMA = ROOT / "contracts" / "ex-payload-v1.schema.json"
EXAMPLES = sorted((ROOT / "contracts" / "examples").glob("ex-payload-*.json")) EXAMPLES = sorted((ROOT / "contracts" / "examples").glob("ex-payload-*.json"))
REQUIRED_TYPES = {"summary_osv", "vgo_pairs", "chess", "kfo_balance", "kfo_income", "goodwill", "corrections", REQUIRED_TYPES = {"summary_osv", "vgo_pairs", "chess", "kfo_balance", "kfo_income", "goodwill", "corrections",
@ -19,7 +21,7 @@ REQUIRED_TYPES = {"summary_osv", "vgo_pairs", "chess", "kfo_balance", "kfo_incom
def main(): def main():
schema = json.loads(SCHEMA.read_text(encoding="utf-8")) schema = json.loads(SCHEMA.read_text(encoding="utf-8"))
Draft202012Validator.check_schema(schema) Draft202012Validator.check_schema(schema)
v = Draft202012Validator(schema) v = Draft202012Validator(schema, format_checker=make_format_checker())
by_type = {} by_type = {}
for p in EXAMPLES: for p in EXAMPLES:
doc = json.loads(p.read_text(encoding="utf-8")) doc = json.loads(p.read_text(encoding="utf-8"))
@ -55,7 +57,50 @@ def main():
bad = copy.deepcopy(by_type["summary_osv"]) bad = copy.deepcopy(by_type["summary_osv"])
bad["units"] = "thousand_rub" bad["units"] = "thousand_rub"
rejected(bad, "summary_osv в тысячах") rejected(bad, "summary_osv в тысячах")
print(f"OK: примеров {len(EXAMPLES)}, отрицательных случаев 6") # ревью #208: легитимные ответы API проходят
ok = copy.deepcopy(by_type["summary_osv"])
ok["data"]["summary"]["gaps"][0]["missing_quarters"] = ["Q1", "Q2"]
assert not list(v.iter_errors(ok)), "C-1: пробелы свода как в API (Q1…Q4)"
ok = copy.deepcopy(by_type["chess"])
ok["data"]["matrix_all"]["cells"][0]["variance_percent"] = "10199959.95"
assert not list(v.iter_errors(ok)), "C-2: большой процент шахматки"
ok = copy.deepcopy(by_type["vgo_pairs"])
ok["data"]["balance"]["aggregates"][0]["deviation_percent"] = "10199959.95"
assert not list(v.iter_errors(ok)), "C-2: большой процент агрегата"
# ревью #208: то, что нужно выгрузкам, обязательно
for path, why in [(("chess", "matrix_all", "total_debit"), "I-1 итоги шахматки"),
(("vgo_pairs", "balance", "rules"), "I-1 правила таблицы корректировок"),
(("chess", "presets", 0, "rule"), "I-1 правило пресета")]:
bad = copy.deepcopy(by_type[path[0]])
node = bad["data"]
for k in path[1:-1]:
node = node[k]
del node[path[-1]]
rejected(bad, why)
bad = copy.deepcopy(by_type["corrections"])
del bad["data"]["items"][0]["correction"]["balance"]
rejected(bad, "I-1 balance корректировки")
bad = copy.deepcopy(by_type["vgo_pairs"])
bad["data"]["balance"]["aggregates"][0]["side_1"]["entries"][0]["entry_ids"] = []
rejected(bad, "I-1 строка агрегата без entry_ids")
bad = copy.deepcopy(by_type["corrections"])
bad["data"]["items"][0]["correction"]["updated_by"] = {"user_id": "x", "full_name": "y"}
rejected(bad, "I-2 updated_by не Ref")
# ревью #208: пустой и незамороженный payload
bad = copy.deepcopy(by_type["version_card"])
bad["data"]["members"] = []
rejected(bad, "M-1 карточка без состава")
bad = copy.deepcopy(by_type["kfo_balance"])
bad["data"]["is_frozen"] = False
rejected(bad, "M-1 КФО не заморожена")
bad = copy.deepcopy(by_type["version_card"])
bad["data"]["quarter"] = 3
rejected(bad, "M-3 квартал числом")
# форматы проверяются
bad = copy.deepcopy(by_type["version_card"])
bad["data"]["verified_at"] = "вчера"
rejected(bad, "M-6 date-time")
print(f"OK: примеров {len(EXAMPLES)}, отрицательных случаев 17, положительных граничных 3")
return 0 return 0