Approvals
Review change proposals, approve or reject them, and see how complete the product data is.
Some people may not write changes to the shop directly. Their changes are stored as proposals and wait until an authorised person approves them. Only then is the shop changed. This area also shows a completeness score for your products and numbers about your own work.
Where to find it
- Products > Approvals: the list of proposals. Everybody sees their own proposals here. People who may approve also see the proposals of others.
- Products > Completeness: the completeness score of the products.
- The button My numbers on the page Approvals: your own work numbers.
What you need
- No special permission to see and withdraw your own proposals and to open My numbers. Access to the shop is enough.
- Approve proposals to approve or reject the proposals of other people. You also need the permission for the change itself, for example the permission to change prices when you approve a price change.
- View completeness for Products > Completeness.
- Numbers of all people to see the page Work quality with the numbers of the whole team. People with the quality permission Assign and review tasks see it too.
- Approval rules and weights to change who needs approval and how the completeness score is calculated.
- A shop that plinth may write to. Approving runs the change in the shop, see Onboarding wizard.
Permissions are assigned in Access.
How do I know whether my change needs approval?
You do not have to do anything special. Work as usual, for example in Prices or Quality.
- Save or start your change as usual.
- If your role needs approval for this type of change, plinth stores it as a proposal and does not change the shop.
- Open Products > Approvals. Your proposal is in the list with the status Waiting for approval.
The types of change are Texts, Prices, Fixes, Create and activate, Images, Cross-selling and Other.
Note: Nothing is changed in the shop until an authorised person approves the proposal.
How do I follow my proposals?
- Open Products > Approvals. If you may approve, switch to My proposals at the top.
- The tiles at the top count your proposals by status. Click a tile to filter the list. Click it again to see all.
- Click a proposal to open it. Under What changes you see the values Before and After.
| Status | Meaning |
|---|---|
| Waiting for approval | Nobody has decided yet. Nothing was changed in the shop. |
| Approved | The change ran as a background job. It can be undone there. |
| Rejected | Nothing was changed in the shop. The reason is shown on the proposal. |
| Withdrawn | You took the proposal back. Nothing was changed in the shop. |
Hover a status to see who decided and when.
A proposal was rejected
- Open the rejected proposal. The banner at the top shows who rejected it and why.
- If the button Back to editing is shown, click it to return to the place where you made the change.
- Correct the change and submit it again.
How do I withdraw a proposal?
- Open your proposal with the status Waiting for approval.
- Click Withdraw.
- Confirm with Withdraw in the dialog Withdraw the proposal?.
The message "Proposal withdrawn." appears. A withdrawn proposal can no longer be approved, but you can submit the change again.
How do I approve or reject a proposal?
You need the permission Approve proposals.
- Open Products > Approvals. The view For approval shows the proposals of other people.
- Click a proposal. Approving and rejecting are only possible on the proposal page.
- Check What changes: product, field, Before and After.
- Decide under Your decision.
Approve
- Click Approve and run.
- In the dialog Approve and carry out this change? you can enter a comment. It is optional.
- Confirm with Approve and run.
The message "Approved. The change now runs as a job and can be undone." appears. The proposal shows the state of the job and the link Jobs and undo. See Jobs for how to undo it.
Warning: Approving writes the change to the shop. A snapshot is saved first, so the change can be undone later.
Reject
- Click Reject.
- Enter the Reason for rejection (required).
- Confirm with Reject.
The message "Rejected. The author sees the reason." appears. Nothing is changed in the shop. A rejection cannot be taken back; the author can submit the change again.
Note: You cannot approve your own proposals. Another person has to do that (two-person approval). You can only withdraw them.
How do I read the completeness score?
- Open Products > Completeness.
- The tiles show the Average of the shop, the number of products per range of points, and the products with No issues.
- Click a range tile to list the products in that range under Weakest products.
- Click Fix in a row to open the product in the quality check and fix its open issues.
- The table Points lost per check shows which checks cost the most points. Click a check to open it in Quality.
Every product starts at 100 points. Every open issue costs points, based on the weight of its check. Exceptions that were accepted in the quality check do not count.
How do I see my own numbers and the numbers of the team?
- Open Products > Approvals and click My numbers.
- Choose the period at the top right: 7, 30, 90 or 365 days.
- The tiles show Tasks done, Reopened, Rejected, Open tasks and Overdue. Several tiles open the matching list when you click them.
- With the permission Numbers of all people, click Work quality to see the same numbers per person.
Note: The rates Reopened and Rejected only appear from a minimum number of cases. Everybody sees their own numbers. Only team leads see the numbers of all people.
How do I set who needs approval?
You need the permission Approval rules and weights. The page is called Approval and weights. There is no menu entry for it; ask your administrator for the link if you cannot find it.
- In the table Approval rules there is one row per role and one column per type of change. The first row Everyone applies to all people.
- Tick a box if this role needs approval for this type of change. Without a tick the change is written right away.
- Click Save at the bottom of the page.
People who may approve proposals always work directly, whatever the rules say.
Change how the completeness score is calculated
On the same page:
| Setting | Meaning |
|---|---|
| Penalty limit | Weight of open issues at which a product has 0 points. |
| Minimum cases for rates | The rates Reopened and Rejected are only shown from this many cases. |
| Weights per group and field | A factor on the weight of the checks. Empty means 1. |
| Weight per check | The points an open issue of this check costs. Empty means the default for its severity. |
Click Save when you are done. The message "Saved." appears.
Common errors and fixes
| What you see | Cause | Fix |
|---|---|---|
| "Another person approves your own proposals (two-person approval)." | You opened your own proposal. | Ask another person with Approve proposals, or withdraw the proposal. |
| A message that the proposal has already been decided | Another person approved, rejected or withdrew it in the meantime. | Reload the list. Nothing more to do. |
| A message that a permission is missing for approving this change | You may approve, but you do not have the permission for the change itself, for example for prices. | Ask an administrator for that permission, or let another person approve. |
| "This proposal belongs to another person." | You opened a proposal of somebody else without Approve proposals. | Open your own proposals under Products > Approvals. |
| "Proposal not found." | The link is wrong or the proposal belongs to another shop. | Open the proposal from the list. |
| "Only the team lead sees the figures of all people." | You opened Work quality without Numbers of all people. | Use My numbers. |
| "No preview was stored for this proposal." | The proposal has no before and after values. | Ask the author what the change contains before you decide. |
| "Not available in the demo." | The proposal is an example in a demo shop. | Nothing to do; examples cannot be approved. |
| "Invalid weight for ..." or "Invalid value." | A field in the settings does not contain a valid number. | Enter a number or leave the field empty. |
| The rates show "–" | There are not yet enough cases in the period. | Choose a longer period. |