To insert a item price, it's necessary to make a POST call, passing a JSON body as specified below.

With this service you can specify the prices valid from a date for an item or an items that manage the grouping price

This web service is asynchronous, this means that the insert operations is enqueued.

After the prices have been inserted or an error has occured, the result can be sent to an optional callbackUrl specified in the request body

The web service response will be composed of:

success: Boolean that indicated wether the request was successful enqueued or not

message: Enqueued message or error message

invalidItems: In case of error contains the invalid item code (this is only a data validation, the real insert is asynchronous)

In case of success enqueud you will get this response:

{
    "success":true,
    "message":"operation_equeued"
}

In case of error you will get this response:

{
    "success":false,
    "message":"invalid_items",
    "invalidItems":["QA7MDNRD1-M80701x"]
}

possible errors are:

missing_params: missing mandatory params

invalid_price_list: invalid list code or type

invalid_items: invalid item code

missing_groupping: missing item groupping

invalid_start_date: invalid start date

invalid_item_price: invalid item price

_invalid_item_price__format: invalid item price format

internal_server_error: generic error

Example

{
  "priceList": "121_1",
  "priceListType": "SALE",
  "items": [
    {
      "itemCode": "QA7MDNRD1-M80701",
      "startDate": "2021-02-01",
      "price": 100.99
    },
    {
      "itemCode": "MAGLIA_BIMBA",
      "startDate": "2021-02-01",
      "priceGrouping": [
        {
          "dimensionGrouping": "BABY",
          "price": 50.99
        },
        {
          "dimensionGrouping": "KID",
          "price": 60
        },
        {
          "dimensionGrouping": "JUNIOR",
          "price": 70
        },
        {
          "dimensionGrouping": "TEEN",
          "price": 80
        }
      ]
    }
  ],
  "callbackUrl": "https://my.endpoint.com/insertPricesCallback"
}

Fields

Price list

Field	Description	Type	Mandatory
priceList	Price list code	String	✓
priceListType	Price list code	String	✓
items	Array of items prices to insert	array	✓

Items

Field	Description	Type	Mandatory
itemCode	item code	String	✓
startDate	price start date (yyyy-MM-dd)	Date	✓
price	price of item, mandatory if price grouping is disable	number
priceGrouping	array of price in case of price grouping	String

PriceGrouping

NB: If an item manages prices grouping, you will need to specify prices for all groups

Field	Description	Type	Mandatory
dimensionGrouping	dimension group code	String	✓
price	price of item group	number	✓

The field callbackUrl is optional, and if specified, a request to that URL will be made after the prices import has finished.

An example of the body passed for this request is

{
    "success": true,
    "message": "Prices correctly inserted"
}

Notes

There's a limit of 100 calls for this API.

Request

Query Params

Header Params

Body Params application/json

Example

{
    "priceList": "121_1",
    "priceListType": "SALE",
    "items": [
        {
            "itemCode": "QA7MDNRD1-M80701",
            "startDate": "2021-02-01",
            "price": "100"
        },
        {
            "itemCode": "MAGLIA_BIMBA",
            "startDate": "2021-02-01",
            "priceGrouping": [
                {
                    "dimensionGrouping": "BABY",
                    "price": "50"
                },
                {
                    "dimensionGrouping": "KID",
                    "price": "60"
                },
                {
                    "dimensionGrouping": "JUNIOR",
                    "price": "70"
                },
                {
                    "dimensionGrouping": "TEEN",
                    "price": "80"
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Add item price to price list

Example

Fields

Price list

Items

PriceGrouping

Request

Request Code Samples

Responses

Add item price to price list

Example#

Fields#

Price list#

Items#

PriceGrouping#

Request

Request Code Samples

Responses

Example

Fields

Price list

Items

PriceGrouping