Я могу с помощью API объединить разные размеры или цвета товара из категории «Одежда» и «Обувь» в одной карточке? Kaspi Гид

Kaspi Pay/Kaspi Гид для Партнеров/Магазин на Kaspi.kz/API/Товары

API

Да. Есть несколько способов сделать это:

Manufacturer code

Укажите одинаковый Manufacturer code у всех товаров одной и той же модели;

Поле «familyId» оставьте пустым.

При последующих загрузках с тем же manufacturer code новые размеры или цвета будут добавлены в ранее созданные карточки.

Пример запроса
POST /shop/api/products/import HTTP/1.1
Host: kaspi.kz
Accept: application/json
X-Auth-Token: token
Content-Type: text/plain

//body

[
{
"sku": "Testsku",
"title": "test",
"brand": "brand",
"category": "Master - Girl knee boots",
"description": "Some description",
"attributes": [
   {
    "code": "Shoes*Model",
    "value": "валенки"
   },
   {
    "code": "Shoes*Gender",
    "value": "для девочек"
   },
   {
    "code": "Shoes*Material",
    "value": "войлок"
   },
   {
    "code": "Shoes*Lining material",
    "value": "шерстяной мех"
   },
   {
    "code": "Shoes*Sole material",
    "value": "полиуретан"
   },
   {
    "code": "Shoes*Shoes sole",
    "value": "анатомическая"
   },
   {
    "code": "Shoes*Season",
    "value": "зима"
   },
   {
    "code": "Shoes*Country",
    "value": "Россия"
   },
   {
    "code": "Shoes*Style",
    "value": "повседневный"
   },
   {
    "code": "Shoes*Clasp",
    "value": "липучка"
   },
   {
    "code": "Shoes*Platform",
    "value": false
   },
   {
    "code": "Shoes*Manufacturer code",
    "value": "abcd123"
   },
   {
    "code": "Shoes*Size features",
    "value": "размер в размер"
   },
   {
    "code": "Shoes*Collection1",
    "value": "Осень-Зима 2025"
   },
   {
    "code": "Shoes*Colour",
    "value": "бежевый"
   },
   {
    "code": "Shoes*Size",
    "value": "25"
   },
   {
    "code": "Shoes*Manufacturer size",
    "value": "25"
   }
],
    "images": [
      {
    "url": "https://resources.cdn-kaspi.kz/img/m/p/h44/h88/63854412398622.jpg"
   }
]
},
{
"sku": "Testsku2",
"title": "test",
"brand": "brand",
"category": "Master - Girl knee boots",
"description": "Some description",
"attributes": [
   {
    "code": "Shoes*Model",
    "value": "валенки"
   },
   {
    "code": "Shoes*Gender",
    "value": "для девочек"
   },
   {
    "code": "Shoes*Material",
    "value": "войлок"
   },
   {
    "code": "Shoes*Lining material",
    "value": "шерстяной мех"
   },
   {
    "code": "Shoes*Sole material",
    "value": "полиуретан"
   },
   {
    "code": "Shoes*Shoes sole",
    "value": "анатомическая"
   },
   {
    "code": "Shoes*Season",
    "value": "зима"
   },
   {
    "code": "Shoes*Country",
    "value": "Россия"
   },
   {
    "code": "Shoes*Style",
    "value": "повседневный"
   },
   {
    "code": "Shoes*Clasp",
    "value": "липучка"
   },
   {
    "code": "Shoes*Platform",
    "value": false
   },
   {
    "code": "Shoes*Manufacturer code",
    "value": "abcd123"
   },
   {
    "code": "Shoes*Size features",
    "value": "размер в размер"
   },
   {
    "code": "Shoes*Collection1",
    "value": "Осень-Зима 2025"
   },
   {
    "code": "Shoes*Colour",
    "value": "бежевый"
   },
   {
    "code": "Shoes*Size",
    "value": "26"
   },
   {
    "code": "Shoes*Manufacturer size",
    "value": "26"
   }
],
   "images": [
   {
    "url": "https://resources.cdn-kaspi.kz/img/m/p/h44/h88/63854412398622.jpg"
     }
    ]
}
]

