POST /v2/api/products/keyswitch

This endpoint is used to switch the key of an existing product and place the old one as a sku synonym

application/json

Body Required

  • ean string

    EAN of Variant

  • info object

    Any info / data needed by the integration (json)

  • key string Required

    Updated Key. Usually SKU or EAN but needs to be same on all occurrences

  • oldKey string Required

    Key to update, transaction & stock tables. Usually SKU or EAN but needs to be same on all occurrences

  • productGroupID string

    Optional ProductGroupID is used to group products together within Madden

  • season string

    Season that the product belongs to

  • sku string Required

    Updated SKU

  • variantGroupID string

    Optional VariantGroupID is used to group variants

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • message string
    • reference string
    • referenceField string
    • statusCode integer
  • default application/json

    All errors will return the same object with a describing code & message

    Hide response attributes Show response attributes object
    • error string
    • message string
    • statusCode integer
POST /v2/api/products/keyswitch
curl \
 --request POST 'https://api.maddenanalytics.com/v2/api/products/keyswitch' \
 --header "Content-Type: application/json" \
 --data '[{"ean":"7340192703345","info":{},"key":"7340192703345","oldKey":"7340192703345_old","productGroupID":"123456","season":"Spring/Summer","sku":"123456-001-43","variantGroupID":"123456-001"}]'
Request examples
[
  {
    "ean": "7340192703345",
    "info": {},
    "key": "7340192703345",
    "oldKey": "7340192703345_old",
    "productGroupID": "123456",
    "season": "Spring/Summer",
    "sku": "123456-001-43",
    "variantGroupID": "123456-001"
  }
]
Response examples (200)
[
  {
    "message": "Missing BrandName",
    "reference": "123456-001-43",
    "referenceField": "key",
    "statusCode": 400
  }
]
Response examples (default)
{
  "error": "Error Type (if any)",
  "message": "Message describing the error",
  "statusCode": 400
}