Salesforce Docs Portal

Localize Receipts in POS App

Use Point of Sale (POS) App to localize the content of the paper receipt based on the user’s choice in the order confirmation screen.

Prerequisites

  • Modern POS App Build: 6.3.1 and later
  • Platform Support: iPad, iPhone
  • Offline Support: yes

Paper Receipt Configuration In Mobile Configuration Settings

  1. Go to Modules > POS > Receipt Configuration.
  2. Select the languages to be supported in the Languages field.
  3. Set the desired default language in Default Language field.
  4. Go to the Text Fields section and find a tab for all the supported languages.
  5. Set the localized text for all the text fields in this section for each tab and click Save.

Configuration Receipt Language Option in Order Confirmation Layouts

  1. Complete the previously-mentioned mobile configuration setting for the receipt language support
  2. Layout Settings > Order Confirmation > Select the existing order confirmation layout
  3. Select the cell where the language dropdown needs to be added
    1. Select Cell Content > Form Element > Dropdown list
    2. Add “ps.print.language” in field
    3. Add any place-holder text if needed
    4. Select add options and use the key for each language
    5. Display name: English, Key : en
    6. Display name: French, Key : fr
    7. Display name: Dutch, Key : nl
    8. Display name: Spanish, Key : es
    9. Display name: Polish, Key : pl
    10. Display name: Portuguese, Key : pt
    11. Display name: Japanese, Key : ja
  4. Save to view the dropdown list in the layout.
  5. Save the layout.

User Documentation

Users can see the preconfigured language in the order confirmation screen and select the ‌language to print the receipt.

The POS app asking you what language you want your paper receipt in, with Polish selected.The POS App asking you what language you want your paper receipt in, with the user selecting English at the bottom.

Limitations

Users can see the preconfigured language in the order confirmation screen and select the ‌language to print the receipt.

  • The terminal translates the EMV lines in Elavon and receipt lines for Adyen only based on the end customer’s language choice with their card issuer
  • POS App supports only English, French, Dutch, Spanish, Polish, Portuguese, Japanese
  • The product names, store addresses, and tax names are from the data feeds for the specific feed uploaded in CMS. These won't be localized to the selected language.
  • The POS app supports printing Japanese characters on Epson printers starting with build 11.1.1.
  • TM-m30II-NT or newer models will work out of the box, as they support all Unicode characters, including Japanese.
  • TM-m30II or older models require additional considerations:
    • The printer has to be purchased in the target region (for example, to print in Japanese, purchase a Japan-region model).
    • If the printer isn't purchased in the target region, a language-specific font file has to be loaded onto the printer via a firmware update.