Get Catalog

Retrieves the available hardware catalog with pricing and stock information for a specific country.

Authentication

This endpoint requires authentication. See Authentication for details.

Parameters

Parameter	Type	Required	Description
countryCode	string	No	Filter catalog by country in ISO 3166-1 alpha-2 format

Request

Production URL: https://orchestrator.tecspal.com/
Sandbox URL: https://tecspal-orchestrator.sandbox.lexartlabs.uy/
Endpoint: GET /catalog

Example Request

{
  "filters": {
    "countryCode": "UY"
  },
  "request": "catalog",
  "vendor": "tecspal",
  "verb": "GET"
}

Note: The countryCode parameter is optional. If not provided, the endpoint will return catalog items for all countries.

Response Schema

Property	Type	Description
statusCode	number	HTTP status code of the response
message	string	Description of the response status
envelop	array	Array containing catalog items grouped by country

Hardware Properties

Property	Type	Description
id	string	Unique identifier of the hardware item
countryCode	string	Country code where the hardware is located
price	string	Price of the hardware (as string)
stock	string	Quantity available in stock (as string)
brand	string	Brand name of the hardware (if available)
name	string	Name of the device (e.g., MacBook Pro)
ram	string	RAM size (e.g., "16GB")
diskSpace	string	Disk space size (e.g., "512GB")
displaySize	string	Display size (e.g., "14 inch", "16 inch")
processor	string	Processor model (e.g., "M1 Pro")
image	string	URL of the hardware image
deprecated	boolean	Indicates if this hardware model is deprecated
manufacturerPartNumber	string | null	Manufacturer part number (if available)
hardwareType	string | null	Hardware type name (e.g., "MACBOOK", "PC")

Example Response

{
  "envelop": [
    {
      "UY": [
        {
          "id": "fbb910c7-9dbe-4bf5-bddc-00f98f5848bf",
          "countryCode": "UY",
          "price": "5000",
          "stock": "1000",
          "brand": "APPLE",
          "name": "MacBook Pro",
          "ram": "16GB",
          "diskSpace": "512GB",
          "displaySize": "16 inch",
          "processor": "M1 Pro",
          "image": "https://a-us.storyblok.com/f/1001855/789x500/82ee51ba4d/macbook-pro-16.png",
          "deprecated": false,
          "manufacturerPartNumber": null,
          "hardwareType": "MACBOOK"
        },
        {
          "id": "5d473040-46fa-43c2-b550-fc32af9b9b4c",
          "countryCode": "UY",
          "price": "4000",
          "stock": "100",
          "brand": "APPLE",
          "name": "MacBook Pro",
          "ram": "16GB",
          "diskSpace": "512GB",
          "displaySize": "14 inch",
          "processor": "M1 Pro",
          "image": "https://a-us.storyblok.com/f/1001855/1997x1169/9ad84eb1c8/macbook-pro-13-other.png",
          "deprecated": false,
          "manufacturerPartNumber": null,
          "hardwareType": "MACBOOK"
        }
      ]
    }
  ],
  "message": "Request successful",
  "statusCode": 200
}

Error Responses

Bad Request (400)

{
  "error": "Bad Request",
  "message": "Invalid country code",
  "statusCode": 400
}

Unauthorized (401)

{
  "error": "Unauthorized",
  "message": "Unauthorized access",
  "statusCode": 401
}

Notes

• Catalog items are grouped by country code in the response
• Prices are in USD
• Stock levels are updated in real-time
• The catalog includes detailed specifications for each hardware model
• Items marked as deprecated: true are no longer recommended for new orders but may still be available in stock