ReceiptTemplates (Partial Update)
Description
See the Aerial Spec for more details.
File Naming Convention
TGEN_receiptTemplates_partialupdate_2026-04_<optionalSuffix>.csv
importType:partialupdateapiVersion:2026-04
Columns
| Column Header | Description | Key Information | Type | Required |
|---|---|---|---|---|
externalId | The external identifier of the receipt template | string | No | |
languageCode | The language code for the receipt template | string | No | |
disabled | Boolean dictating if the receipt template is disabled (true or false) | boolean | No | |
scope | Scope of this receipt template, templates with a more specific scope are prioritized. | Allowed: global, country, store | string | No |
countryCode | The country code in ISO-3166-1 alpha-3 format for the receipt template | string | No | |
merchantLogoUrl | URL for the logo image to be shown on the receipt | string | No | |
merchantMessage | The merchant message for this receipt template. | string | No | |
emailFooterMessage | The footer for the email used for this receipt template. | string | No | |
emailBodyMessage | The body of the email used for this receipt template. | string | No | |
emailTaxDisclaimer | The tax disclaimer message for this receipt template. | string | No | |
emailRefundDisclaimer | The refund disclaimer message for this receipt template. | string | No | |
stores | List of associated stores | array | No | |
stores[0] | Array element | mixed | No | |
stores[0].externalId | Integrator provided unique identifier for the store. Typically used to map a primary key from a third party system to the Tulip resource. | Max Length: 255 | string | Yes |
stores[0].disabled | Boolean dictating if store is disabled (true or false) | boolean | No | |
stores[0].name | Name of the store | string | Yes | |
stores[0].businessEntityName | Business entity name of the store | string | No | |
stores[0].address | Address of the store | string | Yes | |
stores[0].city | City of the store | string | No | |
stores[0].postalCode | Postal code of the store | string | Yes | |
stores[0].zoneCode | Zone code of the store: The ISO-3166-2 region code (including the country code portion) for the state/province/region | string | No | |
stores[0].countryCode | Country ISO code in ISO-3166-1 alpha-3 format | string | Yes | |
stores[0].latitude | Latitude of the store (up to 6 decimal places of precision) | string | No | |
stores[0].longitude | Longitude of the store (up to 6 decimal places of precision) | string | No | |
stores[0].taxDivision | Tax Division of the store | string | No | |
stores[0].taxProvider | Tax Provider of the store - use an ID from the tax provider API | string | No | |
stores[0].remotePayAdyenMerchantAccount | Remote Pay Adyen Merchant Account | string | No | |
stores[0].onlineStore | Online store associated with this store. | string | No | |
stores[0].emailAddress | Email Address of the store | string | No | |
stores[0].phoneNumber | Phone number of the store (E.164 standard) | string | No | |
stores[0].mobilePhoneNumber | Mobile phone number of the store (E.164 standard) | string | No | |
stores[0].receiptLanguageCode | Language code to use for receipts from this store | string | No | |
stores[0].district | UUID of the district associated with this store. | string | No | |
stores[0].timeZone | Time zone in IANA format this store is in | string | No | |
stores[0].settings | N/A | mixed | Yes | |
stores[0].settings.runnerEnabled | Boolean dictating whether runner is enabled for the store (true or false) | boolean | No | |
stores[0].settings.liveConnectEnabled | Boolean dictating if store has live connect enabled (true or false) | boolean | No | |
stores[0].settings.fulfillFromMultipleStoresEnabled | Boolean dictating if store is fulfilled from multiple stores (true or false) | boolean | No | |
stores[0].settings.conditionalOrderFlowEnabled | Boolean dictating if conditional order flow is enabled for the store (true or false) | boolean | No | |
stores[0].settings.twilioCallingEnabled | Boolean dictating if Twilio calling is enabled for the store (true or false) | boolean | No | |
stores[0].settings.clientelingLoginEnabled | Boolean dictating if this store is able to be logged into for the Clienteling app | boolean | No | |
stores[0].settings.checkoutLoginEnabled | Boolean dictating if this store is able to be logged into for the Checkout app | boolean | No | |
stores[0].settings.useStoreDetailsToSendEmail | Boolean dictating whether store name and email will be used as for the From/Sender details when sending an email (true or false). If false, the associate name and email will be used | boolean | No | |
stores[0].settings.pendingCustomerFlowEnabled | Whether pending customer flow is enabled for this store or not | Allowed: Default, Enabled, Disabled | string | No |
stores[0].hours | N/A | mixed | Yes | |
stores[0].hours.monday | N/A | mixed | Yes | |
stores[0].hours.monday.open | Time the store opens for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.monday.close | Time the store closes for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.tuesday | N/A | mixed | Yes | |
stores[0].hours.tuesday.open | Time the store opens for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.tuesday.close | Time the store closes for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.wednesday | N/A | mixed | Yes | |
stores[0].hours.wednesday.open | Time the store opens for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.wednesday.close | Time the store closes for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.thursday | N/A | mixed | Yes | |
stores[0].hours.thursday.open | Time the store opens for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.thursday.close | Time the store closes for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.friday | N/A | mixed | Yes | |
stores[0].hours.friday.open | Time the store opens for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.friday.close | Time the store closes for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.saturday | N/A | mixed | Yes | |
stores[0].hours.saturday.open | Time the store opens for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.saturday.close | Time the store closes for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.sunday | N/A | mixed | Yes | |
stores[0].hours.sunday.open | Time the store opens for the day (local timezone, 24-hour format) | string | No | |
stores[0].hours.sunday.close | Time the store closes for the day (local timezone, 24-hour format) | string | No | |
stores[0].storeType | Unique Tulip identifier of the store type | mixed | No | |
stores[0].storeType.uuid | Unique Tulip identifier of the store type | Max Length: 36 | string | No |
stores[0].storeType.externalId | Integrator provided unique identifier for the store. Typically used to map a primary key from a third party system to the Tulip resource. | Max Length: 255 | string | Yes |
stores[0].storeType.name | Name of the store type | Max Length: 255 | string | Yes |
stores[0].tags | Array of store tag UUIDs associated with this store | array | No | |
stores[0].tags[0] | Array element | string | No | |
stores[0].attributes | Array of Attribute Values associated with this store | array | No | |
stores[0].attributes[0] | Array element | mixed | No | |
stores[0].attributes[0].value | Value of the attribute, this will be any type casted to string but supports all basic types | mixed | Yes | |
stores[0].attributes[0].name | External ID of the attribute | Max Length: 255 | string | Yes |
stores[0].attributes[0].languageExternalId | External ID of the language, defaults to english | Max Length: 255 | string | Yes |
stores[0].attributes[0].description | Tulip Attribute description | Max Length: 255 | string | Yes |
stores[0].attributes[0].type | Tulip Attribute Type | Allowed: string, boolean, integer, float | string | Yes |
stores[0].catalogs | Array of catalog IDs (UUIDs or External IDs) associated with this store | array | No | |
stores[0].catalogs[0] | Array element | string | No | |
taxRegistrations | List of tax registrations associated with the template | array | No | |
taxRegistrations[0] | Array element | mixed | No | |
customFields | List of custom fields associated with the template | array | No | |
customFields[0] | Array element | mixed | No |
Sample CSV
See the following receiptTemplates 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.