Project

General

Profile

Справочник по работе с разделом Экспорт заказов в Кабинете разработчика

Общее описание

Экспорт заказов - раздел Кабинет разработчика, который позволяет Партнеру выгрузить информацию по заказам на свои продукты в виде файла (Excel, CSV, HTML).
Каждая позиция заказа выгружается в отчет в виде отдельной строки.

Подробное описание работы с Кабинетом разработчика см. в отдельной инструкции.

Для доступа к экспорту заказов:
  • Перейдите в Кабинет разработчика: https://secure.allsoft.ru/my_author.php
  • Нажмите ссылку Экспорт заказов в блоке Продажи на главной странице Кабинета разработчика

Также раздел доступен по прямой ссылке (https://secure.allsoft.ru/export_orders.php) после авторизации в Кабинете разработчика.

Критерии выбора данных для экспорта

Для получения файла с данными нужно задать критерии выбора:

  • Статус позиции заказа - позволяет выгрузить позиции заказов только с определенным статусом.
    • При выборе варианта Отказ клиента от ключа, возврат будут выгружены те позиции заказов, по которым был выполнен возврат (хотя бы одного ключа для позиции).
  • Регион - позволяет выгрузить позиции заказов, оформленных в определенном регионе (зоне, стране).
    Используется, если продажа продукта происходит через корзину с возможностью выбрать регион (или есть несколько корзин, работающих в разных регионах).
    В списке перечислены все регионы, существующие в системе. Регионы, в которых нет продаж, из списка не скрываются.
  • Продукты - позволяет выгрузить данные по заказам только на определенные продукты:
    • С помощью фильтра Продукт - можно выбрать конкретные программы.
    • С помощью фильтра Способ доставки продукта - можно выбрать группу продуктов в зависимости от вида их доставки покупателю.
    • С помощью фильтра Договор - можно выбрать группу продуктов, продажи которых происходят по определенному договору.
  • Период дат - позволяет выгрузить данные за период, в течение которого с заказом произошли соответствующие события.
    Отображение полей зависит от статуса заказа, по которому происходит выгрузка. По умолчанию выбран статус "все" поэтому часть полей скрыта. Выберите определенный статус, чтобы отобразилось больше полей для определения периода (см. далее).
    Внимание! Если указать слишком большой период, то файл экспорта может долго формироваться из-за большого объема заказов.
    • Дата создания заказа - период дат, в которые был оформлен заказ. Поле доступно при выборе Статуса позиции заказа = все / новый / удален.
    • Дата оплаты заказа - период дат, в которые заказ был оплачен. Поле доступно при выборе Статуса позиции заказа = оплачен / доставлен.
    • Дата возврата - период дат, в которые был возврат по позиции заказа. Поле доступно при выборе Статуса позиции заказа = отказ клиента от ключа, возврат.

Формат файла экспорта

Поддерживается несколько форматов файла экспорта и выбор кодировки. Для настройки воспользуйтесь полями Формат файла и Кодировка файла в разделе Экспорт заказов.

Особенности форматов файлов:

Формат Особенности
Excel В качестве пустого числового значения, выгружается "0" (используется для полей "процент скидки", "скидка по купону, %", "скидка по купону, руб.", если нет скидки).
В качестве пустого текстового значения всегда подставляется неразрывный пробел.
HTML В качестве пустого текстового значения всегда подставляется неразрывный пробел.
CSV В первой строке содержится нумерация столбцов.
Все текстовые значения берутся в кавычки, в начале подставляется пробел.
CSV (PHP 5 >= 5.1.0) Нумерация столбцов в первой строке не используется.
В качестве пустого значения всегда подставляется неразрывный пробел.
Для текстовых значений используются правила:
Если значение более одного слова, то оно обрамляется в кавычки (иначе нет).

Данные по заказам в экспорте

Для получения файла с экспортом заказов нужно настроить данные, которые будут выгружены. Для этого отметьте нужные данные флажком в списке Данные по заказу в разделе Экспорт заказов.

Обратите внимание! Каждая позиция заказа выгружается в отчет в виде отдельной строки. То есть в выгрузке может быть несколько строк с одинаковыми номерами заказов и другими данными по заказу, но с разными данными по продуктам.

Данные в таблицах далее сгруппированы по тематике. Порядок в интерфейсе Кабинета разработчика может отличаться.

Общая информация по заказу

Данные по заказу Описание Рекомендации по выгрузке
Номер заказа Выгружается только числовая часть номера, например, 3671807.
Покупатель может видеть в корзине номер заказа с префиксом, например: A003671807.
Рекомендуется выгружать при каждом экспорте. для идентификации данных.
Название продукта Полное название продукта в заказе: [название программы] + [название версии] + [название ценовой группы].
HTML-теги вырезаются из названия.
Рекомендуется выгружать при каждом экспорте. для идентификации данных.
Способ доставки продукта Один из способов: электронный или коробочный.
Кол-во копий Количество копий продукта в заказе без учета возвратов по позиции (если они были). Рекомендуется выгружать при каждом экспорте.
Уровень продаж Уровень, через который была выполнена продажа, см. подробнее.
Витрина Название корзины, через которую был оформлен заказ. Рекомендуется выгружать, если продажи идут через несколько корзин.
% по витрине Процент Softline Ecommerce по договору, по которому осуществляется продажа продукта.
Статус заказа Статус позиции заказа.
Статус "Отказ клиента от ключа, возврат" обозначает, что по позиции был выполнен возврат хотя бы одного ключа.
Рекомендуется выгружать при каждом экспорте.
Комментарий к статусу заказа Заполняется при удалении заказа в процессе обработки возврата. Рекомендуется выгружать для детализации информации по возвратам.
Дата оформления заказа Дата и время оформления заказа, например, 01.10.2021 8:38:32. Рекомендуется выгружать при каждом экспорте.
Дата оплаты заказа Дата и время оплаты заказа, например, 03.10.2021 13:24:18.
Заполняется, только если заказ был оплачен.
Рекомендуется выгружать для детализации информации по оплаченным заказам.
Способ оплаты Техническое название способа оплаты зазаза (может отличаться от того названия, которое покупатель видит в корзине). Рекомендуется выгружать для детализации информации по использованию способов оплаты.

Идентификаторы продукта

Данные по заказу Описание Рекомендации по выгрузке
ID ценовой группы продукта Идентификатор Softline Ecommerce для ценовой группы продукта (присваивается продукту при заведении в каталоге). Рекомендуется выгружать при каждом экспорте. для идентификации данных.
Идентификатор в базе продавца Идентификатор продукта из поля Код, который заполняется для ценовой группы в Кабинете разработчика.
Этот код может быть передан в веб-сервис при получении лицензионной информации по позиции заказа.
Рекомендуется выгружать, если в каталоге для продуктов заполняется поле Код.
Артикул (Vendor SCU) Идентификатор продукта (артикул, scu). Заполняется Отделом контента в случае необходимости. В разделе управления каталогом через Кабинет разработчика не отображается. Может отличаться для разных цен одной ценовой группы.
 
Также может быть заполнен дополнительный артикул (Vendor SCU AR), который будет сохранен в заказ и использован вместо обычного Vendor SCU, если на продукт оформлена подписка с автоматическим продлением лицензии.
Рекомендуется выгружать, если в каталоге для продуктов заполняется Артикул/SCU.

Подписки

Данные по заказу Описание Рекомендации по выгрузке
Заказ с подпиской Выгружается комментарий, если оформлена подписка на позицию заказа.
Возможные значения:
- автопродление родительский - заказ создан пользователем, и в нем подключена подписка с автопродлением, подробнее см. в отдельной инструкции.
- фиктивный родительский - заказ создан пользователем и в нем подключена PMR подписка (заказ на продление будет создан автоматически, но оплатить его пользователь должен вручную, автооплаты нет).
- автопродление дочерний - заказ создан автоматически для автопродления подписки, подробнее см. в отдельной инструкции.
- фиктивный дочерний - заказ создан автоматически для PMR подписки.
Если значение не заполнено, то это обычный заказ, созданный пользователем (и без подписки).
Рекомендуется выгружать, для детализации информации по подпискам, если они используются.

Доставка и возвраты лицензионной информации (ключей)

Данные по заказу Описание Рекомендации по выгрузке
Ключ выдан Лицензионная информация (ключи), выданная по позиции заказа.
Заполняется в случае, если выдача осуществляется через автоматическую отправку ключей.
При использовании веб-сервиса для отправки ключа, если включен флаг "Не высылать письмо с ключем", то ключ не будет сохранен в систему при получении, и не отобразится в отчете.
Ключи выгружаются независимо от их текущего статуса (в том числе и по возвратам), чтобы детализировать инфомацию под ключам см. следующие строки.
Ключ удален, клиент отказался / возврат Лицензионная информация (ключи), по которым был возврат для позиции заказа.
Формат выгрузки:
Ключ 1 (причина возврата ключа, Ключ N (причина возврата ключа).
Рекомендуется выгружать для детализации информации по возвратам.
Ключ удален, тех. ошибка Лицензионная информация (ключи), по которым ключ был удален для позиции заказа (был выдан некорректный ключ).
Формат выгрузки:
Ключ 1 (причина удаления ключа, Ключ N (причина удаления ключа).
Рекомендуется выгружать для детализации информации по возвратам.

Стоимость продуктов

Данные по заказу Описание Рекомендации по выгрузке
Цена продукта (1 шт.), в валюте заказа Цена продукта за 1 шт. в валюте заказа.
Скидка по позиции не учитывается.
VAT учитывается также, как при отображении в корзине (начисление сверху на цену каталога или в том числе, способ начисления определяется договором).
Цена продукта со скидкой (1 шт.), в валюте заказа Цена продукта за 1 шт. в валюте заказа с учетом VAT и скидки, примененной при оформлении заказа.
Это та цена за 1 шт., по которой произошла продажа.
Рекомендуется выгружать при каждом экспорте.
Ставка НДС Процент VAT, который был применен при расчете суммы налога.
Сумма НДС (1 шт.), в валюте заказа Сумма VAT, которая была рассчитана для позиции заказа.
Валюта заказа ISO-код валюты заказа Рекомендуется выгружать, если продажи могут осуществляться в разных валютах.
Курс рубля к 1 usd Официальный курс рубля к USD.
Курс валюты заказа к usd Официальный курс валюты заказа к USD.
Если заказ оформлен в рублях, то значение будет совпадать со значением в колонке "Курс рубля к 1 usd".
Цена продукта (1 шт.), руб. Цена продукта за 1 шт. в валюте рублях.
Скидка по позиции не учитывается.
VAT учитывается также, как при отображении в корзине (начисление сверху на цену каталога или в том числе, способ начисления определяется договором).
Пересчет в рубли производится по курсу на день оформления заказа. Для продуктов, купленных за региональную валюту, возможны незначительные отличия от рублевых цен, из-за пересчета цены по курсу.
Цена продукта со скидкой (1 шт.), руб. Цена продукта за 1 шт. в валюте заказа с учетом VAT и скидки, примененной при оформлении заказа.
Пересчет в рубли производится по курсу на день оформления заказа. Для продуктов, купленных за региональную валюту, возможны незначительные отличия от рублевых цен, из-за пересчета цены по курсу.
Итоговая стоимость, руб. Стоимость позиции заказа в рублях без учета скидки за проданное количество копий. [Цена продукта (1 шт.), руб.]*[Кол-во копий].
Итоговая стоимость со скидкой, руб. Стоимость позиции заказа в рублях с учетом скидки за проданное количество копий. [Цена продукта со скидкой (1 шт.), руб.]*[Кол-во копий] Рекомендуется выгружать при каждом экспорте.

Взаиморасчеты

Содержит информацию о взаиморасчетах между Softline Ecommerce и Партнером за проданные продукты.

Данные по заказу Описание Рекомендации по выгрузке
Валюта взаиморасчетов ISO-код валюты валюты, в которой происходят выплаты Разработчику по договору за проданные продукты. Рекомендуется выгружать, если валюта взаиморасчетов с отличается от валюты продажи.
Курс валюты взаиморасчетом к валюте заказа в день оформления заказа Официальный курс валюты заказа к валюте взаиморасчетов. Рекомендуется выгружать, если валюта взаиморасчетов отличается от валюты продажи.
Доля автора, руб Сумма доли Партнера от продажи продукта.
Указывается в рублях.
Рассчитывается от цены продукта в заказе. Возвраты не учитываются при расчете.
Рекомендуется выгружать при каждом экспорте.

Скидки и купоны

Данные по заказу Описание Рекомендации по выгрузке
Процент скидки Указывается процент скидки для продукта, если она была применена при оформлении заказа. Рекомендуется выгружать для детализации информации по применению скидок.
Тип скидки Название типа скидки (указывается если есть, за исключением скидок за счет Softline Ecommerce.
Скидочный купон (серия, номер) Информация о купоне, если он был применен к позиции заказа. Рекомендуется выгружать для детализации информации по промо-акциям с применением купонов.
Скидка по купону, % Процент скидки по купону, если он был применен к позиции заказа. Рекомендуется выгружать для детализации информации по промо-акциям с применением купонов.
Скидка по купону, руб. Сумма скидки по купону в рублях, если он был применен к позиции заказа. Рекомендуется выгружать для детализации информации по промо-акциям с применением купонов.

Данные покупателя

Данные по заказу Описание Рекомендации по выгрузке
Фамилия клиента
Имя клиента
Отчество клиента Заполняется, если отображение поля включено на корзине (по умолчанию выключено).
На чье имя оформлена лицензия Заполняется, если при оформлении заказа пользователь выбрал оформление лицензии на другое лицо. В одном поле выводятся все данные (имя, фамилия, контактные данные и т.п.).
Название организации Заполняется, если заказ был оформлен на юридическое лицо.
VAT Number Заполняется, если поле присутствует на Корзине (присутствует в некоторых регионах). Название поля в корзине может отличаться, например, для Польщи (PL) - это поле называется "NIP"
E-mail Адрес, на который высылается лицензионная информация по заказу, для продуктов с электронной доставкой (если настроена автоотправка ключей)
Телефон
Факс Заполняется, если отображение поля включено на корзине (по умолчанию выключено).
Страна Заполняется, если отображение поля включено на корзине.
Индекс Заполняется, если отображение поля включено на корзине.
Область Заполняется, если отображение поля включено на корзине.
Город Заполняется, если отображение поля включено на корзине.
Улица Заполняется, если отображение поля включено на корзине.
Дом Заполняется, если отображение поля включено на корзине.
Корпус Заполняется, если отображение поля включено на корзине.
Строение Заполняется, если отображение поля включено на корзине.
IP клиента

Вместо данных покупателя может выводиться deleted, если покупатель воспользовался правом на удаление персональных данных, подробнее.

Дополнительные данные

Данные по заказу Описание Рекомендации по выгрузке
Дополнительная информация от клиента Выгружается, если для программы в каталоге настроено отображение дополнительного поля и покупатель заполнил его при оформлении заказа. Рекомендуется выгружать, если у программ в каталоге настроены дополнительные поля.
URL-параметры referer1 - referer6 Выгружаются значения параметров referer1 - referer6 (до 6 штук), если они были зафиксированы для заказа.
Значение параметра фиксируется, если покупатель добавил продукт в корзину по ссылке, содержащей referer. Может использоваться для отслежвания проведения акций, определения источника перехода и др.
Подробнее о параметре см. в отдельной инструкции.
Рекомендуется выгружать, если рефереры используются в ссылках на покупку.
Параметр partner_add Выгружается значение параметра partner_add, если оно было зафиксированы для заказа.
Значение параметра фиксируется, если покупатель добавил продукт в корзину по партнерской ссылке, содержащей partner_add.
Рекомендуется выгружать, если есть продажи через партнерскую программу и используется параметр partner_add.
Реферал Выгружаются название реферала, если был отслежен переход по реферальной ссылке перед оформлением заказа.
Рефералы определяются в разделе Рекламные кампании (рефералы) в Кабинете разработчика.
Рекомендуется выгружать, если используются рекламные кампании с рефералами.
Баннеры, рекомендации Заполняется, если в заказе зафиксировано, каким образом был добавлен продукт в заказ:
- по баннеру - в поле указывается: Баннер [id баннера];
- по рекомендации - если покупатель добавил продукт в корзину, выбрав из блока рекомендуемых продуктов в корзине, то в поле указывается: Рекомендован к [id ценовой группы продукта, к которому была показана рекомендация].
Отслеживание поддерживается не всеми корзинами.
Рекомендуется выгружать для детализации информации о способах добавления продуктов в корзину, если возможность поддерживается корзиной.
Оформлен в Выгружается информация о версии корзины (десктопная / мобильная) в которой был оформлен заказ.
Оплачен в Выгружается информация о версии корзины (десктопная / мобильная) в которой был оплачен заказ.