Skip to main content
POST
/
articles
/
{sellerId}
/
validate
Validate payload
curl --request POST \
  --url https://api.quivo.co/articles/{sellerId}/validate \
  --header 'Content-Type: application/json' \
  --data '
{
  "sku": "<string>",
  "deletedAt": "2023-11-07T05:31:56Z",
  "alternativeSkus": [
    "<string>"
  ],
  "name": {
    "value": "<string>",
    "language": "DE"
  },
  "articleType": "PRODUCT",
  "barcode": "<string>",
  "supplierReferenceNumber": "<string>",
  "alternativeBarcodes": [
    "<string>"
  ],
  "grossWeight": {
    "value": 123,
    "unit": "KG"
  },
  "netWeight": {
    "value": 123,
    "unit": "KG"
  },
  "lotRequired": true,
  "expirationDateRequired": true,
  "serialNumberRequired": true,
  "canShipWithoutCarton": true,
  "length": {
    "value": 123,
    "unit": "M"
  },
  "width": {
    "value": 123,
    "unit": "M"
  },
  "height": {
    "value": 123,
    "unit": "M"
  },
  "customsContentDescription": "<string>",
  "countryOfOrigin": "AF",
  "salesPrice": {
    "currencyCode": "<string>",
    "value": 123
  },
  "insuranceValue": {
    "currencyCode": "<string>",
    "value": 123
  },
  "customsValue": {
    "currencyCode": "<string>",
    "value": 123
  },
  "unNumber": "<string>",
  "customAttributes": "{\"attr1\":\"val1\"}",
  "itemGroup": "<string>",
  "lottableBatchRequired": true,
  "alternativeNames": [
    {
      "value": "<string>",
      "language": "DE"
    }
  ],
  "tariffNumber": "<string>",
  "alternativeSalesPrices": [
    {
      "currencyCode": "<string>",
      "value": 123
    }
  ],
  "alternativeInsuranceValues": [
    {
      "currencyCode": "<string>",
      "value": 123
    }
  ],
  "alternativeCustomsValues": [
    {
      "currencyCode": "<string>",
      "value": 123
    }
  ],
  "packagingUnits": [
    {
      "type": "PALLET",
      "barcode": "<string>",
      "piecesPerPackagingUnit": 123,
      "grossWeight": {
        "value": 123,
        "unit": "KG"
      },
      "netWeight": {
        "value": 123,
        "unit": "KG"
      },
      "length": {
        "value": 123,
        "unit": "M"
      },
      "width": {
        "value": 123,
        "unit": "M"
      },
      "height": {
        "value": 123,
        "unit": "M"
      }
    }
  ],
  "lotNumberPriorities": {},
  "minimumQuantities": [
    {
      "warehouseId": 123,
      "quantity": 123,
      "calculationMode": "<string>"
    }
  ],
  "minimumExpirationDates": [
    {
      "notifyDaysBeforeExpiration": 2,
      "warehouseId": 123
    }
  ],
  "minimumShelfLives": [
    {
      "minimumShelfLife": 2,
      "warehouseId": 123
    }
  ],
  "dummyExpirationDate": "2023-11-07T05:31:56Z",
  "dummyLotNumber": "<string>"
}
'
{
  "sku": "<string>",
  "deletedAt": "2023-11-07T05:31:56Z",
  "alternativeSkus": [
    "<string>"
  ],
  "name": {
    "value": "<string>",
    "language": "DE"
  },
  "articleType": "PRODUCT",
  "barcode": "<string>",
  "supplierReferenceNumber": "<string>",
  "alternativeBarcodes": [
    "<string>"
  ],
  "grossWeight": {
    "value": 123,
    "unit": "KG"
  },
  "netWeight": {
    "value": 123,
    "unit": "KG"
  },
  "lotRequired": true,
  "expirationDateRequired": true,
  "serialNumberRequired": true,
  "canShipWithoutCarton": true,
  "length": {
    "value": 123,
    "unit": "M"
  },
  "width": {
    "value": 123,
    "unit": "M"
  },
  "height": {
    "value": 123,
    "unit": "M"
  },
  "customsContentDescription": "<string>",
  "countryOfOrigin": "AF",
  "salesPrice": {
    "currencyCode": "<string>",
    "value": 123
  },
  "insuranceValue": {
    "currencyCode": "<string>",
    "value": 123
  },
  "customsValue": {
    "currencyCode": "<string>",
    "value": 123
  },
  "unNumber": "<string>",
  "customAttributes": "{\"attr1\":\"val1\"}",
  "itemGroup": "<string>",
  "lottableBatchRequired": true,
  "alternativeNames": [
    {
      "value": "<string>",
      "language": "DE"
    }
  ],
  "tariffNumber": "<string>",
  "alternativeSalesPrices": [
    {
      "currencyCode": "<string>",
      "value": 123
    }
  ],
  "alternativeInsuranceValues": [
    {
      "currencyCode": "<string>",
      "value": 123
    }
  ],
  "alternativeCustomsValues": [
    {
      "currencyCode": "<string>",
      "value": 123
    }
  ],
  "packagingUnits": [
    {
      "type": "PALLET",
      "barcode": "<string>",
      "piecesPerPackagingUnit": 123,
      "grossWeight": {
        "value": 123,
        "unit": "KG"
      },
      "netWeight": {
        "value": 123,
        "unit": "KG"
      },
      "length": {
        "value": 123,
        "unit": "M"
      },
      "width": {
        "value": 123,
        "unit": "M"
      },
      "height": {
        "value": 123,
        "unit": "M"
      }
    }
  ],
  "lotNumberPriorities": {},
  "minimumQuantities": [
    {
      "warehouseId": 123,
      "quantity": 123,
      "calculationMode": "<string>"
    }
  ],
  "minimumExpirationDates": [
    {
      "notifyDaysBeforeExpiration": 2,
      "warehouseId": 123
    }
  ],
  "minimumShelfLives": [
    {
      "minimumShelfLife": 2,
      "warehouseId": 123
    }
  ],
  "dummyExpirationDate": "2023-11-07T05:31:56Z",
  "dummyLotNumber": "<string>",
  "id": 123,
  "created": "2023-11-07T05:31:56Z",
  "lastModified": "2023-11-07T05:31:56Z",
  "errors": [
    {
      "code": "<string>",
      "description": "<string>"
    }
  ],
  "warnings": [
    {
      "code": "<string>",
      "description": "<string>"
    }
  ],
  "sellerId": 123,
  "articleIdentifier": "<string>",
  "images": [
    {
      "source": "<string>",
      "id": "<string>",
      "url": {
        "link": "<string>"
      },
      "packagingUnit": {
        "type": "PALLET",
        "barcode": "<string>",
        "piecesPerPackagingUnit": 123,
        "grossWeight": {
          "value": 123,
          "unit": "KG"
        },
        "netWeight": {
          "value": 123,
          "unit": "KG"
        },
        "length": {
          "value": 123,
          "unit": "M"
        },
        "width": {
          "value": 123,
          "unit": "M"
        },
        "height": {
          "value": 123,
          "unit": "M"
        }
      }
    }
  ],
  "lengthM": 123,
  "widthM": 123,
  "heightM": 123,
  "grossWeightKG": 123,
  "netWeightKG": 123,
  "tags": [
    "<string>"
  ]
}

