Приобретение элементов каталога

Следующий сценарий демонстрирует универсальный процесс приобретения элементов из каталога с помощью API Центра партнеров.

Обнаружение

Выберите продукты и единицы хранения запасов (SKU) и проверьте их доступность с помощью следующих моделей API Центра партнеров:

• Продукт — конструкция группирования для товаров или услуг, доступных для использования. Продукт сам по себе не является purchasable элементом.
• SKU — номер SKU , доступный для использования в продукте. Они представляют различные формы продукта.
• Доступность — конфигурация, в которой номер SKU доступен для покупки (например, страна или регион, валюта и отраслевый сегмент).

Чтобы приобрести элемент из каталога, выполните следующие действия.

1. Определите и получите номер SKU продукта и номера SKU, которые вы хотите приобрести.

   • Получение списка продуктов
   • Получение продукта с помощью идентификатора продукта
   • Получение списка номеров SKU для продукта
   • Получение номера SKU с помощью идентификатора SKU

2. Проверьте инвентаризацию номера SKU. Этот шаг необходим только для номеров SKU, помеченных значением InventoryCheck в свойстве purchasePrerequisites .

   • Проверка запасов

3. Получение доступности для номера SKU. При размещении заказа вам потребуется CatalogItemId доступности. Чтобы получить это значение, используйте один из следующих API:

   • Получение списка доступности для номеров SKU
   • Получение доступности с помощью идентификатора доступности

Отправка заказа

Чтобы отправить заказ элемента каталога, сделайте следующее:

1. Создайте корзину для хранения коллекции элементов каталога, которые вы планируете приобрести. При создании корзины элементы строки корзины автоматически группируются в зависимости от того, что можно приобрести вместе в одном заказе.

   • Создание корзины покупок
   • Обновление корзины покупок

2. Ознакомьтесь с корзиной. Извлечение корзины приводит к созданию заказа.

   • Извлечение корзины

Получение сведений о заказе

Вы можете получить сведения об отдельном заказе с помощью идентификатора заказа или получить список заказов для клиента. Задержка составляет до 15 минут между отправкой заказа и отображением в списке заказов клиента.

• См. статью "Получить заказ по идентификатору ", чтобы получить сведения об отдельном заказе с помощью идентификаторов заказов.

• Ознакомьтесь со всеми заказами клиента, чтобы получить список заказов для клиента с помощью идентификатора клиента.

• Ознакомьтесь со списком заказов по клиенту и типу цикла выставления счетов, чтобы получить список заказов для клиента по типу цикла выставления счетов, что позволяет перечислять заказы на элементы каталога (одноразовая плата) и ежегодные или ежемесячные выставленные заказы отдельно.

Управление жизненным циклом

В рамках управления жизненным циклом элементов каталога в Центре партнеров можно получить сведения о правах элемента каталога и получить сведения о резервировании с помощью идентификатора заказа на резервирование. Примеры этого см. в разделе "Получение прав". ​

Счет и сверка

В следующих сценариях показано, как программным образом просматривать счета клиента , а также получать балансы и сводки учетных записей, которые включают одноразовую плату за элементы каталога.

Баланс и платеж

Чтобы получить баланс текущей учетной записи в типе валюты по умолчанию, который является балансом как повторяющихся, так и однократных (элемент каталога) расходов, см. статью "Получить баланс текущей учетной записи".

Баланс и платеж с несколькими валютами

Чтобы получить баланс текущей учетной записи и коллекцию сводок по счету, содержащих сводку по счету с повторяющимися и одноразовыми расходами для каждого типа валют вашего клиента, см . сводки по счетам.

Счета

Чтобы получить коллекцию счетов, которые показывают как повторяющиеся, так и одноразовые расходы, см. статью "Получение коллекции счетов". ​

Один счет

Чтобы получить конкретный счет с помощью идентификатора счета, см. статью "Получить счет по идентификатору". ​

Примирения

Чтобы получить коллекцию сведений о строке счета (элементы линии выверки) для определенного идентификатора счета, см. статью "Получение элементов строки счета". ​

Скачивание счета в формате PDF

Чтобы получить инструкцию по счету в формате PDF с помощью идентификатора счета, см . инструкцию по получению счета.