Счёт на оплату
Счёт на оплату — это документ, который продавец отправляет покупателю для оплаты. В нём указаны список товаров или услуг, сумма к оплате, реквизиты покупателя и другие данные сделки.
Как создать счёт
Счёт создаётся методом Create Invoice. В запросе передаются:
accountId— идентификатор вашего расчётного счёта в Точке, на который придёт оплатаcustomerCode— ваш код клиента. Узнать его можно методом Get Customers List из объекта с"customerType": "Business"SecondSide— данные покупателя, которому выставляете счёт. Их состав описан на обзорной странице разделаContent— состав счёта
Что передать в Content
Объект Content описывает, за что вы выставляете счёт. Внутри него список позиций Positions — по одной на каждый товар или услугу. В каждой позиции указываются наименование, единица измерения, количество, цена и ставка НДС. Рядом с позициями передаются итоговые суммы по всему счёту — общая сумма с НДС и сумма НДС.
Все суммы в счёте указываются в рублях, копейки отделяются точкой. Например, значение 1234.56 означает 1234 рубля 56 копеек.
При создании счёта можно задать срок оплаты в поле paymentExpiryDate. Если покупатель не оплатит счёт до этой даты, статус счёта автоматически станет payment_expired. Если срок не задавать, счёт будет ждать оплаты без ограничения по времени.
Точный состав полей Content и Positions, их типы и примеры заполнения смотрите на странице метода Create Invoice.
Созданный счёт можно подписать и поставить печать. Это делается в интернет-банке, в разделе «Документооборот».
Что можно сделать со счётом
В ответе метода приходит идентификатор счёта — поле documentId. По нему доступны другие действия:
| Действие | Метод |
|---|---|
| Отправить счёт на почту контрагента | Send Invoice To Email |
| Получить счёт в формате PDF | Get Invoice |
| Узнать статус оплаты | Get Invoice Payment Status |
| Удалить счёт | Delete Invoice |
Отредактировать уже созданный счёт через API нельзя. Если в счёте ошибка, удалите его методом Delete Invoice и создайте заново.
Статусы оплаты
Метод Get Invoice Payment Status возвращает один из статусов:
| Статус | Что означает |
|---|---|
payment_waiting | Счёт выставлен, но ещё не оплачен |
payment_paid | Счёт оплачен |
payment_expired | Истёк срок оплаты. Статус возможен, только если при создании счёта вы задали срок в поле paymentExpiryDate |
Как статус меняется автоматически?
Статус — визуальная подсказка для вашего удобства, на сам документ он не влияет.
Чтобы вам не приходилось отмечать оплату вручную, мы сопоставляем входящие платежи со счётом по трём признакам:
- ИНН контрагента
- сумма платежа
- номер счёта в назначении платежа
Если все три признака совпадают с данными счёта, статус автоматически меняется с payment_waiting на payment_paid. А если вы задали срок оплаты в paymentExpiryDate и деньги в срок не пришли, статус меняется на payment_expired.
Статус не меняется автоматически в таких случаях:
- оплата пришла с расчётного счёта, отличного от указанного в счёте
- контрагент оплатил не ту сумму, то есть переплатил или недоплатил
- оплата пришла уже после того, как счёт получил статус
payment_expired
В этих случаях статус можно изменить вручную в интернет-банке, в разделе «Документооборот».