masstack

V1
API Overview Resources Schemas

Devices

Operations with devices

Parameters

Name In Type Required Description
orgId path string true Organization name as it is registered in Mas-Stack
deviceId path integer(int64) true Identifier of the device

Request example

1
2
3
4
5


curl -X GET https://logistics-stock.sta.masstack.com/v1/orgs/yoigo/device/1 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK success DeviceDto
400 Bad Request Bad Request Error400
404 Not Found Not found Error404
500 Internal Server Error Internal Server Error Error500

Parameters

Name In Type Required Description
orgId path string true Organization name as it is registered in Mas-Stack
identifier query string true The imei or the device serial number
identifierType query string false The type of identifier provided

Enumerated Values

Property Values
identifierType one of [IMEI, SERIALNUMBER]

Request example

1
2
3
4
5


curl -X GET https://logistics-stock.sta.masstack.com/v1/orgs/yoigo/device?identifier='867379061165148'&identifierType='IMEI'?identifier=867379061165148 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK success DeviceDto
400 Bad Request Bad Request Error400
404 Not Found Not found Error404
500 Internal Server Error Internal Server Error Error500

Parameters

Name In Type Required Description
orgId path string true Organization name as it is registered in Mas-Stack
body body DeviceDto false Information needed to insert a device

Request body - instance of DeviceDto

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
  "deviceId": 0,
  "imei": "864467060074057",
  "imei2": "864467060074057",
  "serialNumber": "RFAT73D511Z",
  "brand": "Samsung",
  "model": "Samsung Galaxy Watch5 44mm BT Silver",
  "reference": "G034W54G2",
  "color": "Plata",
  "deviceType": "SmartWatch",
  "orderNumber": "4000003264",
  "providerDeliveryId": "3",
  "loadDate": "2009-01-13",
  "inputDate": "2009-01-13",
  "createDate": "2009-01-13",
  "updateDate": "2009-01-13"
}
Name Type Required Description
deviceId integer(int64) false none
imei string false none
imei2 string false none
serialNumber string false none
brand string false none
model string false none
reference string false none
color string false none
deviceType string false none
orderNumber string false none
providerDeliveryId string false none
loadDate string(date) false none
inputDate string(date) false none
createDate string(date) false none
updateDate string(date) false none

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


curl -X POST https://logistics-stock.sta.masstack.com/v1/orgs/yoigo/device \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'deviceId': 0,
  'imei': '864467060074057',
  'imei2': '864467060074057',
  'serialNumber': 'RFAT73D511Z',
  'brand': 'Samsung',
  'model': 'Samsung Galaxy Watch5 44mm BT Silver',
  'reference': 'G034W54G2',
  'color': 'Plata',
  'deviceType': 'SmartWatch',
  'orderNumber': '4000003264',
  'providerDeliveryId': '3',
  'loadDate': '2009-01-13',
  'inputDate': '2009-01-13',
  'createDate': '2009-01-13',
  'updateDate': '2009-01-13'
}"

Responses

Code Meaning Description Schema
200 OK Success DeviceDto
400 Bad Request Bad Request Error400
404 Not Found Not found Error404
500 Internal Server Error Internal Server Error Error500

Parameters

Name In Type Required Description
orgId path string true Organization name as it is registered in Mas-Stack
body body DeviceDto true Information needed to update a device

Request body - instance of DeviceDto

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
  "deviceId": 0,
  "imei": "864467060074057",
  "imei2": "864467060074057",
  "serialNumber": "RFAT73D511Z",
  "brand": "Samsung",
  "model": "Samsung Galaxy Watch5 44mm BT Silver",
  "reference": "G034W54G2",
  "color": "Plata",
  "deviceType": "SmartWatch",
  "orderNumber": "4000003264",
  "providerDeliveryId": "3",
  "loadDate": "2009-01-13",
  "inputDate": "2009-01-13",
  "createDate": "2009-01-13",
  "updateDate": "2009-01-13"
}
Name Type Required Description
deviceId integer(int64) false none
imei string false none
imei2 string false none
serialNumber string false none
brand string false none
model string false none
reference string false none
color string false none
deviceType string false none
orderNumber string false none
providerDeliveryId string false none
loadDate string(date) false none
inputDate string(date) false none
createDate string(date) false none
updateDate string(date) false none

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


