---
updatedAt: 2026-06-12T14:08:37.000Z
agentTools:
  projectIndex: https://developer.crunchtime.com/llms.txt
---

# saveCheckMenuMixRecordsV1

Create a new Menu Mix item. 
 Update a Menu Mix item.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "Swagger documentation supporting mobile development of Crunchtime.",
    "version": "2.99",
    "title": "Inventory & Labor",
    "termsOfService": "http://springfox.io",
    "contact": {
      "name": "Crunchtime Development Team",
      "url": "http://www.crunchtime.com",
      "email": "apiquestions@crunchtime.com"
    },
    "license": {
      "name": "Apache License Version 2.0",
      "url": "https://github.com/springfox/springfox/blob/master/LICENSE"
    }
  },
  "tags": [
    {
      "name": "Check Menu Mix Service",
      "description": "The Check Menu Mix Service allows for the import of Check and Item based data from the POS system in order to deplete inventory according to the Recipe configuration in Enterprise Manager. The get call will also allow you to extract the check and item based data for externally generated reports as well."
    }
  ],
  "paths": {
    "/checkmenumix/v1/saveCheckMenuMix": {
      "post": {
        "tags": [
          "Check Menu Mix Service"
        ],
        "summary": "saveCheckMenuMixRecordsV1",
        "description": "Create a new Menu Mix item. \n Update a Menu Mix item.",
        "operationId": "saveCheckMenuMixRecordsV1UsingPOST",
        "parameters": [
          {
            "name": "authenticationtoken",
            "in": "header",
            "description": "Secure token for API authentication.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "password",
            "in": "header",
            "description": "Password for the Crunchtime Application User.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sitename",
            "in": "header",
            "description": "Crunchtime site identifier. (test or production)",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "userid",
            "in": "header",
            "description": "User ID for the Crunchtime Application User.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-B3-TraceId",
            "in": "header",
            "description": "Optional trace identifier for troubleshooting.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckMenuMixDetailsList"
              }
            }
          },
          "description": "A list of Check Menu Mix items.",
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object"
                }
              },
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Validation Error",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ObjectError"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ObjectError"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Authorization",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected Error",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/CheckMenuMixDetailsList"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckMenuMixDetailsList"
                }
              }
            }
          },
          "503": {
            "description": "System under maintenance",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "description": "Timeout",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Crunchtime Developer Hub",
    "url": "https://developer.crunchtime.com/"
  },
  "servers": [
    {
      "url": "//webservices-test.net-chef.com"
    }
  ],
  "components": {
    "schemas": {
      "CheckMenuMixCheckDetailDto": {
        "type": "object",
        "required": [
          "checkNumber",
          "checkOpenTime",
          "timeOfSale"
        ],
        "properties": {
          "chargeTips": {
            "type": "number",
            "example": 9999.99,
            "description": "The tips charged to a credit card."
          },
          "checkCloseTime": {
            "type": "string",
            "example": "11:30",
            "description": "Time the check was closed in format HH:mm (24hr format)."
          },
          "checkNumber": {
            "type": "string",
            "example": 12345,
            "description": "The check number."
          },
          "checkOpenTime": {
            "type": "string",
            "example": "11:30",
            "description": "Time the check was opened in format HH:mm (24hr format)."
          },
          "excludeConsumptionFlag": {
            "type": "string",
            "example": "Y",
            "description": "Exclude the sales data from this check in Consumption calculations."
          },
          "guestCount": {
            "type": "integer",
            "format": "int64",
            "example": 99,
            "description": "The number of guests listed on the check."
          },
          "timeOfSale": {
            "type": "string",
            "example": "11:30",
            "description": "Time sale time listed on the check in format HH:mm (24hr format)."
          }
        },
        "title": "CheckMenuMixCheckDetailDto",
        "description": "Check Menu Mix check item details."
      },
      "CheckMenuMixDetails": {
        "type": "object",
        "properties": {
          "checkMenuMixGroupDetails": {
            "type": "array",
            "description": "A list of Check Menu Mix set of details.",
            "items": {
              "$ref": "#/components/schemas/CheckMenuMixGroupDetails"
            }
          },
          "checkMenuMixHeaderDetails": {
            "$ref": "#/components/schemas/CheckMenuMixHeaderDto"
          }
        },
        "title": "CheckMenuMixDetails"
      },
      "CheckMenuMixDetailsList": {
        "type": "object",
        "required": [
          "locationCode"
        ],
        "properties": {
          "checkMenuMixDetails": {
            "type": "array",
            "description": "Check Menu Mix details.",
            "items": {
              "$ref": "#/components/schemas/CheckMenuMixDetails"
            }
          },
          "locationCode": {
            "type": "string",
            "example": "000000",
            "description": "Company Code for site name."
          }
        },
        "title": "CheckMenuMixDetailsList",
        "description": "CheckMenuMixDetailsList description"
      },
      "CheckMenuMixGroupDetails": {
        "type": "object",
        "description": "CheckMenuMixGroupDetails description",
        "properties": {
          "checkMenuMixCheckDetails": {
            "description": "List of check details.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CheckMenuMixCheckDetailDto"
            }
          },
          "checkMenuMixItemDetails": {
            "type": "array",
            "description": "List of items on the check. ",
            "items": {
              "$ref": "#/components/schemas/CheckMenuMixItemDetailDto"
            }
          },
          "checkMenuMixMiscCheckDetails": {
            "type": "array",
            "description": "List of miscellaneous check details.",
            "items": {
              "$ref": "#/components/schemas/CheckMenuMixMiscCheckDetailDto"
            }
          },
          "checkMenuMixMiscItemDetails": {
            "type": "array",
            "description": "List of miscellaneous item details.",
            "items": {
              "$ref": "#/components/schemas/CheckMenuMixMiscItemDetailDto"
            }
          },
          "checkMenuMixTimeDetails": {
            "type": "array",
            "description": "List of time details on the check.",
            "items": {
              "$ref": "#/components/schemas/CheckMenuMixTimeDetailDto"
            }
          }
        },
        "title": "CheckMenuMixGroupDetails"
      },
      "CheckMenuMixHeaderDto": {
        "type": "object",
        "required": [
          "businessDate",
          "customerCode",
          "locationCode"
        ],
        "properties": {
          "businessDate": {
            "type": "string",
            "example": "08/11/2019",
            "description": "Date the check was created."
          },
          "customerCode": {
            "type": "string",
            "example": "000011",
            "description": "The Customer \"Code\" or \"Import Code\" for a Customer linked to \n the Location, or the Location \"Code\" or \"Import Code\"."
          },
          "locationCode": {
            "type": "string",
            "example": "000011",
            "description": "Company Code for site name."
          }
        },
        "title": "CheckMenuMixHeaderDto",
        "description": "Check Menu Mix Header items."
      },
      "CheckMenuMixItemDetailDto": {
        "type": "object",
        "required": [
          "checkNumber",
          "pluNumber",
          "posLineNumber",
          "posPrice",
          "posQuantity",
          "posValue",
          "timeOfSale"
        ],
        "properties": {
          "checkNumber": {
            "type": "string",
            "example": 12345,
            "description": "The check number."
          },
          "cost": {
            "type": "number",
            "example": 55.61,
            "description": "The cost of the Recipe item."
          },
          "itemType": {
            "type": "integer",
            "format": "int64",
            "example": 3,
            "description": "Identification for Price Lookup type (recipe vs discount)."
          },
          "parentLineNumber": {
            "type": "integer",
            "format": "int64",
            "example": 9999,
            "description": "Parent Recipe item line number."
          },
          "pluNumber": {
            "type": "integer",
            "format": "int64",
            "example": 9999,
            "description": "Price lookup number for Recipe item."
          },
          "posLineNumber": {
            "type": "integer",
            "format": "int64",
            "example": 12345,
            "description": "The line number of the Recipe item on the check."
          },
          "posPrice": {
            "type": "number",
            "example": 9999.9,
            "description": "The sale price of the Recipe item."
          },
          "posQuantity": {
            "type": "number",
            "example": 9999.9,
            "description": "The quantity sold of the Recipe item."
          },
          "posValue": {
            "type": "number",
            "example": 9999.9,
            "description": "The sale value of the Recipe item."
          },
          "productNumber": {
            "type": "string",
            "example": "R1717_EM",
            "description": "The product number of the Recipe item."
          },
          "recipeName": {
            "description": "Recipe Name to help identify the Price lookup number.",
            "example": "TURKEY AVOCADO CLUB_EM",
            "type": "string"
          },
          "revenueCenter": {
            "type": "string",
            "example": 9,
            "description": "Sale item revenue center code."
          },
          "serverID": {
            "type": "string",
            "example": 10,
            "description": "ID or code for server who sold the item."
          },
          "timeOfSale": {
            "type": "string",
            "example": "12:30",
            "description": "Item sale time in format HH:mm (24hr clock)."
          }
        },
        "title": "CheckMenuMixItemDetailDto",
        "description": "CheckMenuMixItemDetailDto description"
      },
      "CheckMenuMixMiscCheckDetailDto": {
        "type": "object",
        "required": [
          "checkNumber",
          "dataValue",
          "miscId"
        ],
        "properties": {
          "checkNumber": {
            "type": "string",
            "example": 12345,
            "description": "The check number."
          },
          "dataValue": {
            "type": "string",
            "example": "TEST",
            "description": "Information linked to the miscellaneous id."
          },
          "miscId": {
            "type": "integer",
            "format": "int64",
            "example": 9,
            "description": "ID for miscellaneous information."
          }
        },
        "title": "CheckMenuMixMiscCheckDetailDto",
        "description": "CheckMenuMixMiscCheckDetailDto description"
      },
      "CheckMenuMixMiscItemDetailDto": {
        "type": "object",
        "required": [
          "checkNumber",
          "dataValue",
          "miscId",
          "pluNumber",
          "posLineNumber"
        ],
        "properties": {
          "checkNumber": {
            "type": "string",
            "example": 12345,
            "description": "The check number."
          },
          "dataValue": {
            "type": "string",
            "example": "TEST",
            "description": "Information linked to the miscellaneous id."
          },
          "miscId": {
            "type": "integer",
            "format": "int64",
            "example": 9,
            "description": "ID for miscellaneous information"
          },
          "pluNumber": {
            "type": "integer",
            "format": "int64",
            "example": 9999,
            "description": "Price lookup number for Recipe item."
          },
          "posLineNumber": {
            "type": "integer",
            "format": "int64",
            "example": 12345,
            "description": "The line number of the Recipe item on the check"
          }
        },
        "title": "CheckMenuMixMiscItemDetailDto",
        "description": "CheckMenuMixMiscItemDetailDto description"
      },
      "CheckMenuMixTimeDetailDto": {
        "type": "object",
        "required": [
          "checkNumber",
          "posTimeId",
          "value"
        ],
        "properties": {
          "checkNumber": {
            "type": "string",
            "example": 12345,
            "description": "The check number."
          },
          "posTimeId": {
            "type": "integer",
            "format": "int64",
            "example": 9,
            "description": "ID for time sensitive tasks."
          },
          "value": {
            "type": "number",
            "example": 9,
            "description": "Duration of a task in seconds."
          }
        },
        "title": "CheckMenuMixTimeDetailDto",
        "description": "CheckMenuMixTimeDetailDto description"
      },
      "ObjectError": {
        "type": "object",
        "properties": {
          "arguments": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "code": {
            "type": "string"
          },
          "codes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "defaultMessage": {
            "type": "string"
          },
          "objectName": {
            "type": "string"
          }
        },
        "title": "ObjectError"
      }
    }
  }
}
```