На данный момент в Сервисе доступны две основные команды: order и customer. Команда order управляет запросом к Сервису. Команда customer передает Сервису данные покупателя.

1. Элемент order

Атрибут Описание Принимаемые значения Значение по умолчанию
Renewal Обновление Yes или No.
Временно обновление недоступно. Поэтому значение Renewal должно всегда быть No.
No
Maintenance Количество лет 1, 2 или 3 1
CustomerType Тип покупателя Normal, NonProfit, HealthCare, Government, Educational, CrossUpgrade Normal
DiscountDescription Описание скидки Для покупателей NonProfit, HealthCare, Government, Educational и CrossUpgrade Значения по умолчанию не имеет
ResellerOrderId Номер счета продавца Номер счета в магазине продавца Значения по умолчанию не имеет

Normal — обычная лицензия, NonProfit — некоммерческие организации, HealthCare — медицинские организации, Goverment — государственные учреждения, Educational — образовательные учреждения или организации, CrossUpgrade — миграция с конкурирующих продуктов.

1.1. Дочерний элемент new-customer элемента order
Атрибут Описание Обязательность значения
CustomerName Имя покупателя латиницей без символов одинарной или двойной кавычек ДА
Company Наименование компании покупателя латиницей без символов одинарной или двойной кавычек ДА
Email Адрес электронной почты покупателя ДА
Phone Телефон покупателя в международном формате ДА
City Наименование города покупателя латиницей без символов одинарной или двойной кавычек ДА
Street Наименование улицы покупателя латиницей без символов одинарной или двойной кавычек РЕКОМЕНДУЕТСЯ
ZIP Почтовый индекс покупателя РЕКОМЕНДУЕТСЯ
State Штат США или страна Евросоюза. Допускаются значения или пустая строка, в последнем случае необходимо указать значение для атрибута Country. ДА
Country Страна покупателя. Допускаются значения. Если атрибут State заполнен, атрибут Country должен содержать пустую строку. ДА
1.2 Дочерний customer элемента order
Атрибут Описание
* Все атрибуты элемента new-customer, если их значения изменились, что они могли быть обновлены в базе данных пользователей Avast.
CustomerNo Номер покупателя в базе данных Avast.
AllowedRenewal 0 — если к покупке не применена скидка на обновление, 1 — если применена.
1.3. Дочерний элемент product элемента order

В элементе order должен присутствовать только один элемент product. При наличии нескольких элементов product будет обработан только первый из них.

Атрибут Описание
InternalId Внутренний идентификатор продукта.
Список идентификаторов для продуктов Avast.
Список идентификаторов для продуктов AVG
Quantity Количество лицензий
PreviousLicenseId ID предыдущей лицензии (нужно при обновлении лицензии). Найти ее можно в файле license.avastlic — секция [CertificateN], где N — номер секции.
#
# License Identifier
#
LicenseId=3c1b2020-5f63-43bf-be28-2ef80635ea11

Вы так же можете указать Renewal="Yes" в элементе order. Если вы укажете PreviousLicenseId, система выписки лицензий Avast автоматически увеличит период действия лицензии, оставив текущий период без изменений. Ваш покупатель не потеряет ни единого дня из купленного им периода. Если Вы не укажете PreviousLicenseId, оставшиеся дни из предыдущего срока действия, будут утеряны.

Пример запроса на обновление:

<!DOCTYPE alwil-b2b SYSTEM "order-template.dtd">
    <alwil-b2b>
        <order Renewal="Yes" ResellerOrderId="1">
            <customer CustomerNo="8026867" />
            <product InternalId="PAV-08-001-" Quantity="1" PreviousLicenseId="952802d7-50fc-4fdb-b363-f3c9f837c6ed" />
        </order>
    </alwil-b2b>