Выставление счетов и создание закрывающих документов
Для выставления счетов и создания закрывающих документов нужны разрешения ManageInvoiceData и ReadCustomerData.
Выставление счетов
Создать счёт на оплату можно с помощью метода Create Invoice:
- В параметре
SecondSideукажите данные контрагента, которому вы выставляете счёт - В параметре
Contentукажите содержимое счёта на оплату - В ответе мы передадим
documentId— он может понадобиться для получения информации о выставленном счёте, связывания счёта с закрывающим документом, удаления счёта или отправки его на электронную почту
Для создания счёта на оплату нужен 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.