SOS version 1.0

https://api-customer.sos.sk

/auth

post

post

Headers

  • Authorization: required(string)

    Client authentification.

    Example:

    Basic ZGVtbzo5NUtqblNVWkdYU0c3bTdPa2RHTzlrUDhabnp2TTd1UA==
  • Accept-Language: (string - default: en)

    Example:

    sk-SK, sk;q=0.9, en;q=0.8, de;q=0.7

Body

Media type: application/json

Type: any

Example:

{
  "username": "aaaa",
  "password": "bbb"
}

HTTP status code 200

Body

Media type: application/json

Type: any

Example:

{
  "client_id": "demo",
  "user_id": "596c945c593120649f0ff69c",
  "token_type": "Bearer",
  "access_token": "1a28478147da43ae8745f37a7b47d011940d4611c3f74c619e20bf489b707331758b69d28fe6449ba5a1e7e19033e3cc598f926331f5481aa10a1cbc1d20c442",
  "refresh_token": "970cbbb7e7d5465eb87d31d5ab3cdaddf012ee9575e7449fa559c56aee2968b33ec04c25160a4ba7a2e35e95b9841018a1e06c30da9f4d3f97c958d7856918d4",
  "scopes": [
    "customer",
    "public"
  ]
}

HTTP status code 401

Username or password are invalid.

HTTP status code 403

Forbidden.

HTTP status code 404

Object not found.

HTTP status code 409

Conflict.

HTTP status code 500

Body

Media type: application/json

Type: any

Example:

{
  "id": "9f426268-4e14-4aa1-96ec-ccf5445aec2d",
  "description": "The server encountered an unexpected condition.",
  "name": "Internal Server Error",
  "code": 500,
  "payload": {
    "custom_data": "custom"
  }
}

post

post

Headers

  • Authorization: required(string)

    Client authentification.

    Example:

    Basic ZGVtbzo5NUtqblNVWkdYU0c3bTdPa2RHTzlrUDhabnp2TTd1UA==
  • Accept-Language: (string - default: en)

    Example:

    sk-SK, sk;q=0.9, en;q=0.8, de;q=0.7

Body

Media type: application/json

Type: any

Example:

{
  "refresh_token": "af144de4912c4a30b5a903837aa69c434cdeea8599d340989a13e18b9156405a90440b4f68384d2c9c70facc6159d12aa66e7ee20591407dbbda566571210ebd"
}

HTTP status code 200

Body

Media type: application/json

Type: any

Example:

{
  "client_id": "demo",
  "user_id": "596c945c593120649f0ff69c",
  "token_type": "Bearer",
  "access_token": "72a79f87a91b46ac8d8a93773f80ae0f0f5de32240c94971af6005563ebd109c87d6db88e5d4430aa36838e9d93c3613ca4f6a39299d49469c8a9a0a78ecc0e1",
  "refresh_token": "f8cc8aaeaf9b4d8e869b9cc253c722a43cafaad970d34c3e9e95ef7f59fcc3ee0cfc519b6da341549ea3ba0751713a57491f6cc7afda4b58ae56a653530ccd7e",
  "scopes": [
    "customer",
    "public"
  ]
}

HTTP status code 403

Forbidden.

HTTP status code 404

Object not found.

HTTP status code 409

Conflict.

HTTP status code 500

Body

Media type: application/json

Type: any

Example:

{
  "id": "9f426268-4e14-4aa1-96ec-ccf5445aec2d",
  "description": "The server encountered an unexpected condition.",
  "name": "Internal Server Error",
  "code": 500,
  "payload": {
    "custom_data": "custom"
  }
}

post

post

Information about the access token.

Information about the access token.

Headers

  • Authorization: required(string)

    Client authentification.

    Example:

    Basic ZGVtbzo5NUtqblNVWkdYU0c3bTdPa2RHTzlrUDhabnp2TTd1UA==
  • Accept-Language: (string - default: en)

    Example:

    sk-SK, sk;q=0.9, en;q=0.8, de;q=0.7

Body

Media type: application/json

Type: any

Example:

{
  "access_token": "a892c79372344259baf23cf105eb976e519b71127d164c61a0eb39bca57869028df6cad7fd7f4f85aa82bdcc49eb475dca8c88b26fc44546b3a00e61bf3a7b91"
}

HTTP status code 200

Body

Media type: application/json

Type: any

Example:

{
    "client_id": "demo",
    "user_id": "596c945c593120649f0ff69c",
    "token_type": "Bearer",
    "expires_in": 2841,
    "expires_at": 1500293953,
    "expires_at_date": "2017-07-17 14:19:13.498450+02:00",
    "scopes": [
        "customer",
        "public"
    ]
}

HTTP status code 400

INVALID_DATA - invalid input data.

INVALID_TOKEN - token is invalid.

HTTP status code 401

UNAUTHORIZED_CLIENT -

HTTP status code 403

INVALID_CLIENT -

HTTP status code 404

Object not found.

HTTP status code 409

Conflict.

HTTP status code 500

Body

Media type: application/json

Type: any

Example:

{
  "id": "9f426268-4e14-4aa1-96ec-ccf5445aec2d",
  "description": "The server encountered an unexpected condition.",
  "name": "Internal Server Error",
  "code": 500,
  "payload": {
    "custom_data": "custom"
  }
}

post

post

Revoke both access and refresh token.

Revoke both access and refresh token.

Headers

  • Authorization: required(string)

    Client authentification.

    Example:

    Basic ZGVtbzo5NUtqblNVWkdYU0c3bTdPa2RHTzlrUDhabnp2TTd1UA==
  • Accept-Language: (string - default: en)

    Example:

    sk-SK, sk;q=0.9, en;q=0.8, de;q=0.7

Body

Media type: application/json

Type: any

Example:

{
  "access_token": "a892c79372344259baf23cf105eb976e519b71127d164c61a0eb39bca57869028df6cad7fd7f4f85aa82bdcc49eb475dca8c88b26fc44546b3a00e61bf3a7b91"
}

HTTP status code 200

Tokens was succesfully revoked.

HTTP status code 400

INVALID_DATA - invalid input data.

INVALID_TOKEN - token is invalid.

HTTP status code 401

UNAUTHORIZED_CLIENT -

HTTP status code 403

INVALID_CLIENT -

HTTP status code 404

Object not found.

HTTP status code 409

Conflict.

HTTP status code 500

Body

Media type: application/json

Type: any

Example:

{
  "id": "9f426268-4e14-4aa1-96ec-ccf5445aec2d",
  "description": "The server encountered an unexpected condition.",
  "name": "Internal Server Error",
  "code": 500,
  "payload": {
    "custom_data": "custom"
  }
}

/docs

get

get

REST API documentation.

/invoices

get

get

Invoice list.

get

get

Invoice detail.

Invoice detail.

Secured by auth_oauth

Custom OAuth 2.0 authentification

URI Parameters

  • invoice_id: required(string)

Headers

  • Authorization: required(string)

    Bearer token.

    Example:

    Bearer d5bc5b2ac2464925a0602d375202fb12eb8d1c1a7c124f78808fb204492530342136ee32ded2431da34e58d881e0af69fee3ebaabc3743e4ad648f7d9a280c4c
  • Accept-Language: (string - default: en)

    Example:

    sk-SK, sk;q=0.9, en;q=0.8, de;q=0.7

HTTP status code 200

Body

Media type: application/json

Type: any

Example:

{
  "status": {
    "id": "PAID",
    "name": "uhradená"
  },
  "due_date": "2016-07-08 02:00:00+02:00",
  "total_price": {
    "taxrate": 20,
    "currency": "EUR",
    "amount": 12.15,
    "amount_with_tax": 14.58
  },
  "items_total_price": {
    "taxrate": 20,
    "currency": "EUR",
    "amount": 12.15,
    "amount_with_tax": 14.58
  },
  "items": [
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 3.8301,
        "amount_with_tax": 4.5961
      },
      "name": "TOOLCRAFT 588182",
      "descr": "Hand soldering iron 60W 230VAC D6xL75mm",
      "customer_name": "My Label",
      "ordernr": "161058",
      "brand": {
        "name": "TOOLCRAFT"
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 3.8301,
        "amount_with_tax": 4.5961
      },
      "id": 140880,
      "unit": "szt.",
      "quantity": 1
    },
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 2.2665,
        "amount_with_tax": 2.7198
      },
      "name": "UP 915 EP 160x100mm",
      "descr": "Test board 37 Strips FR4",
      "customer_name": null,
      "ordernr": "80378",
      "brand": {
        "name": "WR RADEMACHER"
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 2.2665,
        "amount_with_tax": 2.7198
      },
      "id": 105504,
      "unit": "szt.",
      "quantity": 1
    },
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 0.3701,
        "amount_with_tax": 0.4441
      },
      "name": "ROSIN45G",
      "descr": "Rosin soldering flux 45g (colophony)",
      "customer_name": null,
      "ordernr": "165955",
      "brand": {
        "name": "CYNEL"
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 0.3701,
        "amount_with_tax": 0.4441
      },
      "id": 143394,
      "unit": "szt.",
      "quantity": 1
    },
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 0.7,
        "amount_with_tax": 0.84
      },
      "name": "1532 Sn60Pb38Cu2 1,5mm 10g",
      "descr": "Solder F-SW26 2,2% ",
      "customer_name": null,
      "ordernr": "41360",
      "brand": {
        "name": null
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 0.35,
        "amount_with_tax": 0.42
      },
      "id": 90774,
      "unit": "szt.",
      "quantity": 2
    },
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 1.4631,
        "amount_with_tax": 1.7557
      },
      "name": "821025",
      "descr": "Set Of Tweezers Curved/Straight 2pc ",
      "customer_name": null,
      "ordernr": "151848",
      "brand": {
        "name": "TOOLCRAFT"
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 1.4631,
        "amount_with_tax": 1.7557
      },
      "id": 137471,
      "unit": "szt.",
      "quantity": 1
    },
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 2.0952,
        "amount_with_tax": 2.514
      },
      "name": "Alkaline LR03 TECXUS SF4",
      "descr": "Bateria alkaliczna 1,5V AAA folia",
      "customer_name": null,
      "ordernr": "77311",
      "brand": {
        "name": "TECXUS"
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 0.1746,
        "amount_with_tax": 0.2095
      },
      "id": 104738,
      "unit": "szt.",
      "quantity": 12
    },
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 1.4288,
        "amount_with_tax": 1.7146
      },
      "name": "HT-109",
      "descr": "Plier side cutter precise IC 0,8mm 130mm ",
      "customer_name": null,
      "ordernr": "6144",
      "brand": {
        "name": "HANLONG"
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 1.4288,
        "amount_with_tax": 1.7146
      },
      "id": 83650,
      "unit": "szt.",
      "quantity": 1
    }
  ],
  "number": "12528",
  "payment": {
    "date": "2016-07-11 02:00:00+02:00",
    "price": {
      "taxrate": 20,
      "currency": "EUR",
      "amount": 0,
      "amount_with_tax": 0
    },
    "id": "122",
    "name": "Przelew bankowy"
  },
  "delivery": {
    "price": {
      "taxrate": 20,
      "currency": "EUR",
      "amount": 0,
      "amount_with_tax": 0
    },
    "id": "407",
    "name": "Personally"
  },
  "vs": "1416012528",
  "created_date": "2016-07-08 02:00:00+02:00",
  "rid": "95386928676893",
  "customer_number": "1743",
  "id": "577fac4267dca52f00ee9e0f"
}

HTTP status code 401

Access token is invalid or missing.

HTTP status code 403

Forbidden.

QUOTA_EXCEEDED - request count reached maximum allowed value

HTTP status code 404

Object not found.

HTTP status code 409

Conflict.

HTTP status code 500

Body

Media type: application/json

Type: any

Example:

{
  "id": "9f426268-4e14-4aa1-96ec-ccf5445aec2d",
  "description": "The server encountered an unexpected condition.",
  "name": "Internal Server Error",
  "code": 500,
  "payload": {
    "custom_data": "custom"
  }
}

Secured by auth_oauth

