openapi: 3.2.0
info:
  description: Swagger documentation supporting mobile development of Crunchtime.
  version: '2.99'
  title: Inventory & Labor Authentication Service API
  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
servers:
- url: //webservices-test.net-chef.com
tags:
- name: Authentication Service
  description: The Authentication Service is allowing to validate user access to a franchisee site using a username and password.
paths:
  /ces-auth/validate-user:
    post:
      tags:
      - Authentication Service
      summary: validate-user
      description: Validate user access to a franchisee site using a username and password.
      operationId: validateUserUsingPOST
      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: false
        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: false
        schema:
          type: string
      - in: header
        name: X-B3-TraceId
        description: Optional trace identifier for troubleshooting.
        required: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
        description: requestBody
      responses:
        '200':
          description: Pass
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult'
            application/json:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult'
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult'
        '400':
          description: Fail - Validation Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-400'
            application/json:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-400'
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-400'
        '401':
          description: Fail - Authentication Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-401'
            application/json:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-401'
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-401'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
            application/json;charset=UTF-8:
              schema:
                type: string
        '500':
          description: Fail - Unexpected Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-500'
            application/json:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-500'
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/CesAuthenticationResult-500'
        '503':
          description: Site temporarily down
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
            application/json;charset=UTF-8:
              schema:
                type: string
        '504':
          description: Timeout
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
            application/json;charset=UTF-8:
              schema:
                type: string
components:
  schemas:
    CesAuthenticationResult-401:
      type: object
      required:
      - result
      properties:
        detail:
          type: string
          example: Unauthorized
          description: Detail of authentication failure
        result:
          type: string
          example: Fail
          description: Result of CES authentication
          enum:
          - '"Fail"'
          - '"Pass"'
      title: CesAuthenticationResult-401
      description: Authentication Result with Http Status Code 401
    CesAuthenticationResult-500:
      type: object
      required:
      - result
      properties:
        detail:
          type: string
          example: Site https://ces-auto-margqa-2-5-nc.mynet-chef.com is currently unavailable
          description: Detail of authentication failure
        result:
          type: string
          example: Fail
          description: Result of CES authentication
          enum:
          - '"Fail"'
          - '"Pass"'
      title: CesAuthenticationResult-500
      description: Authentication Result with Http Status Code 500
    CesAuthenticationResult:
      type: object
      required:
      - result
      properties:
        result:
          type: string
          example: Pass
          description: Result of CES authentication
          enum:
          - '"Fail"'
          - '"Pass"'
      title: CesAuthenticationResult
      description: Authentication Result from CES
    CesAuthenticationResult-400:
      type: object
      required:
      - result
      properties:
        detail:
          type: string
          example: Missing required header input "password"
          description: Detail of authentication failure
        result:
          type: string
          example: Fail
          description: Result of CES authentication
          enum:
          - '"Fail"'
          - '"Pass"'
      title: CesAuthenticationResult-400
      description: Authentication Result with Http Status Code 400
externalDocs:
  description: Crunchtime Developer Hub
  url: https://developer.crunchtime.com/
