Приобретение элементов каталога
Следующий сценарий демонстрирует универсальный процесс приобретения элементов из каталога с помощью API Центра партнеров.
Обнаружение
Выберите продукты и единицы хранения запасов (SKU) и проверьте их доступность с помощью следующих моделей API Центра партнеров:
- Продукт — конструкция группирования для товаров или услуг, доступных для использования. Продукт сам по себе не является purchasable элементом.
- SKU — номер SKU , доступный для использования в продукте. Они представляют различные формы продукта.
- Доступность — конфигурация, в которой номер SKU доступен для покупки (например, страна или регион, валюта и отраслевый сегмент).
Чтобы приобрести элемент из каталога, выполните следующие действия.
Определите и получите номер SKU продукта и номера SKU, которые вы хотите приобрести.
Проверьте инвентаризацию номера SKU. Этот шаг необходим только для номеров SKU, помеченных значением InventoryCheck в свойстве purchasePrerequisites .
Получение доступности для номера SKU. При размещении заказа вам потребуется CatalogItemId доступности. Чтобы получить это значение, используйте один из следующих API:
Отправка заказа
Чтобы отправить заказ элемента каталога, сделайте следующее:
Создайте корзину для хранения коллекции элементов каталога, которые вы планируете приобрести. При создании корзины элементы строки корзины автоматически группируются в зависимости от того, что можно приобрести вместе в одном заказе.
Ознакомьтесь с корзиной. Извлечение корзины приводит к созданию заказа.
Получение сведений о заказе
Вы можете получить сведения об отдельном заказе с помощью идентификатора заказа или получить список заказов для клиента. Задержка составляет до 15 минут между отправкой заказа и отображением в списке заказов клиента.
См. статью "Получить заказ по идентификатору ", чтобы получить сведения об отдельном заказе с помощью идентификаторов заказов.
Ознакомьтесь со всеми заказами клиента, чтобы получить список заказов для клиента с помощью идентификатора клиента.
Ознакомьтесь со списком заказов по клиенту и типу цикла выставления счетов, чтобы получить список заказов для клиента по типу цикла выставления счетов, что позволяет перечислять заказы на элементы каталога (одноразовая плата) и ежегодные или ежемесячные выставленные заказы отдельно.
Управление жизненным циклом
В рамках управления жизненным циклом элементов каталога в Центре партнеров можно получить сведения о правах элемента каталога и получить сведения о резервировании с помощью идентификатора заказа на резервирование. Примеры этого см. в разделе "Получение прав".
Счет и сверка
В следующих сценариях показано, как программным образом просматривать счета клиента , а также получать балансы и сводки учетных записей, которые включают одноразовую плату за элементы каталога.
Баланс и платеж
Чтобы получить баланс текущей учетной записи в типе валюты по умолчанию, который является балансом как повторяющихся, так и однократных (элемент каталога) расходов, см. статью "Получить баланс текущей учетной записи".
Баланс и платеж с несколькими валютами
Чтобы получить баланс текущей учетной записи и коллекцию сводок по счету, содержащих сводку по счету с повторяющимися и одноразовыми расходами для каждого типа валют вашего клиента, см . сводки по счетам.
Счета
Чтобы получить коллекцию счетов, которые показывают как повторяющиеся, так и одноразовые расходы, см. статью "Получение коллекции счетов".
Один счет
Чтобы получить конкретный счет с помощью идентификатора счета, см. статью "Получить счет по идентификатору".
Примирения
Чтобы получить коллекцию сведений о строке счета (элементы линии выверки) для определенного идентификатора счета, см. статью "Получение элементов строки счета".
Скачивание счета в формате PDF
Чтобы получить инструкцию по счету в формате PDF с помощью идентификатора счета, см . инструкцию по получению счета.