Настройка базового продукта

Softline CheckoutИнтеграцияDynamic Product Checkout API

Обзор возможностей

Базовый продукт, это продукт на нашей стороне, свойства которого используются в качестве значений по умолчанию для продуктов с динамическими свойствами.

При генерации ссылки на покупку через API вы передаете идентификатор базового продукта в запросе. На основании этого система определяет, из какого продукта на нашей стороне брать значения свойств по умолчанию.

Обязательные параметры в запросе (такие как название продукта, цена) всегда переопределят свойства базового продукта при генерации ссылки.
Например, если базовый продукт называется "Продукт 1", а в запросе вы передали "name": "Демо продукт", то при добавлении продукта в корзину у него будет название, переданное в запросе - "Демо продукт"
Необязательные параметры (например, SKU, название для инвойса, настройки рассрочки и др.) переопределяют* свойства базового продукта только, если они были переданы.
Например, если в базовом продукте настроен SKU равный "11111", и вы передали в запросе "sku": "22222", то у продукта в корзине SKU будет равен "22222". Если параметр sku не был передан в запросе, то у продукта в корзине будет SKU равный "11111" (он будет взят из базового продукта).
* - некоторые необязательные параметры работают по иному правилу. Например, настройки подписки. Если в базовом продукте настроена подписка, и в запросе предан параметр product.subscription, то у продукта в корзине будет подписка, и переданные данные переопределят настройки базового продукта. Если параметр product.subscription не передан, то у продукта в корзине не будет подписки (несмотря на то, что она есть в базовом продукте). Такие исключения описаны в протоколе взаимодействия.

Создание базового продукта

Вы можете создать базовые продукты самостоятельно (через Merchant Portal или Product API) или обратиться в службу поддержки.

Базовых продуктов может быть создано один или несколько. Несколько продуктов может понадобиться если:

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

Конфигурация базового продукта

Далее перечислены только ключевые свойства и их особенности. Остальные свойства динамического продукта наследуются из базового.

Доступные валюты продажи

required

Определяет валюты, в которых разрешена продажа продукта.

При создании продукта через Merchant Portal или Product API настройка выполняется автоматически
При генерации ссылки через Dynamic Product Checkout API вы передаете ту валюту (currency), в которой назначена цена на продукт. Она должна входить в число валют, в которых разрешена продажа по вашему договору

Название продукта

Название базового продукта не отображается в корзине.

Для отображения в корзине всегда используется название, переданное в запросе на генерацию ссылки на покупку через Dynamic Product Checkout API (products.name). Вы также можете задать отдельное название, которое будет использоваться в закрывающих документах (products.name_for_invoice)
При создании продукта через Merchant Portal или Product API вы можете указать любое название

Пояснение к названию продукта

Пояснение к названию не отображается в корзине. По ссылкам на покупку, сгенерированным через Dynamic Product Checkout API, у продуктов отображается только название, переданное вами в запросе без пояснения. При создании продукта через Merchant Portal или Product API вы можете указать любое пояснение к названию.

Ваш артикул продукта (SKU)

Не отображается в корзине и используется во внутренних отчетах.

Можно настроить через Merchant Portal или Product API
Можно переопределить при генерации ссылки на покупку через Dynamic Product Checkout API (products.sku)

Ваш идентификатор продукта

Не отображается в корзине и используется во внутренних отчетах.

Можно настроить через Product API
Можно переопределить при генерации ссылки на покупку через Dynamic Product Checkout API (products.vendor_code)

Изображение продукта

Если загружено, то отображается для продукта в корзине.

Можно настроить через Merchant Portal или Product API
Нельзя переопределить при генерации ссылки на покупку через Dynamic Product Checkout API. То есть у всех продуктов на основе одного базового продукта будет одинаковое изображение в корзине (или не будет изображения, если оно не загружено в базовом продукте)

Описание продукта

Если заполнено, то для продукта в корзине отображается иконка, при нажатии на которую открывается описание.

Можно настроить через Merchant Portal или Product API
Нельзя переопределить при генерации ссылки на покупку через Dynamic Product Checkout API. То есть у всех продуктов на основе одного базового продукта будет одинаковое описание в корзине (или не будет описания, если оно не задано в базовом продукте)

