v1.0
Powered by

# 2. Create Products With Variants

Bulk Product Upload with Variants — Bulk create/update products with variants (parent + variant items), supporting warehouses and option groups. Processes as an asynchronous, batched job; track via requestId/batchId. Returns per-item results and a processing summary in the standard response envelope. Use for routine product ops; for post-onboarding full-catalog import, use Catalog With Variants Sync.

Overview

HMACASYNC
Auth
HMAC Partner
Method
POST

# Path

https://partners-api.tocobagus.net/api/v1 /partner/stores/products/with-variants/bulk

# Request

Query parameters: None.

# Required Headers

Header Example Description
x-signature bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80 HMAC signature of the request, computed with the partner secret and x-timestamp (auth integrity).
x-partner-client-id 2025112012475048491498 Partner identifier issued by Omni; used to locate the partner secret.
x-store-client-id 638765489981529612855 Target store identifier under the partner account.
x-store-token stkn__6AbJF05mjvxh7sh Store access token for store-level authorization.
x-timestamp 1758100350458 UNIX epoch timestamp used when computing x-signature (replay protection).

# Request Payload

Content-Type: application/json

# Example Body Payload 

{
  "products": [
    {
      "externalId": "946b3ffa-5f9e-412e-acf4-eea306736e64",
      "name": "Regular Fit Printed T-shirt",
      "description": "Comfortable cotton t-shirt, available in multiple colors.",
      "minOrder": 1,
      "subCategoryId": "0e882586-c506-4792-a831-02767a68dae2",
      "categoryId": "2fde2994-28a8-4d09-a128-6d744b9e1323",
      "typeId": "d86db295-41c3-423d-a2c2-a59724f38316",
      "hashtags": [
        "hnm",
        "regular-fit"
      ],
      "condition": "NEW",
      "photos": [
        "https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/d5cf4a4818cfafed5e91f22979dcbe2d79bd025e_xxl-1.jpg",
        "https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/cb3176cb876bdea34e2bf2e76332357a69c7daa9_xxl-1.jpg"
      ],
      "isPreorder": false,
      "preorderPeriod": 0,
      "isArchived": false,
      "insuranceRequired": true,
      "codEnabled": false,
      "variants": {
        "items": [
          {
            "price": 444000,
            "stock": 12,
            "isDefault": true,
            "status": "ACTIVE",
            "sku": "SKU-MRON-L2",
            "weight": 200,
            "photos": [
              "https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto"
            ],
            "optionIndexes": [
              0,
              0
            ],
            "sortOrder": 1
          },
          {
            "price": 444000,
            "stock": 101,
            "isDefault": false,
            "status": "ACTIVE",
            "sku": "SKU-GRY-XL2",
            "weight": 300,
            "photos": [
              "https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto"
            ],
            "optionIndexes": [
              0,
              1
            ],
            "sortOrder": 2
          }
        ],
        "optionGroups": [
          {
            "level": 1,
            "name": "Color",
            "values": [
              {
                "label": "Maroon"
              },
              {
                "label": "Grey"
              },
              {
                "label": "Black"
              }
            ]
          },
          {
            "level": 2,
            "name": "Size",
            "values": [
              {
                "label": "L"
              },
              {
                "label": "XL"
              }
            ]
          }
        ]
      }
    },
    {
      "externalId": "bace66be-47c4-4f72-868c-ad792da8b2a8",
      "name": "Ai Yazawa Short Sleeve UT",
      "description": "Comfortable cotton t-shirt, available in multiple colors.",
      "dimensions": {
        "length": 12,
        "width": 12,
        "height": 10
      },
      "minOrder": 1,
      "subCategoryId": "0e882586-c506-4792-a831-02767a68dae2",
      "categoryId": "2fde2994-28a8-4d09-a128-6d744b9e1323",
      "typeId": "d86db295-41c3-423d-a2c2-a59724f38316",
      "hashtags": [
        "uniqlo",
        "tshirt",
        "Yazawa",
        "japan",
        "Unisex"
      ],
      "condition": "NEW",
      "photos": [
        "https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369",
        "https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369"
      ],
      "isPreorder": false,
      "preorderPeriod": 0,
      "isArchived": false,
      "insuranceRequired": true,
      "codEnabled": false,
      "variants": {
        "items": [
          {
            "price": 444000,
            "isDefault": true,
            "status": "ACTIVE",
            "sku": "SKU-MRON-L3",
            "weight": 200,
            "photos": [
              "https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto"
            ],
            "optionIndexes": [
              0,
              0
            ],
            "sortOrder": 1,
            "warehouses": [
              {
                "clientId": "2026012714314318226016",
                "stock": 1
              }
            ]
          },
          {
            "price": 444000,
            "isDefault": false,
            "status": "ACTIVE",
            "sku": "SKU-GRY-XL3",
            "weight": 300,
            "photos": [
              "https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto"
            ],
            "optionIndexes": [
              0,
              1
            ],
            "sortOrder": 2,
            "warehouses": [
              {
                "clientId": "2026012714314318226016",
                "stock": 10
              }
            ]
          }
        ],
        "optionGroups": [
          {
            "level": 1,
            "name": "Color",
            "values": [
              {
                "label": "Maroon"
              },
              {
                "label": "Grey"
              },
              {
                "label": "Black"
              }
            ]
          },
          {
            "level": 2,
            "name": "Size",
            "values": [
              {
                "label": "L"
              },
              {
                "label": "XL"
              }
            ]
          }
        ]
      }
    }
  ]
}

