Модуль Автовыкуп — это помощник в работе с заказами (автоматизация) на сайте Таобао. 

Есть три вида систем заказов, которые участвуют в процессе:

1. Ваша система заказов (покупателя ключа ОТ API).
2. Система заказов OT Platform.
3. Система заказов Поставщика товаров (Таобао).

Модуль Автовыкуп работает с системами 2 и 3 (из OT Platform в систему Поставщика товаров):

• Экспортирует заказы.
• Синхронизирует статусы (товаров и заказа), трек-коды посылок и тд.

Так как модуль Автовыкуп работает только с заказами, которые находятся в системе заказов OT Platform, необходимо с помощью API загрузить заказы из вашей системы в систему OT Platform. Когда заказы будут загружены, возможна дальнейшая работа с модулем Автовыкуп.

Первоначальная настройка

Для начала работы необходимо создать пользователя в админке OT Platform. Для этого:

Заходим по адресу: http://open-demo.otcommerce.com/ik.php

Вводим свой ключ:

Затем вводим логин и пароль, которые были получены вместе с ключом:

Заходим в раздел «Пользователи › Покупатели» и создаем произвольного пользователя по инструкции в статье «Покупатели». (Если возникнут вопросы, можно обратиться в скайп-чат и получить консультацию у Менеджера ОТ).

Для дальнейшей настройки, сохраняем у себя (записываем или запоминаем) логин и пароль созданного пользователя.

Идем в раздел «Конфигурация › Доставка › Внешняя» и добавляем Внешнюю доставку с бесплатной (нулевой) стоимостью, используя статью «Внешняя доставка». (Если возникнут вопросы, можно обратиться в скайп-чат и получить консультацию у Менеджера ОТ). Это действие необходимо, потому что заказы в системе OT Platform привязываются к Доставке (при этом сама конфигурация не важна, поэтому делаем доставку бесплатной).

Для дальнейшей настройки, сохраняем у себя (записываем или запоминаем) идентификатор доставки.

Добавление заказов в систему ОТ Platform

Для добавления заказов в систему ОТ Platform существует метод AddOrder.

Для работы с ним необходимы:

• Сессия пользователя/покупателя (создали логин и пароль в первичной настройке)
• Описание заказа в формате xml

Заказ в формате xml

Общие данные о заказе:

• DeliveryModeId — идентификатор доставки (созданной ранее)
• Comment — комментарий к заказу (на ваше усмотрение, можно и не задавать)
• UserProfileId — идентификатор профиля покупателя (можно получить методом GetUserProfileInfoList по сессии покупателя)

Список строк заказов (описаний товаров):

• Id — идентификатор товара
• ConfigurationId — идентификатор конфигурации товара (набора опций в товаре), если товар не имеет опций, нужно передать значение 0.
• Quantity — количество товаров
• Weight — вес товара, в данном случае неважен, можно не передавать
• Comment — комментарий к товару (на ваше усмотрение, можно и не передавать)
• PromotionId — идентификатор скидки товара, для заказа без скидки можно не передавать

Результат работы метода AddOrder

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

В ответ метод AddOrder выдаст информацию о готовом заказе либо ошибку. Стоит сверить список товаров в готовом заказе и тот что передавался в метод.

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

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

Возможные причины ошибок

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

1. Товар снят с продажи (закончился на складе и тд). Убрать товар из списка товаров или подобрать аналогичный у другого продавца.
2. Данной конфигурации товара нет на сайте (или она закончилась). Выбрать другую конфигурацию товара (цвет, размер и тп) или подобрать аналогичный у другого продавца.
3. Указанного продавца больше нет на сайте. Выбрать аналогичный товар у другого продавца.
4. Опечатка в каком-либо поле документа. Проверить правильность ввода данных.
   
   

Результат работы метода AddOrder: заказ из вашей системы попал в систему ОТ Platform (если смотреть аналогию в начале статьи, то из блока 1 попал в блок 2).

Имитация оплаты заказа

Так как система ОТ Platform рассчитана на обычную работу интернет-магазина, невозможно отправить в Автовыкуп заказ, который не был оплачен. Пока мы разрабатываем иное решение по данному вопросу, необходимо настроить имитацию оплаты заказа по схеме, описанной ниже.

Все действия делятся на две части:

1. Пополнение счета покупателя.
2. Оплата заказа со счета покупателя.
   

Реальный перевод денег не требуется!

Пополнение счета покупателя

Пополнить счет можно методом PostTransaction. Для этого требуется:

• Административная сессия.
•  Идентификатор покупателя.
•  Сумма перевода.
• В isDebit передаем значение true (так как идет пополнение счета).
•  В комментарий и дату можно ничего не передавать.

Идентификатор покупателя и сумму можно узнать из информации о заказе, которая получена в ответ на AddOrder (либо можно запросить отдельно методом GetSalesOrderDetailsForOperator — там тоже админстративная сессия, идентификатор заказа, в параметр filter можно отправить пустую строку, а в queryType значение 0. Метод неоднократно пригодится вам и далее.)

Оплата со счета покупателя

Оплатить заказ со счета покупателя можно методом SalesPaymentReserve

Для этого требуется:

• Административная сессия.
• Идентификатор Заказа.
• Сумма оплаты.

Если обе операции прошли успешно, то заказ теперь оплачен, и можно приступать к экспорту в систему Товарного Провайдера.

В любой момент состояние заказа можно проверить методом GetSalesOrderDetailsForOperator , он же понадобится в дальнейшем и для получения информации от провайдера, такой как трек-номера, статусы, и т.д.

Автовыкуп