Счёт на оплату
billing.get_invoice
Возвращает полную карточку счёта на оплату по идентификатору или номеру: реквизиты, суммы, статус, срок и условия оплаты, контрагент, документ-источник и все позиции счёта. Нужно указать хотя бы один параметр — идентификатор или номер счёта. Только чтение.
Входы
| Ключ | Тип | Описание |
|---|---|---|
| invoiceId | string | Идентификатор счёта |
| number | string | Номер счёта |
Выходы
| Ключ | Тип | Описание |
|---|---|---|
| invoice | object | Счёт |
| items | array | Позиции |
| itemsCount | integer | Число позиций |
Что делает
Нода находит один конкретный счёт на оплату и возвращает его целиком — вместе со всеми позициями. Счёт можно указать двумя способами: по идентификатору в системе (если он уже известен из предыдущего шага) или по номеру счёта, который видит пользователь. Достаточно любого одного из этих параметров. Если задан идентификатор, поиск идёт по нему; иначе — по точному номеру.
Когда применять
Основной сценарий — посмотреть детали счёта. Например, пользователь спрашивает ассистента: «Покажи счёт №125 — на какую сумму, оплачен ли и до какого числа». Ассистент по номеру находит счёт и отвечает по его карточке: сумма, статус, срок оплаты, контрагент. Также ноду удобно использовать в автоматизации как шаг «получить данные счёта» перед тем, как принять решение — например, отправить напоминание об оплате или сверить сумму. Нода только читает данные и ничего в счёте не меняет.
Что на входе
Идентификатор счёта или его номер — нужен хотя бы один. Если переданы оба, приоритет у идентификатора. Если ни один не задан, нода вернёт ошибку: понять, какой счёт нужен, будет невозможно.
Что приходит в ответе
В ответе — полная карточка счёта: реквизиты и номер, суммы, статус, срок и условия оплаты, контрагент и документ-источник, из которого счёт был создан. Отдельно приходит список всех позиций счёта в том порядке, в котором они идут в документе, и их общее число. Этих данных достаточно, чтобы показать счёт пользователю или передать его дальше — в другую ноду автоматизации.