Headers

  • Authorization: required(string)

    Odoslanie validného access_token parametra

    Example:

    Authorization: Bearer d5bc5b2ac2464925a0602d375202fb12eb8d1c1a7c124f78808fb204492530342136ee32ded2431da34e58d881e0af69fee3ebaabc3743e4ad648f7d9a280c4c

HTTP status code 401

Access token is invalid or missing.

/orders

get

get

List of opened orders.

get

get

List of undelivered products.

get

get

Order detail.

Order detail.

Secured by auth_oauth

Custom OAuth 2.0 authentification

URI Parameters

  • order_id: required(string)

Headers

  • Authorization: required(string)

    Bearer token.

    Example:

    Bearer d5bc5b2ac2464925a0602d375202fb12eb8d1c1a7c124f78808fb204492530342136ee32ded2431da34e58d881e0af69fee3ebaabc3743e4ad648f7d9a280c4c
  • Accept-Language: (string - default: en)

    Example:

    sk-SK, sk;q=0.9, en;q=0.8, de;q=0.7

HTTP status code 200

Body

Media type: application/json

Type: any

Example:

{
  "status": {
    "id": "NEW",
    "name": "prijatá"
  },
  "due_date": null,
  "total_price": {
    "taxrate": 20,
    "currency": "EUR",
    "amount": 4,
    "amount_with_tax": 4.8
  },
  "items_total_price": {
    "taxrate": 20,
    "currency": "EUR",
    "amount": 0,
    "amount_with_tax": 0
  },
  "items": [
    {
      "total_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 0,
        "amount_with_tax": 0
      },
      "name": "DSPIC30F4012-30I/SP",
      "descr": "dsPIC 30F Microcontroller 16-Bit 30 MIPs 48KB FLASH DIP28 ",
      "ordernr": "87196",
      "brand": {
        "name": "MICROCHIP"
      },
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 0,
        "amount_with_tax": 0
      },
      "quantity": 1,
      "id": 107956,
      "unit": "pcs",
      "customer_name": null
    }
  ],
  "number": "4a4d1367-afbd-4d19-9dc6-38a401f22515",
  "payment": {
    "date": null,
    "price": {
      "taxrate": 20,
      "currency": "EUR",
      "amount": 0,
      "amount_with_tax": 0
    },
    "id": "123",
    "name": "Cash on delivery"
  },
  "delivery": {
    "price": {
      "taxrate": 20,
      "currency": "EUR",
      "amount": 4,
      "amount_with_tax": 4.8
    },
    "id": "408",
    "name": "UPS"
  },
  "vs": "1170801003",
  "created_date": "2017-08-01 10:17:14.959000+02:00",
  "rid": null,
  "customer_number": "112323",
  "id": "4a4d1367-afbd-4d19-9dc6-38a401f22515"
}

HTTP status code 401

Access token is invalid or missing.

HTTP status code 403

Forbidden.

QUOTA_EXCEEDED - request count reached maximum allowed value

HTTP status code 404

Object not found.

HTTP status code 409

Conflict.

HTTP status code 500

Body

Media type: application/json

Type: any

Example:

{
  "id": "9f426268-4e14-4aa1-96ec-ccf5445aec2d",
  "description": "The server encountered an unexpected condition.",
  "name": "Internal Server Error",
  "code": 500,
  "payload": {
    "custom_data": "custom"
  }
}

Secured by auth_oauth

Headers

  • Authorization: required(string)

    Odoslanie validného access_token parametra

    Example:

    Authorization: Bearer d5bc5b2ac2464925a0602d375202fb12eb8d1c1a7c124f78808fb204492530342136ee32ded2431da34e58d881e0af69fee3ebaabc3743e4ad648f7d9a280c4c

HTTP status code 401

Access token is invalid or missing.

/products

get

get

List of products.

get

get

Product detail.

Product detail.

Secured by auth_oauth

Custom OAuth 2.0 authentification

URI Parameters

  • ordernr: required(string)

Headers

  • Authorization: required(string)

    Bearer token.

    Example:

    Bearer d5bc5b2ac2464925a0602d375202fb12eb8d1c1a7c124f78808fb204492530342136ee32ded2431da34e58d881e0af69fee3ebaabc3743e4ad648f7d9a280c4c
  • Accept-Language: (string - default: en)

    Example:

    sk-SK, sk;q=0.9, en;q=0.8, de;q=0.7

