Разнести переданную задолженность клиента по срокам

Робот «Разнести переданную задолженность клиента по срокам» показывает просроченные остатки по явному реестру счетов одного клиента.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Финансовому менеджеру и администратору процесса контроля дебиторской задолженности одного клиента по подготовленному реестру счетов.

Общая сумма долга скрывает, какие счета просрочены недавно, а какие требуют отдельного внимания. Робот распределяет непогашенные суммы по срокам и не выдаёт неизвестные оплаты за ноль. Источник реестра и подтверждение его полноты нужно подготовить до расчёта.

Параметры и подготовка

Поле	Как заполнить
Единая валюта, код из трех латинских букв (CURRENCY)	Обязательное поле
Число дробных знаков: 0–6 (SCALE)	Обязательное поле
Идентификатор клиента (CLIENT_ID)	Обязательное поле
Дата расчёта YYYY-MM-DD (AS_OF)	Обязательное поле
Счета клиента (JSON) (INVOICES)	Обязательное поле

Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.

Как использовать

1. Укажите идентификатор клиента, дату расчёта YYYY-MM-DD, валюту и число дробных знаков от 0 до 6.
2. Передайте INVOICES: для каждого счёта нужны id, clientId, currency, dueDate, amount, paidAmount и paymentDataComplete. Последний признак задаётся JSON true/false, а не строкой Y/N.
3. Проверьте, что все счета относятся к выбранному клиенту и валюте, имеют уникальные ID и согласованные суммы.
4. После статуса проверьте complete. При неполных оплатах используйте knownOverdue как известную часть, а unknownIds направьте на уточнение. Полный итог не подменяйте известной частью.

Как заполнить JSON-поля

Счета клиента (JSON) (INVOICES)

[
  {
    "id": "I1",
    "clientId": "C-DEMO",
    "currency": "RUB",
    "dueDate": "2026-10-01",
    "amount": "100.00",
    "paidAmount": "20.00",
    "paymentDataComplete": true
  }
]

До 1000 счетов. id уникален; clientId совпадает с CLIENT_ID; currency с CURRENCY; dueDate дата YYYY-MM-DD; суммы точные строки; paymentDataComplete логический true/false. Реестр готовит предыдущий источник, робот его не загружает. [] даёт ноль.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Учебный пример и ожидаемый результат

CLIENT_ID=C-DEMO, AS_OF=2026-10-15, CURRENCY=RUB, SCALE=2. INVOICES=[{"id":"I1","clientId":"C-DEMO","currency":"RUB","dueDate":"2026-10-01","amount":"100.00","paidAmount":"20.00","paymentDataComplete":true}]. Ожидается просроченный остаток 80.00 за 14 дней в группе 1–30. При paymentDataComplete=false счёт попадёт в unknownIds, а полный итог будет пустым.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Известная просроченная сумма» (knownOverdue).
• «Полная сумма при известных оплатах» (totalOverdue).
• «Оплаты всех переданных счетов известны» (complete).
• «Группы просрочки (JSON)» (buckets).
• «Просроченные счета (JSON)» (overdueInvoices).
• «Счета с неполными оплатами» (unknownIds), список значений.

Просрочка начинается на следующий день после срока. Группы buckets показывают известные остатки за 1–30, 31–60, 61–90 и более 90 дней. complete подтверждает известность оплат переданных счетов, но не доказывает, что в реестр включены все счета клиента.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Принимает идентификатор клиента, дату расчёта YYYY-MM-DD, валюту, точность и до 1000 счетов: id/clientId/currency/dueDate/amount/paidAmount/paymentDataComplete. Просрочка начинается на следующий день после срока; группы 1–30, 31–60, 61–90 и более 90 дней. paymentDataComplete: логический JSON true/false. Неизвестная полнота оплат исключает счёт из известной суммы, общий итог остаётся пустым. Пустой реестр даёт корректный ноль. Возвращает известную просрочку, полный итог при достаточных данных, группы и неизвестные счета. Не запрашивает CRM и не гарантирует полноту реестра клиента; данные и их подтверждение задаёт вызывающий процесс. Суммы точные строковые, неотрицательные, меньше 10^24.

Робот не читает CRM и банк самостоятельно. В день срока счёт ещё не считается просроченным. Переплата не образует отрицательную задолженность: непогашенный остаток ограничен нулём. Пустой реестр даёт корректный ноль в рамках переданных данных.