Пример ответа
{
    "code": "testproduct",
    "status": "UPLOADED"
}

FamilyId

Можете использовать, если артикулы производителя — manufacturer code различаются у одной модели в зависимости от размера или цвета.

Укажите любое одинаковое сочетание букв и цифр в поле «familyId» для всех товаров одной модели до attributes и после description. Например: AA123, bcd, 789.

Пример запроса
POST /shop/api/products/import HTTP/1.1
Host: kaspi.kz
Accept: application/json
X-Auth-Token: token
Content-Type: text/plain

//body

[
{
"sku": "Testsku",
"title": "test",
"brand": "brand",
"category": "Master - Girl swimsuits",
"description": "Some description",
"familyId": "AA123",
"attributes": [
   {
    "code": "Girl swimsuits*Type",
    "value": "раздельный купальник"
   },
   {
    "code": "Girl swimsuits*Purpose",
    "value": "пляжный"
   },
   {
    "code": "Girl swimsuits*Manufacturer size",
    "value": "104"
   },
   {
    "code": "Girl swimsuits*Bra straps",
    "value": "нерегулируемые"
   },
   {
    "code": "Girl swimsuits*Cups",
    "value": "без подклада"
   },
   {
    "code": "Girl swimsuits*Clasp",
    "value": "без застежки"
   },
   {
    "code": "Girl swimsuits*Collection",
    "value": "Весна-Лето 2025"
   },
   {
    "code": "Girl swimsuits*Fabric",
    "value": "полиэстер"
   },
   {
    "code": "Girl swimsuits*Ornament",
    "value": "однотонный"
   },
   {
    "code": "Girl swimsuits*Notice1",
    "value": "товар обмену и возврату не подлежит"
   },
   {
    "code": "Clothes*Size",
    "value": "104"
   },
   {
    "code": "Clothes*Colour",
    "value": "розовый"
   },
   {
    "code": "Clothes*Manufacturer code",
    "value": "Manufacturer code"
   },
   {
    "code": "Clothes*Collection",
    "value": "Весна-Лето 2025"
   }
],
"images": [
      {
    "url": "https://resources.cdn-kaspi.kz/img/m/p/h44/h88/63854412398622.jpg"
   }
]
},
{
"sku": "Testsku2",
"title": "test",
"brand": "brand",
"category": "Master - Girl swimsuits",
"description": "Some description",
"familyId": "AA123",
"attributes": [
   {
    "code": "Girl swimsuits*Type",
    "value": "раздельный купальник"
   },
   {
    "code": "Girl swimsuits*Purpose",
    "value": "пляжный"
   },
   {
    "code": "Girl swimsuits*Manufacturer size",
    "value": "128"
   },
   {
    "code": "Girl swimsuits*Bra straps",
    "value": "нерегулируемые"
   },
   {
    "code": "Girl swimsuits*Cups",
    "value": "без подклада"
   },
   {
    "code": "Girl swimsuits*Clasp",
    "value": "без застежки"
   },
   {
    "code": "Girl swimsuits*Collection",
    "value": "Весна-Лето 2025"
   },
   {
    "code": "Girl swimsuits*Fabric",
    "value": "полиэстер"
   },
   {
    "code": "Girl swimsuits*Ornament",
    "value": "однотонный"
   },
   {
    "code": "Girl swimsuits*Notice1",
    "value": "товар обмену и возврату не подлежит"
   },
   {
    "code": "Clothes*Size",
    "value": "128"
   },
   {
    "code": "Clothes*Colour",
    "value": "розовый"
   },
   {
    "code": "Clothes*Manufacturer code",
    "value": "Manufacturer code"
   },
{
    "code": "Clothes*Collection",
    "value": "Весна-Лето 2025"
   }
],
"images": [
   {
    "url": "https://resources.cdn-kaspi.kz/img/m/p/h44/h88/63854412398622.jpg"
     }
    ]
}
]

Пример ответа
{
    "code": "testproduct",
    "status": "UPLOADED"
}

Обратите внимание: способ работает только в рамках одной загрузки.
Обновлен 20.03.2026
100% считают ответ полезным
Ответ был полезным?