API пользователя

Space shortcuts

Page tree

На этой странице находится старая версия документации Altcraft Platform.
Актуальную информацию вы найдёте, перейдя по ссылке https://guides.altcraft.com.

Описание

Массив объектов product используется в API запросах, связанных с импортом продуктов в маркет.

ПараметрТипПримерОбязательныйОписание
namestring"Canon EOS Digital Camera"ДаНазвание продукта.
external_idstring"12345"ДаИдентификатор продукта, который используется при добавлении позиции в заказе.
pricestring"490"Нет

Актуальная цена продукта.

old_pricestring"520"НетСтарая цена продукта.
currencystring"USD"Нет

Валюта, в которой указана цена продукта.

Валюты настраиваются в интерфейсе платформы: Маркет → Настройки → Другое. Если в запросе передать валюту, которая не задана в платформе, произойдет ошибка.


tagsarray
[
	"camera",
	"Canon"
]
НетСписок тегов.
manufacturer_namestring"Canon"НетНазвание производителя.
descriptionstring"Test description"Нет

Описание продукта.

Длина текста — не более 1000 символов.

urlstring"https://example.com"НетURL страницы продукта на сайте магазина.
picturesarray
[
	"https://example_1.com",
	"https://example_2.com"
]
Нет

Список URL-ссылок на изображения продукта.

countint60НетКоличество продуктов, доступное для продажи.
expiration_timestring"730"Нет

Срок годности или службы (в сутках).

is_availablebooltrueНет

Есть ли продукт в наличии у магазина.

deliverybooltrueНетВозможность курьерской доставки (по всем регионам, в которые доставляет магазин).
barcodearray
[
	5235235,
	347347,
	335578769
]
НетСписок штрихкодов продукта от производителя.
manufacturer_warrantybooltrueНет

Официальная гарантия производителя.

custom_fieldsobject
{
	"color": "black",
	"weight": 701,
	"dimensions": "105*141*77" 
}
Нет

Дополнительные поля продукта.

Подробнее

regional_dataarray
[
	{
		"external_id": "region_YnCrJj8Y1",
		"price": "36000",
		"old_price": "38500",
		"currency": "RUB",
		"custom_fields": {
			"color": "black",
			"weight": 701   
		},
		"count": 30,
		"is_available": true,
		"delivery": true
	}
]
Нет

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

external_id – это идентификатор региона. Создать регион и получить его идентификатор можно в интерфейсе платформы:  Маркет → Настройки.

categoriesarray
[
	"category_1",
	"category_2"
]
Нет

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

Подробнее

skuarray
[
	{
		"name": "Canon EOS 90D Body",
		"external_id": "12345678",
	}
]
Нет

Данные о SKU продукта.

Подробнее

JSON

[
      {
        "name": "iPhone",
        "external_id": "123456",
        "price": "500",
        "old_price": "400",
        "currency": "USD",
        "tags": [
          "one",
          "two"
        ],
        "manufacturer_name": "Apple",
        "description":"Test description",
        "url": "https://example.com",
        "pictures": [
          "https://example.com",
          "https://example.com"
        ],
        "count": 60,
        "expiration_time": "730",
        "is_available": true,
        "delivery": true,
        "barcode": [
          5235235,
          347347,
          335578769
        ],
        "manufacturer_warranty": false,
        "custom_fields": {
          "product_field_id_1": 123,
          "product_field_id_2": "data"
        },
        "regional_data": [
          {
            "external_id": "region_YnCrJj8Y1",
            "price": "864825",
            "old_price": "400",
            "currency": "USD",
            "custom_fields": {
              "product_field_id_1": 123,
              "product_field_id_2": "data"
            },
            "count": 30,
            "is_available": true,
            "delivery": true
          }
        ],
        "categories": [
          "category_1",
          "category_2"
        ],
        "sku": [
          {
            "name": "iPhone",
            "external_id": "12345678",
          }
        ]
      }
]
  • No labels