Add Subscription Monthly Charge History

Отправка исторических тарификаций подписок Абонентов
Отправка со стороны Контент Провайдера - исторические тарификации подпискок Абонентов в суммарно за месяц, которые были активированы с 2022-01-01 и тарификация которых была произведена на основе запросов со стороны Контент Провайдера.

Примечание: Общая схема взаимодействия.

Request

POST http://<APIURL:PORT>/Subscription/History/AddHistoryMonthlyChargePSID

Request headers

Parameter name Value Description Additional
VASMS-CPID <uint>

Content Provider ID
Уникальный код Контент Провайдера. Предоставляется со стороны VASMS.

 Required
VASMS-APIKey <string>

Content Provider API Key Value
Предоставляется со стороны VASMS.

 Required
Content-type application/json; charset=UTF-8 Required

Request body

The request body takes a complete Subscription/History/AddHistoryMonthlyChargePSID resource, containing the following writable properties:

{
    "ARTRID": "uint64",
    "CPID": "uint",
    "MSISDN": "string",
    "PSID": "uint64",
    "RAmount": "uint",
    "RMonth": "uint",
    "RYear": "uint",
    "VASID": "uint"
}

Properties

Name Type Description Additional
ARTRID uint64

API Request Transaction ID
Генерируется на стороне КП и должен быть уникальным:
- или для группы: Subscription/History.
- или глобально для всех API-запросов на усмотрение Контент Провайдера.
CPID uint

Content Provider ID
Уникальный код Контент Провайдера. Предоставляется со стороны VASMS.
MSISDN string

Мобильный номер Абонента
Только цифры в формате: 998xxxxxxxxx.
PSID uint64

Provider Subscription ID
Генерируется на стороне КП и должно быть уникальным в области действия всех сервисов.
RAmount uint

Report Amount
Cумма тарификации подписки Абонента за данный период.
RMonth uint

Report Month
Месяц отчета по суммарной тарификации.
В числовом формате.

Possible values are:

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
RYear uint

Report Year
Год отчета по суммарной тарификации.
В числовом формате. К примеру: 2024.
VASID uint

VAS Service ID
Уникальный код VAS-услуги. Предоставляется со стороны VASMS.

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK

Успешная обработка запроса.
400 Bad Request

Ошибочный запрос.

 400[]
401 Unauthorized

Отказ в доступе. Ошибочный VASMS-CPID и/или VASMS-APIKey.
409 Conflict

Дубликат транзакции ARTRID.
429

Too Many Requests
Слишком много паралельных запросов. (Anti-flood rate limiting).
500 Internal Server Error

Системная ошибка на стороне сервера.