curl -X PUT https://logistics-stock.sta.masstack.com/v1/orgs/yoigo/device \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'deviceId': 0,
  'imei': '864467060074057',
  'imei2': '864467060074057',
  'serialNumber': 'RFAT73D511Z',
  'brand': 'Samsung',
  'model': 'Samsung Galaxy Watch5 44mm BT Silver',
  'reference': 'G034W54G2',
  'color': 'Plata',
  'deviceType': 'SmartWatch',
  'orderNumber': '4000003264',
  'providerDeliveryId': '3',
  'loadDate': '2009-01-13',
  'inputDate': '2009-01-13',
  'createDate': '2009-01-13',
  'updateDate': '2009-01-13'
}"

Responses

Code Meaning Description Schema
200 OK Success DeviceDto
400 Bad Request Bad Request Error400
404 Not Found Not found Error404
500 Internal Server Error Internal Server Error Error500

Parameters

Name In Type Required Description
orgId path string true Organization name as it is registered in Mas-Stack
body body DeviceDto false Information to search a device

Request body - instance of DeviceDto

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
  "deviceId": 0,
  "imei": "864467060074057",
  "imei2": "864467060074057",
  "serialNumber": "RFAT73D511Z",
  "brand": "Samsung",
  "model": "Samsung Galaxy Watch5 44mm BT Silver",
  "reference": "G034W54G2",
  "color": "Plata",
  "deviceType": "SmartWatch",
  "orderNumber": "4000003264",
  "providerDeliveryId": "3",
  "loadDate": "2009-01-13",
  "inputDate": "2009-01-13",
  "createDate": "2009-01-13",
  "updateDate": "2009-01-13"
}
Name Type Required Description
deviceId integer(int64) false none
imei string false none
imei2 string false none
serialNumber string false none
brand string false none
model string false none
reference string false none
color string false none
deviceType string false none
orderNumber string false none
providerDeliveryId string false none
loadDate string(date) false none
inputDate string(date) false none
createDate string(date) false none
updateDate string(date) false none

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


curl -X POST https://logistics-stock.sta.masstack.com/v1/orgs/yoigo/device/search \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'deviceId': 0,
  'imei': '864467060074057',
  'imei2': '864467060074057',
  'serialNumber': 'RFAT73D511Z',
  'brand': 'Samsung',
  'model': 'Samsung Galaxy Watch5 44mm BT Silver',
  'reference': 'G034W54G2',
  'color': 'Plata',
  'deviceType': 'SmartWatch',
  'orderNumber': '4000003264',
  'providerDeliveryId': '3',
  'loadDate': '2009-01-13',
  'inputDate': '2009-01-13',
  'createDate': '2009-01-13',
  'updateDate': '2009-01-13'
}"

Responses

Code Meaning Description Schema
200 OK Success [DeviceDto]
400 Bad Request Bad Request Error400
404 Not Found Not found Error404
500 Internal Server Error Internal Server Error Error500

200 - instance of DeviceDto

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

[
  {
    "deviceId": 0,
    "imei": "864467060074057",
    "imei2": "864467060074057",
    "serialNumber": "RFAT73D511Z",
    "brand": "Samsung",
    "model": "Samsung Galaxy Watch5 44mm BT Silver",
    "reference": "G034W54G2",
    "color": "Plata",
    "deviceType": "SmartWatch",
    "orderNumber": "4000003264",
    "providerDeliveryId": "3",
    "loadDate": "2009-01-13",
    "inputDate": "2009-01-13",
    "createDate": "2009-01-13",
    "updateDate": "2009-01-13"
  }
]
Name Type Required Description
deviceId integer(int64) false none
imei string false none
imei2 string false none
serialNumber string false none
brand string false none
model string false none
reference string false none
color string false none
deviceType string false none
orderNumber string false none
providerDeliveryId string false none
loadDate string(date) false none
inputDate string(date) false none
createDate string(date) false none
updateDate string(date) false none

Endpoints

Base products

    Products

      Characteristics

        Delivery commitment

          Inputs

            Input Types

              Outputs

                Output Types

                  Stock

                    Physical Warehouse

                      Virtual Warehouse

                        Returns

                          Devices

                            Providers

                              Logistic Operators

                                Commercial Brands

                                  Commercial Distributions

                                    Status

                                      Categories

                                        Purposes

                                          Regions

                                            Countries

                                              Receptors

                                                Characteristics Values

                                                  Sales Channel

                                                    Tenant group brand

                                                      Organizations

                                                        Sap Ordering

                                                          Report importer