Choose what to see, set any filters, press Show. Empty dates = all time. Approved orders only.
Waiting on Your Approval
Number
Type
Customer
Location
Requested by
Date
Total
Actions
Nothing waiting on you right now.
New Document
✓
Submitted
Sent for approval. You will be notified of the outcome.
1. Document type *
Select a document type above to begin.
All Documents
Number
Type
Customer
Requested by
Date
Total
Stage
Actions
Dispatch
All dispatch work is done here. Pick the order, enter the quantity you are sending, save. A part dispatch is fine — what is left stays in this list.
Number
Customer
Location
Date
Ordered
Dispatched
Left
Actions
Users
Username
Name
Email
Roles
Departments
Active
Actions
O365 Email Settings
Customers
+ Add customer
Internal = not a real customer (route sale, stock transfer, samples). Internal sales still count in the dashboard month totals, but never in the Top 5 customers.
Name
Locations
Internal
Locations
Name
Items
Litres per 1 qty = the litres of one carton/pack (e.g. 20L bucket = 20, 1L bottle carton of 12 = 12). The dashboard needs it for the MT figure. To change an item: add it again with the same name and the new numbers.
Name
Price range
Litres / qty
Factories
Used by "Transfer to Factory".
Name
Reasons
Reason lists for Credit Note and the two Transfer forms. "Other" (with free text) is always offered automatically.
Form
Reason
Locations & Regions per User
Payment Modes (Proof of Payment)
The modes shown on the POP form. For each mode, tick who gets the email and bell when a POP with that mode is submitted. Nobody ticked = all Collection back office.
Only the ticked people see it: when ticked, POPs of this mode show in All Documents only to the ticked people. The person who uploaded a POP always sees his own. Super Admin sees all. Not ticked, or nobody ticked = everyone who can see POPs sees this mode.
Mode
Email + bell to
All Documents
Daily Collection Report
Every day at 07:00 Mozambique time: the POPs submitted yesterday (00:00 to 24:00 Mozambique time), Central and South side by side, biggest amount first, with totals. Tick who gets it.
Approvers
Choose the approvers for each form. The 2nd approver is optional. The last approver in each column is always the final approver.
User Access
Choose a user to see the full report: what the user can open and do, and which emails and bell alerts go to the user. Read only. How to change it: see How To.
User
Roles
Departments
Forms: what the user can do
Locations
Regions
Pages
How To: change rights
Short steps for every kind of right. After any change, open User Access, choose the user and check the result.
The Controller page has 4 groups: Lists (what users choose on the forms), People & access (who can do and see what), Emails (who gets which email), Help.
First: what decides a user's access
Role = what the user may do (see, fill, mark Tally, open pages).
Department = which forms (Sales forms, Collection forms).
Location = which documents, when the role has no "See all locations".
Region = extra limit, only where "Only user's regions" is ticked.
Payment mode = extra limit for Proof of Payment, only where "Only the ticked people see it" is ticked (point 9).
Approver of a form always sees all documents of that form.
Super Admin can always do everything. It cannot be limited.
A user with two roles gets the rights of both.
1. Add a new user Super Admin
Open Admin page.
Fill Username, Display Name, Email.
Tick the role(s) and the department(s). For a requestor, tick the location(s).
Click Add User. The welcome email carries the password.
2. Change a user's role, department, name or email Super Admin
Admin page > the user's line > Actions > Edit.
Change the ticks or the text. Click Save.
The approver roles cannot be ticked here. They come from Approvers (point 7).
3. Stop or re-open a user, password Super Admin
Stop: Admin > Actions > Disable. Open again: Enable.
An approver cannot be disabled. First put another person on Approvers.
New password: Actions > Reset Password. Or the user clicks "Forgot password?" on the login page (needs an email).
A disabled user whose email is in the Notification Group still gets those emails. Remove the email there too.
4. Change what a role can do Controller, Super Admin
Controller > Roles. One block per role.
Pages: tick "Controller page" / "Dashboard page".
Per form, tick what the role may do:
See documents: the form's documents show in All Documents.
Fill form: the user can submit this form (New Document tab).
See all locations: not ticked = only the user's own locations.
Mark Tally entry: can mark the document as entered in Tally.
Delete documents: can delete a document of this form (Delete button in All Documents). An explanation is always asked. The document is not removed: it stays under Status "Deleted" with who, when and why. It cannot be brought back, and its number is not used again.
Dispatch: can record a dispatch of an approved document (Dispatch button in All Documents), with the quantity per item. Part dispatch is allowed; the rest can be dispatched later. Start: the Dispatch role on Sales Order. A dispatch user without "See all locations" needs location ticks (point 5).
Only user's regions: limits the role to the user's region ticks (point 6).
Click Save. It changes every user who has that role.
A role works only on the forms of the user's departments.
5. Give or remove locations of a user Controller
Controller > Locations & Regions. Choose the user.
Tick the locations. Click Save Assignment.
Role without "See all locations" and no location ticked = the user sees no document and cannot submit (except Proof of Payment, which has no location).
6. Limit a user to a region (Central / Southern) Controller
Controller > Roles: tick "Only user's regions" for the role and the form.
Controller > Locations & Regions: choose the user, tick the region(s), Save.
Both steps are needed. No region ticked = all regions.
If the user has a second role without this tick for the same form, there is no limit.
7. Change who approves a form Controller
Controller > Approvers. One line per form.
Choose the 1st approver. The 2nd approver is optional. Click Save.
The last approver is the final one. Documents already waiting can be approved by the new approver (no new email goes for them).
Proof of Payment has no approval, so it is not on this screen.
8. Change who gets emails Controller
Approvers and the person who filled the document get their emails always. Nothing to set.
Extra people for documents: Controller > Notification Group. Type the email, tick region and event (created / stage-1 approved / final outcome), Add. Use Edit or Remove on the line to change.
Proof of Payment: Controller > Payment Modes. Tick the people per mode, click Save on that line. Nobody ticked = all Collection back office.
The bell (in the portal) goes to the same approvers, requester and POP people. Notification Group and Daily Report are email only.
9. Limit Proof of Payment by mode of payment (Cash, Bank...) Controller
Controller > Payment Modes. One line per mode.
Tick the people of the mode. They get the email and the bell.
Tick Only the ticked people see it on that line. Click Save on that line.
Now POPs of that mode show only to the ticked people: All Documents, details, the POP file, Tally mark.
Example: Cash = Aagam + the tick. Only Aagam sees Cash POPs. Others do not see them.
Always sees: the person who uploaded the POP (his own POPs), and Super Admin.
Tick not set, or nobody ticked on the mode = no limit. Everyone who can see POPs sees that mode.
To let one more person see a limited mode: tick that person on the mode. That person also gets its email.
The limit is per person. Role does not matter here: it works for Controller and Approver also.
The Daily Collection Report email shows all modes to the people ticked on Daily Report.
10. Change the lists on the forms Controller
Customers, Items, Locations, Factories, Reasons, Payment Modes: type the name, click Add.
Remove only hides the entry from the forms. Old documents keep it. Nothing is deleted.
To bring it back: add the same name again.
Customer locations: Customers > Edit on the line. Item price range: add the item again with the same name and the new prices.
Location names should start with "Central - " or "Southern - ". The region comes from that.
11. Check the result
Controller > User Access, choose the user. The report shows the real access and every alert.
The server uses a change at once. The user's menu shows it after a page reload. No new login needed.
Roles
What each role may open and do. A user with two roles gets the rights of both. Super Admin can always do everything.
A role only works on the forms of the user's departments (set per user on the Admin page). "See all locations" not ticked = only documents of the user's own locations (Proof of Payment has no location: everyone who sees it, sees all).
Who approves a form is set on Approvers. The approvers of a form always see its documents and get the Approvals tab. The New Document tab appears when a role may fill at least one form.
Notification Group
Two groups only. A document from a "Central - …" location goes to the Central group, from a "Southern - …" location to the Southern group.