x-provenance:
  method: searched
  source: https://developer.crunchtime.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer.crunchtime.com/reference/downloadscheduledexportsv1usingget.md
  - https://developer.crunchtime.com/reference/downloadscheduledexportsv2usingget.md
  - https://developer.crunchtime.com/reference/get15minutessalesforecastbypagev1usingget.md
  - https://developer.crunchtime.com/reference/get15minutessalesforecastv1usingget.md
  - https://developer.crunchtime.com/reference/get_commissaryorder-v1-getcommissaryordersbypage.md
  - https://developer.crunchtime.com/reference/get_customerorderenhanced-v1-getcustomerorderenhancedbypage.md
  - https://developer.crunchtime.com/reference/getallapplicationusersv1usingget.md
  - https://developer.crunchtime.com/reference/getallbudgetv1usingget.md
  - https://developer.crunchtime.com/reference/getallcategoryv1usingget.md
  - https://developer.crunchtime.com/reference/getallcheckmenumixrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getallcommissaryordersv1usingget.md
  - https://developer.crunchtime.com/reference/getallcompanyproductsenhancedv1usingget.md
  - https://developer.crunchtime.com/reference/getallconfirmreceiptstandardv1usingget.md
  - https://developer.crunchtime.com/reference/getallcurrencyratiov1usingget.md
  - https://developer.crunchtime.com/reference/getallcustomerorderenhancedv1usingget.md
  - https://developer.crunchtime.com/reference/getallcustomerrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getalldailyprepsv1usingget.md
  - https://developer.crunchtime.com/reference/getallgeneralledgersv1usingget.md
  - https://developer.crunchtime.com/reference/getallinventoryadjustmentv1usingget.md
  - https://developer.crunchtime.com/reference/getallinventorylocationtransfersv1usingget.md
  - https://developer.crunchtime.com/reference/getallinventoryvalueadjustmentv1usingget.md
  - https://developer.crunchtime.com/reference/getalllocationproductpricingv1usingget.md
  - https://developer.crunchtime.com/reference/getalllocationsv1usingget.md
  - https://developer.crunchtime.com/reference/getallnutritionv1usingget.md
  - https://developer.crunchtime.com/reference/getallpackagetypesv2usingget.md
  - https://developer.crunchtime.com/reference/getallpbisbypagev2usingget.md
  - https://developer.crunchtime.com/reference/getallpbisv2usingget.md
  - https://developer.crunchtime.com/reference/getallphysicalinventorystandardusingget.md
  - https://developer.crunchtime.com/reference/getallprojectedconsumptionv1usingget.md
  - https://developer.crunchtime.com/reference/getallpurchaseordersv1usingget.md
  - https://developer.crunchtime.com/reference/getallrecipelocationv1usingget.md
  - https://developer.crunchtime.com/reference/getallrecipesenhancedv2usingget.md
  - https://developer.crunchtime.com/reference/getallsalesmixrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getallscheduledexportsv1usingget.md
  - https://developer.crunchtime.com/reference/getallstoragelocationv1usingget.md
  - https://developer.crunchtime.com/reference/getallsupplementalwagerecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getalltimeclockenhancedrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorlocationv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorpaymentv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorproductpricingv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorsv1usingget.md
  - https://developer.crunchtime.com/reference/getapplicationusersbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getattachmentsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getattachmentsbypagev2.md
  - https://developer.crunchtime.com/reference/getbudgetbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcategorybypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcheckmenumixrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcompanyproductsenhancedbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getconfirmreceiptstandardbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcurrencyratiobypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcurrentinventorybypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcustomerrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getdailyprepsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getdailysalesforecastbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getdailysalesforecastv1usingget.md
  - https://developer.crunchtime.com/reference/getemployeenumbersv1usingget.md
  - https://developer.crunchtime.com/reference/getemployeesbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getemployeev1usingget.md
  - https://developer.crunchtime.com/reference/gethierarchiesv2usingget.md
  - https://developer.crunchtime.com/reference/gethierarchydetailsv2usingget.md
  - https://developer.crunchtime.com/reference/gethourlysalesforecastbypagev1usingget.md
  - https://developer.crunchtime.com/reference/gethourlysalesforecastv1usingget.md
  - https://developer.crunchtime.com/reference/getinventoryadjustmentbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getinventorylocationtransfersbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getinventoryvalueadjustmentbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getlocationproductpricingbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getlocationsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getnutritionbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getpackagetypesbypagev2usingget.md
  - https://developer.crunchtime.com/reference/getphysicalinventorystandardbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getprojectedconsumptionbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getpurchaseordersbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getrecipelocationbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getrecipesenhancedbypagev2usingget.md
  - https://developer.crunchtime.com/reference/getsalesmixrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getschedulesv1usingget.md
  - https://developer.crunchtime.com/reference/getstoragelocationbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getsupplementalwagerecordsbypageusingget.md
  - https://developer.crunchtime.com/reference/gettimeclockenhancedrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getudalocationsusingget.md
  - https://developer.crunchtime.com/reference/getudavendorsusingget.md
  - https://developer.crunchtime.com/reference/getvendorlocationbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getvendorpaymentbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getvendorproductpricingbypagev1usingget.md
  - https://developer.crunchtime.com/reference/markscheduledexportsv1usingput.md
  - https://developer.crunchtime.com/reference/save15minutessalesforecastusingpost.md
  - https://developer.crunchtime.com/reference/saveapplicationusersv1usingpost.md
  - https://developer.crunchtime.com/reference/savebudgetusingpost.md
  - https://developer.crunchtime.com/reference/savecategoryusingpost.md
  - https://developer.crunchtime.com/reference/savecheckmenumixrecordsv1usingpost.md
  - https://developer.crunchtime.com/reference/savecompanyproductenhancedv1usingpost.md
  - https://developer.crunchtime.com/reference/saveconfirmreceiptstandardusingpost.md
  - https://developer.crunchtime.com/reference/savecurrencyratiousingpost.md
  - https://developer.crunchtime.com/reference/savecustomerorderenhancedusingpost.md
  - https://developer.crunchtime.com/reference/savecustomerrecordsusingpost.md
  - https://developer.crunchtime.com/reference/savedailyprepsusingpost.md
  - https://developer.crunchtime.com/reference/savedailysalesforecastusingpost.md
  - https://developer.crunchtime.com/reference/saveelectronicinvoiceusingpost.md
  - https://developer.crunchtime.com/reference/saveemployeev1usingpost.md
  - https://developer.crunchtime.com/reference/savegeneralledgerv1usingpost.md
  - https://developer.crunchtime.com/reference/savehierarchyv2usingpost.md
  - https://developer.crunchtime.com/reference/savehourlysalesforecastusingpost.md
  - https://developer.crunchtime.com/reference/saveinventoryadjustmentusingpost.md
  - https://developer.crunchtime.com/reference/saveinventoryvalueadjustmentusingpost.md
  - https://developer.crunchtime.com/reference/savelocationproductpricingusingpost.md
  - https://developer.crunchtime.com/reference/savelocationv1usingpost.md
  - https://developer.crunchtime.com/reference/savenutritionusingpost.md
  - https://developer.crunchtime.com/reference/savepackagetypesv2usingpost.md
  - https://developer.crunchtime.com/reference/savepbiv2usingpost.md
  - https://developer.crunchtime.com/reference/savephysicalinventorystandardusingpost.md
  - https://developer.crunchtime.com/reference/saveprojectedconsumptionusingpost.md
  - https://developer.crunchtime.com/reference/savepurchaseordersusingpost.md
  - https://developer.crunchtime.com/reference/saverecipelocationusingpost.md
  - https://developer.crunchtime.com/reference/saverecipesv2usingpost.md
  - https://developer.crunchtime.com/reference/savesalesmixrecordusingpost.md
  - https://developer.crunchtime.com/reference/savestoragelocationusingpost.md
  - https://developer.crunchtime.com/reference/savesupplementalwagerecordsusingpost.md
  - https://developer.crunchtime.com/reference/savetimeclockenhancedrecordsusingpost.md
  - https://developer.crunchtime.com/reference/savevendorlocationv1usingpost.md
  - https://developer.crunchtime.com/reference/savevendorpaymentusingpost.md
  - https://developer.crunchtime.com/reference/savevendorv1usingpost.md
  - https://developer.crunchtime.com/reference/validateuserusingpost.md
  merge:
    pages: 122
    deduped: 334
    conflicts_kept_first: 0