---
title: "saveLocationV1"
method: POST
path: "/cruise/location/v1/saveLocation"
tags: ["Location Service"]
---

# saveLocationV1

`POST /cruise/location/v1/saveLocation`

## Request

- Base URL: `//webservices-test.net-chef.com` (relative, and the document’s source URL is not known)
- URL: `//webservices-test.net-chef.com/cruise/location/v1/saveLocation`
- Auth: none declared. Required headers: `authenticationtoken`, `password`, `sitename`, `userid`

Create a new location. 
 Update a location's details.

## Headers

- `authenticationtoken` string, required
- `password` string, required
- `sitename` string, required
- `userid` string, required
- `X-B3-TraceId` string

## Request body

- LocationDetails: LocationDetails description
  - `locationAltAddressDetails` LocationAltAddrDetailDto[]
    - `acapCode` string: "ACAP Code" from Location setup screen.
    - `accoCode` string: "ACCO Code" from Location setup screen.
    - `altAddressOne` string: "Alt. Address 1" from Location setup screen.
    - `altAddressTwo` string: "Alt. Address 2" from Location setup screen.
    - `altPhone` string: "Alt. Phone" from Location setup screen.
    - `cdpEMail` string: "CDP E-Mail" from Location setup screen.
    - `city` string: "City" from Location setup screen.
    - `companyNameForPO` string: "Company Name for PO" from Location setup screen.
    - `exportCode` string: "Export Code" from Location setup screen.
    - `importCode` string: "Import Code" from Location setup screen.
    - `locationCode` string, required: "Location Code" from Location setup screen.
    - `payrollExportCode` string: "Payroll Export Code" from Location setup screen.
    - `stateProvince` string, required: "State/Province" from Location setup screen.
    - `zip` string, required: "Zip Code" from Location setup screen.
  - `locationCode` string: "Code" from Company setup screen
  - `locationConceptInfoDetails` LocationConceptInfoDetailDto[]
    - `conceptCode` string, required: "Concept Code" from Location setup screen.
    - `conceptName` string, required: "Concept Name" from Location setup screen.
    - `locationCode` string, required: "Location Code" from Location setup screen.
    - `remove` 'N' | 'Y': "Delete" flag (Y/N). If set to ‘Y’, it will delete this Concept from the Location record
  - `locationDeliverInfoDetails` LocationDeliverInfoDetailDto[]
    - `activeFlag` 'N' | 'Y': "Active Flag" from Location setup screen
    - `delete` 'N' | 'Y': "Delete Flag" from Location setup screen
    - `deliverToCode` string, required: "Deliver To Code" from Location setup screen
    - `deliverToName` string, required: "Deliver To Name" from Location setup screen
    - `locationCode` string, required: "Location Code" from Location setup screen
  - `locationDetailDetails` LocationDetailsDetailDto[]
    - `allowAutoPost` 'N' | 'Y', required: 'Auto-Post' flag from Location setup screen.
    - `allowAutoTransfer` 'N' | 'Y': 'Allow Auto-Transfer' flag from Location setup screen.
    - `autoCreatePOSRecipe` 'N' | 'Y': 'Allow Menu Mix File to Create Recipes for Unknown POS Recipes' from Location setup screen.
    - `autoPostDaysOffset` integer: Offset from Post Date ___ Days from Location setup screen.
    - `autoPostMethod` 'A' | 'X': Auto-Post Method from Location setup screen ‘A’ for Auto-Post Inventory or ‘X’ for Auto-Post Inventory By Exception.
    - `autoPostTime` object: Auto-Post Time from Location setup screen.
    - `autoPrepForDepletion` 'N' | 'Y': 'Auto-Daily Prep for sales depletion flag' from Location setup screen.
    - `baseCurrency` string: 'Base Currency' Code from Location setup screen.
    - `biziqCompDate` string, date: The date on which BizIQ year over year comparisons start for the location, in 'YYYYMMDD' format.
    - `borrowCnsEndDate` string, date: 'Use Historical Consumption from' Date from Location setup screen.
    - `borrowCnsLocationCode` string: 'Use Historical Consumption from' Location Code from Location setup screen.
    - `buffetQuantityAlertPercent` integer: Buffet Quantity Alert (%) from Location setup screen.
    - `dailyPrepReview` 'N' | 'Y': 'Daily Prep Review' flag from Location setup screen.
    - `earliestPostDateTimeBasedOn` 'C' | 'E': 'Earliest Post Date/Time based on' setting from Location setup screen. ‘C’ for Closing Time or ‘E’ for End of Business Day.
    - `gmtOffset` integer: GMT Offset from Location setup screen.
    - `grandOpeningDate` string, date: Opening Date from Location setup screen.
    - `locationCode` string, required: Location Code from Location setup screen
    - `lotTracking` 'N' | 'Y': 'Lot Tracking' flag from Location setup screen
    - `market` string: Market Name from Location setup screen
    - `missingPrepCheck` 'N' | 'Y': 'Check for Missing Prep in Final for Post' flag from Location setup screen.
    - `optimalDaysOnHand` integer: Optimal Days On Hand from Location setup screen
    - `ownershipEntity` string: Ownership Entity from Location setup screen
    - `posFilePath` string: POS File Path from Location setup screen.
    - `posType` string: POS Type from Location setup screen.
    - `productionQuantityAlertPercent` integer: "Production Quantity Alert (%) from Location setup screen.
    - `purchaseType` 'C' | 'D' | 'M': Purchase Type from Location setup screen. ‘M’ for Master Order, ‘D’ for Direct (Vendor) Order, or 'C' for Combination.
    - `secMrktPurchase` 'N' | 'Y': 'Allow purchase from secondary Market Vendors' flag from Location setup screen.
    - `smartPicklist` 'N' | 'Y': 'Smart Picklist' flag from Location setup screen.
    - `software` string: Accounting Software from Location setup screen.
    - `timezone` integer: Time Zone setting from Location setup screen.
  - `locationHoursOfOperationDetails` LocationHoursOfOperationDetailDto[]
    - `closingTime` string: "Closing Time " from Location setup screen.
    - `closingTimeCleanup` string: "Closing Time (Cleanup)" from Location setup screen.
    - `corporateFlag` 'N' | 'Y', required: "Corporate" flag from Location setup screen.
    - `dayOfWeek` integer, required: "Day Of Week" from Location setup screen. '1'– Sun, '2'– Mon, '3'– Tue, '4'- Wed, '5'– Thur, '6'– Fri, '7'– Sat.
    - `locationCode` string, required: Location " Code" from Location setup screen.
    - `openingTime` string: "Opening Time " from Location setup screen.
    - `openingTimeSetup` string: "Opening Time (Setup)" from Location setup screen.
  - `locationLaborDetails` LocationLaborDetailDto[]
    - `businessDayBegins` string: "Business Day Begin Time" from Location setup screen.
    - `corporateFlag` 'N' | 'Y', required: "Corporate" flag from Location setup screen.
    - `locationCode` string, required: Location "Code" from Location setup screen.
  - `locationNameAddressDetails` LocationNameAddrDetailDto[]
    - `activeFlag` 'N' | 'Y': "Active" flag from Location setup screen.
    - `addressOne` string, required: "Address 1" from Location setup screen.
    - `addressTwo` string: "Address 2" from Location setup screen.
    - `city` string, required: "City" from Location setup screen.
    - `country` string: "Country" from Location setup screen.
    - `eMail` string: "E-Mail" from Location setup screen.
    - `fax` string: "Fax" from Location setup screen.
    - `franchiseCode` string: "Franchise Code" from Location setup screen.
    - `locationADRemoteName` string: "AD Location Name" from Location setup screen.
    - `locationCode` string, required: "Location Code" from Location setup screen.
    - `locationName` string, required: "Location Name" from Location setup screen.
    - `phone` string: "Phone" from Location setup screen.
    - `prefix` string
    - `stateProvince` string: "State/Province" from Location setup screen.
    - `zip` string: "Zip Code" from Location setup screen.
  - `locationPostDetails` LocationPostDetailDto[]
    - `enabledFlag` 'N' | 'Y', required: "Enabled" flag from Location setup screen.
    - `locationCode` string, required: Location "Code" from Location setup screen.
    - `postingGrp` string, required: "Posting Group ID" from Location setup screen.
  - `locationSafeLogDetails` LocationSafeLogDetailDto[]
    - `locationCode` string, required: Location "Code" from Location setup screen.
    - `safeLogName` string, required: "Safe Log Name" from Location Safe Log screen.
    - `expectedValue` number, required: "Expected Value" from Location Safe Log screen.
    - `currencyCode` string, required: "Currency Code" from Location Safe Log screen. Supported values include USD, CAD, GBP, EUR, AUD, AED, and SAR.
    - `activeFlag` 'N' | 'Y': "Active Flag" from Location Safe Log screen.
    - `noteRequiredForVarianceFlag` 'N' | 'Y': "Note Required" flag from Location Safe Log screen. If 'Y', user must include a note with each Safe Log entry.
    - `varianceThreshold` integer: "Note Variance" from Location Safe Log screen; indicates the acceptable threshold for a discrepancy between the Expected and Actual values.
  - `locationTimeClockInTwxDetails` LocationTimeClockInTwxDetailDto[]
    - `allowTimeClockInMTX` boolean: "allowTimeClockInMTX" from Location Labor setup screen
    - `allowTimeClockInTWX` boolean: "allowTimeClockInTWX" from Location Labor setup screen
    - `locationCode` string, required: "Location Code" from Location setup screen
    - `minutesEarly` integer: "minutesEarly" from Location Labor setup screen
    - `minutesLate` integer: "minutesLate" from Location Labor setup screen
    - `prefix` string
    - `contentReportingEmail` string: "Inappropriate Content Reporting Emails" from Location -> Labor setup screen

## Response `200`

Success

- object

## Other responses

- `400`: Validation Error
- `401`: Authorization
- `429`: Too Many Requests
- `500`: Unexpected Error
- `503`: System under maintenance
- `504`: Timeout

---

[API](https://skmtc.dev/crunchtime/apis/cruise-platform.md) - [All operations](https://skmtc.dev/crunchtime/apis/cruise-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/crunchtime/apis/cruise-platform/revisions/d6bb0437a907?raw)