Цена за единицу

Цена базового продукта не используется в корзине. Узнайте подробнее о том, как рассчитывается итоговая стоимоть динамического продукта.

При создании продукта через Merchant Portal или Product API вы можете указать любую цену.

Автоматическое продление

Поддерживаются только подписки с автоматическим продлением (AR). Использование подписок с бесплатным пробным периодом (AR Trial) или продлением вручную (PMR) пока не доступно для динамических продуктов.

Чтобы подписка была доступна в корзине, должны выполняться условия:

Автоматическое продление настроено в базовом продукте. Вы можете сделать эту настройку через Merchant Portal или Product API.
Свойства продукта, которые могут быть переопределены в запросе на генерации ссылку на покупку через Dynamic Product Checkout API:
- Для продукта, инициатора подписки: название, цена, срок действия
- Для продукта продления: название, цена
Не могут быть переопределены и будут взяты из настроек базового продукта:
- Срок действия продления (то есть он будет одинаковым у всех продуктов на основе одного базового продукта)
В запросе на генерации ссылку на покупку через Dynamic Product Checkout API передан параметр products.subscription

Узнайте подробнее о том, как работают подписки с динамическими продуктами.

Способ начисления VAT (НДС)

required

Определяет способ начисления VAT на цену продукта. Настраивается в соответствии с вашим договором.

Варианты значения:

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

Особенности заполнения:

При создании продукта через Merchant Portal или Product API настройка выполняется автоматически
Нельзя переопределить при генерации ссылки на покупку через Dynamic Product Checkout API. То есть у всех продуктов на основе одного базового продукта будет одинаковый способ начисления VAT

Начисление НДС

required

Определяет, нужно ли начислять НДС при продаже в российских рублях. Для продаж в других валютах VAT начисляется всегда. Ставка определяется автоматически и зависит от страны продажи.

Варианты значения:

НДС начисляется согласно выбранному способу
Продукт не облагается НДС

Особенности заполнения:

При создании продукта через Merchant Portal или Product API настройка выполняется автоматически в зависимости от наличия продука в реестре отечественного ПО (software_registry)
Может быть переопределено при генерации ссылки на покупку через Dynamic Product Checkout API (products.vat_included)

Наличие программы реестре отечественного ПО

required

Определяет наличие продукта в реестре отечетсвенного ПО (только для продаж в российских рублях). Если программа не внесена в единый реестр российского ПО (https://reestr.digital.gov.ru/), то она облагается НДС (закон 265-ФЗ).

Варианты значения:

Программа внесена в реестр
Программа не внесена в реестр

Особенности заполнения:

Можно настроить через Merchant Portal или Product API
Нельзя переопределить при генерации ссылки на покупку через Dynamic Product Checkout API

Скрытие количества продукта

Позволяет скрыть поле "количество" у продукта в корзине.

Количество продукта в корзине всегда определяется из запроса на генерацию ссылки на покупку через Dynamic Product Checkout API (products.quantity)
Покупатель не может изменить количество продукта в корзине
Скрытие поля "количество" у продукта в корзине можно настроить через Product API
Нельзя переопределить скрытие поля "количество" при генерации ссылки на покупку через Dynamic Product Checkout API

Комментарии для продукта

Выводится рядом с названием продукта в корзине или внизу страницы корзины рядом с кнопкой продолжения оформления заказа. Узнайте подробнее от этой возможности.

Можно настроить через Product API
Нельзя переопределить при генерации ссылки на покупку через Dynamic Product Checkout API

Способ выполнения заказа

Определяет способ доставки продукта покупателю.

Варианты значения:

Электронная доставка - лицензионная информация отправляется покупателю на email
Физическая доставка

Особенности заполнения:

При создании продуктов через Merchant Portal или Product API вы можете создать продукты только с электронной доставкой. Настроить способ электронной доставки можно через Merchant Portal
Переопределить электронную доставку на физическую можно при генерации ссылки на покупку через Dynamic Product Checkout API (products.is_delivery_needed)