API для работы с AliExpress (стр. 1 )

API для работы с AliExpress

(ver.18/04/2017)

Структура API реализована по архитектуре REST ODATA V4. Коммуникация осуществляется посредством

Сообщений JSON, по адресу:

Продуктив https://e-solution. pickpoint. ru/ae/odata

*************************

Для PHP можно использовать https://odataphp. /

Можно почитать https://habrahabr. ru/post/267811/

Curl так же вполне подходит.

Для отправки через curl Http Post запросов можно использовать параметр --data или –X

Более подробно можно прочитать https://curl. haxx. se/docs/manual. html и https://curl. haxx. se/docs/httpscripting. html  

*************************

Описание общей логики:

Для размещения товаров на витрине AliExpress (далее AE) магазину необходимо предоставить данные по размещаемым товарам, через XML(YML) или API.

При работе через API следует последовательно пройти следующие шаги:

1.  Необходимо получить возможные категории товаров АЕ.

Категории товаров перечислены в отдельном Excel файле: http://pickpoint. ru/ali/p/deploy/goods-categoty/ http://pickpoint. ru/ali/p/deploy/step3/

2.  Необходимо добавить категории магазина, указав в какую категорию AE их следует загружать. Метод: Добавление элемента

3.  Получение списка атрибутов и характеристик по категориям для сопоставления.

4.  Сопоставить значения атрибутов и характеристик. Метод: Добавление элемента

5.  Загрузка картинок товара и баннеров в фотобанк АЕ. Метод: Создание

6.  Создание шаблона описания товара. Метод: Создание

7.  Для некоторых товарных категорий (одежда, обувь и подобное) необходимо создать в личном кабинете AE таблицы размеров – SizeChart. ID SizeChart (получается в личном кабинете АЕ после создания) необходимо добавить к соответствующим категориям товаров. Метод: Обновления доступных SizeChart и Частичное изменение

8.  Добавить карточки товаров. Метод: Создание

9.  Опубликовать товары на витрине АЕ. Метод: Публикация

10.  При необходимости обновления информации о товара, следует воспользоваться методами Частичное изменение элемента и Обновление информации одного товара в АЕ:

Для тестирования процессов получения данных, используйте данные ниже.

ClientId - 8f0628de7c6242289531e7fabda3b309

ClientSecret - xLp4rrB_0UTz_fvfjaz6fYi1OBad1oFNESqRzs_Vfec

Username – ShopTest

Password - test

Оглавление

Загрузка товара через xml 3

Регистрация магазина в системе. 3

Авторизация в магазина системе. 3

Работа с категориями товаров магазина. Сопоставление и изменение с категориями AliExpress. 3

1. Получение списка внесенных данных. 3

2. Http method Get, запрос одного элемента. 3

3. Http method Post Добавление нового элемента раздела сопоставление категорий магазина. 3

4. Http method Patch - частичное изменение элемента. 3

5. Http method Put - полное изменение элемента. 3

6. Http method Delete - удаление элемента. 3

7 (а). Http method Get Получение характеристик и их значений по сопоставленным категориям Алиэкспресс 3

7 (б). Http method Get Получение характеристик и их значений по сопоставленным категориям Алиэкспресс 3

8. Http method Post Обновление списка доступных SizeCharts. 3

9. Http method Post Обновление списка доступных ProductGroups. 3

10. Http method Get Получение списка всех параметров категории магазина. 3

11. Http method Get Получение подробной информации о параметре категории. 3

12. Http method Post Добавление нового параметра. 3

13. Http method Patch Изменение параметра, включая добавление или удаление значений параметра и сопоставление с конвертером.. 3

Раздел "Работа с сопоставлениями параметров категорий магазина". 3

1. Получение списка загруженных сопоставлений параметров. 3

2. Http method Get, запрос одного элемента. 3

3. Http method Post – Добавление нового элемента. 3

4. Http method Patch - частичное изменение элемента. 3

5. Http method Put - полное изменение элемента. 3

6. Http method Delete - удаление элемента. 3

Раздел “Работа с товарами». 3

1. Http method Get - запрос всех элементов. 3

2. Http method Post - создание элемента. 3

3. Http method Patch - частичное изменение элемента. 3

4. Http method Delete - удаление элемента. 3

5. Http method Post Публикация одного товара в AE: 3

6. Http method Post Обновление стоков по ID товара в АЕ: 3

7. Http method Post Перевод одного товаров в онлайн: 3

8. Http method Post Перевод одного товара в оффлайн: 3

9. Http method Post Перевод одного товара в оффлайн: 3

10. Http method Post Обновление информации одного товара в АЕ: 3

Работа с шаблонами описаний товаров. 3

1. Http method: GET – получение всех имеющихся шаблонов (с фильтрами). 3

