Product Full Create
Creates/updates product, variant, brand & categories where needed.\
Body
Required
-
additionalSuppliers
object Suppliers
Additional properties are allowed.
-
ageGroup
string AgeGroup assosciated with the product
-
brandName
string Required Name of the products brand
-
categoryName
string Required Category of product. Should be a relevant for segmentation
-
collection
string Collection that the product belongs to
-
color
string Required Color assosciated with the variant
-
costPrice
number CostPrice of the Variant
-
costPriceCurrency
string CostPriceCurrency of the Variant
-
customFields
string Any JSON object holding additional filter attributes
-
ean
string EAN of Variant
-
gender
string Gender assosciated with the product
-
id
integer -
info
object Any info / data needed by the integration (json)
Additional properties are allowed.
-
key
string Required Key used between products, transaction & stock tables. Usually SKU or EAN but needs to be same on all occurrences
-
leadTime
integer Lead Time of variant in months
-
moq
integer Minimum Order Quantity of variant
-
packsize
integer Packsize
-
price
number Sales Price of the Variant (Excl VAT)
-
priceCurrency
string Sales Price Currency of the Variant
-
priceIncludingVat
boolean If Price is including VAT or not
-
productGroupID
string Required ProductGroupID is used to group products together within Madden
-
productName
string Required Name of product
-
productType
number Type of product (1: Normal/standard, 2: Commission, 3: Local)
Values are
1
,2
, or3
. Default value is1
. -
season
string Season that the product belongs to
-
size
string Required Size assosciated with the variant
-
sku
string SKU of product. Should be unique per size/variant
-
skuSynonyms
array[string] List of sku synonyms that should point to this variant
-
status
number Status of the variant (1: Inactive, 2: Active, 3: Outgoing)
Values are
1
,2
,3
,4
,5
,6
, or7
. Default value is2
. -
subCategory
string Required Subcategory of product. Should be a relevant for segmentation
-
supplier
string Supplier of the Product
-
supplierPrice
number Price to produce
-
supplierPriceCurrency
string Currency to produce
-
unitVolume
number Unit volume of the product in meters (l*w*h) (CBM)
-
variantExternalID
string ID of variant in external platform
-
variantGroupID
string VariantGroupID is used to group variants
-
variantName
string Required Name of specific variant
-
vatValue
integer Vat Value is the percentage of VAT
-
vendorSKU
string Vendors SKU if using own sku structure
-
wholesalePrice
number Wholesale price of the Variant (Excl VAT)
-
wholesalePriceCurrency
string Currency Code of the Wholeale Price
-
year
string Start of the porducts life-cycle
curl \
--request POST 'https://api.maddenanalytics.com/v2/api/products' \
--data '{"additionalSuppliers":{},"ageGroup":"Senior","brandName":"Acme","categoryName":"Sneakers","collection":"SS21","color":"Black","costPrice":42,"costPriceCurrency":"USD","customFields":"{}","ean":"7340192703345","gender":"Unisex","id":42,"info":{},"key":"7340192703345","leadTime":3,"moq":300,"packsize":1,"price":42,"priceCurrency":"USD","priceIncludingVat":true,"productGroupID":"123456","productName":"Petter","productType":1,"season":"Spring/Summer","size":"43","sku":"123456-001-43","skuSynonyms":["string"],"status":2,"subCategory":"Low Sneakers","supplier":"string","supplierPrice":42,"supplierPriceCurrency":"string","unitVolume":42.0,"variantExternalID":"shopify_432345","variantGroupID":"123456-001","variantName":"Petter Black","vatValue":25,"vendorSKU":"9876543-001-43","wholesalePrice":42,"wholesalePriceCurrency":"USD","year":"2021"}'
{
"additionalSuppliers": {},
"ageGroup": "Senior",
"brandName": "Acme",
"categoryName": "Sneakers",
"collection": "SS21",
"color": "Black",
"costPrice": 42,
"costPriceCurrency": "USD",
"customFields": "{}",
"ean": "7340192703345",
"gender": "Unisex",
"id": 42,
"info": {},
"key": "7340192703345",
"leadTime": 3,
"moq": 300,
"packsize": 1,
"price": 42,
"priceCurrency": "USD",
"priceIncludingVat": true,
"productGroupID": "123456",
"productName": "Petter",
"productType": 1,
"season": "Spring/Summer",
"size": "43",
"sku": "123456-001-43",
"skuSynonyms": [
"string"
],
"status": 2,
"subCategory": "Low Sneakers",
"supplier": "string",
"supplierPrice": 42,
"supplierPriceCurrency": "string",
"unitVolume": 42.0,
"variantExternalID": "shopify_432345",
"variantGroupID": "123456-001",
"variantName": "Petter Black",
"vatValue": 25,
"vendorSKU": "9876543-001-43",
"wholesalePrice": 42,
"wholesalePriceCurrency": "USD",
"year": "2021"
}
[
{
"additionalSuppliers": {},
"ageGroup": "Senior",
"brandName": "Acme",
"categoryName": "Sneakers",
"collection": "SS21",
"color": "Black",
"costPrice": 42,
"costPriceCurrency": "USD",
"customFields": "{}",
"ean": "7340192703345",
"gender": "Unisex",
"id": 42,
"info": {},
"key": "7340192703345",
"leadTime": 3,
"moq": 300,
"packsize": 1,
"price": 42,
"priceCurrency": "USD",
"priceIncludingVat": true,
"productGroupID": "123456",
"productName": "Petter",
"productType": 1,
"season": "Spring/Summer",
"size": "43",
"sku": "123456-001-43",
"skuSynonyms": [
"string"
],
"status": 2,
"subCategory": "Low Sneakers",
"supplier": "string",
"supplierPrice": 42,
"supplierPriceCurrency": "string",
"unitVolume": 42.0,
"variantExternalID": "shopify_432345",
"variantGroupID": "123456-001",
"variantName": "Petter Black",
"vatValue": 25,
"vendorSKU": "9876543-001-43",
"wholesalePrice": 42,
"wholesalePriceCurrency": "USD",
"year": "2021"
}
]
{
"error": "Error Type (if any)",
"message": "Message describing the error",
"statusCode": 400
}