Выставление счетов и создание закрывающих документов
Для выставления счетов и создания закрывающих документов нужно разрешение ManageInvoiceData
и ReadCustomerData
.
Выставление счетов
Создать счёт на оплату можно с помощью метода Create Invoice.
- В параметре SecondSide укажите данные контрагента, которому вы выставляете счёт.
- В параметре Content укажите содержимое счёта на оплату.
- В ответе мы передадим documentId, который может понадобиться для получения информации о выставленном счёте, связывания счёта с закрывающим документом, удаления счёта или отправки его на электронную почту.
Для вызова метода нужен
customerCode
. Чтобы узнать customerCode, нужно вызвать метод Get Customers List.
Параметр customerCode необходимо брать из поля customerType: "Business".
Получить выставленный счёт в PDF можно с помощью метода Get Invoice.
Узнать, оплачен ли выставленный счёт, можно с помощью метода Get Invoice Payment Status. Нужная информация будет в полученном в ответ параметре paymentStatus.
payment_waiting
— оплаты счёта ещё не было;payment_expired
— оплата счёта просрочена. Статус может появиться только если при выставлении счёта с помощью метода Create Invoice вы передавали параметрpaymentExpiryDate
;payment_paid
— оплата по счёту прошла.
Обратите внимание: для смены статуса мы сличаем входящие платежи со счетами по ИНН контрагента, сумме и наличию номера счёта в назначении.
Если от контрагента придёт платёж на нужную сумму, то меняем статус оплаты счёта. Если сумма будет отличаться — например, при частичной оплате или переплате — меняться автоматически статус не будет.
Статус можно изменить вручную прямо в интернет-банке, раздел «Счета, акты, накладные».
После создания счёт можно отправить на электронную почту контрагента через метод Send Invoice To Email.
Если вам больше не нужен счёт или вы передумали отправлять его контрагенту, то его можно удалить с помощью метода Delete Invoice.
Выставление закрывающих документов
Сформировать акт, счёт-фактуру или накладную можно с помощью метода Create Closing Document.
- В параметре SecondSide укажите данные контрагента, которому предназначен документ.
- В параметре Content укажите указать содержимое акта, счёт-фактуры или накладной.
- В ответе мы передадим documentId, который может понадобиться для получения PDF закрывающего документа, удаления или отправки документа на электронную почту.
При необходимости можно связать выставленный счёт с закрывающим документом. Для этого заполните параметр documentId
, указав в нём documentId из ответа метода Create Invoice.
Для получения PDF с закрывающим документом испоьзуйте метод Get Closing Document.
После создания закрывающий документ можно отправить на электронную почту контрагента через метод Send Closing Documents To Email.
Если вам больше не нужен закрывающий документ или вы передумали отправлять его контрагенту, документ можно удалить с помощью метода Delete Closing Documents.