Jump to

• Request
• Response

Add Menu Levels

post

/config/sim/v1/setup/menulevels

Add the Menu Level object to a specified hierarchy unit of specified organization

Request

Supported Media Types

• application/json
• multipart/form-data

Header Parameters

• Simphony-AuditTrailRef: string
  Detail that identifies, who made the change.

Body ()

Request body

Root Schema : MenuLevelCUDRequestBody

Type: object

Model for Menu Level for an organization

Show Source

• defaultMIMstrGrpObjNum: integer
  Object number of default menu item master group associated with the Menu Level.

  Example: 1
• hierUnitId(required): integer
  Unique reference of the hierarchy unit

  Example: 1
• menuLevelEntries: array menuLevelEntries
• menuLevelType: string
  Specifies whether the Menu Level Set refers to the Main Levels, Sub Levels, or to the levels defined within the record. Following values are supported Main, Sub and Custom

  Example: Main
• name(required): object TranslatedString
  Additional Properties Allowed: additionalProperties

  A string that contains translations into multiple languages
• objectNum(required): integer
  Object number the menu level

  Example: 1
• options: string
  A string value of 0s and 1s of length 8 representing the enablement or disablement of the options associated.

  Example: 10000000

{
    "type":"object",
    "required":[
        "hierUnitId",
        "objectNum",
        "name"
    ],
    "properties":{
        "hierUnitId":{
            "type":"integer",
            "example":1,
            "description":"Unique reference of the hierarchy unit"
        },
        "objectNum":{
            "type":"integer",
            "example":1,
            "description":"Object number the menu level"
        },
        "name":{
            "description":"A group of string objects representing the name of Menu Level in configured languages",
            "$ref":"#/definitions/TranslatedString"
        },
        "menuLevelType":{
            "type":"string",
            "example":"Main",
            "description":"Specifies  whether the Menu Level Set refers to the Main Levels, Sub Levels, or to the levels  defined  within the record. Following values are supported Main, Sub and Custom"
        },
        "defaultMIMstrGrpObjNum":{
            "type":"integer",
            "example":1,
            "description":"Object number of default menu item master group associated  with the Menu Level."
        },
        "options":{
            "type":"string",
            "example":"10000000",
            "description":"A string value of 0s and 1s of length 8 representing the enablement or disablement of the options associated."
        },
        "menuLevelEntries":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/MenuLevel_menuLevelEntries_CUD"
            }
        }
    },
    "description":"Model for Menu Level for an organization"
}

Nested Schema : menuLevelEntries

Type: array

Show Source

• Array of: object MenuLevel_menuLevelEntries_CUD
  An array of the entries associated with the menu level

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/MenuLevel_menuLevelEntries_CUD"
    }
}

Nested Schema : TranslatedString

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "description":"A string that contains translations into multiple languages",
    "example":{
        "en-US":"Coffee",
        "de-DE":"Kaffee",
        "es-MX":"Cafe"
    },
    "additionalProperties":{
        "type":"string"
    }
}

A string that contains translations into multiple languages

Example:

{
    "en-US":"Coffee",
    "de-DE":"Kaffee",
    "es-MX":"Cafe"
}

Nested Schema : MenuLevel_menuLevelEntries_CUD

Type: object

An array of the entries associated with the menu level

Show Source

• index: integer
  Index of the menu level entry

  Example: 1
• name: object TranslatedString
  Additional Properties Allowed: additionalProperties

  A string that contains translations into multiple languages
• options: string
  A string value of 0s and 1s of length 8 representing the enablement and disablement of options associated.

  Example: 00000000
• prefix: object TranslatedString
  Additional Properties Allowed: additionalProperties

  A string that contains translations into multiple languages
• suffix: object TranslatedString
  Additional Properties Allowed: additionalProperties

  A string that contains translations into multiple languages

{
    "type":"object",
    "properties":{
        "index":{
            "type":"integer",
            "example":1,
            "description":"Index of the menu level entry"
        },
        "name":{
            "description":"A group of string objects representing the name of the Menu Level entry in configured languages.",
            "$ref":"#/definitions/TranslatedString"
        },
        "prefix":{
            "description":"Prefix of the menu level to show on the check detail area,  print on guest checks and customer receipts.",
            "$ref":"#/definitions/TranslatedString"
        },
        "suffix":{
            "description":"Suffix of the menu level to show on the check detail area, print on guest checks and customer receipts.",
            "$ref":"#/definitions/TranslatedString"
        },
        "options":{
            "type":"string",
            "example":"00000000",
            "description":"A string value of 0s and 1s of length 8 representing the enablement and disablement of options associated."
        }
    },
    "description":"An array of the entries associated with the menu level"
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Menu Level Response

Body ()

Root Schema : MenuLevelResponse

Type: object

Show Source

• hierUnitId(required): integer
  Unique reference of the hierarchy unit

  Example: 1
• objectNum(required): integer
  Object number the menu level

  Example: 1

{
    "type":"object",
    "required":[
        "hierUnitId",
        "objectNum"
    ],
    "properties":{
        "hierUnitId":{
            "type":"integer",
            "example":1,
            "description":"Unique reference of the hierarchy unit"
        },
        "objectNum":{
            "type":"integer",
            "example":1,
            "description":"Object number the menu level"
        }
    }
}

400 Response

400 Bad Request

Body ()

Root Schema : ErrorDetails

Type: object

Response body when the request returns an error.

Show Source

• detail(required): string
  A short, human-readable summary of the problem.

  Example: Specified Data is invalid
• errorDetails(required): string
  A human-readable explanation specific to this occurrence of the problem.

  Example: Entity Does Not Exist
• o:errorCode(required): integer
  Error code of the problem

  Example: 55223
• status(required): integer
  HTTP status code.

  Example: 400
• title(required): string
  A short, human-readable summary of the problem type.

  Example: VALIDATION ERROR
• type(required): string
  A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".

  Example: http://www.abc.org/xyz.html

{
    "description":"Response body when the request returns an error.\n",
    "type":"object",
    "required":[
        "o:errorCode",
        "detail",
        "status",
        "type",
        "title",
        "errorDetails"
    ],
    "properties":{
        "o:errorCode":{
            "description":"Error code of the problem",
            "type":"integer",
            "example":55223
        },
        "detail":{
            "description":"A short, human-readable summary of the problem.",
            "type":"string",
            "example":"Specified Data is invalid"
        },
        "status":{
            "description":"HTTP status code.",
            "type":"integer",
            "example":400
        },
        "type":{
            "description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".",
            "type":"string",
            "example":"http://www.abc.org/xyz.html"
        },
        "title":{
            "description":"A short, human-readable summary of the problem type.",
            "type":"string",
            "example":"VALIDATION ERROR"
        },
        "errorDetails":{
            "description":"A human-readable explanation specific to this occurrence of the problem.",
            "type":"string",
            "example":"Entity Does Not Exist"
        }
    }
}

Back to Top