Stores (Partial Update)
Description
Patch Store Resources. Accepts a single StorePatch object or an array. Each must include a UUID or External ID to identify the store. Only provided fields are updated. Errors are captured per-item. Note: to clear a field, set its value to the string SET_AS_NULL.
See the Aerial Spec for more details.
File Naming Convention
TGEN_stores_partialupdate_2026-08_<optionalSuffix>.csv
importType:partialupdateapiVersion:2026-08
Columns
Nested object fields are flattened into columns using dot notation (parent.child). Array fields are flattened using zero-based index notation, one element per column (field[0], field[1], and so on).
Note: A whole array cannot be passed in a single column: a literal value such as ['value-1','value-2'] will be rejected. To import multiple array elements, add one indexed column per element. Rows in the table below with type array describe the field as a whole and are not valid CSV column headers.
| Column Header | Description | Key Information | Type | Required |
|---|---|---|---|---|
uuid | UUID of the resource that can be expressed using a value as defined in its types. | string | No | |
externalId | External ID of the resource that can be expressed using a value as defined in its types. | string | No | |
name | Name of the store that can be expressed using a value as defined in its types. | string | No | |
address | Address of the store that can be expressed using a value as defined in its types. | string | No | |
postalCode | Postal code of the store that can be expressed using a value as defined in its types. | string | No | |
countryCode | Country ISO code in ISO-3166-1 alpha-3 format that can be expressed using a value as defined in its types. | string | No | |
disabled | Boolean dictating if store is disabled that can be expressed using a value as defined in its types. | boolean | No | |
businessEntityName | Business entity name of the store that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
city | City of the store that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
zoneCode | Zone code (ISO-3166-2 region code) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
latitude | Latitude of the store that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
longitude | Longitude of the store that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
taxDivision | Tax Division of the store that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
taxProvider | Tax Provider of the store that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
remotePayAdyenMerchantAccount | Remote Pay Adyen Merchant Account that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
onlineStore | Online store UUID that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
emailAddress | Email Address of the store that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
phoneNumber | Phone number of the store (E.164 standard) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
mobilePhoneNumber | Mobile phone number of the store (E.164 standard) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
receiptLanguageCode | Language code for receipts that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
district | UUID of the district that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
timeZone | Time zone in IANA format that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
ecommerceDomain | E-Commerce Domain URL, UUID, or object representation. Use “SET_AS_NULL” to clear. | mixed | No | |
ecommerceDomain.uuid | UUID of the e-commerce domain that can be expressed using a value as defined in its types. | string | No | |
ecommerceDomain.domain | E-Commerce Domain URL that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
storeType | UUID, External ID or object representation of a store type | string | No | |
storeType.uuid | UUID of the resource | string | No | |
storeType.externalId | External ID of the resource | string | No | |
tags | A collection of store tag that can be expressed using “SET_AS_NULL” (to reset all existing values), uuids or expanded objects of the accepted type. | Not a CSV column header. Pass each array element in its own indexed column (tags[0], tags[1], and so on). | array | No |
tags[0] | Array element | mixed | No | |
tags[0].uuid | UUID of the store tag that can be expressed using a value as defined in its types. | string | No | |
tags[0].externalId | External ID of the store tag that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
tags[0].name | Name of the store tag that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
settings | N/A | mixed | No | |
settings.runnerEnabled | Whether runner is enabled for the store that can be expressed using a value as defined in its types. | boolean | No | |
settings.liveConnectEnabled | Whether live connect is enabled for the store that can be expressed using a value as defined in its types. | boolean | No | |
settings.fulfillFromMultipleStoresEnabled | Whether the store is fulfilled from multiple stores that can be expressed using a value as defined in its types. | boolean | No | |
settings.conditionalOrderFlowEnabled | Whether conditional order flow is enabled that can be expressed using a value as defined in its types. | boolean | No | |
settings.twilioCallingEnabled | Whether Twilio calling is enabled that can be expressed using a value as defined in its types. | boolean | No | |
settings.clientelingLoginEnabled | Whether this store can be logged into for the Clienteling app that can be expressed using a value as defined in its types. | boolean | No | |
settings.checkoutLoginEnabled | Whether this store can be logged into for the Checkout app that can be expressed using a value as defined in its types. | boolean | No | |
settings.useStoreDetailsToSendEmail | Whether store name and email are used as From/Sender details when sending email that can be expressed using a value as defined in its types. | boolean | No | |
settings.pendingCustomerFlowEnabled | Whether pending customer flow is enabled for this store that can be expressed using a value as defined in its types. | Allowed: Default, Enabled, Disabled | string | No |
hours | N/A | mixed | No | |
hours.monday | N/A | mixed | No | |
hours.monday.open | Time the store opens (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.monday.close | Time the store closes (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.tuesday | N/A | mixed | No | |
hours.tuesday.open | Time the store opens (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.tuesday.close | Time the store closes (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.wednesday | N/A | mixed | No | |
hours.wednesday.open | Time the store opens (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.wednesday.close | Time the store closes (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.thursday | N/A | mixed | No | |
hours.thursday.open | Time the store opens (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.thursday.close | Time the store closes (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.friday | N/A | mixed | No | |
hours.friday.open | Time the store opens (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.friday.close | Time the store closes (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.saturday | N/A | mixed | No | |
hours.saturday.open | Time the store opens (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.saturday.close | Time the store closes (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.sunday | N/A | mixed | No | |
hours.sunday.open | Time the store opens (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
hours.sunday.close | Time the store closes (local timezone, 24-hour format) that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No | |
catalogs | A collection of catalogs that can be expressed using “SET_AS_NULL” (to reset all existing values), uuids or external ids. | Not a CSV column header. Pass each array element in its own indexed column (catalogs[0], catalogs[1], and so on). | array | No |
catalogs[0] | Array element | mixed | No | |
attributes | A collection of attribute that can be expressed using “SET_AS_NULL” (to reset all existing values) or a value as defined in its types. | Not a CSV column header. Pass each array element in its own indexed column (attributes[0], attributes[1], and so on). | array | No |
attributes[0] | Array element | mixed | No | |
attributes[0].name | Name of the attribute | string | Yes | |
attributes[0].languageExternalId | Language code of the attribute that can be expressed using a value as defined in its types. | string | Yes | |
attributes[0].value | Value of the attribute, this will be any type casted to string but supports all basic types that can be expressed using “SET_AS_NULL” (to reset the existing value) or a value as defined in its types. | string | No |
Sample CSV
See the following stores CSV sample file.
Note: The sample CSV may contain sample ID fields which reference other resources that do not match the data in your environment. You may omit any non-required fields from the sample CSV, reference the table above for required fields.