Replacement Tags
Replacement tags are placeholders in the e-mail templates that are automatically replaced with dynamic content in various situations.
They can be recognized by the brackets in the text of the e-mail template, for example, [ORDERNUMBER]. These tags are automatically replaced by the external values when the e-mail is sent. The replacement tags ensure that dynamic content, for example, order details, customer names, or webstore contact information is accurately inserted into each system e-mail without manual input. If you need to change the content of the e-mail template, do not change or translate the replacement tags.
The purpose of replacement tags is to personalize and automate e-mail communication between webstore administrators and customers, maintaining consistency and data accuracy, and reducing errors.
The webstore information used in the e-mails sent from the Sana webstore, including store name, store phone number, store e-mail address can be changed in Sana Admin: Setup > Basics.
The table below provides the list of all replacement tags used in the e-mail templates of Sana Commerce Cloud.
| Name | Description | Template Identifier (Webstore and Admin) |
|---|---|---|
| ACCOUNTID | The shop account ID. | Admin: BasketCalculationError |
| ADDITIONAL_ORDER_INFORMATION | The reference number, comments, and the requested delivery date of the sales order. | Webstore: EditOrderConfirmation EditQuoteConfirmation GuestOrderConfirmation GuestOrderReceived InvoicePaymentConfirmation OrderConfirmation OrderPayment OrderPaymentCancellation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation UnprocessedOrderConfirmation UnprocessedQuoteConfirmation Admin: ReturnOrderAdminNotification |
| AMOUNT | The authorised, captured, or refunded payment amount. | Webstore: SanaPay__AuthorisationAmountChanged Admin: CapturePaymentAdminNotification RefundPaymentAdminNotification |
| ATTACHMENTS | The links to the sales order, quotation, and return order attachments. | Webstore: EditOrderConfirmation EditQuoteConfirmation GuestOrderConfirmation GuestOrderReceived OrderPayment OrderPaymentCancellation OrderReceived PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation UnprocessedOrderConfirmation UnprocessedQuoteConfirmation Admin: ReturnOrderAdminNotification |
| AUTHORIZATION_FEEDBACK | The comment of an authorizer explaining why the order was declined. | Webstore: OrderAuthorizationDeclined |
| BASKETID | The shopping cart ID. | Admin: BasketCalculationError |
| BLOGTITLE | The blog article title. | Admin: IncomingBlogCommentNotification |
| BLOGURL | The blog article URL. | Admin: IncomingBlogCommentNotification |
| Comments | The comments of the message sender. | Admin: ContactUs |
| COMMENTURL | The URL of a blog article comment. | Admin: IncomingBlogCommentNotification |
| CompanyName | The company name. | Admin: ContactUs |
| CREATEDTIME | The time and date a user tries to log in to Sana Admin from an unknown device. | Admin: UnknownDeviceLogin UnknownDeviceVerification |
| CURRENCYID | The currency ID. | Webstore: SanaPay__AuthorisationAmountChanged Admin: CapturePaymentAdminNotification RefundPaymentAdminNotification |
| CUSTOMERNUMBER | The customer number. | Webstore: CapturePaymentAdminNotification Admin: CapturePaymentAdminNotification InvoicePaymentConfirmationForShopManagers InvoicePaymentRegistrationFailedForShopManagers NewB2BShopAccountToShopAdmin OrderPaymentErrorAdminNotification RefundPaymentAdminNotification |
| DAYS | The number of days that have passed since the last order was created and not authorized (approved or declined). | Webstore: OrderAuthorizationReminderMail |
| DATE | The date when the basket calculation error occurred. | Admin: BasketCalculationError |
| DEVICE_BROWSER | The name of a browser a user uses to log in to Sana Admin from an unknown device. | Admin: UnknownDeviceLogin UnknownDeviceVerification |
| DEVICE_OS | The operating system of an unknown device a user uses to log in to Sana Admin. | Admin: UnknownDeviceLogin UnknownDeviceVerification |
| The company e-mail. | Admin: CapturePaymentAdminNotification ContactUs OrderPaymentErrorAdminNotification RefundPaymentAdminNotification |
|
| ERRORDETAILS | The details about why the order payment has failed. | Admin: OrderPaymentErrorAdminNotification |
| ERRORMESSAGE | The message of why the basket calculation error occurred. | Admin: BasketCalculationError |
| EXCEPTION | The reason for the scheduled task failure. | Admin: TaskFailureNotification |
| EXCEPTIONDETAILS | The error details of the failed scheduled task. | Admin: TaskFailureNotification |
| LINKVALIDITY | The number of hours for which the payment link is valid. | Webstore: SanaPay__PayByEmail |
| MESSAGE | The details of an issue. | Admin: ServiceAvailabilityNotification TechnicalAdminErrorNotification |
| MORE_INFORMATION_TEXT | Additional details. | Webstore: OrderReceived PunchoutOrderConfirmation QuoteConfirmation UnprocessedQuoteConfirmation |
| NAME | The name of a customer in the Sana webstore. | Webstore: AccountChangedNotification ChangePassword EditOrderConfirmation EditQuoteConfirmation ForgotPassword GuestOrderConfirmation GuestOrderReceived InvoicePaymentConfirmation NewB2BShopAccount NewShopAccount NewShopAccountByShopAdmin NewSingleSignOnShopAccountByShopAdmin NewSubAccountSetPassword OrderAuthorizationApproved OrderAuthorizationDeclined OrderAuthorizationReminderMail OrderAuthorizationRequest OrderConfirmation OrderPayment OrderPaymentCancellation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation ShopAccountApproved ShopAccountEmailConfirmation SubscriptionCancelled SubscriptionConfirmationMail SubscriptionCreated SubscriptionOrderSkippedEmail SubscriptionReminderMail SubscriptionsFeatureDisabledNotification UnprocessedOrderConfirmation UnprocessedQuoteConfirmation Admin: AdminUserAccountChangedNotification CapturePaymentAdminNotification ContactUs ForgotPasswordAdmin InvoicePaymentConfirmationForShopManagers InvoicePaymentRegistrationFailedForShopManagers NewB2BShopAccountToShopAdmin OrderPaymentErrorAdminNotification RefundPaymentAdminNotification ReturnOrderAdminNotification UnknownDeviceLogin UnknownDeviceVerification |
| ORDERADDRESS | The billing and shipping addresses of the sales order. | Webstore: EditOrderConfirmation EditQuoteConfirmation GuestOrderConfirmation GuestOrderReceived OrderConfirmation OrderPayment OrderPaymentCancellation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation UnprocessedOrderConfirmation UnprocessedQuoteConfirmation ReturnOrderAdminNotification |
| ORDERAUTHORIZER | The order authorizer name in the Sana webstore. | Webstore: OrderAuthorizationApproved OrderAuthorizationDeclined |
| ORDERAUTHORIZERS | The order authorizers' names in the Sana webstore. | Webstore: EditOrderConfirmation EditQuoteConfirmation GuestOrderConfirmation GuestOrderReceived InvoicePaymentConfirmation OrderConfirmation OrderReceived PunchoutOrderConfirmation Admin: InvoicePaymentConfirmationForShopManagers InvoicePaymentRegistrationFailedForShopManagers |
| ORDERDETAILS | The sales order details. | Webstore: EditOrderConfirmation EditQuoteConfirmation GuestOrderConfirmation GuestOrderReceived InvoicePaymentConfirmation OrderConfirmation OrderPayment OrderPaymentCancellation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation SanaPay__PayByEmail UnprocessedOrderConfirmation UnprocessedQuoteConfirmation Admin: InvoicePaymentConfirmationForShopManagers InvoicePaymentRegistrationFailedForShopManagers ReturnOrderAdminNotification |
| ORDERID | The sales order ID. | Webstore: SanaPay__CaptureFailed SanaPay__PaymentCancelled SanaPay__RefundFailed |
| ORDERNUMBER | The sales order ID. | Webstore: EditOrderConfirmation EditQuoteConfirmation GuestOrderConfirmation GuestOrderReceived OrderAuthorizationApproved OrderAuthorizationDeclined OrderAuthorizationRequest OrderConfirmation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation SanaPay__PayByEmail UnprocessedQuoteConfirmation Admin: CapturePaymentAdminNotification OrderPaymentErrorAdminNotification RefundPaymentAdminNotification ReturnOrderAdminNotification |
| ORIGINALTRANSACTIONID | The payment transaction ID. | Admin: CapturePaymentAdminNotification RefundPaymentAdminNotification |
| PAYBYLINK | The payment link to pay orders through Sana Pay. | Webstore: SanaPay__PayByEmail |
| PAYMENTTRANSACTIONID | The payment transaction ID. | Admin: InvoicePaymentConfirmationForShopManagers InvoicePaymentRegistrationFailedForShopManagers |
| PAYMENT_SHIPPING_INFORMATION | Order shipping and payment information. | Webstore: EditOrderConfirmation EditQuoteConfirmation GuestOrderConfirmation GuestOrderReceived OrderConfirmation OrderReceived PunchoutOrderConfirmation |
| PAUSED_SUBSCRIPTIONS | The order details of the paused subscriptions. | Admin: SubscriptionsCancelledAdminNotification |
| PhoneNo | The phone number of the message sender. | Admin: ContactUs |
| PREVIOUSAMOUNT | The authorised payment amount before the change. | Webstore: SanaPay__AuthorisationAmountChanged |
| REASON | The reason for the failed payment amount adjustment, capture, or refund. | Webstore: SanaPay__AuthorisationAdjustmentFailed SanaPay__CaptureFailed SanaPay__RefundFailed |
| SERVICE_NAME | The third-party service name where an issue occurred. | Admin: ServiceAvailabilityNotification |
| SHOPACCOUNT | The shop account that placed an order. | Webstore: SanaPay__PayByEmail |
| SHOPACCOUNTEMAIL | The e-mail address the customer used to register in the webstore online or a webstore administrator to create a shop account for a B2B customer directly in Sana Admin. The e-mail is used by the customer to log in to the webstore. | Webstore: NewB2BShopAccount NewShopAccount NewShopAccountByShopAdmin NewSingleSignOnShopAccountByShopAdmin ShopAccountApproved Admin: BasketCalculationError NewB2BShopAccountToShopAdmin |
| SHOPACCOUNTENAME | The customer name. | Admin: BasketCalculationError |
| SHOPEMAIL | The webstore e-mail address. | Webstore: EditOrderConfirmation GuestOrderConfirmation GuestOrderReceived InvoicePaymentConfirmation OrderAuthorizationApproved OrderAuthorizationDeclined OrderAuthorizationReminderMail OrderAuthorizationRequest OrderConfirmation OrderPayment OrderPaymentCancellation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation SubscriptionCancelled SubscriptionConfirmationMail SubscriptionCreated SubscriptionOrderSkippedEmail SubscriptionReminderMail SubscriptionsFeatureDisabledNotification UnprocessedOrderConfirmation UnprocessedQuoteConfirmation |
| SHOPNAME | The webstore name. | Webstore: AccountChangedNotification ChangePassword EditOrderConfirmation EditQuoteConfirmation ForgotPassword GuestOrderConfirmation GuestOrderReceived InvoicePaymentConfirmation NewB2BShopAccount NewShopAccount NewShopAccountByShopAdmin NewSingleSignOnShopAccountByShopAdmin NewSubAccountSetPassword OrderAuthorizationApproved OrderAuthorizationDeclined OrderAuthorizationReminderMail OrderAuthorizationRequest OrderConfirmation OrderPayment OrderPaymentCancellation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation SanaPay__AuthorisationAdjustmentFailed SanaPay__AuthorisationAmountChanged SanaPay__CaptureFailed SanaPay__PayByEmail SanaPay__PaymentCancelled SanaPay__RefundFailed ShopAccountApproved ShopAccountEmailConfirmation SubscriptionCancelled SubscriptionConfirmationMail SubscriptionCreated SubscriptionOrderSkippedEmail SubscriptionReminderMail SubscriptionsFeatureDisabledNotification UnprocessedOrderConfirmation UnprocessedQuoteConfirmation Admin: AdminUserAccountChangedNotification BasketCalculationError CapturePaymentAdminNotification ERPConnectionAvailable ERPConnectionUnavailable ForgotPasswordAdmin InvoicePaymentConfirmationForShopManagers InvoicePaymentRegistrationFailedForShopManagers NewB2BShopAccountToShopAdmin OrderPaymentErrorAdminNotification RefundPaymentAdminNotification ReturnOrderAdminNotification ServiceAvailabilityNotification SubscriptionsCancelledAdminNotification TaskFailureNotification TechnicalAdminErrorNotification UnknownDeviceLogin UnknownDeviceVerification |
| SHOPPHONE | The webstore phone number. | Webstore: EditOrderConfirmation GuestOrderConfirmation GuestOrderReceived InvoicePaymentConfirmation OrderAuthorizationApproved OrderAuthorizationDeclined OrderAuthorizationReminderMail OrderAuthorizationRequest OrderConfirmation OrderPayment OrderPaymentCancellation OrderReceived PaymentConfirmation PunchoutOrderConfirmation QuoteConfirmation ReturnOrderConfirmation SubscriptionCancelled SubscriptionConfirmationMail SubscriptionCreated SubscriptionOrderSkippedEmail SubscriptionReminderMail SubscriptionsFeatureDisabledNotification UnprocessedOrderConfirmation UnprocessedQuoteConfirmation |
| SUBACCOUNT_NAME | The name of a sub-account in the Sana webstore. | Webstore: OrderAuthorizationRequest |
| SUBSCRIPTION_DETAILS | The subscription details. | Webstore: SubscriptionCreated |
| SUBSCRIPTION_FREQUENCY | The subscription frequency intervals. | Webstore: SubscriptionConfirmationMail SubscriptionCreated SubscriptionReminderMail |
| SUBSCRIPTION_NAME | The name of a subscription. | Webstore: SubscriptionCancelled SubscriptionConfirmationMail SubscriptionCreated SubscriptionOrderSkippedEmail |
| SUBSCRIPTION_NEXT_ORDER_DATE | The date of the next subscription order. | Webstore: SubscriptionConfirmationMail SubscriptionCreated SubscriptionReminderMail |
| SUBSCRIPTION_ORDER_CONFIRMATION_URL | The link to confirm an upcoming subscription order. | Webstore: SubscriptionConfirmationMail |
| SUBSCRIPTION_PAUSE_REASON | The reason why a subscription was paused. | Webstore: SubscriptionCancelled |
| TASKNAME | The name of a scheduled task that failed. | Admin: TaskFailureNotification |
| TIMESTAMP | The time when the scheduled task failed. | Admin: TaskFailureNotification |
| TRANSACTIONID | The payment transaction ID. | Webstore: SanaPay__AuthorisationAdjustmentFailed SanaPay__AuthorisationAmountChanged SanaPay__CaptureFailed SanaPay__PaymentCancelled SanaPay__RefundFailed Admin: OrderPaymentErrorAdminNotification |
| TRANSACTIONTYPE | The payment transaction type. | Admin: OrderPaymentErrorAdminNotification |
| UPDATEDDATA | The message informing a Sana Admin user about account details that were updated. | Admin: AdminUserAccountChangedNotification |
| URL | The link to reset the shop account password. | Webstore: ForgotPassword NewShopAccountByShopAdmin NewSubAccountSetPassword ShopAccountApproved Admin: ForgotPasswordAdmin |
| USERNAME | The user name who added a new comment to a blog. | Admin: IncomingBlogCommentNotification |
| USEREMAILADDRESS | The user e-mail address who added a new comment to a blog. | Admin: IncomingBlogCommentNotification |
| WEBSITEDOMAIN | The full link to the webstore. | The replacement tag is available in most e-mail templates. |