Path Parameters

​
sellerId
integer<int64>
required

The unique identifier for the seller account. This ID is used to scope operations to a specific seller's data and resources.

Body

application/json

Data to validate for /articles/{sellerId}/validate

Request payload for creating a new article (product/SKU) for a seller. Contains product details including identifiers, descriptions, dimensions, weight, and pricing information.

​
sku
string
required

Stock Keeping Unit (SKU) identifier

Required string length: 1 - 50
​
deletedAt
string<date-time>

The deleted at timestamp

​
alternativeSkus
string[]

Stock Keeping Unit (SKU) identifier

​
name
object

Detailed information for stringi18n

​
articleType
enum<string>

The type or category of the article

Available options:
PRODUCT,
CARTON
​
barcode
string

Code or identifier

Maximum string length: 50
​
supplierReferenceNumber
string

Reference number or identifier for the supplier number

Maximum string length: 20
​
alternativeBarcodes
string[]

Code or identifier

​
grossWeight
object

Detailed information for weight

​
netWeight
object

Detailed information for weight

​
lotRequired
boolean

Indicates whether lot is required

​
expirationDateRequired
boolean

The expiration date required date

​
serialNumberRequired
boolean

Indicates whether serial number is required

​
canShipWithoutCarton
boolean

Boolean flag indicating can ship without carton

​
length
object

Detailed information for lengthmeasurement

​
width
object

Detailed information for lengthmeasurement

​
height
object

Detailed information for lengthmeasurement

​
customsContentDescription
string

Description text

​
countryOfOrigin
enum<string>

Country code or name

Available options:
AF,
AX,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
KH,
CM,
CA,
CV,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CY,
CZ,
DK,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IM,
IL,
IT,
JM,
JP,
JE,
JO,
KZ,
KE,
KI,
KP,
KR,
XK,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MK,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RE,
RO,
RU,
RW,
BL,
SH,
KN,
LC,
MF,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SG,
SK,
SI,
SB,
SO,
ZA,
GS,
ES,
LK,
SD,
SR,
SJ,
CW,
BQ,
SX,
SZ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
GB,
US,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW
​
salesPrice
object

Detailed information for monetaryvalue

​
insuranceValue
object

Detailed information for monetaryvalue

​
customsValue
object

Detailed information for monetaryvalue

​
unNumber
string

Number value

