Добавление точки продаж в маркетплейс
Магазин и точка продаж добавляются в маркетплейс одним запросом:
- метод:
POST - ресурс:
/v3/marketplace/api/shop - тело запроса - объект CreateShopRequest
- тело ответа - объект ShopResponse
- Возможные ошибки
Пример запроса
POST /v3/marketplace/api/shop
Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e
Content-Type: application/json
User-Agent: MyApp 1.0
Accept: application/json
{
"title": "Тестовый магазин",
"description": "Это наш тестовый магазин",
"brandId": 123,
"merchantId": "01771534-1a57-f184-dee3-ebeb91dded76",
"externalUpdate": true
}
Ответ (по схеме):
{
"data": {
"id": 1,
"title": "string",
"description": "string",
"shortDescription": "string",
"seoTitle": "string",
"seoKeywords": "string",
"seoDescription": "string",
"categoryId": 1,
"shopDeliveryId": 1,
"alias": "string",
"shopUrl": "string",
"minOrderSum": 100.5,
"stockMode": "string",
"priceMode": "string",
"notificationEmail": "string",
"defaultPriceId": 1,
"imagePath": "string",
"imageId": 1,
"ogImagePath": "string",
"ogImageId": 1,
"mode": "string",
"jivositeId": "01771534-1a57-f184-dee3-ebeb91dded75",
"orderFlow": "string",
"yandexMetrikaId": 1,
"deliveryInfo": "string",
"shopIds": {},
"accountProgramIds": {},
"type": "string",
"orderLifetime": 1,
"modelId": 1,
"manualProperties": {},
"compiledProperties": {},
"properties": {},
"imageIds": {},
"modelIds": {},
"hours": {
"mon": {},
"tue": {},
"wed": {},
"thu": {},
"fri": {},
"sat": {},
"sun": {}
},
"address": "string",
"lat": 100.5,
"lon": 100.5,
"distance": 100.5,
"externalId": "01771534-1a57-f184-dee3-ebeb91dded75",
"brandId": 1,
"merchantId": "01771534-1a57-f184-dee3-ebeb91dded75",
"countryId": "01771534-1a57-f184-dee3-ebeb91dded75",
"cityId": 1,
"active": false,
"priority": 1,
"merchantCategoryId": 1,
"status": "string",
"contactEmail": "string",
"contactPhone": "string",
"contactVkLink": "string",
"contactTgLink": "string",
"contactOkLink": "string"
},
"metaData": {
"totalCount": 1,
"pageSize": 1,
"page": 1
},
"extendedData": [
{
"type": "string",
"data": {}
}
]
}
CreateShopRequest
| Свойство | Тип | Описание | Пример значения |
|---|---|---|---|
| title * | string(50) | Название магазина | Тестовый магазин |
| description | string(2000) | Описание магазина | Это наш первый тестовый магазин |
| brandId | int | Идентификатор магазина с типом brand | 123 |
| merchantId | string(36) | Идентификатор магазина Инвойсбокс, для подгрузки чсти данных из Инвойсбокс | 01771534-1a57-f184-dee3-ebeb91dded76 |
| accountProgramIds | array | Массив идентификаторов программ лояльностей, котоыре принимает точка | [01771534-1a57-f184-dee3-ebeb91dded71,01771534-1a57-f184-dee3-ebeb91dded72] |
ShopResponse
Повторяет свойства объекта CreateShopRequest с дополнительными свойствами:
| Свойство | Тип | Описание | Пример значения |
|---|---|---|---|
| id * | int | Идентификатор магазина | 12 |
| token * | string(64) | Токен магазина | 95e5396611d261986cec0915a9f85799 |
| type * | string(50) enum | Тип магазина | shop,marketplace,external,offline,brand |
| alias * | string(20) | Алиас магазина | 1694158899 |
| shopUrl * | string(64) | Ссылка на магазин | https://1694158899.expressclient.ru |
| accountProgramIds | array | Массив идентификаторов программ лояльностей, которые принимает точка | [01771534-1a57-f184-dee3-ebeb91dded71,01771534-1a57-f184-dee3-ebeb91dded72] |