Batch Create Articles

POST

/v1/articles/{companyId}/{brandId}/batch-create

curl --request POST \
  --url https://api.dev.caspeco.net/api/am/v1/articles/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/batch-create \
  --header 'Content-Type: application/json' \
  --data '{ "items": [ { "categoryId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "externalId": "example", "name": "example", "description": "example", "customerFacingName": "example", "customerFacingDescription": "example", "prices": { "regular": { "inclVat": 1, "exclVat": 1 }, "takeAway": { "inclVat": 1, "exclVat": 1 }, "conference": { "inclVat": 1, "exclVat": 1 } }, "attributes": { "colorHexValue": "example", "allowDiscount": true, "allowPriceOverride": true, "salesUnit": "Piece", "keepStockBalance": true, "isLoyaltyContributing": true, "ageRestriction": 1, "nonSale": true } } ] }'

Creates up to 50 articles in a single all-or-nothing batch

Parameters

Path Parameters

companyId

required

string format: uuid

brandId

required

string format: uuid

Request Body

object

items

required

Array<object>

object

categoryId

required

string format: uuid

externalId

string

nullable

name

required

string

description

string

nullable

customerFacingName

string

nullable

customerFacingDescription

string

nullable

prices

object

regular

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

takeAway

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

conference

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

attributes

object

colorHexValue

string

nullable

allowDiscount

boolean

nullable

allowPriceOverride

boolean

nullable

salesUnit

string

Allowed values: Piece Kg Liter Centiliter

keepStockBalance

boolean

nullable

isLoyaltyContributing

boolean

nullable

ageRestriction

integer format: int32

nullable

nonSale

boolean

nullable

object

items

required

Array<object>

object

categoryId

required

string format: uuid

externalId

string

nullable

name

required

string

description

string

nullable

customerFacingName

string

nullable

customerFacingDescription

string

nullable

prices

object

regular

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

takeAway

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

conference

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

attributes

object

colorHexValue

string

nullable

allowDiscount

boolean

nullable

allowPriceOverride

boolean

nullable

salesUnit

string

Allowed values: Piece Kg Liter Centiliter

keepStockBalance

boolean

nullable

isLoyaltyContributing

boolean

nullable

ageRestriction

integer format: int32

nullable

nonSale

boolean

nullable

object

items

required

Array<object>

object

categoryId

required

string format: uuid

externalId

string

nullable

name

required

string

description

string

nullable

customerFacingName

string

nullable

customerFacingDescription

string

nullable

prices

object

regular

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

takeAway

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

conference

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

attributes

object

colorHexValue

string

nullable

allowDiscount

boolean

nullable

allowPriceOverride

boolean

nullable

salesUnit

string

Allowed values: Piece Kg Liter Centiliter

keepStockBalance

boolean

nullable

isLoyaltyContributing

boolean

nullable

ageRestriction

integer format: int32

nullable

nonSale

boolean

nullable

Responses

200

Returns created articles

object

items

required

Array<object>

object

articleId

required

string format: uuid

categoryId

required

string format: uuid

externalId

string

nullable

articleNumber

required

integer format: int64

categoryExternalId

string

nullable

name

required

string

nullable

description

required

string

nullable

customerFacingName

required

string

nullable

customerFacingDescription

required

string

nullable

publicationStatus

required

string

Allowed values: Draft Active Inactive

prices

required

object

priceSource

required

string

Allowed values: IncludingVat ExcludingVat

regular

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

takeAway

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

conference

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

images

required

object

imageIdOneByOneUrl

string

nullable

imageIdSixteenByNineUrl

string

nullable

attributes

required

object

color

object

name

required

string

hexValue

required

string

allowDiscount

boolean

nullable

allowPriceOverride

boolean

nullable

salesUnit

string

Allowed values: Piece Kg Liter Centiliter

keepStockBalance

boolean

nullable

isLoyaltyContributing

boolean

nullable

ageRestriction

integer format: int32

nullable

nonSale

boolean

nullable

object

items

required

Array<object>

object

articleId

required

string format: uuid

categoryId

required

string format: uuid

externalId

string

nullable

articleNumber

required

integer format: int64

categoryExternalId

string

nullable

name

required

string

nullable

description

required

string

nullable

customerFacingName

required

string

nullable

customerFacingDescription

required

string

nullable

publicationStatus

required

string

Allowed values: Draft Active Inactive

prices

required

object

priceSource

required

string

Allowed values: IncludingVat ExcludingVat

regular

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

takeAway

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

conference

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

images

required

object

imageIdOneByOneUrl

string

nullable

imageIdSixteenByNineUrl

string

nullable

attributes

required

object

color

object

name

required

string

hexValue

required

string

allowDiscount

boolean

nullable

allowPriceOverride

boolean

nullable

salesUnit

string

Allowed values: Piece Kg Liter Centiliter

keepStockBalance

boolean

nullable

isLoyaltyContributing

boolean

nullable

ageRestriction

integer format: int32

nullable

nonSale

boolean

nullable

Example

{
  "items": [
    {
      "publicationStatus": "Draft",
      "prices": {
        "priceSource": "IncludingVat"
      },
      "attributes": {
        "salesUnit": "Piece"
      }
    }
  ]
}

object

items

required

Array<object>

object

articleId

required

string format: uuid

categoryId

required

string format: uuid

externalId

string

nullable

articleNumber

required

integer format: int64

categoryExternalId

string

nullable

name

required

string

nullable

description

required

string

nullable

customerFacingName

required

string

nullable

customerFacingDescription

required

string

nullable

publicationStatus

required

string

Allowed values: Draft Active Inactive

prices

required

object

priceSource

required

string

Allowed values: IncludingVat ExcludingVat

regular

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

takeAway

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

conference

required

object

inclVat

number format: double

nullable

exclVat

number format: double

nullable

images

required

object

imageIdOneByOneUrl

string

nullable

imageIdSixteenByNineUrl

string

nullable

attributes

required

object

color

object

name

required

string

hexValue

required

string

allowDiscount

boolean

nullable

allowPriceOverride

boolean

nullable

salesUnit

string

Allowed values: Piece Kg Liter Centiliter

keepStockBalance

boolean

nullable

isLoyaltyContributing

boolean

nullable

ageRestriction

integer format: int32

nullable

nonSale

boolean

nullable

Example

{
  "items": [
    {
      "publicationStatus": "Draft",
      "prices": {
        "priceSource": "IncludingVat"
      },
      "attributes": {
        "salesUnit": "Piece"
      }
    }
  ]
}

400

Bad Request

object

statusCode

integer format: int32

message

string

validationErrors

Array<object>

nullable

object

field

required

string

errorId

required

string

entity

string

nullable

object

statusCode

integer format: int32

message

string

validationErrors

Array<object>

nullable

object

field

required

string

errorId

required

string

entity

string

nullable

Example^generated

{
  "statusCode": 1,
  "message": "example",
  "validationErrors": [
    {
      "field": "example",
      "errorId": "example"
    }
  ],
  "entity": "example"
}

object

statusCode

integer format: int32

message

string

validationErrors

Array<object>

nullable

object

field

required

string

errorId

required

string

entity

string

nullable

Example^generated

{
  "statusCode": 1,
  "message": "example",
  "validationErrors": [
    {
      "field": "example",
      "errorId": "example"
    }
  ],
  "entity": "example"
}

401

Unauthorized

403

Forbidden

500

Internal Server Error