Update Store Listing

PUT

/api/v2/channel_sellables/{id}

Update an existing store listing. Note that the channel_id field is silently ignored when updating.

Note: This endpoint is only permitted for channels with the type code custom_integration.

Request Body

object

sellable_id

ID of the existing sellable in Veeqo to link to.

number

remote_id

ID for this listing on the remote store.

string

remote_sku

SKU code for this listing as it appears on the remote store.

string

remote_price

Cost price of this listing on the remote store.

number

remote_barcode

Barcode (UPC code) of this listing as it appears on the remote store.

string

channel_id

ID of the store to link this listing to.

number

autolink

Whether to find and link to an existing sellable in Veeqo by SKU, or create a new product and product variant if none exist.

boolean

channel_product_attributes

The channel product to link this listing to.

object

remote_title

required

The title of the channel product. Can be omitted if relationships.channel_product.data.id is provided.

string

remote_description

Description of the channel product.

string

measurement_attributes

Dimensions of the product represented by this store listing.

object

width

number

height

number

depth

number

dimensions_unit

string

Allowed values: cm in mm

relationships

object

channel_product

object

data

object

id

ID of the channel product in Veeqo to link this store listing to.

number

type

channel_product

Example

{
  "data": {
    "id": "6789",
    "type": "channel_sellable",
    "attributes": {
      "sellable_id": 12345,
      "remote_id": "remote-123456",
      "remote_sku": "SKU123456",
      "remote_price": 19.99,
      "cost_price": 9.99,
      "remote_grams": 500,
      "remote_title": "Updated Product",
      "remote_barcode": "1234567890123",
      "autolink": false,
      "channel_product_attributes": {
        "remote_title": "Updated Product Title",
        "remote_description": "Updated Product Description"
      },
      "measurement_attributes": {
        "width": 10,
        "height": 15,
        "depth": 20,
        "dimensions_unit": "cm"
      }
    }
  }
}

Responses

200

The store listing was updated succesfully.

object

data

A listing on a remote store (aka channel sellable).

object

id

ID of the store listing in Veeqo.

number

attributes

object

remote_title

The title of this store listing.

string

remote_sku

The SKU code of this store listing as it appears on the remote store.

string

remote_price

The price of this listing as it appears on the remote store.

string

currency_code

The unit of currency of the remote_price.

string

remote_inventory_quantity

The number of units shown for sale on the remote store.

number

remote_id

The ID of store listing on the remote store.

number

active

Whether this listing is active on the remote store.

boolean

relationships

object

channel

object

data

object

id

ID of the channel this store listing is linked to.

string

type

channel

created_by

object

data

object

id

ID of the user who created this store listing.

string

type

user

updated_by

object

data

object

id

ID of the last user who updated this store listing.

string

type

user

product

object

data

object

id

ID of the product in Veeqo this store listing is linked to.

string

channel_product

object

data

object

id

ID of the channel product this listing is linked to.

string

type

channel_product

sellable

object

data

object

id

ID of the sellable this store listing is linked to in Veeqo.

string

type

sellable

Example

{
  "data": {
    "id": "6789",
    "type": "channel_sellable",
    "attributes": {
      "remote_title": "Updated Product",
      "remote_sku": "SKU123456",
      "remote_price": 19.99,
      "currency_code": "GBP",
      "remote_inventory_quantity": null,
      "active": true
    },
    "relationships": {
      "channel": {
        "data": {
          "id": "54321",
          "type": "channel"
        }
      },
      "created_by": {
        "data": {
          "id": "101",
          "type": "user"
        }
      },
      "updated_by": {
        "data": {
          "id": "101",
          "type": "user"
        }
      },
      "product": {
        "data": {
          "id": "2468",
          "type": "product"
        }
      },
      "channel_product": {
        "data": {
          "id": "9876",
          "type": "channel_product"
        }
      },
      "sellable": {
        "data": {
          "id": "12345",
          "type": "sellable"
        }
      },
      "remote_url": {
        "data": null
      }
    }
  }
}

404

Ensure the supplied IDs are correct.

Example

{
  "errors": [
    {
      "status": "404",
      "title": "Not found",
      "detail": "Couldn't find ChannelSellable with 'id'=6789"
    }
  ]
}

422

Unprocessable Entity. Ensure that all required fields have been supplied and are correct.

Example

{
  "errors": [
    {
      "source": {
        "pointer": "/data/attributes/measurement_attributes/dimensions_unit"
      },
      "detail": "dimensions_unit must be one of: 'cm', 'in', 'mm'",
      "status": "422"
    }
  ]
}