# Example Request 

curl -X POST "http:///partner/stores/products/with-variants/bulk" \
  -H "Content-Type: application/json" \
  -H "x-signature: bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80" \
  -H "x-partner-client-id: 2025112012475048491498" \
  -H "x-store-client-id: 638765489981529612855" \
  -H "x-store-token: stkn__6AbJF05mjvxh7sh" \
  -H "x-timestamp: 1758100350458" \
  --data '{"products":[{"externalId":"946b3ffa-5f9e-412e-acf4-eea306736e64","name":"Regular Fit Printed T-shirt","description":"Comfortable cotton t-shirt, available in multiple colors.","minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["hnm","regular-fit"],"condition":"NEW","photos":["https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/d5cf4a4818cfafed5e91f22979dcbe2d79bd025e_xxl-1.jpg","https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/cb3176cb876bdea34e2bf2e76332357a69c7daa9_xxl-1.jpg"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false,"variants":{"items":[{"price":444000,"stock":12,"isDefault":true,"status":"ACTIVE","sku":"SKU-MRON-L2","weight":200,"photos":["https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto"],"optionIndexes":[0,0],"sortOrder":1},{"price":444000,"stock":101,"isDefault":false,"status":"ACTIVE","sku":"SKU-GRY-XL2","weight":300,"photos":["https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto"],"optionIndexes":[0,1],"sortOrder":2}],"optionGroups":[{"level":1,"name":"Color","values":[{"label":"Maroon"},{"label":"Grey"},{"label":"Black"}]},{"level":2,"name":"Size","values":[{"label":"L"},{"label":"XL"}]}]}},{"externalId":"bace66be-47c4-4f72-868c-ad792da8b2a8","name":"Ai Yazawa Short Sleeve UT","description":"Comfortable cotton t-shirt, available in multiple colors.","dimensions":{"length":12,"width":12,"height":10},"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["uniqlo","tshirt","Yazawa","japan","Unisex"],"condition":"NEW","photos":["https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false,"variants":{"items":[{"price":444000,"isDefault":true,"status":"ACTIVE","sku":"SKU-MRON-L3","weight":200,"photos":["https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto"],"optionIndexes":[0,0],"sortOrder":1,"warehouses":[{"clientId":"2026012714314318226016","stock":1}]},{"price":444000,"isDefault":false,"status":"ACTIVE","sku":"SKU-GRY-XL3","weight":300,"photos":["https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto"],"optionIndexes":[0,1],"sortOrder":2,"warehouses":[{"clientId":"2026012714314318226016","stock":10}]}],"optionGroups":[{"level":1,"name":"Color","values":[{"label":"Maroon"},{"label":"Grey"},{"label":"Black"}]},{"level":2,"name":"Size","values":[{"label":"L"},{"label":"XL"}]}]}}]}'