HTTP status code 200

Body

Media type: application/json

Type: any

Example:

{
  "category": {
    "name": "Microcontrollers"
  },
  "picture": {
    "url": "https://cdn.sos.sk/productdata/07/0e/57e6c186/at-89-c-2051-24pu.jpg"
  },
  "moq": 1,
  "name": "AT 89 C 4051-24PU",
  "descr": "89C Microcontroller 8-bit 24MHz 4KB FLASH DIP20 ",
  "ordernr": "3168",
  "url": "http://www.sos-com.test/products/microchip/at-89-c-4051-24pu-1-3168",
  "brand": {
    "name": "MICROCHIP"
  },
  "indivisible_quantity": 1,
  "multiple_quantity": 1,
  "packing": 18,
  "packing_type": "P-TUBE",
  "parameters": [
    {
      "unit": null,
      "name": "FLASH Size",
      "value": "4kB"
    },
    {
      "unit": "V",
      "name": "Supply Voltage Min",
      "value": "4"
    },
    {
      "unit": null,
      "name": "Case",
      "value": "DIP20"
    },
    {
      "unit": null,
      "name": "Core / Family",
      "value": "89C"
    },
    {
      "unit": "V",
      "name": "Supply Voltage Max",
      "value": "6"
    },
    {
      "unit": null,
      "name": "Mounting Type",
      "value": "THT"
    },
    {
      "unit": null,
      "name": "RAM Size",
      "value": "128B"
    },
    {
      "unit": null,
      "name": "EEPROM Size",
      "value": "none"
    },
    {
      "unit": "MHz",
      "name": "Core Frequency",
      "value": "24"
    },
    {
      "unit": null,
      "name": "Note",
      "value": "-"
    },
    {
      "unit": null,
      "name": "Series",
      "value": "AT89C"
    }
  ],
  "product_type": "S",
  "pricelist": [
    {
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 2.11,
        "amount_with_tax": 2.532
      },
      "quantity": 1
    },
    {
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 2.05,
        "amount_with_tax": 2.46
      },
      "quantity": 2
    },
    {
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 1.8,
        "amount_with_tax": 2.16
      },
      "quantity": 18
    },
    {
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 1.73,
        "amount_with_tax": 2.076
      },
      "quantity": 36
    },
    {
      "unit_price": {
        "taxrate": 20,
        "currency": "EUR",
        "amount": 1.54,
        "amount_with_tax": 1.848
      },
      "quantity": 144
    }
  ],
  "document": {
    "url": "https://cdn.sos.sk/productdata/64/a8/2ddde755/at-89-c-4051-24pu-1.pdf"
  },
  "availability": {
    "on_stock_delivery": [
      {
        "date": "2020-12-04",
        "quantity": 500
      }
    ],
    "in_store": 540,
    "ordered": 0,
    "external": {
      "lead_time": "in 5-15 days",
      "stock": 38
    }
  },
  "unit": "pcs",
  "customer_name": null
}

HTTP status code 401

Access token is invalid or missing.

HTTP status code 403

Forbidden.

QUOTA_EXCEEDED - request count reached maximum allowed value

HTTP status code 404

Object not found.

HTTP status code 409

Conflict.

HTTP status code 500

Body

Media type: application/json

Type: any

Example:

{
  "id": "9f426268-4e14-4aa1-96ec-ccf5445aec2d",
  "description": "The server encountered an unexpected condition.",
  "name": "Internal Server Error",
  "code": 500,
  "payload": {
    "custom_data": "custom"
  }
}

Secured by auth_oauth

Headers

  • Authorization: required(string)

    Odoslanie validného access_token parametra

    Example:

    Authorization: Bearer d5bc5b2ac2464925a0602d375202fb12eb8d1c1a7c124f78808fb204492530342136ee32ded2431da34e58d881e0af69fee3ebaabc3743e4ad648f7d9a280c4c

HTTP status code 401

Access token is invalid or missing.