Подтверждение акта по модели Постоплата по ID

Метод Approve postpaid invoice by ID используется для подтверждения акта по модели Постоплата по указанному ID с помощью счета на оплату, выставленного клиенту реселлера сторонней ERP-системой (см. Управление актами по модели Постоплата сторонней ERP-системой). Этот метод используется, если у клиента есть несколько актов за один финансовый период и нужно указать ID конкретного акта. Если у клиента только один акт за финансовый период, можно также использовать другой метод без указания ID акта — см. Подтверждение акта по модели Постоплата для клиента реселлера.

В результате:

• Сторонняя ERP-система опционально может указать сумму и валюту счета на оплату. При этом:
  • Сумма и валюта акта и связанного платежа в платформе остаются без изменений.
  • В Панели управления Клиента для платежа отображается сообщение с указанными суммой и валютой счета.
  • Если указанные сумма и валюта счета отличаются от суммы подтверждаемого акта и валюты реселлера в платформе, клиент не сможет оплатить счет с баланса. Доступны только другие способы оплаты, в том числе на основе коннекторов платежных шлюзов (см. Управление коннекторами платежных шлюзов). При переходе на страницу выбранного способа оплаты (см. Способы оплаты) клиенту к оплате выставляются указанная сумма и валюта счета. Сумма платежа в платформе не изменяется, в том числе после оплаты.
  • Если указанные сумма и валюта счета не отличаются от суммы подтверждаемого акта и валюты реселлера в платформе, клиент может оплатить счет с баланса или другим способом оплаты.
  • Сумму и валюту счета, указанные при вызове метода, затем можно получить по API из платежа, связанного с актом (см. Получение информации о платеже реселлера).
• Сторонняя ERP-система опционально может прикрепить к платежу в платформе файл счета на оплату или ссылку на него.
• Для платежа в платформе будет установлена дата отсрочки согласно правилу обслуживания клиента.
• Срабатывает событие уведомлений Счет был подтвержден (см. Создание события уведомлений).

После получения оплаты по выставленному счету необходимо подтвердить платеж в платформе с помощью метода Завершение акта по модели Постоплата по ID.

В Панели управления Оператора опционально доступно подтверждение акта вручную, а также подтверждение или отмена платежа вручную:

• Подтверждение акта вручную с выставлением счета сторонней ERP-системой
• Обработка платежа с выставлением счета сторонней ERP-системой

POST {base_url}/api/v3/resellers/{reseller_id}/invoices/{invoice_id}/approve

Аргументы

Модель ответа

Ошибки

Пример запроса

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",
    "amount": {
        "total": "123.45",
        "currency": "USD"
    },
    "attachment": {
        "type": "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": "987.65",
            "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": []
            }
        }
    }
}