microsoft / microsoft/Dynamics365Commerce.Solutions
Allow for more control over receipt emails to comply with fiscal regulations
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 80
- Forks
- 38
- PR merge metrics
- No merged PRs in 30d
Description
Other Development Issue
Summary
Describe the issue
To comply with (European) regulations, the receipt that is sent via the email, whether or not it's additionally printed as a physical copy, shall not be different than the original receipt. Currently, the receipts are parsed from OPOS to HTML, get stripped of any logos or images and will then only be added as a variable inline of the HTML email. This makes the receipt look incorrect and especially the fact that any logos/images are stripped and it's also removing the required fiscal QR code is incorrect.
Version and Error Info
Commerce SDK Component: Workflows
Component Version: 9.54.25225.4
Commerce SDK Version: 9.54.25225.4
Exception/Error Details: N/A
Reproducing the Issue
Link to GitHub repo/solution where the issue is reproducible: N/A
Steps to reproduce the behavior:
- Set up receipt profile
- Design receipt + save
- Design email template (with the %message% variable), save and apply it to the receipt profile
- Run CDX job 1090
- Sing on to POS, make a sale, print the physical receipt and send it to your email address
- See major difference between printed receipt and emailed receipt, including: no logo, no other images, no fiscal QR code, receipt just part of the email body.
Screenshots
N/A, specific ones can be provided upon request
I would like to see options to control with parameters whether logos are stripped or be able to change the behavior with an extension directly. The relevant helper class and its methods are public but part of the Workflow namespace which is neither extensible, nor accessible. Additionally, a redesign of the receipt emails may be useful to support more variables or an option to define custom variables to be used in the receipt email. Also, barcodes shall be printed correctly as images / svgs, which could be done with a package. If not possible, their OPOS code should be removed, so <B:...> is not actually part of the email body as plain text. Ideally, the receipt could be sent as a PDF attachment depending on the set parameters.
This is mandatory as not every customer will want / need a physical receipt but opts to receiving it via email. Still, regulations would need to be adhered to and include the fiscal QR code (also) within the receipt email.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the receipt profile and email template flow using the %message% variable, then trace the OPOS-to-HTML parsing used when CDX job 1090 processes the profile. Compare the emailed output with the physical POS receipt, including logos, images, fiscal QR codes, and barcodes; done should be defined by the chosen control or extension behavior and its validation.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- backend
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100