IDE + MCPДооформление документов
Дооформление 21 недостающего акта реализации под ранее полученные оплаты: поступления на 657 тыс ₽ полностью закрыты документами
Коротко
По одному покупателю деньги поступали регулярно почти каждый месяц, а закрывающие акты «Реализация услуг» оформлялись только в начале сотрудничества. Из-за этого полученные авансы накапливались на счёте 62.02, а выручка документально не отражалась, и передать клиенту закрывающие документы было нельзя. Агент сверил оплаты с актами помесячно, согласовал недостающие документы с сотрудником и дооформил 21 акт реализации. В итоге сумма реализаций сошлась с поступлениями ровно: 657 034,48 ₽.
Что требовалось
Клиент на бухгалтерском обслуживании заметил, что по одному покупателю (ИП Тихонова Ирина Романовна) поступлений денег больше, чем оформленных актов «Реализация услуг», и попросил дооформить недостающие документы с датой по поступлению денег.
Картина была такой: 36 поступлений на 657 034,48 ₽ против всего 5 актов реализации на 104 034,48 ₽, причём все акты — только за 2024 год. С середины 2024 года деньги от покупателя продолжали приходить, но закрывающие акты больше не оформлялись. Налог по УСН «доходы» считался верно (он зависит от поступления денег), но в учёте оставались две проблемы: авансы на счёте 62.02 не закрывались, и выручка не отражалась в бухгалтерском учёте (счета 62.01 и 90.01).
Как помог агент
Агент сверил все банковские поступления с оформленными актами и нашёл причину расхождения: первые 5 платежей были закрыты актами один в один, а начиная с июля 2024 года 31 платёж прошёл вообще без закрывающих документов. Все поступления — оплата от одного покупателя по одному основному договору.
Поскольку формулировка задачи расходилась с фактическими данными, агент уточнил правило у заказчика. Решили: оформлять именно реализации (которых не хватает), по одному акту на каждый календарный месяц, а если в месяце было два платежа — отражать их общей суммой; дату акта ставить по дате поступления денег.
Затем агент изучил структуру одного из уже оформленных актов (вид операции, договор, номенклатура услуги, счёт доходов 90.01.1, ставка «Без НДС») и взял его за образец. Все недостающие платежи он сгруппировал по месяцам и составил наглядную таблицу «месяц — сумма» — 21 акт на 553 000 ₽, что в точности равно разнице между поступлениями и уже оформленными актами. Эту таблицу согласовали с сотрудником до внесения в базу.
Сначала агент создал и провёл один пробный акт и проверил, что проводки сформировались правильно — отразилась выручка и автоматически зачёлся аванс. Убедившись, что всё работает корректно, он дооформил остальные акты, скопировав реквизиты с образца, чтобы не пропустить ни одного поля. После записи агент повторно сверил итоги.
Результат
Все недостающие документы дооформлены: создан и проведён 21 акт реализации на 553 000 ₽, по одному на каждый месяц. Общее число актов по покупателю выросло с 5 до 26.
Итоговая сверка сошлась полностью: 26 реализаций = 36 поступлений = 657 034,48 ₽. Полученные авансы закрылись, выручка отразилась в учёте, и клиенту теперь можно передать закрывающие документы.
Отдельно агент отметил остаток по счёту 62 в размере 11 500 ₽ (на налог по УСН он не влияет, в КУДИР доход учтён по поступлению денег), который устраняется групповым перепроведением документов.
Вся работа выполнена прямо в рабочей базе, без программиста и без установки дополнительных обработок; список документов был согласован с сотрудником до записи.
1. Контекст
ИП Тихонова — клиент агентства на абонентском обслуживании. Оплата производится помесячно (в отдельных месяцах аванс и доплата в одном месяце). Банковские поступления заведены и проведены, а документы «Реализация услуг» (акты оказанных услуг) оформлялись только в начале сотрудничества (5 штук за март-июль 2024), после чего оформление прекратилось.
Для УСН-«доходы» налог рассчитывается от поступления денежных средств, и он рассчитан корректно. Однако без актов:
- авансы на
62.02не закрываются, накапливается незакрытая кредиторская задолженность; - выручка не отражена в бухгалтерском контуре (62.01 → 90.01);
- клиенту не могут быть переданы закрывающие документы.
Это типовая задача по дооформлению: оплаты проведены, акты не оформлены.
2. Обращение заказчика
«Посмотри в базе по Тихоновой: поступление денег больше, чем документов Реализация услуг. Нужно сделать недостающие документы на поступления, с датой поступления денежных средств.»
Формулировка содержит внутреннее противоречие (поступлений, напротив, больше), поэтому детали предстояло уточнить по данным.
3. Исследование
3.1 Идентификация: организация или контрагент?
В базе одна организация — «Лебедева Ольга Викторовна ИП». Следовательно, «Тихонова» — это контрагент (покупатель услуг), а не организация. Найдена карточка: «Тихонова Ирина Романовна ИП», ИНН 481200773366.
3.2 Измерение расхождения — один запрос
ВЫБРАТЬ "Реализация" КАК Вид, КОЛИЧЕСТВО(*) КАК Кол, СУММА(СуммаДокумента) КАК Сумма,
МИНИМУМ(Дата) КАК Перв, МАКСИМУМ(Дата) КАК Посл
ИЗ Документ.РеализацияТоваровУслуг ГДЕ Контрагент = &К И ПометкаУдаления = ЛОЖЬ
ОБЪЕДИНИТЬ ВСЕ
ВЫБРАТЬ "ПоступлениеНаРС", КОЛИЧЕСТВО(*), СУММА(СуммаДокумента), МИНИМУМ(Дата), МАКСИМУМ(Дата)
ИЗ Документ.ПоступлениеНаРасчетныйСчет ГДЕ Контрагент = &К И ПометкаУдаления = ЛОЖЬ
| Документ | Кол-во | Сумма | Период |
|---|---|---|---|
| Поступление на расчётный счёт | 36 | 657 034,48 | 06.03.2024 → 01.06.2026 |
| Реализация услуг | 5 | 104 034,48 | 06.03.2024 → 02.07.2024 |
Детальные списки (даты/суммы/вид операции/договор) показали: первые 5 поступлений закрываются 5 актами 1:1 (те же суммы и даты), а с 17.07.2024 проходит 31 платёж без единого акта. Все поступления — «Оплата от покупателя», один договор «Основной».
3.3 Уточнение правила у заказчика
Поскольку формулировка расходилась с фактическими данными, правило было уточнено у заказчика. Решение заказчика:
- создавать реализации (которых недостаёт), а не поступления;
- одна реализация на календарный месяц (если в месяце было два платежа — отразить общей суммой в одном акте);
- дата акта — по дате поступления денежных средств (последний платёж месяца).
3.4 Эталон для копирования
Прочитаны шапка и табличная часть Услуги существующего акта (query_1c) и метаданные документа (metadata_1c). Эталон 0000-000078:
- вид операции «Услуги», организация «Лебедева Н. В. ИП», договор «Основной»;
- зачёт авансов «Автоматически», валюта руб., «Документ без НДС»;
- строка услуги: номенклатура «Услуги по консультированию», счёт доходов 90.01.1, ставка «Без НДС», счёт НДС 90.03.
4. Решения
4.1 Карта «месяц → сумма»
31 непокрытый платёж сгруппирован по месяцам — получился 21 акт на 553 000 ₽, что равно 657 034,48 − 104 034,48. Карта согласована с заказчиком до записи.
4.2 Создание реализаций через batch_1c + copyFrom
Документы создаются копированием эталона; переопределяются только дата, сумма документа и строка услуги:
{
"action": "CREATE", "post": true,
"type": "Документ.РеализацияТоваровУслуг",
"copyFrom": "<эталон 0000-000078>",
"data": {
"Дата": "2024-11-01T12:00:00",
"СуммаДокумента": 15000,
"Услуги": [{
"Номенклатура": {"metadata_type":"Справочник.Номенклатура","uuid":"<Услуги по консультированию>"},
"Содержание": "Услуги по консультированию, ноябрь 2024",
"Количество": 1, "Цена": 15000, "Сумма": 15000,
"СтавкаНДС": {"metadata_type":"Перечисление.СтавкиНДС","uuid":"ref-no-props:Без НДС"},
"СчетДоходов": {"metadata_type":"ПланСчетов.Хозрасчетный","uuid":"<90.01.1>"},
"СчетУчетаНДСПоРеализации": {"metadata_type":"ПланСчетов.Хозрасчетный","uuid":"<90.03>"},
"СчетРасходов": {"metadata_type":"ПланСчетов.Хозрасчетный","uuid":"<90.02.1>"}
}]
}
}
copyFrom унаследовал все технические реквизиты шапки (счета расчётов 62.01/62.02, банковский счёт, ответственного, договор) — их не потребовалось задавать вручную.
Технический момент — пробное создание перед пакетом. Сначала был создан и проведён один акт (17.07.2024, 15 000), проводки проверены запросом по
РегистрБухгалтерии.Хозрасчетный:Дт 62.01 — Кт 90.01.115 000 (выручка) иДт 62.02 — Кт 62.0115 000 (автозачёт аванса, сформирован из накопленных 11 500 + 3 500). После подтверждения корректной работы механизма остальные 20 актов созданы одним пакетом.
Технический момент — построчные статусы пакета. В одном из актов в UUID счёта был лишний пробел (
...0242 ac120003) — сервер вернулНедопустимое значение параметра (параметр номер 1)и отклонил только эту операцию, остальные в том же пакете прошли (mode: parallel). UUID исправлен, акт доформирован. Некорректная ссылка не приводит к отклонению всего пакета.
4.3 Итоговая сверка
ВЫБРАТЬ "Реализаций всего" КАК П, КОЛИЧЕСТВО(*), СУММА(СуммаДокумента)
ИЗ Документ.РеализацияТоваровУслуг ГДЕ Контрагент = &К И Проведен И ПометкаУдаления = ЛОЖЬ
ОБЪЕДИНИТЬ ВСЕ
ВЫБРАТЬ "Поступлений всего", КОЛИЧЕСТВО(*), СУММА(СуммаДокумента)
ИЗ Документ.ПоступлениеНаРасчетныйСчет ГДЕ Контрагент = &К И Проведен И ПометкаУдаления = ЛОЖЬ
| Показатель | Кол-во | Сумма |
|---|---|---|
| Реализаций | 26 (5 было + 21 новая) | 657 034,48 |
| Поступлений | 36 | 657 034,48 |
Значения совпали полностью.
Технический момент — развёрнутый остаток. На счёте 62 остался развёрнутый остаток 11 500 (часть аванса отражена и как дебиторская, и как кредиторская задолженность) — следствие хронологии автозачёта при датировании актов концом месяца. Нетто-остаток равен 0, на налог УСН не влияет (доход в КУДИР учитывается от поступления), однако в карточке счёта 62 отражается некорректно. Отмечено отдельно: устраняется групповым перепроведением.
5. Инструменты
5.1 Использовали в этом кейсе
| Инструмент | Что делали |
|---|---|
query_1c |
Измерение «реализации vs поступления», детальные списки с датами/суммами/договорами, чтение табличной части эталона, контроль проводок пробного акта, итоговая сверка |
metadata_1c |
Состав Документ.РеализацияТоваровУслуг (табличные части Услуги/Товары, счета, ставки) перед копированием |
batch_1c |
CREATE + POST 21 реализации через copyFrom; построчные статусы операций |
session_info_1c |
Контекст и права сессии (yrtsevanatasha, полные права) перед записью |
5.2 Что осталось за рамками — но есть в арсенале
| Инструмент / компонент | Что даёт | Когда пригодился бы в похожей задаче |
|---|---|---|
run_task / task_status |
Длительные асинхронные задачи с поллингом | Групповое перепроведение всех документов контрагента для устранения развёрнутого остатка — в фоновом режиме, без поштучных вызовов |
get_skill / skill_report |
Поиск/сохранение переиспользуемого скилла | Скилл «помесячное дооформление актов под оплаты» применялся бы шаблонно и накапливался как актив |
invoke_1c |
Вызов экспортного метода конфигурации | При необходимости вызвать типовое «Заполнить по договору» вместо ручного формирования строки услуги |
get_run_history |
История операций агента в базе | Аудит: кто и когда доформировал акты |
ai_ПанельАгента |
Агент внутри 1С | Бухгалтер самостоятельно запускает дооформление актов под оплаты в привычной программе |
| Audit-trail runtime | Журнал вызовов с токеном клиента | На каждый из 21 акта — запись в аудите |
6. Результаты
| Метрика | Значение |
|---|---|
| Поступлений по контрагенту | 36 на 657 034,48 ₽ |
| Реализаций было / стало | 5 → 26 |
| Создано и проведено реализаций | 21 на 553 000 ₽ |
| Свод «реализации = поступления» | 657 034,48 = 657 034,48 |
Пакетов batch_1c |
2 (пробный + основной на 20) |
| EPF в боевую базу / обращений к Конфигуратору | 0 / 0 |
| Развёрнутый остаток 62 к перепроведению | 11 500 (нетто 0) |
7. Что это даёт пользователю MCP ai-agent-1c
Массовое дооформление документов под факт оплаты — типовая задача, под которую обычно разрабатывают разовую обработку и согласуют её установку в боевую базу. Связка query_1c (выявить пробелы) → metadata_1c + copyFrom (взять готовую структуру эталона) → batch_1c (создать и провести пакетом) решает её из чата:
- агент самостоятельно строит карту «месяц → сумма» и представляет её сотруднику до записи;
- пробный акт проверяется по проводкам, и только затем создаётся остальной пакет;
- дата признания, ставка НДС, счета учёта наследуются от эталона — без риска пропустить реквизит;
- итог сверяется тем же
query_1c— подтверждается, что реализации сошлись с поступлениями полностью.
Приложения
A. Файлы кейса
| Объект | Назначение |
|---|---|
| Документ.РеализацияТоваровУслуг (21 шт, 2024-2026) | Созданные акты под поступления, по одному на каждый месяц |
~/.claude/projects/.../memory/ |
Память агента по клиенту/правилам сессии |
B. Карта проблемы
36 поступлений (657 034) — заведены и проведены
│
▼
только 5 актов реализации (104 034), все за 2024
│
с 17.07.2024: деньги идут, актов нет
│
▼
авансы на 62.02 висят, выручка не отражена
│
▼
query_1c: карта «месяц → сумма» (21 акт = 553 000) ── подтверждение человеком
│
▼
batch_1c copyFrom эталона → CREATE+POST 21 акт
│
▼
свод: 26 реализаций = 36 поступлений = 657 034,48 ✅
(остаётся развёрнутый хвост 11 500 → перепроведение)