แก้ไขผลิตภัณฑ์#

อัปเดตสินค้าหนึ่งรายการแบบซิงโครนัส ระบุสินค้าด้วย productId หรือ sku พร้อมกับ shopId โดยต้องระบุตัวระบุเพียงหนึ่งรายการ คำขอที่ระบุทั้งสองรายการหรือไม่ระบุทั้งคู่จะได้รับ 400 Bad Request

http

PATCH https://sdkapi.ideal.house/product-import/products

ตัวระบุแยกจากออบเจ็กต์ product ทำให้ระบบที่เชื่อมต่อสามารถค้นหาสินค้าด้วย SKU ปัจจุบันและเปลี่ยน SKU ได้ในคำขอเดียวกัน

ใช้ productId เป็นตัวระบุเมื่อเปลี่ยน SKU การดำเนินการนี้จะทำให้การลองใหม่ไม่คลุมเครือหากคำขอแรกอัปเดต SKU แต่การตอบกลับหายไป

เนื้อหาคำขอ#

ฟิลด์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
`shopId`	string	ใช่	รหัสร้านค้าให้มาโดย Ideal House (Shop ID)
`productId`	string	มีเงื่อนไข	ID ของสินค้าที่ต้องการค้นหา จำเป็นเมื่อไม่ได้ระบุ `sku`
`sku`	string	มีเงื่อนไข	SKU ปัจจุบันของสินค้าที่ต้องการค้นหา จำเป็นเมื่อไม่ได้ระบุ `productId`
`product`	object	ใช่	ฟิลด์ที่จะอัปเดต รวมอย่างน้อยหนึ่งช่อง

ฟิลด์ผลิตภัณฑ์ที่สามารถแก้ไขได้#

ระบบจะอัปเดตเฉพาะฟิลด์ที่ระบุใน product เท่านั้น

ฟิลด์	ชนิดข้อมูล	ความยาวสูงสุด	คำอธิบาย
`sku`	string	120	SKU ใหม่ จะต้องคงความเป็นเอกลักษณ์เฉพาะภายในร้าน
`externalProductId`	string	120	ตัวระบุผลิตภัณฑ์ภายนอก
`groupId`	string	120	ตัวระบุกลุ่มผลิตภัณฑ์
`collectionId`	string	120	ตัวระบุคอลเลกชันสินค้า
`name`	string	255	ชื่อสินค้า.
`title`	string	255	ชื่อที่แสดงผลิตภัณฑ์
`brand`	string	120	แบรนด์สินค้า.
`productType`	string	120	ประเภทสินค้าในระบบการจัดหมวดหมู่ของคุณ
`normalizedProductType`	string	40	ประเภทสินค้าที่ปรับเป็นมาตรฐาน ประสานค่าที่รองรับกับ Ideal House
`category`	string	120	หมวดหมู่สินค้า.
`style`	string	120	ลักษณะสินค้า.
`color`	string	120	สีสินค้า.
`availability`	string	40	ค่าที่ระบุความพร้อมจำหน่ายของสินค้า
`imageUrl`	string	1,000	URL รูปภาพแหล่งที่มา HTTP หรือ HTTPS สาธารณะ
`previewImageUrl`	string	1,000	URL รูปภาพตัวอย่าง HTTP หรือ HTTPS
`productUrl`	string	1,000	URL รายละเอียดผลิตภัณฑ์ HTTP หรือ HTTPS
`attributes`	object	—	คุณลักษณะของผลิตภัณฑ์ เมื่อระบุ วัตถุนี้จะแทนที่วัตถุแอตทริบิวต์ปัจจุบัน
`status`	string	—	สถานะสินค้า เอนด์พอยต์อัปเดตรองรับค่า `active` หรือ `inactive`

ฟิลด์ต่อไปนี้อ่านได้อย่างเดียว: id, shopId, productCode, createdAt และ updatedAt ให้ใช้เอนด์พอยต์ลบเพื่อตั้งสถานะสินค้าเป็น invalid

แก้ไขโดย SKU#

json

{
  "shopId": "shop_123",
  "sku": "SKU-10001",
  "product": {
    "name": "Large Gold Wall Mirror",
    "color": "Antique Gold",
    "status": "active"
  }
}

bash

curl --request PATCH \
  'https://sdkapi.ideal.house/product-import/products' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>' \
  --data-raw '{
    "shopId": "shop_123",
    "sku": "SKU-10001",
    "product": {
      "name": "Large Gold Wall Mirror",
      "color": "Antique Gold",
      "status": "active"
    }
  }'

แก้ไขด้วยรหัสผลิตภัณฑ์และเปลี่ยน SKU#

json

{
  "shopId": "shop_123",
  "productId": "product_123",
  "product": {
    "sku": "SKU-10001-NEW",
    "name": "Large Gold Wall Mirror",
    "status": "inactive"
  }
}

การอัปเดตที่สำเร็จจะส่งคืน 200 OK พร้อมออบเจ็กต์สินค้าที่อัปเดตครบทั้งออบเจ็กต์ สินค้าที่เป็น inactive จะยังถูกเก็บไว้และเรียกดูได้ผ่านเอนด์พอยต์รายการสินค้า