​
customAttributes
object

Optional value for custom attributes of article.

Example:

"{\"attr1\":\"val1\"}"

​
itemGroup
string

The item group

​
lottableBatchRequired
boolean

Indicates whether lottable batch is required

​
alternativeNames
object[]

The name of the alternative s

​
tariffNumber
string

Number value

Maximum string length: 20
​
alternativeSalesPrices
object[]

Price value

​
alternativeInsuranceValues
object[]

The alternative insurance values value

​
alternativeCustomsValues
object[]

The alternative customs values value

​
packagingUnits
object[]

Array of packaging unit

​
lotNumberPriorities
object

Number value

​
minimumQuantities
object[]

Array of minimum quantitie

​
minimumExpirationDates
object[]

The minimum expiration dates date

​
minimumShelfLives
object[]

Array of minimum shelf live

​
dummyExpirationDate
string<date-time>

The dummy expiration date date

​
dummyLotNumber
string

Number value

Response

Returns the newly created article (product/SKU) with assigned identifier and full product details.

Detailed article (product/SKU) information returned from API responses. Contains complete product details including identifiers, descriptions, dimensions, weight, pricing, images, and configuration settings.

​
sku
string
required

Stock Keeping Unit (SKU) identifier

Required string length: 1 - 50
​
deletedAt
string<date-time>

The deleted at timestamp

​
alternativeSkus
string[]

Stock Keeping Unit (SKU) identifier

​
name
object

Detailed information for stringi18n

​
articleType
enum<string>

The type or category of the article (product).

Available options:
PRODUCT,
CARTON
​
barcode
string

Code or identifier

Maximum string length: 50
​
supplierReferenceNumber
string

Reference number provided by the supplier for this article.

Maximum string length: 20
​
alternativeBarcodes
string[]

Code or identifier

​
grossWeight
object

Detailed information for weight

​
netWeight
object

Detailed information for weight

​
lotRequired
boolean

Indicates whether lot is required

​
expirationDateRequired
boolean

Indicates whether an expiration date is required for this article.

​
serialNumberRequired
boolean

Indicates whether serial number is required

​
canShipWithoutCarton
boolean

Boolean flag indicating can ship without carton

​
length
object

Detailed information for lengthmeasurement

​
width
object

Detailed information for lengthmeasurement

​
height
object

Detailed information for lengthmeasurement

​
customsContentDescription
string

Description text

​
countryOfOrigin
enum<string>

Country code or name

Available options:
AF,
AX,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
KH,
CM,
CA,
CV,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CY,
CZ,
DK,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IM,
IL,
IT,
JM,
JP,
JE,
JO,
KZ,
KE,
KI,
KP,
KR,
XK,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MK,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RE,
RO,
RU,
RW,
BL,
SH,
KN,
LC,
MF,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SG,
SK,
SI,
SB,
SO,
ZA,
GS,
ES,
LK,
SD,
SR,
SJ,
CW,
BQ,
SX,
SZ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
GB,
US,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW
​
salesPrice
object

Detailed information for monetaryvalue

​
insuranceValue
object

Detailed information for monetaryvalue

​
customsValue
object

Detailed information for monetaryvalue

​
unNumber
string

Number value

​
customAttributes
object

Optional value for custom attributes of article.

Example:

"{\"attr1\":\"val1\"}"

​
itemGroup
string

The item group

​
lottableBatchRequired
boolean

Indicates whether lottable batch is required

​
alternativeNames
object[]

The name of the alternative s

​
tariffNumber
string

Number value

Maximum string length: 20
​
alternativeSalesPrices
object[]

Price value

​
alternativeInsuranceValues
object[]

Alternative insurance values for customs declaration.

​
alternativeCustomsValues
object[]

Alternative customs values for declaration purposes.

​
packagingUnits
object[]

Array of packaging unit

​
lotNumberPriorities
object

Number value

​
minimumQuantities
object[]

Array of minimum quantitie

​
minimumExpirationDates
object[]

Minimum expiration dates required for this article.

​
minimumShelfLives
object[]

Array of minimum shelf live

​
dummyExpirationDate
string<date-time>

Placeholder expiration date used when actual date is not available.

​
dummyLotNumber
string

Number value

​
id
integer<int64>

The unique identifier for the article.

​
created
string<date-time>

Timestamp when the item was created

​
lastModified
string<date-time>

Timestamp when the item was last modified

​
errors
object[]

Error information

​
warnings
object[]

Array of warning messages or validation issues for this article.

​
sellerId
integer<int64>

The unique identifier for the seller

​
articleIdentifier
string

The unique identifier for the articleentifier

​
images
object[]

Image reference

​
lengthM
number

Length measurement

​
widthM
number

Width measurement

​
heightM
number

Height measurement

​
grossWeightKG
number

Weight value

​
netWeightKG
number

Weight value

​
tags
string[]

Tags or labels