Get Stock Date

To retrieve an article stock, it's necessary to make a POST call, passing a JSON body as specified below.

The web service response will be composed of:

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

code : HTTP Code for the response

200 means the request was correctly processed

204 means a duplicate record was found in KeepIT, and that no insertion was performed

206 means that not all records were inserted or processed

400 means that the request body is invalid or contains syntax errors

500 means a server error has happened

stocks : is an array containing all the stock information for each shop. Each array entry is composed as follows:

entityCode : shop code

barcode : barcode of the searched article

item : item code of the searched article

description : article description

dim1 : type of 1st dimension (e.g. SIZE)

codDim1 : code of 1st dimension (ex. 1)

desDim1 : description of 1st dimension (ex. UN)

dim2 : type of 2nd dimension (ex. COLOR)

codDim2 : code of 2nd dimension (ex. 00000)

desDim2 : description of 2nd dimension (ex. Neutral)

dim3 : type of 3rd dimension

codDim3 : code of 3rd dimension

desDim3 : description of 3rd dimension

dim4 : type of 4th dimension

codDim4 : code of 4th dimension

desDim4 : description of 4th dimension

dim5 : type of 5th dimension

codDim5 : code of 5th dimension

desDim5 : description of 5th dimension

quantity : number of stocked articles

This is the list of fields that can be passed in the request body:

Field	Description	Type	Mandatory
barcode	Barcode of the article for which the stock is requested	Varchar(50)	✓
itemCode	Item code of the article for which the stock is requested	Varchar(250)
date	If specified, the stock is calculated up to the given date (movements date <= given date)	Date (yyyy-mm-dd)

Response example

{
    "succes" : true,
    "code" : 200,
    "stocks" : [
        {
            "entityCode": "0",
            "barcode": "8033772180009",
            "item": "U58_G.MSM100205",
            "description": "POLSINI",
            "dim1": "Taglia",
            "codDim1": "1",
            "desDim1": "UN",
            "dim2": "Colore",
            "codDim2": "00000",
            "desDim2": "Neutro",
            "dim3": "Drop",
            "codDim3": "1",
            "desDim3": "_",
            "dim4": null,
            "codDim4": null,
            "desDim4": null,
            "dim5": null,
            "codDim5": null,
            "desDim5": null,
            "quantity": 1
        },
        {
            "entityCode": "3",
            "barcode": "8033772180009",
            "item": "U58_G.MSM100205",
            "description": "POLSINI",
            "dim1": "Taglia",
            "codDim1": "1",
            "desDim1": "UN",
            "dim2": "Colore",
            "codDim2": "00000",
            "desDim2": "Neutro",
            "dim3": "Drop",
            "codDim3": "1",
            "desDim3": "_",
            "dim4": null,
            "codDim4": null,
            "desDim4": null,
            "dim5": null,
            "codDim5": null,
            "desDim5": null,
            "quantity": 6
        }
    ]
}

Notes

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses