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

"Update": "2016-02-20T00:24:03.457+03:00"

},

"Params": [],

"Pictures": [

{

"Url": "http://ttt9/50/25029/images/62935/62935.970.jpg",

"Hash": "445A88A14EBD0B68D54CDE6EBAEC19E8BD5E4EE81902CB. jpg",

"AeUrl": "http://g02.a. /227487941/HTB1c8NsLVXXXXa1XXXXq6xXFXXXq. jpg",

"Position": 0,

"Date": {

"Create": "2016-02-19T01:34:55.687+03:00",

"Update": "2016-02-20T00:24:03.467+03:00"

},

"Deleted": false

}

],

"Deleted": false

}

],

"Deleted": false

}

]

"@odata. nextLink": "https://e-solution. pickpoint. ru/ae/odata/Goods?$skip=10"

}

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

URL:  https://e-solution. pickpoint. ru/ae/odata/Goods

Создание - добавить карточек товаров.

Тело сообщения:

{

"Sku": "112233",

"Name": "Настольная развивающая игра для детей Сундучок знаний A",

"Description": "Для детей от 7 лет",

"Price": 1233,

"Currency": "RUB",

"Category": {

"CategoryId": 59

},

"Vendor": {

"Name": "BrainBOX",

"Code": "595895"

},

"Characteristics": [

{

"Code": "250545",

"Stock": 0,

"Params": [

{

"Name": "Вес",

"Value": "1"

},

{

"Name": "Высота",

"Value": "12"

},

{

"Name": "Длина",

"Value": "12"

},

{

"Name": "Ширина",

"Value": "12"

}

],

"Pictures": [

{

"Url": "http://images. bobber. ru/wa-data/public/shop/products/29/50/25029/images/62935/62935.970.jpg"

}

]

}

]

}

Ответ:

{

"@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#Goods/$entity",

"Sku": "112233",

"Name": "Настольная развивающая игра для детей Сундучок знаний A",

"Description": "Для детей от 7 лет",

"Price": 1233,

"Currency": "RUB",

"Category": {

"Id": 59

},

"Vendor": {

"Name": "BrainBOX",

"Code": "595895"

},

"Characteristics": [

{

"Code": "250545",

"Stock": 0,

"Params": [

{

"Name": "Вес",

"Value": "1"

},

{

"Name": "Высота",

"Value": "12"

},

{

"Name": "Длина",

"Value": "12"

},

{

"Name": "Ширина",

"Value": "12"

}

],

"Pictures": [

{

"Url": "http://images. /images/62935/62935.970.jpg",

"Position": 0,

"Deleted": false

}

],

"Deleted": false

}

],

"Deleted": false

}

HTTP/1.1 201 Created

Content-Type: application/json; odata. metadata=minimal

Location: https://e-solution. pickpoint. ru/ae/odata/Goods(‘Sku’)

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

Изменяемые параметры элемента должны содержаться в теле запроса

URL: https://e-solution. pickpoint. ru/ae/odata/Goods(‘Sku’)

Метод для обновления информации о товаре в базе данных PickPoint (не в AliExpress). Если хотите чтоб изменения отобразились в AliExpress необходимо воспользоваться методом «Обновление информации одного товара в AE»

{

"@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#Goods/$entity",

"Sku": "112233",

"Name": "Настольная развивающая игра для детей Сундучок знан1ий A",

"Description": "Для детей от 7 лет",

"Price": 1233,

"Currency": "RUB",

"Category": {

"CategoryId": 59

},

"Vendor": {

"Name": "BrainBOX",

"Code": "595895"

},

"Characteristics": [

{

"Code": "250545",

"Stock": 0,

"Params": [

{

"Name": "Вес",

"Value": "1",

"Display": "NONE"

},

{

"Name": "Высота",

"Value": "12",

"Display": "NONE"

},

"Name": "Длина",

"Value": "12",

"Display": "NONE"

},

{

"Name": "Ширина",

"Value": "12",

"Display": "NONE"

}

],

"Pictures": [

"Url": "http://images. bobber. ru/wa-data/public/shop/products/29/50/25029/images/62935/62935.970.jpg",

"Hash": "445A88A14EBEAC013A52619ECB53BD0B68D54CDE6EBAEC19E8BD5E4EE81902CB. jpg",

"Position": 0

}

]

}

]

}

