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

# saveProjectedConsumption

Create a new projected consumption entry. 
 Update a projected consumption entry's details.

# 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": "Projected Consumption Service",
      "description": "The Projected Consumption service is used to get Consumption data that has been systematically calculated based on a Location's Suggested Order configuration, or post Projected Consumption, overriding the system calculated value. Projected Consumption data is used to help a location choose how much to purchase from a vendor or how much to prep for the day."
    }
  ],
  "paths": {
    "/projectedconsumption/v1/saveProjectedConsumption": {
      "post": {
        "tags": [
          "Projected Consumption Service"
        ],
        "summary": "saveProjectedConsumption",
        "description": "Create a new projected consumption entry. \n Update a projected consumption entry's details.",
        "operationId": "saveProjectedConsumptionUsingPOST",
        "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/ProjectedConsumptionDetailsList"
              }
            }
          },
          "description": "projectedConsumptionDetails",
          "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": {
                  "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": {
      "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"
      },
      "ProjectedConsumptionDetails": {
        "type": "object",
        "properties": {
          "projectedConsumptionDetailDetails": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProjectedConsumptionDetailsDto"
            }
          },
          "projectedConsumptionHeaderDetails": {
            "$ref": "#/components/schemas/ProjectedConsumptionHeaderDto"
          }
        },
        "title": "ProjectedConsumptionDetails",
        "description": "ProjectedConsumptionDetails description"
      },
      "ProjectedConsumptionDetailsDto": {
        "type": "object",
        "required": [
          "productNumber",
          "projCnsQty"
        ],
        "properties": {
          "productNumber": {
            "type": "string",
            "example": "R-001",
            "description": "\"productNumber\" from projected consumption"
          },
          "projCnsQty": {
            "type": "number",
            "example": 99999999.9999,
            "description": "\"projCnsQty\" from projected consumption"
          }
        },
        "title": "ProjectedConsumptionDetailsDto",
        "description": "ProjectedConsumptionDetailsDto description"
      },
      "ProjectedConsumptionDetailsList": {
        "type": "object",
        "required": [
          "locationCode"
        ],
        "properties": {
          "locationCode": {
            "type": "string",
            "example": "000122",
            "description": "The Code that identifies the Location in Crunchtime."
          },
          "projectedConsumptionDetails": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProjectedConsumptionDetails"
            }
          }
        },
        "title": "ProjectedConsumptionDetailsList",
        "description": "ProjectedConsumptionDetailsList description"
      },
      "ProjectedConsumptionHeaderDto": {
        "type": "object",
        "required": [
          "locationCode",
          "projCnsDate"
        ],
        "properties": {
          "locationCode": {
            "type": "string",
            "example": "000122",
            "description": "\"locationCode\" from projected consumption"
          },
          "projCnsDate": {
            "type": "string",
            "example": "MM/dd/yyyy",
            "description": "\"projCnsDate\" from projected consumption"
          }
        },
        "title": "ProjectedConsumptionHeaderDto",
        "description": "ProjectedConsumptionHeaderDto description"
      }
    }
  }
}
```