2. Http method Get, запрос одного элемента. 3

3. Http method Post - создание элемента. 3

4. Http method Patch - частичное изменение элемента. 3

5. Http method Put - полное изменение элемента. 3

6. Http method Delete - удаление элемента. 3

Работа с изображениями. 3

1. Http method: GET – получение загруженных изображений (с фильтрами). 3

2. Http method: Get, запрос одного элемента. 3

3. Http method: Post - создание элемента. 3

4. Http method: Delete - удаление элемента. 3

5. Прямая загрузка изображения. 3

Раздел Работа с заказами. 3

1. Http method: GET – получение всех заказов (с фильтром). 3

2. Http method Get, запрос одного элемента. 3

3. Http метод Patch: Изменение заказа (для редактирования доступны только поля трекинг и логист) 3

4. Http метод Get: Запрос обновления информации по заказу в АЕ. 3

5. Http метод Get Запрос выгрузки заказа на FTP(https; sFTP;). 3

Раздел "Работа с сообщениями". 3

1. Http method: GET – получение всех сообщений (с фильтрами). 3

2. Http method Get, запрос одного сообщения. 3

3. Http method Post. Отправка сообщения пользователю.. 3

Раздел "Работа с диспутами". 3

1. Http method: GET получение всех диспутов (споров). 3

2. Http method Get, запрос одного диспута. 3

3. Http method Post - отправить сообщения по диспуту. 3

4. Http method Post - удовлетворение диспута. 3

5. Http method Post - отказ в диспуте. 3

6. Http method Post - отправка диспута на арбитраж.. 3

7. Http method Post - подтверждение получения груза, отправленного клиентом.. 3

8. Http method Post - отказ от ожидания груза, отправленного клиентом.. 3

Загрузка товара через xml

Файл формата xml на основе yml для Яндекс-Маркет (https://yandex. ru/support/partnermarket/yml/about-yml. xml ) с добавлением необходимых полей для AliExpress.

<yml_catalog date="2016-02-19 13:59">

<shop>

<name>kameastudio. ru</name>

<company>kameastudio. ru</company>

<phone>8-800-555-85-89</phone>

<email>*****@***ru</email> - на почту дублируются сообщения от покупателей

</shop>

<currencies>

<currency id="RUR" rate="1"/>

</currencies>

<categories> - перечень категорий товаров, которые есть в данном XML. Где aeId=”100002861 – это ID категории товаров на АлиЭкспресс в которую необходимо загрузить товары.

<category id="109" aeId=” 100007323”>Кольцо</category>

<category id="110" aeId=” 200000167”>Серьги</category>

<category id="113" aeId=” 200001700”>Подвеска</category>

<category id="123" aeId=” 200000175”>Запонки</category>

<category id="126" aeId=”100007299”>Пирсинг</category>

<category id="121" aeId=”200001702”>Зажим</category>

<category id="119" aeId=”100002861”>Часы</category>

</categories>

<offers>

<offer id="3000212"available="false" type="vendor. model" group_id="3000019" bid="13">-уникальный номер товара (SKU). Будет использоваться в качестве идентификатора при выгрузке оформленных заказов. Используем значения: «id="3000212"» group_id="3000019"

 <url>http://baon. ru/catalog/model/id/tsb-to-000019/specialColorName/JASPERPRINTED/item/tsb-to-000212/event/yandex-market/?utm_source=yandexmarket&amp;utm_medium=cpc</url>

 <price>4999</price> - если цена с копейками, то указывается через точку (.) 4999.50. Скидки на товар устанавливаются в личном кабинете, при регистрации товара на промо-активности.

  <currencyId>RUR</currencyId>

  <categoryId>124</categoryId> - ID категории товара в системе магазина

  <picture>http://baon. ru/public/shopcatalog/baon/B294901/JASPERPRINTED/FRONT. jpg</picture>

  <picture order=”1” > http://baon. ru/public/shopcatalog/baon/B294901/JASPERPRINTED/BACK. jpg</picture> - данный параметр нужен для заполнения картинками в нужном порядке в поле «Описание продукта»

  <picture>http://baon. ru/public/shopcatalog/baon/B294901/JASPERPRINTED/2.jpg</picture>

  <picture>http://baon. ru/public/shopcatalog/baon/B294901/JASPERPRINTED/1.jpg</picture> - картинки используются в карточке товара и в поле «Описание товара»

  <store>false</store> - не используется.

  <pickup>false</pickup> - не используется.

  <delivery>true</delivery> - не используется.

  <local_delivery_cost>0</local_delivery_cost> - не используется.

 <name>Брюки</name> - обратите внимание, здесь должно быть название и модель товара, а так же ключевые слова для выдачи в поисковике – публикуется, входит в название товара. Не более 100 символов.