При успешном изменении возвращается HTTP/1.1 204 No Content

Пример2: Для обновления стоков необходимо передавать изменяемую характеристику в полном виде

{

  "@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#Goods/$entity",

  "Characteristics": [

  {

  "Code": "107490", - ID характеристики

  "Stock": 10 - остатки

  }

  ]

}

Пример3:

Работа с разделом «product group» в магазине, который позволяет группировать товары в магазине. Например для магазина «Косметики» можно создать группу: «for Face» - переместить в нее все товары данной категории. «for Hands»…

Для этого необходимо следующее:

1.  Создать группы в ЛК AE

2.  Выполнить метод Http Post https://e-solution. pickpoint. ru/ae/odata/ShopCategories/Data. UpdateProductGroups

3.  Добавить ID группы в категорию товаров, через метод Http Get https://e-solution.pickpoint.ru/ae/odata/ShopCategories(categoryId) (categoryId – Id категории магазина)
{
  "@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#ShopCategories/$entity",
 "AeProductGroupId": 201789654
}

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

URL: https://e-solution. pickpoint. ru/ae/odata/Goods(‘Sku’)

При успешном изменении возвращается HTTP/1.1 204 No Content

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

Метод для публикации в личном кабинете магазина загруженного товара из базы данных PickPoint. Без этого метода товар в личном кабинете не появится!

Узнать о публикации товара или наличие ошибки при публикации можно по методу «Запрос элементов» - данные по этому методу обновляются с задержкой ~20 минут.

https://e-solution. pickpoint. ru/ae/odata/Goods(id)/Data. Publish

При успешном изменении возвращается HTTP/1.1 204 No Content

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

https://e-solution. pickpoint. ru/ae/odata/Goods(id)/Data. UpdateStock

При успешном изменении возвращается HTTP/1.1 204 No Content

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

 https://e-solution. pickpoint. ru/ae/odata/Goods(id)/Data. Online

При успешном изменении возвращается HTTP/1.1 204 No Content

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

https://e-solution. pickpoint. ru/ae/odata/Goods/Data. Offline

При успешном изменении возвращается HTTP/1.1 204 No Content

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

https://e-solution. pickpoint. ru/ae/odata/Goods(id)/Data. Offline

При успешном изменении возвращается HTTP/1.1 204 No Content

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

https://e-solution. pickpoint. ru/ae/odata/Goods(id)/Data.Update

При успешном изменении возвращается HTTP/1.1 204 No Content

Метод для обновления информации о товаре в личном кабинете АлиЭкспресс по конкретному товару.

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

Работа с блоком «Описание товара» в карточке товара на АлиЭкспресс. Шаблон описания можно «привязать» к всем товарам магазина (shop), конкретное описание к товарам определенного бренда (производителя, торговой марки) (Vendor) или к конкретной категории товара (Category).

Максимальное количество выдаваемых элементов на одну страницу: 100 штук. для заказов и 10 штук для товаров

Запрос общего количества существующих элементов в данный момент не реализован.

Существуют три вида шаблонов:

· Shop

· Vendor

· Category

При отсутствии бренда (Vendor) заполняем категорию (Category), а если и категории нет, то – магазин (Shop).

Обязательны в заполнении следующие поля: "TemplateType", “TextRus” и "Target"(при условии, что выбранный шаблон не Shop)

В описании должны присутствовать не менее 2-х картинок товара. Для добавления картинок в описание их необходимj загрузить в Photobank для этого есть отдельная функция “Работа с изображениями»

{

  "@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#DescriptionTemplates",

  "value": [

  Id": 297, -- внутренний идентификатор шаблона описания в PickPoint;

  "TemplateType": "Shop", --тип шаблона (vendor, shop, category);