Подтверждение акта по модели Постоплата по ID
Метод Approve postpaid invoice by ID используется для подтверждения акта по модели Постоплата по указанному ID с помощью счета на оплату, выставленного клиенту реселлера сторонней ERP-системой (см. Управление актами по модели Постоплата сторонней ERP-системой). Этот метод используется, если у клиента есть несколько актов за один финансовый период и нужно указать ID конкретного акта. В результате вызова этого метода:
- Сторонняя ERP-система опционально может прикрепить к платежу, связанному с актом по модели Постоплата, для которого выполняется подтверждение, файл счета на оплату или ссылку на него.
- В платформе для платежа будет установлена дата отсрочки согласно правилу обслуживания клиента.
После получения оплаты по выставленному счету необходимо подтвердить платеж в платформе с помощью метода Завершение акта по модели Постоплата по ID. Опционально также доступно подтверждение платежа вручную в Панели управления Оператора (см. Обработка платежа с выставлением счета сторонней ERP-системой).
Платформа проверяет соответствие счета на оплату и акта по дате начала финансового периода, к которому относится акт (billing_date
).
Для авторизации требуется API-токен сотрудника. API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).
По указанному в запросе API-токену определяются текущий реселлер и его нижестоящие реселлеры, доступные в рамках метода.
POST {base_url}/api/v3/resellers/{reseller_id}/invoices/{invoice_id}/approve
Аргументы
Название | Тип параметра | Тип данных | Обязательный/ | Описание | |
---|---|---|---|---|---|
X-Api-Token | header | string | Обязательный | API-токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике) | |
Content-Type | header | string | Обязательный | Тип данных, передаваемых в запросе. Необходимо указать: application/vnd.api+json | |
Accept | header | string | Обязательный | Поддерживаемые типы данных в ответе. Необходимо указать: application/vnd.api+json | |
base_url | path | string | Обязательный | URL ActivePlatform | |
reseller_id | path | integer | Обязательный | ID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере) | |
invoice_id | path | integer | Обязательный | ID акта, который необходимо подтвердить | |
document_id | form | string | Обязательный | Номер счета на оплату, для которого требуется подтвердить акт | |
billing_date | form | string | Обязательный | Дата начала финансового периода, за который выставлен акт, в формате ГГГГ-ММ-ДД | |
file | form | object | Опциональный | Сведения о файле счета на оплату, сформированного в сторонней ERP-системе. Можно указать или сведения о файле, или сведения о ссылке на файл, но не то и другое вместе | |
data | form | string | Опциональный | Счет на оплату в кодировке base64. Обязательный, если указываются сведения о файле Максимальный размер прикрепляемого файла зависит от настроек конкретной инсталляции и может быть изменен по обращению в службу технической поддержки. | |
name | form | string | Опциональный | Имя файла счета на оплату. Обязательный, если указываются сведения о файле | |
link | form | object | Опциональный | Сведения о ссылке на файл счета на оплату, сформированного в сторонней ERP-системе. Можно указать или сведения о файле, или сведения о ссылке на файл, но не то и другое вместе | |
data | form | string | Опциональный | Ссылка на файл счета на оплату. Обязательный, если указываются сведения о ссылке на файл | |
name | form | string | Опциональный | Имя файла счета на оплату по ссылке. Обязательный, если указываются сведения о ссылке на файл |
Модель ответа
Название | Тип данных | Описание | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
data | object | Данные ответа | |||||||||||||
id | string | ID акта в платформе | |||||||||||||
type | string | Тип данных | |||||||||||||
attributes | object | Информация об акте | |||||||||||||
created_at | string | Дата и время создания акта | |||||||||||||
updated_at | string | Дата и время последнего обновления акта | |||||||||||||
document_id | string | Номер акта | |||||||||||||
status | string | Статус акта | |||||||||||||
total | string | Общая сумма акта | |||||||||||||
account_id | integer | ID клиента, которому выставлен акт | |||||||||||||
from_date | string | Дата начала периода, за который выставлен акт, в формате ГГГГ-ММ-ДД | |||||||||||||
to_date | string | Дата окончания периода, за который выставлен акт, в формате ГГГГ-ММ-ДД | |||||||||||||
payment_model | string | Модель оплаты акта:
| |||||||||||||
relationships | object | Перечень объектов, связанных с актом | |||||||||||||
subscriptions | object | Информация о подписках | |||||||||||||
data | array of objects | Информация о связанном объекте:
| |||||||||||||
payments | object | Информация о платеже | |||||||||||||
data | array of objects | Информация о связанном объекте:
| |||||||||||||
charges | object | Информация о списаниях | |||||||||||||
data | array of objects | Информация о связанном объекте:
| |||||||||||||
corrections | object | Информация о корректировках | |||||||||||||
data | array of objects | Информация о связанном объекте:
|
Ошибки
Статус | Код ошибки | Текст ошибки | Комментарий |
---|---|---|---|
400 | INVOICE-0001 | Required parameters are not provided | Необходимо указать в запросе все обязательные параметры |
INVOICE-0005 | Неверно указан финансовый день для счета | Указанная дата начала финансового периода billing_date не соответствует указанному акту | |
INVOICE-0007 | Только счет с моделью оплаты Постоплата может быть подтвержден | Указанный акт не относится к модели Постоплата и поэтому не может быть подтвержден (см. Получение информации об акте) | |
INVOICE-0008 | Только счет в статусе Закрыт может быть подтвержден | Статус указанного акта отличается от Закрыт, и поэтому он не может быть подтвержден (см. Получение информации об акте) | |
INVOICE-0009 | Только ненулевой счет может быть подтвержден | Сумма указанного акта равна нулю, и поэтому он не может быть подтвержден (см. Получение информации об акте) | |
422 | INVOICE-0003 | Unable to approve Invoice one more time | Акт уже подвержен |
Only one attribute can be present: file or link | Можно указать или сведения о файле счета на оплату (параметр file ), или сведения о ссылке на файл (параметр link ), но не то и другое вместе |
Пример запроса
POST /api/v3/resellers/1/invoices/2046/approve
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
{
"document_id": "NS2000015",
"billing_date": "2020-04-01",
"file": {
"data": "data:application/pdf;base64,'SSBob2xkIHRoZSBwb3NpdGlvbiBvZiBhIHFhIGVuZ2luZWVyLiBRQSBlbmdpbmVlciByZXNwb25zaWJpbGl0aWVzIGluY2x1ZGUgZGVzaWduaW5nIGFuZCBpbXBsZW1lbnRpbmcgdGVzdHMsIGRlYnVnZ2luZyBhbmQgZGVmaW5pbmcgY29ycmVjdGl2ZSBhY3Rpb25zLiBJIGFsc28gcmV2aWV3IHN5c3RlbSByZXF1aXJlbWVudHMgYW5kIHRyYWNrIHF1YWxpdHkgYXNzdXJhbmNlIG1ldHJpY3MgKGUuZy4gZGVmZWN0IGRlbnNpdGllcyBhbmQgb3BlbiBkZWZlY3QgY291bnRzLikgVGhlIFFBIHRlY2huaWNpYW4gcm9sZSBwbGF5cyBhbiBpbXBvcnRhbnQgcGFydCBpbiBvdXIgY29tcGFueeKAmXMgcHJvZHVjdCBkZXZlbG9wbWVudCBwcm9jZXNzLg=='",
"name": "Invoice NS2000015"
}
}
Пример ответа
{
"data": {
"id": "2046",
"type": "invoices",
"attributes": {
"created_at": "2019-04-18T09:02:01.257560+0300",
"updated_at": "2019-05-02T06:12:41.990713+0300",
"document_id": "NS2000015",
"status": "closed",
"total": "0.32",
"account_id": 505,
"from_date": "2019-04-17",
"to_date": "2019-05-01",
"payment_model": "postpay"
},
"relationships": {
"subscriptions": {
"data": [
{
"id": "3009839",
"type": "subscriptions"
}
]
},
"payments": {
"data": [
{
"id": "12201",
"type": "payments"
}
]
},
"charges": {
"data": [
{
"id": "323740",
"type": "charges"
}
]
},
"corrections": {
"data": []
}
}
}
}