--- title: "saveLocationV1" method: POST path: "/location/v1/saveLocation" tags: ["Location Service"] --- # saveLocationV1 `POST /location/v1/saveLocation` 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.net/crunchtime/apis/inventory-labor.md) · [All operations](https://skmtc.net/crunchtime/apis/inventory-labor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchtime/inventory-labor/revisions/0af8e380ff2c/schema)