Создание Заказа на пролонгацию

Метод Create a Prolong Order позволяет создать Заказ на пролонгацию существующей Подписки текущего Реселлера или любого из его нижестоящих Реселлеров (см. Пролонгация подписки).

Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.

POST {base_url}/api/v3/resellers/{reseller_id}/prolong_order

Аргументы

Название					Тип параметра	Тип данных	Обязательный/ Опциональный	Описание
X-Api-Token					header	string	Обязательный	API токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-Type					header	string	Обязательный	Предназначен для идентификации формата и способа представления сущности
Accept					header	string	Обязательный	Предназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером)
reseller_id					path	integer	Обязательный	ID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере)
data					form	object	Обязательный	Информация об атрибутах операции
	attributes				form	object	Обязательный	Атрибуты операции
		subscription_id			form	integer	Обязательный	ID Подписки, которую необходимо пролонгировать
		resources			form	object	Опциональный	Перечень Ресурсов в Заказе на пролонгацию. Если атрибут отсутствует, Подписка будет пролонгирована с текущим количеством Ресурсов
			data		form	array	Опциональный	Информация о Ресурсах, количество которых требуется изменить
				plan_resource_id	form	integer	Опциональный	ID Ресурса Тарифного плана
				quantity	form	integer	Опциональный	Целевое количество Ресурса
		promo_code			form	string	Опциональный	Код для получения скидки

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

В случае отсутствия ошибок метод возвращает данные о созданном Заказе на пролонгацию (см. модель ответа в Получение информации о Заказе Реселлера). Статус ответа: 201 Created.

Ошибки

Статус ошибки	Текст ошибки	Комментарий
403	Выполнение действия запрещено	Список доступных действий над Подпиской см. в Получение информации о Подписке Реселлера
422	Заказ не может быть завершен: сумма заказа превышает кредитный лимит по подписке	Чтобы создать Заказ, необходимо увеличить Кредитный лимит для Клиента (см. Просмотр и обновление информации о клиенте) или индивидуальный Кредитный лимит для данной Подписки (см. Просмотр и обновление информации о подписке)
	Заказанное количество ресурсов не удовлетворяет доступному диапазону значений	Необходимо уменьшить или увеличить количество Ресурсов в соответствии с пределами, заданными в Тарифном плане (см. Получение информации о Тарифном плане Реселлера)
	Ресурс id недоступен для заказа в тарифном плане	Ресурс с указанным ID недоступен в рамках Тарифного плана

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

POST /api/v3/resellers/1/prolong_order
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

{
    "data": {
        "attributes": {
            "subscription_id": 3008945,
            "resources": {
                "data": [
                    {
                        "plan_resource_id": 4340,
                        "quantity": 5
                    }
                ]
            },
            "promo_code": ""
        }
    }
}

Пример ответа

{
    "data": {
        "id": "16106",
        "type": "prolong_orders",
        "attributes": {
            "created_at": "2021-12-27T01:23:02.982+03:00",
            "updated_at": "2021-12-27T01:23:03.128+03:00",
            "document_id": "PO0000818",
            "status": "waiting_for_payment",
            "account_id": 1405,
            "type": "ProlongOrder",
            "closed_at": null,
            "expiration_date": "2022-02-01",
            "provisioning_date": null,
            "total": "500.0",
            "promo_code": null,
            "payment_id": 11373,
            "manager_id": 343,
            "requester_ip": null,
            "custom_price": false,
            "created_by": "#343 Alexandr Sales",
            "subscription_id": 3008945,
            "items": [
                {
                    "id": 23743,
                    "target_id": "Subscription",
                    "target_type": "Subscription",
                    "type": "ProvisioningItem::Prolong",
                    "status": "waiting_for_payment",
                    "description": "csp_monthly",
                    "quantity": "2022-01-01"
                }
            ]
        },
        "relationships": {
            "charges": {
                "data": [
                    {
                        "id": "115181",
                        "type": "charges"
                    }
                ]
            }
        }
    }
}