const qs = new URLSearchParams({});
const url = "http:///partner/stores/products/with-variants/bulk" + (qs.toString() ? "?" + qs.toString() : "");
const res = await fetch(url, {
  method: "POST",
  headers: {
  "x-signature": "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80",
  "x-partner-client-id": "2025112012475048491498",
  "x-store-client-id": "638765489981529612855",
  "x-store-token": "stkn__6AbJF05mjvxh7sh",
  "x-timestamp": "1758100350458"
},
  body: JSON.stringify({"products":[{"externalId":"946b3ffa-5f9e-412e-acf4-eea306736e64","name":"Regular Fit Printed T-shirt","description":"Comfortable cotton t-shirt, available in multiple colors.","minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["hnm","regular-fit"],"condition":"NEW","photos":["https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/d5cf4a4818cfafed5e91f22979dcbe2d79bd025e_xxl-1.jpg","https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/cb3176cb876bdea34e2bf2e76332357a69c7daa9_xxl-1.jpg"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false,"variants":{"items":[{"price":444000,"stock":12,"isDefault":true,"status":"ACTIVE","sku":"SKU-MRON-L2","weight":200,"photos":["https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto"],"optionIndexes":[0,0],"sortOrder":1},{"price":444000,"stock":101,"isDefault":false,"status":"ACTIVE","sku":"SKU-GRY-XL2","weight":300,"photos":["https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto"],"optionIndexes":[0,1],"sortOrder":2}],"optionGroups":[{"level":1,"name":"Color","values":[{"label":"Maroon"},{"label":"Grey"},{"label":"Black"}]},{"level":2,"name":"Size","values":[{"label":"L"},{"label":"XL"}]}]}},{"externalId":"bace66be-47c4-4f72-868c-ad792da8b2a8","name":"Ai Yazawa Short Sleeve UT","description":"Comfortable cotton t-shirt, available in multiple colors.","dimensions":{"length":12,"width":12,"height":10},"minOrder":1,"subCategoryId":"0e882586-c506-4792-a831-02767a68dae2","categoryId":"2fde2994-28a8-4d09-a128-6d744b9e1323","typeId":"d86db295-41c3-423d-a2c2-a59724f38316","hashtags":["uniqlo","tshirt","Yazawa","japan","Unisex"],"condition":"NEW","photos":["https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369","https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369"],"isPreorder":false,"preorderPeriod":0,"isArchived":false,"insuranceRequired":true,"codEnabled":false,"variants":{"items":[{"price":444000,"isDefault":true,"status":"ACTIVE","sku":"SKU-MRON-L3","weight":200,"photos":["https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto"],"optionIndexes":[0,0],"sortOrder":1,"warehouses":[{"clientId":"2026012714314318226016","stock":1}]},{"price":444000,"isDefault":false,"status":"ACTIVE","sku":"SKU-GRY-XL3","weight":300,"photos":["https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto"],"optionIndexes":[0,1],"sortOrder":2,"warehouses":[{"clientId":"2026012714314318226016","stock":10}]}],"optionGroups":[{"level":1,"name":"Color","values":[{"label":"Maroon"},{"label":"Grey"},{"label":"Black"}]},{"level":2,"name":"Size","values":[{"label":"L"},{"label":"XL"}]}]}}]})
});
const json = await res.json();
console.log(json);
qs := url.Values{}

u := "http:///partner/stores/products/with-variants/bulk"
if q := qs.Encode(); q != "" { u = u + "?" + q }
req, _ := http.NewRequest("POST", u, bytes.NewBufferString("{\"products\":[{\"externalId\":\"946b3ffa-5f9e-412e-acf4-eea306736e64\",\"name\":\"Regular Fit Printed T-shirt\",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"hnm\",\"regular-fit\"],\"condition\":\"NEW\",\"photos\":[\"https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/d5cf4a4818cfafed5e91f22979dcbe2d79bd025e_xxl-1.jpg\",\"https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/cb3176cb876bdea34e2bf2e76332357a69c7daa9_xxl-1.jpg\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false,\"variants\":{\"items\":[{\"price\":444000,\"stock\":12,\"isDefault\":true,\"status\":\"ACTIVE\",\"sku\":\"SKU-MRON-L2\",\"weight\":200,\"photos\":[\"https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto\"],\"optionIndexes\":[0,0],\"sortOrder\":1},{\"price\":444000,\"stock\":101,\"isDefault\":false,\"status\":\"ACTIVE\",\"sku\":\"SKU-GRY-XL2\",\"weight\":300,\"photos\":[\"https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto\"],\"optionIndexes\":[0,1],\"sortOrder\":2}],\"optionGroups\":[{\"level\":1,\"name\":\"Color\",\"values\":[{\"label\":\"Maroon\"},{\"label\":\"Grey\"},{\"label\":\"Black\"}]},{\"level\":2,\"name\":\"Size\",\"values\":[{\"label\":\"L\"},{\"label\":\"XL\"}]}]}},{\"externalId\":\"bace66be-47c4-4f72-868c-ad792da8b2a8\",\"name\":\"Ai Yazawa Short Sleeve UT\",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"uniqlo\",\"tshirt\",\"Yazawa\",\"japan\",\"Unisex\"],\"condition\":\"NEW\",\"photos\":[\"https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false,\"variants\":{\"items\":[{\"price\":444000,\"isDefault\":true,\"status\":\"ACTIVE\",\"sku\":\"SKU-MRON-L3\",\"weight\":200,\"photos\":[\"https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto\"],\"optionIndexes\":[0,0],\"sortOrder\":1,\"warehouses\":[{\"clientId\":\"2026012714314318226016\",\"stock\":1}]},{\"price\":444000,\"isDefault\":false,\"status\":\"ACTIVE\",\"sku\":\"SKU-GRY-XL3\",\"weight\":300,\"photos\":[\"https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto\"],\"optionIndexes\":[0,1],\"sortOrder\":2,\"warehouses\":[{\"clientId\":\"2026012714314318226016\",\"stock\":10}]}],\"optionGroups\":[{\"level\":1,\"name\":\"Color\",\"values\":[{\"label\":\"Maroon\"},{\"label\":\"Grey\"},{\"label\":\"Black\"}]},{\"level\":2,\"name\":\"Size\",\"values\":[{\"label\":\"L\"},{\"label\":\"XL\"}]}]}}]}"))
req.Header.Set("x-signature", "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80")
req.Header.Set("x-partner-client-id", "2025112012475048491498")
req.Header.Set("x-store-client-id", "638765489981529612855")
req.Header.Set("x-store-token", "stkn__6AbJF05mjvxh7sh")
req.Header.Set("x-timestamp", "1758100350458")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))
var client = java.net.http.HttpClient.newHttpClient();
var req = java.net.http.HttpRequest.newBuilder()
    .uri(java.net.URI.create("http:///partner/stores/products/with-variants/bulk"))
    .header("Content-Type","application/json")
    .header("x-signature", "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80")
    .header("x-partner-client-id", "2025112012475048491498")
    .header("x-store-client-id", "638765489981529612855")
    .header("x-store-token", "stkn__6AbJF05mjvxh7sh")
    .header("x-timestamp", "1758100350458")
    .method("POST", java.net.http.HttpRequest.BodyPublishers.ofString("{\"products\":[{\"externalId\":\"946b3ffa-5f9e-412e-acf4-eea306736e64\",\"name\":\"Regular Fit Printed T-shirt\",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"hnm\",\"regular-fit\"],\"condition\":\"NEW\",\"photos\":[\"https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/d5cf4a4818cfafed5e91f22979dcbe2d79bd025e_xxl-1.jpg\",\"https://d29c1z66frfv6c.cloudfront.net/pub/media/catalog/product/large/cb3176cb876bdea34e2bf2e76332357a69c7daa9_xxl-1.jpg\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false,\"variants\":{\"items\":[{\"price\":444000,\"stock\":12,\"isDefault\":true,\"status\":\"ACTIVE\",\"sku\":\"SKU-MRON-L2\",\"weight\":200,\"photos\":[\"https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto\"],\"optionIndexes\":[0,0],\"sortOrder\":1},{\"price\":444000,\"stock\":101,\"isDefault\":false,\"status\":\"ACTIVE\",\"sku\":\"SKU-GRY-XL2\",\"weight\":300,\"photos\":[\"https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto\"],\"optionIndexes\":[0,1],\"sortOrder\":2}],\"optionGroups\":[{\"level\":1,\"name\":\"Color\",\"values\":[{\"label\":\"Maroon\"},{\"label\":\"Grey\"},{\"label\":\"Black\"}]},{\"level\":2,\"name\":\"Size\",\"values\":[{\"label\":\"L\"},{\"label\":\"XL\"}]}]}},{\"externalId\":\"bace66be-47c4-4f72-868c-ad792da8b2a8\",\"name\":\"Ai Yazawa Short Sleeve UT\",\"description\":\"Comfortable cotton t-shirt, available in multiple colors.\",\"dimensions\":{\"length\":12,\"width\":12,\"height\":10},\"minOrder\":1,\"subCategoryId\":\"0e882586-c506-4792-a831-02767a68dae2\",\"categoryId\":\"2fde2994-28a8-4d09-a128-6d744b9e1323\",\"typeId\":\"d86db295-41c3-423d-a2c2-a59724f38316\",\"hashtags\":[\"uniqlo\",\"tshirt\",\"Yazawa\",\"japan\",\"Unisex\"],\"condition\":\"NEW\",\"photos\":[\"https://image.uniqlo.com/UQ/ST3/id/imagesgoods/480166/item/idgoods_00_480166_3x4.jpg?width=369\",\"https://image.uniqlo.com/UQ/ST3/AsianCommon/imagesgoods/480166/sub/goods_480166_sub14_3x4.jpg?width=369\"],\"isPreorder\":false,\"preorderPeriod\":0,\"isArchived\":false,\"insuranceRequired\":true,\"codEnabled\":false,\"variants\":{\"items\":[{\"price\":444000,\"isDefault\":true,\"status\":\"ACTIVE\",\"sku\":\"SKU-MRON-L3\",\"weight\":200,\"photos\":[\"https://static.pullandbear.net/assets/public/3001/922e/19f14781b122/23c526d5bd5d/03248921606-A20M/03248921606-A20M.jpg?ts=1743413691151&w=1082&f=auto\"],\"optionIndexes\":[0,0],\"sortOrder\":1,\"warehouses\":[{\"clientId\":\"2026012714314318226016\",\"stock\":1}]},{\"price\":444000,\"isDefault\":false,\"status\":\"ACTIVE\",\"sku\":\"SKU-GRY-XL3\",\"weight\":300,\"photos\":[\"https://static.pullandbear.net/assets/public/c019/a31d/4bea4e8b8db6/69962d7cd14d/03248921400-A20M/03248921400-A20M.jpg?ts=1743413694905&w=1082&f=auto\"],\"optionIndexes\":[0,1],\"sortOrder\":2,\"warehouses\":[{\"clientId\":\"2026012714314318226016\",\"stock\":10}]}],\"optionGroups\":[{\"level\":1,\"name\":\"Color\",\"values\":[{\"label\":\"Maroon\"},{\"label\":\"Grey\"},{\"label\":\"Black\"}]},{\"level\":2,\"name\":\"Size\",\"values\":[{\"label\":\"L\"},{\"label\":\"XL\"}]}]}}]}"))
    .build();
var res = client.send(req, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

# Responses

# Example Responses 

{
  "success": true,
  "message": "Products processed",
  "requestId": "1c714bfe-64c5-4b2d-b603-a61f014d70c4",
  "meta": {
    "timestamp": "2026-02-04T20:46:45.767Z",
    "durationMs": 47,
    "dispatch": true
  },
  "data": {
    "batchId": "pbv_4a60677f-f835-4168-9a8e-8e0f82aeddef",
    "summary": {
      "total": 2,
      "failed": 1,
      "pending": 1
    },
    "acceptedRows": [
      {
        "rowIndex": 0,
        "externalId": "946b3ffa-5f9e-412e-acf4-eea306736e64"
      }
    ],
    "errors": [
      {
        "code": "PRD_002",
        "message": "Product with this external ID already exists",
        "rowIndex": 0,
        "externalId": "bace66be-47c4-4f72-868c-ad792da8b2a8",
        "details": {
          "retryable": false
        }
      }
    ]
  }
}
{
  "success": false,
  "error": {
    "code": "AUTH_003",
    "message": "Expired or invalid timestamp",
    "details": {
      "timestamp": "2026-02-04T20:41:32.290Z",
      "hint": "Request timestamp must be within 300 seconds",
      "context": {
        "providedTimestamp": 1770237380408,
        "currentTime": 1770237692290,
        "ageSeconds": 311
      }
    }
  },
  "requestId": "a7adcb8d-4167-4615-97c6-b0f839609bb5"
}
{
  "success": false,
  "error": {
    "code": "AUTH_011",
    "message": "Partner ID not registered",
    "details": {
      "timestamp": "2026-02-04T20:40:56.539Z",
      "hint": "Partner not found",
      "context": {
        "partnerClientId": "ptnr_1s4UqMnO64"
      }
    }
  },
  "requestId": "5073cf35-2dc5-485b-94a1-72cdc7f4901d"
}
{
  "success": false,
  "error": {
    "code": "VAL_001",
    "message": "Validation failed",
    "details": {
      "timestamp": "2026-02-04T20:43:19.604Z",
      "hint": "Please check your request data and try again",
      "context": {
        "validationErrors": {
          "products": {
            "0": {
              "stock": "property stock should not exist"
            }
          }
        }
      }
    }
  },
  "requestId": "f12981b7-25ae-4abf-9841-f3c73593230d"
}

# Dictionary

None for this endpoint.

# Notes

None for this endpoint.

© Copyright 2026. Toco All rights reserved.