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% жауапты пайдалы деді
Жауап пайдалы болды ма?