API Reference
joor.com

Update SKUs

Update SKU data for your products. We map all combinations of color and size. For example, if you send Color:Blue|Size:Small and Color:Red|Size:Medium, we will create 4 SKUs for:

  • Color:Blue | Size:Small
  • Color:Blue | Size:Medium
  • Color:Red | Size:Small
  • Color:Red | Size:Medium

👍

Endpoint

Params

  • Accept: application/json
  • Authorization: OAuth2 [Base64 encoded token]

Sample cURL Request

curl -X POST "https://api.jooraccess.com/v4/skus/bulk_update" -H  "accept: application/json" -H  "Content-Type: application/json" -d "[{\"id\":\"string\",\"external_id\":\"string\",\"sku_identifier\":\"string\",\"trait_values\":[{\"trait_id\":\"string\",\"value\":\"string\",\"external_id\":\"string\",\"order_minimum\":0,\"status\":\"string\"}],\"identifiers\":[{\"type\":\"string\",\"value\":\"string\"}]}]"

Workflow

  1. Fetch a list of SKU ids using the GET /skus endpoint
  2. Reference the id of the SKU you want to update

SKU Data

PARAMETERSREQUIREDTYPENOTES
idYstring
external_idNstring
sku_identifierNstring

SKU Trait Data

Insert id U0tVVHJhaXQ6U3R5bGVDb2xvcg== for trait type Color
Insert id U0tVVHJhaXQ6U2l6ZQ== for trait type Size

When the SKU is created, we set to status:ACTIVE by default. This means that it will be displayed and shoppable on a collection.

PARAMETERSREQUIREDTYPENOTES
trait_idYstring
valueYstring
external_idNstring
order_minimumNinteger
statusNstring

SKU Identifier Data

PARAMETERSREQUIREDTYPENOTES
typeNstring
valueNstring

Request Example

[
  {
    "id": "555555",
    "external_id": "444444",
    "sku_identifier": "333333",
    "trait_values": [
      {
        "trait_id": "U0tVVHJhaXQ6U3R5bGVDb2xvcg==",
        "value": "Green",
        "external_id": "GRN",
        "order_minimum": 0,
        "status": "ACTIVE"
      },
      {
        "trait_id": "U0tVVHJhaXQ6U2l6ZQ==",
        "value": "Large",
        "external_id": "LRG",
        "order_minimum": 0,
        "status": "ACTIVE"
      }
    ],
    "identifiers": [
      {
        "type": "UPC",
        "value": "666666"
      }
    ]
  }
]

Response Example

{
  "data": [
    {
      "id": "555555",
      "product_id": "111111",
      "identifiers": [
        {
          "type": "UPC",
          "value": "666666"
        }
      ],
      "trait_values": [
        {
          "trait": {
            "id": "U0tVVHJhaXQ6U3R5bGVDb2xvcg==",
            "name": "Color"
          },
          "value": "Green",
          "external_id": "GRN",
          "order_minimum": 0,
          "status": "ACTIVE"
        },
        {
          "trait": {
            "id": "U0tVVHJhaXQ6U2l6ZQ==",
            "name": "Size"
          },
          "value": "Large",
          "external_id": "LRG",
          "order_minimum": 0,
          "status": "ACTIVE"
        }
      ],
      "external_id": "444444",
      "sku_identifier": "333333"
    }
  ],
  "errors": []
}