Перейти к основному содержимому

Счёт на оплату

Счёт на оплату — это документ, который продавец отправляет покупателю для оплаты. В нём указаны список товаров или услуг, сумма к оплате, реквизиты покупателя и другие данные сделки.

Как создать счёт

Счёт создаётся методом 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
Получить счёт в формате PDFGet 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

В этих случаях статус можно изменить вручную в интернет-банке, в разделе «Документооборот».